Plugin Tools

Every VAEA plugin (Agent Kit, GOAT, MCP) exposes 5 core tools. Here's what each one does, with examples.

vaea_check_capacity 👁️ Read-only

Discover available flash loan liquidity. Returns all tokens or filter by symbol. Always call this first to know what's available.

Agent prompt: "What tokens can I flash borrow?" · "How much SOL is available?" · "Show me flash loan liquidity"

// Agent Kit
const result = await agent.methods.vaea_check_capacity({ token: "SOL" });
// → { total_tokens: 67, tokens: [{ symbol: "SOL", max_amount: 245000, ... }] }

// GOAT — called automatically by the LLM, no code needed

vaea_get_quote 👁️ Read-only

Get the exact fee breakdown before borrowing. Shows protocol fee + VAEA fee + total cost.

Agent prompt: "How much would it cost to borrow 1000 SOL?" · "What's the fee for a 5000 USDC flash loan?"

const quote = await agent.methods.vaea_get_quote({ token: "SOL", amount: 1000 });
// → { source: "kamino", protocol_fee_bps: 0.1, vaea_fee_bps: 2,
//     total_fee_sol: 0.03, total_fee_usd: 4.50 }

vaea_find_best_route 👁️ Read-only

Compare all protocols and find the cheapest source. Returns ranked candidates.

Agent prompt: "Find the cheapest flash loan for 5000 USDC" · "Compare routes for 100 SOL"

const route = await agent.methods.vaea_find_best_route({ token: "USDC", amount: 5000 });
// → { best_route: { protocol: "marginfi", cost_bps: 2.0 },
//     candidates: [
//       { protocol: "marginfi", cost_bps: 2.0 },
//       { protocol: "kamino",   cost_bps: 2.1 },
//       { protocol: "juplend",  cost_bps: 2.0 }
//     ] }

vaea_check_profitability 👁️ Read-only

Verify a strategy is profitable after all costs — VAEA fee, network fee, Jito tip. The agent should call this before building a TX.

Agent prompt: "Is this arb profitable?" · "Check if borrowing 1000 SOL for 0.5 SOL revenue makes sense"

const profit = await agent.methods.vaea_check_profitability({
  token: "SOL", amount: 1000,
  expected_revenue_sol: 0.5, jito_tip_sol: 0.001
});
// → { verdict: "✅ PROFITABLE", net_profit_sol: 0.12,
//     costs: { vaea_fee: 0.03, network_fee: 0.00025, jito_tip: 0.001 } }

vaea_build_flash_loan 🔧 Build

Build the atomic flash loan transaction. Returns prefix and suffix instructions that wrap the agent's custom logic. The agent inserts its swap/arb/liquidation instructions between them.

Agent prompt: "Build a 1000 SOL flash loan for my wallet" · "Create a flash loan transaction"

const tx = await agent.methods.vaea_build_flash_loan({
  token: "SOL", amount: 1000,
  user_pubkey: "7nYvRrpJLDfWZqxfhBFSGQ8n1KFjxJHf2bnvStRcSVEv"
});
// → { prefix_instructions: [...],  // begin_flash
//     suffix_instructions: [...],  // end_flash + fee transfer
//     lookup_tables: [...]         // for VersionedTransaction }

Summary