API: Payout Scheduling & Recurring Jobs (BullMQ)

[0xdevcollins]

Summary

Implement payout scheduling (future-dated) and recurring payout configuration using BullMQ.

Requirements

• scheduledAt field on payout — execute at specified time
• Recurring payout config: daily, weekly, bi-weekly, monthly
• BullMQ delayed jobs for scheduled payouts
• BullMQ repeatable jobs for recurring payouts
• Batch processing: group pending payouts into batches for efficiency
• Balance check before execution — fail gracefully if insufficient
• 2FA confirmation for payouts above configurable threshold

Acceptance Criteria

• Scheduled payouts execute at correct time (±30s)
• Recurring payouts generate new payout records on schedule
• Batch processing groups payouts efficiently
• Insufficient balance fails with clear error, doesn't debit
• Payout jobs survive API restart (persisted in Redis)

[RemmyAcee]

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

Based on your request, I will implement and fix this issue according to the design requirement and to fit your acceptance criteria

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

[Dubemtopsite]

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

Good day. I would like to work on this issue

Thanks

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

[1sraeliteX]

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

I would like to work on the issue because implementing payout scheduling and recurring jobs with BullMQ is critical for enabling reliable time-based and automated financial operations in the system. I’ll add support for scheduledAt execution using delayed jobs, implement recurring payout configurations (daily, weekly, bi-weekly, monthly) using repeatable BullMQ jobs, and introduce batch processing to efficiently group pending payouts.

I’ll also integrate a pre-execution balance validation step to prevent overdrafts with graceful failure handling, and enforce 2FA verification for payouts above configurable thresholds. Finally, I’ll ensure job persistence across restarts via Redis-backed BullMQ queues and add comprehensive tests for scheduling accuracy, recurrence correctness, batching behavior, and failure scenarios.

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

[boalambo]

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

Hi Maintainer,

I’m a smart contract and full-stack developer with experience in Rust, Soroban, Cairo, and TypeScript. I’m interested in contributing to this issue and can deliver a complete solution within 24 hours.

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

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