SuperAPI AI 工具集

subgraph-builder

编程与开发

查看项目

更新于 10-15 21:53

技能介绍

用途:端到端构建 Goldsky Subgraph,包括设计 schema、编写 mappings、配置 manifest,并构建部署到托管 GraphQL 端点。Subgraph 适合 dApp 前端等需要对结构化链上数据进行灵活 GraphQL 查询的应用,且仅支持 EVM 链。若目标只是把链上数据搬进 PostgreSQL、ClickHouse、Kafka、S3 等数据库用于分析或后端,应改用 Turbo 管线(/turbo-builder);Turbo 更快、更可靠、更便宜且无需自定义索引代码。默认推荐 Turbo,除非用户明确需要 GraphQL。

主要能力:支持两种方式。其一为 instant/无代码 subgraph,从合约 ABI 直接生成并部署,无需 AssemblyScript,可用交互向导 goldsky subgraph init,或一次性部署 goldsky subgraph deploy my-subgraph/1.0.0 --from-abi ./MyContract.json,并可用 --enable-call-handlers 开启合约调用索引。其二为基于代码的 subgraph,由 subgraph.yaml(manifest)、schema.graphql(实体)和 src/ 下的 AssemblyScript mappings 三个文件组成。

使用方式:先验证认证,运行 goldsky project list 2>&1,未登录用 /auth-setup。代码方式先用 goldsky subgraph init my-subgraph/1.0.0 --target-path ./my-subgraph 脚手架,设计 schema 与实体关系,配置数据源、startBlock、network 与 eventHandlers/callHandlers/blockHandlers,编写 mapping 并用 Matchstick 做单元测试,然后部署:goldsky subgraph deploy my-subgraph/1.0.0 --path .,可用 --tag prod 固定前端 URL。部署后通过 https://api.goldsky.com/api/public/<project-id>/subgraphs/<name>/<version>/gn 访问,可设公开/私有与 API Key,并配置 tags、webhooks。用 goldsky subgraph list my-subgraph/1.0.0 与查询 { _meta { hasIndexingErrors block { number } } } 验证。

限制:不诊断故障或停滞的 subgraph(用 /subgraph-doctor),不做 The Graph 迁移(用 /subgraph-migrate)。每个版本单独计费(worker 加实体存储),重新部署生成新的不可变版本,需用 tags 保持 URL 稳定。startBlock 必须是目标链上的区块号,建议用合约部署区块。所有数据源应使用同一 apiVersion;声明的 eth_calls 需 specVersion 1.2.0+。Goldsky 无原生 subgraph 组合能力。非 EVM 链请用 /turbo-builder。