@shroudfi/agent-sdk

AI Agent SDK for ShroudFi MEV protection. Purpose-built for autonomous agents that execute DeFi transactions.

Installation

npm install @shroudfi/agent-sdk

Quick Start

import { ShroudFiAgent } from '@shroudfi/agent-sdk';

// Initialize the agent
const agent = new ShroudFiAgent({
  apiKey: 'your-api-key',
  chainId: 1,
  walletAddress: '0x...',
});

// Execute a MEV-protected swap
const result = await agent.swap({
  tokenIn: 'WETH',
  tokenOut: 'USDC',
  amount: '1.0',
  maxSlippageBps: 50,
});

console.log('Swap executed:', result.txHash);
console.log('MEV saved:', result.mevSaved);

Features

• ERC-8004 compatible — Works with the emerging standard for agent-to-protocol communication
• Coinbase AgentKit integration — Plug directly into Coinbase's Agentic Wallet framework
• x402 protocol support — HTTP 402-based payment flows for agent transactions
• Autonomous execution — Agents can submit intents, monitor settlements, and handle retries
• Multi-chain — Same API across 10 EVM chains + Solana

Integration with Coinbase AgentKit

import { ShroudFiAgent } from '@shroudfi/agent-sdk';
import { CoinbaseAgentKit } from '@coinbase/agentkit';

const agentKit = new CoinbaseAgentKit({ /* ... */ });
const shroud = new ShroudFiAgent({
  apiKey: 'your-api-key',
  chainId: 8453, // Base
  walletAddress: agentKit.walletAddress,
});

// The agent can now execute MEV-protected trades
const tools = shroud.getAgentKitTools();
// Returns tool definitions compatible with AgentKit's tool registry

API Reference

ShroudFiAgent

new ShroudFiAgent({
  apiKey: string;          // Your ShroudFi API key
  chainId: number;         // Target chain ID
  walletAddress: string;   // Agent's wallet address
  rpcUrl?: string;         // Custom RPC (defaults to rpc.shroudfi.com)
})

Methods

| Method | Description | |---|---| | swap(params) | Execute a MEV-protected token swap | | submitIntent(intent) | Submit a raw swap intent | | getBalance(token) | Get token balance for agent wallet | | estimateGas(tx) | Estimate gas with MEV-aware pricing | | getAgentKitTools() | Get Coinbase AgentKit-compatible tool definitions | | getMevReport() | Get MEV savings report for this agent |

Supported Chains

Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, zkSync Era, Linea, Scroll, Solana (Beta)

Links

• Website
• GitHub
• TypeScript SDK

License

MIT — Astra Fintech Labs Pvt. Ltd.