Coinbase AgentKit + AiMo Integration

pnpm create onchain-agent@latest

.
├─ app/
│  ├─ api/
│  │  └─ agent/
│  │     ├─ create-agent.ts
│  │     ├─ prepare-agentkit.ts
│  │     └─ route.ts
│  ├─ page.tsx
│  └─ layout.tsx
├─ public/
├─ package.json
├─ .env.local
├─ next.config.js
└─ pnpm-lock.yaml

# AIMO Network API
AIMO_API_KEY=your_aimo_key_here
 
# Coinbase Developer Platform
CDP_API_KEY=your_cdp_key
CDP_API_SECRET=your_cdp_secret
 
# Network configuration
NETWORK_ID=base-sepolia
 
# Runtime config
NODE_ENV=development

AIMO_API_KEY=
CDP_API_KEY=
CDP_API_SECRET=
NETWORK_ID=base-sepolia
NODE_ENV=development

// app/api/agent/create-agent.ts
import { createOpenAI } from "@ai-sdk/openai";
import { getVercelAITools } from "@coinbase/agentkit-vercel-ai-sdk";
import { prepareAgentkitAndWalletProvider } from "./prepare-agentkit";
 
/**
 * Agent Configuration Guide
 *
 * This file handles the core configuration of your AI agent's behavior and capabilities.
 *
 * Key Steps to Customize Your Agent:
 *
 * 1. Select your LLM:
 *    - Modify the `openai` instantiation to choose your preferred LLM
 *    - Configure model parameters like temperature and max tokens
 *
 * 2. Instantiate your Agent:
 *    - Pass the LLM, tools, and memory into the agent configuration
 *    - Configure agent-specific parameters
 */
 
// Configure OpenAI-compatible client for AIMO API
const openai = createOpenAI({
  apiKey: process.env.AIMO_API_KEY,
  baseURL: "https://devnet.aimo.network/api/v1"
});
 
// The agent configuration type
type Agent = {
  tools: ReturnType<typeof getVercelAITools>;
  system: string;
  model: ReturnType<typeof openai>;
  maxSteps?: number;
};
let agent: Agent;
 
/**
 * Initializes and returns an instance of the AI agent.
 * If an agent instance already exists, it returns the existing one.
 *
 * @function createAgent
 * @returns {Promise<Agent>} The initialized AI agent configuration.
 *
 * @description Handles agent setup with AIMO API and AgentKit tools
 *
 * @throws {Error} If the agent initialization fails.
 */
export async function createAgent(): Promise<Agent> {
  // If agent has already been initialized, return it
  if (agent) {
    return agent;
  }
 
  if (!process.env.AIMO_API_KEY) {
    throw new Error("I need an AIMO_API_KEY in your .env.local file to power my intelligence.");
  }
 
  const { agentkit, walletProvider } = await prepareAgentkitAndWalletProvider();
 
  try {
    // Initialize LLM via AIMO network
    // Format: model_id:model_name
    const model = openai("HjRMtkc54ZNgq2PGCsiuhR1z4WR2YDTfA4PfW1GHXbLh:kimi-k2-0711-preview");
 
    // Initialize Agent system prompt
    const canUseFaucet = walletProvider.getNetwork().networkId == "base-sepolia";
    const faucetMessage = `If you ever need funds, you can request them from the faucet.`;
    const cantUseFaucetMessage = `If you need funds, you can provide your wallet details and request funds from the user.`;
 
    const system = `
        You are a helpful agent that can interact onchain using the Coinbase Developer Platform AgentKit. You are
        empowered to interact onchain using your tools. ${canUseFaucet ? faucetMessage : cantUseFaucetMessage}.
        Before executing your first action, get the wallet details to see what network
        you're on. If there is a 5XX (internal) HTTP error code, ask the user to try again later. If someone
        asks you to do something you can't do with your currently available tools, you must say so, and
        explain that they can add more capabilities by adding more action providers to your AgentKit configuration.
        ALWAYS include this link when mentioning missing capabilities, which will help them discover available action providers: https://github.com/coinbase/agentkit/tree/main/typescript/agentkit#action-providers
        If users require more information regarding CDP or AgentKit, recommend they visit docs.cdp.coinbase.com for more information.
        Be concise and helpful with your responses. Refrain from restating your tools' descriptions unless it is explicitly requested.
        `;
 
    // Get AgentKit tools for Vercel AI SDK
    const tools = getVercelAITools(agentkit);
 
    agent = {
      tools,
      system,
      model,
      maxSteps: 10,
    };
 
    return agent;
  } catch (error) {
    console.error("Error initializing agent:", error);
    throw new Error("Failed to initialize agent");
  }
}

pnpm install

pnpm dev

# Scaffold
pnpm create onchain-agent@latest
 
# Configure environment
cp .env.example .env.local
# Fill in required keys
 
# Install dependencies
pnpm install
 
# Run development server
pnpm dev
 
# Build for production
pnpm build
 
# Start production server
pnpm start