Balancer V1
Discord
Search…
Home
Getting Started
Use Cases
FAQ
Core Concepts
Protocol
BAL Governance Token
Liquidity Mining
Security
Smart Contracts
Exchange Proxy
Smart Order Router
Smart Pools
On Chain Registry
Interfaces
Addresses
API
Migration to Version 1.0
Events
API Index
UML Docs
Guides
Interact via Etherscan
Using the SOR
Creating a Shared Pool
Creating a Smart Pool
CRP Tutorial
Smart Pool Use Cases
Testing on Kovan
Hackathons
Powered By GitBook
On Chain Registry

This page has been deprecated. V1 documentation is partially maintained here​

On Chain Registry

Summary

Stores a registry of Balancer Pool addresses for a given token address pair. Pools can be sorted in order of liquidity and queried via view functions. Used in combination with the Exchange Proxy swaps can be sourced and exectured entirely on-chain.

API

Adding Pools To Registry

addPoolPair
addPoolPair(address pool, address token1, address token2)
Adds a single pool address for token pair.
addPools
addPools(address[] calldata pools, address token1, address token2)
Adds an array of pool addresses for token pair.

Sorting Pools

sortPools
sortPools(address[] calldata tokens, uint256 lengthLimit)
Sorts pools in order of liquidity. lengthLimit can be used to limit the number of pools sorted.
sortPoolsWithPurge
sortPoolsWithPurge(address[] calldata tokens, uint256 lengthLimit)
Sorts pools in order of liquidity and removes any pools with <10% of total liquidity.

Retrieving Pools

getBestPools
getBestPools(address fromToken, address destToken)
Retrieve array of pool addresses for token pair. Ordered by liquidity if previously sorted. Max of 32 pools returned.
getBestPoolsWithLimit
getBestPoolsWithLimit(address fromToken, address destToken, uint256 limit)
Retrieve array of pool addresses for token pair. Ordered by liquidity if previously sorted. Max of n pools returned where n=limit.
getPoolsWithLimit
getPoolsWithLimit(address fromToken, address destToken, uint256 offset, uint256 limit)
Retrieve array of pool addresses using an offset starting position.
Previous
Liquidity Bootstrapping FAQ
Next - Smart Contracts
Interfaces
Last modified 3mo ago
Copy link
Contents
This page has been deprecated. V1 documentation is partially maintained here
On Chain Registry
Summary
API