Batch Transfer Processing

[alefmanvladimir]

Description
Enhance the TON Plugin to support batch transfer operations, allowing AI agents (and other elizaOS modules) to simultaneously send TON coins, tokens, and NFTs to multiple recipients in a single request. This feature should streamline large-scale distribution scenarios and reduce the overhead of handling multiple discrete transactions.

Key Requirements

1. Unified Batch Interface

   • Provide a single action/method for creating a batch transfer that includes TON coins, fungible tokens, and NFTs.
   • Allow flexible input parameters, such as recipient addresses, amounts, token identifiers, and optional metadata.

2. Multi-Asset Support

   • Ensure the plugin can handle TON coin transfers, token transfers (e.g., Jettons), and NFT transfers (TEP-62 or similar).
   • Validate each transfer type internally, preventing invalid or partially successful operations.

3. Performance Optimization

   • Handle large recipient lists efficiently, minimizing blockchain fees and resource consumption.
   • Provide an option for batching signatures or confirmations to streamline transaction processing.

4. Error Handling & Logging

   • Return detailed error codes and messages for any failed transfers within the batch.
   • Maintain a transaction log or report summarizing outcomes for each recipient.

5. Security & Best Practices

   • Enforce robust checks for each transfer (e.g., sufficient balances, valid NFT ownership) to avoid accidental or malicious misuse.
   • Follow recommended TON documentation guidelines for multi-asset transfers.

6. AI Agent Integration

   • Expose all batch transfer functionalities through well-documented actions or APIs.
   • Return structured responses suitable for automated verification by AI agents.

Resources

• [TON Plugin Repository](https://github.com/elizaOS/eliza/tree/develop/packages/plugin-ton)
• [TON Documentation](https://docs.ton.org/)
• [TON NFT Standard (TEP-62)](https://github.com/ton-blockchain/TEPs/blob/master/text/0062-nft-standard.md)

Definition of Done

• A fully implemented batch transfer feature supporting TON coins, tokens, and NFTs.
• Comprehensive test coverage demonstrating both successful multi-asset transfers and robust error handling.
• Clear documentation on configuring and invoking batch transfers, including partial or atomic execution modes.

Bounty

• Estimated Reward: $1000 in TON

For any questions or further discussion, please join the bounty program working group: [Telegram: @ton_ai_bounty](https://t.me/ton_ai_bounty).

[Must09]

I want to participate

[Vodka2134156]

Hi I have some suggestions regarding eliza os to improve performance I advice to use walletv5 on wallet provider as walletv5 has less fees and can send multiple messages in one transaction (good for batch transactions) , and it the transaction.ts wait for transaction is well defined as it wait for seqno to go up but it's not use in and seqno going up doesn't always means a succes it goes up even for fails so transaction.ts needs improvement too. I would gladly help at that if you give me some instructions.

[mikirov]

Work on this started here: #3236

[eliot58]

I’d like to take this task