Add batch dividend claim so holders can collect earnings from multiple creators in one transaction

[Chucks1093]

Summary

A fan who holds keys for several creators has to call claim_dividend separately for each one. Each call is a separate Soroban transaction with its own fee. A batch claim function lets a holder collect dividends from multiple creators in a single transaction, reducing fees and making the claim flow practical when holding a diversified portfolio.

Scope

• Add batch_claim_dividend(claims: Vec<CreatorId>) -> Vec<ClaimResult> function
  • claims is a list of creator IDs to claim from in one call
  • For each creator ID: if the caller has a claimable balance, transfer it and zero the balance; if zero, skip silently (no revert)
  • Returns a result per creator: { creator_id, amount_claimed } — zero for creators with nothing to claim
  • Maximum 20 creator IDs per call to bound execution cost
  • Each claim within the batch is independent — a failure on one creator does not revert the others

Acceptance Criteria

• Dividends claimed from all specified creators in one call
• Creators with zero claimable balance return amount_claimed: 0 and do not revert
• Each claimed balance zeroed after the batch completes
• More than 20 creator IDs reverts with a clear error
• Caller XLM balance increases by the sum of all claims
• Individual claim failures are isolated and do not revert the whole batch

ETA: 24 hours

---

Coordinate on Telegram

[khanavi272-spec]

I would like to work on this issue

[GBOYEE]

I'll take this. Implementing batch_claim_dividend(creator_ids: Vec<Address>) that loops over creators and accumulates payouts in a single transaction, reducing Soroban fee overhead for multi-creator holders. Adding tests for: empty list, single creator, multiple creators, zero-balance skip. Branch: feat/batch-claim-dividend

[JamesVictor-O]

Hello! I’d love to take on this issue. I’ve reviewed the requirements and have a clear path forward for the implementation. I estimate I can have a PR ready within about 3 hours of being assigned. Could you please assign this to me?

[grantfox-oss]

🦊 GrantFox — @JamesVictor-O has been assigned to this issue as part of the Official Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #521)
2. Your PR will be reviewed by the accesslayerorg maintainers

Good luck! Track your progress on GrantFox.

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox as part of the Official Campaign campaign!

@JamesVictor-O's PR #527 was approved and merged by @Chucks1093.

🏆 @JamesVictor-O: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (471 total points). Track your full progress on GrantFox.

👏 Great work, @JamesVictor-O! Keep contributing to accesslayerorg.