Transacciones de Bridge (Diario)
Requisitos previos de acceso
- Permiso (módulo):
viewBridgeJournal - Licencia/Feature: Ninguna
- Contenedor del menú: GENERAL → grupo Diarios de transacciones → Transacciones de Bridge (
/bridge-journal)
Qué es / cuándo usar
El bridge mueve activos entre diferentes redes blockchain (ej.: token en Ethereum → token en Polygon). Este diario lista cada transacción de puente con la red de origen y destino, el activo de entrada y el de salida, los valores y el estado actual del enrutamiento. El operador usa la pantalla para seguir una transferencia cross-chain de un usuario, diagnosticar puentes pendientes/expirados y abrir el detalle técnico para soporte.
Requisitos previos
- Permiso:
viewBridgeJournalregistrado para el rol (permiso doble — enum CPM + módulo dinámico en la BD). - Licencia/Feature: ninguna.
- Dependencias de otras pantallas: Ninguna. Las redes y los tokens disponibles se cargan del propio backend al abrir la pantalla.
Paso a paso
- Acceda a Diarios de transacciones → Transacciones de Bridge.
- La pantalla carga la lista de redes (excepto la red
INTERNAL) y los tokens, y ya busca las primeras transacciones. - Busque por ID de usuario en el campo de búsqueda (la escritura tiene debounce de 500 ms).
- Filtre por red y por estado en los selectores. El valor "Todas" elimina el filtro de red.
- Haga clic en el ícono de visualizar (ojo) para abrir el detalle técnico del puente.
Filtros y columnas
| Filtro / Columna | Qué muestra / hace | Origen del dato |
|---|---|---|
| Búsqueda por ID de usuario | Filtra por los puentes de un customerId. Debounce de 500 ms. | Parámetro customerId enviado al BridgeService. |
| Filtro de red | Restringe por red; envía el chain_id de la red seleccionada. "Todas" no filtra. | CollectionsService.getNetworks() (excluye INTERNAL). |
| Filtro de estado | ALL, FILLED, PENDING, PLANNED, REFUNDED, EXPIRED, SLOW_FILL_REQUESTED. | BridgeTransactionStatus. |
Fecha (createdAt) | Cuándo se creó el puente. | createdAt. |
| Id | Identificador de la transacción de bridge. | id. |
Usuario (userId) | Propietario de la transacción. | userId. |
Monto de entrada (inputAmount) | Cantidad enviada en la red de origen. | inputAmount (formateado vía BigNumber). |
Monto de salida (outputAmount) | Cantidad recibida en la red de destino. | outputAmount (formateado vía BigNumber). |
| Red de origen / destino | Nombre de la red resuelto a partir del chainId. | originChainId / destinationChainId. |
| Token de entrada / salida | Símbolos de los activos transaccionados. | inputTokenSymbol / outputTokenSymbol. |
| Estado | Estado del enrutamiento; verde para FILLED, rojo para EXPIRED/REFUNDED. | status. |
| Detalles (acción) | Abre el modal técnico del puente. | openDetailsComponent(id). |
La paginación es server-side: el paginador usa el total_count retornado por el backend.
Acciones y modales
- Visualizar (ojo): abre
BridgeDetailsModalComponenten pantalla completa, con los datos completos de la transacción de puente (solo lectura).
Reglas de negocio / consideraciones
Atención
- La diferencia entre el monto de entrada y el monto de salida refleja costos/enrutamiento del puente (gas, tarifas del proveedor, slippage). No interprete la diferencia como un error.
EXPIREDyREFUNDEDindican que el activo no llegó al destino — enREFUNDEDel usuario recibe el valor de vuelta en el origen. Use el detalle para confirmar el desenlace antes de orientar al cliente.SLOW_FILL_REQUESTEDes un estado intermedio de llenado lento — el puente aún puede completarse; no lo trate como falla definitiva.
- Valores financieros: entrada y salida se tratan como BigNumber — sin redondeo en el origen; la visualización usa 2 decimales solo para lectura.