Chainalysis oracle for sanctions screening

Use the Chainalysis oracle to screen wallet addresses on-chain

Chainalysis oracle for sanctions screening

Use the Chainalysis oracle to screen wallet addresses on-chain

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, including but not limited to, sanctions lists imposed by the US, EU, or UN, with which anyone subject to those jurisdictions is prohibited from dealing.

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:

1 pragma solidity ^0.8.12;
2 
3 interface SanctionsList {
4     function isSanctioned(address addr) external view returns (bool);
5 }
6 
7 contract ConsumerContract {
8     address constant SANCTIONS_CONTRACT = 0x40C57923924B5c5c5455c48D93317139ADDaC8fb;
9 
10     function transfer(address to, uint256 amount) external {
11         SanctionsList sanctionsList = SanctionsList(SANCTIONS_CONTRACT);
12         bool isToSanctioned = sanctionsList.isSanctioned(to);
13         require(!isToSanctioned, "Transfer to sanctioned address");
14     }
15 }

JavaScript

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

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

The above code prints:

$ 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

Get help

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

ABI

1 [
2 	{
3 		"inputs": [],
4 		"stateMutability": "nonpayable",
5 		"type": "constructor"
6 	},
7 	{
8 		"anonymous": false,
9 		"inputs": [
10 			{
11 				"indexed": true,
12 				"internalType": "address",
13 				"name": "addr",
14 				"type": "address"
15 			}
16 		],
17 		"name": "NonSanctionedAddress",
18 		"type": "event"
19 	},
20 	{
21 		"anonymous": false,
22 		"inputs": [
23 			{
24 				"indexed": true,
25 				"internalType": "address",
26 				"name": "previousOwner",
27 				"type": "address"
28 			},
29 			{
30 				"indexed": true,
31 				"internalType": "address",
32 				"name": "newOwner",
33 				"type": "address"
34 			}
35 		],
36 		"name": "OwnershipTransferred",
37 		"type": "event"
38 	},
39 	{
40 		"anonymous": false,
41 		"inputs": [
42 			{
43 				"indexed": true,
44 				"internalType": "address",
45 				"name": "addr",
46 				"type": "address"
47 			}
48 		],
49 		"name": "SanctionedAddress",
50 		"type": "event"
51 	},
52 	{
53 		"anonymous": false,
54 		"inputs": [
55 			{
56 				"indexed": false,
57 				"internalType": "address[]",
58 				"name": "addrs",
59 				"type": "address[]"
60 			}
61 		],
62 		"name": "SanctionedAddressesAdded",
63 		"type": "event"
64 	},
65 	{
66 		"anonymous": false,
67 		"inputs": [
68 			{
69 				"indexed": false,
70 				"internalType": "address[]",
71 				"name": "addrs",
72 				"type": "address[]"
73 			}
74 		],
75 		"name": "SanctionedAddressesRemoved",
76 		"type": "event"
77 	},
78 	{
79 		"inputs": [
80 			{
81 				"internalType": "address[]",
82 				"name": "newSanctions",
83 				"type": "address[]"
84 			}
85 		],
86 		"name": "addToSanctionsList",
87 		"outputs": [],
88 		"stateMutability": "nonpayable",
89 		"type": "function"
90 	},
91 	{
92 		"inputs": [
93 			{
94 				"internalType": "address",
95 				"name": "addr",
96 				"type": "address"
97 			}
98 		],
99 		"name": "isSanctioned",
100 		"outputs": [
101 			{
102 				"internalType": "bool",
103 				"name": "",
104 				"type": "bool"
105 			}
106 		],
107 		"stateMutability": "view",
108 		"type": "function"
109 	},
110 	{
111 		"inputs": [
112 			{
113 				"internalType": "address",
114 				"name": "addr",
115 				"type": "address"
116 			}
117 		],
118 		"name": "isSanctionedVerbose",
119 		"outputs": [
120 			{
121 				"internalType": "bool",
122 				"name": "",
123 				"type": "bool"
124 			}
125 		],
126 		"stateMutability": "nonpayable",
127 		"type": "function"
128 	},
129 	{
130 		"inputs": [],
131 		"name": "name",
132 		"outputs": [
133 			{
134 				"internalType": "string",
135 				"name": "",
136 				"type": "string"
137 			}
138 		],
139 		"stateMutability": "pure",
140 		"type": "function"
141 	},
142 	{
143 		"inputs": [],
144 		"name": "owner",
145 		"outputs": [
146 			{
147 				"internalType": "address",
148 				"name": "",
149 				"type": "address"
150 			}
151 		],
152 		"stateMutability": "view",
153 		"type": "function"
154 	},
155 	{
156 		"inputs": [
157 			{
158 				"internalType": "address[]",
159 				"name": "removeSanctions",
160 				"type": "address[]"
161 			}
162 		],
163 		"name": "removeFromSanctionsList",
164 		"outputs": [],
165 		"stateMutability": "nonpayable",
166 		"type": "function"
167 	},
168 	{
169 		"inputs": [],
170 		"name": "renounceOwnership",
171 		"outputs": [],
172 		"stateMutability": "nonpayable",
173 		"type": "function"
174 	},
175 	{
176 		"inputs": [
177 			{
178 				"internalType": "address",
179 				"name": "newOwner",
180 				"type": "address"
181 			}
182 		],
183 		"name": "transferOwnership",
184 		"outputs": [],
185 		"stateMutability": "nonpayable",
186 		"type": "function"
187 	}
188 ]