Documentação

Español

Português
English

Español

Português
English

Appearance

Gestionar Tokens ​

Requisitos previos de acceso

  • Permiso (módulo): manageToken (la pantalla también se muestra para perfiles con viewTokens, en modo de solo lectura)
  • Licencia/Feature: MANAGE_TOKENS
  • Contenedor del menú: TOKENIZACIÓN → grupo Tokenización

Qué es / cuándo usar ​

Es el catálogo central de tokens fungibles de la plataforma (stablecoins, tokens utilitarios, monedas de respaldo, tokens de recompensa, etc.). Desde aquí el operador crea, edita, visualiza y desactiva tokens, actualiza cotizaciones, configura pares de swap y de trading, y abre el reporte financiero de cada token.

El listado muestra solo tokens "operables": los tokens marcados como solo cotización (only_quote = true) se filtran y aparecen en la pantalla Gestionar Cuotas.

Requisitos previos ​

  • Permiso: manageToken registrado para el rol del operador. Recuerde que el permiso es doble — el enum estático en el CPM (decorator del backend) y el módulo dinámico en la base de datos (flag que habilita el ítem en el menú). Si solo uno de los dos está presente, o la acción falla (403) o el ítem no aparece.
  • Licencia/Feature: MANAGE_TOKENS habilitada en la licencia del tenant (Vault). Si está deshabilitada, el grupo Tokenización ni siquiera aparece en el menú.
  • Dependencias: para definir la red (network_id) del token, las redes deben estar previamente registradas (consultadas vía getNetworks).

Paso a paso ​

  1. Acceda al menú Tokenización → Gestionar Tokens.
  2. Use la búsqueda por nombre y el filtro de red para localizar un token.
  3. Mediante los íconos de acción de cada fila puede: visualizar, editar, actualizar cotización, configurar swap (solo si el token tiene swap automático habilitado), gestionar pares de trading y abrir el reporte financiero.
  4. Use Crear token para iniciar el formulario en blanco.

Filtros y columnas ​

Filtro / ColumnaQué muestraOrigen del dato
Búsqueda por nombreFiltra la lista por el name del token (sin distinción de mayúsculas)Lista local ya cargada de getTokens()
RedFiltra por network_id (ej.: INTERNAL, POLYGON, ETHEREUM, BITCOIN, TRON, SOLANA)getNetworks(true)
NombreIdentificación visual del token (sigla + nombre)tokens_all (TokenController)
RedBlockchain donde vive el token / será minteadonetwork_id
AccionesÍconos: visualizar, editar, cotización, swap, pares, reporte financiero—

Acciones y modales ​

  • Crear token: navega al formulario de creación (ver Crear Tokens).
  • Editar / Visualizar: abre el formulario en el modo correspondiente; ver Editar Tokens.
  • Actualizar cotización: abre el modal de cotización; ver Editar Cotización de Tokens. La nueva tasa se guarda vía storeExchangeRateInformation (fecha, moneda de referencia y tasa).
  • Configurar swap: solo se activa si isAutomaticSwap = true en el token; abre el modal de pares de swap. Ver Gestión de Swap.
  • Gestionar pares de trading: abre la pantalla de pares de exchange interna del token.
  • Reporte financiero: abre el reporte de ventas (manual + automático) del token por período.
  • Eliminar / desactivar: la eliminación lógica se realiza mediante la edición (completando la fecha disabled), preservando el historial on-chain y contable.

Reglas de negocio / consideraciones ​

Atención

  • La sigla (id) y el nombre del token son inmutables tras la creación — definen la identidad del token en el libro mayor y on-chain. Verifique con cuidado antes de guardar.
  • Los tokens de solo cotización no aparecen aquí; se gestionan en Gestionar Cuotas.
  • Bloqueos como el bloqueo cambiario (exchange_lock) solo pueden activarse en la creación y no pueden deshacerse.
  • Valores financieros: cotización, tasas, supply y precios se tratan como BigNumber — sin redondeo. Verifique los decimales (decimals) configurados en el token.

Pantallas relacionadas ​