Overview
Fireblocks supports Ethereum Virtual Machine (EVM) assets across all Fireblocks workspaces. In addition to these globally supported assets, Owners, Admins, Non-Signing Admins, Signers, and Editors can manually add more EVM assets to your organization's workspace as needed.
What standards are supported?
Originally defined for the Ethereum blockchain, the ERC-20 token standard provides a standard interface to implement transferable tokens within smart contracts. ERC-20 is used on EVM blockchains such as Arbitrum C-Chain (ARC-20), Binance Smart Chain (BEP-20), Polygon (MRC-20), and all other EVM blockchain networks supported by Fireblocks.
Fireblocks also supports token formats that adhere to the ERC-20 standard, including ERC-1400 and ERC-1404. You can view a list of all the supported EVM blockchains when you add a new ERC-20 asset to a workspace.
How to add EVM assets to a workspace
There are three ways to add EVM assets to your workspace:
- Via the Fireblocks Console
- Via the Fireblocks API
- Via Contract Calls
Via the Fireblocks Console
- Go to the Assets page and search for the asset in the top left corner. If the asset is not listed, select List asset. This button also appears when attempting to create a wallet for assets not currently listed in the workspace.
- Select the asset’s blockchain, and select Continue.
- Copy and paste the asset’s contract address. You can find this information using a block explorer for the asset’s blockchain network.
- Select Continue. Fireblocks verifies the contract address and blockchain and then displays the asset’s properties.
- Select List asset to list the asset in your workspace. You can now add asset wallets for this asset to any vault account.
Via the Fireblocks API
Use the Register an asset endpoint to add ERC-20 assets. This makes the asset available via the Fireblocks API for all asset-related operations, such as:
- Creating asset wallets for this asset in any vault account
- Whitelisting addresses for this asset in any whitelisted wallet
- Creating transactions with this asset
- Tracking active transactions with this asset
- Viewing previous transactions with this asset
- Retrieving vault accounts, exchange accounts, and whitelisted wallets that contain this asset.
Via Contract Calls
Note
This is an opt-in feature. Contact Fireblocks Support to enable it in your workspace.
Once enabled, ERC-20 assets transferred in a contract call you initiated are automatically added to the workspace that initiated the contract call. A notification in the Fireblocks Console lets you know when a new ERC-20 asset has been automatically added to your workspace.
Fireblocks considers ERC-20 assets unverified and insecure when automatically listed in a workspace. An Admin-level user must approve the asset before it can be used in the workspace.
To approve or reject a new ERC-20 asset:
- In the Fireblocks Console, hover your pointer over the unverified asset.
- On the pop-up window, select Approve token to list the asset in your workspace. Otherwise, select Contact Support to request the asset be removed from your workspace.
Additionally, the Owner or Admin can view the asset contract if necessary by selecting View Token Contract.
Finding newly added assets
To find the new asset’s ID using the Console, hover over the asset’s name to view additional details, including the asset’s ID in the Fireblocks API and its contract address. Use the asset’s ID in Fireblocks for all relevant API endpoints.
To find the new asset via the API, use the Get supported assets endpoint, then look for the asset by name, contractAddress, or id.
Troubleshooting
Incoming transactions involving assets deposited to your vault account before being added to your workspace do not appear in your Transaction History. However, the destination account balance will include the asset.
Contact Fireblocks Support to re-scan the deposit address and recognize the incoming transaction.