Skip to content

Sources behind this page

Every claim on this page resolves to these pinned revisions. Follow a path to read the exact source the statement was verified against.

atomicals-electrumx-1.5.2.0

Atomicals ElectrumX

Revision v1.5.2.0 (2025-03-27)

Open pinned path: realmValidation

Version-sensitive ARC-20 and Atomicals validation behavior used as the pinned reference baseline.

atomicals-electrumx-1.5.2.0

Atomicals ElectrumX

Revision v1.5.2.0 (2025-03-27)

Open pinned path: mintParser

Version-sensitive ARC-20 and Atomicals validation behavior used as the pinned reference baseline.

Claims and rules

Raw

How a name claim is evaluated, how payments participate, and why deterministic rules are the whole point.

Protocol behavior Verified 2026-08-31 Metadata & Sources

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

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.

  1. Is the name available, or is there a competing candidate?
  2. Does the claim satisfy every published rule?
  3. Where a rule requires payment, is the payment present, correct, and correctly marked?
  4. Where Bitwork is required, is it satisfied?
  5. Was this claim the first valid one for the name?

A claim that fails any step is invalid. The Bitcoin transaction still confirmed.

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.

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.

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.

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.