SuperAPI AI 工具集

portal-query-solana-instructions

通用与其它

查看项目

更新于 10-16 05:46

技能介绍

用途:通过 SQD Portal Stream API 查询 Solana 链上指令(instruction,相当于 EVM 的 transaction/log),用于追踪程序交互(如 Jupiter 兑换、Raydium 池)、监控 SPL 代币转账、分析钱包活动、按程序函数(discriminator)筛选以及追踪账户与程序的交互。

主要能力:以 JSON 查询体提交,type 固定为 "solana",fromBlock/toBlock 使用 Solana slot 号(当前约 3 亿以上),instructions 为过滤对象数组。可过滤字段均为索引字段:programId、d1/d2/d4/d8(discriminator)、a0–a31(按位置的账户)、mentionsAccount(账户出现在任意位置,较慢)、isCommitted。返回 JSON Lines,每行一个 JSON 对象,首行为区块头。

必要用法:查询前先估算指令量,可用 curl 对 10K slot 采样并 wc -l 统计:少于 50 条属低量,需排查是否为转发程序;50–500 适中;500 以上适合建索引。Anchor 程序使用 d8,推荐用 @subsquid/solana-typegen 自动生成 discriminator 与解码器(安装:npm install @subsquid/solana-typegen;生成:npx squid-solana-typegen src/abi <PROGRAM_ID>#<program_name> 或 npx squid-solana-typegen src/abi ./idl/program.json)。非 Anchor 程序(SPL Token、SPL Stake Pool、System Program)用 d1 单字节 discriminator,需手动解码。

适用场景:追踪指定程序与函数调用、SPL 代币 Transfer(SPL Token Program,d1 为 0x03)、指定钱包相关全部指令、账户位置过滤、Raydium、Orca Whirlpool、代币余额追踪、程序部署与失败指令等(更多示例见 references/additional-examples.md)。若环境提供 MCP 工具 portal_query_solana_instructions,可先做快速查询;需要自定义字段、关联交易余额/代币余额/日志或流式大数据时改用原始 Stream API。

限制与注意:discriminator 依实际 IDL 与程序版本计算,版本间可能不同,应核对或使用 typegen。务必先按 programId 过滤;Jupiter 使用 d8 而非 d1;区块号不要用 EVM 风格数值;交易签名字段是 "signatures"(复数),写成 "signature" 会报 unknown field;只需费用支付者或成功状态时需显式选择 transaction 字段。过滤选择性由高到低为 programId+d8+a0、programId+d8、programId+mentionsAccount、仅 programId。文档与数据集信息以官方 API 文档和可用数据集列表为准,其余细节暂未提供。