Overview

Socket docs

Socket is a set of Uniswap v4 hooks and an app on Robinhood Chain. These pages cover trading and providing liquidity in the app, how the hooks work, and how to build on Socket.

Socket is a set of Uniswap v4 hooks and an app, on Robinhood Chain. Every v4 pool lives in one contract, PoolManager, and may name one hook: a contract PoolManager calls at fixed points of every swap and liquidity change. The hook's address is part of the pool's key, and the lowest 14 bits of that address say which calls PoolManager makes. Both are fixed for the life of the pool.

Because every pool lives in PoolManager, a router that integrates v4 once reaches every pool, whatever hook it has. Any pool can name any hook, and a router can't tell a reviewed hook from one that isn't. Socket writes hooks for Robinhood Chain and keeps an on-chain allowlist of the hooks its app routes through. SOCKET holders vote that list, and a share of the LP fees in pools on Socket's hooks buys SOCKET and burns it.

Start here#

SwapQuote every route through pools with no hook or a listed hook, and take the best.Provide liquidityPick a price range, deposit, collect fees, withdraw.Create a poolPick a pair, one of Socket's hooks, its settings and a starting price.How Socket worksPools, hooks, permissions and the order a swap runs in.

Hooks in the app#

Dynamic feeRaises the LP fee after the price moves and lets it decay while trading is calm.TWAP oracleRecords the pool's tick around every swap. Any contract can read a time-weighted mean.Range orderSell through a price range you choose, like a limit order. Orders from many owners share one pool.Hooks and permissionsWhat a hook's address says, and how any other hook joins the allowlist as an External hook.

Build on Socket#

Write a hookA v4 hook for Robinhood Chain: its flags, its address, and how it joins the allowlist.Socket on Uniswap v4Socket's contracts and how they sit around PoolManager.Route through SocketCheck the allowlist and quote pools on Socket's hooks from a router.Contract addressesRobinhood Chain and the Uniswap v4 contracts Socket uses.

Worth knowing first#

Socket runs on Robinhood Chain, an Ethereum layer 2 with chain ID 4663. ETH pays gas.
v4 pools can trade native ETH as itself, without wrapping. USDG is the chain's dollar stablecoin; USDC bridged in arrives as USDG.
The app routes only through pools with no hook or a listed hook. A listed hook that isn't one of Socket's shows as External hook.
Pools on Socket's hooks keep a buyback share of the LP fees their positions collect, 20% today. A swap pays the pool's fee and nothing more.
Positions are ERC-721 tokens from PositionManager, so they transfer like any NFT.
A pool's hook, permissions and settings never change. A different setup is a new pool.