Large Batch Payment Operation Chunker

[Kingsman-99]

Description

Stellar transactions are limited to 100 operations each. When a split invoice has more recipients than that limit, the SDK crashes attempting to build an over-limit transaction rather than splitting it into multiple chained transactions. A chunker should automatically partition recipient operations into valid transaction batches, submit them in sequence, and report the batch results as a single logical invoice payment.

Technical Context

Add src/operationChunker.ts. Reads MAX_OPERATIONS_PER_TRANSACTION = 100 constant. Accepts OperationOptions[] from @stellar/stellar-sdk and partitions them into chunks. Each chunk is built via src/txBuilder.ts. Chunks are submitted in sequence using src/client.ts. All chunk hashes are recorded in BatchPaymentResult added to src/types.ts. Integrates with src/idempotency.ts to prevent duplicate chunk submission on retry.

Acceptance Criteria

• OperationChunker.chunk(operations: OperationOptions[], chunkSize = 100): OperationOptions[][] partitions operations into sub-arrays of at most chunkSize
• OperationChunker.submitAll(chunks, txBuilderConfig): Promise<BatchPaymentResult> submits each chunk sequentially and collects txHash per chunk
• On partial failure (one chunk succeeds, the next fails), reports successful chunks in BatchPaymentResult.succeeded and the failed chunk in BatchPaymentResult.failed
• Uses src/idempotency.ts idempotency keys per chunk to ensure a retry does not resubmit already-successful chunks
• Unit tests with 150 and 250 recipients assert correct chunk counts (2 and 3 respectively) and that each chunk is within the operation limit
• All CI checks (npm test, npm run build, ESLint/TypeScript) pass and the branch has no merge conflicts

---

[Luchistack]

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

Hi Maintainer. i would love to work on this issue.

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

[Anichris-koded]

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

Hi my name is Koded, please assign me to this issue.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Anichris-koded 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.

[Fabulouz34]

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

Hi maintainer please I will appreciate it if I'm given this issue to work on. Please assign me I'm ready to get started
Thank you

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

[Emmanuellsensai]

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

Hi maintainer, please assign this issue to me

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

[webdevayo]

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

Hello Maintainer, i'm an experienced full stack dev and i will like to work on this issue.
if you'll kindly assign, the issue will be resolved.
ETA: 5 Hours

ℹ️ Repo Maintainers: To accept this application, review their application or assign @webdevayo 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 🌊