用途:在 Starknet 上执行 DeFi 操作,包括通过 avnu 聚合器进行代币兑换、DCA 定投、STRK 质押以及借贷。适用于需要 AVNU 路由、Paymaster 支持或协议级 DeFi 执行的智能体工作流。不适用于无 DeFi 意图的纯钱包管理,也不用于 Cairo 合约编写、部署或安全审计。
主要能力:代币兑换(获取报价、执行兑换、构建可组合的多调用);无 Gas 兑换(用指定代币支付 Gas,如 USDC);DCA 定投(创建、查询、取消订单);STRK 质押(查询池信息、质押、查看用户信息、领取奖励并可选复投、发起解除质押并等待冷却期后完成);市场数据(代币价格、按符号查询已验证代币、分页浏览代币)。涉及的协议包括 avnu、Ekubo、JediSwap、zkLend、Nostra。
使用方式:先安装依赖 npm install starknet@^8.9.1 @avnu/avnu-sdk@^4.0.1,并将技能指向已注资的 Starknet 账户。核心入口为 getQuotes、executeSwap、quoteToCalls、executeCreateDca、getDcaOrders、executeCancelDca、executeStake、getUserStakingInfo、executeClaimRewards、executeInitiateUnstake、executeUnstake、getPrices 等。需要配置 STARKNET_RPC_URL、STARKNET_ACCOUNT_ADDRESS、STARKNET_PRIVATE_KEY(均为必填),可选 AVNU_BASE_URL、AVNU_PAYMASTER_URL、AVNU_API_KEY。主网 API 为 https://starknet.api.avnu.fi,Paymaster 为 https://starknet.paymaster.avnu.fi;Sepolia 对应 sepolia 子域。
限制:需提供 RPC 与已注资账户;STRK 解除质押存在冷却期(资料标注为 21 天);文档提供常见错误处理示例,如余额不足、滑点、报价过期、流动性不足。其他细节暂未提供。