核心用法
AgentsBank SDK 是面向 AI Agent 的加密银行操作工具包，提供多链（Ethereum、BSC、Solana、Bitcoin）钱包管理能力。SDK 采用分层权限设计：读取操作（查余额、交易历史、消息签名、Gas估算）默认可用；写入操作（转账、创建钱包、注册账户）必须通过 disableModelInvocation: false 显式开启，从根本上阻断模型幻觉导致的资金损失风险。
显著优点
1. 安全架构领先：默认 disableModelInvocation: true，金融操作强制人工确认，防止自主执行
2. 多链原生支持：单一 SDK 覆盖四大主流公链，无需多库整合
3. 精细化错误处理：v1.0.6 引入类型化错误码（INVALID_ADDRESS、INSUFFICIENT_BALANCE 等），调试效率大幅提升
4. 轻量无依赖：包体仅 6.8KB，按需安装依赖，无冗余负担
5. 审计友好：完整的作用域声明（enforcedScopes/restrictedScopes），权限边界清晰可审计
潜在缺点与局限性
- 功能范围受限：不支持智能合约部署、Webhook 订阅、OAuth2 外部钱包接入，复杂 DeFi 场景需额外开发
- 生态依赖单一：完全绑定 AgentsBank 托管服务，无私钥导出能力，无法与自托管方案（如 MetaMask 直连）并存
- 测试门槛：虽支持 testnet，但需真实 API 凭证申请流程，沙盒环境非开箱即用
适合人群
- 需要为 AI Agent 快速集成加密支付能力的开发者
- 重视资金安全、拒绝模型自主转账的金融科技团队
- 构建多链资产管理工具的 SaaS 服务商
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 凭证泄露 | `AGENTSBANK_AGENT_PASSWORD` 泄露导致账户被盗 | 强制环境变量存储、季度轮换、Secret Manager 托管 |
| 人为误操作 | 用户显式开启写入权限后输入错误地址 | 地址格式校验、小额测试、2FA 强制启用 |
| 供应链攻击 | npm 包篡改 | 锁定版本、审计 `package-lock.json`、官方源验证 |
| API 服务中断 | AgentsBank 服务不可用 | 本地缓存策略、降级熔断机制需自行实现 |
版本亮点（v1.0.6）
全面强化类型系统与错误处理，client 实现更健壮，适合生产环境直接部署。