Lookup Address

Method Signature

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

Parameters

string

required

Ethereum address to look up

JsonRpcProvider

required

Ethereum mainnet provider

Returns

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

Examples

TypeScript
JavaScript

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");
}

const name = await align.blockchain.utils.lookupAddress(
  address,
  provider
);
console.log("ENS:", name);

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

Getting Started

API Reference

Method Signature

Parameters

Returns

Examples

Display Friendly Names

Resolve Name

Validate Address

​Method Signature

​Parameters

​Returns

​Examples

​Display Friendly Names

​Related Methods

Resolve Name

Validate Address

Method Signature

Parameters

Returns

Examples

Display Friendly Names

Related Methods