Build on Joseon.fun
Every token starts on a bonding curve, graduates into a JoseonSwap pool with permanently locked liquidity, and streams out of one indexer API. These docs cover the maths, the contracts, and the calls.
Total supply
1B
On the curve
800M 80%
Curve fee
2.00% 70/30
Graduation FDV
18 ETH
Chain ID
91342
What this is#
Joseon.fun is a token launchpad on GIWA Chain, an OP Stack L2. Anyone can mint a fixed-supply ERC-20 and start trading it against a bonding curve in one transaction. No liquidity to seed, no pool to configure, no listing to apply for.
When the curve sells out, the launch graduates: the ETH it collected and the tokens it held back are moved into a JoseonSwap pool in a single atomic transaction, and the initial LP position is burned into a permanent locker. From that point on the token trades like any other AMM pair, and its price chart continues without a seam.
JoseonSwap is the DEX underneath — a Uniswap V2-style constant-product AMM, with one addition: launch pairs are protected so nobody can front-run a graduation by creating the pair first at a fake price.
The path a launch takes#
create ──▶ CURVE_ACTIVE ──▶ GRADUATING ──▶ DEX_ACTIVE
bonding curve atomic JoseonSwap pair,
buys and sells migration LP locked forever| Stage | Where trades go | What ends it |
|---|---|---|
CURVE_ACTIVE | BondingCurvePool.buy / .sell | the 800M curve allocation sells out |
GRADUATING | trading is paused | the migration transaction completes |
DEX_ACTIVE | JoseonSwapRouter | nothing, it is the end state |
A launch never goes backwards. Graduation is one transaction, so GRADUATING is not a state users normally sit in —
it exists so that a partially completed migration can never be traded against.
Fixed by design#
Every launch uses the same parameters. There are no per-token knobs, which is what makes the graduation price predictable and the migration safe to run atomically.
| Total supply | 1,000,000,000 (18 decimals) |
| Sold on the curve | 800,000,000 |
| Reserved for the DEX pool | 200,000,000 |
| Net ETH the curve collects | 3.6 ETH |
| Graduation price | 0.000000018 ETH per token |
| Graduation FDV | 18 ETH |
| Initial pool TVL | 7.2 ETH |
These are testnet numbers on GIWA Sepolia. Mainnet parameters get re-derived against real gas and real ETH before launch, so treat every figure here as the current testnet configuration rather than a permanent promise.
Where to go next#
If you want to use it, start with the quickstart — wallet setup, test ETH, and a first launch.
If you want to understand the economics, read bonding curve then fees. The curve page derives every number above from the two virtual reserves, so you can check the maths rather than trust the table.
If you are building on it, the indexer API covers reads and contract calls covers writes. Both are testnet-live right now.
This is unaudited testnet software with a single EOA holding admin keys. Do not put real value into it. The security page is specific about what is centralized and what has not been exercised on-chain yet.