Compras de tokens e NFTs (Jornal)
Pré-requisitos de acesso
- Permissão (módulo):
viewBuyTokensJournal - Licença/Feature: Nenhuma
- Contêiner do menu: GERAL → grupo Jornais de transações → Compras de tokens e NFTs (
/buy-tokens-journal)
No menu, este item pode aparecer rotulado como "Transações de NFTs"; tecnicamente é a trilha de compra (buy track) de qualquer ativo tokenizado vendido pela plataforma — tokens e NFTs.
O que é / quando usar
Registra cada venda/compra de ativo tokenizado (buy track): quem comprou, qual ativo (asset_id), por qual preço e em qual moeda. O operador usa para auditar uma compra específica, conferir para qual carteira o ativo foi entregue, e verificar dois marcadores importantes do fluxo: se o dono/captador foi pago (paid_owner) e se houve chamada ao serviço de blockchain/PGH (pgh_call).
Pré-condições
- Permissão:
viewBuyTokensJournal(permissão dupla — enum CPM + módulo dinâmico no DB). - Licença/Feature: nenhuma.
- Dependências de outras telas: Nenhuma. A trilha é alimentada pela auditoria de compra de ativos do OrderBook/OBS.
Passo a passo
- Acesse Jornais de transações → Compras de tokens e NFTs.
- A listagem carrega paginada do servidor.
- Pesquise por ID do cliente ou ID do ativo no campo de busca (debounce de 500 ms).
- Clique em Ver detalhes para abrir o modal com a trilha completa.
Filtros e colunas
| Filtro / Coluna | O que mostra / faz | Origem do dado |
|---|---|---|
| Busca (cliente ou ativo) | Filtra por customerId ou assetId. Debounce 500 ms. | Parâmetro search. |
Data (when) | Quando a compra ocorreu. | when. |
Ativo (assetId) | Identificador do ativo comprado. | asset_id. |
Cliente (customerId) | Comprador. | customer_id. |
Preço (price) | Valor pago, com a unidade monetária. | price (BigNumber) + unit_of_money. |
| Ações | Abre o detalhe completo. | openTransactionDetails(buyTrack). |
Campos do modal de detalhes
| Campo | O que mostra | Efeito/leitura |
|---|---|---|
| ID da transação | Identificador da trilha. | Chave para suporte/auditoria. |
Ativo (asset_id) | Ativo vendido. | — |
| Cliente de origem | E-mail do comprador (resolvido) ou o customer_id cru. | A UI resolve o e-mail buscando os usuários. |
| Cliente de destino | E-mail/ID do recebedor, quando a compra entrega a outro usuário. | customer_id_to. |
| Carteira de destino | Carteira para a qual o ativo foi entregue. | wallet_id_to. |
| ID na blockchain | Referência on-chain do ativo, quando aplicável. | blockchainId. |
| Moeda / Preço | Unidade e valor da compra. | unit_of_money / price. |
Dono pago (paid_owner) | Indica se o repasse ao dono/captador do ativo já foi liquidado. | Sim/Não — útil para conciliar o lado da casa/captador. |
Chamada PGH (pgh_call) | Indica se a operação acionou o serviço de blockchain (PGH) para efetivar a entrega on-chain. | Sim/Não — distingue compras já efetivadas on-chain das puramente internas. |
Data (when) | Momento da compra. | — |
Ações e modais
- Ver detalhes: abre
BuyTrackDetailsModalComponent(840 px), somente leitura. Resolve e-mails de comprador e recebedor a partir do cadastro de usuários.
Regras de negócio / cuidados
Atenção
paid_owner = Nãonuma compra concluída sinaliza repasse pendente ao dono/captador — cruze com Distribuições/Comissões antes de orientar.pgh_call = Nãoindica que a entrega on-chain ainda não foi acionada (ou a compra é puramente interna). Em ativos que exigem on-chain, isso pode indicar trabalho pendente do watcher.- O valor de venda reflete o preço da operação; em mercados com book, a receita da casa nasce do spread entre preço-limite e preço de execução — não é visível diretamente nesta linha, conferir nos jornais financeiros.
- Valores financeiros:
priceé BigNumber — sem arredondamento na origem; a UI formata em 2 casas para leitura.