upgrade-stellar-contracts

Soroban contracts are mutable by default. Mutability refers to the ability of a smart contract to modify its own WASM bytecode, altering its function interface, execution logic, or metadata. Soroban provides a built-in, protocol-level mechanism for contract upgrades — no proxy pattern is needed.

A contract can upgrade itself if it is explicitly designed to do so. Conversely, a contract becomes immutable simply by not provisioning any upgrade function. This is fundamentally different from EVM proxy patterns:

| | Soroban | EVM (proxy pattern) | Starknet |

OpenZeppelin のアップグレード可能なモジュールを使用して、Stellar/Soroban スマート コントラクトをアップグレードします。ユーザーが以下を行う必要がある場合に使用します: (1) ネイティブ WASM 置換によってそろばんコントラクトをアップグレード可能にする、(2) Upgradeable または UpgradeableMigratable 派生マクロを使用する、(3) Upgrader コントラクトを使用してアトミックなアップグレードおよび移行パターンを実装する、(4) アップグレード間でのストレージ キーの互換性を確保する、または (5) そろばんコントラクトのアップグレード パスをテストする。 ソース: openzeppelin/openzeppelin-skills。