Experimental onchain execution primitive

Range orders that don't rewind.

Bandbook is a gas-efficient onchain orderbook for one-way price bands. Place liquidity across a range, let swaps consume it, and lock the result forever once price crosses.

take profit band
buyback band
treasury band
backstop band
No resurrectionOnce crossed, liquidity converts once and cannot reverse.
No user loopsSwap cost is independent of how many users sit behind a tick.
No history scansClaims read frontier state, not every old fill lifecycle.

Passive like AMM liquidity. Final like an orderbook fill.

Normal AMM range orders can unwind when price reverses. Bandbook turns price bands into one-way execution: if the market crosses your band, the trade locks in.

1

Place a band

Deposit liquidity across a price range above or below the current market.

2

Let swaps cross it

As price moves, active liquidity is consumed by real orderflow.

3

Lock the result

Filled liquidity becomes claimable proceeds. Reversals cannot resurrect it.

4

Roll internally

Builders can recycle proceeds into opposite-side bids without extra token transfers.

Execution bands for users, vaults, and protocols.

Bandbook is not trying to replace every orderbook. It gives builders a compact primitive for passive one-way execution.

Take-profit ladders

Sell gradually into strength and keep the execution final, even if price snaps back.

Grid vaults

Buy low, sell high, and roll proceeds internally without offchain keeper choreography.

Treasury bands

Give DAOs transparent, onchain execution policies for buybacks, distributions, and sales.

Liquidation backstops

Pre-place executable liquidity across stress ranges instead of relying only on mempool races.

Router liquidity

Let aggregators consume passive price-band liquidity with final settlement semantics.

Launch curves

Distribute or accumulate inventory over a programmable band without a trusted operator.

Built for fragmented markets.

The prototype stores the market frontier instead of every user's fill history. The result is exact lazy accounting that stays flat across users, range width, and historical reversals.

139,932gas deposit at width 10, 1,000, and 100,000
28,350gas witness claim
34,445gas witness cancel
79tests passing, including fuzz and Base fork tests

A primitive between AMMs and CLOBs.

Bandbook is narrower than a full central limit order book and more final than reversible concentrated liquidity.

V3 range order

Capital efficient and passive, but execution can reverse if price crosses back through the range.

CLOB limit order

Precise and expressive, but matching engines and queue state are heavier onchain.

Put execution bands onchain.

Use Bandbook to build take-profit ladders, grid vaults, treasury execution, liquidation backstops, and router-accessible one-way liquidity.

Prototype ready for review