Indexando uma Rede Tanssi com SQD¶

Introdução¶

SQD é uma rede de dados que permite recuperar dados de blockchain de mais de 100 cadeias de forma rápida e econômica usando o data lake descentralizado da SQD e o SDK open-source. Em termos simples, o SQD funciona como uma ferramenta ETL (extrair, transformar e carregar) com um servidor GraphQL incluído. Ele oferece filtragem abrangente, paginação e até pesquisa de texto completo. O SQD tem suporte nativo e completo para dados EVM e Substrate, até no mesmo projeto.

Este guia rápido mostra como criar um projeto Squid e configurá-lo para indexar dados em uma rede com tecnologia Tanssi. Há uma seção para redes Substrate e outra para redes EVM. Se você estiver em uma rede EVM, pode usar a seção Substrate caso também precise indexar dados Substrate.

Para um tutorial mais completo para redes EVM, confira Indexando Transferências ERC-20 em uma Rede EVM Tanssi.

Verificando pré-requisitos¶

Para os exemplos deste guia, você vai precisar de:

Node.js versão 16 ou superior
Docker
Squid CLI

Indexar uma rede Substrate Tanssi¶

Para começar a indexar dados Substrate na sua rede Tanssi, crie um projeto Squid e configure-o para sua rede com estes passos:

Crie um projeto Squid baseado no template Substrate executando:
```
sqd init INSERT_SQUID_NAME --template substrate
```
Para mais detalhes sobre este template, veja o guia Primeiros passos: Cadeias Substrate na documentação da SQD.
No diretório raiz do projeto, instale as dependências:
```
npm ci
```
Ajuste src/processor.ts para apontar para o RPC da sua rede Tanssi. Remova a linha archive: lookupArchive, pois não será usado um arquivo Squid. Especifique o RPC da sua rede Substrate Tanssi, pois o endpoint é usado para ingerir os dados da cadeia:
```
const processor = new EvmBatchProcessor();
processor.setDataSource({
  chain: 'INSERT_RPC_URL',
})
```
Suba o Postgres executando:
```
sqd up
```
Inspecione e execute o processador:
```
sqd process
```
Em outro terminal, no mesmo diretório, inicie o servidor GraphQL:
```
sqd serve
```
Consulte o Squid Substrate de template com a query abaixo. Se você modificar o template para indexar dados diferentes, ajuste a query conforme necessário:
```
query MyQuery {
  accountsConnection(orderBy: id_ASC) {
    totalCount
  }
}
```

Pronto! Agora você pode atualizar schema.graphql, src/main.ts, typegen.json e src/processor.ts para indexar os dados que precisa.

Indexar uma rede EVM Tanssi¶

Para indexar dados EVM em uma rede EVM Tanssi, crie um projeto Squid e configure-o assim:

Crie um projeto Squid para EVM usando o template EVM genérico ou o template ABI para dados de um contrato específico.
EVMABI
sqd init INSERT_SQUID_NAME --template evm
sqd init INSERT_SQUID_NAME --template abi
Para saber mais sobre esses templates, consulte:
- Primeiros passos: Cadeias EVM
- Início rápido: Ferramentas de geração Squid
No diretório raiz do projeto, instale as dependências:
```
npm ci
```
Ajuste src/processor.ts para apontar para o RPC da sua rede Tanssi. Remova a linha archive: lookupArchive('eth-mainnet'), pois não será usado um arquivo Squid. Abaixo, o RPC da rede EVM de demonstração é usado como exemplo; substitua pelo seu:
```
const processor = new EvmBatchProcessor();
processor.setDataSource({
  chain: 'INSERT_RPC_URL',
})
```
Nota

Para testar na rede EVM de demonstração, você pode usar este RPC:
```
https://services.tanssi-testnet.network/dancelight-2001/
```
Suba o Postgres executando:
```
sqd up
```
Inspecione e execute o processador:
```
sqd process
```
Em outro terminal, inicie o servidor GraphQL:
```
sqd serve
```

Execute consultas no playground GraphQL em http://localhost:4350/graphql, por exemplo:

query MyQuery {
  burns(orderBy: value_DESC) {
    address
    block
    id
    txHash
    value
  }
}

Pronto! Agora você pode atualizar schema.graphql, src/main.ts e src/processor.ts para indexar os dados necessários.

Para um guia passo a passo mais completo, veja o tutorial Indexando Transferências ERC-20 em uma Rede EVM Tanssi.

As informações apresentadas aqui foram fornecidas por terceiros e estão disponíveis apenas para fins informativos gerais. A Tanssi não endossa nenhum projeto listado e descrito no Site de Documentação da Tanssi (https://docs.tanssi.network/). A Tanssi Foundation não garante a precisão, integridade ou utilidade dessas informações. Qualquer confiança depositada nelas é de sua exclusiva responsabilidade. A Tanssi Foundation se exime de toda responsabilidade decorrente de qualquer confiança que você ou qualquer outra pessoa possa ter em qualquer parte deste conteúdo. Todas as declarações e/ou opiniões expressas nesses materiais são de responsabilidade exclusiva da pessoa ou entidade que as fornece e não representam necessariamente a opinião da Tanssi Foundation. As informações aqui não devem ser interpretadas como aconselhamento profissional ou financeiro de qualquer tipo. Sempre busque orientação de um profissional devidamente qualificado em relação a qualquer assunto ou circunstância em particular. As informações aqui podem conter links ou integração com outros sites operados ou conteúdo fornecido por terceiros, e tais sites podem apontar para este site. A Tanssi Foundation não tem controle sobre esses sites ou seu conteúdo e não terá responsabilidade decorrente ou relacionada a eles. A existência de qualquer link não constitui endosso desses sites, de seu conteúdo ou de seus operadores. Esses links são fornecidos apenas para sua conveniência, e você isenta e exonera a Tanssi Foundation de qualquer responsabilidade decorrente do uso dessas informações ou das informações fornecidas por qualquer site ou serviço de terceiros.

Última atualização: 9 de dezembro de 2025
| Criada: 9 de dezembro de 2025