API Reference
Go to Nodit!

BLOCK_LIST_CALLER

특정 주소 목록(block list)에 포함된 주소들이 대상 주소(target address)로 토큰을 전송할 때 알림을 제공합니다. 이 이벤트 타입은 주로 사전에 정의된 블록 리스트에 있는 주소들의 활동을 모니터링하고 싶을 때 활용됩니다. 예를 들어, 블랙리스트에 올라간 주소들이 특정 계정으로 자금을 이체하려고 시도할 때 즉시 경고를 받을 수 있습니다. 이를 통해 불법적이거나 의심스러운 자금 이동을 사전에 감지할 수 있는 유용한 도구입니다.

Supported Network

NetworkSupporting
Ethereum Mainnet✅
Ethereum Testnet (sepolia)✅
Ethereum Testnet (holesky)✅
Polygon Mainnet✅
Polygon Testnet (amoy)✅
Arbitrum Mainnet✅
Arbitrum Testnet (sepolia)✅
Optimism Mainnet✅
Optimism Testnet (sepolia)✅
Kaia Mainnet✅
Kaia Testnet (kairos)✅
Aptos Mainnet❌
Aptos Testnet❌

Webhook 생성 요청 예제

eventType값을 BLOCK_LIST_CALLER로 설정하는 경우, 사용 가능한 condition 객체 필드는 아래와 같습니다.

KeyTypeRequiredDescriptionExample Value
addressStringtrue토큰 전송 이벤트를 모니터링 하고자 하는 대상 주소0x657fde0c1cb43c3ebbfa5bdcf9ab065fb89a62d5
blockListCallersArray of Stringtrue대상 주소로 토큰 전송이 발생하는 경우 알림을 받고자 하는 주소의 목록[0x389aa657f2249d0225b337e338a84b01d0fb74eb]

Request Example

curl --location 'https://web3.nodit.io/v1/ethereum/mainnet/webhooks' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: ••••••' \
--data '{
  "eventType": "BLOCK_LIST_CALLER",
  "description": "{WEBHOOK_DESCRIPTION}",
  "notification": {
    "webhookUrl": "{WEBHOOK_LISTENER_ENDPOINT}"
  },
  "condition": {
    "address": "0x657fde0c1cb43c3ebbfa5bdcf9ab065fb89a62d5",
    "blockListCallers": ["0x389aa657f2249d0225b337e338a84b01d0fb74eb"]
  }
}'

Response Example

🚧

Response 필드는 발생하는 Event type에 따라 달라질 수 있습니다.

📍 Type: ERC20

{
  "subscriptionId": "4975",
  "description": "{WEBHOOK_DESCRIPTION}",
  "protocol": "ethereum",
  "network": "mainnet",
  "subscriptionType": "WEBHOOK",
  "notification": {
    "webhookUrl": "{WEBHOOK_LISTENER_ENDPOINT}"
  },
  "signingKey": "{signingKey}",
  "eventType": "BLOCK_LIST_CALLER",
  "event": {
    "targetAddress": "0x657fde0c1cb43c3ebbfa5bdcf9ab065fb89a62d5",
    "blockListCaller": "0x389aa657f2249d0225b337e338a84b01d0fb74eb", // ⚠️ This field will be deprecated soon
    "blockListCallers": [
			"0x389aa657f2249d0225b337e338a84b01d0fb74eb",
			"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
		],
    "messages": [
      {
        "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "from_address": "0x389aa657f2249d0225b337e338a84b01d0fb74eb",
        "to_address": "0x657fde0c1cb43c3ebbfa5bdcf9ab065fb89a62d5",
        "value": "375000000",
        "transaction_hash": "0x1c64e4a1009c8110ac20ae082a40541f23cc1ea953e9cf17e8bb32f642b5f4ee",
        "log_index": 214,
        "block_number": 21492608,
        "block_timestamp": 1735288199,
        "type": "erc20"
      }
    ]
  },
  "createdAt": "2024-12-27T08:31:59.466Z"
}

📍 Type: ERC721

{
  "subscriptionId": "4975",
  "description": "{WEBHOOK_DESCRIPTION}",
  "protocol": "ethereum",
  "network": "mainnet",
  "subscriptionType": "WEBHOOK",
  "notification": {
    "webhookUrl": "{WEBHOOK_LISTENER_ENDPOINT}"
  },
  "signingKey": "{signingKey}",
  "eventType": "BLOCK_LIST_CALLER",
  "event": {
    "targetAddress": "0x976db6a4415531af5c96be3013dbbccf7ec2a0fd",
    "blockListCaller": "0xce4d5ffbb39a07ffc12f3a0800f08cd9909cd0ea", // ⚠️ This field will be deprecated soon
    "blockListCallers": [
			"0xce4d5ffbb39a07ffc12f3a0800f08cd9909cd0ea",
			"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
		],
    "messages": [
      {
        "block_number": 21492607,
        "block_timestamp": 1735288187,
        "from_address": "0xce4d5ffbb39a07ffc12f3a0800f08cd9909cd0ea",
        "log_index": 341,
        "to_address": "0x976db6a4415531af5c96be3013dbbccf7ec2a0fd",
        "token_address": "0x6f36d6a10a04a81ade402a98a0840ffdf99b8579",
        "token_id": "4674",
        "transaction_hash": "0xa006045b54bf6f56d1fe7be3be77d6bec9ddc838199400b8497d7e5650cb65ef",
        "type": "erc721"
      }
    ]
  },
  "createdAt": "2024-12-27T08:31:28.707Z"
}

📍 Type: ERC1155

{
  "subscriptionId": "4975",
  "description": "{WEBHOOK_DESCRIPTION}",
  "protocol": "ethereum",
  "network": "mainnet",
  "subscriptionType": "WEBHOOK",
  "notification": {
    "webhookUrl": "{WEBHOOK_LISTENER_ENDPOINT}"
  },
  "signingKey": "{signingKey}",
  "eventType": "BLOCK_LIST_CALLER",
  "event": {
    "targetAddress": "0x4a06f2320b17040001174331a4ef89c8214bbf43",
    "blockListCaller": "0xc4dad120712a92117cc65d46514be8b49ed846a1", // ⚠️ This field will be deprecated soon
    "blockListCallers": [
			"0xc4dad120712a92117cc65d46514be8b49ed846a1",
			"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
		],
    "messages": [
      {
        "batch_index": 0,
        "block_number": 21492633,
        "block_timestamp": 1735288499,
        "from_address": "0xc4dad120712a92117cc65d46514be8b49ed846a1",
        "log_index": 302,
        "operator": "0x1e0049783f008a0085193e00003d00cd54003c71",
        "to_address": "0x4a06f2320b17040001174331a4ef89c8214bbf43",
        "token_address": "0x10f62ca5f836a8ed4d80968500ef430fcd8813b0",
        "token_id": "1",
        "transaction_hash": "0x0c05e3d2a6eff38d250f6f6acbefcad6546d4fdc832b33e3d246cf27fce8d57e",
        "value": "1",
        "type": "erc1155"
      }
    ]
  },
  "createdAt": "2024-12-27T08:36:39.616Z"
}