Wallet Creation and Private Key Management

[alefmanvladimir]

Description
Extend the TON Plugin to allow AI agents (and other modules) to create, securely store, and manage wallets on the TON blockchain. This includes generating new wallets, securely storing private keys, signing transactions, and performing typical wallet operations such as transfers and deposits. The overall objective is to empower AI agents with reliable, secure access to on-chain assets.

Key Requirements

1. Wallet Generation & Storage

   • Implement an action that creates new TON wallets on demand, returning essential data (e.g., public address).
   • Provide secure mechanisms for storing private keys, ensuring they remain inaccessible to unauthorized entities.
   • Support multiple wallet instances per AI agent, accommodating diverse use cases.

2. Private Key Management

   • Safely handle private keys within the plugin, adhering to recommended cryptographic practices.
   • Allow import and export of keys in a controlled manner (e.g., encrypted backups).
   • Implement role-based or AI agent-specific access control to limit unauthorized key usage.

3. Transaction Signing

   • Provide an interface for AI agents to sign transactions, including outgoing transfers, contract interactions, and other on-chain operations.
   • Ensure transaction signing is atomic and secure, minimizing the risk of key exposure.

4. Wallet Operations

   • Support typical wallet functionalities:
     • Transfer: Send TON or other tokens to a specified address.
     • Deposit: Receive tokens and automatically detect incoming funds.
     • Balance Queries: Fetch wallet balances in real-time for both TONCoin and other supported tokens.
   • Generate standardized transaction receipts or confirmations for AI agents to process.

5. Security & Best Practices

   • Follow TON documentation guidelines for wallet creation and private key handling.
   • Implement robust error handling, ensuring transaction failures or invalid requests are conveyed clearly.

6. AI Agent Integration

   • Expose well-defined actions for wallet creation, management, and transaction signing.
   • Return structured responses (e.g., JSON) containing wallet details, transaction hashes, and status messages.

Resources

• TON Plugin Repository
• TON Documentation

Definition of Done

• Secure creation and storage of wallet private keys within the plugin.
• Ability to sign transactions and execute wallet operations (send, receive, query balances) with comprehensive test coverage.
• Documentation outlining how AI agents can create, manage, and use wallets for day-to-day on-chain operations.

Bounty

• Estimated Reward: $1000 in TON

For further questions or discussion, please visit the bounty program working group: Telegram: @ton_ai_bounty.