SuperAPI AI 工具集

subgraphs

部署与运维

查看项目

更新于 10-15 21:53

技能介绍

用途:Goldsky Subgraphs 是托管式 GraphQL API,用于索引链上事件并通过可查询端点暴露数据,适合需要灵活 GraphQL 查询结构化链上数据的前端应用与 dApp。若目标是把原始链上数据流式写入数据库(PostgreSQL、ClickHouse、Kafka、S3)而非 GraphQL 查询,官方建议改用 Turbo pipeline。

主要能力:支持本地初始化子图、从源码/ABI/IPFS 哈希部署、从 The Graph 一步迁移、无代码仪表盘部署;提供公开与私有端点、标签(tag)固定版本别名、Webhook 实体变更通知,以及列表、更新、暂停、恢复、删除、日志排查等管理操作。

使用方式:安装 CLI 并登录:curl https://goldsky.com | sh 与 goldsky login。初始化:goldsky subgraph init my-subgraph/1.0.0 --target-path ./my-subgraph。从本地构建部署:goldsky subgraph deploy my-subgraph/1.0.0 --path ./build。从 ABI:goldsky subgraph deploy my-subgraph/1.0.0 --from-abi ./MyContract.json。从 IPFS:goldsky subgraph deploy my-subgraph/1.0.0 --from-ipfs-hash QmXyz...。从 The Graph 迁移:goldsky subgraph deploy my-subgraph/1.0.0 --from-url <url>。注意 --path、--from-url、--from-ipfs-hash、--from-abi 互斥。端点形如 https://api.goldsky.com/api/public/<project-id>/subgraphs/<name>/<version>/gn,可用 goldsky subgraph list 获取。

适用场景:前端/dApp 需要 GraphQL API、索引处理器中需自定义业务逻辑、迁移已有 The Graph 子图。跨链场景可每链部署独立子图,再用 Mirror 管道合并到同一数据库表。

限制:子图停滞时会被自动暂停并邮件通知;Webhook 不保证投递,需可靠入库建议用 Mirror。私有端点需 API Key 并在请求中加 Authorization: Bearer <your-api-key>。具体支持网络、收费与价格资料暂未提供。