Skip to content

[HARD][SOROBAN GOVERNANCE] Add timelocked, quorum-approved WASM upgrades with schema migration guards #164

Description

@Obiajulu-gif

Summary

The design documents call for upgradeable contracts and governed production releases, but the contracts expose no controlled WASM upgrade or schema-migration entrypoint.

Repository evidence

  • docs/stellar-asset-and-soroban-design.md describes Mainnet upgradeability, quorum approval, and timelocks.
  • The Soroban contracts do not expose an authorized update_current_contract_wasm path or persisted schema version.

Scope

  • Add proposal, approval, timelock, execution, and cancellation states for upgrades.
  • Persist code/schema versions and require an explicit migration plan before activation.
  • Emit auditable proposal and execution events.

Acceptance criteria

  • No single signer can upgrade immediately.
  • Execution is impossible before quorum and timelock conditions are met.
  • Incompatible schema versions fail before changing the active WASM.

Tests

  • Authorization, quorum, expiry, cancellation, and replay tests.
  • Upgrade fixture proving state survives a supported migration and rejects an incompatible one.

Non-goals

  • Choosing a specific multisig vendor or deploying an upgrade to Mainnet.

Metadata

Metadata

Assignees

Labels

GrantFox OSSIssue tracked in GrantFox OSSMaybe RewardedIssue may be eligible for a GrantFox rewardThird CampaignCampaign: Third Campaign

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions