专为AI Agent设计的多链加密钱包SDK，支持余额查询与受控交易，默认禁用模型自主调用以保护用户资产安全。
说明：
## 核心用法
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 实现更健壮，适合生产环境直接部署。
会员专属
