Inconsistent storage layout for ERC2771ContextUpgradeable
Impact
The storage layout of the ERC2771ContextUpgradeable is not constant between versions.
- versions
4.0.0,4.1.0and4.2.0, the contract has a length of 51 slots. - since
4.3.0, the contract has a length of 50 slots - future versions will continue using 50 slots.
This difference in layout could result in breaking upgrades if someone upgrades from an affected version to a non-affected version. It is thus recommended to be extremely careful when upgrading from a contract that uses ERC2771ContextUpgradeable <4.3.0 to a newer version that uses >=4.3.0.
We've assessed the instances of this contract found on chain (with publicly verified source code) and notified the corresponding teams of the risk that an upgrade could cause.
Workarounds
Potentially breaking upgrades would be caught by the OpenZeppelin Upgrades Plugins for Hardhat and Truffle. It is recommended to use this tooling for all your upgrades.
If you need to upgrade to a newer version of the Upgradeable Contracts library, we recommend copying the previous implementation ERC2771ContextUpgradeable (available in the release-4.2 branch) and packaging it with your code.
Reference
https://github.com/OpenZeppelin/openzeppelin-transpiler/pull/86
For more information
If you have any questions, comments, or need assistance regarding this advisory, email us at security@openzeppelin.com.
To submit security reports please use our bug bounty on Immunefi.
Affected software
Click a technology to see all vulnerabilities affecting it.
| Platform | Package | Vulnerable versions | Fixed in |
|---|---|---|---|
| npm package | @openzeppelin/contracts-upgradeable | >= 4.0.0, < 4.3.0 | 4.3.0 |
References
- Weakness (CWE)
-- Platform
- npm
- Package
@openzeppelin/contracts-upgradeable- Disclosed
- 14.03.2022
- Updated
- 11.10.2026 10:22
Sources and licenses
OSV / GitHub Advisory Database - GHSA-7j52-6fjp-58gr - CC BY 4.0
Vulnerability history: @openzeppelin/contracts-upgradeable
All published vulnerabilities of this package (npm package), newest first. Shows whether this is a one-off slip or a package that needs watching.
- Total entries
- 22
- First → latest
- 08.2021 07.2025
- Without a fix
- 0
- Exploited in attacks
- 0
Severity breakdown
- Critical 3
- High 5
- Medium 12
- Low 2
Disclosures per year
- 2021: 5
- 2022: 8
- 2023: 7
- 2024: 1
- 2025: 1
- 2026: 0
-
Inconsistent storage layout for ERC2771ContextUpgradeable this entry
Know which vulnerabilities affect your application
With the DockRay integration and software inventory enabled, DockRay checks reported component versions against known vulnerabilities and notifies you about confirmed matches. Coverage depends on the supported technology and available advisory data.