OpenZeppelin/openzeppelin-upgrades

View on GitHub

Plugins for Hardhat and Foundry to deploy and manage upgradeable contracts on Ethereum.

Stars: 658
Forks: 286
Open beginner issues: 0
Indexed issues: 98

Dominant language: TypeScript
License: MIT
Last GitHub push: Jul 24, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: No code of conduct
Beginner labels: good first issue
PR merge metrics: No merged PRs in 30d

Beginner friendly Everything

Open All

98 open issues indexed

`validateBaseSlotUnchanged` never fires when layouts are read through `unfoldStorageLayout` Open

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

OpenZeppelin/openzeppelin-upgrades#1296 · Opened Aug 4, 2026
Tighten constructor-argument handling for contracts-only validateUpgrade Open

OpenZeppelin/openzeppelin-upgrades#1292 · 1 assignee · Opened Jul 20, 2026
`getUnlinkedBytecode` crashes with "Bytecode is not a valid hex string" when build-info contains library-linked contracts Open

Difficulty 3/5 1-2 days Newbie friendliness 74/100

OpenZeppelin/openzeppelin-upgrades#1227 · Opened Mar 24, 2026
[Defender Sunset] No migration path for CREATE2 deterministic deployments via `hardhat-upgrades` Open

Difficulty 5/5 Over a week Newbie friendliness 38/100

OpenZeppelin/openzeppelin-upgrades#1224 · 1 comment · Opened Mar 18, 2026
Unexpected different CREATE2 address when using defender.deployProxy() despite identical parameters Open

Difficulty 4/5 3-5 days Newbie friendliness 28/100

OpenZeppelin/openzeppelin-upgrades#1199 · 1 comment · Opened Dec 4, 2025
Support upgrades plugin for PolkaVM Open

feature

OpenZeppelin/openzeppelin-upgrades#1188 · 1 comment · 1 assignee · Opened Sep 4, 2025
Document use of precompiled proxies and compiler version for proxies Open

docs

Difficulty 2/5 1-3 hours Newbie friendliness 62/100

OpenZeppelin/openzeppelin-upgrades#1187 · 2 reactions · Opened Sep 3, 2025
Support unsafe-allow-reachable for constructors Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

OpenZeppelin/openzeppelin-upgrades#1184 · Opened Aug 20, 2025
support gnosis-safe owner for `Upgrades.upgradeProxy` Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

OpenZeppelin/openzeppelin-upgrades#1177 · Opened Jul 16, 2025
Can't find upgrade tx in Proxy admin contract Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

OpenZeppelin/openzeppelin-upgrades#1176 · Opened Jul 15, 2025
Potential false positive `Missing initializer calls for one or more parent contracts` for `ERC20PermitUpgradeable` Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

OpenZeppelin/openzeppelin-upgrades#1175 · 4 comments · Opened Jul 4, 2025
Hardhat Ignition support Open

feature

Difficulty 5/5 Over a week Newbie friendliness 30/100

OpenZeppelin/openzeppelin-upgrades#1170 · 1 comment · 1 reaction · Opened Jun 24, 2025
ProviderError: the method has been deprecated: eth_accounts when deploying with defender.deployProxy on Polygon Mainnet Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

OpenZeppelin/openzeppelin-upgrades#1159 · 4 comments · 3 reactions · Opened May 13, 2025
Unable to get Deterministic Address for Factory Contract Across Networks using deployProxy method Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

OpenZeppelin/openzeppelin-upgrades#1142 · 3 comments · 2 reactions · Opened Mar 20, 2025
Cannot append to struct at the end of storage layout Open

Difficulty 4/5 3-5 days Newbie friendliness 45/100

OpenZeppelin/openzeppelin-upgrades#1136 · 3 comments · Opened Feb 27, 2025
Consider an `@oz-renamespaced-from` tag to redeclare ERC-7201 namespace tags. Open

Difficulty 5/5 Over a week Newbie friendliness 20/100

OpenZeppelin/openzeppelin-upgrades#1132 · 1 comment · Opened Feb 24, 2025
validateUpgradeSafety: Cannot read properties of undefined (reading 'ast') Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

OpenZeppelin/openzeppelin-upgrades#1126 · 3 comments · Opened Feb 12, 2025
Improve validations for transitive parent initializer calls Open

Difficulty 4/5 3-5 days Newbie friendliness 38/100

OpenZeppelin/openzeppelin-upgrades#1123 · Opened Feb 10, 2025
'incorrect-initializer-order' warning fires spuriously for nested initializers Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

OpenZeppelin/openzeppelin-upgrades#1121 · 4 comments · 1 reaction · Opened Feb 7, 2025
Fix: Hardhat Upgrades API documentation for `deployProxy:kind` Open

Difficulty 3/5 1-2 days Newbie friendliness 45/100

OpenZeppelin/openzeppelin-upgrades#1112 · 1 reaction · Opened Jan 17, 2025
Namespaced layout validations: extract detailed types in interfaces Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

OpenZeppelin/openzeppelin-upgrades#1089 · Opened Oct 2, 2024
"nonce too low" fails proxy deployment Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

OpenZeppelin/openzeppelin-upgrades#1073 · Opened Sep 2, 2024
Can't install and test after cloning Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

OpenZeppelin/openzeppelin-upgrades#1058 · 1 comment · Opened Aug 7, 2024
hardhat-upgrades: Use actual build info when verifiying contracts on explorers Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

OpenZeppelin/openzeppelin-upgrades#1054 · 1 comment · Opened Jul 30, 2024
Update 5.x proxy artifact paths in next major version of `upgrades-core` Open

breaking change

Difficulty 4/5 3-5 days Newbie friendliness 35/100

OpenZeppelin/openzeppelin-upgrades#931 · Opened Nov 30, 2023
Issue with deployProxy when using ContractFactory instantiated directly with ABI and Bytecode Open

Difficulty 4/5 3-5 days Newbie friendliness 38/100

OpenZeppelin/openzeppelin-upgrades#916 · 6 comments · Opened Nov 2, 2023
Files without contracts cause the Truffle plugin to fail Open

Difficulty 4/5 3-5 days Newbie friendliness 45/100

OpenZeppelin/openzeppelin-upgrades#826 · 1 reaction · Opened Jun 21, 2023
The upgradeProxy fails with "Bytecode is not a valid hex string" Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

OpenZeppelin/openzeppelin-upgrades#823 · 2 comments · Opened Jun 20, 2023
Support Vyper contracts Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

OpenZeppelin/openzeppelin-upgrades#822 · 1 comment · 1 reaction · Opened Jun 20, 2023
Add Sourcify support for proxies and beacons Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

OpenZeppelin/openzeppelin-upgrades#819 · 2 comments · Opened Jun 16, 2023
Support rename/retype of variables within struct Open

Difficulty 5/5 Over a week Newbie friendliness 30/100

OpenZeppelin/openzeppelin-upgrades#802 · 1 comment · Opened May 19, 2023
Can't add variables with change of storage gap with hardhat Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

OpenZeppelin/openzeppelin-upgrades#785 · 1 comment · Opened May 3, 2023
The plugins are broken for some networks (eg. Hedera and ZkSync) Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

OpenZeppelin/openzeppelin-upgrades#765 · 1 comment · 1 reaction · Opened Mar 25, 2023
Show stacktrace for unsafe delegatecall/selfdestruct errors Open

Difficulty 4/5 3-5 days Newbie friendliness 42/100

OpenZeppelin/openzeppelin-upgrades#762 · Opened Mar 22, 2023
Use separate Solc inputs to verify different proxy contracts Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

OpenZeppelin/openzeppelin-upgrades#754 · 1 comment · 2 reactions · Opened Mar 2, 2023
gap resizing using solc v0.5.x Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

OpenZeppelin/openzeppelin-upgrades#753 · 1 comment · Opened Mar 1, 2023
Move development network files to OS temporary directory Open

Difficulty 3/5 1-2 days Newbie friendliness 45/100

OpenZeppelin/openzeppelin-upgrades#748 · Opened Feb 15, 2023
Check for method ID clashes across versions Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

OpenZeppelin/openzeppelin-upgrades#735 · 2 comments · Opened Feb 1, 2023
Remove type keyword from layout error report Open

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

OpenZeppelin/openzeppelin-upgrades#728 · Opened Jan 27, 2023
Show error when retype/rename annotation is wrong Open

Difficulty 4/5 3-5 days Newbie friendliness 42/100

OpenZeppelin/openzeppelin-upgrades#727 · Opened Jan 26, 2023
Support `unsafe-allow-reachable` in constructors Open

Difficulty 4/5 3-5 days Newbie friendliness 45/100

OpenZeppelin/openzeppelin-upgrades#715 · Opened Jan 18, 2023
Only consider errors from modifiers in use Open

Difficulty 3/5 1-2 days Newbie friendliness 48/100

OpenZeppelin/openzeppelin-upgrades#714 · Opened Jan 18, 2023
Cannot read properties of undefined (reading 'content') Open

Difficulty 3/5 1-2 days Newbie friendliness 25/100

OpenZeppelin/openzeppelin-upgrades#713 · 1 comment · Opened Jan 16, 2023
Remove reliance on getTransactionByHash Open

Difficulty 4/5 3-5 days Newbie friendliness 45/100

OpenZeppelin/openzeppelin-upgrades#700 · 1 reaction · Opened Dec 13, 2022
Support using with hardhat-deploy Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

OpenZeppelin/openzeppelin-upgrades#680 · 1 comment · 9 reactions · Opened Oct 25, 2022
Support verifying proxy contracts from older versions Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

OpenZeppelin/openzeppelin-upgrades#674 · 4 comments · Opened Oct 17, 2022
Document use of retyped comments for incompatible enums Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

OpenZeppelin/openzeppelin-upgrades#659 · 4 comments · Opened Sep 21, 2022
Support adding variables at the end of storage gap Open

storage-checks

Difficulty 4/5 3-5 days Newbie friendliness 45/100

OpenZeppelin/openzeppelin-upgrades#656 · Opened Sep 14, 2022
Validation functions fail if contract has constructor args Open

bug good first issue

Difficulty 3/5 1-2 days Newbie friendliness 72/100

OpenZeppelin/openzeppelin-upgrades#654 · 2 comments · Opened Sep 13, 2022
Support read-only file systems Open

Difficulty 4/5 3-5 days Newbie friendliness 38/100

OpenZeppelin/openzeppelin-upgrades#651 · 2 comments · 1 reaction · Opened Sep 9, 2022

OpenZeppelin/openzeppelin-upgrades

Get new issues in your inbox