Claims and rules
How a name claim is evaluated, how payments participate, and why deterministic rules are the whole point.
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/realms/claims-and-rules - Normative authority
- Atomicals reference implementation
- Networks
- mainnet
- Documentation version
- 2026.08
- Audience
- creator, developer
- Owner
- bitcoin-universe-docs
- Sources
-
- Atomicals ElectrumX
at
v1.5.2.0 - Atomicals ElectrumX
at
v1.5.2.0
- Atomicals ElectrumX
at
このコンテンツはまだ日本語訳がありません。
Name claims for Subrealms and Container items share the same shape: a parent publishes rules, a claimant submits a claim, a validator evaluates the claim against the rules.
The evaluation
Section titled “The evaluation”- Is the name available, or is there a competing candidate?
- Does the claim satisfy every published rule?
- Where a rule requires payment, is the payment present, correct, and correctly marked?
- Where Bitwork is required, is it satisfied?
- Was this claim the first valid one for the name?
A claim that fails any step is invalid. The Bitcoin transaction still confirmed.
Payment markers
Section titled “Payment markers”A payment output alone is not enough. A marker identifies which claim the payment belongs to, so a validator can match payment to claim without guessing. The reference implementation recognises markers for both Subrealm and DMINT item payments.
Consequences for a builder:
- The marker must be present and well formed.
- The payment must go to the exact output the rule specifies.
- The amount must be exact.
- All of it must be in the same transaction as the claim.
Deterministic evaluation
Section titled “Deterministic evaluation”Rules must evaluate the same way for every independent implementation. That rules out anything that depends on wall clock time, arrival order, an external service, or unbounded work.
A rule that cannot be evaluated independently cannot be checked by a buyer, which removes the reason to trust the name in the first place.
Competing claims
Section titled “Competing claims”When several valid claims arrive for the same name, the rules decide. A product must show the full candidate set with heights rather than presenting one as settled. See candidates and winners.
After a reorg
Section titled “After a reorg”Resolution is computed at a chain position. A reorg can change which claim was first, which changes the winner. Re-resolve rather than trusting a cached result. See consistency and reorgs.