Dev Container do Substreams

Programe o seu primeiro projeto com o Dev Container do Substreams.

O que é um Dev Container?

É uma ferramenta para ajudar-lhe a construir o seu primeiro projeto. Pode ser executada remotamente com codespaces do Github ou localmente, com um clone do repositório inicial do Substreams⁠.

Dentro do recipiente de Programador, o comando substreams init prepara um projeto de Substreams gerado por código, o que lhe permite construir um Subgraph ou uma Solução para gestão de dados baseada em SQL com facilidade.

Pré-requisitos

Certifique-se de que o Docker e o VS Code estão atualizados.

Como navegar o Dev Container

No Dev Container, é possível criar ou importar o seu próprio substreams.yaml e associar módulos dentro do caminho mínimo, ou optar pelos caminhos de Substreams gerados automaticamente. Então, ao executar o Substreams Build, ele irá gerar os arquivos do Protobuf.

Opções

Mínimo: Você começa com o .proto do bloco bruto; é necessário programar. Este método é para utilizadores experientes.
Não-Mínimo: Extrai dados filtrados com caches específicos de rede e Protobufs tirados de módulos fundamentais correspondentes (administrados pela equipa da StreamingFast). Esse método gera um Substreams funcional do início.

Para compartilhar o seu trabalho com a comunidade, edite o seu .spkg no Registo do Substreams⁠ com:

substreams registry login
substreams registry publish

Observação: Se tiver algum problema dentro do Dev Container, use o comando help para acessar ferramentas de solução de problemas.

Como Construir um Coletor Para o Seu Projeto

O seu projeto pode ser configurado para fazer queries de dados através de um Subgraph ou diretamente de um banco de dados de SQL:

Subgraph: Execute substreams codegen subgraph. Isto gera um projeto com arquivos schema.graphql e mappings.ts básicos. É possível personalizá-los para definir entidades com base nos dados extraídos por Substreams. Para obter mais configurações, consulte esta documentação⁠.
SQL: execute substreams codegen sql para queries baseadas na SQL. Para saber mais sobre como configurar um coletor de SQL, consulte a documentação da SQL⁠.

Opções de Implantação

Para implantar um Subgraph, você pode executar o graph-node localmente com o comando deploy-local ou implantar para o Subgraph Studio com o comando deploy no arquivo package.json.

Erros Comuns

Ao executar localmente, use o comando dev-status para verificar se todos os contêineres do Docker estão saudáveis.
Se colocar o bloco inicial errado ao gerar o seu projeto, navegue até o substreams.yaml para alterar o número do bloco e execute novamente o substreams build.