State Transfer Overview

State Transfer Overview

State Transfer is the process of migrating state from the Morse network to the Shannon network.

---

What is ETVL?

ETVL is an abbreviation for the State Transfer process including Export, Transform, Validate, and Load.

• ETVL is the process for migrating state from the Morse network to the Shannon network.

• This is not a full restart (not a re-genesis).

• Goal: Optimize the exported Morse state for long-term impact on Shannon.

---

Design Considerations & Constraints

1

Re-use Morse CLI tooling

• Export Morse state:

Export Morse state

pocket util export-genesis-for-reset ...

• Export Morse account keys for Shannon claims:

Export Morse account keys

pocketd txmigrate claim-...

2

Offchain social consensus

• Use cryptographic hash verification

• Community agrees offchain on the canonical MorseAccountState

3

Minimize Shannon onchain state bloat

• Keep onchain data small and fast

• Transform Morse export into minimal MorseClaimableAccount objects

• Only store what’s needed for claims

---

ETVL High-Level Flow

The following preserves the logical flow between Morse (export), Off-chain processing (transform & validation), and Shannon (load/on-chain persistence):

Shannon On-Chain

Off-Chain

Morse On-Chain

Migration Module State

MsgImportMorseClaimableAccounts

MorseAccountState

MorseAccountState

MorseStateExport

**Validate** (identical)

**Load** (Onchain Persistence)

Track exported
account unstaked balance

Track exported
Supplier stake

Track exported
Application stake

**Export**

**Validate** (SHA256)

**Validate** (SHA256)

**Load** (Authorized Tx)

MorseState

**Transform**

MorseAppState

MorseApplications

MorseAuth

MorsePos

MorseApplication

MorseAuthAccount

MorseAccount

MorseValidator

MorseClaimableAccount

MorseAccountStateHash (Authority Derived)

MorseAccountStateHash (User Derived)

MorseClaimableAccount

MorseAccountStateHash

MorseClaimableAccount

---