Introdução
O Wallet Manager permite criar Wallets em diferentes provedores de custódia por meio de um fluxo único na Plataforma Parfin.
Embora a experiência de criação seja padronizada, as opções apresentadas podem variar. Cada provedor possui seu próprio modelo de organização, suas redes suportadas e suas regras para criação de Vaults e Wallets.
Neste artigo, é possível entender:
- o que é necessário antes de iniciar;
- como preencher o formulário de criação;
- por que os campos variam entre provedores;
- o que acontece após o envio da solicitação;
- quando a nova Wallet estará disponível para uso.
Antes de começar
A ação Add Wallet está disponível apenas para administradores da instância.
A custódia Parfin já vem habilitada por padrão na Plataforma e não precisa ser conectada previamente. Ela será apresentada como opção sempre que oferecer suporte à rede selecionada.
Para utilizar outros provedores de custódia, como a Fireblocks, é necessário que eles tenham sido previamente conectados à instância e estejam ativos.
As opções disponíveis no formulário dependem:
- da rede selecionada;
- dos provedores habilitados ou conectados à instância;
- das funcionalidades oferecidas por cada provedor;
- das capacidades implementadas na integração com a Parfin.
Importante: a disponibilidade de um provedor na instância não significa que ele ofereça suporte a todas as redes ou a todos os tipos de Wallet.
Cada solicitação cria uma Wallet associada a uma única rede. Para criar Wallets em redes diferentes, é necessário realizar uma nova solicitação para cada rede.
A criação de Wallets e Vaults não passa por um fluxo de aprovação dentro da Plataforma da Parfin.
Onde iniciar a criação
A criação é iniciada ao selecionar Add Wallet em uma das telas onde essa ação estiver disponível, como:
- Wallet Manager > Assets;
- Visão detalhada por ativo;
- Wallet Manager > Wallets;
- Vault Details.
Independentemente do ponto de entrada, a Plataforma utiliza o mesmo fluxo de criação.
Quando a ação for iniciada a partir de Vault Details, o Vault consultado poderá vir previamente considerado, desde que seja compatível com o provedor e com a criação da nova Wallet.
Como o formulário de criação é definido
O formulário de criação é dinâmico.
Os campos e as opções apresentados mudam de acordo com a rede, o provedor selecionado e as funcionalidades disponíveis naquele contexto.
A Plataforma pode, por exemplo:
- permitir a escolha do tipo de Wallet;
- solicitar ou gerar automaticamente o nome da Wallet;
- permitir a seleção de um Vault existente;
- permitir a criação de um novo Vault;
- criar automaticamente um Vault Wrapper;
- ocultar opções que não são compatíveis com a rede ou com o provedor.
Passo a passo
1. Selecionar a Network
No campo Network, deve ser selecionada a blockchain na qual a Wallet será criada.
A rede selecionada determina:
- quais provedores poderão ser utilizados;
- quais tipos de Wallet estarão disponíveis;
- quais ativos são suportados;
- quais campos serão apresentados no restante do formulário.
Ao alterar a rede, as demais opções podem ser atualizadas automaticamente.
2. Selecionar o Custody Provider
No campo Custody Provider, deve ser selecionado o provedor no qual a Wallet será efetivamente criada.
A lista pode incluir:
- a Parfin, habilitada por padrão na instância;
- Contas de outros provedores conectados e ativos que ofereçam suporte à rede selecionada.
A escolha do provedor determina:
- onde as chaves e a Wallet serão gerenciadas;
- como Vaults e Wallets serão organizados;
- quais tipos de Wallet poderão ser criados;
- quais informações precisarão ser preenchidas;
- quais funcionalidades ficarão disponíveis depois da criação.
3. Consultar os Supported Assets
O bloco Supported Assets apresenta os ativos que o provedor oferece para a rede selecionada.
Essa informação ajuda a confirmar se o contexto escolhido é compatível com os ativos que a organização pretende utilizar.
4. Escolher o Wallet Type
Quando houver mais de um tipo disponível para a combinação de rede e provedor selecionada, o formulário apresentará o campo Wallet Type.
Para mais informações sobre os tipos de Wallet existentes, consulte o artigo: Vaults, Wallets e Deposit Addresses.
5. Informar o Wallet Name
O campo Wallet Name deve ser preenchido, quando estiver disponível.
O nome é utilizado para identificar a Wallet na Plataforma e, quando suportado, no próprio provedor.
Dependendo do modelo do provedor:
- o nome poderá ser informado pelo usuário;
- o nome poderá ser gerado automaticamente;
- o campo poderá aparecer desabilitado;
- a Wallet poderá herdar uma nomenclatura baseada no Vault.
As regras específicas de nomenclatura devem ser consultadas na documentação do provedor utilizado.
6. Definir o Vault
A forma como o Vault é definido depende do modelo do provedor.
6.1 Quando o provedor possui Vault nativo
Se o provedor possui uma estrutura própria equivalente a Vault, a Plataforma irá permitir escolher entre:
- criar a Wallet em um novo Vault (New Vault);
- adicionar a Wallet a um Vault já existente (Existing Vault).
Novo Vault (New Vault)
- É necessário selecionar New Vault e informar o Vault Name.
- A Plataforma solicitará ao provedor a criação do novo Vault e da Wallet associada a ele.
Vault Existente (Existing Vault)
- É necessário selecionar Existing Vault e escolher uma das opções apresentadas.
- A lista exibirá os Vaults já existentes no provedor selecionado.
- A nova Wallet será criada dentro do Vault escolhido.
6.2 Quando o provedor não possui Vault nativo
Se o provedor não possui uma estrutura equivalente a Vault, não é necessário selecionar nem criar um Vault manualmente.
Nesse caso, o Wallet Manager:
solicita a criação da Wallet ao provedor;
cria automaticamente um Vault Wrapper para representá-la no modelo padronizado da Plataforma;
associa o Vault Wrapper à Wallet em uma relação de 1:1
- A estrutura resultante é: 1 Vault Wrapper → 1 Wallet
O nome do Vault Wrapper será gerado automaticamente a partir do nome da Wallet.
O Vault Wrapper existe somente no Wallet Manager e não representa a criação de um Vault real no provedor.
7. Finalizar a criação da Wallet
Depois de preencher os campos obrigatórios, é necessário selecionar Create Wallet e informar o 2FA.
Algumas regras específicas somente podem ser avaliadas pelo próprio provedor depois que a solicitação é enviada.
Exemplo de criação de uma wallet na custódia da Parfin:
Exemplo de criação de uma wallet na Fireblocks:
O que acontece depois de selecionar Create Wallet
A criação não é necessariamente concluída no momento em que a solicitação é enviada.
O Wallet Manager acompanha o processamento até que a Wallet:
- seja criada no provedor;
- seja sincronizada com a Plataforma;
- esteja disponível para uso.
O feedback apresentado dependerá da resposta do provedor:
Criação concluída - Quando o provedor confirma a criação durante o próprio fluxo, a Plataforma apresenta a mensagem de sucesso com os dados da nova wallet.
Criação em processamento - Alguns provedores precisam de mais tempo para concluir a criação ou disponibilizar todas as informações da Wallet.
- Nesse caso, a Plataforma apresenta a mensagem informando que a wallet está em processo de criação.
- A Plataforma acompanha a solicitação e atualiza as informações automaticamente quando a criação for concluída.
- Enquanto estiver em processamento, a Wallet não é exibida nas listagens; ela aparece apenas após a confirmação de sua criação.
Particularidades de cada provedor
Este artigo apresenta o comportamento geral do fluxo Add Wallet.
Os provedores podem possuir regras específicas para:
- organização de Vaults e Wallets;
- redes suportadas;
- Wallet Types disponíveis;
- criação em Vault novo ou existente;
- definição e geração de nomes;
- disponibilização do endereço;
- ativos suportados;
- ações disponíveis depois da criação;
- restrições e permissões exigidas.
Para conhecer essas particularidades, consulte:
- Parfin Custody no Wallet Manager
- Fireblocks no Wallet Manager
Saiba mais
Para aprofundar outros conceitos relacionados, consulte: