核心功能
typhoon-starknet-account 是一套面向 AI Agent 的隐私钱包工具集，基于 Typhoon 协议实现 Starknet 链上的匿名账户管理。核心能力覆盖：
1. 匿名钱包生命周期管理 —— 创建/加载 Typhoon 风格的 Starknet 账户，私钥与地址隔离存储
2. 智能合约交互 —— 发现 ABI、执行读写调用、预检模拟与费用估算
3. 隐私 DeFi 执行 —— 集成 AVNU SDK 完成匿名 swap，支持条件触发（CONDITIONAL）与事件监听（EVENT_WATCH）
显著优点
- 隐私优先设计：Typhoon 集成确保交易链路匿名，适合对抗审查场景
- Agent 原生：脚本化设计、JSON-RPC 驱动、LLM 可解析的输出格式
- 生产级鲁棒性：内置 RPC 降级（Lava 公共节点）、错误码分级（RPC_UNAVAILABLE / INSUFFICIENT_FUNDS 等）、回退重试逻辑
- 条件自动化：支持基于链上事件的自动执行（如价格触发 swap），带 TTL 自动清理
潜在局限
- RPC 依赖：需自行配置
STARKNET_RPC_URL，公共节点可能存在延迟或限流 - Gas 代币要求：STRK/ETH 余额检查前置，新账户需手动充值
- 授权门槛：所有写操作需用户显式确认（
USER_AUTHORIZATION步骤），全自动化受限 - 生态锁定：深度绑定 AVNU/Ekubo 路由，跨协议扩展需手动 ABI 配置
适合人群
- 需要匿名链上操作的 AI Agent 开发者
- 自动化交易策略的隐私增强场景
- 对抗地址追踪的 DeFi 自动化工具构建者
常规风险
- 私钥管理：环境变量存储
PRIVATE_KEY，需确保运行环境隔离 - RPC 中间人：使用第三方公共 RPC 存在日志泄露风险，建议自建节点
- 协议智能合约风险：Typhoon/AVNU/Ekubo 合约漏洞可能导致资金损失
- 授权滥用：虽强制用户确认，但 LLM 解析错误可能误导用户授权恶意操作