Soroban storage entry recovery tooling

[truthixify]

Tier: M (2-4 days) Type: tooling

Context

Soroban storage entries get archived after TTL expiry. Recovery exists but is manual and error-prone. Build tooling that surfaces archived state and restores it with cost estimation.

Scope

• stellar/scripts/recover-storage.ts CLI
• Subcommands: list-archived <contract-id>, estimate-restore <key>, restore <key>
• Reads Stellar Expert API or RPC for archived entries
• Pre-computes XLM cost before restoring
• Idempotent restore (no-op if already live)
• Documentation

Acceptance criteria

• CLI implemented + tested against futurenet
• Cost estimator accurate
• Documentation in stellar/README.md
• Per-contract recovery procedure section

Files to start with

• New: stellar/scripts/recover-storage.ts
• Soroban state archival docs