Chainalysis oracle for sanctions screening

[REDDNoC]

The Chainalysis oracle is a smart contract that validates if a cryptocurrency wallet address has been included in a sanctions designation. The smart contract is maintained by Chainalysis on a variety of popular blockchains and will be regularly updated to reflect the latest sanctions designations listed on economic/trade embargo lists from organizations including the US, EU, or UN. The smart contract is available for anyone to use and does not require a customer relationship with Chainalysis

Defining Sanctions Data Sanctioned entities refer to entities listed on economic/trade embargo lists, such as by the US, EU, or UN, with which anyone subject to those jurisdictions is prohibited from dealing. Currently, this includes the Specially Designated Nationals (SDN) list of the US Department of the Treasury’s Office of Foreign Assets Control (OFAC). While we will be taking reasonable measures to keep the sanctions oracle up-to-date, Chainalysis cannot guarantee the accuracy, timeliness, suitability, or validity of the data.

Using the Chainalysis oracle You can use the Chainalysis oracle in conjunction with many programming languages. Below we provide an example for Solidity and for Javascript using the popular web3.js library.

Solidity The following code checks whether the address funds are being sent to is on the sanctions list:

pragma solidity ^0.8.12;

interface SanctionsList { function isSanctioned(address addr) external view returns (bool); }

contract ConsumerContract { address constant SANCTIONS_CONTRACT = 0x40C57923924B5c5c5455c48D93317139ADDaC8fb;

function transfer(address to, uint256 amount) external {
    SanctionsList sanctionsList = SanctionsList(SANCTIONS_CONTRACT);
    bool isToSanctioned = sanctionsList.isSanctioned(to);
    require(!isToSanctioned, "Transfer to sanctioned address");
}

}

Javascript The following code checks if an address is on a sanctions list from the web3.js collection of libraries:

const Web3 = require('web3') const rpcurl = "" const web3 = new Web3(rpcurl) const abi = [/* See our ABI below */] const contract_address = "0x40c57923924b5c5c5455c48d93317139addac8fb" contract = new web3.eth.Contract(abi, contract_address) contract.methods.isSanctioned("0x7f268357A8c2552623316e2562D90e642bB538E5").call((err, result) => { console.log("Non-sanctioned address: "); console.log(result); }); contract.methods.isSanctioned("0x7F367cC41522cE07553e823bf3be79A889DEbe1B").call((err, result) => { console.log("Sanctioned address: "); console.log(result); });

This will print:

Non-sanctioned address: false Sanctioned address: true

Compatible networks Currently, the Chainalysis oracle is available on the Ethereum network as well as the following EVM-compatible networks (click the links to view the Chainalysis oracle on each network):

Ethereum: 0x40C57923924B5c5c5455c48D93317139ADDaC8fb Polygon: 0x40C57923924B5c5c5455c48D93317139ADDaC8fb BNB Smart Chain: 0x40C57923924B5c5c5455c48D93317139ADDaC8fb Avalanche: 0x40C57923924B5c5c5455c48D93317139ADDaC8fb Optimism: 0x40C57923924B5c5c5455c48D93317139ADDaC8fb Arbitrum: 0x40C57923924B5c5c5455c48D93317139ADDaC8fb Fantom: 0x40c57923924b5c5c5455c48d93317139addac8fb Celo: 0x40C57923924B5c5c5455c48D93317139ADDaC8fb Blast: 0x40C57923924B5c5c5455c48D93317139ADDaC8fb Base: 0x3A91A31cB3dC49b4db9Ce721F50a9D076c8D739B

Getting help Contact [email protected] to provide feedback or ask us any questions.

ABI [ { "inputs": [], "stateMutability": "nonpayable", "type": "constructor" }, { "anonymous": false, "inputs": [ { "indexed": true, "internalType": "address", "name": "addr", "type": "address" } ], "name": "NonSanctionedAddress", "type": "event" }, { "anonymous": false, "inputs": [ { "indexed": true, "internalType": "address", "name": "previousOwner", "type": "address" }, { "indexed": true, "internalType": "address", "name": "newOwner", "type": "address" } ], "name": "OwnershipTransferred", "type": "event" }, { "anonymous": false, "inputs": [ { "indexed": true, "internalType": "address", "name": "addr", "type": "address" } ], "name": "SanctionedAddress", "type": "event" }, { "anonymous": false, "inputs": [ { "indexed": false, "internalType": "address[]", "name": "addrs", "type": "address[]" } ], "name": "SanctionedAddressesAdded", "type": "event" }, { "anonymous": false, "inputs": [ { "indexed": false, "internalType": "address[]", "name": "addrs", "type": "address[]" } ], "name": "SanctionedAddressesRemoved", "type": "event" }, { "inputs": [ { "internalType": "address[]", "name": "newSanctions", "type": "address[]" } ], "name": "addToSanctionsList", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "addr", "type": "address" } ], "name": "isSanctioned", "outputs": [ { "internalType": "bool", "name": "", "type": "bool" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "addr", "type": "address" } ], "name": "isSanctionedVerbose", "outputs": [ { "internalType": "bool", "name": "", "type": "bool" } ], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [], "name": "name", "outputs": [ { "internalType": "string", "name": "", "type": "string" } ], "stateMutability": "pure", "type": "function" }, { "inputs": [], "name": "owner", "outputs": [ { "internalType": "address", "name": "", "type": "address" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "address[]", "name": "removeSanctions", "type": "address[]" } ], "name": "removeFromSanctionsList", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [], "name": "renounceOwnership", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [ { "internalType": "address", "name": "newOwner", "type": "address" } ], "name": "transferOwnership", "outputs": [], "stateMutability": "nonpayable", "type": "function" } ]