Probar el servidor de API bxid/txid

El servicio de archivo dual txid/bxid simplifica la integración de Qubic al verificar el éxito de las transacciones mediante consultas curl o navegadores web.

Qsilver · 9 de enero de 2024.

Creé un servicio de archivo dual de txid y bxid que es accesible usando curl o incluso un navegador web. Los datos de txid del epoch 83 y los datos de bxid del epoch 90 están en el archivo. Tanto los datos de txid como de bxid se actualizan cada minuto.

Esto permitirá una integración mucho más fácil de Qubic en los servicios criptográficos existentes, ya que se vuelve mucho más sencillo determinar si una transacción tuvo éxito. ADVERTENCIA: Este es solo un servidor de prueba y no para uso en producción, pero debería ser suficiente para depurar la lógica de depósito/retiro.

Uso de la utilidad bxid

Si tienes los detalles importantes de la transacción, puedes calcular directamente el bxid con el comando calcbxid de la utilidad bxid:

./bxid calcbxid epoch tick source dest amount

Encuentra más detalles en: qubic-cli/bxid.cpp at main · Qsilver97/qubic-cli (github.com)

Recuperación de datos de transacciones

Alternativamente, una vez que tengas un txid, puedes obtener sus datos después de que estén incluidos en el tick especificado con:

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

o simplemente usar un navegador web.

Asumiendo que la transacción fue incluida en el tick, aparecerá y tendrá un campo “bxid”. Busca ese bxid con:

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

Si obtienes un retorno válido, significa que la transacción se completó con éxito. Si no se encuentra, suponiendo que el archivo esté actualizado, significa que la transacción fue incluida en un tick pero falló (por ejemplo, enviaste más QU de lo que había en el saldo).

Para asegurarte de que tu transacción está “confirmada”, verifica el bxid. No hay un concepto real de confirmaciones en Qubic, ya que se vuelve instantáneamente final. Tan pronto como el bxid está disponible, es seguro asumir que los fondos fueron transferidos por el txid.

Búsqueda avanzada

Aunque no es necesario para la validación de transacciones, puedes buscar cualquier campo en el conjunto de datos de txid o bxid usando el endpoint _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

Se pueden devolver diferentes resultados, ya que puedes tener txid que no transfieren ningún valor además de fallos de transacción. Muchas transacciones usan valor cero con datos extra, y eso se puede ver en la salida de txid.

Para más detalles, consulta la Documentación de OpenSearch sobre Búsqueda.

Para obtener las últimas actualizaciones, únete al Discord de Valis, síguenos en X y guarda nuestro blog en tus favoritos.

En esta página

• Probar el servidor de API bxid/txid
• Uso de la utilidad bxid
• Recuperación de datos de transacciones
• Búsqueda avanzada

Artículos relacionados