Servidor de API de teste bxid/txid

O serviço de arquivo duplo txid/bxid simplifica a integração do Qubic, verificando o sucesso da transação através de consultas curl ou do navegador Web.

Qsilver - 9 de janeiro de 2024.

Fiz um serviço de arquivo duplo txid e bxid que é acessível usando curl ou mesmo um navegador web. Os dados txid da época 83 e os dados bxid da época 90 estão no arquivo. Tanto os dados txid como os bxid estão a ser actualizados a cada minuto.

Isto permitirá uma integração muito mais fácil do Qubic nos serviços de criptografia existentes, uma vez que se torna muito mais fácil determinar se uma transação foi bem sucedida. AVISO: Este é apenas um servidor de teste e não para uso em produção, mas deve ser suficiente para depurar a lógica de depósito/retirada.

Usando o utilitário bxid

Se tiver os detalhes importantes da transação, pode calcular diretamente o bxid com o comando calcbxid do utilitário bxid:

./bxid calcbxid epoch tick source dest amount

Encontre mais detalhes em: qubic-cli/bxid.cpp em main - Qsilver97/qubic-cli (github.com)

Buscando dados de transação

Alternativamente, uma vez que você tenha um txid, você pode obter seus dados depois que ele for incluído no tick especificado com:

curl 93.190.139.223:9200/txid/_doc/(txid)

ou simplesmente usar um navegador da web.

Assumindo que a transação foi incluída no tick, aparecerá e terá um campo "bxid". Procure esse bxid com:

curl 93.190.139.223:9200/bxid/_doc/(bxid)

Se obtiver um resultado válido, significa que a transação foi concluída com êxito. Se não for encontrado, assumindo que o arquivo é atual, significa que a transação foi incluída num tique mas falhou (por exemplo, enviou mais QU do que o saldo).

Para garantir que a sua transação está "confirmada", verifique o bxid. Não existe um conceito real de confirmações no Qubic, uma vez que se torna instantaneamente final. Assim que o bxid estiver disponível, é seguro assumir que os fundos foram transferidos pelo txid.

Pesquisa avançada

Embora não seja necessário para a validação da transação, pode pesquisar qualquer campo no conjunto de dados txid ou bxid utilizando o ponto final _search:

curl 93.190.139.223:9200/txid/_search?q=AFZPUAIYVPNUYGJRQVLUKOPPVLHAZQTGLYAAUUNBXFTVTAMSBKQBLEIEPCVJ
curl 93.190.139.223:9200/bxid/_search?q=AFZPUAIYVPNUYGJRQVLUKOPPVLHAZQTGLYAAUUNBXFTVTAMSBKQBLEIEPCVJ
curl 93.190.139.223:9200/txid/_search?q=11919361
curl 93.190.139.223:9200/bxid/_search?q=11919361

Podem ser devolvidos resultados diferentes, uma vez que pode haver txid que não transfere qualquer valor, para além da falha da transação. Muitas transacções utilizam o valor zero com dados extra, e isso pode ser visto na saída txid.

Para obter mais detalhes, consulte a Pesquisa - Documentação do OpenSearch.

Para as últimas atualizações, junta-te ao Discord da Valis, segue-nos no X e adiciona o nosso blog aos marcadores.

Nesta página

• Servidor de API de teste bxid/txid
• Usando o utilitário bxid
• Buscando dados de transação
• Pesquisa avançada

Publicações relacionadas