We refreshed our doc site!
Bookmarked links may have changed
Read release notesThis guide walks you through testing Circle's Transaction Screening service using the Web3 Services API on testnet. The service is a real time tool that checks blockchain transactions and addresses against predefined rules outlined in your Console.
Rules in Testnet
For testnet, nine (9) default rules are already in place. Therefore, you will not need to set up rules using this guide. Note that if you remove rules in testnet, the testing flows below will no longer work.
This guide allows you to trigger hits against each of these rules.
9999
triggers the Sanctioned Address rule.You can test the rules using both existing flows to trigger a screening evaluation against the magic value address generated in the previous steps:
You can trigger specific responses and actions using addresses with certain suffixes:
9999
8888
7777
8999
8899
8889
7779
7666
7766
These addresses will return the appropriate test responses, allowing you to verify the functionality of the screening system.
Note
This guide helps you test Circle’s transaction screening service thoroughly and ensures your applications comply with Circle’s rules for real-time transaction risk screening.
9999
.{
"transactionScreeningEvaluation": {
"ruleName": "Circle’s Sanctions Blocklist",
"actions": [
"REVIEW",
"FREEZE_WALLET"
],
"reasons": [
{
"source": "address",
"sourceValue": "addressValue",
"riskScore": "blocklist",
"riskCategories": [
"Sanctions"
],
"type": "OWNERSHIP"
}
],
"screeningDate": "<timestamp>"
}
}
8888
.{
"transactionScreeningEvaluation": {
"ruleName": "Frozen User Wallet",
"actions": [
"REVIEW"
],
"reasons": [
{
"source": "address",
"sourceValue": "addressValue",
"riskScore": "blocklist",
"riskCategories": [
"FROZEN"
],
"type": "OWNERSHIP"
}
],
"screeningDate": "<timestamp>"
}
}
7777
.{
"transactionScreeningEvaluation": {
"ruleName": "Your blocklist",
"actions": [
"REVIEW"
],
"reasons": [
{
"source": "address",
"sourceValue": "0xd89e56cba08ee44a9ca9f6c5f2f0e608227b7777",
"riskScore": "blocklist",
"riskCategories": [
"UNSUPPORTED"
],
"type": "OWNERSHIP"
}
],
"screeningDate": "<timestamp>"
}
}
8999
.{
"transactionScreeningEvaluation": {
"ruleName": "Severe Sanctions Risk (Owner)",
"actions": [
"REVIEW",
"FREEZE_WALLET"
],
"reasons": [
{
"source": "address",
"sourceValue": "0x21e936783ed3ced968ab083010eb14f359018999",
"riskScore": "severe",
"riskCategories": [
"SANCTIONS"
],
"type": "OWNERSHIP"
}
],
"screeningDate": "<timestamp>"
}
}
8899
.{
"transactionScreeningEvaluation": {
"ruleName": "Severe Terrorist Financing Risk (Owner)",
"actions": [
"REVIEW",
"FREEZE_WALLET"
],
"reasons": [
{
"source": "address",
"sourceValue": "0x01f43824a066cebe734f3d949e48392851cf8899",
"riskScore": "severe",
"riskCategories": [
"TERRORIST_FINANCING"
],
"type": "OWNERSHIP"
}
],
"screeningDate": "<timestamp>"
}
}
8889
.{
"transactionScreeningEvaluation": {
"ruleName": "Severe CSAM Risk (Owner)",
"actions": [
"REVIEW",
"FREEZE_WALLET"
],
"reasons": [
{
"source": "address",
"sourceValue": "0x068f626eacfbf669a0f4995b4de79f46cb9e8889",
"riskScore": "severe",
"riskCategories": [
"CSAM"
],
"type": "OWNERSHIP"
}
],
"screeningDate": “<timestamp>”
}
}
7779
.{
"transactionScreeningEvaluation": {
"ruleName": "Severe Illicit Behavior Risk (Owner)",
"actions": [
"REVIEW",
"FREEZE_WALLET"
],
"reasons": [
{
"source": "address",
"sourceValue": "0xd5d268603413c563a9739a4ca69214cc4ed77779",
"riskScore": "severe",
"riskCategories": [
"ILLICIT_BEHAVIOR"
],
"type": "OWNERSHIP"
}
],
"screeningDate": "<timestamp>"
}
}
7666
.{
"transactionScreeningEvaluation": {
"ruleName": "High Illicit Behavior Risk (Owner)",
"actions": [
"REVIEW"
],
"reasons": [
{
"source": "address",
"sourceValue": "address",
"riskScore": "high",
"riskCategories": [
"ILLICIT_BEHAVIOR"
],
"type": "OWNERSHIP"
}
],
"screeningDate": "<timestamp>"
}
}
7766
.{
"transactionScreeningEvaluation": {
"ruleName": "High Gambling Risk (Owner)",
"actions": [
"REVIEW"
],
"reasons": [
{
"source": "address",
"sourceValue": "0x2d6d4a938e7b69f9b67d815cd0c2737ebf897766",
"riskScore": "high",
"riskCategories": [
"GAMBLING"
],
"type": "OWNERSHIP"
}
],
"screeningDate": "<timestamp>"
}
}