Add how-to guide for storage data migration (#2228)#2299
Add how-to guide for storage data migration (#2228)#2299carstenjacobsen wants to merge 3 commits intomainfrom
Conversation
There was a problem hiding this comment.
Pull request overview
Adds a new how-to guide explaining how to safely migrate Soroban contract storage data when upgrading stored data structures, focusing on why naïve decoding traps and how to use explicit versioning patterns.
Changes:
- Introduces a “Version Marker Pattern” guide for per-record versioning and safe reads/writes across upgrades.
- Explains lazy vs eager migration tradeoffs for Soroban.
- Provides example test approaches for validating upgrade/migration behavior, plus an alternative “Versioned Enum Pattern”.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
@carstenjacobsen I've opened a new pull request, #2300, to work on those changes. Once the pull request is ready, I'll request review from you. |
|
Preview is available here: |
|
Preview is available here: |
|
Preview is available here: |
PR for issue #2228