Mint an Atomicals NFT
Build the payload, choose an output value, and understand which decisions become permanent.
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/mint-an-nft - 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
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 bytes you embed are permanent and public.
What you need
Section titled “What you need”| Input | Notes |
|---|---|
| The payload | A file, or a JSON document |
| Media, if any | Optimised before minting. Reveal fees scale with size |
| An output value | Above the relay dust threshold for the script type |
| Funding | Two fees plus the output value plus grinding cost |
The commands
Section titled “The commands”yarn cli mint-nft <file>yarn cli mint-nft-json <file>Options include --satsoutput, --initialowner, --parent, --parentowner, --bitworkc,
--bitworkr, --funding, --satsbyte, --rbf. See the
CLI reference.
Permanent decisions
Section titled “Permanent decisions”| Decision | Why |
|---|---|
| The Atomical ID | Assigned at mint |
| Embedded bytes | They are in a block |
| Parent linkage | Set at mint |
| A name request | A different name means a different mint |
Everything else is state and can change until you seal.
Reducing cost
Section titled “Reducing cost”- Reference shared bytes rather than embedding them per item.
- Prefer a compact source format such as optimised SVG.
- Estimate the reveal size with the real bytes before choosing a Bitwork prefix.
Check before signing
Section titled “Check before signing”- The payload contains nothing private.
- The media is the final version. There is no replacing it.
- The output value is above the dust threshold and is a value you are content to lock.
- The funding input is cardinal.
- Enough remains after the commit to pay the reveal.
After broadcast
Section titled “After broadcast”- Confirm, then wait for indexing.
- Confirm the type and subtype are what you expected.
- Record the Atomical ID.
- Move it into your protected pool.
- Seal only when you are certain. There is no unseal.