Cosmos Quick Start

... 2022-11-16 大约 7 分钟

# Cosmos Quick Start

In this Quick start guide, we're going to start with a simple Cosmos starter project in the Juno Network and then finish by indexing some actual real data. 这是开发您自己的 SubQuery 项目的良好基础。

如果您正在寻找Terra指南,您可以阅读 Terra特定的快速启动指南

在本指南的最后,您将拥有一个在 SubQuery 节点上运行的可工作 的 SubQuery 项目,该节点具有一个可以从中查询数据的 GraphQL 端点。

如果您还没有准备好进一步学习,我们建议您熟悉SubQuery中所使用的 terminology

The goal of this quick start guide is to adapt the standard starter project to begin indexing all votes on the Terra Developer Fund (opens new window) (which also contributed to SubQuery) from Cosmos, it should only take 10-15 minutes

You can see the final code of this project here at https://github.com/jamesbayly/juno-terra-developer-fund-votes (opens new window)

# 准备

# 本地开发环境

# 安装 SubQuery CLI

使用 NPM 在终端上全局安装 SubQuery CLI:

# NPM
npm install -g @subql/cli
1
2

请注意,我们鼓励使用yarn global来安装@subql/cli,因为它的依赖性管理不好,可能会导致下一步的错误。

然后,您可以运行帮助以查看 CLI 提供的可用命令和用法。

subql help
1

# 初始化 Starter SubQuery 项目

Cosmos is not yet supported in SubQuery's CLI (subql), to start with Juno clone or fork the starter project (opens new window).

在初始化过程完成后,您应该看到目录内创建了一个项目名称的文件夹。 此目录的内容应该与 Directory Structure 中列出的内容完全相同。

最后,在项目目录下,运行以下命令来安装新项目的依赖关系。

# 正在对您的项目进行更改

在您刚刚初始化的启动包, 我们为您的新项目提供了标准配置。 您将主要处理下列文件:

  1. schema.graphql中的 GraphQL Schema
  2. project.yaml 中的项目清单
  3. src/mappings/ 目录中的映射函数

本快速入门指南的目的是调整标准的启动项目,以开始对Polkadot的所有转移进行索引。

# 更新你的GraphQL Schema文件

schema.graphql 文件定义了各种GraphQL 模式。 遵循GraphQL查询语言的工作方式,模式文件基本上决定了您从 SubQuery 获取数据的格式。 这是一个很好的开始,因为它允许你在前面定义你的最终目标。

We're going to update the schema.graphql file to read as follows so we can index all votes on the Terra Developer Fund (opens new window).

type Vote @entity {
  id: ID! # id field is always required and must look like this
  blockHeight: BigInt!
  voter: String! # The address that voted
  proposalID: BigInt! # The proposal ID
  vote: Boolean! # If they voted to support or reject the proposal
}
1
2
3
4
5
6
7

重要提示:当您对模式文件做任何更改时, 请确保使用命令yarn codegen来重新生成你的类型目录。 现在就做。

上次编辑于: 2022年11月16日 22:54