Self Upgrade & State Migration
Three examples on how to handle updates and state migration:
- State Migration: How to implement a
migratemethod to migrate state between contract updates. - State Versioning: How to use readily use versioning on a state, to simplify updating it later.
- Self Update: How to implement a contract that can update itself.
State Migration​
The State Migration example shows how to handle state-breaking changes between contract updates.
It is composed by 2 contracts:
- Base: A Guest Book where people can write messages.
- Update: An update in which we remove a parameter and change the internal structure.
- 🦀 Rust
Loading...
The Migration Method​
The migration method deserializes the current state (OldState) and iterates through the messages, updating them
to the new PostedMessage that includes the payment field.
Notice that migrate is actually an initialization method that ignores the existing state ([#init(ignore_state)]), thus being able to execute and rewrite the state.
State Versioning​
The State Versioning example shows how to use Enums to implement state versioning on a contract.
Versioning simplifies updating the contract since you only need to add a new version of the structure. All versions can coexist, thus you will not need to change previously existing structures.
The example is composed by 2 contracts:
- Base: The Guest Book contract using versioned
PostedMessages(PostedMessagesV1). - Update: An update that adds a new version of
PostedMessages(PostedMessagesV2).
- 🦀 Rust
Loading...
Self Update​
The Self Update example shows how to implement a contract that can update itself.
It is composed by 2 contracts:
- Base: A Guest Book were people can write messages, implementing a
update_contractmethod. - Update: An update in which we remove a parameter and change the internal structure.
- 🦀 Rust
Loading...
