Atomicals digital objects
What an Atomical actually is at the data level, what a validator stores about it, and what it never guarantees.
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/core/digital-objects - Normative authority
- Atomicals reference implementation
- Networks
- mainnet
- Documentation version
- 2026.08
- Audience
- everyone, developer
- Owner
- bitcoin-universe-docs
- Sources
-
- Atomicals ElectrumX
at
v1.5.2.0
- Atomicals ElectrumX
at
本頁內容尚未翻譯。
An Atomical is the record a validator builds after reading a valid operation envelope in a Bitcoin transaction. Three things exist from that moment.
Identity
Section titled “Identity”Assigned once, at mint, in the form <txid>i<output-index>. It never changes and is never
reassigned. A separate sequential number is also assigned, useful for display and ordering but
not a durable key.
Store the Atomical ID. Display the number if you like. Never key on the number alone.
Type and subtype
Section titled “Type and subtype”The mint operation decides the type. nft produces a non-fungible object. ft and dft produce
fungible issuance. Subtypes narrow this further: a Realm, a Subrealm, a Container, and a DMINT
item are all non-fungible objects with a request payload that makes them a name or a collection.
An integration that only expects a plain NFT must reject the subtypes it does not handle, rather than treating them as generic.
Payload
Section titled “Payload”The CBOR payload in the envelope. It can contain:
- arbitrary metadata such as
name,desc,image,links,legal; - one or more embedded files with declared content types;
- request fields such as a ticker, realm, or container name;
- rule structures for Subrealm and DMINT claims.
All of it is supplied by the minter. None of it is verified by anyone. See metadata trust boundaries.
What a validator stores
Section titled “What a validator stores”| Field | Meaning |
|---|---|
| Atomical ID | Durable identity |
| Number | Mint order |
| Type and subtype | What kind of object it is |
| Mint transaction and height | Where it came from |
| Current location | The outpoint that carries it now |
| Owner script | The script controlling that outpoint |
| State | The result of applied mod operations |
| History | Every operation applied, in order |
| Sealed flag | Whether further changes are refused |
What none of this proves
Section titled “What none of this proves”- Not who created it. Anyone can mint anything with any metadata.
- Not that the media is original, licensed, or safe to render.
- Not that a name in the payload matches the name the rules actually awarded.
- Not that another validator revision agrees with this record.
Read indexer dependency next.