Transações de Bridge (Jornal)
Pré-requisitos de acesso
- Permissão (módulo):
viewBridgeJournal - Licença/Feature: Nenhuma
- Contêiner do menu: GERAL → grupo Jornais de transações → Transações de Bridge (
/bridge-journal)
O que é / quando usar
A bridge move ativos entre redes blockchain diferentes (ex.: token na Ethereum → token na Polygon). Este jornal lista cada transação de ponte com a rede de origem e destino, o ativo de entrada e o de saída, os valores e o status atual do roteamento. O operador usa a tela para acompanhar uma transferência cross-chain de um usuário, diagnosticar pontes pendentes/expiradas e abrir o detalhe técnico para suporte.
Pré-condições
- Permissão:
viewBridgeJournalcadastrado para a role (permissão dupla — enum CPM + módulo dinâmico no DB). - Licença/Feature: nenhuma.
- Dependências de outras telas: Nenhuma. As redes e os tokens disponíveis são carregados do próprio backend ao abrir a tela.
Passo a passo
- Acesse Jornais de transações → Transações de Bridge.
- A tela carrega a lista de redes (exceto a rede
INTERNAL) e os tokens, e já busca as primeiras transações. - Pesquise por ID do usuário no campo de busca (a digitação tem debounce de 500 ms).
- Filtre por rede e por status nos seletores. O valor "Todas" remove o filtro de rede.
- Clique no ícone de visualizar (olho) para abrir o detalhe técnico da ponte.
Filtros e colunas
| Filtro / Coluna | O que mostra / faz | Origem do dado |
|---|---|---|
| Busca por ID do usuário | Filtra pelas pontes de um customerId. Debounce de 500 ms. | Parâmetro customerId enviado ao BridgeService. |
| Filtro de rede | Restringe pela rede; envia o chain_id da rede selecionada. "Todas" não filtra. | CollectionsService.getNetworks() (exclui INTERNAL). |
| Filtro de status | ALL, FILLED, PENDING, PLANNED, REFUNDED, EXPIRED, SLOW_FILL_REQUESTED. | BridgeTransactionStatus. |
Data (createdAt) | Quando a ponte foi criada. | createdAt. |
| Id | Identificador da transação de bridge. | id. |
Usuário (userId) | Dono da transação. | userId. |
Valor de entrada (inputAmount) | Quantia enviada na rede de origem. | inputAmount (formatado via BigNumber). |
Valor de saída (outputAmount) | Quantia recebida na rede de destino. | outputAmount (formatado via BigNumber). |
| Rede de origem / destino | Nome da rede resolvido a partir do chainId. | originChainId / destinationChainId. |
| Token de entrada / saída | Símbolos dos ativos transacionados. | inputTokenSymbol / outputTokenSymbol. |
| Status | Estado do roteamento; verde para FILLED, vermelho para EXPIRED/REFUNDED. | status. |
| Detalhes (ação) | Abre o modal técnico da ponte. | openDetailsComponent(id). |
A paginação é server-side: o paginador usa o total_count retornado pelo backend.
Ações e modais
- Visualizar (olho): abre
BridgeDetailsModalComponentem tela cheia, com os dados completos da transação de ponte (somente leitura).
Regras de negócio / cuidados
Atenção
- A diferença entre valor de entrada e valor de saída reflete custos/roteamento da ponte (gas, taxas de provedor, slippage). Não interprete a diferença como erro.
EXPIREDeREFUNDEDindicam que o ativo não chegou ao destino — emREFUNDEDo usuário recebe o valor de volta na origem. Use o detalhe para confirmar o desfecho antes de orientar o cliente.SLOW_FILL_REQUESTEDé um estado intermediário de preenchimento lento — a ponte ainda pode concluir; não trate como falha definitiva.
- Valores financeiros: entrada e saída são tratados como BigNumber — sem arredondamento na origem; a exibição usa 2 casas apenas para leitura.