Adicionar ou excluir comissão (agente)
Pré-requisitos de acesso
- Permissão (módulo):
manageToken - Licença/Feature:
STAKING_TOKENS - Contêiner do menu: GERAL → grupo Investimentos / Distribuições Financeiras → tela Aplicações de Staking
O que é / quando usar
Modal aberto pelo ícone Comissão de agente (manage_accounts) de uma aplicação de staking. Permite vincular um agente (parceiro/indicador) a uma aplicação, definindo o percentual que ele recebe sobre o valor aplicado pelo cliente. O agente passa a ser pago automaticamente conforme o contrato vigente. O modal tem duas seções: lista (agentes já vinculados) e adicionar.
Pré-condições
- O agente já deve existir no sistema (cadastro de agente). Caso contrário, o backend responde
agent not found. - Permissão:
manageToken(dupla — enum CPM no backend + módulo no DB).
Campos (aba "Adicionar")
| Campo | O que é | Obrigatório? | Efeito no sistema/backend |
|---|---|---|---|
| ID do agente | Identificador do agente a ser vinculado | Sim | Enviado como agentId a createAgentsLinkedStaking; valida existência do agente |
| Percentual | Percentual de comissão sobre o valor aplicado | Sim | Enviado como percentage; define o quanto o agente recebe; pagamento automático conforme contrato |
O botão Aplicar fica desabilitado enquanto ambos (percentual e ID do agente) não estiverem preenchidos.
Ações e modais
- Aplicar (adicionar): chama
createAgentsLinkedStaking(stakeId+agentId+percentage). Trata erros distintos:agent not foundestake not found. - Excluir (na lista): abre uma confirmação (bottom-sheet); ao confirmar, chama
deleteAgentsLinkedStakingpeloiddo vínculo.
Regras de negócio / cuidados
Atenção
- A comissão incide sobre o valor aplicado pelo usuário e o agente é pago automaticamente segundo o contrato vigente — não há lançamento manual.
- Erros são diferenciados: agente inexistente, aplicação (stake) inexistente e comissão inexistente (ao excluir).
- Valores financeiros: o percentual de comissão segue o tratamento BigNumber dos valores financeiros.