SubQuery是波卡生态的 The Graph(以太坊生态的数据服务提供者)

SubQuery可以让开发者专注于其核心用例和前端,而无需浪费时间来构建用于数据处理的后端。


下载SubQuery CLI


npm install -g @subql/cli

subql help


初始化 Starter SubQuery 项目


subql init --starter Shuang_subql

  • Git 存储库(可选):提供指向此 SubQuery 项目的,并将在其中托管的存储库的 Git URL(当托管在 SubQuery Explorer 中时)。

  • RPC 端点(必需):提供一个 wss URL给一个正在运行的 RPC 端点,该端点将默认用于此项目。 您可以快速访问不同 Polkadot 网络的公共端点,甚至可以使用 OnFinality,或仅使用默认的 Polkadot 端点创建您自己的私有专用节点。

  • 作者(必填):在此处输入此 SubQuery 项目的所有者。

  • 描述(可选):您可以提供关于您项目的简短段落,描述项目包含哪些数据以及用户可以使用它做什么。

  • 版本(必填):输入自定义版本号或使用默认版本 (1.0.0)。

  • 许可证(必需):提供此项目的软件许可证或接受默认(Apache-2.0)。

cd Shuang_test

npm install


配置和构建入门项目


之后的开发将主要处理以下文件:

  • project.yaml 中的清单

  • schema.graphql 中的 GraphQL 架构

  • src/mappings/ 目录中的映射函数


GraphQL 模型生成


npm run-script codegen

此时会自动新建/src/types/models文件夹,里面是自动生成的文件


构建项目


npm run-script build


运行 SubQuery 项目


打开本地的Docker,然后执行

docker-compose pull && docker-compose up


查询新建的项目


打开浏览器并前往 http://localhost:3000

这时会看到 GraphQL playground 显示在资源管理器中,其模式是准备查询。 在 Playground 的右上角,会找到一个 Docs 按钮,该按钮将打开文档绘图。 该文档是自动生成的,能帮助找到可以查询的实体和方法。

对于新的 SubQuery 入门项目,可以尝试以下查询以了解其工作原理或了解有关 GraphQL 查询语言的更多信息。

1
2
3
4
5
6
7
8
9
10
11
12
{
query{
starterEntities(first:10){
nodes{
field1
field2
field3
id
}
}
}
}

现在有一个本地运行的 SubQuery 项目,该项目接受 GraphQL API 对示例数据的请求~

下一篇将向展示如何将新项目发布到 SubQuery Projects, 并使用ta们的资源管理器去查询


参考

SubQuery丨开发者快速入门指南

SubQuery丨Hello world 入门简介

SubQuery开发者指南丨Hello World Explained

!!!SubQuery开发者指南丨清单文件(Manifest File)