Implement SDK compression middleware

[Kingsman-99]

Label: complexity: high
Points: 200

Description

Large batch responses from the RPC can be slow to transfer. This issue adds optional compression middleware that compresses outgoing request bodies and decompresses incoming responses using the browser's CompressionStream API or Node.js zlib.

Technical Context

Involves a new src/compression.ts. Detect environment and use CompressionStream (browser) or zlib.gzip (Node.js). Add compression?: { enabled: boolean; algorithm: 'gzip' | 'deflate' } to StellarSplitClientConfig. Apply via request/response interceptors. Only compress payloads > 1KB.

Acceptance Criteria

• Compression disabled by default
• Compresses request bodies > 1KB when enabled
• Decompresses compressed responses automatically
• Works in both browser and Node.js environments
• Test verifies compressed payload smaller than original
• All existing tests pass
• TypeScript strict mode — zero any types

---

[khanavi272-spec]

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

I would like to work on this issue

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

[webdevayo]

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

Hi, I would love to implement this compression middleware for the SDK.

I can build a lightweight, efficient middleware layer that handles compression/decompression for outbound and inbound network payloads, reducing payload sizes and optimizing data transfer speeds. I'll ensure it integrates seamlessly with the existing SDK configuration and handles edge cases or fallback scenarios gracefully.

I’m available to start immediately, will provide clean code with thorough test coverage, and will ensure it’s fully merged before the Wave deadline. Thank you!

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

[Henrichy]

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

My name is Henry Nzekwe, a full stack software developer with experience in TypeScript, SDK development, browser and Node.js runtimes, API optimization, and performance engineering. I am interested in implementing the compression middleware for the Stellar Split SDK.

I can design and build a robust src/compression.ts module that supports both browser and Node.js environments by leveraging the CompressionStream API where available and Node.js zlib for server-side execution. The implementation will introduce configurable compression settings, apply request and response interceptors, compress only payloads larger than 1KB, and automatically handle decompression of supported responses.

I will ensure compression remains disabled by default, maintain strict TypeScript compliance with zero any types, and add comprehensive tests validating compression ratios, cross-environment compatibility, automatic decompression, and overall compatibility with the existing SDK test suite.

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

[Eromosele0110]

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

I will like to work on this issue

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

[drips-wave]

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

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