coinbase-agentkit
Installation
SKILL.md
Coinbase AgentKit
AgentKit is Coinbase's open-source framework for building AI agents with onchain capabilities. It provides wallet management, 50+ built-in actions (transfers, swaps, contract deployment, NFT minting), and integrations with LangChain, Vercel AI SDK, and Model Context Protocol. Framework-agnostic and wallet-agnostic — works with CDP wallets, Viem, Privy, and ZeroDev.
Source: https://github.com/coinbase/agentkit
What You Probably Got Wrong
LLMs have stale training data. These are the most common mistakes.
cdp-agentkit-nodejsis deprecated → The old@coinbase/cdp-agentkit-coreand@coinbase/cdp-langchainpackages are retired. The current package is@coinbase/agentkitwith framework extensions@coinbase/agentkit-langchainand@coinbase/agentkit-vercel-ai-sdk. If you see imports fromcdp-agentkit, you are using the deprecated SDK.- "CdpWalletProvider" is the class name → It was renamed to
CdpEvmWalletProviderin v0.1+. There is alsoCdpSmartWalletProviderfor smart contract wallets andCdpV2SolanaWalletProviderfor Solana. Using the old name will fail. - "AgentKit needs an OpenAI key" → AgentKit itself is model-agnostic. It creates tools/actions that any LLM framework can call. You only need an OpenAI key if you use LangChain with
ChatOpenAI. It works equally well with Anthropic, Google, or local models. - "npm install agentkit" → The correct package is
@coinbase/agentkit. The scoped name is required. - Node.js 18 is fine → AgentKit requires Node.js v22+. Earlier versions will fail silently or throw runtime errors.
- "AgentKit only works on Base" → AgentKit supports any EVM network and Solana. Base has the deepest protocol integrations (Basename, Compound, Morpho), but wallet operations work on Ethereum, Arbitrum, Polygon, Optimism, and more.
- Using
AgentKit.from()with no config → Default setup usesCdpEvmWalletProviderand requiresCDP_API_KEY_IDandCDP_API_KEY_SECRETenvironment variables. Without them, initialization throws a cryptic error about missing credentials. - Hardcoding private keys →
ViemWalletProvideraccepts a private key for local testing, but production agents must useCdpEvmWalletProviderorCdpSmartWalletProviderwhere keys are managed by CDP infrastructure.