Upgrades

OpenZeppelin provides tooling for deploying and securing upgradeable smart contracts.

  • Upgrades Plugins to deploy upgradeable contracts with automated security checks.

  • Upgradeable Contracts to build your contract using our Solidity components.

  • Defender to manage upgrades in production and automate operations.

Find all of our resources related to upgradeability below.

If you don’t know where to start we suggest to start with Learn: Upgrading Smart Contracts.

Resources

Upgrades Plugins Plugins for Hardhat and Truffle that abstract away the complexities of upgrades, while running automated security checks to ensure successful upgrades.

Writing Upgradeable Contracts When working with upgradeable contracts using OpenZeppelin Upgrades, there are a few minor caveats to keep in mind when writing your Solidity code.

OpenZeppelin Upgradeable Contracts A variant of the popular OpenZeppelin Contracts library, with all of the necessary changes specific to upgradeable contracts.

Proxy Contracts A complete list of all available proxy contracts and related utilities, with documentation relevant for low-level use without Upgrades Plugins.

The State of Smart Contract Upgrades A survey of upgrade patterns, and good practices and recommendations for upgrades management and governance.

Transparent vs UUPS Proxies Explaining the differences between the Transparent Proxy Pattern and the newly available UUPS Proxies.

Learn: Upgrading Smart Contracts A chapter about upgrades in our Learn series, a guided journey through smart contract development. Available for both Hardhat and Truffle.

Upgrading via Multisig A Defender guide on upgrading a smart contract in production secured by a multisig wallet, using Defender Admin and the Hardhat Upgrades plugin.

UUPS Proxies Tutorial A tutorial on using the UUPS proxy pattern: what the Solidity code should look like, and how to use the Upgrades Plugins with this new proxy pattern.