> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dfns.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Global Ledger

> Screen outbound transactions with Global Ledger's blockchain analytics and KYT services, enforced through Dfns policies before signing.

export const Loom = props => {
  return <iframe className="w-full aspect-video rounded-xl" src={`https://www.loom.com/embed/${props.videoId}`} title="Loom video player" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen>
      </iframe>;
};

[Global Ledger](https://globalledger.io/) is a blockchain analytics company providing AML compliance and KYT (Know Your Transaction) solutions. Their platform supports over 2,000 digital assets and delivers real-time risk scoring for transaction screening.

<Loom videoId="eae6c05e61f94205b4c057bf61da4e2f" />

## Setup

1. In the Dfns Dashboard, navigate to [**Integrations**](/integrations) and find the Global Ledger card
2. Click **Configure** to open the settings panel
3. Enter your Global Ledger API key
4. (Optional) If using an on-prem deployment, specify your custom base domain and supported blockchains
5. Save

## Outbound transfer prescreening

Outbound transfers can be screened by Global Ledger before they are broadcast on-chain. To enable this, create a policy with:

* Activity kind: [`Wallets:Sign`](/api-reference/policies#walletssign-activity)
* Rule kind: [`GlobalLedgerTransactionPrescreening`](/api-reference/policies#globalledgertransactionprescreening-policy-rule)
* Action kind: [`Block`](/api-reference/policies#block-policy-action), [`RequestApproval`](/api-reference/policies#requestapproval-policy-action), or [`NoAction`](/api-reference/policies#noaction-policy-action)

### When the policy triggers

The policy triggers when either:

* The transaction's risk score meets or exceeds your configured `riskScoreThreshold` (0-100 scale, where 100 is highest risk)
* Global Ledger returns any alerts for the transaction (alerts are configured in your [Global Ledger dashboard](https://globalledger.io/))

When triggered, the policy approval page displays "Evaluation details" with the full response from Global Ledger, including risk scores and any alerts.

### Skip options

The rule includes options to handle edge cases:

| Option                        | Description                                                         |
| ----------------------------- | ------------------------------------------------------------------- |
| `skipUnscreenableTransaction` | Skip wallet requests that cannot be screened (e.g., raw signatures) |
| `skipUnsupportedNetwork`      | Skip transfers to networks not supported by the integration         |
| `skipUnsupportedAsset`        | Skip transfers of assets not supported by the integration           |
| `skipGlobalLedgerFailure`     | Skip if the Global Ledger API request fails                         |

When a skip option is enabled and the condition is met, the policy does not trigger and the transaction proceeds.

### Webhook events

When the policy triggers, the screening results are included in the [`policy.triggered`](/api-reference/webhook-events) webhook event.

## Supported networks

Global Ledger supports major blockchains including Bitcoin, Ethereum, Tron, BNB Chain, Solana, and more. For the complete list of supported networks and assets, see [Global Ledger's documentation](https://globalledger.io/kyt).

<Note>
  If you're using an on-prem deployment of Global Ledger, you can specify which blockchains your deployment supports in the Dashboard integration settings.
</Note>