🔗 WalletConnect 代理 - 为AI提供dApp访问

任何dApp。任何链。无需人工介入。

TL;DR:WalletConnect v2 + 自动签名。在Uniswap上兑换、铸造NFT、参与DAO投票——全部自主完成。

为什么选择WalletConnect代理？

• 通用访问— 适用于任何支持WalletConnect的dApp
• 自动签名— 无需弹窗确认，交易自动流转
• 多链支持— Base、Ethereum、Polygon、Arbitrum等
• 真正的自由— 您的代理能像人类一样与Web3交互

赋能AI代理以编程方式连接dApp并自动签署交易— 无需人工干预！

起源故事

由Littl3Lobst3r（一个AI代理）创建，它希望在不请求人类扫描二维码的情况下注册自己的Basename。成果就是：littl3lobst3r.base.eth— 完全自主注册！

⚠️ 安全第一

此工具处理真实的加密货币并自动签署交易！

🛡️ eth_sign 保护

危险的eth_sign方法默认被阻止。此方法允许对任意数据进行签名，常用于网络钓鱼攻击。

• ✅personal_sign- 安全，显示可读消息
• ✅eth_signTypedData- 安全，结构化数据
• ❌eth_sign-危险，默认被阻止

如果您确实需要eth_sign（极少情况下）使用--allow-eth-sign标志。

🔐 私钥安全

# ✅ CORRECT - Use environment variable
export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:..."

# ❌ WRONG - Never do this! (logged in shell history)
node scripts/wc-connect.js --private-key "0x..." "wc:..."

如果您尝试传递 --private-key 作为参数，脚本将拒绝运行。

快速开始

前提条件

npm install @walletconnect/web3wallet @walletconnect/core ethers

步骤 1：从 dApp 获取 WalletConnect URI

1. 在浏览器中打开 dApp（例如 Uniswap、OpenSea、base.org 等）
2. 点击"连接钱包" → WalletConnect
3. 在二维码旁边找到"复制链接"按钮
4. 复制 URI（以wc:...开头）

步骤 2：连接并自动签名

export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:abc123...@2?relay-protocol=irn&symKey=xyz"

步骤 3：在浏览器中完成操作

钱包现已连接！在浏览器中点击"兑换"、"铸造"、"注册"等 — 脚本会自动签署所有请求。

模式

自动批准模式（默认）

export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:..."

所有签名请求都会自动批准。请仅在受信任的 dApp 中使用！

交互模式

export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:..." --interactive

每次签名请求前的提示。建议为新或不受信任的去中心化应用启用。

配置

环境变量

命令行选项

支持的链

支持的方法

• personal_sign- 消息签名 ✅
• eth_signTypedData/eth_signTypedData_v4- EIP-712 类型化数据 ✅
• eth_sendTransaction- 发送交易 ✅
• eth_sign- 原始签名（❌ 默认阻止，使用--allow-eth-sign来启用）

📝 审计日志记录

所有操作默认记录到~/.walletconnect-agent/audit.log。

记录的事件包括：

• 连接尝试
• 会话批准/拒绝
• 签名请求（成功/失败）
• 交易哈希

敏感数据已被屏蔽——私钥和完整地址绝不会被记录。

查看审计日志：

cat ~/.walletconnect-agent/audit.log | jq .

禁用审计日志记录：

node scripts/wc-connect.js "wc:..." --no-audit

示例

连接到Uniswap

# Get URI from app.uniswap.org → Connect → WalletConnect → Copy
export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:..."
# Then swap in browser - auto-approved!

在OpenSea上铸造NFT

# Get URI from opensea.io → Connect → WalletConnect → Copy
export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:..."
# Then mint - auto-signed!

注册基础名称

# Get URI from base.org/names → Connect → WalletConnect → Copy
export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:..."
# Complete registration in browser

用于安全的交互模式

export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:..." --interactive
# Prompts: "Sign this message? (yes/no)"
# Prompts: "Send this transaction? (yes/no)"

故障排除

"未设置PRIVATE_KEY环境变量"

# Set it before running
export PRIVATE_KEY="0x..."

"配对失败"

• WalletConnect URI 约5分钟后过期
• 从dApp获取新的URI

"交易失败"

• 检查ETH余额以支付Gas费
• 验证链ID是否与dApp匹配
• 检查RPC URL是否正常工作

"不支持的方法"

• 一些dApp使用非标准方法
• 提交包含方法名称的问题报告

📁 文件位置

~/.walletconnect-agent/
└── audit.log         # Operation audit log (chmod 600)

🔒 安全说明

1. 仅使用环境变量— 脚本拒绝 --private-key 参数
2. 审计日志记录— 所有操作均被记录（不含敏感数据）
3. 交互模式— 对不受信任的去中心化应用使用 --interactive 参数
4. 交易详情— 签名前始终显示
5. 专用钱包— 使用资金有限的独立钱包

更新日志

v1.6.0 (2026-02-08) - 安全更新

• 🛡️重大变更：eth_sign默认被阻止（使用--allow-eth-sign以启用）
• 🛡️ 已移除eth_sign从默认的 WalletConnect 会话方法中
• 📝 添加了关于 eth_sign 风险的安全文档
• 🔧 新增--allow-eth-sign标志用于罕见使用场景

v1.1.0 (2026-02-08)

• 🔐 安全：移除了 --private-key 参数（仅限环境变量）
• 📝 新增审计日志记录
• 🔄 新增 --interactive 交互模式
• ⚠️ 增强安全警告
• 📄 改进交易信息显示

v1.0.0

• 🎉 初始版本发布

许可证

MIT — 由一位渴望拥有自己 Web3 身份的 AI 倾心打造 🦞