WalletPilot-7715

借助 MetaMask 的 ERC-7715 权限标准，为您的 AI agent 赋予加密货币操作能力。

概述

WalletPilot 使 AI agent 能够基于 MetaMask 官方 ERC-7715 权限标准执行链上交易。用户只需一次性授予受限权限（例如支出限额、链限制），此后 agent 即可在该权限范围内自由执行操作。

核心特性：

• 不共享私钥——用户始终完全掌控自己的 MetaMask 钱包
• 可配置的安全护栏（支出限额、链白名单）
• 多链支持（Ethereum、Polygon、Arbitrum、Optimism、Base）
• 构建于 MetaMask 官方 Smart Accounts Kit 之上

快速开始

1. 在 walletpilot.xyz 获取 API 密钥
2. 安装 SDK：npm install @walletpilot/sdk

可用操作

connect

向用户请求钱包权限。

import { WalletPilot, PermissionBuilder } from '@walletpilot/sdk';

const pilot = new WalletPilot({ apiKey: 'wp_...' });

const permission = new PermissionBuilder()
  .spend('USDC', '100', 'day')   // 每日最多花费 100 USDC
  .spend('ETH', '0.1', 'day')    // 每日最多花费 0.1 ETH
  .chains([1, 137, 42161])       // Ethereum、Polygon、Arbitrum
  .expiry('30d')                 // 权限有效期为 30 天
  .build();

const { deepLink } = await pilot.requestPermission(permission);
console.log('用户应打开：', deepLink);

execute

使用已授予的权限执行交易。

const result = await pilot.execute({
  to: '0x1234...',        // 目标合约地址
  data: '0xabcd...',      // calldata（例如：兑换操作）
  value: '0',             // ETH 数值（可选）
  chainId: 1,             // 链 ID
});

console.log('交易哈希：', result.hash);

balance

查询代币余额（使用标准 RPC 接口，无需额外权限）。

import { createPublicClient, http } from 'viem';
import { mainnet } from 'viem/chains';

const client = createPublicClient({
  chain: mainnet,
  transport: http(),
});

const balance = await client.getBalance({ address: '0x...' });

swap

通过 DEX 聚合器执行代币兑换。

// 从 1inch、0x 等获取兑换报价
const quote = await fetch('https://api.1inch.io/v5.0/1/swap?...');
const { tx } = await quote.json();

// 通过 WalletPilot 执行
await pilot.execute({
  to: tx.to,
  data: tx.data,
  value: tx.value,
  chainId: 1,
});

send

向指定地址发送代币。

import { encodeFunctionData, erc20Abi } from 'viem';

// 编码 ERC20 transfer 调用
const data = encodeFunctionData({
  abi: erc20Abi,
  functionName: 'transfer',
  args: ['0xRecipient...', 1000000n], // 1 USDC（6 位小数）
});

await pilot.execute({
  to: '0xUSDC_ADDRESS...',
  data,
  chainId: 1,
});

history

获取交易历史记录。

const state = pilot.getState();
console.log('当前有效权限：', state.permissions);

// 或通过 API 查询
const response = await fetch('https://api.walletpilot.xyz/v1/tx/history/PERMISSION_ID', {
  headers: { 'Authorization': 'Bearer wp_...' },
});
const { data } = await response.json();
console.log('近期交易：', data);

权限类型

支持的链

安全性

• 不接触私钥：用户通过 MetaMask 完全自主掌控资产
• 细粒度权限控制：agent 仅能在授权范围内执行操作
• 时效性保障：权限自动过期，避免长期风险
• 随时可撤销：用户可在任意时刻主动撤销权限
• 全程可审计：所有交易均被记录并对外可见

API 参考文档

基础 URL： https://api.walletpilot.xyz

示例：DeFi 交易 agent

import { WalletPilot, PermissionBuilder } from '@walletpilot/sdk';

async function defiAgent() {
  const pilot = new WalletPilot({ apiKey: process.env.WALLETPILOT_KEY });

  // 检查是否已有有效权限
  const state = pilot.getState();
  
  if (!state.connected) {
    // 请求权限
    const permission = new PermissionBuilder()
      .spend('USDC', '500', 'day')
      .chains([1, 42161])
      .expiry('7d')
      .description('DeFi 交易 agent')
      .build();
    
    const { deepLink } = await pilot.requestPermission(permission);
    console.log('请在 MetaMask 中确认授权：', deepLink);
    return;
  }

  // 执行交易
  const swapData = await getSwapQuote('USDC', 'ETH', '100');
  
  await pilot.execute({
    to: swapData.to,
    data: swapData.data,
    chainId: 1,
  });
  
  console.log('兑换已执行！');
}

相关链接

• 文档
• GitHub
• API 参考文档