When should I choose a Beacon proxy over UUPS?

You should choose a Beacon proxy when you need to deploy and manage many instances of a contract simultaneously. It allows you to upgrade every instance at once by updating a single Beacon contract.

How does this skill help prevent storage collisions during upgrades?

The skill provides strict storage layout rules, such as never changing the order or types of existing variables and using storage gaps in base contracts to ensure that new implementation versions don't overwrite existing state.

Does this skill include security checklists for contract upgrades?

Yes, it integrates with security audit workflows and provides checklists for safe upgrade practices, ensuring critical functions like _authorizeUpgrade are correctly and securely implemented.

Which proxy pattern is recommended for most Solidity use cases?

UUPS (Universal Upgradeable Proxy Standard) is generally recommended because it is more gas-efficient than Transparent proxies and offers more flexible upgrade authorization logic directly within the implementation contract.

Solidity Proxy Patterns

Name: Solidity Proxy Patterns
Author: IvanTorresEdge

byIvanTorresEdge

Security & Testing

Provides expert guidance and implementation patterns for building upgradeable Ethereum smart contracts using UUPS, Transparent, and Beacon proxies.

About

The Proxy Patterns skill serves as a comprehensive reference for developers implementing or auditing upgradeable smart contracts in Solidity. It guides users through selecting the optimal proxy architecture—ranging from gas-efficient UUPS to robust Transparent and Beacon patterns—while enforcing critical storage layout rules to prevent data corruption. This skill is essential for ensuring long-term maintainability and security in blockchain applications where contract immutability needs to be balanced with the ability to fix bugs and add features.

Key Features

Reference patterns for EIP-2535 Diamond Pattern for large-scale contracts
0 GitHub stars
Storage layout safety checks and validation rules to prevent state corruption
Implementation guidance for UUPS, Transparent, and Beacon proxy patterns
Standardized boilerplate for upgradeable contract initialization and authorization
Comparative analysis of proxy patterns based on gas efficiency and complexity

Use Cases

Optimizing gas costs for multi-instance contract deployments using Beacons
Conducting security reviews of smart contract upgradeability and storage logic
Designing upgradeable DeFi protocols or NFT collections with long-term support

About

Key Features

Reference patterns for EIP-2535 Diamond Pattern for large-scale contracts
0 GitHub stars
Storage layout safety checks and validation rules to prevent state corruption
Implementation guidance for UUPS, Transparent, and Beacon proxy patterns
Standardized boilerplate for upgradeable contract initialization and authorization
Comparative analysis of proxy patterns based on gas efficiency and complexity

Use Cases

Optimizing gas costs for multi-instance contract deployments using Beacons
Conducting security reviews of smart contract upgradeability and storage logic
Designing upgradeable DeFi protocols or NFT collections with long-term support