Saldos — Tokenização
Pré-requisitos de acesso
- Permissão (módulo):
manageCorporateAccount - Licença/Feature: Nenhuma.
- Contêiner do menu: GERAL → grupo Dashboard → Saldos (aba Tokenização)
O que é / quando usar
Aba do painel de Saldos dedicada aos tokens emitidos pela plataforma (tokens de tokenização, distintos dos criptoativos de mercado). Mostra quantos usuários detêm cada token, o total em unidades, o equivalente em moeda fiduciária e a movimentação mensal — a visão patrimonial de "quanto da casa está representado em tokens emitidos".
Filtros e colunas
Tela de visualização — sem campos editáveis.
| Indicador / Gráfico | O que mostra | Origem do dado |
|---|---|---|
| Quantidade de detentores | Nº de usuários com posse do token | numberUsersInPossession (somado por token) |
| Total em tokens | Soma das unidades emitidas em posse | totalInCrypto por token |
| Total em fiduciário | Equivalente em fiat (unidades × cotação USD) | totalInCrypto × quotations.amountUsd |
| Movimentação mensal | Valor movimentado por mês, por token | monthlyMovement × cotação; série em allTokensMovementsByMonth |
| Detentores por token | Distribuição de detentores entre os tokens | agregação por ativo |
Regras de negócio / cuidados
Atenção
- Total em fiduciário usa cotação USD. Sem cotação cadastrada para o token, o multiplicador cai para 1 e o "total em fiduciário" fica igual ao total em unidades — o que distorce o consolidado. Cruze sempre com as cotações vigentes.
- Saldo nunca é zero por padrão: ausência de valor = estado de carregamento ou erro do serviço, não saldo real igual a zero.
- Valores financeiros: todas as multiplicações por cotação e somas são feitas em
BigNumber, sem arredondamento intermediário. Confira as casas decimais por token.