Add a numeric chain-id validation scheme as an alternative to free-text src_chain

[james2177]

Description

As a more solver-bot-friendly alternative (or complement) to a string-based allowlist, consider validating src_chain against standard numeric chain IDs (e.g. EVM chain IDs), which are less ambiguous for programmatic matching than free-text names like "ethereum".

Requirements and context

• Weigh this against the string-based enum approach in the other src-chain issues -- these are alternative designs, not both meant to ship

Suggested execution

1. Fork the repo and create a branch

   git checkout -b docs/chain-id-vs-string-comparison
   

2. Prototype the chain-ID approach and compare ergonomics against the string enum
3. Bring the comparison back to whichever src-chain issue is picked up first for a final decision

Example commit message
feat: add a numeric chain-id validation scheme as an alternative t

Guidelines

• Assignment required before starting -- comment on the issue to claim it
• PR description must include: Closes #<this issue's number>
• Complexity: High (200 points)

[Hikmaholadele]

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

Hello Maintainer, I'd love to work on this issue.

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

[abdulazizishaq212-prog]

@abdulazizishaq212-prog has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

i will like to work on this issues

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

[emmixeryng]

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

Hi, am ready to fix this issue, kindly assign

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

[Coredevjay]

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

please assgin me this issue

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

[drips-wave]

Congratulations, @Coredevjay! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on July 30, 2026.

🧑‍💻 @Coredevjay: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊