Create a Container
Mint a collection identity, confirm the name resolved, and prepare for item minting without locking in a mistake.
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/create-a-container - Normative authority
- Atomicals reference implementation
- Networks
- mainnet
- Documentation version
- 2026.08
- Audience
- creator, developer
- Owner
- bitcoin-universe-docs
- Sources
-
- Atomicals JavaScript CLI
at
1333565efbfe - Atomicals ElectrumX
at
v1.5.2.0
- Atomicals JavaScript CLI
at
- Known limitations
-
- No Universe read projection exposes Containers. Verification of your own collection uses the reference CLI or a compatible indexer.
Este conteúdo não está disponível em sua língua ainda.
Before you start
Section titled “Before you start”- Supported networks: mainnet.
- Status: protocol behavior. Not exposed by the Universe read projection.
- The Container name is a globally allocated name and follows the candidate model.
The procedure
Section titled “The procedure”-
Choose the Container name. Check it is not confusable with an existing one.
-
Mint it:
yarn cli mint-container <container> -
Confirm on Bitcoin, then wait for indexing.
-
Confirm the name resolved to your Atomical ID and is not still a candidate.
-
Record the Container Atomical ID. Publish that, not just the name.
-
Do not open item minting yet. First prepare and seal the manifest. See create DMINT items.
Reading it back
Section titled “Reading it back”| Command | Reads |
|---|---|
get-container |
The Container |
get-container-items |
Items claimed against it |
summary-containers |
An overview |
find-containers |
Discovery |
See the CLI reference.
Check before signing
Section titled “Check before signing”- The name string is exactly what you intend.
- You are on the network you think you are.
- The funding input is cardinal.
- The metadata contains nothing you cannot stand behind permanently.
If the name does not resolve to you
Section titled “If the name does not resolve to you”Another claim won it. Your Atomical exists but does not hold the name. Do not publish it as the collection. Start again with a different name, or resolve the dispute before minting items.
Publish the Container Atomical ID everywhere the name appears, so buyers can verify membership rather than trusting a label.