Launching a Coin
Required inputs, what launch does, and how creator economics begin at creation.
Protocol
Launching a coin on Dumpster
A launch creates a Token-2022 mint, stores token metadata, seeds a bonding curve with virtual reserves, and optionally allows the creator to buy in the same transaction flow.
Required inputs
| Field | Details |
|---|---|
| name | Token name. Max 32 characters. |
| symbol | Ticker symbol. Max 10 characters. |
| uri | Metadata URI used by Token-2022 metadata. Max 200 characters. |
| creator | Wallet that receives creator-fee accruals on the bonding curve. |
| mint | A freshly generated keypair that becomes the token mint and must sign the transaction. |
What launch does
Global validation
After checking creation disablement, creator authorization and metadata lengths, create validates stored Global parameters using the same rule as set_params. The administrator must configure launch parameters first; creating the singleton and setting its initialized flag is not enough.
The shared rule checks reserves, supply, migration funding, withdrawal authority and fee recipients. The primary recipient must be nondefault; the seven optional slots may all be empty, otherwise active entries must be sorted and unique with empty slots last. These requirements also apply when migration is disabled or the protocol fee rate is zero. Passing them is not a guarantee of every later trade or migration; see configuration and funding limits.
Mint + metadata creation
The program creates a Token-2022 mint with metadata extensions and stores the name, symbol, and URI.
The payer funds the mint's rent-exempt account deposit, including its metadata allocation. The contract uses Token-2022's final account size and transfers only any missing rent. This deposit is separate from protocol fees; existing excess mint funding isn't refunded.
Bonding curve setup
A new BondingCurve PDA is initialized for the mint. The full token supply is minted into the bonding-curve ATA.
Mint authority revocation
Mint authority is revoked as part of launch so the token supply is fixed after creation.
Optional creator buy
An integration can choose to launch only, or to bundle launch with an immediate first buy in the same transaction flow.
Account constraints can allocate accounts before handler validation. A failed launch transaction commits no launch state or account changes, but network transaction fees still apply.
Creator economics begin immediately
Creator fees accrue into the creator vault from the first curve trade onward.
- Dumpster stores creator fees as native GOR in
creator-vaultPDAs. - The creator can withdraw accumulated fees with
collect_creator_fee. - If the token later migrates, AMM-side creator fees continue through DumpsterSwap.