用途:Kora 是 Solana 上的 paymaster(付费代理),让用户以 SPL 代币(如 USDC)支付手续费,实现无 Gas 交易,并支持费用抽象与 Jito bundle 提交。本技能面向使用 Kora TypeScript SDK 与 JSON-RPC API 的集成场景。
主要能力:提供两类客户端模式——独立的 KoraClient,以及可组合的 Kit 插件 koraPlugin(响应使用 Kit 类型,如 Address、Blockhash),插件方式通过 client.kora.* 访问。核心方法包括 getPayerSigner、getBlockhash、getPaymentInstruction、signTransaction、signAndSendTransaction、estimateTransactionFee、signBundle、signAndSendBundle、estimateBundleFee、getConfig。支持 Jito bundle 原子提交(最多 5 笔交易)以及仅签名不提交。
使用方式:安装 @solana/kora,并配置 @solana/kit v6+ 与 @solana-program/token v0.10+。无 Gas 交易流程共 6 步:(1) 用 @solana-program/* 库构建指令;(2) 以 noop signer 作为 fee payer 构建估算交易;(3) 调用 getPaymentInstruction() 获取费用转账指令;(4) 合并用户指令与支付指令并使用新 blockhash 构建最终交易;(5) 用户部分签名;(6) 调用 signTransaction() 或 signAndSendTransaction() 让 Kora 联签费用方签名。noop signer 是 Kora 费用方的占位符,通过 createNoopSigner(address(...)) 创建。signer_key 为可选参数,用于多签池一致性;user_id 在定价为免费且启用用量跟踪时于签名方法中必需。认证方式有三种且可同时启用:API Key(x-api-key)、HMAC(x-timestamp 与 x-hmac-signature,SDK 自动计算 SHA256)、reCAPTCHA v3(通过 getRecaptchaToken 回调自动附加令牌)。/liveness 端点始终绕过认证。
限制与注意事项:启用 Lighthouse 费用方保护时,signTransaction/signBundle 可能修改交易消息(加入余额断言),客户端签名会失效需重新签名;Lighthouse 不适用于 signAndSendTransaction/signAndSendBundle 广播方法。务必为最终交易获取新 blockhash。文档与详细 RPC 方法说明见 https://launch.solana.com/docs/kora/ 及参考资料。具体收费、价格与计费细节暂未提供。