Build on Poolix

Poolix is an interface to public liquidity contracts on Robinhood Chain. It holds no custody, runs no private orderbook, and adds no fee of its own. Everything the interface shows is read from contracts you can query yourself.

Network

Network: Robinhood Chain
Chain ID: 4663
Native currency: Ether (ETH), 18 decimals
RPC endpoint: https://robinhood-rpc.publicnode.com
Explorer: https://robinhoodchain.blockscout.com

Robinhood’s own endpoint, https://rpc.mainnet.chain.robinhood.com, is rate limited and is not reachable from every network. Poolix defaults to a public gateway and reads NEXT_PUBLIC_RPC_URL when you want a different one.

Architecture

Liquidity sources sit behind one interface, so the swap surface does not know which protocol quoted it. Today the only implementation is Uniswap v2; adding v3, v4 or Poolix’s own pools means adding an adapter, not changing the UI.

services/liquidity/types.ts

export interface LiquiditySource {
  readonly id: LiquiditySourceId;
  getAvailability(): SourceAvailability;
  /** Resolves to null when this source has no route for the pair. */
  quoteExactIn(request: ExactInSwapRequest, signal?: AbortSignal): Promise<SwapQuote | null>;
  buildSwap(params: SwapExecutionParams): PreparedCall;
}

Liquidity management stays source specific on purpose: v2 uses fungible LP tokens, v3 and v4 use ranged positions, and v4 identifies pools by ID rather than address. Forcing those into one interface would leak the differences anyway.

Data availability

Poolix shows -- wherever a number cannot be derived from a source it can verify. That is a deliberate boundary, not a gap waiting to be filled with an estimate.

Reserves, supply, positions: Read per request from the pair contract
Quotes: router.getAmountsOut, confirmed against local v2 math
Token prices: Mid price from pool reserves, denominated in ETH
TVL in USD: Unavailable — no verified price feed wired in
Volume, fees, APR: Unavailable — the public RPC rejects archive queries
Holders, active users: Unavailable — needs a transfer and transaction index

Verifying what Poolix ships

Every address in the interface is a constant in the repository, checked against the chain by a script you can run yourself. It asserts the router points at the factory, the factory’s WETH matches, pair addresses derive correctly from the canonical init code hash, and the deployed fee arithmetic matches Poolix’s own.

Terminal

npm run verify:chain
npm run verify:chain -- testnet

Unaudited

Poolix’s interface code has not been audited, and it routes through third-party contracts that Poolix did not deploy. Read the addresses on the contracts page and check them on the explorer before trusting anything with funds.

API and SDK

Poolix does not publish a hosted API or an npm SDK yet, and this page will not pretend otherwise. What exists today is the service layer in this repository — services/liquidity, services/pools and services/tokens — which has no React dependency and can be imported directly. See Integration.