pool-sdk

TypeScript SDK for Pool Protocol — the CLOB matching engine for tokenized equities on Robinhood Chain.

Place orders, read the book, verify settlements. Orders match against resting limit orders first, then route unmatched remainder through Uniswap v4 pools for maximum fill.

Install

npm install @poolprotocol/sdk

Usage

import { PoolClient, buildSignedOrder } from '@poolprotocol/sdk';

const client = new PoolClient('http://localhost:3000');

// Sign and place a limit buy
// The engine matches against the book first, then routes remainder to the v4 pool
const signed = buildSignedOrder(
  { asset: 'AAPL/USD', side: 'buy', type: 'limit', price: 195.50, size: 100, trader: '0xabc' },
  process.env.TRADER_SECRET!
);

const { order, trades } = await client.placeOrder(signed);
console.log('placed:', order.id, '| trades:', trades.length);

// Read the book
const book = await client.getBook('AAPL/USD');
console.log('best bid:', book.bids[0]?.price);
console.log('best ask:', book.asks[0]?.price);

// Cancel
await client.cancelOrder(order.id);

API

PoolClient

Method	Returns	Description
placeOrder(params)	PlaceOrderResult	Place a limit or market order (book + pool hybrid fill)
cancelOrder(id)	{ cancelled: boolean }	Cancel an open order
getOrder(id)	Order	Fetch order by ID
getBook(asset)	OrderBookSnapshot	Current bids and asks
getTrades(asset)	Trade[]	Trade history for an asset (book and pool fills)

Signing

import { signOrder, verifyOrder } from '@poolprotocol/sdk';

const sig = signOrder({ asset, side, type, price, size, trader, nonce }, secret);
const valid = verifyOrder({ asset, side, type, price, size, trader, nonce }, sig, secret);

License

MIT