Add a batch transfer function allowing holders to send keys to multiple recipients in a single transaction

[teethaking]

Summary

Closes #799

Adds batch_transfer_keys(creator, from, transfers: Vec<(Address, u32)>) — a new entrypoint that lets any holder distribute keys to up to 10 recipients in one signed, atomic transaction.

Changes

creator-keys/src/lib.rs

• ContractError: append BatchTransferSizeExceeded = 51 and InvalidRecipient = 52 (ABI-safe, end-of-enum)
• MAX_BATCH_TRANSFER_SIZE = 10 constant
• batch_transfer_keys implementation:
  • from.require_auth() + assert_not_paused guards
  • Pre-flight pass: validates size <= 10, all quantities > 0, no self-recipients, accumulates total with overflow protection
  • Reads sender balance once and settles dividend checkpoint before any mutation
  • Rejects atomically if balance < total_quantity
  • Apply pass: settles per-recipient dividends, decrements running sender balance, updates recipient balances, tracks holder count incrementally
  • Writes final sender balance, decrements holder count if sender empties
  • Emits BatchTransferCompletedEvent
  • Total supply is never touched — bonding curve invariant preserved

creator-keys/src/events.rs

• BATCH_TRANSFER_COMPLETED_EVENT_NAME = symbol_short!("bat_xfer")
• BatchTransferCompletedEvent { creator_id, from, transfers, total_transferred, ledger }
• batch_transfer_completed_topics(creator, from) helper

Tests

tests/batch_transfer_keys.rs — 11 integration tests:

• Sender balance decremented by total quantity
• Each recipient balance incremented correctly
• Accumulation onto existing recipient balance
• Total supply unchanged (bonding curve invariant)
• Holder count increments for new recipients
• Holder count net-zero when sender empties and recipient is new
• BatchTransferSizeExceeded on 11 entries; succeeds on exactly 10
• InsufficientBalance + state unchanged when total > balance
• InvalidRecipient when any recipient == sender
• ZeroTransferAmount when any entry has qty == 0
• NotRegistered for unregistered creator

tests/batch_transfer_event_fields.rs — 7 event-field unit tests:

• creator_id, from, total_transferred, transfers.len(), per-entry (address, qty), ledger fields
• No event emitted on revert

[drips-wave]

@teethaking Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

[Chucks1093]

❌ CI Failed — verify (Contracts CI)

The verify check is failing on this PR.

Likely causes:

• Compile error from a missing import or unresolved symbol after merge
• cargo fmt not run before pushing
• Unused import warning treated as error

Steps to fix:

1. Run cargo build and fix all errors
2. Run cargo fmt --all and commit
3. Push

[Chucks1093]

Fix CI and MC

[teethaking]

alright on it

…

On Fri, Sep 4, 2026, 4:41 PM Sebastian Anioke ***@***.***> wrote: *Chucks1093* left a comment (accesslayerorg/accesslayer-contracts#814) <#814 (comment)> Fix CI and MC — Reply to this email directly, view it on GitHub <#814?email_source=notifications&email_token=BD2MJO7QGMFOKZX4SA64BTT5NLPEHA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTKNJUGI4TCMRYGQZKM4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2KYZTPN52GK4S7MNWGSY3L#issuecomment-5542912842>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BD2MJO7WIKQTILKXRNJFRZL5NLPEHAVCNFSNUABGKJSXA33TNF2G64TZHMYTCOBRGYYTEMRVGQ5US43TOVSTWNJSGY4TGNJXHEZDJILWAI> . You are receiving this because you authored the thread.Message ID: ***@***.***>