skills.rest
barolivera
baroliveraCOMMUNITY
Explore all skills by this author →
GitHub

upgrade-stellar-contracts

Implement upgradeable Soroban Stellar contracts with OpenZeppelin tooling.

1|Updated Mar 21, 2026
Search Tags:#migration#upgrade#soroban#stellar#openzeppelin#contract-upgrade
One-click install
npx skills add https://github.com/barolivera/avalon --skill upgrade-stellar-contracts-barolivera
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: upgrade-stellar-contracts
Source: https://github.com/barolivera/avalon/tree/main/docs/skills/upgrade-stellar-contracts
Command: npx skills add https://github.com/barolivera/avalon --skill upgrade-stellar-contracts-barolivera

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenZeppelin's upgradeable tooling for Soroban contracts enables safe, versioned upgrades and migration paths, addressing the need for mutable WASM contracts in Stellar's Soroban environment.

Core Features & Use Cases

  • Upgradeable and UpgradeableMigratable patterns for Soroban contracts.
  • Atomic upgrade-and-migrate via an Upgrader contract to preserve state consistency.
  • Storage compatibility guidance and on-chain version tracking (SEP-49) for upgrade-safe deployments.
  • Guidance on access control, rollbacks, and migration strategies across deployments.

Quick Start

Consult the stellar-contracts repository for full integration examples and run a local test that upgrades a contract and performs a migrate call.

Frequently Asked Questions about upgrade-stellar-contracts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make Soroban contracts upgradeable safely?▼

To make Soroban contracts upgradeable safely, implement upgradeable patterns using OpenZeppelin tooling, which provides versioned upgrades, migration paths, and storage compatibility guidance for mutable WASM contracts.

What is the atomic upgrade and migrate pattern for Soroban contracts?▼

The atomic upgrade and migrate pattern uses an Upgrader contract to simultaneously replace WASM code and execute migration logic, preserving state consistency during Soroban contract upgrades.

Does OpenZeppelin work with Soroban for contract upgrades?▼

Yes, OpenZeppelin provides upgradeable tooling specifically for Soroban contracts, enabling safe versioned upgrades, migration paths, and on-chain version tracking via SEP-49.

How do I track contract versions during a Soroban upgrade?▼

Track contract versions during a Soroban upgrade by using on-chain version tracking aligned with SEP-49, deriving upgrade metadata directly from your Cargo.toml file.

What are the limitations when upgrading Stellar Soroban contracts?▼

Limitations when upgrading Stellar Soroban contracts include maintaining storage compatibility across versions and carefully sequencing migrations, as improper state handling can break contract functionality.

Related Skills

Explore More Software Engineering Skills→
OpenZeppelinOpenZeppelin
203

setup-stellar-contracts

Set up Soroban/Stellar smart contract projects with OpenZeppelin Rust crate dependencies.

Official
Intermediate
OpenZeppelinOpenZeppelin
203

upgrade-stellar-contracts

Upgrade Soroban smart contracts with WASM replacement and migration workflows.

Official
Intermediate
iamcapoteiamcapote

upgrade-stellar-contracts

Automate secure WASM upgrades for Stellar Soroban contracts.

Community
Advanced
pproencapproenca

python-project

Set up Python projects and manage dependencies with uv.

Community
Intermediate