Transações Blockchain de NFTs (Jornal)
Pré-requisitos de acesso
- Permissão (módulo):
viewNftTransactionsJournal - Licença/Feature: Nenhuma
- Contêiner do menu: GERAL → grupo Jornais de transações → Transações Blockchain de NFTs (
/nft-blockchain-transactions-journal)
O que é / quando usar
Registra os eventos on-chain de NFTs processados pela plataforma: emissão (mint), transferência (transfer) e demais movimentos do ativo na blockchain, com vendedor, comprador, ativo e o hash da transação. É a tela para confirmar que uma NFT realmente foi mintada/transferida na rede, obter o transaction_hash para consultar em um explorer, e diagnosticar entregas pendentes.
Pré-condições
- Permissão:
viewNftTransactionsJournal(permissão dupla — enum CPM + módulo dinâmico no DB). - Licença/Feature: nenhuma.
- Dependências de outras telas: Nenhuma. Os eventos vêm do TokenController/ExternalBlockchainProvider (watcher on-chain).
Passo a passo
- Acesse Jornais de transações → Transações Blockchain de NFTs.
- Preencha um ou mais filtros: ID do ativo, ID do comprador, ID do vendedor (a busca tem debounce de 400 ms; também há botões Aplicar e Limpar).
- Clique em Ver detalhes para abrir o diálogo com o hash e os dados completos do evento.
Filtros e colunas
| Filtro / Coluna | O que mostra / faz | Origem do dado |
|---|---|---|
| Filtro ID do ativo | Restringe a um asset_id. | filters.assetId. |
| Filtro ID do comprador | Restringe a um buyerId. | filters.buyerId. |
| Filtro ID do vendedor | Restringe a um sellerId. | filters.sellerId. |
Data (createdOn) | Quando o evento foi registrado. | created_on. |
Ativo (assetId) | Identificador do NFT/ativo. | asset_id. |
Tipo (transactionType) | mint, transfer (traduzido); outros tipos exibidos como vierem. | transaction_type. |
Vendedor (seller) | E-mail/nome resolvido do vendedor (ou o ID cru). | seller_id (resolvido via cadastro de usuários). |
Comprador (buyer) | E-mail/nome resolvido do comprador (ou o ID cru). | buyer_id. |
| Ações | Abre o diálogo de detalhes. | openTransactionDetails(transaction). |
Campos adicionais no diálogo
| Campo | O que mostra |
|---|---|
| ID na blockchain | nft_blockchain_id — o ID on-chain do token. |
| Hash da transação | transaction_hash — para consulta em explorer da rede. |
Motivo (reason) | Razão/contexto do evento (ex.: mint de crowdfunding, queima). |
Executado em (executed_on) | Quando o evento foi efetivado on-chain (pode diferir do created_on). |
Ações e modais
- Ver detalhes: abre
TransactionDetailsDialogComponent, somente leitura, com hash, IDs on-chain e os rótulos de comprador/vendedor já resolvidos.
Regras de negócio / cuidados
Atenção
- A diferença entre
created_on(registro) eexecuted_on(efetivação on-chain) indica latência de confirmação. Um evento comcreated_onmas semexecuted_onainda está pendente na rede. - Para NFTs de crowdfunding, o
minté exclusivo do job de crowdfunding (não há emissão avulsa pelo dono do token). Ummintaqui deve sempre ter umreasoncoerente com a origem. - Em queima de NFT, o evento on-chain pode ser um
NATIVE_BURN(contratos v2) ou uma transferência para a carteira-sumidouroBURN_SINK(v1). O comprador/destino então não é um usuário, e sim o sink — não confunda com transferência comum.
- Esta tela é somente leitura: não dispara mint/transfer/burn. Operações de emissão/queima são feitas nas telas de Tokenização.