Skip to content

Integrate Transaction Screening Providers into Fordefi

Fordefi lets you screen outgoing transactions for risk with external screening providers, alongside Fordefi's own risk engine. Screening runs before the transaction is signed, so the risks that a provider finds are shown to the initiator and to every approver while the transaction can still be cancelled.

The supported providers are Blockaid and Hypernative. Screening is opt-in per organization and self-serve: an organization admin activates a provider by saving valid credentials for it. Until credentials are saved, nothing changes in your transaction flow.

Once a provider is active:

  • Risks are shown with the transaction. Provider risks appear next to Fordefi's own risks in the transaction preview, in the transaction details, and in the transaction history, each attributed to the provider that found it. See View transaction screening results.
  • Risks become a policy condition. You can write policy rules on the screening result, for example to block a transaction that Hypernative denies, or to require an admin quorum for a transaction that Blockaid flags as a warning. See Set policy rules on screening results.

Screening results are informational on their own. As with Fordefi's own risk engine, the presence of a risk does not block a transaction unless a policy rule acts on it.

Transaction screening is separate from AML screening. AML screening checks the counterparties of a transfer against a compliance data set; transaction screening evaluates the behavior of the transaction itself. You can run both.

Providers and credentials

You obtain credentials directly from the provider, under your own contract with them. Fordefi does not resell either provider and does not verify your commercial relationship — it validates and stores the credentials you supply, and calls the provider's API with them. Any quota or rate limit consumed by screening is consumed against your own account with the provider.

ProviderCredentials required
BlockaidAPI key
HypernativeClient ID and client secret

Supported chains

Chain typeNetworksWhat is screened
EVMMainnets only, varies by providerTransactions and messages
SolanaMainnet onlyTransactions
BitcoinMainnet onlyTransfers and PSBTs

Coverage within each chain type also depends on the provider. If a provider does not support the chain of a given transaction, Fordefi shows the transaction as not screened rather than as an error. See Unsupported chains, errors, and timeouts.

Transactions on testnets and on chain types not listed above are not screened.

Permissions

  • Organization admins: Can activate a provider by saving valid credentials, edit those credentials, test the connection, and deactivate a provider.
  • Traders: Can see screening results in transaction and swap previews, and in transaction details and history.
  • Viewers: Can see screening results in transaction details and history. Viewers do not create transactions, so previews do not apply to them.

Learn more: