Outbound HTTP timeouts for Horizon and webhooks

[greatest0fallt1me]

Description

Ensure all fetch/axios (or undici) calls to Horizon and external risk providers use connect and read timeouts.

Requirements and context

• Configurable via environment.
• Surface structured errors to callers.

Suggested execution

Fork and branch

Fork the repo and create a branch:

git checkout -b chore/outbound-http-timeouts

Implement changes

• Audit horizonListener.ts and future HTTP clients.
• Add shared fetchWithTimeout utility under src/utils/.

Test and commit

Run tests, cover edge cases, and attach test output plus security or ops notes (auth, PII, Stellar keys) in the PR.

Run tests

npm test

Example commit message

chore(http): outbound timeouts for Horizon and integrations

Guidelines

• Minimum 95% coverage on touched modules where applicable (npm test / coverage report).

• Clear documentation (OpenAPI openapi.yaml, README, and inline comments for non-obvious logic).

• Timeframe: 96 hours.

• Run npm run build or tsc if types change.

• Keep OpenAPI in sync with route behavior.

[ReinaMaze]

@ReinaMaze has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

Gm maintainer, can I get assigned to work on this issue

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

[drips-wave]

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

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

[drips-wave]

This issue has been marked as completed by a Drips Wave moderator for @ReinaMaze as part of the Stellar Wave Program's 3rd Wave 🥳

Moderator's reason: [Auto-assessed] The contributor successfully implemented the 'fetchWithTimeout' utility as requested in the issue, including configurable environment variables, structured error handling, and comprehensive documentation. The PR #151 was reviewed and merged by the maintainers, confirming the quality and relevance of the work.

😎 @ReinaMaze: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.

ℹ️ Note: This issue was marked complete via moderation. Points were issued even though the GitHub issue remains open.