Introduction

The Wallet Manager brings together the balances of the Wallets held across the different custody providers connected to the Parfin Platform.

Because each provider may use different names, structures, and balance types, the Wallet Manager standardizes this information before presenting it on the Platform. This makes it possible to review consolidated positions without losing the ability to identify which provider, Vault, and Wallet each value is held in.

This article explains:

• how the Wallet Manager represents a balance;
• the difference between Balance and Available;
• how balances are consolidated;
• where to review positions on the Platform.

How the Wallet Manager represents a balance

In the Wallet Manager, a balance is first recorded at the Wallet level.

Each balance is related to:

• a Wallet;
• a custody provider;
• an asset;
• a network;
• a balance type.

For example, the USDC balance held in a Wallet on the Ethereum network is different from the USDC balance held in a Wallet on the Solana network.

Even though both assets use the USDC symbol, they belong to different networks and are therefore presented separately.

The information shown at higher levels — such as Vault, provider, or instance — consists of consolidations derived from the Wallet balances.

The structure can be represented as follows:

• Wallet -> Balance by asset and network 
• Vault -> Consolidation of the Vault's Wallets 
• Connection -> Consolidation of that connection's Wallets 
• Instance -> Consolidation of the connected providers


The values originate from the information made available by the custody providers. The Wallet Manager standardizes and consolidates this data, but it does not create balances that haven't been reported or mapped.

What identifies an asset

In the interface, an asset is usually shown by its symbol and icon, such as USDC, ETH, or BTC. However, the symbol is only display information and does not uniquely identify an asset.

Different assets can use the same symbol, even within the same network. For this reason, the Wallet Manager doesn't rely on the symbol alone to determine whether two records represent the same asset.

The identity considered by the Platform depends on the asset type:

The Wallet Manager maps the assets reported by the different providers to a standardized identity on the Platform.

Only balances associated with the same asset identity are consolidated.

This means that:

• records of the same token, on the same network and with the same contract address, can be added together even when they come from different providers;
• tokens with the same symbol but different contract addresses are treated as distinct assets;
• tokens with the same symbol on different networks are also treated separately.

Example:

Consider three positions reported by the providers:

The first two positions represent the same asset and are consolidated into 800 USDC.

The third position has the same symbol and is on the same network, but it uses a different contract. It therefore remains separate as a different asset.

The symbol makes the information easier to read, but it is not used on its own to identify or consolidate an asset.

Balance and Available

The two main balance types shown in the interface are Balance and Available.

Balance (Total)

The Balance field represents the total balance observed for that asset and network in the queried context of the custody provider.

Available

The Available field represents the portion of the balance that is available for a new transfer.

Available can be lower than Balance when part of the balance is:

• committed to an ongoing transfer;
• temporarily pending;
• blocked or restricted;
• allocated to staking;
• reserved by a network or protocol rule.

For example:

In this case, the Wallet holds 100 ETH in total, but only 75 ETH are available to start a new transfer.

The difference between Balance and Available doesn't necessarily represent a single category. Its composition depends on the information made available by the custody provider.

Other balance types

Beyond Balance and Available, the Wallet Manager model recognizes other balance types (currently available only via API).

Not all providers make all of these balance types available. The Wallet Manager shows only the types that:

• are part of the Platform's standardized model; and
• have a valid match in the provider's information.

If a given balance type isn't reported by the provider, the Wallet Manager doesn't consider it. The absence of information means that balance type wasn't made available or doesn't have an applicable mapping.

Where to view balances

The Platform offers different views because each one answers a distinct operational need.

Wallet Manager > Assets

The Assets tab shows the consolidated position by asset and network across all custody providers connected to the Wallet Manager.

This is the view for answering:

How much of each asset does the organization hold on each network?

• The Currencies subtab shows fungible assets (e.g., network-native assets, ERC-20s, TRC-20s, SPL Tokens, etc.).
• The Items subtab shows assets represented by units, when this category is available. It currently supports only ERC-1155 assets.

Selecting a row opens the detailed view of that asset and network.

Detailed view by asset × network

The detailed view of an asset shows the Wallets that make up its consolidated position.

This is the view for answering:

Where is this asset's balance held?

The page shows:

The Total Balance shown at the top corresponds to the sum of the positions for the selected asset and network.

This screen makes it possible to start from a consolidated position and identify how it is distributed across the different providers, Vaults, and Wallets.

Wallet Manager > Wallets

The Wallets tab shows all the Wallets connected to the Wallet Manager in a single list.

This is the view for answering:

Which Wallets exist and what is the total value held in each one?

The main information is:

Wallet Total Balance

The Total Balance represents the sum, in USD, of the Wallet's assets that have a price available.

This value is a consolidated financial reference and does not replace the individual balances in their native currencies.

The USD Total Balance includes only assets for which the Platform has price data.

For this reason, a Wallet can hold assets and still show 0 USD if none of them has a price available.

Blocked Wallets

Both active and blocked Wallets continue to appear in the list.

When a Wallet is blocked:

• its balance is still included in the consolidated views;
• the Blocked badge is shown;
• deposit and withdrawal actions become unavailable.

Vault Details

The Vault Details page shows the balances within the structure of a specific Vault.

This is the view for answering:

How are the assets distributed across the Wallets of this Vault?

The Vault Details page is reached by selecting a Wallet from one of the following pages:

• Detailed view by asset
• Wallets

Portfolio > Managed Wallets

The Managed Wallets tab, within the Portfolio, shows a consolidated view by provider and connection:

• This is the view for answering:

What is the organization's position in each custody connection?

• Each connection appears as a separate section.

• Within it, balances are consolidated by:

  • asset and network, for Currencies;
  • item and network, for Items.

The main information is:

If the same asset and network are present in several Wallets within the same connection, the screen shows a single consolidated row.

Learn more

To explore other concepts related to the Wallet Manager, see also:

• What the Wallet Manager is 
• How assets are organized: Vaults, Wallets, and Deposit Addresses 
• How to create and track an outbound transfer