coinbase-cdp-agentkit

n8n community node for Coinbase Developer Platform (CDP) - wallets, transfers, swaps, and AI agent tools

Package Information

Downloads: 21 weekly / 311 monthly

Latest Version: 0.2.0

Author: pvdyck

Available Nodes

Coinbase CDP Tool

Use Coinbase CDP as a tool for AI agents - wallets, transfers, swaps, and more

Coinbase CDP

Interact with Coinbase Developer Platform - accounts, transfers, swaps, policies

Coinbase CDP Trigger

Triggers workflow on Coinbase CDP balance changes

Documentation

n8n-nodes-coinbase-cdp-agentkit

This is the only open-source n8n node for Coinbase CDP. Never run security-critical crypto tools — wallets, transfers, swaps — from closed-source packages you cannot audit. If you can't read the code, you can lose your funds. Audit this package yourself.

n8n community node package for Coinbase Developer Platform (CDP). Create wallets, transfer tokens, swap assets, and build AI-powered blockchain agents — all from n8n workflows.

First AI agent + blockchain integration for any workflow automation platform.

Architecture
Installation
Credentials
Nodes
Supported Networks
Example Workflows
Development
Design Decisions
Links & References
License

Architecture

This package uses an AgentKit-first architecture: 3 focused nodes + 1 shared credential, designed to align with Coinbase AgentKit conventions while keeping the bundle lightweight by using @coinbase/cdp-sdk directly.

┌──────────────────────────────────────────────────────────┐
│              n8n-nodes-coinbase-cdp-agentkit              │
│                                                          │
│  ┌─────────────────────────────────────────────────────┐ │
│  │           CoinbaseCdpApi Credential                 │ │
│  │   API Key ID  |  API Secret  |  Wallet Secret (opt) │ │
│  └──────┬──────────────┬──────────────┬────────────────┘ │
│         │              │              │                   │
│         ▼              ▼              ▼                   │
│  ┌────────────┐ ┌────────────┐ ┌──────────────┐         │
│  │ AgentTool  │ │ CoinbaseCdp│ │CoinbaseTrigger│         │
│  │ (AI Tool)  │ │  (Action)  │ │  (Polling)   │         │
│  │ 7 tools    │ │ 7 resources│ │ balance watch│         │
│  └─────┬──────┘ └─────┬──────┘ └──────┬───────┘         │
│        │              │               │                  │
│        └──────┬───────┴───────┬───────┘                  │
│               ▼               ▼                          │
│  ┌──────────────────────────────────────────┐            │
│  │           Shared Layer                    │            │
│  │  cdpClientFactory | networkOptions       │            │
│  │  toolFactory      | types                │            │
│  └────────────────────┬─────────────────────┘            │
└───────────────────────┼──────────────────────────────────┘
                        ▼
              ┌─────────────────┐
              │ @coinbase/cdp-sdk│
              └─────────────────┘

See IMPLEMENTATION.md for detailed Mermaid architecture diagrams (rendered on GitHub).

Installation

n8n Community Nodes (Recommended)

Go to Settings > Community Nodes in your n8n instance
Enter n8n-nodes-coinbase-cdp-agentkit
Click Install

See the n8n community nodes installation guide for details.

Manual Installation

cd ~/.n8n/custom
npm install n8n-nodes-coinbase-cdp-agentkit

Restart n8n after installation. See manual install docs.

Credentials

You need a Coinbase CDP API key from the CDP Portal. See CDP API Keys documentation for details.

Field	Required	Description
API Key ID	Yes	Your CDP API Key ID (UUID format)
API Key Secret	Yes	Your CDP API Key Secret (base64-encoded ES256 private key)
Wallet Secret	No	Required for signing transactions (transfers, swaps). Leave empty for read-only operations

Getting Your Credentials

Go to portal.cdp.coinbase.com
Create a new project (or use an existing one)
Navigate to API Keys and create a new key
Copy the API Key ID and API Key Secret
For transaction signing, also copy the Wallet Secret from the key creation screen

Note: The Wallet Secret is only shown once during key creation. If you lose it, you'll need to create a new API key.

Nodes

Coinbase CDP (Action Node)

The primary node for deterministic blockchain operations. Processes items through a resource/operation pattern. Supports usableAsTool: true, so it can also be used directly as an AI Agent tool.

Input Items → execute() → Resource Router → CDP SDK → Output Items
                              │
          ┌───────┬───────┬───┴───┬───────┬───────┬────────┐
          ▼       ▼       ▼       ▼       ▼       ▼        ▼
       Account  Solana  Smart  Transfer  Swap   Policy  Balance

Resources & Operations

Account (EVM)

Operation	Description	Key Parameters
Get or Create	Get existing or create new EVM account	`accountName`
List Balances	List all token balances for an address	`address`, `network`
Request Faucet	Request testnet tokens	`address`, `faucetNetwork`, `faucetToken`

Solana Account

Operation	Description	Key Parameters
Get or Create	Get or create a Solana account	`accountName`
Request Faucet	Request Solana devnet tokens	`address`, `faucetToken`

Smart Account

Operation	Description	Key Parameters
Get or Create	Create an ERC-4337 smart account	`ownerAccountName`, `smartAccountName`

Transfer

Operation	Description	Key Parameters
Send Native Token	Transfer ETH, MATIC, AVAX, etc.	`accountName`, `to`, `amount`, `network`
Send ERC-20 Token	Transfer USDC, DAI, or any ERC-20	`accountName`, `to`, `amount`, `token`, `network`

Swap (Base & Ethereum only)

Operation	Description	Key Parameters
Execute Swap	Swap tokens via DEX	`accountName`, `fromToken`, `toToken`, `fromAmount`, `network`
Get Quote	Get swap quote without executing	`accountName`, `fromToken`, `toToken`, `fromAmount`, `network`

Policy (see CDP Policy docs)

Operation	Description	Key Parameters
List	List all policies	—
Get	Get a policy by ID	`policyId`
Create	Create a new policy	`policyJson`
Update	Update a policy	`policyId`, `policyJson`
Delete	Delete a policy	`policyId`

Balance

Operation	Description	Key Parameters
List Token Balances	List all token balances for an address	`address`, `network`

Coinbase CDP Tool (AI Agent)

Connect blockchain operations to n8n's AI Agent node. Each tool is a LangChain DynamicStructuredTool that an LLM can invoke autonomously. Tool names and schemas are compatible with Coinbase AgentKit conventions.

Chat Trigger → AI Agent (Claude/GPT) → Chat Response
                    │ tools
       ┌────────────┼────────────┐
  [CDP Tool:   [CDP Tool:   [CDP Tool:
   Wallet]      Transfer]     Swap]     ... (7 tools)

Available Tools

Tool	LangChain Name	Zod Schema	Description
Get Wallet Details	`get_wallet_details`	`{ name: string }`	Get or create an EVM account, return address
Native Transfer	`native_transfer`	`{ accountName, to, amount, network }`	Transfer ETH/native tokens to an address
ERC-20 Transfer	`erc20_transfer`	`{ accountName, to, amount, token, network }`	Transfer ERC-20 tokens (USDC, DAI, etc.)
Get Balance	`get_balance`	`{ address, token, network }`	Check token balance for any wallet address
Swap Tokens	`swap_tokens`	`{ accountName, fromToken, toToken, fromAmount, network }`	Swap one token for another on Base/Ethereum
Get Swap Price	`get_swap_price`	`{ accountName, fromToken, toToken, fromAmount, network }`	Get price quote without executing
Request Faucet	`request_faucet`	`{ address, token, network }`	Request testnet tokens (ETH, USDC, SOL)

AI Agent Setup

Add a Chat Trigger node
Add an AI Agent node with your preferred LLM (OpenAI, Anthropic, etc.)
Add Coinbase CDP Tool nodes for each capability you want the agent to have
Connect the CDP Tool nodes to the AI Agent's ai_tool input
The LLM will decide when and how to use each tool based on the conversation

Coinbase CDP Trigger

Polls for balance changes on any EVM address. Fires when any token balance increases, decreases, or a new token appears.

Configuration

Parameter	Description
Event	`Balance Changed` — triggers on any token balance change
Address	The EVM wallet address to monitor (`0x...`)
Network	Which network to monitor (any of the 12 supported networks)

Output Format

Each trigger event contains:

{
  "address": "0x1234...abcd",
  "network": "base-sepolia",
  "token": "ETH",
  "previousBalance": "1000000000000000000",
  "currentBalance": "2000000000000000000",
  "timestamp": "2026-01-15T10:30:00.000Z"
}

The trigger stores the last known balances in n8n's workflow static data and compares on each poll. The first poll captures a baseline without triggering.

Supported Networks

Network	Chain	Transfer	Swap	Faucet
Base	EVM	Yes	Yes	—
Base Sepolia	EVM	Yes	—	Yes
Ethereum	EVM	Yes	Yes	—
Ethereum Sepolia	EVM	Yes	—	Yes
Ethereum Holesky	EVM	Yes	—	Yes
Polygon	EVM	Yes	—	—
Arbitrum	EVM	Yes	—	—
Optimism	EVM	Yes	—	—
Avalanche C-Chain	EVM	Yes	—	—
BNB Chain	EVM	Yes	—	—
Solana Mainnet	Solana	Yes	—	—
Solana Devnet	Solana	Yes	—	Yes

See the CDP SDK documentation for the latest network support.

Example Workflows

Import these from the examples/ directory into your n8n instance.

#	Workflow	Description
1	Account & Balance Check	Create an EVM account on Base Sepolia and query its token balances
2	Faucet & Transfer	Request testnet ETH from the faucet and verify receipt
3	Swap Tokens	Quote a WETH→USDC swap on Base, check liquidity, execute if available
4	AI Agent Blockchain	Chat-driven blockchain operations via LLM tool calling
5	Balance Monitor	Event-driven balance monitoring with configurable alerts
6	Multi-Chain Accounts	Parallel account creation across EVM and Solana with testnet funding
7	Policy Management	Query CDP governance policies for the organization

See IMPLEMENTATION.md for visual workflow diagrams (rendered on GitHub).

Development

Prerequisites

Node.js 22+ (required by @coinbase/cdp-sdk)
npm

Setup

git clone https://github.com/pvdyck/n8n-nodes-coinbase-cdp
cd n8n-nodes-coinbase-cdp
npm install

Scripts

Command	Description
`npm run build`	Compile TypeScript + copy icons (`tsc && gulp build:icons`)
`npm test`	Run all 116 unit tests
`npm run test:coverage`	Run with coverage report (100% across all metrics)
`npm run test:watch`	Run in watch mode
`npm run test:e2e`	Run E2E workflows against live n8n (requires `.env` + running n8n)
`npm run test:all`	Unit tests + E2E combined
`npm run lint`	ESLint check
`npm run lint:fix`	ESLint auto-fix

Environment Variables

Copy .env.example to .env for E2E testing:

cp .env.example .env

CDP_API_KEY_ID=your-key-id
CDP_API_KEY_SECRET=your-key-secret
CDP_WALLET_SECRET=your-wallet-secret

Test Coverage

116 tests across 8 suites with 100% coverage on all metrics:

Suite	Tests	Covers
CoinbaseAgentTool.test.ts	30	All 7 AI tool actions, error handling, edge cases
CoinbaseAgentToolNode.test.ts	10	`supplyData` integration, tool invocation, metadata
CoinbaseCdp.test.ts	35	All 7 resource operations, error branches, fallbacks
CoinbaseCdpNode.test.ts	15	`execute()`, `continueOnFail`, multi-item, unknown resource
CoinbaseTrigger.test.ts	14	Polling, balance change detection, null fallbacks
toolFactory.test.ts	4	Error wrapper (Error, string, object throws)
cdpClientFactory.test.ts	3	Client creation with/without walletSecret
credentials.test.ts	5	Credential metadata validation

E2E Tests

Run against a live n8n instance with real CDP credentials:

Workflow	Result	What it validates
account-and-balance	PASS	Account creation + balance query on Base Sepolia
faucet-and-transfer	PASS	Faucet request + balance verification
multi-chain-accounts	PASS	Parallel EVM + Solana account creation
policy-management	PASS	Policy listing via CDP API
ai-agent-blockchain	VALID	Structure validation (needs AI model)
balance-monitor	VALID	Structure validation (needs trigger activation)
swap-tokens	VALID	Structure validation (needs funded wallet)

Design Decisions

AgentKit-Compatible Without the Dependency

Tool names (get_wallet_details, native_transfer, etc.) and schemas match Coinbase AgentKit conventions, but we use @coinbase/cdp-sdk directly. This gives a 10x lighter bundle while staying compatible with AgentKit tutorials and documentation.

Triple-Pathway Usage via `usableAsTool`

The CoinbaseCdp action node sets usableAsTool: true, enabling three usage modes:

Direct: Trigger → CoinbaseCdp → Next Node (resource/operation UI)
AI Tool: AI Agent → tools → CoinbaseCdp (LLM selects operation)
Expression: $('CoinbaseCdp').item.json.address (reference in other nodes)

Error-Safe Agent Tools

The toolFactory wraps every tool function in try/catch, returning error messages as strings instead of throwing. This allows the LLM to recover gracefully and try alternative approaches.

Polling Trigger with Static Data

n8n supports polling natively. The @coinbase/cdp-sdk doesn't expose WebSocket balance streams, so polling with n8n's getWorkflowStaticData('node') persistence is the pragmatic choice. The first poll stores a baseline; subsequent polls compare and emit change events.

`DynamicStructuredTool` with `any` Typed Schema

Complex Zod schemas trigger TypeScript error TS2589 (deep instantiation) in LangChain's type system. Typing the schema as any in the ToolDefinition interface avoids this while keeping runtime validation intact via Zod.

See IMPLEMENTATION.md for full architecture diagrams.

Links & References

Coinbase Developer Platform

Resource	URL
CDP Documentation	docs.cdp.coinbase.com
CDP Portal (API Keys)	portal.cdp.coinbase.com
CDP API Keys Guide	docs.cdp.coinbase.com/get-started/docs/cdp-api-keys
CDP SDK Guide	docs.cdp.coinbase.com/get-started/docs/use-sdks
CDP API Reference	docs.cdp.coinbase.com/cdp-apis/docs/welcome
AgentKit Documentation	docs.cdp.coinbase.com/agent-kit/welcome

GitHub Repositories

Repository	URL
CDP SDK (TypeScript/Python)	github.com/coinbase/cdp-sdk
AgentKit	github.com/coinbase/agentkit
This Package	github.com/pvdyck/n8n-nodes-coinbase-cdp

n8n

Resource	URL
Community Nodes Install (GUI)	docs.n8n.io/integrations/community-nodes/installation/gui-install
Community Nodes Install (Manual)	docs.n8n.io/integrations/community-nodes/installation/manual-install
Creating Nodes Guide	docs.n8n.io/integrations/creating-nodes

Dependencies

Package	Version	Purpose	Docs
`@coinbase/cdp-sdk`	^1.44.0	CDP SDK v2 — blockchain operations	GitHub
`@langchain/core`	^0.3.0	`DynamicStructuredTool` for AI Agent integration	API Docs
`zod`	^3.24.0	Schema validation for tool parameters	zod.dev
`n8n-workflow`	* (peer)	n8n node interfaces	n8n docs

License

MIT

coinbase-cdp-agentkitInstall

Package Information

Available Nodes

Documentation

n8n-nodes-coinbase-cdp-agentkit

Table of Contents

Architecture

Installation

n8n Community Nodes (Recommended)

Manual Installation

Credentials

Getting Your Credentials

Nodes

Coinbase CDP (Action Node)

Resources & Operations

Coinbase CDP Tool (AI Agent)

Available Tools

AI Agent Setup

Coinbase CDP Trigger

Configuration

Output Format

Supported Networks

Example Workflows

Development

Prerequisites

Setup

Scripts

Environment Variables

Test Coverage

E2E Tests

Design Decisions

AgentKit-Compatible Without the Dependency

Triple-Pathway Usage via usableAsTool

Error-Safe Agent Tools

Polling Trigger with Static Data

DynamicStructuredTool with any Typed Schema

Links & References

Coinbase Developer Platform

GitHub Repositories

n8n

Dependencies

License

Discussion

coinbase-cdp-agentkit

Triple-Pathway Usage via `usableAsTool`

`DynamicStructuredTool` with `any` Typed Schema