[ Method ]

Sources and limits

Where every number comes from, what it assumes, and what it cannot tell you.

Sources

Elysium mainnet, chain id 99901, gas in HYPE, read through the public RPC https://rpc.elysium.kinetiq.xyz. Each address below was checked on chain on 11 November 2026: code present, the contract name verified on the Elysium explorer, and the reads we use answer.

ContractAddressHow it was confirmed
Uniswap v4 PoolManager (v4 e2e1)0xe2e105d3f7209a9da11f83ccf3e7398a753823f1Emits v4 Swap events; verified as PoolManager; same runtime size as the others. PositionManagers: 0x73a3098520404f4ea174788bab5f0e04810e6460, 0x1d1c51b9d07fd27d36412a2b66cc23d19eb3e518 (poolManager() returns this address).
Uniswap v4 PoolManager (v4 06c6)0x06c63714fbf1f5753017123e2fcfdede4540b2c4Emits v4 Swap events; verified as PoolManager; same runtime size as the others.
Uniswap v4 PoolManager (v4 5fb0)0x5fb015a49f5b35073f9ce01c2adb287a75f89600Emits v4 Swap events; verified as PoolManager; same runtime size as the others. PositionManagers: 0x1f9b957071228a3190280e062cc62a3f66b6a13a (poolManager() returns this address).
Uniswap v4 PoolManager (v4 b308)0xb308b5df891c300a5f5a5b8fdbc30108ba842490Emits v4 Swap events; verified as PoolManager; same runtime size as the others.
v3-style factory (v3 1707)0x1707327f626496a7b5b3872e7e4d2879df7d7a9fA pool is counted only when this factory's getPool(token0, token1, fee) returns that pool's address.
v3-style factory (v3 8c60)0x8c60243181370bda9a7d1a45b1249a8263da0158A pool is counted only when this factory's getPool(token0, token1, fee) returns that pool's address.
v3-style factory (v3 29cd)0x29cd8852ff040cfe74fb20277a121ed1293afb41A pool is counted only when this factory's getPool(token0, token1, tickSpacing) returns that pool's address.
v3-style factory (v3 efd7)0xefd7a089d3057f05189b05f74ffcf30610c42891A pool is counted only when this factory's getPool(token0, token1, tickSpacing) returns that pool's address.
WHYPE (listed token)0xba876237b0f021a6c6d852d6c26e107997cc5e81symbol() and decimals() read on chain (18 decimals).
USDC (listed token)0xb47c4c8f73f009cc0c0d3f92b388d13e293f0b65symbol() and decimals() read on chain (6 decimals).
KNTQ (listed token)0xe45a355d9e9cad2ad85f2d03e3ee3102a036acf0symbol() and decimals() read on chain (18 decimals).

Dollar prices: HYPE and KNTQ from Montra's public stats API (https://api.montramarkets.xyz/api/stats), USDC counted at $1. The site says so beside every dollar figure it derives.

Method

  • Explorer: Swap events of the last ~34,000 blocks (about one hour) from the four PoolManagers and all v3-style pools, split into spans the node accepts (it returns at most 10,000 logs per query). A span that cannot be read is listed as missing, never skipped silently.
  • Volume = amounts swappers paid in. Fees paid = that input × the fee in each v4 Swap event (or the v3 pool's fee()).
  • Pool state: v4 pools through the PoolManager's extsload (slot0, fee growth, liquidity); v3 pools through slot0() and liquidity().
  • Tick math: sqrt price at a tick, tick at a sqrt price, liquidity for amounts and amounts for liquidity, all in exact integers, tested against 100 (price, tick) pairs written by Elysium's own pools.
  • Planner fees = window fees scaled to a day × your share of active liquidity × the scenario's volume factor × the median share of time in range.
  • Time in range: 1,500 seeded random walks of the log price at the measured (or your) daily volatility, hourly steps, zero drift. The 10th, 50th and 90th percentiles are shown.
  • Gas in the planner: 400,000 gas to open and 250,000 to close, at the current gas price. Mints read on 11 November used about 380,000 gas.
  • Uncollected fees: the pool's fee growth inside the range minus the position's last recorded value, times its liquidity, exactly as the pool settles them.
  • Breakdown: pool and position state at the mint block (archive read) against now. Fees since mint are shown only while the liquidity is unchanged.

Risk questions

Can I lose money providing liquidity?

Yes. When the price moves, a concentrated position ends up holding more of the token that fell. That can cost more than the fees it earned. The planner shows this as value against holding.

Why no APR?

An APR takes a short window of fees and stretches it over a year. It hides time out of range, price moves and gas. Elyearn shows net outcomes under stated scenarios instead.

Does Elyearn hold or move my funds?

No. It reads the chain. The ElyearnRangeBook contract stores plans and holds no funds. Automated rebalancing is planned and would come only after implementation and security testing.

Does holding $ELYEARN pay me anything?

No. Holding $ELYEARN gives no income from any liquidity position, and every tool works without it.

Can a token be fake?

Yes. Anyone can deploy a token with any symbol. Only HYPE, WHYPE, USDC and KNTQ are on our checked list; other tokens are shown with their address, and a symbol copying a listed one is flagged.

Is the contract safe?

ElyearnRangeBook is new and has not been through an outside security review. It holds no funds, has no admin and no upgrade path, and only makes bounded read-only calls. Its tests and a written self-review are in the repository.

Limits

  • Fees are not guaranteed. A range earns only while the price is inside it, and a price move can cost more than the fees earned.
  • No yield headline. Every estimate is a scenario with its assumptions shown next to it; the last hour's activity is not a forecast.
  • Volume and fees in the explorer cover the last window of blocks shown on the page, summed from Swap events. Pools with no swap in that window are not listed.
  • Dollar values use HYPE and KNTQ prices from Montra's public API and USDC at $1. Other tokens get a dollar price only from a pool against one of those with enough depth near the price; otherwise no dollar value is shown.
  • Token names and symbols come from the token contracts themselves. Only HYPE, WHYPE, USDC and KNTQ are on the checked list; any other symbol is shown with its address, and a symbol that copies a listed one is flagged.
  • Depth within 2% assumes the active liquidity stays the same across that band.
  • The position breakdown compares the state at the mint block with now. If liquidity was added or removed since, fees since mint are not shown.
  • Elyearn reads the chain and never moves funds. Automated rebalancing is planned, after implementation and security testing.
  • Holding $ELYEARN gives no income from any liquidity position, and the tools work without it.

Planned, not built

  • plannedAutomated rebalancing (moving funds when a range is left), only after the code is written, tested and reviewed for security.
  • plannedAdvanced analytics subscription.
  • plannedMore alerts: push or email, larger quota.
  • plannedAPI credits.
  • planned$ELYEARN as the way to pay for those, once they exist. Unproven until then.