Wallet safety
What an Atomicals aware wallet must do, what it must never do, and how to tell whether the wallet you use qualifies.
Protocol behavior Verified 2026-08-31
Describes the Atomicals protocol itself at the pinned reference revision. It does not promise that any product exposes it.
- Page ID
-
protocol/arc20/wallet-safety - Normative authority
- Atomicals reference implementation
- Networks
- mainnet
- Documentation version
- 2026.08
- Audience
- everyone, holder, integrator
- Owner
- bitcoin-universe-docs
- Sources
-
- Atomicals ElectrumX
at
v1.5.2.0
- Atomicals ElectrumX
at
An ordinary Bitcoin wallet is dangerous for Atomicals not because it is badly built, but because it is correctly built for a different problem. It sees satoshis and optimises fees.
What a wallet must do
Section titled “What a wallet must do”- Identify coloured outputs. Per outpoint, with the Atomical ID, not as an address total.
- Exclude them from automatic coin selection. Always, unless the user explicitly chose to spend that asset.
- Keep a cardinal pool. Ordinary outputs reserved for fees.
- Preview the allocation. Before signing, show every output, its satoshi value, and its expected coloured assignment.
- Show the burn figure. Zero should be the normal case, and a non-zero figure should require a deliberate confirmation.
- Preserve input and output order. Never reorder for canonicalisation.
- Show the signature hash flag. And refuse flags the user did not expect.
- Report its data source. Which index, which revision, how fresh.
What a wallet must never do
Section titled “What a wallet must never do”- Never sweep or consolidate without showing the allocation result.
- Never choose a coloured output for a fee silently.
- Never display a token balance without the resolved Atomical ID available.
- Never round a native quantity using
decimalsbefore building a transaction. - Never ask for a seed phrase or private key to display a balance.
How to test the wallet you use
Section titled “How to test the wallet you use”| Test | Pass |
|---|---|
| Ask it to show your outputs | It lists outpoints and marks coloured ones |
| Try to send BTC while holding coloured outputs | It excludes them or warns clearly |
| Build a partial transfer | It shows expected units per output before signing |
| Build a transfer with a bad change size | It shows a non-zero burn figure and asks again |
| Check the source | It names the index and its freshness |
If a wallet fails the first test, it is not suitable for holding Atomicals. See choose a wallet.
For integrators
Section titled “For integrators”Capability discovery matters. Ask the provider what it supports before building a transaction for it, rather than discovering a gap through a signing failure. See wallet integration.