Skip to main content
Privy 是专为 AI 代理构建的强大钱包基础设施,可扩展性强。

概述

创建能够执行以下操作的代理:
  • 自动创建和管理钱包
  • 使用多种数字资产(包括稳定币)进行支付
  • 签署消息和交易
  • 查询钱包余额和地址

工作原理

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

快速入门

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"钱包已创建!地址:{privy_tool.wallet_address}")

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

# 代理现在可以执行钱包操作
agent.invoke({"messages": [{"role": "user", "content": "我在 Base 上的钱包地址是什么?"}]})
请参阅完整的示例以获取完整实现。

设置

前往 Privy 仪表板 注册并创建新应用。您将收到:
  • App ID - 您的应用标识符
  • App Secret - 您的服务器端认证密钥
  1. 安装软件包:
pip install langchain-privy
  1. 设置您的凭证:
import os
import getpass

os.environ["PRIVY_APP_ID"] = getpass.getpass("输入您的 Privy App ID:")
os.environ["PRIVY_APP_SECRET"] = getpass.getpass("输入您的 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"
})

在代理中使用

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 = create_agent(
    model="claude-sonnet-4-6",
    tools=tools,
)

# 自然语言钱包操作
agent.invoke({
    "messages": [{"role": "user", "content": "签署消息 'Verified by AI Agent',然后检查我在 Base 上的余额"}]
})

API 参考