@openzeppelin/upgrades-core@1.45.0-alpha.1

• Improve support for validating build-info files in CLI for Hardhat 3, Hardhat 2, and Foundry. (#1194)

Note ⚠️ This version is still in testing and should not be used in production.

@openzeppelin/hardhat-upgrades@4.0.0-alpha.0

Note ⚠️ This version is still in testing. Do not use it to deploy or upgrade production deployments.

• Migrate to Hardhat 3 with ESM module structure and plugin hooks architecture. (#1194)

  Breaking Changes

  • Requires Hardhat 3: Minimum hardhat@^3.0.0 required
  • ESM-only: Package converted to ESM, CommonJS no longer supported
  • API Changes:
    • No automatic hre.upgrades - must call factory function explicitly
    • Factory functions are async: await upgrades(hre, connection)
    • Network connection must be explicitly created: await hre.network.connect()
    • ethers now comes from connection, not hre.ethers
  • Import Changes: Import factory functions instead of side-effect import
    • Before: import '@openzeppelin/hardhat-upgrades'
    • After: import { upgrades, defender } from '@openzeppelin/hardhat-upgrades'

  Usage and Migration

  See the README for Hardhat 3 usage, the examples directory for sample projects, and the Migration Guide for Hardhat 2 to 3 migration steps.

  Changes

  • Migrated from extendEnvironment to Hardhat 3's HardhatPlugin with hookHandlers
  • Converted package to ESM
  • Etherscan verification requires @nomicfoundation/hardhat-verify@^3.0.10 (optional peer dependency).
  • Support Solidity tests in Hardhat 3 with @openzeppelin/foundry-upgrades.
  • Added example projects to work with Hardhat 3

@openzeppelin/upgrades-core@1.45.0-alpha.0

• Support Hardhat 3 build-info file format for CLI validation (#1203) (59dcd33)

Note ⚠️ This version is still in testing and should not be used in production.

@openzeppelin/upgrades-core@1.44.2

• Add Celo Sepolia network to manifest file names. (#1189)

@openzeppelin/hardhat-upgrades@3.9.1

• Support contract verification via etherscan V2 API. (#1166)
  • Potentially breaking changes: Changes peer dependencies to the following:
    • "@nomicfoundation/hardhat-ethers": "^3.0.6"
    • "@nomicfoundation/hardhat-verify": "^2.0.14"
    • "hardhat": "^2.24.1"

@openzeppelin/upgrades-core@1.44.1

• Fix Missing initializer calls error when initializer name ends with _unchained (#1161)

@openzeppelin/upgrades-core@1.44.0

• Validate Solidity custom storage layouts, use proxies from OpenZeppelin Contracts 5.3.0. (#1144)

@openzeppelin/upgrades-core@1.43.0

• Add Sonic network to manifest file names. (#1146)
• Support annotation to validate functions as initializers. (#1148)

@openzeppelin/upgrades-core@1.42.2

• Fix ASTDereferencerError for additional scenario when validating initializers. (#1137)

@openzeppelin/upgrades-core@1.42.1

• Fix ASTDereferencerError when validating initializers. (#1118)