About the Chainalysis integration

You can configure Fireblocks to provide transaction information, such as output address, transaction hash, and a Customer Reference ID, to Chainalysis for Know Your Transaction (KYT) screening. Using the AML Transaction Screening Policy, you decide which transactions are screened and sent to Chainalysis for further analysis.

Fireblocks works with Chainalysis API v1. For a list of supported assets on Fireblocks and Chainalysis, see here.

Viewing risk information

Auditable risk information about all your screened transactions is available from Chainalysis and Fireblocks. You can view your screened transactions on the Fireblocks Console’s Transaction History page and Audit Log, or use the Fireblocks API. Transaction rejection information is only available from Fireblocks.

You can also receive notifications of indirect risk exposure and ongoing risk attributions via severity alerts in the Chainalysis UI.

Before you begin

Before you can connect your Chainalysis account, complete the process of enabling the Compliance tab.

Initial setup

Generate your Chainalysis API key

1. Log in to the Chainalysis KYT website.
2. Go to Account > Developers > API Keys.
3. Select Generate API Key.
4. Copy the API key.

Make sure the user generating the API key has KTY API access permissions enabled in Chainalysis. Additionally, if the user generating the API key is removed from your Chainalysis account, you will need to generate a new API key.

Activate the Chainalysis integration on Fireblocks

1. In the Fireblocks Console, go to Settings > Compliance > AML > Connect provider.
2. Select Chainalysis V2.
3. Enter your Chainalysis API key.

AML Transaction Screening Policy

The Chainalysis integration uses your workspace's AML Transaction Screening Policy to determine which incoming and outgoing transactions to screen. Upon activating the Chainalysis integration, the default AML Transaction Screening Policy is used until you create an optional custom policy.

AML Post-Screening Policy

The Chainalysis integration uses your workspace's AML Post-Screening Policy to pre-determine what action to take on a screened transaction based on the screening result returned by Chainalysis. Upon activating the Chainalysis integration, the default AML Post-Screening Policy is used until you create an optional custom policy.

Additional configurations

You can set up Customer Reference IDs to automatically associate users with incoming and outgoing transactions. This allows you to view the potential risk of transacting with each user.

Testing transaction rejection

Incoming transactions

1. Add two rules to the end of your AML Post-Screening Policy that reject small dust transactions (e.g., $0.0568) from an identified source, such as from a well-known exchange.
   1. The first rule should accept all transactions greater than $0.0568.
   2. The second rule (the last rule on the policy) rejects all transactions.
2. Initiate transactions above and below the amount threshold to trigger the respective rules.

These rules can be disabled at your request. Also, remember that only transactions with an attribution made within the Inbound Blocking Timeout period will be rejected. This does not include transactions that receive an “Unknown” screening result from Chainalysis.

Outgoing transactions

1. Create a reject rule on your AML Post-Screening Policy to match transactions identified as high-risk by Chainalysis.
2. Set one of your destination wallet addresses as a custom address in Chainalysis. You can delete the custom address after you complete testing.
3. Set the rule’s Category parameter to match one of the high-risk categories.

These rules can be disabled at your request. Also, remember that only transactions with an attribution made within the Outbound Blocking Timeout period will be rejected. This does not include transactions that receive an “Unknown” screening result from Chainalysis.

Supported assets (V1)

Chainalysis has a list of assets and networks defined as mature and emerging assets and networks. Fireblocks supports the subset of these assets and networks as listed below.

You can request support for screening additional assets that are a part of Chainalysis' list by submitting a request to Fireblocks Support. On your request, make sure to list the specific assets you want to be supported in your workspace.

Supported assets (V2)

Chainalysis V2 uses Dynamic token support to support blockchains holistically. This means that newly deployed tokens are supported automatically. Fireblocks supports a subset of these assets and networks as listed below.

ERC-20 tokens

Fireblocks supports all ERC-20 tokens on the following blockchains for screening with Chainalysis V2.

• Arbitrum One
• Avalanche C-Chain
• Base
• BNB Smart Chain (BSC)
• Ethereum
• Linea
• OP Mainnet (Optimism)
• Polygon PoS
• ZKsync

Other tokens

View the list of all other supported tokens on Chainalysis V2.

Testnet assets

The following testnet assets are supported on Chainalysis V2:

• BTC_TEST (Bitcoin Test)
• ETH_TEST (Ethereum Test Ropsten)
• ETH_TEST2 (Ethereum Test Kovan)
• ETH_TEST3 (Ethereum Test Goerli)
• ETH_TEST4 (Ethereum Test Rinkeby)
• ETH_TEST5 (Ethereum Test Sepolia)
• ETH_TEST6 (Ethereum Test Holesky)