核心用法
Basename Agent 是一款专为 AI Agent 设计的链上身份注册工具，允许用户程序化地注册 .base.eth 域名。通过集成 WalletConnect v2 和 Puppeteer 浏览器自动化，用户可以在无图形界面干预的情况下完成从域名查询、钱包连接到交易签名的全流程。
主要功能：
- 域名可用性检查：
--dry-run模式预查域名是否可注册 - 自动化注册流程：自动打开 base.org/names、连接 WalletConnect、签署注册交易
- 多 dApp 支持：通过
wc-connect.js模块可扩展至任意支持 WalletConnect 的 dApp - 审计日志：所有操作记录至
~/.basename-agent/audit.log
显著优点
1. 无浏览器交互：全程自动化，适合服务器/Agent 部署场景
2. 安全措施完善：强制环境变量传入私钥（禁止命令行参数），内置 --dry-run 测试模式
3. 成本透明：按字符长度分级定价（0.0001-0.1 ETH），Gas 费用低廉（Base 链约 0.0001 ETH）
4. 生态集成：直接对接 Base 官方域名系统，支持后续链上声誉构建
潜在缺点与局限性
- 私钥暴露风险：虽强制环境变量，但 Node.js 进程内存中仍明文存在私钥；建议配合硬件钱包或 KMS
- 浏览器依赖：依赖 Puppeteer 和 Chromium，容器环境需额外配置无头浏览器
- 单链限制：仅支持 Base 网络，无多链扩展性
- 前端 UI 依赖：base.org/names 界面变更可能导致自动化脚本失效
适合人群
- AI Agent 开发者：为自主 Agent 创建可识别、可交互的链上身份
- 自动化运维团队：批量管理组织域名资产
- Web3 基础设施开发者：构建无需人工干预的链上身份系统
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 私钥泄露 | 环境变量可能通过进程 dump、日志泄露 | 使用专用低资金钱包，配合 AWS Secrets Manager 等 KMS |
| 合约风险 | 与 Base Registrar 合约交互，存在潜在漏洞可能 | 关注官方合约审计报告，限制单钱包资金 |
| 前端篡改 | base.org 被劫持时可能遭受钓鱼 | 验证交易参数中的合约地址 |
| Gas 波动 | 网络拥堵时成本不可控 | 设置最大 Gas 限制，非紧急时段操作 |