Storage Layout

The storage layout defines how variables are arranged and accessed within the storage slots of a smart contract. Maintaining a consistent storage layout is the most critical challenge when upgrading proxy-based contracts.

If a developer adds a new variable or changes the type of an existing one in the implementation contract without respecting the previous layout, the proxy will read the wrong data, leading to corruption of user positions and collateral balances. Advanced techniques, such as using storage gaps or namespaces, are employed to ensure that storage slots remain aligned across multiple versions, safeguarding the integrity of the protocol's financial data.