Documentação

Português

English
Español

Português

English
Español

Appearance

Gerenciar Tokens ​

Pré-requisitos de acesso

  • Permissão (módulo): manageToken (a tela também é exibida para perfis com viewTokens, em modo de leitura)
  • Licença/Feature: MANAGE_TOKENS
  • Contêiner do menu: TOKENIZAÇÃO → grupo Tokenização

O que é / quando usar ​

É o catálogo central de tokens fungíveis da plataforma (stablecoins, tokens utilitários, moedas-lastro, tokens de recompensa, etc.). A partir daqui o operador cria, edita, visualiza e desativa tokens, atualiza cotações, configura pares de swap e de trading e abre o relatório financeiro de cada token.

A listagem mostra apenas tokens "operáveis": tokens marcados como somente cotação (only_quote = true) são filtrados e aparecem na tela Gerenciar Cotas.

Pré-condições ​

  • Permissão: manageToken cadastrado para a role do operador. Lembre-se de que a permissão é dupla — o enum estático no CPM (decorator do backend) e o módulo dinâmico no banco (flag que liga o item no menu). Se só um dos dois estiver presente, ou a ação falha (403) ou o item não aparece.
  • Licença/Feature: MANAGE_TOKENS habilitada na licença do tenant (Vault). Se desabilitada, o grupo Tokenização nem aparece no menu.
  • Dependências: para definir a rede (network_id) do token, as redes precisam estar previamente cadastradas (consultadas via getNetworks).

Passo a passo ​

  1. Acesse o menu Tokenização → Gerenciar Tokens.
  2. Use a busca por nome e o filtro de rede para localizar um token.
  3. Pelos ícones de ação de cada linha você pode: visualizar, editar, atualizar cotação, configurar swap (apenas se o token tiver swap automático ligado), gerenciar pares de trading e abrir o relatório financeiro.
  4. Use Criar token para iniciar o formulário em branco.

Filtros e colunas ​

Filtro / ColunaO que mostraOrigem do dado
Busca por nomeFiltra a lista pelo name do token (case-insensitive)Lista local já carregada de getTokens()
RedeFiltra por network_id (ex.: INTERNAL, POLYGON, ETHEREUM, BITCOIN, TRON, SOLANA)getNetworks(true)
NomeIdentificação visual do token (sigla + nome)tokens_all (TokenController)
RedeBlockchain onde o token vive / será mintadonetwork_id
AçõesÍcones: visualizar, editar, cotação, swap, pares, relatório financeiro—

Ações e modais ​

  • Criar token: navega para o formulário de criação (ver Criar Tokens).
  • Editar / Visualizar: abre o formulário no modo correspondente; ver Editar Tokens.
  • Atualizar cotação: abre o modal de cotação; ver Editar Cotação de Tokens. A nova taxa é gravada via storeExchangeRateInformation (data, moeda de referência e taxa).
  • Configurar swap: só dispara se isAutomaticSwap = true no token; abre o modal de pares de swap. Ver Gerência de Swap.
  • Gerenciar pares de trading: abre a tela de pares de exchange interna do token.
  • Relatório financeiro: abre o relatório de vendas (manual + automático) do token por período.
  • Excluir / desativar: a exclusão lógica é feita pela edição (preenchendo a data disabled), preservando o histórico on-chain e contábil.

Regras de negócio / cuidados ​

Atenção

  • A sigla (id) e o nome do token são imutáveis após a criação — definem a identidade do token no ledger e on-chain. Conferir com cuidado antes de salvar.
  • Tokens somente cotação não aparecem aqui; eles são gerenciados em Gerenciar Cotas.
  • Travas como trava cambial (exchange_lock) só podem ser ligadas na criação e não podem ser desfeitas.
  • Valores financeiros: cotação, taxas, supply e preços são tratados como BigNumber — sem arredondamento. Confira as casas decimais (decimals) configuradas no token.

Telas relacionadas ​