Integration Guides

These guides cover the common ways to integrate with Bush liquidity: indexing pools, quoting swaps off-chain, executing swaps, and adding or removing liquidity. Everything here talks to the contracts directly, from Javascript/TypeScript or Solidity; there is no SDK layer to learn.

If you are building an aggregator, solver or router, start with the Aggregators section. It walks through fetching pool state, tracking it with events, quoting with the exact off-chain maths in @bush.fi/mathsopen in new window, and executing through the prepaid Aggregator Routers.

All pool factories approved for Bush, together with their reference maths in TypeScript, Python and Rust, live in the bush-pool-factoriesopen in new window repository. If you are building a new pool type, see Contributing a Pool Factory.

For interface APIs, ABIs and deployment addresses see the Developer Reference. Individuals are encouraged to contact our developers via Discordopen in new window to request further assistance.

Aggregators

Index Bush pools, price them off-chain with exact maths, and route swaps through the Aggregator Routers

Swapping

Single and multi-path swaps through the Router and Batch Router, from Javascript or Solidity

Add Liquidity

How to add tokens to a pool

Remove Liquidity

How to remove tokens from a pool

Price Impact

How to calculate price impact for swap, add and remove actions

Pool Maths & Factories

Exact off-chain maths for every approved pool type, and how to contribute a new factory