marscoin / martianrepublic / 23808195253

11%

Build Type

push

github

Committed by Martian Congress

Commit Message

feat: civic wallet migration — MG_ OP_RETURN on-chain identity swap

New feature allowing citizens to migrate their civic wallet to a new
address. Follows the same OP_RETURN standard as other on-chain actions:

  MG_<new_civic_address>

The flow:
1. User generates a new wallet (new mnemonic → new civic address)
2. Signs a migration tx from OLD address with OP_RETURN MG_<new_addr>
3. Broadcasts to blockchain
4. Blockchain scanner picks up MG_ tx and completes the swap

Architecture: The web UI only records the broadcast (status='broadcast').
The blockchain scanner is the authority that completes the migration
(status='confirmed') — Laravel is just a reference implementation,
the blockchain is the trail of truth.

Includes:
- MigrationController with initiate/confirm/history endpoints
- civic_wallet_migrations table (preserves full audit trail)
- 30-day rate limit on migrations
- Full-page wizard UI (4 steps: intent → generate → sign → complete)
- Old wallet preserved as HD wallet (funds remain accessible)
- Warning: do NOT discard old seed before moving funds

Scanner integration (track_blockchain.py) to be added in next session
to handle the MG_ head code and complete the DB swap.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Coverage Stats

0 of 129 new or added lines in 1 file covered. (0.0%)

620 of 5667 relevant lines covered (10.94%)

1.5 hits per line