Overview

Fireblocks allows you to maintain a secure list of whitelisted addresses to make transfers easier. Whitelisted addresses are deposit addresses that exist outside of your Fireblocks Vault. You can whitelist addresses for any supported blockchain or fiat account to transact with that address easily.

You can group whitelisted addresses in internal, external, or contract call whitelisted wallets. Each wallet type has different properties and can be assigned different rules in your workspace Policies.

Each wallet can only contain one address per asset type. If a counterparty has multiple addresses for the same asset, create a whitelisted wallet for each address. Fiat bank accounts with wire transfer details are supported.

New whitelisted addresses must be approved by the Admin Quorum before funds can be transferred to that address. If an address is rejected by a member of the Admin Quorum, it can be resubmitted for approval at a later time.

What are internal and external wallets?

Internal wallets are addresses that you control that exist outside of your Fireblocks workspace. These addresses' current balances appear in your workspace and are included in your total billable address count.

External wallets are addresses managed by your clients and counterparties. These addresses' balances do not appear in your workspace.

What about whitelisting Contract and Program calls?

Contract and Program calls are smart contracts on EVM-based blockchains and Solana Program accounts you want to interact with.

For EVM-based blockchains, you whitelist the contract address.
For Solana Program accounts, you whitelist the Program ID (base58).
For regular user/treasury addresses on any other chain, use Internal or External, as described above.

Create a whitelisted wallet

In the Fireblocks Console, select Whitelisted addresses on the left navigation panel.
On the Whitelisted addresses page, select Add > Whitelisted address wallet.
On the Create Whitelisted Wallet window, select the type of wallet you want to create (Internal, External, or Contract) and then enter the name you want to give the wallet. Note that this name will identify the wallet and its addresses throughout your workspace, and you cannot change the name after you create it.

Note: To whitelist a fiat bank account for off-ramp or fiat transfers, select External as the wallet type.

Select Create wallet. The wallet appears in your list, and you can now add deposit addresses.

Add deposit addresses to a whitelisted wallet

Notes

Once a whitelisted address is created, it cannot be edited. To edit a whitelisted address, delete it, resubmit the correct address, and approve it.
You can avoid manually entering whitelist addresses by connecting directly with counterparties on the Fireblocks P2P Network.

In the Fireblocks Console, select Whitelisted addresses from the left navigation panel.
Select the wallet you want to add an address to.
Select Add address.
In the Add whitelisted address window, select (or search for and select) the wallet's asset type and then enter the wallet's deposit address.
1. For Contract Calls: Make sure the whitelisted wallet is a Contract/Program wallet, then select the base asset of the appropriate blockchain and enter the contract address.
2. For Solana Program Calls: Make sure the whitelisted wallet is a Contract/Program wallet, then select SOL and enter the Program ID (base58). Please note that regular Solana account addresses, such as user wallets and token accounts, should be added as internal or external wallets.
3. For fiat accounts/wire transfers: Make sure the whitelisted wallet is internal or external, then select your fiat account provider (e.g., Cross River, BLINC) and enter the requested account details.
4. For addresses that require a destination tag, memo, note, or Bank Transfer description: Enter the relevant information as required. For destination tags, select The recipient doesn't require a destination tag if the recipient doesn't require one.
5. For whitelisting Ripple addresses: To avoid failed transactions, make sure the destination tag consists of up to nine numerical digits.
Select Add address. Your Admin Quorum must then approve the new address before you can send transfers to it.

Delete a whitelisted wallet

You can delete whitelisted wallets from your workspace. Note that when you delete a whitelisted wallet, transactions using that wallet appear in the Transaction History with the wallet's name at the time of the transaction.

In the Fireblocks Console, select Whitelisted addresses from the left navigation panel.
Find the wallet you want to delete, then select More actions > Delete wallet.
On the confirmation dialog, select Delete.

Delete a whitelisted wallet's deposit address

You can delete a whitelisted wallet's deposit addresses. Note that when you delete a deposit address, transactions using that address appear in the Transaction History with the wallet's name and the address used at the time of the transaction.

In the Fireblocks Console, select Whitelisted addresses from the left navigation panel.
Find and select the wallet containing the deposit address you want to delete.
Find the deposit address you want to delete, then select More actions > Delete address.
On the confirmation dialog, select Delete.

Managing whitelisted wallets & contracts via the API

We offer several solutions for all whitelisted wallet types and deposit address management via the Fireblocks API and our SDKs.