Coinbase's Base-native onchain identity. ENS-compatible `*.base.eth` names registered, resolved, and stored fully onchain on Base. Tightly integrated with OnchainKit.
- 01human-readable identity on Base
- 02profile + avatar resolution in dApps
- 03Coinbase Smart Wallet user flows
- 04EAS-attested social/profile records
- 05ENS-compatible naming on Base L2
- pnpm add @coinbase/onchainkit viem wagmi
| Variable | Scope | Description |
|---|---|---|
| NEXT_PUBLIC_ONCHAINKIT_API_KEY | Client | Coinbase Developer Platform API key for OnchainKit (rate-limited resolution + indexed reads). |
Use OnchainKit to resolve and render Basenames. Wrap your app in `OnchainKitProvider` with `chain={base}` and `apiKey={NEXT_PUBLIC_ONCHAINKIT_API_KEY}`. Resolve a name with `import { getName } from '@coinbase/onchainkit/identity'` and call `await getName({ address, chain: base })`; reverse-resolve via `getAddress({ name, chain: base })`. For UI, drop in `<Identity address={address} chain={base}><Name /><Avatar /></Identity>`. Direct contract reads go through the L2 Registry / Public Resolver on Base — text records (avatar, description, socials, EAS attestation keys) follow the standard ENS resolver interface (`addr`, `text`, `contenthash`).
- ⚑Names live on Base L2 — don't try to resolve `*.base.eth` against mainnet ENS; pass `chain: base` explicitly to OnchainKit.
- ⚑Subdomain registration costs gas + annual rent; rent expiry releases the name back to auction — implement renewal reminders.
- ⚑OnchainKit `getName` does an offchain lookup against Coinbase's resolver gateway — without an API key you'll hit aggressive public-tier rate limits.
- ⚑Some primary-name resolutions require a separate reverse record set; users registering on base.org may not have reverse set automatically.
- ⚑Avatar text records can point to IPFS or HTTPS — sanitize and proxy untrusted avatar URLs to avoid mixed-content and SSRF.
- ⚑Free Basename promotions (early-Coinbase-user free names) have specific eligibility checks; for general users expect normal pricing.