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:

  1. o saldo pode estar disponível no momento da criação;
  2. a transferência pode permanecer aguardando aprovação;
  3. outra operação pode utilizar parte desse saldo;
  4. 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

  1. Escolher o ativo que será transferido.

  2. Selecionar a origem (Provedor de custódia, Vault e Wallet).

  3. 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.
  4. Verificar a rede (blockchain).

  5. 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;
  6. 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:

ResultadoO 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:

StatusDescriçãoÉ um status final?
CreatedA solicitação foi registrada pelo Wallet Manager.Não
Pending ApprovalA 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 AMLA 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 AMLA transferência aguarda o resultado da avaliação AML do endereço de destino.Não
Sending to CPO Wallet Manager está enviando a solicitação ao provedor de custódia responsável pela Wallet.Não
Awaiting CPA 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
CompletedO provedor informou que a transferência foi concluída com sucesso.Sim
RejectedA 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
CanceledA operação foi cancelada na Governança ou recebeu do provedor um resultado final equivalente a cancelamento.Sim
FailedA 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
UnknownO 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:


Saiba mais

Para aprofundar os conceitos relacionados, consulte: