Noções Básicas de Indexação

8 exemplos para você começar com a indexação Solana - 5 básicos e 3 intermediários.

Pré-requisitos

• Provedor RPC ou nó auto-hospedado para backfill
• Banco de dados (Postgres é comum) para o estado indexado persistente
• Compreensão de Métodos RPC Principais

Exemplos Básicos

1. Por Que o RPC Sozinho Quebra em Escala

O histórico da carteira via getSignaturesForAddress pagina milhares de chamadas HTTP.

# Lento para whales - cada página é uma ida e volta RPC
solana confirm -v $(solana transaction-history <PUBKEY> 2>/dev/null | head -1) 2>/dev/null || true

• RPC é request/response - sem camada de consulta durável para análises SQL.
• Limites de taxa impedem backfills históricos durante o lançamento do produto.
• Indexadores escrevem uma vez, consultam muitas vezes a partir do seu banco de dados.

Relacionado: Paginação e Eficiência - Limites RPC

2. Fluxo de Dados do Indexador

Ingerir, analisar, armazenar, servir.

Validator → Geyser/Yellowstone/Webhook → Parser → Postgres → API

• A ingestão são eventos append-only ordenados por slot.
• O parser mapeia instruções para linhas de domínio (swaps, votos, mints).
• A API serve consultas paginadas para aplicativos.

Relacionado: Construindo um Indexador - Implementação

3. Backfill vs Transmissão ao Vivo

Recuperação histórica e depois acompanhamento de novos slots.

# Conceitual: reproduzir slots 250000000..latest de ledger arquivado ou RPC

• Backfill usa getBlock / getTransaction ou arquivos do provedor.
• Transmissão ao vivo usa Geyser ou WebSocket depois que o cursor atinge a ponta.
• Armazene o último slot processado para recuperação após falha.

4. Escritas Idempotentes

Use chaves naturais para que replays não dupliquem linhas.

INSERT INTO transfers (signature, idx, amount)
VALUES ($1, $2, $3)
ON CONFLICT (signature, idx) DO NOTHING;

• Transações têm assinaturas únicas; o índice da instrução desambigua instruções internas.
• Reorgs são raros em confirmed, mas projete flags de rollback de slot para finanças críticas.
• Replay a partir do slot N após uma interrupção deve ser seguro.

5. Analisar com IDL

Decodifique dados de instrução de forma determinística.

// Conceito: use cliente gerado ou match de discriminador anchor
// if data[..8] == DEPOSIT_DISCRIMINATOR { ... }

• Discriminadores do IDL Anchor identificam variantes de instrução.
• Parsers gerados por Codama mantêm o schema sincronizado com os lançamentos do programa.
• Nunca baseie a lógica de negócios apenas na análise de strings de log.

Relacionado: Analisando Dados de Programa - Detalhes de decodificação

Exemplos Intermediários

6. Hook de Plugin Geyser

O validador transmite atualizações de conta/tx para o seu sink.

# Flag do validador (configuração do operador)
agave-validator --geyser-plugin-config geyser.json

• Plugins recebem um fluxo contínuo na velocidade do validador.
• Você filtra programas de interesse cedo para economizar CPU.
• Veja Plugins Geyser.

7. Consumidor Yellowstone gRPC

Consumidores Rust/Go de alto throughput assinam fluxos filtrados.

# Consumidor conecta ao endpoint Yellowstone do provedor
# Filtra por ID do programa proprietário e memcmp de conta

• Menor latência do que sondar RPC para indexadores.
• Requer um provedor gerenciado ou uma stack auto-hospedada.
• Veja Yellowstone gRPC.

8. Ingestão por Webhook

O provedor envia eventos para o seu endpoint HTTPS.

# Webhook Helius -> POST https://api.yourapp.com/helius

• Não requer um servidor WebSocket de longa duração do seu lado.
• Verifique as assinaturas nos payloads do webhook de acordo com a documentação do provedor.
• Veja Webhooks.

Versões da stack: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0 e LiteSVM 0.6.x. NzA2MjAyfDQ4M29pZ2N8b2kuc2VkaXVnZWRvYw==