GraphQL subscriptions for live transfer streams

[Miracle656]

Background

Clients want push updates for new transfers/events without polling. GraphQL subscriptions over WebSocket are the idiomatic fit.

What to build

Add a subscription resolver that streams new TokenTransfer/HostFnLog rows as they're ingested, with per-client filters (contract/asset) and backpressure handling.

Key files

• src/api/graphql.ts
• src/api/subscriptions.ts (new)

Acceptance criteria

• Subscribe receives new rows in real time
• Filter by contract/asset works
• Slow consumer doesn't OOM the server (backpressure)

Drips Wave · Complexity: Advanced · 200 points

[benedictworks-home]

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

Hello Maintainer, I would love to work on this issue.

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

[GEEKYFOCUS]

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

Hi Miracle656/wraith,

I’ll implement GraphQL subscriptions for real-time transfer streams over WebSocket by adding a dedicated subscription layer in src/api/subscriptions.ts and wiring it into the existing GraphQL server in src/api/graphql.ts. The resolver will stream newly ingested TokenTransfer and HostFnLog records with support for per-client filters such as contract and asset.

I’ll also implement proper backpressure handling to ensure slow subscribers do not exhaust memory or degrade server performance, using controlled buffering and safe emission patterns. The final implementation will guarantee real-time delivery, filter correctness, and system stability under load.

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

[Zainab5970]

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

please can i work on the issue

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

[oncleweynom]

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

goodmorning would want to work on this issue please

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

[Just-Bamford]

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

I'd love to work on this issue

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

[drips-wave]

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

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