.bnb — Documentation
Everything you need to send crypto to a .bnb name on any chain. No addresses, no seed phrases, no chain-picker anxiety.
Introduction
.bnb is a utility layer around .bnb identities — a multi-chain wallet and payment layer. Instead of copying a long address, you send to a name: mema.bnb on X, Instagram, TikTok, LinkedIn, Facebook, GitHub, Twitch, Discord and more.
If the recipient already has a wallet here, funds arrive instantly. If they don't, the amount sits in an on-chain escrow tied to that exact name until they sign in and claim it. You can attach an expiry so unclaimed funds sweep back to you.
Under the hood, .bnb provisions a wallet on every supported chain the moment you sign up, so you can receive anywhere and send from a single balance view.
Quick start
- Open the app and sign in with email, Google, Apple or a supported social.
- Pick your .bnb name (URL-safe, dash-separated).
- Link additional socials from Profile so friends can pay you by any of them.
- Fund the wallet from any external wallet or exchange using the Deposit QR.
- Send: choose a chain, choose a token, type
friend.bnb, confirm.
Accounts & identity
A .bnb account is a single identity that can carry several verified socials. You can start with email and add socials later, or start with a social and add email later — the account stays the same.
Sign-in methods
- Email one-time code (OTP)
- Google, Apple
- X, Facebook, LinkedIn, GitHub, Twitch, Discord
- Additional socials continue to roll out; unavailable ones are labeled Coming soon.
Identity vs name
Your account is the vault. Your .bnb is how the world addresses you. Names are unique and can be changed; the vault behind them is not affected.
Names & socials
Handles are case-insensitive and normalized to a URL-safe slug. Spaces become dashes. Example: Me Ma becomes @send-me-money. Share links use the slug.
A name must be backed by a verified social or an owned .bnb domain for it to appear as a payable target. You verify by signing in with that provider — text entry alone is not enough. This is what prevents impersonation.
Wallets & custody
When you sign up, .bnb creates a wallet for every live chain (EVM, Solana, and UTXO families like Bitcoin, Dogecoin and Litecoin). You can view every address, QR code and balance from the app.
Custody model
Private keys are encrypted at rest with AES-256-GCM. The encryption key lives only on the server; it is never sent to the browser, never stored in a cookie, and never exposed in a public API response. Signing happens inside authenticated server functions scoped to your user id.
Ownership
You can reveal or export the private key of any wallet from Profile at any time, with a short countdown and audit log. Export it and walk away — the wallet is yours.
Sending
Every send is a chain, a token, a recipient, an amount. Two recipient modes:
- Address — paste a raw wallet address on the selected chain.
- Name — type a .bnb domain, or pick a verified social handle.
Address mode delivers instantly on Tier 1 chains. Handle mode delivers instantly if the recipient is already linked, otherwise the amount is escrowed for them.
Tokens, not just native
You can send the chain's native asset or any tracked token in that network's wallet. The token picker shows what you actually hold with live USD values.
MAX
Tap MAX to auto-fill your balance. On native-asset sends we reserve a small buffer for network fees so the transaction still confirms.
Estimates
Before you confirm you see the amount, a gas estimate, and a total in USD. If any of those change while you sit on the screen, they refresh in place.
Receiving & QR
Every chain view shows a receive address and a QR. Anyone with a wallet on that chain can pay you directly. Traditional wallet-address payments are supported too.
For a chain-agnostic ask, share your public profile at dotbnb.xyz/u/@you — it lists every address at once.
Claim pages
When someone sends to your name before you've signed up, they generate a claim page at dotbnb.xyz/claim/@you. The page shows pending balances across every chain a sender used, plus a claim button for only the socials that actually received funds.
You claim by signing in with the matching social provider. That step is the proof of identity — the escrow is released to your wallet only when the verified provider matches.
Escrow & refunds
For unlinked-name sends we mint a fresh keypair per (name, chain-family) and encrypt it server-side. Funds land at that escrow address. It's a real on-chain address; you can verify it on any explorer.
Auto-refund
Optionally attach an expiry when you send. If the recipient hasn't claimed by then, the sweeper returns funds to your wallet automatically on the next run.
Visibility
Pending sends appear in your Feed with a "Pending claim" badge. Once claimed, the entry updates in place.
Supported chains
Chains fall into three tiers:
- Live — full send/receive. Ethereum, Base, Arbitrum, OP Mainnet, Polygon, BNB Smart Chain, Avalanche, Robinhood Chain, Solana, Bitcoin, Dogecoin, Litecoin.
- Beta — 30+ additional EVM networks with live balances and read access. Toggle them on in Settings to see them in the chain switcher.
- Soon — networks queued for launch. Hit "Notify me" on any Soon card to lock a spot in the queue.
Robinhood Chain is the default active chain because most first-time users are testing the free-to-move flow there. You can change the default from Settings.
Tokens, prices & charts
Every chain view shows your held tokens on top and tracked market tokens below. Tokens carry live prices, market cap, liquidity, and a chart when data is available.
Tiny numbers use subscript compression — for example $0.0₅212 means five zeros then 212. This keeps rows aligned when prices differ by orders of magnitude.
Asset detail
Tap any token to open its sheet. If you hold it, your balance and USD value show at the top. A "View chart" button opens the full chart view; the base card remains a fast summary.
Swap
Swap between tokens on the same chain. Route quotes surface the best on-chain venue for the pair. Slippage defaults are conservative; you can override in the sheet.
Cross-chain swaps are on the roadmap.
Token launches
Anyone can launch a token on a single chain or deploy the same token across multiple chains in one flow. The same IPFS-pinned metadata (name, ticker, image, description, socials) is reused everywhere so the token has one consistent identity.
Creator fees
Set a creator-fee recipient at launch. Trading fees on the token accrue to that wallet on every chain it lives on.
Multi-chain
Multi-chain launches deploy sequentially with a per-chain status timeline. If one chain fails, the others aren't blocked — you can retry the failed leg.
Staking
Staking is coming. Lock $BNB for 30d, 90d or 180d to earn base rewards, boosted yield, or the top perk tier. Rewards accrue in-kind and are claimable at unlock.
We'll announce launch dates and reward math on the app. Follow the account for updates.
Public profile
Your public profile at /u/@handle is a shareable card with an avatar, all your verified socials, a QR, and every-chain addresses. Drop it in a bio, DM, receipt or invoice.
You control which socials show. Removing a linked social hides it from the public profile immediately.
Wallet passes
Generate an Apple Wallet or Google Wallet pass for your .bnb. The pass shows your name, avatar, and a QR that resolves to your public profile. Balances refresh nightly.
One pass per type per account. Regenerate to pick up the latest style. Passes use a cyan-blue brand palette and are designed for legibility at a glance.
Mobile & shake gestures
.bnb is a PWA today — install it from your browser's Add to Home Screen menu. Native iOS and Android are in the works.
Shake action (mobile only)
On touch devices you can bind a shake gesture to one of:
- Hide balances — toggles the privacy eye.
- Open bug report — pops a report sheet pre-filled with route, device, and chain.
- Off — no listener attached.
On iOS the first shake asks for motion permission — a one-time system prompt. Configure the binding in Settings.
Notifications
Toasts confirm every action. In-app badges highlight pending claims. Push notifications ship with the native mobile apps.
Security
Key storage
Private keys are AES-256-GCM encrypted with a server-only key. That key never touches the browser, is never bundled into JS, and does not appear in any client-visible API response. Even a full front-end inspection cannot recover it.
Server signing
Signing runs inside authenticated server functions scoped to your user id. Every self-reveal of a private key is audit-logged with timestamp and IP fingerprint.
Admin controls
Admin routes are gated by a role check and require a second-factor unlock before any sensitive action. Admin visibility is stripped from Settings for non-admin users.
Bot protection
Forms are protected by silent reCAPTCHA v3. Rate-limits apply to auth, sends, waitlist and support endpoints.
Privacy
Your public profile only reveals what you've explicitly linked. Reporters of bugs are never exposed in the public feed; only status and component are shown.
We don't sell data. We don't share it with third parties beyond the infrastructure needed to run the product (auth, storage, RPC nodes, mail delivery).
Fees & gas
.bnb does not charge a platform fee to send. You pay the network's gas or fee-per-byte, deducted from the source chain balance. Estimates are shown before confirm.
Escrow sweeps are paid out of the sender's original send. There is no additional charge to the recipient at claim.
Exporting keys
From Profile, pick a wallet and tap Reveal key. A 5-second countdown gives you a moment to make sure no one is over your shoulder. Copy the key into your preferred wallet, or take a note of it — either way, you're in full control.
Every reveal is written to your audit log.
Support & bug reports
Two paths from Settings:
- Help — private request to the team. Category, subject, message. You'll see admin replies inline.
- Report a bug — public tracker. Reports auto-capture your route, chain and device. A shared feed shows fixes as they land, without revealing reporters.
Every report has a status timeline: pending → triaged → in progress → fixed. Reporters can add follow-up comments; admins can post updates.
Glossary
- Handle
- A URL-safe slug tied to a verified social. E.g.
@send-to-all. - Escrow
- On-chain address that holds funds for an unclaimed name until the recipient signs in.
- Sweep
- The process that moves escrow funds into a recipient wallet (on claim) or refunds sender (on expiry).
- Chain family
- A group of chains that share an address format — EVM, Solana, UTXO (BTC/DOGE/LTC).
- Tier
- Live, Beta, or Soon — the launch status of a chain in .bnb.
FAQ
Do I need an existing wallet? No. Sign up and we provision a wallet on every supported chain.
Is this custodial? You own your wallets and can export at any time. Keys are encrypted server-side while you use the app.
What if my recipient never claims? Attach an expiry and unclaimed funds sweep back to you. Without an expiry they stay in escrow indefinitely.
Which socials work? Google, Apple and email for sign-in; X, Instagram, TikTok, LinkedIn, Facebook, GitHub, Twitch, Discord for payable identities. More are being added.
Do I pay gas? Yes, standard network fees. We show a live estimate before you confirm.
Can I use my existing wallet? Yes. Deposit from any external wallet or exchange to any chain address.
When are more chains coming? Regularly. Enable Beta chains in Settings to preview, or hit "Notify me" on Soon chains.
Is there a token? $BNB and staking are coming. Details will be announced in-app.
Still stuck? Open the app, head to Settings → Help and send us a request. We answer inline.
Open the app →