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, and can add an unlimited amount of whitelisted addresses to each whitelisted wallet. 

Each address a user requests to be whitelisted must be approved by the Admin Quorum before funds can be transferred to that address. If one of the admins rejects the request, the address is not whitelisted. However, a new request to whitelist the same address can be submitted and approved by the Admin Quorum at any time.

Creating a whitelisted wallet

To create a whitelisted wallet:

1. In your Fireblocks Console, select Whitelisted Addresses on the left navigation panel.
2. On the Whitelisted Addresses page, select + Whitelisted Wallet.
3. On the Create Whitelisted Wallet window, select the type of wallet you want to create.
   
   • Internal: Addresses you control outside of your Fireblocks workspace. Internal addresses display their current balance and are included in your workspace's total billable address count.
   • External: Addresses managed by your clients and counterparties.
   • Contract: Addresses of smart contracts that you want to interact with. Currently, this only applies to smart contracts on EVM-compatible blockchains.
4. Under Wallet Name, enter the name you want to give the wallet. This name will identify the wallet and its addresses throughout your workspace. You cannot change the name after you create it.
5. Select Create. The wallet appears in your list, and you can now add deposit addresses.

Adding whitelisted addresses

To add a whitelisted address to a whitelisted wallet:

1. In your Fireblocks Console, select Whitelisted Addresses on the left navigation panel.
2. On the Whitelisted Addresses page, select the wallet where you want to add a whitelisted address.
3. On the page with your wallet’s information, select Add Address. If you are adding additional addresses to an existing wallet, select + Whitelisted Address in the top right corner of the page.
4. On the Add Whitelisted Address window, select the wallet's asset type and then enter or paste the wallet's deposit address in the Deposit Address field.
   

   Note

   1. When whitelisting an address in a Contract whitelisted wallet, select the base asset of the blockchain. For example, to whitelist a smart contract address on Ethereum, select ETH as the asset type.
   2. Each whitelisted 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 deposit address.
5. If the asset requires a destination tag, enter the appropriate tag in the Destination Tag field. Bear in mind, though, that the particular field that appears is dependent on the selected asset (i.e. Destination Tag for XRP; Memo for EOS, HBAR, XDB, XLM; Note for ALGO; Bank Transfer Description for fiat, etc). If the asset allows a destination tag but the deposit address does not require it, select The recipient does not require tag (per the clarification above, the optional "does not require" checkbox changes to match the asset type).
   
   

   Important note:

   When whitelisting a Ripple address, make sure its destination tag consists of up to 9 numerical digits, in order to avoid failed transactions.

6. Select Submit for Approval.

Your Admin Quorum must approve the new whitelisted address before you can send transfers to them.

Removing whitelisted addresses

Whitelisted wallets and addresses can be removed from your workspace and re-added if necessary. If a whitelisted wallet is removed and re-added, any transaction to an included whitelisted address is shown in the Transaction History with the name of the wallet at the time of the transaction. 

To remove a whitelisted wallet:

1. In your Fireblocks Console, select Whitelisted Addresses on the left navigation panel.
2. Select the action menu on the wallet you want to remove.
3. Select Remove Whitelisted Wallet.