Documentation
Tartarus
Tartarus is a permissionless token launchpad on Elysium, Kinetiq's Arbitrum Orbit chain settling on HyperEVM. Anyone can launch a token in one transaction. There is no bonding curve and nothing to graduate: the token trades on a Uniswap V4 pool from its first block, and that pool holds the whole supply in a single position that is locked forever.
New here? Start by adding Elysium to your wallet.
What a launch is#
| Supply | Exactly 1,000,000,000 tokens, 18 decimals. No mint, no burn. |
| Where the supply goes | 100% into one single-sided V4 position, owned by a locker with no withdrawal function |
| Team or presale allocation | None. A creator who wants tokens buys them, like everyone else |
| Starting price | Set by the launch config. Config 0 opens at a market cap of about 36 HYPE |
| Quote asset | Native HYPE today. The contracts also support owner-approved ERC-20s |
| Swap fee | 1% to 10%: a fixed 0.5% to the protocol plus 0.5% to 9.5% chosen by the creator, frozen at launch |
| Launch fee | 0.001 HYPE, read it live from launchFee() |
Fees are taken in the pool by a shared hook, converted to the quote asset, and credited to an escrow that recipients claim from. A creator can send their share to the token's holders instead of themselves. See Fees and Holder rewards.
What you actually call#
| To | Call |
|---|---|
| launch with no opening buy | factory.launchToken |
| launch and buy in one transaction | launchAndBuy.launchAndBuy |
| buy or sell | Uniswap's UniversalRouter, V4_SWAP |
| quote a trade | Uniswap's V4Quoter, or GET /v1/tokens/:id/quote |
| collect fees you are owed | feeEscrow.claim() or claimToken(token) |
| claim holder rewards | distributor.batchClaim on the token's own distributor |
There is one pool for every token, and no phase to branch on. If getLaunchedToken(token).exists is
true, the token is tradeable.
Where to start#
- Quickstart launches a token, trades it and collects the fees, in code you can run.
- Approvals says which contract pulls your funds. Most failed integrations start here: native HYPE needs no approval at all, and an ERC-20 swap needs two.
- Elysium network covers the RPC situation, which is unusual and decides how your transactions reach the chain.
Building with an AI#
There is a Use with AI button at the top of every page. It copies the page, opens a Claude conversation pointed at the full reference, or installs a Claude Code skill.
/llms-full.txt | All of this documentation as one document, with every address, signature, selector and event topic. |
/llms.txt | A short index, following the llms.txt convention. |
/skill.md | A Claude Code skill. Save it as .claude/skills/tartarus/SKILL.md. |
/documentation/<page>.md | Any single page as raw markdown. |