Upgrade Stylus smart contracts using OpenZeppelin proxy patterns on Arbitrum. Use when users need to: (1) make Stylus Rust contracts upgradeable with UUPS or Beacon proxies, (2) understand Stylus-specific proxy mechanics (logic_flag, WASM reactivation), (3) integrate UUPSUpgradeable with access control, (4) ensure storage compatibility across upgrades, or (5) test upgrade paths for Stylus contracts.
Quickly install upgrade-stylus-contracts AI skill to your development environment via command line
Source: openzeppelin/openzeppelin-skills.
Stylus contracts run on Arbitrum as WebAssembly (WASM) programs alongside the EVM. They share the same state trie, storage model, and account system as Solidity contracts. Because of this, EVM proxy patterns work identically for Stylus — a Solidity proxy can delegate to a Stylus implementation and vice versa.
| Proxy mechanism | Same — delegatecall to implementation contract | delegatecall to implementation contract | | Storage layout | #[storage] fields map to the same EVM slots as equivalent Solidity structs | Sequential slot allocation per Solidity rules | | EIP standards | ERC-1967 storage slots, ERC-1822 proxiable UUID | Same |
| Context detection | logicflag boolean in a unique storage slot (no immutable support) | address(this) stored as immutable | | Initialization | Two-step: constructor sets logicflag, then setversion() via proxy | Constructor + initializer via proxy |
Stable fields and commands for AI/search citations.
npx skills add https://github.com/openzeppelin/openzeppelin-skills --skill upgrade-stylus-contractsUpgrade Stylus smart contracts using OpenZeppelin proxy patterns on Arbitrum. Use when users need to: (1) make Stylus Rust contracts upgradeable with UUPS or Beacon proxies, (2) understand Stylus-specific proxy mechanics (logic_flag, WASM reactivation), (3) integrate UUPSUpgradeable with access control, (4) ensure storage compatibility across upgrades, or (5) test upgrade paths for Stylus contracts. Source: openzeppelin/openzeppelin-skills.
Open your terminal or command line tool (Terminal, iTerm, Windows Terminal, etc.) Copy and run this command: npx skills add https://github.com/openzeppelin/openzeppelin-skills --skill upgrade-stylus-contracts Once installed, the skill will be automatically configured in your AI coding environment and ready to use in Claude Code, Cursor, or OpenClaw
https://github.com/openzeppelin/openzeppelin-skills