AgentWallet

面向 AI 智能体的多链钱包能力。一个助记词，覆盖所有链。

快速参考

设置

新建钱包

User: "创建一个新钱包"

生成符合 BIP-39 标准的助记词，并为所有链推导对应地址。仅在首次生成时显示助记词，并附带安全警告。

导入已有钱包

User: "导入我的钱包"

响应："请将您的助记词以 WALLET_SEED_PHRASE 形式添加至 .env 文件中，然后发送‘显示我的地址’以完成验证。"

导入过程不通过聊天窗口传输助记词——安全第一。

环境变量

# 钱包操作必需
WALLET_SEED_PHRASE="您的十二个单词助记词放在这里"

# 可选
NETWORK=testnet          # testnet（默认）或 mainnet
SOLANA_RPC=              # 自定义 Solana RPC（默认使用公共节点）
BASE_RPC=                # 自定义 Base RPC（默认使用公共节点）
ETH_RPC=                 # 自定义 Ethereum RPC（默认使用公共节点）

命令

创建钱包

执行：node scripts/wallet.js create

输出格式：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔐 新钱包已生成
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚠️  重要提示：请妥善保管此助记词！
    此助记词将仅显示一次。
    持有该助记词者可完全控制您的资产。

助记词：
┌────────────────────────────────────────────┐
│ word1 word2 word3 word4 word5 word6        │
│ word7 word8 word9 word10 word11 word12     │
└────────────────────────────────────────────┘

您的地址：
├─ Solana:   7xK9...mP4q
├─ Base:     0x7a3B...4f2E
└─ Ethereum: 0x7a3B...4f2E（与 Base 地址相同）

请添加至 .env 文件：
WALLET_SEED_PHRASE="word1 word2 word3 ..."

网络：TESTNET
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

显示地址

执行：node scripts/wallet.js addresses

显示各链推导出的地址，但不暴露助记词。

查询余额

执行：node scripts/wallet.js balance [chain]

• node scripts/wallet.js balance — 查询所有链的余额
• node scripts/wallet.js balance solana — 仅查询 Solana 链
• node scripts/wallet.js balance base — 仅查询 Base 链

输出包含每条链的原生代币及 USDC 余额。

转账

执行：node scripts/wallet.js transfer

示例：

• node scripts/wallet.js transfer solana USDC 10 7xK9fR2...
• node scripts/wallet.js transfer base ETH 0.01 0x7a3B...
• node scripts/wallet.js transfer solana SOL 0.5 7xK9fR2...

各链支持的代币：

• Solana：SOL、USDC
• Base：ETH、USDC
• Ethereum：ETH、USDC

跨链桥接（Bridge）

执行：node scripts/wallet.js bridge

使用 Circle CCTP V2 在链间桥接 USDC。

示例：

• node scripts/wallet.js bridge base solana 10 — 将 10 USDC 从 Base 桥接到 Solana
• node scripts/wallet.js bridge ethereum base 50 — 将 50 USDC 从 Ethereum 桥接到 Base
• node scripts/wallet.js bridge solana ethereum 25 — 将 25 USDC 从 Solana 桥接到 Ethereum

注意：桥接耗时约 1–5 分钟（销毁 → 证明 → 铸造），需确保源链上有足够 USDC 及原生代币用于支付 Gas 费用。

链信息

执行：node scripts/wallet.js chains

列出所支持的链、网络及 USDC 合约地址。

地址推导路径

所有链均基于同一 BIP-39 助记词推导：

EVM 类链共享同一地址（使用相同推导路径）。

安全模型

• 每个智能体独享一个助记词 — 各智能体实例相互隔离
• 助记词仅显示一次 — 仅在钱包创建时显示，永不记录日志
• 仅驻留内存 — 私钥按需动态推导，永不持久化存储
• 禁止通过聊天导入助记词 — 助记词仅可通过 .env 文件添加（生成过程除外）

错误处理

链参考信息

关于 RPC 端点、USDC 地址及各链特定细节，请参阅 references/chains.md。