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
Ce contenu n’est pas encore disponible dans votre langue.
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.