用途:在 Base 链上查询链上数据,包括解码后的事件日志、交易、区块与转账信息,通过 CDP SQL API 执行,经 x402 按次付费。
主要能力:可查询 base.events(解码事件日志,含 event_signature、address、block_timestamp 等索引字段及 parameters 解码参数)、base.transactions(完整交易数据)、base.blocks(区块元数据)。支持 CoinbaseQL 语法,含 SELECT、WHERE、GROUP BY、ORDER BY、LIMIT、WITH、UNION、各类 JOIN、CASE、CAST、子查询、数组/映射索引与 lambda 函数。
使用方式:先确认钱包已初始化并认证,运行 npx awal@latest status;未认证时参考 authenticate-wallet 技能。执行查询示例:npx awal@latest x402 pay https://x402.cdp.coinbase.com/platform/v2/data/query/run -X POST -d '{"sql": "<YOUR_QUERY>"}' --json。务必用单引号包裹 -d 的 JSON 字符串以防 bash 变量展开。
限制与要求:需已认证且钱包有足够 USDC 余额(可用 npx awal@latest balance 查看),每次查询费用 0.10 美元(100000 USDC 原子单位)。查询 base.events 必须至少包含一个索引字段(event_signature、address、block_timestamp)以避免全表扫描,优先用 event_signature 而非 event_name;避免 SELECT *,指定所需列并加 LIMIT;地址用 lower() 包裹。常见错误包括未认证、余额不足、查询超时。
适用场景:查看 Base 链上解码区块、事件、交易与转账等链上信息。其他细节暂未提供。