Link a long wallet address to a phone number. Then look up the linked wallet address using just the phone number, for transfers or Web3 identity verification.
Link the wallet address and blockchain network to a phone number. The operator responds with a link ID.
Look up the linked wallet addresses, blockchain networks, and currencies using the phone number.
Get a one-time challenge from the operator. The user signs it with their wallet and includes it when linking to prove they own the wallet.
Use a phone number instead of a long addressThe other person can look up the linked wallet address using just the phone number.
User authorizationLinking and unlinking require authorization from the phone number's user (three-party authorization); lookups can use any phone number.
Blockchain Public Address: How it works
- Get a nonce (optional)For extra verification, first call the nonce API to get a one-time challenge.
- LinkAfter the user authorizes it, submit the phone number, wallet address, and blockchain network, optionally with a nonce and signature.
- Look up and unlinkLook up linked addresses using a phone number; the user can unlink them.
Blockchain Public Address: API spec
POST /blockchain-public-addresses to link; POST /blockchain-public-addresses/retrieve-blockchains to look up; DELETE /blockchain-public-addresses/{id} to unlinkPOST /nonce to get a one-time challenge; include nonce and signature when linkingevm:1 is Ethereum mainnet; evm:137 is Polygon mainnet| Response fields | Meaning | Example |
|---|---|---|
| id | Link ID | 90c626ce-… |
| blockchainPublicAddress | Wallet address | 0x71C7656E…932A |
| blockchainNetworkId | Blockchain network ID | evm:1 |
| currency | Currency list (optional) | ["ETH"] |
| nonce | One-time challenge | abc626ce-… |
Responses for three scenarios (excerpts)
90c626ce-5284-4a84-b85e-46e0ee3d0434Link ID0x71C7656EC7ab88b098dafB451B2314C5f6d8932AWallet addressevm:1Ethereum mainnet["ETH"]Currencyabc626ce-5284-4a84-b85e-46e0ee3d0434One-time challenge generated by the operator0x…Result of the user signing the nonce with their walletSpec source: CAMARA BlockchainPublicAddress r2.2 (Blockchain Public Address v0.3.0, Validation v0.1.0)