为AI代理创建匿名Starknet钱包，集成Typhoon隐私协议，支持合约读写、DeFi交互（AVNU兑换）及预执行模拟，适合需要链上匿名的自动化场景。
说明：
## 核心用法
typhoon-starknet-account 是一个面向AI代理的Starknet链上操作工具包，核心流程为**解析→执行**两步走：
1. **解析阶段**：`parse-smart.js` 接收自然语言指令，通过LLM结合ABI上下文识别操作意图（代币兑换、余额查询、授权检查等），输出结构化的操作计划，包含安全校验、代币映射、协议识别和合约地址。
2. **执行阶段**：`resolve-smart.js` 根据解析结果执行具体操作，支持**READ**（视图函数）、**WRITE**（合约调用）、**EVENT_WATCH**（事件监听）和**CONDITIONAL**（条件触发执行）四种模式。所有DeFi相关写操作强制使用AVNU SDK进行路由优化和滑点保护，而非原始RPC调用。
**特色功能**：
– **Typhoon匿名账户流**：创建隐私保护的Starknet钱包，隐藏代理身份
– **预执行模拟**：通过preflight模拟交易并估算gas费用，避免失败交易损失
– **人类可读金额**：自动处理ERC20小数位转换
– **条件自动化**：支持基于链上事件的定时触发任务（带TTL自动清理）
## 显著优点
| 优势 | 说明 |
|——|——|
| 隐私优先 | Typhoon集成实现真正的匿名钱包，代理地址不与真实身份关联 |
| 安全设计 | 强制用户显式授权（`USER_AUTHORIZATION`步骤）后才广播交易 |
| DeFi原生 | 内置AVNU SDK，自动处理最优路径、滑点保护和报价失效场景 |
| 容错机制 | 详细的错误码体系（`RPC_UNAVAILABLE`、`INSUFFICIENT_FUNDS`等）及恢复建议 |
| 轻量依赖 | 仅依赖starknet.js v9、typhoon-sdk等成熟库 |
## 潜在局限
– **网络依赖**：必须配置`STARKNET_RPC_URL`，默认公共RPC（Lava）可能有速率限制
– **SDK版本锁定**：严格要求starknet@^9.2.1，升级可能存在breaking changes
– **条件任务持久化**：cron任务依赖运行环境，代理重启可能导致watcher丢失
– **隐私边界**：Typhoon保护链上地址关联，但不隐藏交易金额和合约交互模式分析
## 适合人群
– 需要**匿名执行链上策略**的量化交易代理
– 构建**隐私保护DeFi自动化**的开发者
– 希望**隐藏资金轨迹**的机构级AI agent
– Starknet生态的**MEV searcher**和**套利机器人**
## 常规风险
| 风险等级 | 描述 | 缓解措施 |
|———|——|———|
| ? 高 | 私钥环境变量泄露 | 使用专用密钥管理服务，禁止日志打印 |
| 中 | 智能合约漏洞（尤其是Ekubo等外部协议） | preflight模拟+小额测试 |
| ? 中 | AVNU报价失效/滑点损失 | 设置合理slippage tolerance，监控revert |
| ? 低 | RPC节点不稳定 | 配置多个fallback endpoint |
| ? 低 | 条件任务堆积 | TTL自动清理+监控cron job数量 |
会员专属
