用途:面向 keep-starknet-strange/starkzap 仓库的开发技能,当任务涉及 Starkzap SDK 代码、示例或文档时使用,例如新增引导流程、修复 wallet.execute 的赞助交易行为、更新质押池逻辑或校验器预设、修补 Privy 签名器/服务端集成、审查测试与文档。
主要能力:覆盖 StarkSDK 顶层编排、钱包实现与生命周期、StarkSigner/PrivySigner 签名器适配、Tx 与 TxBuilder、ERC20 代币辅助(余额/转账)、质押操作与池发现、共享领域类型。提供参考文档(签名器信任边界、赞助交易与 paymaster 费用模式、Amount 语义、质押可靠性)与可运行诊断脚本。
使用方式:用 network 或 rpcUrl+chainId 实例化 StarkSDK,通过 sdk.onboard(...) 或 sdk.connectWallet(...) 连接钱包,支持 OnboardStrategy.Signer、Privy、Cartridge;user_pays 写入前调用 wallet.ensureReady({ deploy: "if_needed" })。执行用 wallet.execute(calls, options),模拟检查用 wallet.preflight({ calls, feeMode }),批量用 wallet.tx()。ERC20 用 Amount.parse 校验金额;质押涉及 enter、add、exit intent、exit。
限制与注意:Cartridge 仅限 Web 运行时,需处理弹窗/会话与策略范围。不要手改生成文件(token/validator 预设、docs/api、docs/export),应使用 npm run generate:tokens、generate:tokens:sepolia、generate:validators、generate:validators:sepolia、docs:api、docs:export 重新生成。验证先跑 npm run typecheck 与 npm test,跨切面改动再跑 npm run build、npm run test:all,集成测试 npm run test:integration 可能需要本地 devnet/fork。错误分为 VALIDATION_ERROR、UNDEPLOYED_ACCOUNT、RPC_OR_NETWORK、TX_REVERTED、AUTH_OR_PERMISSION、RATE_LIMIT_OR_TIMEOUT、GENERATED_ASSET_DRIFT,按对应步骤恢复。通用 DeFi 与 avnu 聚合器 STRK 质押请改用 starknet-defi 技能。