Documentação

Español

Português
English

Español

Português
English

Appearance

Staking ​

Requisitos previos de acceso

  • Permiso (módulo): manageToken
  • Licencia/Feature: STAKING_TOKENS habilitada en la licencia del tenant (Vault).
  • Contenedor del menú: GENERAL → grupo Productos → Staking

Qué es / cuándo usar ​

El Staking permite al operador configurar productos de rendimiento sobre tokens: el usuario bloquea (hace staking) una cantidad de un token y, periódicamente, recibe pagos de rendimiento en otro token (o en el mismo). Esta pantalla administra las configuraciones de staking (StakingConfig) — las "reglas del producto" — no las aplicaciones individuales de los usuarios (éstas se encuentran en Aplicaciones de Staking).

Úsalo para crear un nuevo producto de staking, ajustar tasas/plazos, activar/desactivar, o abrir el dashboard de un producto para dar seguimiento a las aplicaciones.

Requisitos previos ​

  • Permiso: manageToken (enum estático CPM + módulo dinámico en la DB).
  • Licencia/Feature: STAKING_TOKENS habilitada. Si está deshabilitada, el ítem ni siquiera aparece en el menú.
  • Dependencias: los tokens de stake (unit_of_money) y de pago (unit_to_pay) deben existir en la plataforma.

Paso a paso ​

  1. Accede a Productos → Staking.
  2. La lista muestra los productos por nombre, token de stake, token de pago y estado (activo/inactivo).
  3. Usa Crear para abrir el modal de configuración.
  4. Completa los campos y guarda.
  5. En cada fila, usa Editar, Dashboard (dar seguimiento a las aplicaciones) o Eliminar.

Campos (modal de configuración) ​

CampoQué es¿Obligatorio?Efecto en el sistema/backend
Nombre (name)Nombre del producto de stakingSíIdentifica la configuración.
Token de stake (unit_of_money)Token que el usuario bloqueaSíDefine el activo aceptado para staking.
Token de pago (unit_to_pay)Token en que se paga el rendimientoSíDefine el activo del payout.
Plazo (stakingLength)Duración del stakingSíDebe ser > 0 (BigNumber). Combinado con periodType.
Tipo de período (periodType)M (meses) o Y (años)SíDefault M.
Valor a aplicar (valueToApply)Tasa/porcentaje de rendimientoSíDebe ser > 0. Junto con method (siempre P = porcentaje) y thresholdToApply, gobierna el cálculo del payout.
Threshold (thresholdToApply)Valor mínimo para aplicar el rendimientoNoRango a partir del cual incide el rendimiento.
Tasa de salida (exit_fee)Multa por retiro anticipadoNoAplicada cuando hay salida antes del plazo.
Pagos mensuales (monthlyPayments)Paga rendimiento mes a mesNoPersistido como 1 (encendido) o -1 (apagado).
Permitir retiro anticipado (allowEarlyWithdraw)Permite el rescate antes del plazoNoHabilita el retiro anticipado (sujeto a exit_fee).
Hold (hold)Retención/bloqueo adicionalNoFlag de comportamiento del producto.
Términos (terms, upload)Documento de términos del productoNoUpload vía files API (máx. 30 MB); guarda la URL.
Activo (is_active)Producto disponible para nuevos stakesNoDefault true en la creación. Desactivar no cancela aplicaciones existentes; solo impide nuevas.

Acciones y modales ​

  • Crear / Editar: abre el modal StakeTokensModalComponent. Guardar permanece deshabilitado mientras falten nombre, tokens, plazo > 0 y valor > 0.
  • Dashboard: navega hacia manage-stakes/dashboard/:id para dar seguimiento a las aplicaciones del producto.
  • Eliminar: elimina la configuración (con confirmación) y recarga.
  • Ayuda: el botón de troubleshooting abre la guía de staking integrada.

Reglas de negocio / consideraciones ​

Atención

  • El plazo y el valor a aplicar deben ser > 0 (validados como BigNumber); de lo contrario el guardar queda bloqueado.
  • Desactivar un producto no afecta las aplicaciones ya realizadas — solo impide nuevas adhesiones.
  • method se fija en P (porcentaje) al guardar, aunque el modelo permita otros métodos.
  • Idempotencia: los payouts de staking son idempotentes — reprocesar un pago (tras retry/crash) es seguro; el errorCode FinLib E00021 "already processed" significa éxito.
  • Valores financieros: valor, threshold, tasa de salida y plazo se tratan como BigNumber — sin redondeo.

Ejemplos ​

Escenario 1 — Staking de 12 meses con pagos mensuales
  1. Crea un producto: token de stake = AXT, token de pago = tBRL.
  2. Plazo 12, período M (meses), valor a aplicar 1,5 (porcentaje), pagos mensuales encendidos.
  3. Sin retiro anticipado (allowEarlyWithdraw apagado).
  4. El usuario que adhiera bloquea AXT y recibe tBRL cada mes conforme al porcentaje.
Escenario 2 — Producto anual con retiro anticipado y multa
  1. Plazo 1, período Y (año), valor a aplicar 18 (porcentaje anual).
  2. allowEarlyWithdraw encendido, exit_fee 5.
  3. El usuario puede retirar antes de 1 año, pero paga 5 de multa de salida.
Escenario 3 — Pausar adhesiones sin afectar a quienes ya hicieron staking
  1. Edita el producto y desmarca Activo.
  2. Las nuevas adhesiones quedan bloqueadas; las aplicaciones en curso continúan rindiendo y pagando normalmente.

Pantallas relacionadas ​