用途:面向需要查询或校验 Goldsky 区块链数据集名称、链前缀、数据集类型与版本的场景,供 Turbo 管道引用数据集时使用。
主要能力:提供热门链前缀(如 ethereum、base、matic、arbitrum、solana、bitcoin.raw、stellar_mainnet 等,注意 Polygon 用 matic);列出常见数据集类型(EVM 的 blocks、raw_transactions、raw_logs、raw_traces、erc20/erc721/erc1155_transfers;Solana、Bitcoin、Stellar、Sui、NEAR、Starknet、Fogo 的对应数据集);给出部分数据集字段模式,并说明数据集中不提供可消费的 decoded_logs。
必要用法:验证数据集使用 goldsky dataset get <chain>.<dataset> --outputFormat json,返回 slug、版本、schema 与 isTurboOnly;浏览用 goldsky dataset list --output json,可加 --group <chain>;无该参数时可用 curl -s https://api.goldsky.com/api/public/datasets/v1。纯 goldsky dataset list 无参数仅在真实终端可用,CI/管道中无输出。管道配置形如 sources 下 type: dataset、dataset_name、version、start_at。EVM 用 raw_transactions 而非 transactions;解码事件用 <chain>.raw_logs 配合 _gs_log_decode(_gs_fetch_abi(...), topics, data)。
适用场景与限制:适用于追踪 USDC 转账、NFT 活动、监控合约、多链数据。版本号会漂移,需以 dataset get 结果为准;字段名未列出时不得臆测;本资料未提供收费、价格等信息。