隐私优先的Starknet代理钱包

为AI代理创建匿名Starknet钱包，集成Typhoon隐私协议，支持合约读写、DeFi交互（AVNU兑换）及预执行模拟，适合需要链上匿名的自动化场景。

基本信息

• 技能名称?Typhoon Starknet Account
• 中文名称?隐私优先的Starknet代理钱包
• 作者?esdras-sena
• 分类?专业技能
• 版本?0.3.8
• 标签?starknet, privacy, anonymous-wallet, defi, avnu, typhoon, zero-knowledge, smart-contract, agent-automation, cryptocurrency

使用方法

使用说明
核心用法
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数量 |