# Solana Send SPL Tokens Tool

#### Solana Send SPL Tokens Tool (`solana_send_spl_tokens_tool`)

Performs an **on-chain transaction** to send a specified amount of a specific SPL token (like USDC, Bonk, etc.) from the agent's (user's) wallet to a recipient's Solana address. Exercise extreme caution as this involves real fund transfers.

{% hint style="info" %}
**Inputs:** Requires sender's wallet, recipient, token details, and amount.
{% endhint %}

```python
class SolanaSendSplTokensInput(BaseModel):
    agent_public: str      # Sender's public key
    agent_private: str     # Sender's ENCRYPTED private key
    recipient_address: str # Recipient's Solana address
    token_address: str     # SPL token mint address (e.g., for USDC)
    amount: float          # Amount of the token to send
```

***

**Key Functionality:**

* Securely decrypts the sender's private key.
* Validates the amount and checks the sender's balance for the specified SPL token.
* Handles Associated Token Account (ATA) creation for the recipient if one doesn't exist.
* Constructs and sends a versioned transaction to the Solana network for the SPL token transfer.
* Returns a confirmation with the transaction signature and an explorer link on 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.)*

* "Send 100 USDC to `RecipientPublicKeyHere` from my wallet."
* "Transfer 500 Bonk from my account to `FriendAddress`."
* "I need to send 25.5 of token `TokenMintAddressHere` to `DestinationAddress`."
* "Initiate a payment of 1000 LUMO to address `Z`."
* "Execute a transaction: send `75` FARTCOIN to `AnotherWalletAddress`."
* "Help me send some GOAT tokens from my wallet." (Agent would then gather all parameters)
* "Send `AmountX` of `$TOKEN_SYMBOL` to `wallet_address`."

***

**Quick Code Glance:**

```python
class SolanaSendSplTokensTool(BaseTool):
    name: ClassVar[str] = "solana_send_spl_tokens_tool"
    description: ClassVar[str] = "Send SPL tokens from agent wallet to a specified Solana address."
    args_schema: ClassVar[Type[BaseModel]] = SolanaSendSplTokensInput
```

***

**⚠️ CRITICAL INFORMATION & SECURITY:**

* **Real Transactions:** This tool executes actual SPL token transfers on the Solana blockchain. **Transactions are irreversible.**
* **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 recipient wallet address are used.
* **Network Dependent:** Relies on a connection to a Solana RPC node (`CONFIG.SOLANA_RPC_URL`).
* **Asynchronous:** Primarily designed for asynchronous execution (`_arun`).