Claim a Realm
Request a top-level name, confirm it resolved to you, and protect the output that carries it.
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
-
guides/claim-a-realm - Normative authority
- Atomicals reference implementation
- Networks
- mainnet
- Documentation version
- 2026.08
- Audience
- everyone, creator
- Owner
- bitcoin-universe-docs
- Sources
-
- Atomicals JavaScript CLI
at
1333565efbfe - Atomicals ElectrumX
at
v1.5.2.0
- Atomicals JavaScript CLI
at
Ce contenu n’est pas encore disponible dans votre langue.
Before you start
Section titled “Before you start”- Supported networks: mainnet.
- Status: protocol behavior. The Universe read model exposes realm resolution and hierarchy.
- A request is not a name. It becomes one only when the rules resolve it.
Check first
Section titled “Check first”- Search for the name.
find-realms,get-realm, andrealm-inforead the current state. - Check for existing candidates for the same name.
- Check for confusable variants that already exist. See Unicode and confusable names.
- Confirm the name passes validation for your target rule set.
The command
Section titled “The command”yarn cli mint-realm <realm>Options include --satsoutput, --initialowner, --container, --bitworkc, --bitworkr,
--funding, --satsbyte, --rbf. See the
CLI reference.
Two Bitcoin fees, grinding if you set Bitwork, and the output value that will carry the Realm.
Check before signing
Section titled “Check before signing”- The name is exactly the string you intend, character by character.
- No confusable variant is already claimed by someone else.
- The output value is above the dust threshold.
- The funding input is cardinal.
After broadcast
Section titled “After broadcast”- Confirm, then wait for indexing.
- Read the resolution. Confirm you are the verified winner, not a pending or losing candidate.
- Record the Atomical ID.
- Move the output into your protected pool. Losing that output loses the name.
- If you plan to allow Subrealms, configure the rules deliberately. See claim a Subrealm.
If you did not win
Section titled “If you did not win”Another claim resolved first. Your Atomical exists without the name. Do not present it as the Realm.