Solana Burn Tokens Tool

Solana Burn Token Tool (solana_burn_token_tool)

Performs an on-chain transaction to permanently burn (destroy) a specified amount of an SPL token from the agent's (user's) wallet, removing them from circulation forever. This action is irreversible.

Inputs: Requires owner's wallet, token details, and amount to burn.

class SolanaBurnTokenInput(BaseModel):
    agent_public: str      # Owner's public key
    agent_private: str     # Owner's ENCRYPTED private key
    token_address: str     # SPL token mint address to burn
    amount: float          # Amount of the token to burn

---

Key Functionality:

• Securely decrypts the owner's private key.

• Validates the amount and checks the owner's balance for the specified SPL token.

• Constructs and sends a versioned transaction to the Solana network to execute the burn instruction.

• Returns a confirmation with the transaction signature and an explorer link upon success.

---

Sample Usage Queries (How an AI might use it): (These imply the agent has access to or will securely prompt for necessary wallet details, and can use a token identification tool to get token_address if a name like "USDC" or "LUMO" is given.)

• "Burn 100 of my unwanted tokens with mint address TokenMintAddressHere."

• "I want to destroy 50 of my FARTCOIN tokens."

• "Help me burn AmountX of TOKEN_SYMBOL from my wallet."

• "Initiate a token burn for N units of LUMO."

• "Execute a transaction: burn 0.5 of GOAT tokens."

• "Permanently remove Z amount of token SomeMintAddress from my holdings."

---

Quick Code Glance:

class SolanaBurnTokenTool(BaseTool):
    name: ClassVar[str] = "solana_burn_token_tool"
    description: ClassVar[str] = "Burn SPL tokens from agent wallet, permanently removing them from circulation."
    args_schema: ClassVar[Type[BaseModel]] = SolanaBurnTokenInput

---

⚠️ CRITICAL INFORMATION / WARNING:

• Permanent & Irreversible: Burning tokens permanently removes them from circulation. This action cannot be undone. Double-check all details before proceeding.

• Encrypted Private Key: Requires the agent's encrypted private key. The security of the encryption/decryption mechanism is vital.

• Token & Wallet Addresses: Ensure correct SPL token mint address and owner wallet details are used.

• Network Dependent: Relies on a connection to a Solana RPC node (CONFIG.SOLANA_RPC_URL).

• Asynchronous: Primarily designed for asynchronous execution (_arun).