Documentação

Português

English
Español

Português

English
Español

Appearance

Sincronismos de Depósitos ​

Pré-requisitos de acesso

  • Permissão (módulo): viewDeposits
  • Licença/Feature: DEPOSITS_HANDLING
  • Contêiner do menu: GERAL → grupo Operações

O que é / quando usar ​

Ferramenta de reprocessamento de blocos da blockchain. O watcher de depósitos lê continuamente os blocos das redes (EVM) para detectar depósitos on-chain e creditar os usuários. Quando um bloco não foi processado (queda do watcher, RPC indisponível, atraso de rede) e um depósito on-chain não apareceu na carteira do cliente, o operador informa a rede e o número do bloco para forçar o reprocessamento daquele bloco e capturar a transação faltante.

Pré-condições ​

  • Permissão: viewDeposits (permissão dupla — enum CPM + módulo dinâmico no DB).
  • Licença/Feature: DEPOSITS_HANDLING habilitada (sem ela o item nem aparece no menu).
  • Dependências de outras telas: o usuário-destino do depósito on-chain deve ter carteira mapeada; o bloco precisa conter uma transferência para uma carteira monitorada para gerar crédito.

Passo a passo ​

  1. Acesse o menu Operações → Sincronismos de Depósitos.
  2. Selecione a Rede (ex.: Ethereum, BSC, Polygon, Arbitrum, Optimism, Avalanche, Base, Moonbeam) — a lista vem de getNetworks().
  3. Informe o Número do bloco a reprocessar (o campo é trimado; obrigatório).
  4. Confirme em enviar — chama reprocessBlock({ network, blockNumber }).
  5. Acompanhe o feedback (snackbar) de sucesso ou erro.

Campos ​

CampoO que éObrigatório?Efeito no sistema/backend
RedeBlockchain alvo do reprocessamentoSimDefine a chain consultada pelo ExternalBlockchainProvider; valida contra a lista de redes habilitadas
Número do blocoBloco a reprocessarSimDispara a releitura do bloco; transações para carteiras monitoradas geram crédito via FMS (idempotente por txHash)

Ações e modais ​

  • Enviar: valida o formulário, faz trim no número do bloco e chama reprocessBlock. Em sucesso, limpa o formulário; em erro, exibe a mensagem retornada pelo backend.

Regras de negócio / cuidados ​

Atenção

  • Informe o número do bloco exato. Reprocessar a faixa errada não cria o crédito faltante.
  • Se a lista de redes não carregar, a tela exibe erro — verifique a disponibilidade do serviço antes de tentar reprocessar.
  • A moeda fiduciária padrão do tenant e a ponte USD→EUR afetam a leitura/conciliação dos valores creditados.
  • Valores financeiros: tratados como BigNumber — sem arredondamento.
  • Idempotência: o watcher é idempotente por txHash — reprocessar o mesmo bloco várias vezes não duplica crédito. Se o FinLib retornar E00021 "already processed", aquele depósito já havia sido creditado (sucesso).
  • Status APPROVED: o crédito ao usuário pressupõe usuário APPROVED.

Telas relacionadas ​