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

0•

Security & Testing

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

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

01Reference patterns for EIP-2535 Diamond Pattern for large-scale contracts

020 GitHub stars

03Storage layout safety checks and validation rules to prevent state corruption

04Implementation guidance for UUPS, Transparent, and Beacon proxy patterns

05Standardized boilerplate for upgradeable contract initialization and authorization

06Comparative analysis of proxy patterns based on gas efficiency and complexity

Use Cases

01Optimizing gas costs for multi-instance contract deployments using Beacons

02Conducting security reviews of smart contract upgradeability and storage logic

03Designing upgradeable DeFi protocols or NFT collections with long-term support

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ivantorresedge/molcajete.ai proxy-patterns

For use in Claude.ai and ChatGPT

Download Skill