FAQ

Basics#

Is this on mainnet?#

No. GIWA Sepolia only, with test ETH. GIWA mainnet is still in development, and the plan is to re-derive parameters against real gas and redeploy rather than port testnet numbers straight over.

What does it cost to launch a token?#

Nothing beyond gas, about 0.0000023 ETH. Whether mainnet adds a small anti-spam fee is undecided.

Can I change my token's name, supply, or image?#

Name, symbol, and supply are on-chain and permanent. There is no mint and no burn. The image and description live off-chain and can be updated by the creator; the tokenURI() pointing at them cannot be changed by anyone.

How long does graduation take?#

It is not a waiting period — it happens inside the buy that sells out the curve. What varies is how long the curve takes to sell out, which depends entirely on demand.

Trading#

What are the fees?#

2% on curve trades, 0.30% on swaps. Full breakdown of who receives what is on fees.

What if I buy more than the curve has left?#

The contract uses only what it needs and refunds the rest in the same transaction. You cannot overpay into a graduation.

Can I sell before graduation?#

Yes. Curve sells are available the whole time the curve is active, priced by the same invariant in reverse. You cannot sell more than the curve has circulated.

Why did my trade revert with NOT_ACTIVE?#

The launch graduated. Route through JoseonSwapRouter instead of the curve. A UI holding stale state is the usual cause.

Why did my trade revert with SLIPPAGE?#

Someone traded between your quote and your transaction. Re-quote and retry, or widen your minimum-out.

Is there MEV or front-running here?#

On the curve, ordering matters like any AMM — an earlier buy gets a better price. What is specifically prevented is front-running a graduation: nobody but the launch factory can create the pair, and nobody but the migration manager can seed it.

Liquidity#

Can liquidity be pulled after graduation?#

Not the initial position. It is held by a locker with no withdraw function. Liquidity added by others afterwards belongs to them and can be removed by them.

How much liquidity does a graduated pool start with?#

3.6 WETH against 200,000,000 tokens — 7.2 ETH of TVL at an 18 ETH FDV.

Can I add liquidity to a graduated pool?#

Yes, exactly like any V2 pair, and you receive LP tokens for your share.

Creators#

When and how do I get paid?#

Curve fees accrue as people trade and are claimed with claimCreatorFees(recipient) on your curve. After graduation, 0.15% of swap volume accrues in the pair and is claimed with claimCreatorFees() there. Both are pull-based; nothing expires.

Do my fees stop after graduation?#

No, they change source. Curve fees are capped at roughly 0.051 ETH total; swap fees are 0.15% of volume indefinitely. Past ~34 ETH of post-graduation volume, swap fees have paid you more than the entire curve did.

Can I split fees between wallets?#

In the UI, yes, but it is display metadata — on-chain accrual targets one address. For enforceable splitting, set feeRecipient to a splitter contract.

Can I hand a token over to someone else?#

The fee recipient can be changed, which moves future fees. Fees already accrued stay with the previous recipient. It does not affect the token, the pool, the price, or the locked liquidity.

Building#

Is there an SDK?#

No, and deliberately. The contracts are simple enough that viem plus a few ABI fragments covers it, with nothing to keep in sync across stack versions. See contract calls.

Do I need an API key?#

No. Reads on api.joseon.fun are public and CORS-open.

Why are amounts strings in the API?#

They are base-unit integers, and a 1e27 token supply overflows a JS number. Parse with BigInt.

How fresh is the API?#

A cron runs every minute at a 5-block confirmation depth, and the app nudges POST /api/sync after a write, so a new launch usually appears within seconds.

Why is my token unverified on the explorer?#

Blockscout does not match freshly deployed per-launch contracts against already-verified bytecode. A repo script submits them — see network.

Risk#

Has this been audited?#

Internally, with fuzzing, invariant tests, and static analysis. Not by a third party. Security is specific about what that covers and what it does not.

What can the team do to my token?#

Not mint, not move balances, not drain a curve, not unlock liquidity, not repoint metadata. Admin keys control the protocol's own fee destination and which launch factories may graduate. The full list is on security.

Can I lose money?#

Yes. It is a bonding curve on testnet software with no audit — treat every launch as a total-loss possibility, and do not bridge real value in.