📜Contract Reference

Solidity interfaces for the LiquidCore Router and pool contracts.

Use the Router for execution. Direct pool calls are optional when you already know the pool address.

Router

Chain	chainId	Router
HyperEVM	999	0x625aC1D165c776121A52ff158e76e3544B4a0b8B
Robinhood Chain	4663	0x322F277BfB7Ba9c196194ad18011377A0fF55Fb3

Prefer the routerAddress returned by the quote API.

Discovery functions

function getPools() external pure returns (address[] memory pools)
function getPoolForPair(address tokenA, address tokenB) public view returns (address)

Off-chain, list pools with GET /liquidcore/pools?chainId=....

Execution functions

function swap(
    address tokenIn,
    address tokenOut,
    uint256 amountIn,
    uint256 minAmountOut
) external returns (uint256 amountOut)

function swap(
    address tokenIn,
    address tokenOut,
    uint256 amountIn,
    uint256 minAmountOut,
    bytes32 refCode
) external returns (uint256 amountOut)

refCode is checked against an on-chain allowlist (RefCodeRegistry). Invalid codes do not accrue referral allocation and do not block the swap.

Quote functions

function estimateSwap(
    address tokenIn,
    address tokenOut,
    uint256 amountIn
) external view returns (uint256 amountOut)

function estimateSwapBatch(
    address tokenIn,
    address tokenOut,
    uint256[] calldata amountsIn
) external view returns (uint256[] memory amountsOut)

function getReserves(address tokenA, address tokenB)
    external view returns (uint256 reserve0, uint256 reserve1)

estimateSwapBatch is used by the REST API quote endpoint for CSV amountIn inputs. getReserves reverts with NoPoolForPair if no pool exists.

Referral functions

function getRefClaimable(address tokenA, address tokenB, bytes32 refCode)
    external view returns (uint256 amount0, uint256 amount1)

function claimRefFees(address tokenA, address tokenB, bytes32 refCode)
    external returns (uint256 amount0, uint256 amount1)

function distributeRefFees() external

See Referrals for usage details.

Router errors

error NoPoolForPair();
error TransferFailed();

---

Direct pool interface

Discover pool addresses via GET /liquidcore/pools?chainId=.... Do not hardcode them — they differ by chain and change over time.

function getTokens() external view returns (address token0, address token1)
function getReserves() external view returns (uint256 reserve0, uint256 reserve1)
function swap(address tokenIn, address tokenOut, uint256 amountIn, uint256 minAmountOut) external returns (uint256 amountOut)
function swap(address tokenIn, address tokenOut, uint256 amountIn, uint256 minAmountOut, bytes32 refCode) external returns (uint256 amountOut)
function estimateSwap(address tokenIn, address tokenOut, uint256 amountIn) external view returns (uint256 amountOut)
function estimateSwapBatch(address tokenIn, address tokenOut, uint256[] calldata amountsIn) external view returns (uint256[] memory amountsOut)
function getRefClaimable(bytes32 refCode) external view returns (uint256 amount0, uint256 amount1)
function claimRefFees(bytes32 refCode) external returns (uint256 amount0, uint256 amount1)

Common direct-pool errors

error InvalidToken();
error ZeroAmount();
error SlippageExceeded();
error InsufficientReserve();
error TransferFailed();
error InvalidRefCode();
error UnauthorizedRefCodeClaim();
error RefCodeClaimLocked();

Referral usage details are documented in Referrals.