Setup
1
Open the Chainalysis integration
In the DFNS Dashboard, navigate to Integrations, find the Chainalysis card, and click Configure.
2
Activate and enter your API key
Toggle Activate Chainalysis Integration, then enter your Chainalysis API key.
3
Choose what to monitor
Under Transfer monitoring, choose which transfers DFNS sends to Chainalysis for monitoring. This is separate from the screening policies below, which always run on the activity they target.
- All transfers (default): every incoming and outgoing transfer is sent.
- Verified tokens only: only transfers of verified tokens are sent. Unverified tokens, which anyone can mint under a legitimate symbol, are skipped.
- Off: no transfers are sent. The integration is used only by your screening policies.
4
Save
Click Save. DFNS verifies the key with a live call to Chainalysis before activating; if Chainalysis rejects it, the save fails with
Chainalysis API key seems invalid. and nothing is stored. Once the key is accepted, the integration is active and the Chainalysis rules become available in the policy builder.Outbound transfer prescreening
Outbound transfers can be screened by Chainalysis before they are broadcast on-chain. Create a policy that runs the Chainalysis prescreening rule on wallet activity.From the dashboard
1
Create a policy
Go to Policies, click Create Policy, give it a name, and select the Wallet usage (transfer, transaction, signature) activity.
2
Select the Chainalysis rule
On the Rule step, choose Transaction attempt prescreening (Chainalysis). Set the minimum alert level that triggers the policy (Low, Medium, High, or Severe), and optionally restrict the alert, exposure, and address categories or set a User ID template.
3
Choose an action and save
Pick the action taken when the rule triggers, then review and Save. You can scope the policy to specific wallets or tags.
RequestApproval, a flagged transfer stays pending until an approver reviews it. The approval page shows the triggered policy and the reason, with the full Chainalysis evaluation under “Evaluation details”.
With the API
Create a policy with:- Activity kind:
Wallets:Sign - Rule kind:
ChainalysisTransactionPrescreening - Action kind:
Block,RequestApproval, orNoAction
policy.triggered webhook event.
Inbound transfer screening
Incoming transfers detected by the DFNS indexer can be screened by Chainalysis and reported to you.From the dashboard
1
Create a policy
Go to Policies, click Create Policy, give it a name, and select the Incoming wallet transaction activity.
2
Select the Chainalysis screening rule
On the Rule step, choose Transaction screening (Chainalysis) and configure the alert level and categories.
3
Save
Incoming screening reports results without blocking, so the action is No action. Review and Save.
With the API
Create a policy with:- Activity kind:
Wallets:IncomingTransaction - Rule kind:
ChainalysisTransactionScreening - Action kind:
NoAction
policy.triggered webhook event.
Supported networks
For the most up-to-date list of supported networks and assets, check Chainalysis KYT documentation.