upgrade-stellar-contracts
OfficialSafely upgrade Soroban smart contracts
AuthorOpenZeppelin
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Helps developers and auditors perform safe upgrades of Soroban (Stellar) smart contracts by guiding WASM binary replacement, storage migration, and access-control checks to avoid accidental state corruption or loss of upgradeability.
Core Features & Use Cases
- WASM binary upgrades: Use derive macros to replace contract WASM while preserving on-chain storage.
- Upgrade-and-migrate support: Provide UpgradeableMigratable patterns and an Upgrader wrapper to achieve atomic upgrade-and-migrate flows.
- Safety guidance and versioning: Explain storage key compatibility rules, authorization requirements, and embedding crate versions into WASM metadata for tracking.
- Use case: Test deploying V1 locally, write state, upgrade to V2 with migration data, and verify storage and access control on a Soroban testnet.
Quick Start
Upgrade a deployed Soroban contract to a new WASM version on a local testnet, run the required migration with an authorized operator, and verify storage reads after the upgrade.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: upgrade-stellar-contracts Download link: https://github.com/OpenZeppelin/openzeppelin-skills/archive/main.zip#upgrade-stellar-contracts Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.