True-Tags Developer API

Integrate the True-Tags naming service into your Web3 dApp. Allow your users to send USDT, BNB, or any BEP-20 token using readable @usernames instead of 42-character addresses.

The Smart Contract

True-Tags is a public registry permanently deployed on the Binance Smart Chain (Mainnet).

Network: BSC Mainnet (Chain ID 56)
Contract Address: 0xA189fC7529B40b5B6F6CA4EAe1b217F5957e78A3
Cost to Query: Free (View Function)

Resolve a Username to an Address (Ethers.js v6)

You can resolve any True-Tag to its owner's wallet address using just 3 lines of Javascript.

import { ethers } from "ethers";

// 1. Initialize the True-Tags Contract
const TAGS_ADDRESS = "0xA189fC7529B40b5B6F6CA4EAe1b217F5957e78A3";
const ABI = ["function resolve(string name) view returns (address)"];
const tagsContract = new ethers.Contract(TAGS_ADDRESS, ABI, provider);

// 2. Resolve the username (e.g., "batman")
async function getWalletAddress(username) {
    const walletAddress = await tagsContract.resolve(username);
    
    if (walletAddress === ethers.ZeroAddress) {
        throw new Error("True-Tag does not exist!");
    }
    
    return walletAddress;
}
            

Once you have the resolved walletAddress, your dApp can execute a standard BEP-20 transfer of USDT, CAKE, or BNB directly to that user.