Introdução
O Wallet Manager permite criar transferências de saída a partir das Wallets gerenciadas na Plataforma Parfin e acompanhar todas as etapas da operação até seu desfecho.
Quando uma transferência é iniciada pela Plataforma, o Wallet Manager coordena o fluxo entre os diferentes componentes envolvidos:
Criação → Governança → AML (quando habilitado) → Provedor de Custódia → Conclusão
Cada etapa possui uma função diferente:
- Governança - verifica se a operação recebeu as aprovações exigidas pela instância;
- AML - avalia o risco do endereço de destino, quando o módulo estiver habilitado;
- o Provedor de custódia - cria, assina e processa a transferência;
- o Wallet Manager - acompanha as atualizações e apresenta o andamento em uma estrutura padronizada.
Neste artigo, é possível entender:
- o que é necessário antes de iniciar uma transferência;
- como preencher e confirmar a solicitação de transferência;
- como a Governança e o AML participam do fluxo;
- como acompanhar o andamento da operação;
- por que uma transferência pode ser rejeitada, cancelada ou falhar;
- como identificar operações criadas diretamente no provedor.
Antes de começar
Para criar uma transferência de saída, é preciso garantir que:
- as configurações necessárias foram realizadas no provedor de custódia;
- o provedor de custódia está conectado e ativo na instância;
- existe um fluxo de aprovação (governança) aplicável à transferência;
- a Wallet possui saldo disponível suficiente;
As opções disponíveis na criação podem variar conforme:
- o provedor de custódia responsável pela Wallet;
- a rede;
- o ativo;
- o tipo da Wallet;
- as funcionalidades habilitadas na integração;
- as regras e permissões configuradas diretamente no provedor.
Importante: todas as transferências de saída iniciadas pelo Wallet Manager precisam passar pelo fluxo de Governança. Sem uma Wallet Manager Policy aplicável, a transferência não pode ser criada.
Wallet Manager Policies
As regras de aprovação das transferências são configuradas em:
Governance > Wallet Manager Policies
As políticas determinam quais aprovações são necessárias para as transferências com base em informações como:
- iniciador;
- origem (provedor de custódia);
- destino;
- ativo;
- valor ou quantidade da operação.
Quando uma transferência é criada, a Plataforma avalia se existe uma política configurada (Wallet Manager Policy) que cobre as condições daquela operação.
Se nenhuma política for aplicável, a criação é bloqueada por padrão.
Quando existe uma política aplicável, o Wallet Manager permite a criação e fica aguardando as aprovações necessárias, para poder seguir para a próxima etapa.
O saldo não é reservado durante o fluxo de aprovação e AML
O Wallet Manager consulta o saldo disponível informado pelo provedor de custódia, mas não reserva nem bloqueia esse valor enquanto a transferência aguarda o fluxo de aprovação da governança e AML (quando aplicável).
Isso significa que:
- o saldo pode estar disponível no momento da criação;
- a transferência pode permanecer aguardando aprovação;
- outra operação pode utilizar parte desse saldo;
- quando a transferência for aprovada e enviada ao provedor, o saldo pode já não ser suficiente.
Por isso, uma transferência pode ser aprovada na governança e, ainda assim, ser rejeitada posteriormente pelo provedor por falta de saldo disponível.
Recomenda-se sempre verificar o saldo da Wallet antes de aprovar uma operação pendente.
Como criar uma transferência
1. Iniciando a criação
A criação da transferência pode ser acessada a partir de diferentes áreas da Plataforma, como:
Portfolio
- o cabeçalho principal da página, botão “Send”;
- ícone de envio, dentro da aba Managed Wallets;
Wallet Manager
o cabeçalho principal da página, botão “Send”;
ícone de envio, ao lado das Wallets nas páginas:
- Wallets
- Visão detalhada por ativo (Assets > Ativo selecionado)
Vault Details
ícone de envio, ao lado dos ativos listados nas Wallets da página
Dependendo do ponto de entrada, algumas informações podem vir previamente preenchidas, como a Wallet, o ativo ou a rede.
Independentemente de onde a ação for iniciada, a transferência seguirá as mesmas etapas de Governança, AML e execução no Custody Provider.
2. Selecionando os parâmetros da transferência
Escolher o ativo que será transferido.
Selecionar a origem (Provedor de custódia, Vault e Wallet).
Selecionar o destino dos ativos
- As opções habilitadas dependem da rede, do ativo, do provedor de custódia e das funcionalidades disponíveis na Plataforma.
Verificar a rede (blockchain).
Informar a quantidade da transferência.
Dependendo do provedor, da rede e do ativo, a opção do tipo de transferência estará disponível para seleção:
- valor bruto (To be sent) - é informado o valor total a ser “gasto”; as taxas da transferência serão deduzidas desse valor;
- valor líquido (To be received) - é informado o valor que chegará na wallet de destino; as taxas da transferência serão deduzidas do saldo remanescente da wallet;
Informar a prioridade (transaction fee priority) da transferência.
As taxas de uma transferência são estimadas automaticamente. Dependendo do provedor e da rede selecionados, a opção de prioridade da transferência estará disponível para seleção.
A prioridade dita a velocidade com que a transferência poderá ser confirmada na rede (blockchain):
- Alta (High) - uma taxa mais alta será aplicada para se obter uma confirmação mais rápida na rede.
- Média (Medium) - uma taxa média será aplicada para se obter uma confirmação média na rede.
- Baixa (Low) - uma taxa baixa será aplicada, porém o tempo para a confirmação será mais demorado.
Cada provedor de custódia possui uma regra para estimar a taxa da transferência. A documentação do provedor pode ser consultada para entender em detalhes como essa estimativa funciona.
3. Revisando e registrando a solicitação
Antes de confirmar, é importante revisar cuidadosamente os dados da transferência:
- Ativo;
- Wallet e provedor de custódia de origem;
- Informações do destino;
- Rede (blockchain);
- Quantidade;
- Tipo e prioridade da transferência (quando aplicável);
- Estimativa de taxa;
Após confirmar a criação, o Wallet Manager registra a solicitação e inicia o fluxo de Governança.
Confirmar a solicitação não envia imediatamente a transferência ao provedor de custódia ou à blockchain.
O que acontece depois da criação
1. Aprovação em Governance
Depois de registrada, a transferência é enviada ao motor de Governança.
Enquanto aguarda as aprovações:
- a operação ainda não foi enviada ao Custody Provider;
- nenhum ativo foi movimentado;
- o saldo não fica reservado;
- os aprovadores podem analisar a solicitação conforme a política aplicada.
Os possíveis resultados do fluxo de aprovação da governança são:
| Resultado | O que acontece |
|---|---|
| Aprovado (Approved) | A transferência segue para a próxima etapa. |
| Rejeitado (Rejected) | A transferência é encerrada como rejeitada. |
| Expired (Expirado) | O prazo de aprovação termina e a transferência não segue. |
Transferências rejeitadas ou expiradas não são enviadas ao AML nem ao Custody Provider.
2. Verificação de AML
Depois da aprovação em Governança, a transferência passa pelo AML quando o módulo estiver habilitado e for aplicável ao contexto.
No fluxo de saída, o motor de AML usa as configurações cadastradas na instância (provedor de AML conectado e perfil de risco) para avaliar o risco do endereço de destino e verificar se a transferência pode ou não seguir:
- Quando o AML estiver desabilitado ou o resultado permitir a continuidade, a transferência segue para o provedor de custódia.
- Quando o resultado impedir a operação, a transferência é encerrada sem ser criada no provedor.
Mais informações sobre o funcionamento do AML estão disponíveis no artigo: Módulo AML.
3. Envio ao provedor de custódia
Depois de concluir as etapas anteriores, o Wallet Manager envia a solicitação ao provedor de custódia responsável pela Wallet.
O provedor pode então:
- validar o saldo disponível;
- aplicar suas regras e permissões internas;
- criar a transferência;
- realizar aprovações próprias, quando existentes;
- assinar a operação;
- transmitir a transferência à blockchain;
- acompanhar as confirmações necessárias.
Os controles internos do provedor são independentes dos controles da Parfin. Uma transferência aprovada na Governança e liberada pelo AML ainda pode ser rejeitada pelo provedor de custódia.
O Wallet Manager acompanha as atualizações recebidas e converte os diferentes estados dos provedores para uma linguagem comum na Plataforma.
Como acompanhar uma transferência
As transferências podem ser consultadas pela página Activity > Crypto Transfers. Para verificar mais detalhes, é possível selecionar a transferência desejada.
Fluxo de status da transferência
O fluxo principal de uma transferência de saída é:
Created → Pending Approval → Sending to AML → Pending AML → Sending to Custody Provider → Pending Custody Provider → Completed
Esse caminho pode variar:
- se o AML estiver desabilitado, a transferência segue de Governance diretamente para o Custody Provider;
- uma falha pode encerrar a transferência em qualquer etapa;
- uma rejeição de Governance ou AML impede que a operação siga para o provedor;
- o provedor pode concluir, cancelar ou falhar a transferência;
- um status não reconhecido do provedor leva a operação para
Unknown.
Status da transferência
Os possíveis status de uma transferência estão listados a seguir:
| Status | Descrição | É um status final? |
|---|---|---|
| Created | A solicitação foi registrada pelo Wallet Manager. | Não |
| Pending Approval | A transferência aguarda o resultado das aprovações definidas pela Wallet Manager Policy aplicável. Ela ainda não foi enviada ao AML nem ao Custody Provider. | Não |
| Sending to AML | A transferência foi aprovada na Governança e está sendo enviada ao motor de AML. Esse status não ocorre quando o AML está desabilitado. | Não |
| Pending AML | A transferência aguarda o resultado da avaliação AML do endereço de destino. | Não |
| Sending to CP | O Wallet Manager está enviando a solicitação ao provedor de custódia responsável pela Wallet. | Não |
| Awaiting CP | A transferência foi criada no provedor e permanece em processamento. Enquanto o provedor enviar atualizações intermediárias, a operação continua nesse status. | Não |
| Completed | O provedor informou que a transferência foi concluída com sucesso. | Sim |
| Rejected | A operação foi impedida de continuar. Esse status pode ocorrer por rejeição na Governança ou por um resultado AML classificado como Risky. A transferência não é enviada ao provedor. | Sim |
| Canceled | A operação foi cancelada na Governança ou recebeu do provedor um resultado final equivalente a cancelamento. | Sim |
| Failed | A transferência não pôde ser concluída devido a uma falha. A falha pode ocorrer em qualquer uma das etapas da transferência. | Sim |
| Unknown | O provedor de custódia retornou um status que o Wallet Manager não conseguiu interpretar. O status original é preservado e a operação depende de avaliação técnica antes que seu resultado final possa ser confirmado. | Não |
Por que uma transferência pode não seguir
Uma operação pode ser interrompida antes de chegar à blockchain por diferentes motivos, alguns exemplos são:
- não existe uma Wallet Manager Policy aplicável;
- a solicitação foi rejeitada, cancelada ou expirou no fluxo de governança;
- o AML impediu a continuidade;
- ocorreu uma falha ou timeout na comunicação com outro serviço;
- o provedor de custódia rejeitou a solicitação;
- as credenciais da conexão não possuem a permissão necessária;
- uma regra interna do provedor não foi atendida;
Transferências criadas diretamente no provedor
O Wallet Manager também pode detectar e exibir transferências de saída criadas diretamente no sistema do provedor de custódia. Nesses casos:
- a transferência passa a ser acompanhada a partir do
- estágio em que foi detectada;
- não há aplicação retroativa da Governança da Parfin;
- não há aplicação retroativa do AML da Parfin;
- os controles próprios do provedor continuam válidos;
- alguns dados podem não estar disponíveis;
É possível identificá-las na Plataforma da Parfin consultando o campo “Source” nos detalhes da transferência. Transferências criadas diretamente no provedor de custódia exibem a informação “Custody Provider” nesse campo.
A presença da transferência na Plataforma não significa que ela tenha passado pelos controles da Parfin.
Particularidades dos provedores
Este artigo apresenta o fluxo geral das transferências de saída no Wallet Manager.
Cada provedor de custódia pode possuir diferenças relacionadas a:
- opções de prioridade de taxa;
- tipos Net ou Gross;
- aprovações internas;
- possibilidade de cancelamento;
- validação de endereços;
- estimativa e cobrança de taxas;
- status intermediários;
- tempo de processamento;
- informações exibidas;
- redes e ativos suportados;
- permissões necessárias.
Para conhecer essas particularidades, consulte:
- Parfin Custody no Wallet Manager
- Fireblocks no Wallet Manager
Saiba mais
Para aprofundar os conceitos relacionados, consulte: