feat(soroban): add contract upgrade orchestration with state migration safety verification

[ayomidearegbeshola29-dev]

Summary

Implements Soroban Contract Upgrade Orchestration with state migration safety verification (#770).

Changes

• upgrade-orchestrator.ts: New module with:

  • diffAbiSchemas() — compares old/new ABI schemas using structural diff, detecting added, removed, and type-changed storage keys
  • orchestrateContractUpgrade() — orchestrates upgrades with schema safety checks and optional dry-run simulation
  • Breaking change detection: blocks upgrades that remove required keys or change storage key durability types
  • Dry-run support: simulates the upgrade transaction via Soroban RPC without broadcasting
  • Detailed SchemaDiffReport with human-readable summary and categorized changes

• index.ts: Added export for the new module

• upgrade-orchestrator.test.ts: Comprehensive tests covering:

  • Safe upgrades (identical schemas, adding keys)
  • Breaking change detection (removed required keys, type changes)
  • Dry-run simulation (success, RPC errors, simulation errors)
  • Edge cases (empty schemas, mixed changes)

Testing

✓ src/upgrade-orchestrator.test.ts  (16 tests)

Closes #770

[drips-wave]

@ayomidearegbeshola29-dev 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