upgrade-solidity-contracts

| Pattern | Upgrade logic lives in | Best for |

| UUPS (UUPSUpgradeable) | Implementation contract (override authorizeUpgrade) | Most projects — lighter proxy, lower deploy gas | | Transparent | Separate ProxyAdmin contract | When admin/user call separation is critical — admin cannot accidentally call implementation functions |

| Beacon | Shared beacon contract | Multiple proxies sharing one implementation — upgrading the beacon atomically upgrades all proxies |

Aggiorna i contratti intelligenti Solidity utilizzando i modelli proxy OpenZeppelin. Da utilizzare quando gli utenti devono: (1) rendere i contratti aggiornabili con proxy UUPS, Transparent o Beacon, (2) scrivere inizializzatori anziché costruttori, (3) utilizzare i plug-in di aggiornamento Hardhat o Foundry, (4) comprendere le regole del layout di archiviazione e l'archiviazione con spazio dei nomi ERC-7201, (5) convalidare la sicurezza dell'aggiornamento, (6) gestire distribuzioni e aggiornamenti dei proxy o (7) comprendere le restrizioni di aggiornamento tra le versioni principali di OpenZeppelin Contracts. Fonte: openzeppelin/openzeppelin-skills.