Item verification
How to prove an item belongs to a Container, what each check establishes, and what a product must show.
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/containers/item-verification - Normative authority
- Atomicals reference implementation
- Networks
- mainnet
- Documentation version
- 2026.08
- Audience
- developer, integrator
- Owner
- bitcoin-universe-docs
- Sources
-
- Atomicals ElectrumX
at
v1.5.2.0 - Atomicals JavaScript CLI
at
1333565efbfe
- Atomicals ElectrumX
at
The verification chain
Section titled “The verification chain”Each step depends on the one before it. A break anywhere means the item is unverified.
- Resolve the Container. By Atomical ID, not by name.
- Confirm the manifest is sealed. An unsealed manifest proves nothing.
- Read the manifest entry for the claimed item identifier.
- Compare the item content digest to the manifest entry.
- Check the claim satisfied its rules, including mint height, Bitwork, and payment.
- Check the claim was the winning one for that identifier, if the identifier is unique.
- Confirm the item Atomical exists and its current location.
The reference CLI exposes validate-container-item for this. See the
CLI reference.
What each check establishes
Section titled “What each check establishes”| Check | Establishes |
|---|---|
| Container resolved by ID | You are looking at the right collection |
| Manifest sealed | The rules could not be changed after minting began |
| Manifest entry exists | The item was allowed |
| Digest matches | The content is exactly what was allowed |
| Rules satisfied | The claim was valid |
| Winning claim | No one else holds that identifier |
| Item exists | The object is real and locatable |
What a product must show
Section titled “What a product must show”- Verified, with the checks that passed.
- Unverified, with the first check that failed.
- Never a green tick based on a metadata field.
An interface that shows collection membership from metadata alone is misleading, because anyone can mint an object asserting membership in anything.
Consumer expectations for an indexer
Section titled “Consumer expectations for an indexer”An index that serves Container items should expose:
- the Container Atomical ID and sealed state;
- the manifest total and the verified item count;
- per item, the verification result and the reason when it failed;
- the generation and source revision the answer came from.
No Universe read projection exposes Containers today. See status and known limitations.