Make Stellar network selection configurable instead of hardcoding MAINNET

[robertocarlous]

Summary

The backend currently uses MAINNET as a hardcoded Stellar network value in event and contract handling.

Problem

This limits deployment flexibility and makes testnet/futurenet deployments error-prone.

Proposed work

• Use environment/config values for Stellar network selection
• Validate network values against supported options (TESTNET, MAINNET, FUTURENET)
• Refactor any direct MAINNET usage to use config
• Update docs and env examples

Files

• src/stellar/events.ts
• src/stellar/contract.ts
• src/agent/README.md
• package.json or config env docs if needed

Acceptance criteria

• Network is read from config/env in all relevant code
• Hardcoded MAINNET removed from runtime logic
• Deployments can run using STELLAR_NETWORK=testnet or similar

[mikevill20]

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

Hello maintainer, please assign this issue to me. Thanks.

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

[Xaxxoo]

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

Hi can I work on this issue ?

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

[drips-wave]

Congratulations, @Xaxxoo! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 2, 2026.

🧑‍💻 @Xaxxoo: 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 🌊