Docs/stellar v0 to v1 migration

[Truphile]

Summary of Changes

1. Indexer SQL Migration & Validation Suite (indexer) — Commit
   001_v0_to_v1.sql
   • schema_v0.sql: Base v0 indexer DDL schema for announcements,
   registrations, names, and splitters.
   • 001_v0_to_v1.sql: Non-destructive SQL migration script introducing
   view_tag_bucket (topic 2), metadata_kind, scheme_version, persistent
   storage TTL tracking, subdomain/multisig name attributes, pausable
   states, upgrade timelock proposals, rate-limiting windows, and vault
   deposit tables.
   • schema_v1.sql: Consolidated post-migration v1/v2 database schema.
   • validate_migration.py: Automated test suite that executes schema
   migration, verifies historical data preservation, tests composite view-
   tag query performance, and updates indexer_metadata.schema_version to 1.
   • README.md: Comprehensive documentation for off-chain indexer
   operators.
2. v0 to v1 Migration Documentation (MIGRATION_V0_TO_V1.md) — Commit
   MIGRATION_V0_TO_V1.md
   • Governance & Upgradability Matrix: Complete classification of frozen
   vs timelocked contracts and pause support.
   • Field-by-Field Storage Diff: Detailed table mapping every DataKey
   enum, storage type (instance() vs persistent()), data types, and
   default values across all contracts (stealth-sender, wraith-names,
   stealth-vault, stealth-splitter, wraith-asset-policy, stealth-registry).
   • Event-Topic Layout Diff: Breakdown of stealth-announcer v0 vs v1/v2
   event schemas, explaining how indexing view_tag_bucket as Topic 2
   enables 256-bucket RPC getEvents server-side filtering for a ~99.6%
   bandwidth reduction.
   • End-to-End Upgrade Order: Step-by-step checklist spanning pre-
   migration setup, database migrations, circuit-breaker pausing, storage
   TTL extension, 7-day governance timelock WASM upgrades, configuration,
   and unpausing.
   • Futurenet Rehearsal Log: Detailed run log capturing network RPC
   parameters, preflight validation, dry-run output (deploy.sh futurenet -
   -dry-run), storage extension, WASM installation hash, circuit breaker
   invocation, and integration verification.

closes #124

[drips-wave]

@Truphile Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits