From curve to pool, explained.
A Joseon.fun token is born on a bonding curve, graduates into a JoseonSwap pool whose liquidity is locked for good, and stays readable through one indexer API the whole way. This handbook covers the mechanics, the fees, and the contracts and endpoints you build against.
What Joseon.fun is#
Joseon.fun is a place to launch and trade tokens on GIWA Chain, an OP Stack L2. You mint a fixed-supply ERC-20 and it starts trading immediately, in the same transaction. There is nothing to seed, no pool to configure, and no listing to apply for.
Custody stays with you. A launch, a trade, or a fee claim is a transaction you sign in your own wallet, sent to contracts with no owner key, no pause switch, and no upgrade path.
A new token trades against a bonding curve first — a pool that quotes a price from block one without anyone depositing liquidity. Once the curve sells out, the launch graduates into a JoseonSwap pool, and the liquidity that opens that pool is locked permanently. After that it behaves like any AMM pair, and the price chart carries on without a break.
Good to know before you trade#
- Names, symbols, and images can be copied. The token address is the only thing that identifies a launch.
- Prices come from the venue a token is currently on: its curve, or its pool once it has graduated.
- Launches can be volatile, thin, or go to zero. Nothing here is vetted or endorsed.
How a launch moves#
create ──▶ curve ──▶ graduation ──▶ pool
buys and one JoseonSwap pair,
sells transaction liquidity locked| Stage | Where your trade goes | What ends it |
|---|---|---|
| Curve active | the launch's bonding curve | the 800M curve allocation sells out |
| Graduating | trading is paused | the migration finishes, inside that same buy |
| Pool active | the JoseonSwap router | nothing, this is the end state |
A launch only moves forward. Graduation is not a queue or a job someone runs later: it happens inside the buy that finishes the curve, so nobody sits in the middle state waiting.
Every launch has the same shape#
There are no per-token knobs. That is what makes the graduation price knowable in advance, and what lets the migration run in a single transaction.
| Total supply | 1,000,000,000 (18 decimals) |
| Sold on the curve | 800,000,000 |
| Held back for the pool | 200,000,000 |
| Net ETH the curve collects | 3.6 ETH |
| Graduation price | 0.000000018 ETH per token |
| Graduation FDV | 18 ETH |
| Pool size at graduation | 7.2 ETH of TVL |
Where to go from here#
Want to try it? The quickstart covers wallet setup and your first launch in a few minutes.
Curious how the pricing works? Bonding curve derives every figure above from two starting numbers, then fees covers who earns what.
Building something? Indexer API is the read side, contract calls is the write side, and both are available now.