Skip to content
HYPE price unavailable

Docs

How a token gets launched on Home Of Elysium, where each fee is sent, and every contract with its address and ABI.

Built on Uniswap

Pools on Home Of Elysium are not custom contracts. Each one is created inside the Uniswap v4 PoolManager on Elysium, and swaps are sent through Uniswap’s standard UniversalRouter. Our only addition is a hook that enforces each token’s fee rules.

Because the core is reused instead of copied, there is no custom pool code to learn. Pools, quotes and swaps behave exactly like any other Uniswap v4 pool, so the wallets, routers and tools you already use keep working as they are.

Launching a token

One transaction deploys the token, opens its Uniswap v4 pool and sets up the fee routing; gas is the only cost. Supply is fixed at 1,000,000,000 tokens, all of it deposited into the pool at launch, so nothing is reserved for the team.

Trading starts from a 40 HYPE market cap, with prices following a constant-product curve: buying half of the supply costs roughly 40 HYPE, and three quarters costs roughly 120 HYPE. Each buy lifts the price and each sell lowers it.

  • Swap fee: 1% to 5%, set by the creator and permanent for that pool.
  • Anti-snipe: optional. Buys start as high as 30% and ease down to the regular fee within at most 15 minutes; any charge above the regular fee is burned.
  • Scheduled opening: optional. The creator can delay the start of trading by up to 30 days.
  • Quote asset: HYPE by default.

Launch a token

Fees

Each trade’s swap fee is paid in the quote asset. The protocol takes 30%; the other 70% is split however the creator chose at launch.

  • Creator: goes to whoever currently holds the creator NFT of that token.
  • Buyback and burn: buys back the token from its pool and burns it.
  • Holder rewards: distributed to token holders, in the quote asset.

Together the three shares make up the full creator side, and they stay locked from launch.

Buybacks and holder rewards

Fees reserved for buybacks and holders are not spent right away. The FeeVault holds them until a pool reaches 0.01 HYPE, a limit set per pool at launch. Only the FeeExecutor can move that balance, and just for two things: buying and burning the token, or paying holders.

Rewards go out in rounds, at most one per pool every 10 minutes. A wallet qualifies with 1,000,000 tokens or more (0.1% of the supply) and is paid according to its balance. Pools, routers and other contracts hold tokens but are not real holders, so they are excluded.

$HOME

The $HOME token uses a buyback-and-burn model: out of the protocol’s 30% fee cut, 80% is spent buying $HOME and burning it, so more volume means less supply.

$HOME trades here like any other token, with no special treatment. Address: 0x4FfFCB7c03c1CAC14f54f88E0d1732FAA025f872. See the flywheel

Trading

Each token page includes a swap card. To price a trade it queries the V4Quoter, so the quote already reflects the fee in force, and it submits the swap through the UniversalRouter using your slippage limit. The first time you sell a token you approve Permit2 and the router, one approval apiece; every sale after that is a single transaction.

The app is deployed on Elysium (chain ID 99901) and gas costs HYPE. Got HYPE on HyperEVM? The bridge moves it over.

Network and RPC

If your wallet is on a different network, the switch button in the header takes it to Elysium and registers the network if needed. To add it manually, copy the values from the table below. Our RPC submits each transaction directly to the Elysium inbox contract on HyperEVM, so no outside relayer is involved, and most trades confirm within 20 seconds.

  • Network name
  • RPC URL
  • Chain ID
  • Currency symbol
  • Block explorer

Contracts and ABIs

All of these contracts are on Elysium (chain ID 99901). The explorer cannot verify them yet, which is why we post the ABIs here as JSON arrays, plus /abi/home.json with all of them.

Home Of Elysium

  • All contractsOne bundle with all the ABIs, the addresses and the start block
    ABI
  • PositionManagerThe v4 hook that launches tokens, opens pools and splits the fee
    ABI
  • TokenThe template each launched token is cloned from
    ABI
  • Creator NFTOne NFT per launch; whoever owns it earns the creator’s share
    ABI
  • FeeVaultEscrows buyback and holder funds until spent
    ABI
  • FeeExecutorThe vault’s only spender: buyback-burns, holder payouts
    ABI
  • FeeEscrowHolds the creator and protocol fee shares until claimed
    ABI
  • InternalSwapPoolSells the token fees it collects to buyers ahead of the curve
    ABI
  • PairedTokenRegistryAssets a new token can be paired against
    ABI
  • HomeInitialPriceHolds the launch market cap of each quote asset
    ABI
  • OracleKeeps a running record of every pool’s price
    ABI
  • TreasuryActionManagerCarries out operations on token treasuries
    ABI
  • Token treasuryA treasury per launch, found in that launch’s PoolCreated event
    ABI
  • NotifierContracts subscribe here to receive pool updates
    ABI
  • LaunchLibraryLinked into the manager; its events appear there
    ABI

Uniswap v4 on Elysium

Uniswap v4’s standard ABIs apply.

  • PoolManagerThe v4 singleton that holds every pool
  • UniversalRouterExecutes swaps submitted from the token pages
  • V4QuoterEstimates a swap through the hook before sending
  • Permit2Manages the router’s token approvals

Integrating

  • Finding launches: each launch makes the PositionManager emit PoolCreated, with the new token in its _memecoin field. Start scanning at block 266,498.
  • Pool key: the PositionManager exposes it through poolKey(token). The key uses a fee of 0 and a tick spacing of 60, and names the PositionManager as its hook. The swap fee itself is applied by the hook; read it, in basis points, with currentSwapFee(poolId, isBuy).
  • Trades: read prices from the V4Quoter and trade through the UniversalRouter, the standard Uniswap v4 route. Every swap makes the hook emit a PoolSwap event.
  • Launching: invoke launch(params) on the PositionManager. Whoever you give as creator is sent the creator NFT with the dev-buy tokens (premineAmount), and the caller pays. The website never launches with a dev buy below 0.001 HYPE; integrations should follow suit.

A question, or a token to share? Message us on X or Telegram.