CDP Agentkit 工具包

这CDP Agentkit工具包包含使 LLM 代理能够与 Coinbase 开发人员平台交互的工具。该工具包为 CDP SDK 提供了一个包装器，允许代理执行链上作，如转账、交易和智能合约交互。

概述

集成详细信息

类	包	序列化	JS 支持	最新包装
CdpToolkit	`cdp-langchain`	❌	❌

工具特点

该工具包提供以下工具：

get_wallet_details - 获取有关 MPC 钱包的详细信息
get_balance - 获取特定资产的余额
request_faucet_funds - 从 faucet 请求测试令牌
transfer - 在地址之间转移资产
trade - 交易资产（仅限主网）
deploy_token - 部署 ERC-20 代币合约
mint_nft - 从现有合约铸造 NFT
deploy_nft - 部署新的 NFT 合约
register_basename - 为钱包注册一个 basename

我们鼓励您使用 CDP 和 web2 API 添加自己的工具，以创建根据您的需求量身定制的代理。

设置

概括地说，我们将：

安装 langchain 软件包
设置您的 CDP API 凭证
初始化 CDP 包装器和工具包
将工具传递给您的代理toolkit.get_tools()

要启用单个工具的自动跟踪，请设置您的 LangSmith API 密钥：

# os.environ["LANGSMITH_API_KEY"] = getpass.getpass("Enter your LangSmith API key: ")
# os.environ["LANGSMITH_TRACING"] = "true"

安装

此工具包位于cdp-langchain包：

%pip install -qU cdp-langchain

设置环境变量

要使用此工具包，您必须首先设置以下环境变量以访问 CDP API 以创建钱包并在链上交互。您可以在 CDP 门户上免费注册 API 密钥：

import getpass
import os

for env_var in [
    "CDP_API_KEY_NAME",
    "CDP_API_KEY_PRIVATE_KEY",
]:
    if not os.getenv(env_var):
        os.environ[env_var] = getpass.getpass(f"Enter your {env_var}: ")

# Optional: Set network (defaults to base-sepolia)
os.environ["NETWORK_ID"] = "base-sepolia"  # or "base-mainnet"

实例

现在我们可以实例化我们的工具包：

from cdp_langchain.agent_toolkits import CdpToolkit
from cdp_langchain.utils import CdpAgentkitWrapper

# Initialize CDP wrapper
cdp = CdpAgentkitWrapper()

# Create toolkit from wrapper
toolkit = CdpToolkit.from_cdp_agentkit_wrapper(cdp)

工具

查看可用工具：

tools = toolkit.get_tools()
for tool in tools:
    print(tool.name)

在代理内使用

我们需要一个 LLM 或聊天模型：

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(model="gpt-4o-mini")

API 参考：ChatOpenAI

使用以下工具初始化代理：

from langgraph.prebuilt import create_react_agent

tools = toolkit.get_tools()
agent_executor = create_react_agent(llm, tools)

API 参考：create_react_agent

用法示例：

example_query = "Send 0.005 ETH to john2879.base.eth"

events = agent_executor.stream(
    {"messages": [("user", example_query)]},
    stream_mode="values",
)
for event in events:
    event["messages"][-1].pretty_print()

预期输出：

Transferred 0.005 of eth to john2879.base.eth.
Transaction hash for the transfer: 0x78c7c2878659a0de216d0764fc87eff0d38b47f3315fa02ba493a83d8e782d1e
Transaction link for the transfer: https://sepolia.basescan.org/tx/0x78c7c2878659a0de216d0764fc87eff0d38b47f3315fa02ba493a83d8e782d1

CDP 工具包特定功能

钱包管理

该工具包维护一个 MPC 钱包。钱包数据可以导出和导入，以便在会话之间持续存在：

# Export wallet data
wallet_data = cdp.export_wallet()

# Import wallet data
values = {"cdp_wallet_data": wallet_data}
cdp = CdpAgentkitWrapper(**values)

网络支持

该工具包支持多个网络

无 Gas 交易

一些作在 Base 主网上支持无 gas 交易：

USDC 转账
EURC 转账
cbBTC 转账

API 参考

有关所有 CDP 功能和配置的详细文档，请前往 CDP 文档。

工具概念指南
工具操作指南

概述