Add Soroban event replay tooling with cursor reset and partial range backfill

[thlpkee20-wq]

Description

Operators need a CLI to reset the indexer cursor and replay Soroban events for a partial range, with safety rails preventing replay across an unrelated network or contract id.

Requirements and context

• Must be secure, tested, and documented
• Should be efficient and easy to review
• Relevant code: src/lib/stellarRpcClient.ts, src/services/
• CLI must require a confirmation hash before applying

Suggested execution

• Fork the repo and create a branch
• git checkout -b feat/soroban-replay-cli
• Implement changes
  • Add scripts/replay-soroban-events.ts with dry-run default
  • Verify network passphrase and contract id checksum
  • Emit progress metrics and audit log
• Validate security and correctness assumptions

Test and commit

• Run tests
  • npm test
• Cover edge cases
  • Wrong network, overlapping range, mid-run abort
• Include test output and notes

Example commit message

feat: Soroban event replay CLI with safety rails

Guidelines

• Minimum 95 percent test coverage
• Clear documentation
• Timeframe: 96 hours

[Osuochasam]

@Osuochasam has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

I would like to contribute here, please assign to me

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Osuochasam to this issue.