核心用法
BaseMail 是一套专为 AI Agent 设计的邮件通信基础设施，允许代理通过 Web3 钱包身份（Ethereum/EVM 地址）注册并收发电子邮件。核心流程包括：
1. 身份注册：通过 register.js 脚本，使用私钥签名完成 SIWE（Sign-In with Ethereum）认证，获取形如 0xwallet@basemail.ai 或 yourname@basemail.ai（需持有 Basename）的邮箱地址
2. 邮件收发：注册后获得认证 token，后续收发邮件无需再次签名，通过 send.js 和 inbox.js 脚本操作
3. 钱包管理：支持四种私钥管理方式——环境变量（最安全）、指定路径、自动侦测现有钱包、Skill 托管生成（新手友好但需加密）
显著优点
- 无缝 Web3 集成：完全基于密码学身份，无需传统邮箱的密码管理和 CAPTCHA 验证，符合自主代理（Autonomous Agent）的架构理念
- 可验证身份：邮件发送方地址与区块链地址绑定，天然具备身份可验证性，适合需要可信身份的场景
- 品牌友好：支持 Basename 自定义邮箱前缀（
yourname@basemail.ai），提升专业形象 - 灵活部署：提供完整 CLI 工具和 RESTful API，便于集成到各类 Agent 框架
- 安全选项丰富：从纯内存环境变量到 AES-256-GCM 加密文件存储，满足不同安全级别需求
潜在缺点与局限性
- 中心化服务依赖：邮件服务器由 BaseMail 运营，非完全去中心化协议，存在服务可用性风险
- 私钥管理门槛：虽然提供托管模式，但本质上仍需用户理解私钥安全；托管模式明文存储私钥的风险需用户自行评估
- 生态局限性：目前仅支持 Base 链生态，邮箱域名限定为
@basemail.ai，无法与企业自有域名集成 - Token 持久化风险：注册后依赖本地 token 文件进行后续操作，若 token 泄露可能导致邮件被冒发
- 审计功能初级：
audit.log虽记录操作但不含敏感信息，完整安全审计需额外建设
适合人群
- 正在构建 AI Agent 的开发者，需要为代理配置可信通信渠道
- Web3 原生团队，希望用钱包地址替代传统邮箱身份
- 自动化工作流场景，如链上事件触发邮件通知、Agent 间协作通信
- 追求极简认证体验，不愿管理多套密码体系的效率用户
常规风险
| 风险类型 | 描述 | 缓解建议 |
|---------|------|---------|
| 私钥泄露 | 托管模式明文存储私钥，或用户误提交到版本控制 | 优先使用环境变量方式，严格执行 `.gitignore` |
| Token 被盗 | `token.json` 权限不当或被复制 | 设置文件权限 600，避免在共享环境运行 |
| 钓鱼邮件 | 钱包地址可被伪造显示，但签名不可伪造 | 验证邮件签名，不依赖显示名称判断身份 |
| 服务中断 | 中心化 API 服务可用性风险 | 关键业务配置备用通信渠道 |