Minimum Recipient Count Enforcement Per Invoice

[Kingsman-99]

Description

An invoice with a single recipient is effectively a direct payment and does not benefit from the splitting infrastructure. The contract should enforce a configurable minimum number of recipients per invoice to ensure the feature is used appropriately.

Technical Context

Store MinRecipientsPerInvoice: u32 in storage::instance in contracts/split/src/lib.rs. In create_invoice, count the entries in the recipients vector and compare against the minimum. Return TooFewRecipients { found: u32, min: u32 } (new error in types.rs) when below threshold. Admin method set_min_recipients allows updating the floor.

Acceptance Criteria

• Invoices with fewer recipients than the minimum are rejected with TooFewRecipients
• MinRecipientsPerInvoice defaults to 2 at deployment
• Admin can lower the minimum to 1 for single-recipient use cases
• TooFewRecipients error carries both found and min values for client display
• MinRecipientsUpdated(new_min) event is emitted from events.rs on admin change
• All CI checks (cargo build --target wasm32-unknown-unknown, cargo test, cargo clippy) pass and the branch has no merge conflicts

---

[senmalong]

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

hi,

I’d love to take this issue on. I’m a smart contract and full-stack developer with experience across OnlyDust, Drips Waves 1–5, and the GrantFox beta campaign.

My stack includes Rust, Soroban, Cairo, Solidity, and TypeScript. I can deliver a clean, tested, and well-documented solution within 24 hours of assignment.

Happy to start immediately.

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

[0darkside0rbit-star]

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

I would like to work on his issue please

ℹ️ Repo Maintainers: To accept this application, review their application or assign @0darkside0rbit-star to this issue.