Home

Awesome

<img src="logo.svg" alt="Balancer" height="128px">

Balancer V2 Deployments

NPM Package GitHub Repository

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.


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.

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.

Returns a contract's ABI.

Returns a contract's creation code.

Returns the address of a contract's canonical deployment.

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

Active Deployments

DescriptionTask ID
Authorizer, governance contract20210418-authorizer
Vault, main protocol contract20210418-vault
Rate Provider for wstETH20210812-wsteth-rate-provider
Liquidity Bootstrapping Pools20211202-no-protocol-fee-lbp
Authorizer Adaptor for extending governance20220325-authorizer-adaptor
Wallet for the BAL token20220325-bal-token-holder-factory
Admin of the BAL token20220325-balancer-token-admin
Liquidity Mining: veBAL, Gauge Controller and Minter20220325-gauge-controller
Test Balancer Token20220325-test-balancer-token
Delegation of veBAL boosts20220325-ve-delegation
veBAL Smart Wallet Checker20220420-smart-wallet-checker
Relayer with the fix for the Double Entrypoint issue20220513-double-entrypoint-fix-relayer
Protocol Fee Withdrawer20220517-protocol-fee-withdrawer
Preseeded Voting Escrow Delegation20220530-preseeded-voting-escrow-delegation
Distribution Scheduler for reward tokens on gauges20220707-distribution-scheduler
Fee Distributor for veBAL holders V220220714-fee-distributor-v2
Swap, join and exit simulations (queries)20220721-balancer-queries
Protocol fee percentages provider20220725-protocol-fee-percentages-provider
Mainnet Staking Gauges V220220822-mainnet-gauge-factory-v2
Arbitrum Root Gauges V2, for veBAL voting20220823-arbitrum-root-gauge-factory-v2
Optimism Root Gauges V2, for veBAL voting20220823-optimism-root-gauge-factory-v2
Polygon Root Gauges V2, for veBAL voting20220823-polygon-root-gauge-factory-v2
Pool Recovery Helper20221123-pool-recovery-helper
Authorizer Adaptor Entrypoint20221124-authorizer-adaptor-entrypoint
VeBoost V220221205-veboost-v2
Single Recipient Stakeless Gauges V220230215-single-recipient-gauge-factory
Gnosis Root Gauge, for veBAL voting20230217-gnosis-root-gauge-factory
Merkle Orchard Distributor V220230222-merkle-orchard-v2
Protocol ID registry20230223-protocol-id-registry
L2 Balancer Pseudo Minter20230316-l2-balancer-pseudo-minter
Child Chain Gauge Factory V220230316-child-chain-gauge-factory-v2
L2 Voting Escrow Delegation Proxy20230316-l2-ve-delegation-proxy
Weighted Pool V420230320-weighted-pool-v4
L2 Layer0 Bridge Forwarder20230404-l2-layer0-bridge-forwarder
Managed Pool V220230411-managed-pool-v2
Authorizer with Adaptor Validation20230414-authorizer-wrapper
Voting Escrow Remapper20230504-vebal-remapper
Gauge Registrant V420230519-gauge-adder-v4
LayerZero OmniVotingEscrowChild (Base)20230524-base-lz-omni-voting-escrow-child
LayerZero OmniVotingEscrow20230524-mainnet-lz-omni-voting-escrow
LayerZero OmniVotingEscrowChild20230524-lz-omni-voting-escrow-child
L2 VeBoost V220230525-l2-veboost-v2
Polygon ZkEVM Root Gauge, for veBAL voting20230526-zkevm-root-gauge-factory
Gauge Working Balance Helper20230526-gauge-working-balance-helper
Timelock Authorizer, governance contract20230522-timelock-authorizer
Pool Data Queries for bulk operations20230613-balancer-pool-data-queries
L2 Child Chain Gauge Checkpointer (Relayer)20230712-child-chain-gauge-checkpointer
Chainlink Rate Provider Factory20230717-chainlink-rate-provider-factory
Avalanche Root Gauge V2, for veBAL voting20230811-avalanche-root-gauge-factory-v2
Base Root Gauge, for veBAL voting20230911-base-root-gauge-factory
Stakeless Gauge Checkpointer V220230915-stakeless-gauge-checkpointer-v2
Batch Relayer V620231031-batch-relayer-v6
Composable Stable Pools V620240223-composable-stable-pool-v6
Fraxtal Root Gauge, for veBAL voting20240522-fraxtal-root-gauge-factory
V3 Vault20241204-v3-vault
V3 Weighted Pool20241205-v3-weighted-pool
V3 Stable Pool20241205-v3-stable-pool
V3 Router20241205-v3-router
V3 Batch Router20241205-v3-batch-router
V3 Composite Liquidity Router20241205-v3-composite-liquidity-router
V3 Buffer Router20241205-v3-buffer-router
V3 Vault Explorer20241205-v3-vault-explorer
V3 Hook Examples20241213-v3-hook-examples

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.

DescriptionTask ID
Coordination of the veBAL deployment20220325-veBAL-deployment-coordinator
Coordination of setup of L2 gauges for veBAL system20220415-veBAL-L2-gauge-setup-coordinator
Coordination of veBAL gauges fix (Option 1)20220418-veBAL-gauge-fix-coordinator
veBAL Smart Wallet Checker Coordinator20220421-smart-wallet-checker-coordinator
Tribe BAL Minter Coordinator20220606-tribe-bal-minter-coordinator
Coordination of the double entrypoint issue fix20220610-snx-recovery-coordinator
Coordination of the Gauge Adder migration20220721-gauge-adder-migration-coordinator
Coordination of the Gauge Adder migration V2 --> V320230109-gauge-adder-migration-v2-to-v3
Timelock authorizer transition permission migration20230130-ta-transition-migrator
Coordination of the Gauge Adder migration V3 --> V420230519-gauge-adder-migration-v3-to-v4

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).

DescriptionTask ID
Weighted Pools of up to 8 tokens20210418-weighted-pool
Stable Pools of up to 5 tokens20210624-stable-pool
Liquidity Bootstrapping Pools of up to 4 tokens20210721-liquidity-bootstrapping-pool
Meta Stable Pools with 2 tokens and price oracle20210727-meta-stable-pool
Distributor contract for LDO rewards20210811-ldo-merkle
Relayer for Lido stETH wrapping/unwrapping20210812-lido-relayer
Basic Investment Pools for few tokens20210907-investment-pool
Distributor contract for arbitrum BAL rewards20210913-bal-arbitrum-merkle
Distributor contract for arbitrum MCB rewards20210928-mcb-arbitrum-merkle
Merkle Orchard Distributor20211012-merkle-orchard
Batch Relayer20211203-batch-relayer
Linear Pools for Aave aTokens20211208-aave-linear-pool
Preminted BPT Meta Stable Pools20211208-stable-phantom-pool
Linear Pools for ERC4626 Tokens20220304-erc4626-linear-pool
Batch Relayer V220220318-batch-relayer-v2
Mainnet Staking Gauges20220325-mainnet-gauge-factory
Single Recipient Stakeless Gauges20220325-single-recipient-gauge-factory
Gauge Registrant20220325-gauge-adder
Linear Pools for ERC4626 Tokens V220220404-erc4626-linear-pool-v2
Gauges on child networks (L2s and sidechains)20220413-child-chain-gauge-factory
Arbitrum Root Gauges, for veBAL voting20220413-arbitrum-root-gauge-factory
Polygon Root Gauges, for veBAL voting20220413-polygon-root-gauge-factory
Fee Distributor for veBAL holders20220420-fee-distributor
Linear Pools for Unbutton tokens20220425-unbutton-aave-linear-pool
Child Chain Gauge Token Adder20220527-child-chain-gauge-token-adder
Child Chain Gauge Reward Helper20220812-child-chain-reward-helper
Stable Pools V2 of up to 5 tokens20220609-stable-pool-v2
Optimism Root Gauges, for veBAL voting20220628-optimism-root-gauge-factory
Gauge Registrant V2, supporting new networks20220628-gauge-adder-v2
Batch Relayer V320220720-batch-relayer-v3
Linear Pools for Aave aTokens (with rebalancing) V220220817-aave-rebalanced-linear-pool
Composable Stable Pools20220906-composable-stable-pool
Weighted Pool V220220908-weighted-pool-v2
Batch Relayer V420220916-batch-relayer-v4
Managed Pool20221021-managed-pool
Composable Stable Pools V220221122-composable-stable-pool-v2
Linear Pools for Aave aTokens (with rebalancing) V320221207-aave-rebalanced-linear-pool-v3
Gauge Registrant V320230109-gauge-adder-v3
Weighted Pool V320230206-weighted-pool-v3
Composable Stable Pools V320230206-composable-stable-pool-v3
Linear Pools for Euler Tokens20230208-euler-linear-pool
Timelock Authorizer, governance contract20221202-timelock-authorizer
Linear Pools for ERC4626 Tokens V320230206-erc4626-linear-pool-v3
Linear Pools for Aave aTokens (with rebalancing) V420230206-aave-rebalanced-linear-pool-v4
Linear Pools for Yearn Tokens20230213-yearn-linear-pool
Linear Pools for Gearbox Tokens20230213-gearbox-linear-pool
Batch Relayer V520230314-batch-relayer-v5
Linear Pools for Silo Tokens20230315-silo-linear-pool
Composable Stable Pools V420230320-composable-stable-pool-v4
Linear Pools for ERC4626 Tokens V420230409-erc4626-linear-pool-v4
Linear Pools for Yearn Tokens V220230409-yearn-linear-pool-v2
Linear Pools for Gearbox Tokens V220230409-gearbox-linear-pool-v2
Linear Pools for Aave aTokens V520230410-aave-linear-pool-v5
Linear Pools for Silo Tokens V220230410-silo-linear-pool-v2
L2 Gauge Checkpointer20230527-l2-gauge-checkpointer
Avalanche Root Gauge, for veBAL voting20230529-avalanche-root-gauge-factory
Composable Stable Pools V520230711-composable-stable-pool-v5
Composable Stable Pools V5 (ZKEVM)20230711-zkevm-composable-stable-pool-v5
Stakeless Gauge Checkpointer20230731-stakeless-gauge-checkpointer