Skip to main content

​
Method Signature

align.blockchain.utils.lookupAddress(
  address: string,
  provider: JsonRpcProvider
): Promise<string | null>

​
Parameters

​
address
string
required
Ethereum address to look up
​
provider
JsonRpcProvider
required
Ethereum mainnet provider

​
Returns

Returns the primary ENS name as a string, or null if not set.

​
Examples

import Align from "@tolbel/align";

const align = new Align({
  apiKey: process.env.ALIGN_API_KEY!,
  environment: "sandbox",
});

const provider = align.blockchain.providers.getProvider("ethereum");

const ensName = await align.blockchain.utils.lookupAddress(
  "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  provider
);

if (ensName) {
  console.log(`Address has ENS: ${ensName}`);
  // Address has ENS: vitalik.eth
} else {
  console.log("No ENS name set");
}

​
Display Friendly Names

async function formatAddress(address: string): Promise<string> {
  const provider = align.blockchain.providers.getProvider("ethereum");

  const ensName = await align.blockchain.utils.lookupAddress(address, provider);

  if (ensName) {
    return ensName; // vitalik.eth
  }

  // Truncate address for display
  return `${address.slice(0, 6)}...${address.slice(-4)}`; // 0xd8dA...6045
}
Not all addresses have ENS names. Only addresses with a primary ENS name set will return a value.

Resolve Name

ENS to address

Validate Address

Check address format