Package detail

@0x/contract-addresses

A tiny utility library for getting known deployed contract addresses for a particular network.

Installation

yarn add @0x/contract-addresses

Import

import { getContractAddressesForChainOrThrow } from '@0x/contract-addresses';

or

var getContractAddressesForChainOrThrow = require('@0x/contract-addresses').getContractAddressesForChainOrThrow;

Contributing

We welcome improvements and fixes from the wider community! To report bugs within this package, please create an issue in this repository.

Please read our contribution guidelines before getting started.

Install dependencies

If you don't have yarn workspaces enabled (Yarn < v1.0) - enable them:

yarn config set workspaces-experimental true

Then install dependencies

yarn install

Build

To build this package and all other monorepo packages that it depends on, run the following from the monorepo root directory:

PKG=@0x/contract-addresses yarn build

Clean

yarn clean

Lint

yarn lint

Run Tests

yarn test

CHANGELOG

v8.13.0 - November 16, 2023

* Add Sepolia addresses

v8.12.0 - August 29, 2023

* Add VelodromeV2 support on Base

v8.11.0 - August 18, 2023

* Add MaverickV1 support on Ethereum, BSC, and Base

v8.10.0 - August 9, 2023

* Add VelodromeV2 support on Optimism

v8.9.0 - July 21, 2023

* Add Uniswap V3 router v2 support in Base FillQuoteTransformer

v8.8.0 - July 19, 2023

* Add Base mainnet addresses
* Add UniswapV3 support in Avalanche and BSC FillQuoteTransformers

v8.7.0 - May 10, 2023

* Add Trader Joe V2 MixIn to Arbitrum

v8.6.0 - May 1, 2023

* Add Trader Joe V2.1 Router Support for MixIn

v8.5.0 - April 20, 2023

* Add Trader Joe V2 support on Avalanche

v8.4.0 - April 17, 2023

* Add Barter support in Ethereum FillQuoteTransformer

v8.3.0 - April 17, 2023

* Add Barter support in Ethereum FillQuoteTransformer

v8.2.0 - March 10, 2023

* Upgrade Polygon, Avalanche, Arbitrum, and Optimism FillQuoteTransformers to remove Aave V3 L2 Encoding and support KyberElastic (#678)

v8.1.0 - March 1, 2023

* Upgrade Mainnet and Polygon FillQuoteTransformers to support KyberElastic (#669)

v8.0.3 - February 1, 2023

* Upgrade Arbitrum FillQuoteTransformer to support Woofi (#653)

v8.0.2 - January 30, 2023

* Dependencies updated

v8.0.1 - January 23, 2023

* Dependencies updated

v8.0.0 - December 12, 2022

* Remove Kovan and Arbitrum Rinkeby as they are no longer supported. (#630)

v7.4.1 - November 23, 2022

* Dependencies updated

v7.4.0 - November 15, 2022

* Upgrade Polygon FillQuoteTransformer to support Solidly (and its forks). (#616)

v7.3.0 - November 5, 2022

* Upgrade `AffiliateFeeTransformer`, `PayTakerTransformer`, and `PositiveSlippageFeeTransformer` to support smart contract wallets (#615)

v7.2.0 - November 2, 2022

* Add RFQTV2 to Mumbai (#611)

v7.1.0 - October 24, 2022

* Add `BalancerV2Batch` support in `FantomBridgeAdapter` (#607)

v7.0.0 - October 21, 2022

* Updated Ethereum FQT to enable RFQT V2 (#604)
* updated changelog (#605)

v6.25.0 - October 11, 2022

* Remove Ropsten and Rinkeby addresses (#597)

v6.24.0 - October 5, 2022

* Add missing zeroExGovernor for Arbitrum (#583)

v6.23.4 - September 21, 2022

* New FQT for Arbitrum with Nerve (#581)

v6.23.3 - September 12, 2022

* New FQT for Optimism with BalV2 (#577)
* Add balV2/batch to opt bridge adapter code (#578)

v6.23.2 - September 7, 2022

* New FQT for arbitrum again (#574)

v6.23.1 - September 2, 2022

* New FQT for arbitrum (#572)

v6.23.0 - September 1, 2022

* Remove contract addresses that are no longer needed (#564)
* Change WETH address in contract-addresses (#571)

v6.22.0 - August 25, 2022

* Arbitrum Rinkeby support (#552)

v6.21.0 - August 25, 2022

* Arbitrum addresses: need to be updated when deployed

v6.20.1 - August 22, 2022

* Revert: Remove contract addresses that are no longer needed

v6.20.0 - Invalid date

* Remove contract addresses that are no longer needed (#548)

v6.19.2 - August 10, 2022

* Dependencies updated

v6.19.1 - August 9, 2022

* Fix lowercase addresses (#543)

v6.19.0 - August 6, 2022

* Goerli and Mumbai updated verified contracts addresses (#537)

v6.17.0 - July 27, 2022

* Goerli and Mumbai
* Redeploy FQT on Mainnet and Optimism (#530)

v6.16.0 - June 14, 2022

* Redeploy FQT on Mainnet and Optimism

v6.15.0 - June 3, 2022

* Redeploy FQT on Mainnet

v6.14.0 - May 19, 2022

* Redeploy FQT on Avalanche and BSC

v6.13.0 - April 22, 2022

* Redeploy FQT on mainnet and polygon (#462)

v6.12.1 - March 31, 2022

* Dependencies updated

v6.12.0 - March 2, 2022

* Update fantom fillQuoteTransformer addresses (#398)

v6.11.0 - December 24, 2021

* Add Optimism addresses (#385)

v6.10.0 - December 1, 2021

* Add Aave supported FQT addresses for Polygon, Avalanche (#321)

v6.9.0 - November 16, 2021

* Add Celo addresses (#368)

v6.8.1 - November 3, 2021

* Dependencies updated

v6.8.0 - October 19, 2021

* Fantom deployment (#347)

v6.7.0 - September 1, 2021

* Avalanche deployment (#312)

v6.6.1 - August 19, 2021

* Dependencies updated

v6.6.0 - August 11, 2021

* Add zrxTreasury address (#301)

v6.5.0 - August 6, 2021

* Deployed `Clipper` (#299)

v6.4.0 - June 22, 2021

* Deployed Lido FQT

v6.3.1 - June 11, 2021

* Dependencies updated

v6.3.0 - May 25, 2021

* Deployed contracts on `Polygon` (#240)

v6.2.0 - May 21, 2021

* Deployed FQT on mainnet and ropsten for `KyberDMM` (#247)

v6.1.0 - May 5, 2021

* Deployed FQT on mainnet and ropsten for `Balancer_V2` (#225)
* Deployed FQT on mainnet and ropsten for `Uniswap_V3` (#227)

v6.0.0 - April 1, 2021

* Add BSC chain addresses (#164)
* Remove exchangeProxyAllowanceTarget (#164)
* Redeployed FQT on BSC (#181)
* Redeployed FQT on mainnet and ropsten (#150)

v5.11.0 - February 24, 2021

* Deploy new FQT (#155)
* Deploy new `PositiveSlippageFeeTransformer` (#101)

v5.10.0 - February 10, 2021

* Deploy new FQT (#129)

v5.9.0 - January 13, 2021

* Redeploy LiquidityProviderSandbox (#107)
* Update ganache snapshot addresses (#109)

v5.8.0 - December 23, 2020

* redeploy FQT (#99)

v5.7.0 - December 17, 2020

* Redeploy FQT (#91)

v5.6.0 - December 7, 2020

* Update mainnet and ropsten transformer addresses for hot-pants release (#70)

v5.5.0 - December 3, 2020

* Update ganache snapshot addresses (#59)

v5.4.0 - November 19, 2020

* Update ganache snapshot addresses (#27)

v5.3.0 - November 13, 2020

* Add `exchangeProxyLiquidityProviderSandbox` addresses (#16)

v5.2.0 - November 3, 2020

* Redeploy FQT with CORRECT deployer (#29)

v5.1.0 - November 3, 2020

* Deploy new FQT (#28)

v5.0.1 - October 28, 2020

* Dependencies updated

v5.0.0 - October 27, 2020

* update erc20BridgeSampler address for Kovan (#14)
* Moved Bridge addresses into Asset-swapper (#4)

v4.12.0 - October 21, 2020

* Update `CurveBridge` address on all networks (#2633)
* Redeploy `ERC20BridgeSampler` on Kovan (#2644)
* Deploy `UniswapV2Bridge` on Kovan (#2652)
* Redeploy previously unverified contracts on testnets (#2656)
* Deploy `BancorBridge` on Mainnet (#2650)
* Deploy FQT (#2667)
* Deploy `MStableBridge` on Mainnet (#2662)
* Deploy `MooniswapBridge` on Mainnet (#2675)
* Redeploy `MooniswapBridge` on Mainnet (#2681)
* Redeploy `KyberBridge` on Mainnet (#2683)
* Update transformer deployer and transformers for champagne-problems deployment (#2693)
* Deploy `BancorBridge` on Mainnet (#2699)
* Deploy `ShellBridge` on Mainnet (#2722)
* Deploy `DodoBridge` on Mainnet (#2701)
* Deploy `CreamBridge` on Mainnet (#2715)

v4.11.0 - July 15, 2020

* Update ganache snapshot Exchange Proxy addresses (#2612)
* Add EP flash wallet and affiliate fee transformer (#2622)
* Update DFB addresses (#2616)
* Deploy FQT from PR 2608 (#2625)
* Redeploy DFB on kovan (#2628)
* Update ganache snapshot Exchange Proxy addresses for MetaTransactions (#2610)
* Add BalancerBridge addresses (#2613)

v4.10.0 - June 24, 2020

* Updated Kovan's ERC20BridgeSampler address (#2519)
* Added MaximumGasPrice addresses (#2511)
* Redeploy `KyberBridge`, `UniswapBridge`, `Eth2DaiBridge`, `CurveBridge`, `DydxBridge` on mainnet and kovan (#2512)
* Redeploy `KyberBridge`, `UniswapBridge`, `Eth2DaiBridge`, `CurveBridge`, `DydxBridge` on mainnet and kovan (#2529)
* Redeploy `CurveBridge` with GST support (#2530)
* Add `dexForwarderBridge` addresses (#2525)
* Redeploy `Forwarder` on all networks (#2521)
* Redeploy `DexForwarderBridge` on Mainnet with Gas Token freeing (#2536)
* Revert to older Curve Bridge (without Gas Tokens) (#2536)
* Updated Ganache's ERC20BridgeSampler address (#2541)
* Updated Mainnet ERC20BridgeSampler address (#2551)
* Updated Kovan ERC20BridgeSampler address (#2568)
* Redeploy ERC20BridgeSampler on kovan (#2570)
* Redeploy ERC20BridgeSampler on Mainnet using `Kyber.searchBestRate` (#2575)
* Redeploy ERC20BridgeSampler on Mainnet and Kovan using UniswapV2 (#2599)
* Add UniswapV2Bridge address on Mainnet (new field) (#2599)
* Add Exchange Proxy addresses (#2591)

v4.9.0 - March 3, 2020

* Redeploy `ERC20BridgeSampler` (#2503)

v4.8.0 - February 27, 2020

* Added Broker, GodsUnchainedValidator, ChainlinkStopLimit to index.ts (#2498)

v4.7.0 - February 25, 2020

* Update `DevUtils` addresses. (#2493)

v4.6.0 - February 15, 2020

* Added `ChainlinkStopLimit` addresses (mainnet, ropsten, rinkeby) (#2473)
* Added `CurveBridge` address (mainnet) (#2483)
* Update `ERC20BridgeSampler` address (mainnet, kovan) (#2483)

v4.5.0 - February 8, 2020

* Update `ERC20BridgeSampler` and `Eth2Dai` on mainnet and kovan. (#2474)
* Update `ERC20BridgeSampler` address on mainnet and kovan. (#2476)
* Removed OrderValidator and DutchAuction addresses (#2469)
* Added Broker and GodsUnchainedValidator addresses (#2469)
* Updated Forwarder addresses (#2469)
* Update `ERC20BridgeSampler` address on mainnet and kovan. (#2477)

v4.4.0 - February 4, 2020

* Update `ERC20BridgeSampler` on mainnet and kovan. (#2459)
* Remove `libTransactionDecoder` (#2456)
* Update snapshot addresses (#2466)

v4.3.0 - January 22, 2020

* Update `DevUtils` mainnet, Ropsten, Rinkeby, Kovan addresses with PR#2440 changes (#2446)
* Update `DevUtils` mainnet, Ropsten, Rinkeby, Kovan addresses (#2436)
* Update `ERC20BridgeSampler` address on kovan and mainnet. (#2427)

v4.2.0 - January 6, 2020

* Added new `DevUtils` addresses (#2402)
* Update ERC20BridgeSampler address on Kovan and mainnet. (#2405)
* Added DydxBridge Contract to contract-addresses (#2390)
* Update `UniswapBridge` mainnet address. (#2390)
* Update `KyberBridge` mainnet address. (#2390)
* Update `Forwarder` mainnet address. (#2390)
* Added ChaiBridge Contract to contract-addresses (#2390)

v4.1.0 - December 17, 2019

* Addition of ERC20BridgeSampler + Kyber Erc20Bridge Contract in contract-addresses (#2353)

v4.0.0 - December 2, 2019

* `1337` addresses updated with Forwarder deployed after Exchange is configured (#2368)
* Update Forwarder addresses on all newtorks (#2374)
* Update all v3 mainnet addresses (#2322)
* Update ZeroExGovernor address on all testnets (#2322)
* Updated devUtils contract addresses on testnets
* Remove `readOnlyProxy` from addresses interface (#2295)
* Add `zeroExGovernor` and `erc20BridgeProxy` to addresses interface (#2296)
* Update `exchange`, `staking`, `stakingProxy`, `zeroExGovernor`, `assetProxyOwner`, and `erc20BridgeProxy` addresses for each tesnet (#2296)
* Contract addresses are no longer indexed by network ID.  Now they're indexed by chain ID. (#2313)
* Removed `getNetworkIdByExchangeAddressOrThrow`. It's not needed with V3 tooling. (#2170)
* Add `zrxVault`, `readOnlyProxy`, `staking`, and `stakingProxy` schema with addresses for each tesnet (#2224)
* Update `assetProxyOwner` address for each testnet (#2224)

v3.3.0-beta.5 - December 2, 2019

* `1337` addresses updated with Forwarder deployed after Exchange is configured (#2368)
* Update Forwarder addresses on all newtorks (#2374)

v3.3.0-beta.4 - November 20, 2019

* Dependencies updated

v3.3.0-beta.3 - November 17, 2019

* Update all v3 mainnet addresses (#2322)
* Update ZeroExGovernor address on all testnets (#2322)

v3.3.0-beta.2 - November 7, 2019

* Updated devUtils contract addresses on testnets

v3.3.0-beta.1 - November 6, 2019

* Remove `readOnlyProxy` from addresses interface (#2295)
* Add `zeroExGovernor` and `erc20BridgeProxy` to addresses interface (#2296)
* Update `exchange`, `staking`, `stakingProxy`, `zeroExGovernor`, `assetProxyOwner`, and `erc20BridgeProxy` addresses for each tesnet (#2296)
* Contract addresses are no longer indexed by network ID.  Now they're indexed by chain ID. (#2313)

v3.3.0-beta.0 - October 3, 2019

* Removed `getNetworkIdByExchangeAddressOrThrow`. It's not needed with V3 tooling. (#2170)
* Add `zrxVault`, `readOnlyProxy`, `staking`, and `stakingProxy` schema with addresses for each tesnet (#2224)
* Update `assetProxyOwner` address for each testnet (#2224)

v3.2.0 - September 17, 2019

* Added `getNetworkIdByExchangeAddressOrThrow` (#2096)

v3.1.0 - August 22, 2019

* Added DevUtils (#2060)

v3.0.3 - August 8, 2019

* Added StaticCallAssetProxy and ERC1155AssetProxy (#2021)

v3.0.2 - July 15, 2019

* Update OrderValidator testnet addresses

v3.0.1 - July 13, 2019

* Update remaining Mainnet V2.1 contract addresses

v3.0.0 - July 13, 2019

* Redeployed Mainnet Exchange and Asset Proxies

v2.3.3 - May 14, 2019

* Redeploy Coordinator contract (#1812)

v2.3.1 - April 11, 2019

* Dependencies updated

v2.3.0 - March 21, 2019

* Add addresses for coordinator extension contract and coordinator registry (#1689)
* Added Dutch Auction mainnet address (#1715)

v2.2.2 - February 25, 2019

* Fixed Ganache addresses for OrderValidator & Forwarder

v2.2.1 - February 5, 2019

* Dependencies updated

v2.2.0 - January 15, 2019

* Added migration for `MultiAssetProxy` contract (#1503)

v2.1.0 - January 9, 2019

* Added testnet entries for Dutch Auction contract (kovan,rinkeby,ropsten) (#1465)

v2.0.0 - November 28, 2018

* Redeployed Rinkeby with testnet Exchange artifact (#1318)
* Added Ganache snapshot addresses for network 50 (#1318)

v1.2.0 - November 21, 2018

* Rinkeby Deployment

v1.1.0 - November 9, 2018

* Update Forwarder addresses (#1192)

v1.0.1 - October 18, 2018

* Initial release (#1105)

v1.0.0 - Invalid date

* Unpublished Package