Verificación en Blockchain

Verificar un Registro

Los usuarios autenticados pueden verificar cualquier registro anclado en blockchain desde la plataforma, y las contrapartes pueden verificar los mismos registros en la página de verificación pública sin iniciar sesión. La verificación confirma que el documento no ha sido alterado desde que fue anclado: la plataforma vuelve a calcular el hash SHA-256 del documento actual y lo compara con el hash registrado en el blockchain. Una coincidencia indica que el documento no ha sido modificado; una discrepancia indica que ha sido modificado desde el anclaje.

Lo que aprenderás

Cómo verificar un registro anclado desde un caso
Qué se necesita para realizar la verificación (en la app vs. verificación pública)
Qué significa una verificación exitosa frente a una fallida
Cómo buscar un registro por hash de transacción o ID de entidad
Cómo funciona el sistema de reintentos y transacciones pendientes

Requisito de autenticación

Vilulia ofrece dos rutas de verificación. Las contrapartes que reciben un registro anclado pueden verificarlo en la página pública en /verifysin necesidad de cuenta ni inicio de sesión, mediante hash de transacción, ID de acuerdo, ID de laudo, o enviando un hash para comparación. La API de verificación dentro de la app es independiente: requiere autenticación, acceso al caso o entidad, y la función blockchain_verification en tu plan.

Verificación desde un registro de caso

Para los laudos arbitrales, el estado de verificación en blockchain se muestra directamente en la pestaña Laudosdel caso. Una vez que un laudo es emitido y anclado, el panel muestra el hash de transacción (tx_hash), número de bloque, fecha y hora de confirmación, nombre de la red y un enlace para ver la transacción en PolygonScan. Si un laudo aún no ha sido anclado, se muestra un botón Verificar en Blockchainque inicia el anclaje. No existe una pestaña de Verificación separada en el registro del caso.

La verificación es compatible con acuerdos, laudos, documentos (solo finales/ejecutados) y certificados de capacitación. Las cargas de evidencia, borradores y documentos de trabajo no se registran en la cadena.

Códigos QR en certificados de capacitación

Los certificados de capacitación en PDF incluyen un código QR que codifica una URL de verificación con el formato https://vilulia.com/verify/{verification_code}. Escanear el código QR abre una consulta de verificación pública para ese certificado, que devuelve el nombre del titular, el título del curso y la fecha de emisión. No se requiere inicio de sesión.

Verificación por hash de transacción o ID de entidad

Cualquier registro anclado puede verificarse por hash de transacción (GET /api/v1/blockchain/tx/{tx_hash}) o por tipo de entidad e ID (por ejemplo, GET /api/v1/blockchain/settlement/{id}, GET /api/v1/blockchain/award/{id}, GET /api/v1/blockchain/document/{id}, o GET /api/v1/blockchain/certificate/{id}). La página de verificación pública cubre un subconjunto de estas sin inicio de sesión: GET /verify/tx/{tx_hash}, GET /verify/settlement/{id}, y GET /verify/award/{id}. Los administradores también pueden consultar la página de Historial de Verificación en Blockchain en el panel de administración, que lista todos los registros anclados en una tabla filtrable y paginada con soporte de exportación a CSV.

Transacciones pendientes

Cuando una transacción es enviada a la red Polygon pero la confirmación agota el tiempo límite, el sistema la guarda como pendiente y una tarea en segundo plano continúa monitorearla. El estado del anclaje puede consultarse mediante GET /api/v1/blockchain/anchor-status/{log_id} o por entidad usando GET /api/v1/blockchain/anchor-status/by-entity/{type}/{id}. Los valores de estado son: pending, processing, submitted, confirmed, y failed.

Lógica de reintentos

El sistema de anclaje reintenta automáticamente los fallos transitorios (errores de red, tiempos de espera agotados, límites de velocidad, respuestas 5xx) usando retroceso exponencial con jitter completo, hasta tres intentos por defecto. Los fallos permanentes (fondos insuficientes, firma inválida, ejecución revertida) no se reintentan. Si se agotan todos los reintentos, el registro se marca como fallido y puede reenviarse manualmente.

Resultados de la verificación

Un resultado verificadosignifica que el hash SHA-256 del documento actual coincide con el hash registrado en el blockchain Polygon en el momento del anclaje, confirmando que el documento no ha sido modificado. Una verificación fallidasignifica que los hashes no coinciden, lo que indica que el contenido del documento difiere de lo que fue anclado. Una verificación fallida debe investigarse de inmediato.

Si el servicio de blockchain no está disponible en el momento de la verificación, la plataforma recurre a comparar el hash esperado con el hash almacenado localmente en la base de datos y lo indica en la respuesta.