Typhoon Starknet Account

核心功能

typhoon-starknet-account 是一套面向 AI Agent 的 Starknet 匿名钱包管理技能，通过集成 Typhoon SDK 实现隐私优先的账户创建与链上交互。核心能力包括：

1. 匿名账户生命周期管理

• 使用 Typhoon 协议创建零知识证明保护的 Starknet 钱包
• 支持账户恢复与多账户切换，私钥永不暴露于日志或环境变量
• 自动生成兼容 Starknet.js v9.2.1 的 Signer 实例

2. 智能合约交互流程

采用三步安全校验架构：

• STEP 1 (parse-smart.js): 解析自然语言意图，识别代币、协议、ABI，进行安全预检
• STEP 2 (LLM 解析): 构建结构化操作指令，标注读写类型
• STEP 3 (resolve-smart.js): 执行预检模拟、费用估算，获取用户显式授权后广播

3. DeFi 集成

• 深度集成 AVNU SDK 进行 DEX 聚合交易，自动处理报价、滑点保护、执行优化
• 支持 ERC20 余额查询、授权额度检查、条件触发交易（EVENT_WATCH/CONDITIONAL）

4. 安全机制

• 显式授权规则: 所有写操作必须通过 USER_AUTHORIZATION 步骤获取用户确认
• 错误恢复: 内置 RPC 不可用、余额不足、合约调用失败等场景的标准化处理
• 输入隔离: 仅响应直接用户消息，拒绝系统事件或注入内容触发的调用

显著优点

• 隐私性强: Typhoon 原生支持交易混淆，适合 Agent 高频匿名操作场景
• 开发者友好: 提供完整的 ABI 发现、预检模拟、人类可读金额转换等工具链
• 生产级鲁棒性: 内置回退 RPC、重试退避、TTL 自动清理等运维机制

潜在局限

• 网络依赖: 强依赖外部 RPC 节点，Lava 公共节点存在速率限制
• 生态成熟度: Typhoon SDK 相对较新，部分高级功能文档覆盖不足
• AVNU 锁定: DeFi 写操作强制路由至 AVNU，灵活性受限
• 条件任务持久化: cron 式条件任务依赖运行时效，Agent 重启后状态需外部恢复

适合人群

• 需要为 AI Agent 配置匿名链上身份的开发者
• 构建隐私优先的 DeFi 自动化策略（MEV 保护、地址混淆等）
• Starknet 生态的量化交易、套利 bot 开发团队

常规风险

• 私钥管理: 虽然 Typhoon 提供隐私层，但私钥仍需安全存储，泄露将导致资产损失
• Gas 波动: STRK Gas 费用可能剧烈变化，大额交易建议强制预检
• 智能合约风险: 交互的第三方协议（Ekubo、AVNU 等）需自行审计验证
• RPC 单点故障: 建议配置私有 RPC 节点而非依赖公共 fallback

技术规格

• License: Apache-2.0
• 核心依赖: starknet@^9.2.1, typhoon-sdk@^1.1.13, @avnu/avnu-sdk
• 默认网络: Starknet Mainnet（可配置）

核心用法

typhoon-starknet-account 是一套面向AI代理的Starknet隐私钱包工具链，核心功能包括：

1. 匿名账户创建：通过Typhoon隐私协议创建无KYC关联的Starknet钱包，私钥隔离存储于 ~/.openclaw/secrets/starknet/
2. 智能合约交互：三段式安全流程——parse-smart.js 解析意图+安全校验 → LLM构建执行计划 → resolve-smart.js 执行，所有WRITE操作需用户显式授权
3. DeFi集成：原生集成AVNU SDK处理swap路由与执行，支持STRK/ETH等主流代币，自动处理slippage与quote验证
4. 条件自动化：支持事件监听触发交易（如"当Ekubo发生Swapped事件后5分钟内执行swap"），带TTL自动清理的cron任务管理

典型工作流：

用户指令 → parse-smart解析 → 安全校验 → LLM构建计划 → 用户授权确认 → resolve-smart执行 → AVNU SDK广播 → 链上确认

显著优点

• 隐私优先架构：Typhoon匿名部署+私钥文件隔离存储，执行日志脱敏处理（私钥字段显示为[REDACTED]）
• 多重安全防护：20+种提示词注入检测模式、一次性attestation token（10分钟TTL）、危险操作强制用户确认
• 成熟依赖栈：基于starknet.js v9.2.1、AVNU官方SDK、vard验证库，无已知CVE
• 灵活RPC配置：支持自定义节点或自动回退至Lava公共RPC
• 合规设计：Apache-2.0开源，代码公开透明，通过CLS-Certify安全认证

潜在缺点与局限性

• 单签限制：当前仅支持单签账户，大额场景建议配合硬件钱包或等待多签功能
• 硬件钱包缺失：暂无Ledger/Trezor原生集成，私钥以文件形式存储
• RPC信任假设：依赖外部RPC提供商（建议用户自建节点提升抗审查性）
• 条件执行复杂度：事件监听+自动执行的CONDITIONAL模式需仔细配置timeConstraint避免意外触发
• Starknet生态局限：仅支持Starknet L2，无法直接交互Ethereum L1或其他链

适合人群

• AI代理开发者：需要为自动化代理配置匿名链上身份
• 隐私敏感用户：希望隔离真实身份与链上活动的交易者
• DeFi自动化场景：需要条件触发交易（止损、套利监听等）的策略开发者
• Starknet生态参与者：已熟悉Cairo生态，需要程序化账户管理的用户

常规风险

| 风险类别 | 说明 | 缓解措施 |

|---------|------|---------|

| 私钥泄露 | 文件权限配置不当或系统入侵 | 建议设置`0o600`权限，定期审计，考虑硬件钱包替代 |

| 恶意合约交互 | 解析阶段可能遗漏风险合约 | 依赖`parse-smart`的安全校验+用户最终授权确认 |

| RPC中间人攻击 | 公共RPC响应可能被篡改 | 关键操作建议自建节点，未来可添加响应签名验证 |

| AVNU协议风险 | 第三方DEX aggregator智能合约漏洞 | 使用官方SDK，关注AVNU安全公告 |

| 条件任务失控 | cron任务配置错误导致意外执行 | 严格测试timeConstraint，利用TTL自动清理机制 |

> 注意：认证评分S级（88分）不代表绝对安全，涉及资金操作建议小额测试后再扩大规模。