Skip to main content
Privy 是专为 AI Agent 打造的强大钱包基础设施，可大规模使用。

​
概述

使用该集成，可以创建能够：
  • 自动创建和管理钱包
  • 以多种数字资产（包括稳定币）进行支付
  • 签名消息和交易
  • 查询钱包余额和地址
的 Agent。

​
工作原理

Privy 提供钱包基础设施，消除了区块链交互的复杂性：
  1. 为你的 Agent 提供强大的钱包
  2. 通过交易策略保护 Agent 的资产安全
  3. 快速完成支付
零摩擦接入 与传统钱包解决方案不同，Privy 会自动为你的 Agent 创建嵌入式钱包，无需管理私钥、助记词或复杂的设置。 生产级基础设施 受到领先 Web3 应用信赖，Privy 在规模化场景下处理安全密钥生成、多链地址派生、交易签名和合规策略。

​
快速入门

import os
from langchain_privy import PrivyWalletTool
from langchain.agents import create_agent

# 设置凭据
os.environ["PRIVY_APP_ID"] = "your-privy-app-id"
os.environ["PRIVY_APP_SECRET"] = "your-privy-app-secret"

# 初始化钱包工具（自动创建钱包）
privy_tool = PrivyWalletTool()
print(f"Wallet created! Address: {privy_tool.wallet_address}")

# 创建 Agent
agent = create_agent(
    model="claude-sonnet-4-6",
    tools=[privy_tool],
)

# Agent 现在可以执行钱包操作
agent.invoke({"messages": [{"role": "user", "content": "What's my wallet address on Base?"}]})
完整实现请参阅示例。

​
设置

前往 Privy 控制台 注册并创建新应用，你将获得：
  • App ID - 你的应用标识符
  • App Secret - 你的服务端身份验证密钥
  1. 安装包：
pip install langchain-privy
  1. 设置凭据：
import os
import getpass

os.environ["PRIVY_APP_ID"] = getpass.getpass("Enter your Privy App ID: ")
os.environ["PRIVY_APP_SECRET"] = getpass.getpass("Enter your Privy App Secret: ")

​
实例化

from langchain_privy import PrivyWalletTool

# 自动创建新的以太坊钱包
tool = PrivyWalletTool()

# 或在特定链上创建
base_tool = PrivyWalletTool(chain_type="base")
solana_tool = PrivyWalletTool(chain_type="solana")

# 或复用现有钱包
existing_tool = PrivyWalletTool(wallet_id="wal_abc123...")

​
调用

​
可用操作

# 获取任意链的钱包地址
tool.invoke({
    "operation": "get_wallet_address",
    "chain": "base"
})

# 签名消息
tool.invoke({
    "operation": "sign_message",
    "message": "Hello from LangChain!",
    "chain": "ethereum"
})

# 查询余额
tool.invoke({
    "operation": "get_balance",
    "chain": "base"
})

# 发送交易
tool.invoke({
    "operation": "send_transaction",
    "chain": "base",
    "to": "0x1234567890123456789012345678901234567890",
    "value": "0.001",
    "unit": "ether"
})

​
在 Agent 中使用

import os
from langchain_privy import PrivyWalletTool
from langchain.agents import create_agent

# 设置凭据
os.environ["PRIVY_APP_ID"] = "your-privy-app-id"
os.environ["PRIVY_APP_SECRET"] = "your-privy-app-secret"

# 初始化工具
tools = [PrivyWalletTool()]

# 创建 Agent
agent = create_agent(
    model="claude-sonnet-4-6",
    tools=tools,
)

# 自然语言钱包操作
agent.invoke({
    "messages": [{"role": "user", "content": "Sign the message 'Verified by AI Agent' and then check my balance on Base"}]
})

​
API 参考

Edit this page on GitHub or file an issue.
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.