Governance-Only Upgradability Pattern

[hman38705]

Descriptions:

Issue #13:

Developer Goal: Implement safe contract upgrades via the update_current_contract_wasm host function.

• The upgrade function MUST be locked behind a 48-hour timelock and require a majority vote from the GuardianSet.

Verification Checklist:

• initiate_upgrade successfully starts a 48-hour clock.
• Attempting to execute_upgrade before 48 hours results in ErrorCode::TimelockActive.
• execute_upgrade successfully replaces the contract WASM and retains all persistent state.
• git checkout -b features/issue-13-Governance-Only Upgradability Pattern
• Pr Request create your pr against develop branch

---

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 200 Points.

🧑‍💻 Interested in contributing? Apply to work on this issue on Drips Wave, earn points, and receive rewards.

Warning

Only applications submitted via the apply link above will be considered. Please do not apply by commenting on the issue or opening a PR directly.

🤠 Repo maintainers: You can manage this issue's Points and Complexity on your Maintainer Dashboard here. Please keep an eye on applications and respond quickly 💙

ℹ️ Learn more about Drips Wave

[henrypeters]

@henrypeters has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

Hi I’m a full stack developer and I would love to work on your issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @henrypeters to this issue.

[Yusufolosun]

@Yusufolosun has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

Gooday Maintainer
I'm Yusuf, I will like to work on this task
I can implement maintainable solution as described in the issue description and deliver fast

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Yusufolosun to this issue.

[henrypeters]

@henrypeters has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

Hi, I would love to work on your issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @henrypeters to this issue.

[Chibey-max]

@Chibey-max has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

i can do this

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Chibey-max to this issue.

[sublime247]

@sublime247 has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

Hello
I will implement a governance-only upgrade mechanism using update_current_contract_wasm, protected by a 48-hour timelock and majority GuardianSet approval.

initiate_upgrade will start the timelock, and execute_upgrade will revert with ErrorCode::TimelockActive if called before 48 hours.

After the timelock and valid majority vote, execute_upgrade will update the contract WASM while preserving all persistent state.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @sublime247 to this issue.

[Emeka000]

@Emeka000 has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

i would like to work on this

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Emeka000 to this issue.

[drips-wave]

Congratulations, @Emeka000! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on February 26, 2026.

🧑‍💻 @Emeka000: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are issued when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[drips-wave]

This issue has been completed by @Emeka000 as part of the Stellar Wave Program's 2nd Wave 🥳

😎 @Emeka000: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.