Sumário
Introdução
O Wallet Manager reúne os saldos das Wallets mantidas nos diferentes provedores de custódia conectados à Plataforma Parfin.
Como cada provedor pode utilizar nomes, estruturas e tipos de saldo diferentes, o Wallet Manager padroniza essas informações antes de apresentá-las na Plataforma. Isso permite consultar posições consolidadas sem perder a possibilidade de identificar em qual provedor, Vault e Wallet cada valor está custodiado.
Neste artigo, é possível entender:
- como o Wallet Manager representa um saldo;
- a diferença entre Balance e Available;
- como os saldos são consolidados;
- onde consultar as posições na Plataforma.
Como o Wallet Manager representa um saldo
No Wallet Manager, o saldo é registrado inicialmente no nível da Wallet.
Cada saldo está relacionado a:
- uma Wallet;
- um provedor de custódia;
- um ativo;
- uma rede;
- um tipo de saldo.
Por exemplo, o saldo de USDC mantido em uma Wallet da rede Ethereum é diferente do saldo de USDC mantido em uma Wallet da rede Solana.
Mesmo que os dois ativos utilizem o símbolo USDC, eles pertencem a redes diferentes e, por isso, são apresentados separadamente.
As informações exibidas em níveis superiores, como Vault, provedor ou instância, são consolidações derivadas dos saldos das Wallets.
A estrutura pode ser representada da seguinte forma:
- Wallet -> Saldo por ativo e rede
- Vault -> Consolidação das Wallets do Vault
- Conexão -> Consolidação das Wallets daquela conexão
- Instância -> Consolidação dos provedores conectados
Os valores partem das informações disponibilizadas pelos provedores de custódia. O Wallet Manager padroniza e consolida esses dados.
O que identifica um ativo
Na interface, um ativo costuma ser apresentado por seu símbolo e ícone, como USDC, ETH ou BTC. No entanto, o símbolo é apenas uma informação de exibição e não identifica um ativo de forma única.
Diferentes ativos podem utilizar o mesmo símbolo, inclusive dentro da mesma rede. Por isso, o Wallet Manager não utiliza somente o símbolo para determinar se dois registros representam o mesmo ativo.
A identidade considerada pela Plataforma depende do tipo do ativo:
Tipo de ativo | Como ele é identificado |
|---|---|
| Ativo nativo de uma rede | Pela rede e pelo identificador do ativo nativo. Por exemplo, ETH na Ethereum e BTC na Bitcoin. |
| Token fungível (ex.: ERC-20, SPL Tokens, TRC-20, etc) | Pela rede e pelo endereço do contrato ou identificador on-chain equivalente, como um mint address. |
| Items (ERC-1155) ou NFTs | Pela rede, pelo endereço do contrato ou identificador equivalente e, quando aplicável, pelo token ID. |
O Wallet Manager associa os ativos informados pelos diferentes provedores a uma identidade padronizada na Plataforma.
Somente os saldos associados à mesma identidade de ativo são consolidados.
Isso significa que:
- registros do mesmo token, na mesma rede e com o mesmo endereço de contrato, podem ser somados mesmo quando vierem de provedores diferentes;
- tokens com o mesmo símbolo, mas com endereços de contrato diferentes, são tratados como ativos distintos;
- tokens com o mesmo símbolo em redes diferentes também são tratados separadamente.
Exemplo:
Considere três posições apresentadas pelos provedores:
Símbolo exibido | Rede | Identificador on-chain | Saldo |
|---|---|---|---|
| USDC | Ethereum | Contrato A | 500 USDC |
| USDC | Ethereum | Contrato A | 300 USDC |
| USDC | Ethereum | Contrato B | 200 USDC |
As duas primeiras posições representam o mesmo ativo e são consolidadas em 800 USDC.
A terceira posição possui o mesmo símbolo e está na mesma rede, mas utiliza outro contrato. Portanto, ela permanece separada como um ativo diferente.
O símbolo facilita a leitura, mas não é utilizado isoladamente para identificar ou consolidar um ativo.
Balance e Available
Os dois principais tipos de saldo apresentados na interface são Balance e Available.
Balance (Total)
O campo Balance representa o saldo total observado para aquele ativo e rede no contexto consultado do provedor de custódia.
Available
O campo Available representa a parcela do saldo que está disponível para uma nova transferência.
O Available pode ser menor que o Balance quando parte do saldo estiver:
- comprometida com uma transferência em andamento;
- temporariamente pendente;
- bloqueada ou restrita;
- alocada em staking;
- reservada por uma regra da rede ou do protocolo.
Por exemplo:
Tipo de saldo | Valor |
|---|---|
| Balance | 100 ETH |
| Available | 75 ETH |
Nesse caso, a Wallet possui 100 ETH no total, mas apenas 75 ETH estão disponíveis para iniciar uma nova transferência.
A diferença entre Balance e Available não representa necessariamente uma única categoria. Sua composição depende das informações disponibilizadas pelo provedor de custódia.
Outros tipos de saldo
Além de Balance e Available, o modelo do Wallet Manager reconhece outros tipos de saldo (atualmente disponíveis apenas via API).
Tipo | O que representa |
|---|---|
| Total | Saldo total observado para o ativo e a rede. É apresentado na interface como Balance. |
| Available | Saldo disponível para uma nova transferência. |
| Inbound pending | Valores recebidos que ainda não atingiram as confirmações necessárias para serem considerados finalizados pelo provedor. |
| Restricted | Valores indisponíveis por bloqueio, congelamento, ação de compliance ou restrição administrativa. |
| Outbound in flight | Valores já comprometidos com transferências de saída em andamento. |
| Staked | Valores alocados em staking. |
| Protocol reserved | Saldo mínimo exigido pela rede ou pelo protocolo e que não pode ser livremente transferido. |
Nem todos os provedores disponibilizam todos esses tipos de saldo.
O Wallet Manager apresenta apenas os tipos que:
- fazem parte do modelo padronizado da Plataforma; e
- possuem uma correspondência válida nas informações do provedor.
Se determinado tipo de saldo não for informado pelo provedor, o Wallet Manager não o considera. A ausência de informação significa que aquele tipo de saldo não foi disponibilizado ou não possui um mapeamento aplicável.
Onde visualizar os saldos
A Plataforma oferece diferentes visões porque cada uma responde a uma necessidade operacional distinta.
Wallet Manager > Assets
A aba Assets apresenta a posição consolidada por ativo e rede de todos os provedores de custódia conectados ao Wallet Manager.
Essa é a visão indicada para responder:
Quanto a organização possui de cada ativo em cada rede?
- A subtab Currencies, apresenta ativos fungíveis (ex.: Ativos nativos da rede, ERC-20s, TRC-20s, SLP Tokens, etc.).
- A subtab Items apresenta ativos representados por unidades, quando essa categoria estiver disponível. Atualmente comporta apenas ativos do padrão ERC-1155.
Ao selecionar uma linha, é apresentada a visão detalhada daquele ativo e rede.
Visão detalhada por ativo x rede
A visão detalhada de um ativo apresenta as Wallets que compõem sua posição consolidada.
Essa é a visão indicada para responder:
Onde o saldo deste ativo está custodiado?
A página apresenta:
Informação | O que significa |
|---|---|
| CP | Provedor de custódia da Wallet |
| Wallet Type | Tipo da wallet |
| Wallet | Nome e endereço da Wallet |
| Vault | Vault ao qual a Wallet pertence |
| Balance | Saldo do ativo naquela Wallet |
| Available | Saldo disponível para transferência naquela Wallet |
| Updated at | Última atualização conhecida do saldo |
| Actions | Ações disponíveis para aquela Wallet |
O Total Balance apresentado no topo corresponde à soma das posições do ativo e da rede selecionados.
Essa tela permite partir de uma posição consolidada e identificar sua distribuição entre os diferentes provedores, Vaults e Wallets.
Wallet Manager > Wallets
A aba Wallets apresenta todas as Wallets conectadas ao Wallet Manager em uma listagem única.
Essa é a visão indicada para responder:
Quais Wallets existem e qual é o valor total mantido em cada uma?
As principais informações são:
| Informação | O que significa |
|---|---|
| CP | Provedor de custódia associado à Wallet |
| Wallet Type | Tipo da Wallet |
| Wallet | Nome e endereço principal |
| Network | Rede da Wallet |
| Vault | Vault ao qual ela pertence |
| Total Balance | Valor total em USD dos ativos da Wallet |
| Updated at | Última atualização conhecida |
| Actions | Ações disponíveis |
Total Balance da Wallet
O Total Balance representa a soma, em USD, dos ativos da Wallet que possuem preço disponível.
Esse valor é uma referência financeira consolidada e não substitui os saldos individuais em suas moedas nativas.
O Total Balance em USD inclui somente ativos para os quais a Plataforma possui dados de preço.
Por isso, uma Wallet pode possuir ativos e, ainda assim, apresentar 0 USD caso nenhum deles tenha uma cotação disponível.
Wallets bloqueadas
Wallets ativas e bloqueadas continuam aparecendo na listagem. Quando uma Wallet está bloqueada:
- seu saldo continua sendo considerado nas visões consolidadas;
- o badge Blocked é apresentado;
- ações de depósito ou retirada ficam indisponíveis.
Vault Details
A página Vault Details apresenta os saldos dentro da estrutura de um Vault específico.
Essa é a visão indicada para responder:
Como os ativos estão distribuídos entre as Wallets deste Vault?
A página de Vault Details é acessada a partir da seleção de uma Wallet em uma das páginas abaixo:
- Visão detalhada por ativo
- Wallets
Portfolio > Managed Wallets
A aba Managed Wallets, dentro do Portfolio, apresenta uma visão consolidada por provedor e conexão:
Essa é a visão indicada para responder:
Qual é a posição da organização em cada conexão de custódia?
Cada conexão aparece como uma seção separada.
Dentro dela, os saldos são consolidados por:
- ativo e rede, para Currencies;
- item e rede, para Items.
As principais informações são:
| Informação | O que significa |
|---|---|
| Provider/Connection | Provedor e conta conectada |
| Asset | Ativo daquela conexão |
| Network | Rede do ativo |
| Balance | Saldo consolidado na conexão |
| Available | Saldo disponível para transferência na conexão |
Se o mesmo ativo e rede estiverem presentes em várias Wallets dentro da mesma conexão, a tela apresenta uma única linha consolidada.
Saiba mais
Para aprofundar outros conceitos relacionados ao Wallet Manager, consulte também: