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:
- In your Fireblocks Console, select Whitelisted Addresses on the left navigation panel.
- On the Whitelisted Addresses page, select + Whitelisted Wallet.
- 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. Only smart contracts on EVM-compatible blockchains are compatible with this feature. Contracts on any other blockchain, like Solana, should be labeled internal or external.
- 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.
- Select Create. The wallet appears in your list, and you can now add deposit addresses.
Note
Different Transaction Authorization Policy (TAP) rules may apply to the types of whitelisted addresses.
Adding whitelisted addresses
To add a whitelisted address to a whitelisted wallet:
- In your Fireblocks Console, select Whitelisted Addresses on the left navigation panel.
- On the Whitelisted Addresses page, select the wallet where you want to add a whitelisted address.
- On the page with your wallet’s information, select Add Address. If you're adding additional addresses to an existing wallet, select + Whitelisted Address in the top right corner of the page.
- 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
- 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.
- 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.
- Enter a Destination Tag if the recipient requires it. Only certain asset types allow tags, also known as memos, notes, or bank transfer descriptions depending on the blockchain. If the asset type allows a destination tag but the deposit address does not require it, select The recipient does not require tag. Learn more about using destination tags.
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.
- Select Submit for Approval.
Your Admin Quorum must approve the new whitelisted address before you can send transfers to them.
Notes
- Once a whitelisted address is created, it cannot be edited.
- You can avoid manually entering whitelist addresses by connecting directly with counterparties on the Fireblocks Network.
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:
- In your Fireblocks Console, select Whitelisted Addresses on the left navigation panel.
- Select the action menu on the wallet you want to remove.
- Select Remove Whitelisted Wallet.