No contexto dos dados históricos da Solana, indexação é o processo de estruturar e organizar dados históricos de transações em um banco de dados para recuperação rápida e eficiente. A maioria das empresas que cria produtos na Solana mantém índices relacionados aos seus negócios (por exemplo, transferências de stablecoins). O preenchimento retroativo é o processo de recuperar dados históricos de transações de qualquer momento desde o bloco gênese da Solana para criar um índice. Na maioria dos casos, os desenvolvedores podem usar um método RPC como getTransactionsForAddress para aplicar filtros temporais, definir a ordem de classificação (ou seja, cronológica ou mais recentes primeiro) e paginar lotes de transações. Para grandes preenchimentos retroativos, as empresas podem entrar em contato com nossa equipe para solicitar preenchimentos retroativos gerenciados.

O autoatendimento permite preencher retroativamente ou indexar dados da Solana usando métodos RPC existentes, como nosso getTransactionsForAddress aprimorado, para enviar os dados ao destino de sua preferência. O preenchimento retroativo gerenciado é uma oferta beta em que cuidamos desse processo para você. Inicialmente, limitaremos o acesso ao serviço de preenchimento retroativo gerenciado a um número restrito de clientes para entendermos melhor os pontos problemáticos e os destinos desejados para os dados antes de lançá-lo como uma opção de autoatendimento.

O método recomendado para indexar dados da Solana é usar o método RPC getTransactionsForAddress para obter todos os dados históricos da Solana, armazená-los no banco de dados de sua preferência, como PostgreSQL ou um banco de dados colunar como ClickHouse, e depois usar uma solução de streaming de dados da Solana, como LaserStream ou WebSockets aprimorados, para manter seu índice atualizado em tempo real.

O método RPC getTransactionsForAddress (gTFA) é um método RPC da Solana para consultar dados históricos exclusivo da Helius que combina getSignaturesForAddress e getTransaction em uma única chamada. Os desenvolvedores podem usar novos recursos avançados, incluindo busca reversa, filtros por tempo, status e slot, além de paginação, para retornar lotes de até 100 transações completas ou 1.000 assinaturas.

O novo filtro tokenAccounts para getTransactionForAddress retorna todas as transações de um endereço da Solana — incluindo todas as transações que envolvem as Associated Token Accounts (ATAs) do endereço — com uma única chamada. Antes, os desenvolvedores precisavam consultar getTokenAccountsByOwner e depois getSignaturesForAddress para cada conta de token, o que era lento, caro e frequentemente exigia centenas de chamadas RPC adicionais.

Sim. Para ter uma visão completa, use a API de eventos analisados para percorrer o histórico de um endereço, com instruções compatíveis decodificadas em argumentos e contas nomeados em mais de 3.600 programas da Solana, além de detalhes sobre transferências de tokens e resumos em linguagem simples quando disponíveis. Os dados brutos das instruções são preservados quando a decodificação não está disponível. Use getTransactionsForAddress quando precisar dos payloads brutos das transações. Você também pode usar getTransfersByAddress para retornar registros concisos e analisados de transferências de SOL e tokens de um endereço.

Para obter todo o histórico de uma carteira Solana, incluindo todas as suas Associated Token Accounts (ATAs), use o método RPC getTransactionsForAddress e defina o filtro tokenAccounts como all. Isso exige que as transações retornadas façam referência ao endereço da carteira ou a uma conta de token pertencente à carteira. Para saber mais, leia nosso guia sobre como obter o histórico de tokens da Solana em uma única chamada.

Criamos do zero um sistema totalmente novo para dados históricos da Solana para substituir o banco de dados padrão Google BigTable, usado pela maioria dos outros provedores de RPC para fornecer dados históricos. Nosso índice armazena uma entrada para cada par exclusivo de (transação, conta). Até o momento, nosso índice tem mais de 2,3 trilhões de linhas, que armazenam as mais de 450 bilhões de transações da Solana registradas até esta publicação. Apesar do tamanho, o tempo de consulta P50 é de aproximadamente 8 ms sob carga de produção. Também criamos outros índices para permitir consultas por slot, tempo, status e muito mais. Todos esses índices são executados em hosts bare metal desenvolvidos especificamente para essa finalidade, com petabytes de NVMEs de última geração, replicados em várias regiões para oferecer aos desenvolvedores acesso confiável, escalável e de baixa latência aos dados históricos.

Métodos RPC padrão, como getBlock, são lentos e inadequados para conjuntos de dados pequenos e específicos. Métodos em loop, como getSignaturesForAddress e getTransaction, exigem muitas solicitações RPC desnecessárias, recuos exponenciais e lógica de novas tentativas. Até agora, esses métodos RPC padrão também acessavam o Google BigTable, o armazenamento padrão de dados históricos usado pela maioria dos provedores de RPC. Criamos nosso próprio índice do zero para otimizar a forma como os dados históricos são armazenados, acessados e fornecidos. Quando os desenvolvedores consultam o método getTransactionsForAddress (gTFA), eles combinam os métodos padrão getSignaturesForAddress e getTransaction em uma única consulta, com opções adicionais de classificação, filtragem e paginação. Como criamos índices personalizados, getTransactionsForAddress oferece aos desenvolvedores mais controle sobre suas consultas, simplifica os fluxos de trabalho e retorna os dados com mais rapidez.