Forge Notes

What actually happens when a token is minted

Creating a token on Solana is not one action. It is a short list of account writes, and several of those writes set values that no later transaction can change.

This workshop documents each write in order: what the mint account stores, which authorities keep their power after launch, where the name and the image really live, and which button on a launchpad quietly makes one of those decisions for you.

What a mint account holds

Five fields. Everything a holder can be subjected to later is decided by them.

Supply
The number of raw units currently in existence. It is a running total, not a ceiling, and no maximum field exists beside it.
Decimals
One byte, written when the mint is initialised, never editable afterwards. It only moves the decimal point on display.
Mint authority
Optional. Whoever holds it can create new units at will, forever, until the field is set to none.
Freeze authority
Optional, and only assignable at initialisation. It can freeze and thaw individual holder accounts.
Owner program
Either the SPL Token program or Token-2022. The choice is made when the account is allocated and cannot be migrated later.

The six decisions that cannot be undone

Most of token creation is repairable. You can rename a token, replace an image, add liquidity, or hand a key to someone else. These six are the exceptions, and every one of them is made in the first minute by someone who is usually in a hurry.

01Written once

The decimals value

Decimals is a single byte set by the initialise-mint instruction. There is no instruction to change it later. Getting it wrong does not break the token, but it permanently fixes how every interface and every integer amount reads.

02No migration

Which token program owns the mint

A mint is owned either by the original SPL Token program or by Token-2022. The owner is fixed when the account is allocated. Moving a live token from one program to the other means a new mint and a new address.

03Creation only

Which Token-2022 extensions are enabled

Mint extensions such as transfer fees, transfer hooks or a permanent delegate are chosen while the mint is being created, because they change how much space the account needs. They cannot be bolted on afterwards.

04One direction

Revoking the mint authority

Setting the mint authority to none ends the ability to create new units. That is usually the intent, and it is permanent. No key, including the one that just signed it, can restore the authority afterwards.

05Never added later

Leaving the freeze authority empty

A freeze authority can only be assigned while the mint is being initialised. If it is left empty then, it can never be added. If it is set, it can be revoked once, and that revocation is also final.

06Sealed record

Marking metadata immutable

Clearing the mutable flag on a metadata account seals the name, symbol and URI in place. It removes a risk and a repair path at the same time, and there is no instruction to unseal it.

Field notes

Four notes carry most of the site. Each one starts from the accounts and instructions involved, marks every irreversible step before describing it, and ends by saying what the workshop has not tested.

01

Solana token creation explained

The whole sequence from a fresh keypair to a tradable token: allocation, rent exemption, initialisation, the first mint into an associated token account, metadata, and where the sequence stops being reversible.

Open the head note
02

Mint and freeze authority

Two optional keys inside the mint. One can print supply forever, the other can lock an individual holder out of transferring. What each actually controls, and what revoking each one does and does not prove.

Read the authorities note
03

Token metadata explained

The name, the symbol and the image are not stored in the token. They sit in a separate derived account or in a mint extension, with hard length limits and an update authority that is usually still live.

Read the metadata note

Three benches

Minting covers the mint account and the values written into it. Metadata covers everything that is displayed but not owned by the token program. Launchpads covers the shortcuts, and how to read what they produced.

Minting

The mint account is the token. Everything a holder can be subjected to later, dilution, freezing, a supply that keeps growing, is decided by fields written into that one account.

Open the bench

Metadata

A name and a symbol are not part of the token. They live in a separate account, or in a mint extension, owned by an update authority that can usually rewrite them at any time.

Open the bench

Launchpads

A launchpad makes the same decisions you would make by hand, faster and out of sight. What it locks in on your behalf, and how any reader can check the result against the chain.

Open the bench

Six things any reader can check

None of these needs a node, a subscription or a developer. Every one is visible on a public explorer once you have the mint address, and every one is a field this site explains in full somewhere.

Mint address
The only identifier that is unique. Names and symbols are free text and can be duplicated by anyone within minutes.
Mint authority
Present or none. Present means the supply figure you are reading is a snapshot rather than a limit.
Freeze authority
Present or none. Present means an individual holder account can be frozen by whoever holds that key.
Decimals and supply
Read together. Raw supply divided by ten to the power of decimals is the human number that circulates.
Token program
SPL Token or Token-2022. If it is Token-2022, the extension list is part of the token's behaviour.
Metadata mutability
Whether the name, symbol and URI can still be rewritten, and which key is allowed to rewrite them.

After the mint comes the market

Everything this workshop documents ends at the moment a token becomes tradable. That is the point where a different set of questions starts: how deep the pool is, how much turnover a pair shows on aggregator screens, and how much of that turnover was produced on purpose rather than by people arriving on their own.

Those questions are not part of token construction, but they are the reason many of the construction decisions get made in the first place. A team that expects a listing threshold picks a supply and a liquidity structure with that threshold in mind. A team that never thought about the market picks defaults and finds out later.

The workshop keeps the two apart deliberately. Construction facts come from the token programs and are checkable by anyone. Market activity is a commercial layer with its own tooling, its own pricing and its own claims, and it is described here as market structure rather than recommended.

What changes the moment trading starts

  • The pool becomes the price, and the pool is a separate pair of token accounts owned by an AMM program.
  • Liquidity provider tokens appear, and who holds or burns them becomes a bigger question than the mint authority.
  • Every new holder needs an associated token account, and someone pays the rent-exempt minimum for it.
  • Turnover starts being displayed on screens that rank and filter by turnover, which creates its own incentives.
  • Metadata that is still mutable can now be changed underneath people who already hold the token.
  • A freeze authority that was harmless while nobody held anything is no longer harmless.

How this workshop documents things

Three rules decide what appears on these pages, and more often what does not.

Checked against the programs

Field names, account sizes, instruction names and limits are taken from the token programs and the metadata standard, not from a launch interface, a tooltip or a screenshot of one. Where an interface uses a friendlier word than the program does, both words appear so the reader can search either.

Where a number would depend on network conditions or a fee schedule that changes, it is labelled as illustrative arithmetic and the inputs are shown.

Irreversibility comes first

If a step cannot be undone, the warning sits above the instruction rather than in a note at the end. Notes that contain irreversible steps carry a list of them before the first section, so a reader who scrolls no further still sees the ones that matter.

Reversible steps are marked as reversible too, because treating everything as dangerous is its own kind of bad documentation.

Verification, never concealment

The workshop explains how to read a token's authorities, extensions and metadata state so that a buyer can check them. It does not publish the opposite: nothing here describes how to hide a live mint authority, disguise a supply, fake a lock or make any of those checks return a misleading answer.

That line is not negotiable, and requests for the other side of it are declined rather than answered privately.