Sincronizaciones de Depósitos

Requisitos previos de acceso

• Permiso (módulo): viewDeposits
• Licencia/Feature: DEPOSITS_HANDLING
• Contenedor del menú: GENERAL → grupo Operaciones

Qué es / cuándo usar

Herramienta de reprocesamiento de bloques de la blockchain. El watcher de depósitos lee continuamente los bloques de las redes (EVM) para detectar depósitos on-chain y acreditar a los usuarios. Cuando un bloque no fue procesado (caída del watcher, RPC no disponible, retraso de red) y un depósito on-chain no apareció en la billetera del cliente, el operador indica la red y el número de bloque para forzar el reprocesamiento de ese bloque y capturar la transacción faltante.

Requisitos previos

• Permiso: viewDeposits (permiso doble — enum CPM + módulo dinámico en DB).
• Licencia/Feature: DEPOSITS_HANDLING habilitada (sin ella el ítem ni siquiera aparece en el menú).
• Dependencias de otras pantallas: el usuario destino del depósito on-chain debe tener una billetera mapeada; el bloque debe contener una transferencia hacia una billetera monitoreada para generar el crédito.

Paso a paso

1. Acceda al menú Operaciones → Sincronizaciones de Depósitos.
2. Seleccione la Red (ej.: Ethereum, BSC, Polygon, Arbitrum, Optimism, Avalanche, Base, Moonbeam) — la lista proviene de getNetworks().
3. Ingrese el Número de bloque a reprocesar (el campo es recortado; obligatorio).
4. Confirme en enviar — llama a reprocessBlock({ network, blockNumber }).
5. Observe el feedback (snackbar) de éxito o error.

Campos

Campo	Qué es	¿Obligatorio?	Efecto en el sistema/backend
Red	Blockchain objetivo del reprocesamiento	Sí	Define la chain consultada por ExternalBlockchainProvider; valida contra la lista de redes habilitadas
Número de bloque	Bloque a reprocesar	Sí	Dispara la relectura del bloque; las transacciones hacia billeteras monitoreadas generan un crédito vía FMS (idempotente por txHash)

Acciones y modales

• Enviar: valida el formulario, aplica trim al número de bloque y llama a reprocessBlock. En caso de éxito, limpia el formulario; en caso de error, muestra el mensaje devuelto por el backend.

Reglas de negocio / precauciones

Atención

• Ingrese el número de bloque exacto. Reprocesar el rango incorrecto no creará el crédito faltante.
• Si la lista de redes no carga, la pantalla muestra un error — verifique la disponibilidad del servicio antes de intentar reprocesar.
• La moneda fiduciaria predeterminada del tenant y el puente USD→EUR afectan la lectura/conciliación de los montos acreditados.

• Valores financieros: tratados como BigNumber — sin redondeo.
• Idempotencia: el watcher es idempotente por txHash — reprocesar el mismo bloque varias veces no duplica el crédito. Si FinLib devuelve E00021 "already processed", ese depósito ya había sido acreditado (éxito).
• Estado APPROVED: el crédito al usuario presupone un usuario con estado APPROVED.

Pantallas relacionadas

• Gestionar Pagos Manuales
• Gestionar Retiros
• Volver al índice Financiero