Wallet Identification

Wallet identification is the process of associating a human-readable name or domain with a blockchain wallet address. Instead of showing long hexadecimal addresses like 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045, apps can display friendly names like vitalik.eth, making blockchain applications more intuitive and user-friendly.

What is a Domain in Wallet Terms?

In the blockchain ecosystem, domains are human-readable names registered on networks like:

• Ethereum Name Service (ENS) – .eth domains
• Unstoppable Domains – .crypto, .nft domains
• Other blockchain-native naming systems

These domains resolve to wallet addresses, so users can send and receive funds without memorizing or copying long addresses.

Example:vitalik.eth → 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

Why Wallet Identification Matters?

Supporting wallet identification in your application provides:

• Better UX – Users see recognizable names instead of long hex addresses.
• Reduced Errors – Minimizes mistakes from manual copy-pasting.
• Simplified Onboarding – New users can interact using domains.
• Enhanced App Features – Portfolio apps, wallet trackers, and payment interfaces can show friendly names alongside balances.

Tatum API for Wallet Identification

Tatum provides an API to resolve a human-readable blockchain domain name into its corresponding wallet address.

API Endpoint: Resolve Address by Domain

📘

Resolve Name to Address (Popular🔥)

GET /v4/wns/address/{name}
Resolve a Web3 name into the corresponding blockchain address.
Explore Docs →

 Example Request to resolve vitalik.eth:

curl -X GET "https://api.tatum.io/v3/blockchain/domain/resolution?chain=ethereum-mainnet&name=vitalik.eth" \
  -H "x-api-key: YOUR_API_KEY"

const options = {
  method: 'GET',
  headers: {
    accept: 'application/json',
    'x-api-key': 'YOUR_API_KEY'
  }
};

fetch('https://api.tatum.io/v4/data/ns/name?chain=ethereum-mainnet', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

 Example Response :

{  
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",  
  "chain": "ethereum-mainnet",  
  "name": "vitalik.eth",  
  "resolved": true  
}  

Usage Workflow

1. Input Domain Name – User enters a blockchain domain in your app.
2. Call API – Send a request to Tatum with the domain and chain name.
3. Display Result – Show the resolved wallet address or the friendly domain in your UI.
4. Optional – Cache resolved addresses to reduce repeated API calls and save credits.

Best Practices

• Always validate domains before resolving to prevent errors.
• Display fallback if resolution fails, e.g., show the raw wallet address.
• Support multiple chains to make your wallet app cross-chain compatible.

By integrating wallet identification, your portfolio or wallet app will offer a cleaner, safer, and more user-friendly experience while leveraging Tatum’s fast and reliable blockchain indexing infrastructure.