# Elysium

Pangea v3: every new launch, stock pairs and questions. Every launch since 2026-11-02 is a v3 launch, made by factory v3 on all five chains. This tab is everything new in v3: the factories, the fee hook, launch buys, stock pairs, the bridge price-gap fee, Solana, the security model, and plain-language questions and answers at the end. Bridging, routes and the APIs are in the V2 tab and hold for v3 except where this tab says otherwise.

- Elysium: Kinetiq's chain (Arbitrum Orbit) on HyperEVM. Gas is HYPE. Chain id 99901.
- An Elysium coin lives on Elysium only. 1B supply, all in one locked Uniswap v4 pool on our fee hook.
- Bridging: not yet. Elysium has no LayerZero; bridging out opens when LayerZero reaches Elysium.

## Contracts

| Contract | Address |
| --- | --- |
| Launch factory (ElysiumLaunchFactory) | 0x9Ae1f9844d885D0A646294ECf9DFCaf40C9903CB |
| Fee hook (PangeaFeeHook) | 0xfc020627A2F600c36ED4EBABd1e8124E6328a8cc |
| Liquidity locker | 0x0Ea7fb46415270f33fdD2fde7aA3e0Dc46E2E2BC |
| Dev buyer | 0x101c50201A6Bff01b4D197392aD1418276DcD8cf |
| Launch buys | 0x8C127d90A3C857C947e758e6a51669D21E56295B |
| Tokenomics v2.4 factory | 0xFc44Ae11EE9D0b2A38b1B7C59a3858C85C51a129 |
| Uniswap v4 PoolManager | 0xE2e105d3F7209A9DA11f83cCf3E7398a753823F1 |
| Universal Router | 0x1B341FDD55d56F8E08409A2C25DDFad93Eb03C1a |
| V4 Quoter | 0x379F556c5a748BD7Cc9baF0F7A344094Ac1814f5 |
| StateView | 0x27eD73aE0652fdCf71d6793412A7525f32bE9dfE |
| Permit2 | 0x000000000022D473030F116dDEE9F6B43aC78BA3 |
| WHYPE | 0xbA876237B0F021A6c6D852d6c26E107997cC5E81 |
| USDC.e | 0xb47c4C8F73F009CC0C0d3f92B388d13E293F0B65 |

## Launching

- You launch from your own wallet, in one transaction to the launch factory. No launch fee: you pay gas, plus your dev buy if you set one.
- Pair with HYPE, or with any ERC-20 on Elysium (paste its address). The page prices it live and refuses a token it cannot price.
- Opening market cap: at least $3,000, at the pair's live price. A taxed pair token is flagged before you launch.
- Hook fee: 0.3% to 5% of every trade, your choice, taken in the pair token. Split as on the other chains.
- An ERC-20 pair is approved to the factory first (exactly the amount needed, never unlimited).

## Trading

- Trades go through the Universal Router to the coin's Uniswap v4 pool, with Permit2 for a sale or an ERC-20 buy (exact amounts, short expiry).
- Confirmation takes about a minute: Elysium sends are batched through the HyperEVM Inbox. The page shows the simulated outcome at once and waits for the receipt; only the receipt counts.
- Minimum trade through our RPC: 0.005 HYPE on a HYPE pool; on an ERC-20 pool 0.005 WHYPE, 1 USDC.e, 1/10,000 of a token for the known pair tokens (Kinetiq, Unit, stocks, stables), or 1/100 of one whole token of any other pair token. A buy counts what it spends, a sale the least it takes back.

## Our public RPC

- Elysium RPC (wallets): `https://elysium-rpc.pangea.trade`
- Send status: `https://elysium-rpc.pangea.trade/status/<hash>`

- It relays Pangea trades only: launch and renounceMigration on the launch factory; claim on the dev buyer; deposit, depositFor, depositToken, depositTokenFor, reclaim and reclaimTo on launch buys; createVault on the tokenomics factory (its owner sending, at the account's next nonce, 5 a day); a Universal Router execute holding exactly one v4 swap on our hook; and approvals (ERC-20 approve to Permit2, the router or our contracts, and Permit2.approve to the router) of our coins, of a pair token the factory accepts, or of WHYPE and USDC.e, up to 30 a day per account.
- Calldata must be exactly its canonical encoding (no padding, no trailing bytes), at most 4 KB for a contract call.
- Gas limit at most 5M, and near what the transaction needs (at most twice the simulated gas, or simulated + 150k). Transaction types 0, 1 and 2; max fee at least 1.1x the base fee; nonce at most 3 ahead with no gap.
- Accounts with code (EIP-7702 delegated accounts, contracts) are refused. The next nonce must simulate without reverting.
- Your wallet adds Elysium with this RPC. Send anything else through another Elysium RPC.

| Answer | Meaning |
| --- | --- |
| -32003 | Not a Pangea trade ("this RPC relays Pangea trades only …"), or "below the minimum trade …", or "a tokenomics vault is created by its owner only", or for a pair token the relay cannot value "this quote token cannot be valued here" / "this quote is not listed: its daily allowance on this endpoint is used up" (an unlisted quote has an allowance of 20 trades a day per client). |
| -32000 | Refused with its reason: "would revert: …", "insufficient funds …", "nonce too low/high …", "max fee per gas below the current base fee …", "too many sends: slow down", "the relay is busy …". |
| -32005 | Rate limited ("rate limited: slow down"); HTTP 429 carries the same JSON-RPC body. |
| -32602 | Invalid params (pangea_txStatus: not a 0x 32-byte hash). |

pangea_txStatus:

```json
{"jsonrpc":"2.0","id":1,"method":"pangea_txStatus","params":["0x<32-byte L2 tx hash>"]}
```

| state | Meaning |
| --- | --- |
| queued | Accepted and recorded, not yet posted to HyperEVM (seconds). |
| posted | In a HyperEVM transaction, not yet mined (seconds). |
| confirming | Mined on HyperEVM, waiting for Elysium to include it (about a minute). |
| landed | Has an Elysium receipt: receiptStatus and landedBlock say how it ended. |
| replaced | Another transaction with the same nonce from this sender landed instead. |
| stuck | Will not land as it is (e.g. underpriced): why says why. Re-sign the same nonce with a higher fee. |
| unknown | Not held by the relay (not sent through it, or older than 24 h): read eth_getTransactionReceipt. |

Every answer has hash, state, from, nonce, simulated {ok, gasUsed, revert}, l1Tx, landedBlock, receiptStatus, why, note and firstSeen (null when unknown). GET /status/<hash> answers the same object as plain JSON.

## Bringing HYPE in

- From HyperEVM: a deposit through Elysium's own Inbox on HyperEVM (a retryable ticket naming your address); it reaches your same address on Elysium in minutes, from a plain wallet or a smart account (EIP-7702) alike.
- From another chain: a route provider (Relay) to HyperEVM first, then the Inbox deposit. Any wallet you sign for with your own key; not a contract wallet (its address is not yours on Elysium).
- Out of Elysium: no bridge yet.

## Fees, tokenomics, listing

- 80% of the platform's Elysium fees are held in HYPE as a pending buyback until PANGEA trades on Elysium; the buyback page shows it.
- Tokenomics v2.4 on Elysium: HYPE-paired coins only. The vault is the coin's fee wallet; its bind to the factory is made by the tokenomics executor within about 15 minutes of the launch. Rewards are HYPE, the coin, or another HYPE-paired Elysium coin of ours.
- Listing floor: every launch has its own page at once; Explore and the lists show it while its market cap, at the live price, is at least $3,000.

## Migration to the official Uniswap v4

- A pool may later move to the official Uniswap v4 by an admin migration: the venue switches, the liquidity moves, and the chart, trades and trading follow the coin's current pool (its earlier pools stay in its history).
- A creator can renounce migration for their coin (renounceMigration on the launch factory): then it is never moved.

## API and live feed

| Field | Meaning |
| --- | --- |
| launchChains | ["elysium"] for an Elysium coin. |
| chains.elysium | token, pool, poolManager, and quote (an ERC-20 pair; absent for HYPE). |
| elysium | creator, payee, feeBps, hook, previousPools (pool, poolManager, hook, tokenIsCurrency0, until) and the venue's router, quoter, stateView. |
| pools[].chain | "elysium"; pair {address, symbol, usd} for an ERC-20 pair; prices in HYPE and USD. |
| belowFloor | true while the coin's market cap is under the $3,000 listing floor (/api/pools still answers it; the lists hide it). |
| marketCapUsd | the coin's market cap in dollars at the live price (price x 1B supply): the listing floor's figure; null when unread. |
| trades | /api/history and the live feed carry Elysium trades with chain "elysium"; the creator's and fee wallet's trades are marked and not counted in the floor's volume. |

> **Note:** See also [fees](https://www.pangea.trade/app/docs#v3-fees) and [API](https://www.pangea.trade/app/docs?v=2#api).

Part of the Pangea documentation, V3 (every new launch) tab: https://www.pangea.trade/app/docs.md