Indexer

Este endpoint facilita a recuperação e o armazenamento adequado no Firebase de informações relacionadas a cauções submetidas à Blockchain Stellar por aplicações externas, contornando a aplicação padrão.

Componentes principais

• Transação Externa: Este endpoint lida com casos em que o XDR gerado por qualquer endpoint da nossa API REST é assinado e enviado diretamente por aplicações externas.

• Fila Interna: Informações inicialmente geradas pela aplicação são armazenadas em uma fila interna, aguardando associação com uma transação específica identificada pelo seu hash (txHash).

• Armazenamento Firebase: Uma vez recuperadas da fila interna, as informações são armazenadas permanentemente no Firebase.

Papéis Envolvidos

• Aplicação Externa: Assina e envia o XDR sem usar o endpoint padrão (helper/send-transaction).

• Indexer: Responsável por recuperar informações da fila interna e armazená-las no Firebase ao receber o hash da transação (txHash).

Fluxo do Endpoint

1. O XDR é obtido de qualquer transação (não assinada) gerada com qualquer um dos endpoints da nossa API REST.

2. O XDR gerado é assinado e enviado externamente (sem usar helper/send-transaction).

3. A aplicação externa fornece o correspondente txHash.

4. O txHash é enviado para indexer/update-from-txHash.

5. O endpoint recupera informações armazenadas na fila interna e as salva no Firebase.

Exemplo de Uso

• Requisição:

{
  "txHash": "seu-valor-txHash"
}

• Resposta:

As informações associadas ao fornecido txHash são armazenadas com sucesso no Firebase, garantindo a integridade do escrow gerado.

Benefícios do Uso

• Permite integrações externas enquanto mantém a consistência das informações.

• Previne perda de dados ao contornar o fluxo de trabalho padrão.

• Garante armazenamento seguro e preciso no Firebase usando o hash da transação.

Este endpoint aprimora a flexibilidade e robustez do sistema, garantindo que todas as transações, independentemente do método usado, sejam adequadamente registradas no Firebase.