Skip to content

Documentation

Docs

What eDesk does

eDesk is an arbitrage intelligence and execution-preparation workspace for Elysium. It compares supported markets for the same asset, quotes both legs of a route at the size you enter, and estimates what remains after pool fees, price impact and gas. It tells you whether a route is indicative, quoted, simulated, stale, unavailable or supported for execution, and it prepares transactions for your review when execution is supported. It never sends a transaction on its own.

Core analysis is deterministic: every number comes from an on-chain call, a public API response, or your own inputs. There is no AI feature, no eDesk token and no partnership with any venue.

Supported integrations

Network: Elysium mainnet, chain id 99901, HYPE gas, 100 ms blocks, settling to HyperEVM (chain id 999). Verified on 2026-11-10 against Kinetiq’s docs and the chain registry. The Vulcan Forged network of the same name (chain ids 1338 and 1339) is a different chain and is rejected.

SourceTypeUsed forExecution
Uniswap v4 (PoolManager, StateView, V4Quoter)On-chain AMMPool discovery, mid price, liquidity, exact-input quotesQuote only in this version
Uniswap v3 (Factory, QuoterV2, SwapRouter02)On-chain AMMPool discovery, state, exact-input quotesPrepared via SwapRouter02.exactInputSingle
Uniswap v2 (Factory, Router02)On-chain AMMPair discovery, reserves, getAmountsOutPrepared via Router02.swapExactTokensForTokens
KyberSwap aggregator (chain “elysium”)Public APIExact-input quotes across Pharaoh, Metric and Uniswap pools; gas estimatePrepared via calldata from /route/build to the MetaAggregationRouterV2
HyperCore spot order book (@107)Public API (Hyperliquid info)Mid price and a size-aware book walkReference only, different chain

Contract addresses: WHYPE 0xbA876237B0F021A6c6D852d6c26E107997cC5E81, USDC 0xb47c4C8F73F009CC0C0d3f92B388d13E293F0B65, v4 PoolManager 0xE2e105d3F7209A9DA11f83cCf3E7398a753823F1, V4Quoter 0x379F556c5a748BD7Cc9baF0F7A344094Ac1814f5, QuoterV2 0x204FAca1764B154221e35c0d20aBb3c525710498, SwapRouter02 0x2d01411773c8C24805306E89A41F7855C3c4Fe65, v2 Router02 0xE783DE89a7F0408687f051e3E6D0BEb62719EbAd, KyberSwap router 0x6131B5fae19EA4f9D964eAc0408E4408b66337b5. The full list with explorer links and how each was verified is on Sources.

Supported assets are curated: HYPE (native), WHYPE and USDC, matched by contract address on chain id 99901. Native HYPE and WHYPE are tracked as two forms of one asset; a route whose legs need different forms gets an explicit wrap or unwrap step with its own gas.

Quote methodology

  1. Discover the pools for the market (v4 Initialize events filtered by currency pair, v3 factory lookups per fee tier, the v2 pair) and read their state: liquidity and mid price.
  2. Quote the buy leg on every quotable venue at your exact size (base → asset). Pools without liquidity are listed but not quoted.
  3. Quote the sell leg on every other venue using each buy leg’s actual quoted output as the input (asset → base). For KyberSwap, exact sell quotes are fetched within the API’s rate budget; the remaining pairings are scaled linearly from the nearest exact quote (within 2 %) and marked indicative.
  4. Compute the gross result (sell output − input), the headline spread between the two venues’ mid prices, gas for both legs plus extras, the gas conversion into the base denomination, and the net result.
  5. Classify the route and sort: execution-supported, quoted, indicative, stale, unavailable.

All amounts are integers in token units; prices and ratios are 18-decimal scaled integers. Floating point is used only to render.

Fee accounting

Exact-input quotes from the Uniswap quoters, the v2 router and the KyberSwap API already include the pool fee and the price impact at that size. eDesk therefore subtracts only what is not inside the quotes: gas (both legs, approvals, wrap/unwrap) and explicit extra costs. The pool fee tiers are displayed as information and never subtracted a second time. The HyperCore book walk excludes the taker fee because it depends on the account’s tier; its routes are always indicative.

The manual calculator uses one explicit convention: buy fee on the amount spent, sell fee on the proceeds, gas and extra costs flat in the base currency, percentages as percent (0.3 = 0.3 %), every step rounded down. Break-even is the sell price at which the net result is exactly zero.

Price impact

Your trade size changes the opportunity. The headline spread compares mid prices and ignores size. The size-aware result uses the quoters, which walk the pool’s liquidity for the exact input. The difference between the two is the impact of your size plus fees. On shallow pools the difference is dramatic: several Uniswap v3 and v2 pools on Elysium hold dust, and routes through them show large negative results, which is the honest answer.

Data freshness

  • The shared scan for a size is refreshed at most every 8 seconds; pages poll it every 10 seconds. Elysium blocks arrive every 100 ms, so a scan is a snapshot, not a tick-by-tick feed.
  • Each quote carries its timestamp and, for on-chain sources, the block number. A route whose oldest quote is past 30 seconds is marked stale.
  • The route page re-quotes before the review dialog opens; the execution gate requires quotes under 20 seconds old.
  • The Sources page shows the last successful update, the staleness threshold and the poll interval per source.

Atomic versus sequential execution

Same-chain sequential: two separate transactions on Elysium. The first leg can succeed while the second fails, reverts for slippage, or becomes unfavourable. eDesk re-quotes the sell leg at the amount actually received before the second review.

Same-chain atomic: not available. eDesk has no verified atomic executor contract and does not label sequential swaps as atomic arbitrage. If an experimental executor is ever developed, it will be isolated from production, tested locally and labelled unaudited; it will not be activated with user funds.

Cross-chain observation: routes with a HyperCore leg. Acting on them needs inventory on both sides, a bridge or a withdrawal (Elysium → HyperEVM withdrawals have a challenge period of about 5.5 days), HyperCore trading fees and non-atomic settlement. eDesk only observes these.

Execution unlocks only when every gate passes: verified venue integration for both legs, complete fresh quotes, wallet on Elysium, sufficient base balance, sufficient HYPE for gas, and understood approvals. Approvals are exact-amount. The review dialog lists the network, the contract called, tokens spent, expected and minimum outputs, approvals, gas and limitations, then simulates from your address before enabling the signature.

Simulation limitations

A simulation is an eth_call of the exact calldata from your address against the latest block. It proves the call did not revert at that moment with that state. It does not guarantee inclusion, ordering, the same output, or that a pool’s hooks behave the same in a real block. Quoter calls are also simulations: the V4Quoter and QuoterV2 execute the swap in a reverting call, which is why they return normally through Multicall3.

Wallet permissions

  • Connecting reads your address and chain. eDesk never requests a seed phrase or a private key, and never asks for a signature or transaction until you press the button in a review dialog.
  • The only connector is the injected provider (EIP-1193 / EIP-6963). Announced wallets are preferred over the generic injected entry to avoid duplicate connections.
  • Reads go through a same-origin relay (/api/rpc) that allowlists read methods and rate-limits per client. Transactions are sent by the wallet through its own RPC.
  • Network mismatches are detected from the wallet’s chain; eDesk offers to add or switch to Elysium with the public RPC and explorer.
  • Records of snapshots and submitted transactions live in this browser’s localStorage, scoped by chain id and wallet address.

Configuration and deployment

pnpm install
pnpm dev            # http://127.0.0.1:28100
pnpm check          # typecheck + lint + unit tests
pnpm build && pnpm start   # production on :28110
pnpm verify:network # re-run the on-chain verification, refresh the pool snapshot

Environment (see .env.example; nothing is required): ELYSIUM_RPC_URL (server-side provider URL; the public endpoint by default), KYBERSWAP_CLIENT_ID (identification header), HYPERLIQUID_INFO_URL, SCAN_SIZES (warm sizes, default 100,1000), NEXT_PUBLIC_SITE_URL. No API key is exposed to the browser. The app has no server-side writable state: caches are in-memory per instance, which suits serverless hosting; multi-user persistent state is not needed because records are local to each browser.

Rate limits: the scanner is cached per size; custom sizes are limited per client; the relay allows 120 requests per 10 seconds per client and 12 per second per instance; KyberSwap calls are capped at the API’s 10 per 10 seconds. Upstream calls have timeouts (8–12 s) and bounded retries with backoff; a failed refresh keeps serving the last good snapshot marked stale.

Known limitations

  • Uniswap v4 pool legs are quote-only: the Universal Router + Permit2 flow is not integrated, so the deepest HYPE/USDC pools can be analysed but not executed from eDesk. KyberSwap routes through those pools and can be executed.
  • KyberSwap sell quotes beyond the rate budget are scaled from a nearby quote and marked indicative; the route page fetches an exact quote.
  • When the buy leg’s observed output differs from the scan’s buy output, a KyberSwap sell leg cannot be rebuilt for the exact amount without a new scan at that size; the review refuses to sign a mismatched amount.
  • Native HYPE received from routers other than KyberSwap leaves no event log, so the observed output of such a leg is unavailable.
  • There is no indexer: the portfolio’s transaction list contains only what this browser recorded or you added by hash; the explorer at https://elysium.kinetiq.xyz has the full history.
  • The USDC contract was matched by address and on-chain metadata; its issuer and bridge origin were not independently verified.
  • Gas conversion uses the deepest on-chain HYPE/USDC mid or the HyperCore mid; when neither is fresh, net results are marked incomplete rather than guessed.
  • The public RPC is shared and rate-limited; Kinetiq asks production traffic to use a provider endpoint (ELYSIUM_RPC_URL).

$EDESK token

No $EDESK contract address has been announced: every surface on this site says “CA: Soon”. When an address is published it appears on the token card of the landing page, in the footer and here, and is announced from @elysiumdesk. Any address circulating before that is not ours.

How publication works: the address is never typed into the site by hand. The operator runs the publish script, which checks the contract on Elysium (chain id 99901) for bytecode and an ERC-20 surface, writes it to the deployment’s environment, and redeploys. The token has no role in the scanner’s calculations.

Risk notes

  • Estimated net result is an estimate, not a guaranteed profit. Arbitrage is not risk-free.
  • Sequential routes are not atomic: one leg can succeed while the next fails or prices differently. Slippage, MEV and ordering are outside eDesk’s control.
  • A successful simulation is not a guarantee of execution. Zero slippage is never claimed; minimum outputs enforce your tolerance.
  • eDesk is not audited and has no partnerships or guarantees. The $EDESK token, when published, gives no rights over the scanner or its estimates. Nothing here is investment advice.