WalletPilot

面向 AI 代理的通用浏览器钱包自动化工具。可控制任意基于浏览器的加密钱包，并支持配置化的权限管控机制。

支持的钱包

概述

WalletPilot 允许 AI 代理与去中心化应用（dapp）交互，并通过任一受支持的浏览器钱包执行交易。所有操作均受用户定义的约束条件限制。

安全模型：代理在隔离的浏览器配置文件中控制一个独立的钱包。切勿使用您的主钱包。

安装配置

1. 安装依赖项

cd wallet-pilot
npm install
npx playwright install chromium

2. 配置钱包提供商

编辑 config.json 文件以选择您要使用的钱包：

{
  "wallet": {
    "provider": "metamask",  // 或：rabby、coinbase、rainbow、phantom
    "extensionPath": null    // 自动从 Chrome 检测，或手动指定路径
  }
}

3. 创建代理钱包配置文件

npm run setup

该命令将启动一个浏览器窗口，您需在其中完成以下操作：

• 安装/配置所选钱包扩展
• 创建一个全新钱包（使用新的助记词）
• 该配置文件将被保存，供后续自动化流程复用

4. 为钱包充值

向您的代理钱包转入少量资产：

• 原生代币用于支付 Gas（推荐 0.01–0.05 ETH/SOL）
• 用于操作的代币（建议从小额开始，例如 $50 USDC）

5. 配置权限

编辑 permissions.json 文件：

{
  "constraints": {
    "spendLimit": {
      "daily": "50000000",
      "perTx": "10000000"
    },
    "allowedChains": [1, 137, 42161, 8453],
    "allowedProtocols": ["0x...uniswap", "0x...1inch"]
  }
}

可用操作

连接至 Dapp

connect 

跳转至目标 dapp 并连接代理钱包。

执行兑换（Swap）

swap   for  [on ]

在允许的去中心化交易所（DEX）上执行代币兑换。

发送代币

send   to 

向指定地址发送代币（受支出限额约束）。

签名消息

sign 

对任意消息进行签名。

查询余额

balance [token]

返回钱包当前余额。

查看交易历史

history [count]

显示最近的代理交易记录（可选参数 count 指定条数）。

约束条件

新增钱包支持

WalletPilot 采用插件式架构。如需添加新钱包，请按以下步骤操作：

1. 在 src/wallets/ 目录下新建适配器文件
2. 实现 WalletAdapter 接口
3. 为该钱包的 UI 元素编写对应的选择器（selectors）
4. 在 src/wallets/index.ts 中注册该适配器

参考实现请见 src/wallets/metamask.ts。

安全性保障

• 隔离配置文件：代理运行于独立的浏览器配置文件中
• 独立钱包：与您的主钱包完全分离
• 支出上限：硬性限额防止异常大额支出
• 协议白名单：仅允许调用已授权的合约
• 完整日志：每笔交易均被详细记录
• 权限撤销：设置 "revoked": true 可禁用全部操作

架构概览

src/
├── index.ts              # 主入口文件
├── browser.ts            # Playwright 浏览器管理模块
├── guard.ts              # 权限校验与执行模块
├── logger.ts             # 交易日志记录模块
├── price.ts              # USD 价格估算模块
├── types.ts              # TypeScript 类型定义
├── config.ts             # 配置加载模块
└── wallets/
    ├── index.ts          # 钱包适配器注册表
    ├── adapter.ts        # 基础适配器接口定义
    ├── metamask.ts       # MetaMask 适配器
    ├── rabby.ts          # Rabby 适配器
    ├── coinbase.ts       # Coinbase Wallet 适配器
    ├── rainbow.ts        # Rainbow 适配器
    ├── phantom.ts        # Phantom 适配器
    ├── trust.ts          # Trust Wallet 适配器
    ├── zerion.ts         # Zerion 适配器
    ├── exodus.ts         # Exodus 适配器
    ├── okx.ts            # OKX Wallet 适配器
    └── backpack.ts       # Backpack 适配器

对比：WalletPilot vs MetaMask-only 方案

若您需要跨钱包灵活性或 Solana 支持，请选择 WalletPilot； 若您仅需简单的 MetaMask 单钱包方案，请选择 MetaMask Agent Wallet。