Balancer V2 Deployments

This package contains the addresses and ABIs of all Balancer V2 deployed contracts for Ethereum mainnet, Polygon, Arbitrum, Optimism, Gnosis, BSC and Avalanche, as well as various test networks. Each deployment consists of a deployment script (called 'task'), inputs (script configuration, such as dependencies), outputs (typically contract addresses), ABIs and bytecode files of related contracts.

Addresses and ABIs can be consumed from the package in JavaScript environments, or manually retrieved from the GitHub repository.

Note that some protocol contracts are created dynamically: for example, WeightedPool contracts are deployed by the canonical WeightedPoolFactory. While the ABIs of these contracts are stored in the abi directory of each deployment, their addresses are not. Those can be retrieved by querying the on-chain state or processing emitted events.

Overview

Deploying Contracts

For more information on how to create new deployments or run existing ones in new networks, head to the deployment guide.

Installation

$ npm install @balancer-labs/v2-deployments

Usage

Import @balancer-labs/v2-deployments to access the different ABIs and deployed addresses. To see all current Task IDs and their associated contracts, head to Active Deployments.

Past deployments that are currently not in use or have been superseded can be accessed in the Deprecated Deployments section. Use deprecated/ as prefix when referring to a deprecated task ID.

⚠️ Exercise care when interacting with deprecated deployments: there's often a very good reason why they're no longer active.

You can find information on why each deployment has been deprecated in their corresponding readme file.

• async function getBalancerContract(taskID, contract, network)

Returns an Ethers contract object for a canonical deployment (e.g. the Vault, or a Pool factory).

Note: requires using Hardhat with the hardhat-ethers plugin.

• async function getBalancerContractAt(taskID, contract, address)

Returns an Ethers contract object for a contract dynamically created at a known address (e.g. a Pool created from a factory).

Note: requires using Hardhat with the hardhat-ethers plugin.

• function getBalancerContractAbi(taskID, contract)

Returns a contract's ABI.

• function getBalancerContractBytecode(taskID, contract)

Returns a contract's creation code.

• function getBalancerContractAddress(taskID, contract, network)

Returns the address of a contract's canonical deployment.

• function getBalancerDeployment(taskID, network)

Returns an object with all contracts from a deployment and their addresses.

Active Deployments

Scripts

These are deployments for script-like contracts (often called 'coordinators') which are typically granted some permission by Governance and then executed, after which they become useless.

Deprecated Deployments

These deployments have been deprecated because they're either outdated and have been replaced by newer versions, or because they no longer form part of the current infrastructure. In almost all cases they should no longer be used, and are only kept here for historical reasons.

Go to each deprecated deployment's readme file to learn more about why it is deprecated, and what the replacement deployment is (if any).