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.