Horizon Streaming Health Probe with Auto-Reset

[Kingsman-99]

Description

The SDK's Horizon streaming connections silently stall when the underlying network changes (e.g. WiFi handoff, VPN reconnect) without closing the TCP connection cleanly, leaving the SSE stream appearing open but delivering no events. A health probe should send periodic heartbeat checks, detect stalled streams by measuring event interarrival time, and automatically tear down and reopen the stream connection when a stall is detected.

Technical Context

Add src/streamHealthProbe.ts. Monitors src/sse.ts and src/stream.ts connections. Tracks the timestamp of the last received event per stream ID. When Date.now() - lastEventAt > stalledThresholdMs (configurable, default 30 000), marks the stream as stalled and calls reconnect(). Emits streamStallDetected and streamAutoReset via src/events.ts. Integrates with src/health.ts.

Acceptance Criteria

• StreamHealthProbe.attach(streamId, stream) begins monitoring event interarrival time for the given stream
• When no event is received within stalledThresholdMs, emits streamStallDetected and invokes the registered onStall callback
• autoReset: true causes the probe to close the stalled stream and invoke the stream factory to create a replacement
• After auto-reset, resumes from the last persisted cursor via src/cursorTracker.ts
• Unit tests simulate a stalled stream (no events for > threshold) and assert streamStallDetected fires and onStall is called
• All CI checks (npm test, npm run build, ESLint/TypeScript) pass and the branch has no merge conflicts

---

[dot-enny]

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

Hello maintainer, I'd like to work on this please. Thank you.

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

[ValJnr-dev1]

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

Hi Maintainer,

I’m a smart contract and full-stack developer and would love to contribute to this issue. I’m an experienced contributor with hands-on expertise in Rust, Soroban, Cairo, and TypeScript.

I’m passionate about building secure, scalable blockchain solutions, with a strong emphasis on writing clean and maintainable code. Based on the scope of this issue, I’m confident I can deliver a complete solution within 24 hours of assignment.

I’d greatly appreciate the opportunity to contribute and help move this forward.

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

[sladeoj]

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

hello maintainer i would love to work on this issue please

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

[Busiii-adetiba]

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

Hi can i work on this issue.

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

[drips-wave]

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

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

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox!

@Busiii-adetiba's PR #579 was approved and merged by @Kingsman-99.

🏆 @Busiii-adetiba: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (83 total points). Track your full progress on GrantFox.

👏 Great work, @Busiii-adetiba! Keep contributing to Stellar-split.

[drips-wave]

This issue has been completed by @Busiii-adetiba as part of the Stellar Wave Program's 7th Wave 🥳

😎 @Busiii-adetiba: 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. You can also Leave a review to share your experience working on this issue.

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