🔗 OpenClaw Solana Connect v3.0
Secure toolkit for AI agents to interact with Solana blockchain
🛡️ Security Features
- Private Key Protection - Keys never exposed to agent
- Max Limits - Configurable transaction limits
- Dry-Run Mode - Simulate before sending (default)
- Human Confirmation - Required for large transactions
- Testnet Default - Safe by default
What Works
| Function | Status | Description |
|---|---|---|
generateWallet() |
✅ Works | Generate wallet addresses |
connectWallet() |
✅ Works | Validate wallet addresses |
getBalance() |
✅ Works | Read SOL/token balances |
getTransactions() |
✅ Works | Read transaction history |
getTokenAccounts() |
✅ Works | Read token holdings |
sendSol() |
✅ Works | Send SOL (with security) |
Installation
clawhub install solana-connect
Environment Variables
SOLANA_RPC_URL- RPC endpoint (default: testnet)MAX_SOL_PER_TX- Max SOL per transaction (default: 10)MAX_TOKENS_PER_TX- Max tokens per transaction (default: 10000)HUMAN_CONFIRMATION_THRESHOLD- SOL amount requiring human confirmation (default: 1)
Usage
const { generateWallet, getBalance, sendSol, getConfig } = require('./scripts/solana.js');
// Generate wallet (address only - private key protected)
const wallet = generateWallet();
console.log('Address:', wallet.address);
// Check balance
const balance = await getBalance(wallet.address);
// Send SOL (DRY-RUN by default - simulation only)
const result = await sendSol(privateKey, toAddress, 0.5, { dryRun: true });
console.log('Simulation:', result);
// Send real transaction
const tx = await sendSol(privateKey, toAddress, 0.5, { dryRun: false, skipConfirmation: true });
console.log('Signature:', tx.signature);
Security Options
// Dry-run (simulation) - safe, doesn't send
await sendSol(key, to, amount, { dryRun: true });
// Real transaction - requires explicit flag
await sendSol(key, to, amount, { dryRun: false });
// Skip human confirmation (for automated agents)
await sendSol(key, to, amount, { dryRun: false, skipConfirmation: true });
Security: Never hardcode private keys. Use environment variables.