Sumário

Introdução

O Wallet Manager utiliza uma estrutura padronizada para organizar as carteiras mantidas nos diferentes provedores de custódia conectados à Plataforma Parfin.

Essa estrutura possui três níveis principais:

Vault → Wallet → Deposit Address

Cada nível possui uma função diferente:

o Vault agrupa uma ou mais Wallets;
a Wallet organiza os ativos e saldos de uma rede blockchain;
o Deposit Address é o identificador utilizado para receber ativos naquela Wallet.

Essa estrutura permite que a Plataforma apresente informações de diferentes provedores de forma consistente, mesmo quando eles utilizam modelos e nomenclaturas próprios.

Neste artigo, é possível entender o significado de cada uma dessas estruturas e como consultar suas informações na página Vault Details.

O que é um Vault

Um Vault representa, no Wallet Manager, uma estrutura agrupadora que contém uma ou mais Wallets.

Quando o provedor de custódia possui uma estrutura equivalente, o Wallet Manager a reproduz na Plataforma, preservando a organização definida no próprio provedor.

Quando o provedor não possui esse nível de organização, o Wallet Manager cria um Vault artificial apenas para representar a Wallet dentro do modelo padronizado da Plataforma.

A partir do Vault, é possível consultar de forma consolidada as Wallets, os ativos, os saldos e as transferências associados àquela estrutura.

Tipos de Vault

Como cada provedor organiza suas estruturas de custódia de uma maneira diferente, o Wallet Manager trabalha com dois tipos de Vault:

Native
Wrapper

Native

Um Vault é classificado como Native (ou nativo) quando existe uma estrutura equivalente no provedor de custódia, como é o caso da Fireblocks.

Dependendo das funcionalidades oferecidas pelo provedor, um Vault do tipo Native pode conter várias Wallets, inclusive Wallets associadas a redes diferentes.

Wrapper

Um Vault é classificado como Wrapper (ou artificial) quando o provedor não possui uma estrutura equivalente a Vault, como é o caso da custódia Parfin.

Nesse caso, o Wallet Manager cria um agrupador para representar a Wallet do provedor dentro do modelo padronizado da Plataforma.

Um Vault Wrapper possui uma relação individual com a Wallet correspondente:

1 Vault Wrapper → 1 Wallet

Como o Vault Wrapper não existe no provedor, ele não oferece ações que dependam da existência de um Vault real, como adicionar outras Wallets à mesma estrutura.

Regras importantes

Um Vault está associado a um único provedor de custódia.
Uma Wallet pertence a um único Vault.
A quantidade de Wallets permitida em um Vault depende do provedor.
Um Vault do tipo Native pode conter múltiplas Wallets, quando o provedor oferece esse modelo.
Um Vault do tipo Wrapper possui apenas uma Wallet.
O saldo exibido no Vault é uma consolidação dos saldos das Wallets que fazem parte dele.
As ações disponíveis para um Vault dependem das funcionalidades oferecidas pelo provedor e pela integração da Parfin.

O que é uma Wallet

Uma Wallet é a unidade operacional do Wallet Manager associada a uma rede blockchain.

Ela reúne as informações necessárias para operar ativos naquela rede, incluindo:

os ativos habilitados;
os saldos de cada ativo;
o saldo disponível para transferência;
os endereços utilizados para recebimento;
as transferências relacionadas àquela Wallet.

Por exemplo, um mesmo Vault pode conter uma Wallet para Ethereum, outra para Bitcoin e outra para Solana.

Cada Wallet pertence a apenas um Vault e está associada a uma única rede.

Wallet não é apenas um endereço

Embora uma Wallet possua um endereço utilizado para recebimento, os dois conceitos não são equivalentes.

A Wallet é a estrutura que organiza a operação naquela rede. Ela pode conter diferentes ativos, saldos e mais de um Deposit Address.

O Deposit Address é apenas o identificador utilizado para receber ativos dentro dessa Wallet.

Main Deposit Address

Toda Wallet possui um Main Deposit Address, utilizado como endereço principal na interface da Plataforma.

Esse é o endereço exibido diretamente abaixo do nome da Wallet na página Vault Details.

Mesmo quando a Wallet possui outros endereços de depósito, o Main Deposit Address funciona como sua referência principal na Plataforma.

Dependendo da rede e do provedor, o endereço principal pode incluir informações adicionais, como memo ou tag.

Wallet Type

Alguns provedores classificam suas Wallets por tipo. Quando essa informação estiver disponível e for relevante para a operação, ela será exibida na Plataforma como Wallet Type.

Os nomes e significados desses tipos podem variar entre os provedores. Quando a informação não for aplicável ou não estiver disponível de forma confiável, a Plataforma não deve inferir um valor.

Atualmente existem os seguintes tipos de Wallet:

Regular Wallet - Wallet convencional controlada por chaves criptográficas. Pode receber, manter e enviar ativos e, normalmente, utiliza seu próprio saldo do ativo nativo da rede para pagar as taxas de suas transações.
Gas Station - Regular Wallet que recebeu a função adicional de pagar as taxas de rede das Contract Wallets.
Contract Wallet - Wallet baseada em smart contract. Nas redes e configurações compatíveis, as taxas de suas transferências podem ser delegadas a uma Gas Station.
External Wallet - Wallet que não é controlada pelos provedores de custódia conectados à organização, mas é monitorada pelo Wallet Manager. Por estar fora do escopo de custódia desses provedores, suas informações e ações disponíveis são mais limitadas.
Unknown - Indica que o Wallet Manager não conseguiu determinar o tipo da Wallet com base nas informações disponíveis. Não representa um tipo operacional específico.

Estado da Wallet

Uma Wallet pode estar ativa, bloqueada ou indisponível para determinadas operações.

Quando uma Wallet estiver bloqueada:

o badge Blocked será exibido em seu cabeçalho;
seus ativos e saldos continuarão visíveis;
algumas ações operacionais poderão ficar indisponíveis.

O bloqueio não remove a Wallet nem apaga suas informações.

O que é um Deposit Address

Um Deposit Address é o identificador utilizado para receber ativos em uma Wallet.

Cada Deposit Address pertence a uma única Wallet e está associado à mesma rede dessa Wallet.

O formato desse identificador depende da blockchain e do modelo utilizado pelo provedor de custódia.

Endereço simples

Em algumas redes, o identificador de depósito é composto apenas pelo endereço blockchain.

Exemplo: 0x446eD7...7390A7D8

Endereço com memo ou tag

Algumas redes utilizam um endereço compartilhado e exigem uma informação adicional para identificar corretamente o destinatário.

Nesses casos, o identificador de depósito é formado por: Endereço + memo ou tag

Quando memo ou tag forem exigidos, eles fazem parte das informações de destino e devem ser utilizados junto com o endereço. Enviar ativos sem essa informação pode impedir a identificação correta do depósito pelo provedor.

Múltiplos endereços

Dependendo da rede e do provedor, uma mesma Wallet pode possuir mais de um Deposit Address.

Isso pode ocorrer, por exemplo, em redes que permitem a geração de endereços derivados ou rotacionados.

Mesmo nesses casos, um dos endereços é definido como o Main Deposit Address e utilizado como referência principal na interface.

Como as estruturas se relacionam

Considere um Vault utilizado para uma operação de tesouraria:

Nesse exemplo:

Omnibus é o Vault;
cada blockchain possui sua própria Wallet;
cada Wallet reúne os ativos habilitados naquela rede;
cada Wallet possui um endereço principal para recebimento;
o saldo total do Vault é calculado a partir dos saldos de suas Wallets.

O mesmo ativo com o mesmo SYMBOL pode aparecer em Wallets de redes diferentes. Por exemplo, USDC em Ethereum e USDC em Solana são apresentados separadamente, preservando a rede de cada posição.

Como consultar essas informações na Plataforma

A página Vault Details reúne as informações do Vault, das Wallets que pertencem a ele e das transferências on-chain relacionadas à estrutura.

Ela é dividida em três áreas principais:

informações gerais do Vault;
Wallets e seus ativos;
Transaction Explorer.

Esta página pode ser acessada de duas formas:

Menu Wallet Manager → aba Assets → Seleção do asset → Seleção da Wallet/Vault
Menu Wallet Manager → aba Wallets → Seleção da Wallet/Vault

Informações gerais do Vault

O primeiro bloco da página apresenta um resumo da estrutura que está sendo consultada:

Vault Name - Nome utilizado para identificar o Vault na Plataforma.
- A opção de edição fica disponível somente quando o provedor permite renomear essa estrutura por meio da integração.
- A presença de um nome na Plataforma não significa necessariamente que ele possa ser alterado.
Total Balance - Valor consolidado em USDdos saldos mantidos nas Wallets do Vault.
- Esse valor representa uma visão agregada. Para entender sua composição, consulte os ativos e saldos apresentados em cada Wallet.
Custody Provider - Provedor e conta responsável pela custódia das Wallets daquele Vault.
Vault Type - Indica como o Vault é representado no provedor:
- Native: existe uma estrutura equivalente no provedor;
- Wrapper: foi criado pelo Wallet Manager para representar uma Wallet de um provedor que não possui Vault.
Wallets - Quantidade de Wallets pertencentes ao Vault.
- Em um Vault Native, esse número pode ser maior que um. Em um Vault Wrapper, existe apenas uma Wallet.
Created (Data de criação) - Data e hora de criação da estrutura no provedor de custódia.
ID Number- Identificador único atribuído ao Vault pelo Wallet Manager.
- Esse identificador pertence ao modelo da Parfin e não deve ser interpretado necessariamente como o mesmo identificador utilizado pelo provedor.
Composição por ativo (gráfico) - O gráfico apresenta como o Total Balance do Vault está distribuído entre seus principais ativos. Ativos com menor participação podem ser agrupados em Others para facilitar a leitura.

Wallets do Vault

O segundo bloco da página apresenta todas as Wallets pertencentes ao Vault.

Cada Wallet possui seu próprio cabeçalho e sua própria tabela de ativos.

Quando houver várias Wallets, elas são organizadas pela rede à qual estão associadas.

Currencies e Items

As abas Currencies e Items alteram a categoria de ativos apresentada em todas as Wallets do Vault.

Currencies: apresenta ativos com informações de saldo, como Balance e Available.
Items: apresenta ativos controlados por tipo e quantidade de unidades, quando essa categoria estiver disponível.

O contador ao lado de cada tab indica a quantidade de ativos únicos da categoria encontrada no conjunto das Wallets do Vault com saldo maior do que zero.

Ao trocar de aba, todas as Wallets permanecem visíveis. Caso uma Wallet não possua ativos naquela categoria, sua estrutura continua sendo apresentada com a indicação de que não há dados disponíveis.

Informações apresentadas em cada Wallet

O cabeçalho de cada Wallet apresenta suas principais informações operacionais:

Wallet Name- Nome utilizado para identificar a Wallet.
1. A ação de edição fica disponível apenas quando o provedor e a integração permitem renomeá-la.
Network - Blockchain à qual a Wallet está associada. A rede determina quais ativos, endereços e operações podem ser utilizados naquele contexto.
Wallet Type - Classificação da Wallet no provedor, quando aplicável. Esse campo pode não aparecer em todas as Wallets.
Main Deposit Address - Endereço principal utilizado para receber ativos na Wallet.
Botão “More Options” - Abre o menu com informações e ações adicionais daquela Wallet.
- As opções apresentadas operam somente sobre a Wallet selecionada e podem variar de acordo com o provedor de custódia.

Wallets Bloqueadas

Quando uma wallet estiver bloqueada, uma tag “Blocked” será exibida.

A tabela de ativos continua disponível para consulta, mas as ações operacionais estarão desabilitadas.

Ações disponíveis para uma Wallet (botão More Options)

O menu More Options reúne ações e consultas adicionais relacionadas à Wallet selecionada.

Wallet Information

Esta opção abre uma visão somente para consulta com as principais informações da Wallet. Ela apresenta:

Informação	O que significa
Wallet Name	Nome da Wallet
Wallet ID	Identificador único atribuído pelo Wallet Manager
Wallet Type	Tipo da Wallet, quando aplicável
Network	Blockchain associada à Wallet
Main Deposit Address	Endereço principal utilizado para recebimento
Created at	Data e hora de criação da Wallet
Vault Name	Vault ao qual a Wallet pertence
Custody Provider	Provedor responsável pela custódia

Block Wallet ou Unblock Wallet

Permite solicitar o bloqueio ou desbloqueio da Wallet, quando essa funcionalidade for suportada.
Quando o provedor não oferece essa ação, ela permanece indisponível.

Deposit Addresses

Permite consultar os endereços de depósito associados à Wallet, incluindo o endereço principal e eventuais endereços adicionais.

Supported Assets

Permite consultar os ativos suportados naquela Wallet, considerando o provedor e a rede.

Ações do bloco Wallets

No cabeçalho do bloco Wallets, a Plataforma pode apresentar duas ações gerais.

New Wallet

Permite adicionar uma Wallet ao Vault atual.
Ao iniciar a ação pela página Vault Details, o Vault já é considerado como o destino da nova Wallet.
Essa opção está disponível somente quando o tipo do Vault e o provedor permitem adicionar outras Wallets.
Em um Vault Wrapper, por exemplo, não é possível adicionar uma segunda Wallet.

New Asset

Permite habilitar um novo ativo em uma Wallet existente.
Os ativos disponíveis dependem da rede, do provedor e das funcionalidades oferecidas pela integração.

Transaction Explorer

O terceiro bloco da página apresenta o Transaction Explorer consolidado do Vault.

Ele reúne as transferências on-chain concluídas das Wallets pertencentes àquela estrutura.

A tabela permite consultar informações como:

data de criação;
direção da movimentação;
origem;
destino;
ativo;
rede;
quantidade;
taxa;
hash da transação.

Como ele apresenta apenas movimentações concluídas e propagadas para a blockchain, solicitações pendentes, rejeitadas ou que não chegaram à etapa on-chain não aparecem nesse bloco.

A página permite ordenar, filtrar, atualizar e exportar essas informações.

Por que algumas ações podem não estar disponíveis

O Wallet Manager apresenta uma estrutura comum, mas os provedores não oferecem necessariamente as mesmas funcionalidades.

A disponibilidade de uma ação pode depender:

do provedor de custódia;
do tipo do Vault;
da rede da Wallet;
do ativo selecionado;
das configurações da conta no provedor;
das permissões concedidas à integração;
das funcionalidades implementadas pela Parfin.

Por isso, um botão pode aparecer habilitado para uma Wallet e indisponível para outra.

Em alguns casos, a Plataforma sabe antecipadamente que a ação não é suportada. Em outros, a ação pode ser iniciada, mas sua aceitação final depende de regras internas do provedor.

Regras e restrições importantes

Um Vault está associado a um único provedor de custódia.
Uma Wallet pertence a um único Vault.
Uma Wallet está associada a uma única rede.
Um Deposit Address pertence a uma única Wallet.
Um Vault Native pode conter múltiplas Wallets, dependendo do provedor.
Um Vault Wrapper possui apenas uma Wallet.
Uma Wallet pode possuir mais de um Deposit Address.
Toda Wallet possui um Main Deposit Address como referência principal.
Memo ou tag fazem parte do identificador de depósito quando exigidos pela rede.
Os saldos são apresentados no nível da Wallet.
O saldo do Vault é uma consolidação dos saldos de suas Wallets.
A presença de uma estrutura ou de um nome na Plataforma não significa que ele possa ser editado.
As ações disponíveis variam conforme o provedor e o contexto da operação.
Algumas informações podem levar algum tempo para aparecer após a criação ou sincronização com o provedor.

Saiba mais

Para aprofundar outros conceitos relacionados ao Wallet Manager, consulte também:

Support Portal

Como os ativos são organizados: Vaults, Wallets e Deposit Addresses Imprimir

Introdução

O que é um Vault