특정 주소 목록(block list)에 포함된 주소들이 대상 주소(target address)로 토큰을 전송할 때 알림을 제공합니다. 이 이벤트 타입은 주로 사전에 정의된 블록 리스트에 있는 주소들의 활동을 모니터링하고 싶을 때 활용됩니다. 예를 들어, 블랙리스트에 올라간 주소들이 특정 계정으로 자금을 이체하려고 시도할 때 즉시 경고를 받을 수 있습니다. 이를 통해 불법적이거나 의심스러운 자금 이동을 사전에 감지할 수 있는 유용한 도구입니다.
Supported Network
| Network | Supporting |
|---|---|
| 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 | ❌ |
Conditions
eventType값을 BLOCK_LIST_CALLER로 설정하는 경우, 사용 가능한 condition 객체 필드는 아래와 같습니다.
| Key | Type | Required | Description | Example Value |
|---|---|---|---|---|
| address | String | true | 토큰 전송 이벤트를 모니터링 하고자 하는 대상 주소 | 0x657fde0c1cb43c3ebbfa5bdcf9ab065fb89a62d5 |
| blockListCallers | Array of String | true | 대상 주소로 토큰 전송이 발생하는 경우 알림을 받고자 하는 주소의 목록 | [0x389aa657f2249d0225b337e338a84b01d0fb74eb] |
Response Example
Response 필드는 발생하는 Event type에 따라 달라질 수 있습니다.
📍 Type: ERC20
subscription_connected The user(8350954814192461336) is connected.
registered messageId: 123,
subscriptionId: 5091
subscription Event : subscriptionId: 5091,
eventType: BLOCK_LIST_CALLER,
event: {
"targetAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"blockListCaller": "0xdfd5293d8e347dfe59e90efd55b2956a1343963d",
"blockListCallers": [
"0xdfd5293d8e347dfe59e90efd55b2956a1343963d"
],
"messages": [
{
"block_hash": "0x72ead2932d1adcaa2d8194bbbccc94704a3c9d343f34cbd4c610ce9dcbd7efe9",
"block_number": 21570639,
"block_timestamp": 1736229335,
"from_address": "0xdfd5293d8e347dfe59e90efd55b2956a1343963d",
"gas": 220436,
"gas_price": 6681013225,
"hash": "0x3dd3d4e3fbf848e686342a157d8e986dcd9b8eee598010e9ae9ea16091fbc15b",
"input": "0xa9059cbb000000000000000000000000ac362803d14edd890a352e27a64e435c1e2934fa0000000000000000000000000000000000000000000000000000000f24638674",
"max_fee_per_gas": 102000000000,
"max_priority_fee_per_gas": 2000000000,
"nonce": 10542440,
"to_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"transaction_index": 68,
"transaction_type": 2,
"value": "0",
"access_list": [],
"receipt_contract_address": null,
"receipt_cumulative_gas_used": 9340339,
"receipt_effective_gas_price": 6681013225,
"receipt_gas_used": 46121,
"receipt_root": null,
"receipt_status": 1,
"type": "transaction"
}
]
}
📍 Type: ERC721
subscription_connected The user(8350954814192461336) is connected.
registered messageId: 123,
subscriptionId: 5091
subscription Event : subscriptionId: 5091,
eventType: BLOCK_LIST_CALLER,
event: {
"targetAddress": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8",
"blockListCaller": "0xdfd5293d8e347dfe59e90efd55b2956a1343963d",
"blockListCallers": [
"0xdfd5293d8e347dfe59e90efd55b2956a1343963d"
],
"messages": [
{
"block_hash": "0xeab8a4f8ecc6335e5859182e022ac96909ee01e9831664799bc9c42cea8731d0",
"block_number": 21570769,
"block_timestamp": 1736229335,
"from_address": "0xdfd5293d8e347dfe59e90efd55b2956a1343963d",
"gas": 146458,
"gas_price": 5296209271,
"hash": "0x841b0e12db029caf00487ef9d77e708f8ac03f695cbee3e76739e38e3f2c70a0",
"input": "0x23b872dd000000000000000000000000e82e5c47d1136806354b6aac5dec6c87a979694f0000000000000000000000008766d42076962de7147d4106f0769546932ad6ab000000000000000000000000000000000000000000000000000000000000089e",
"max_fee_per_gas": 102000000000,
"max_priority_fee_per_gas": 2000000000,
"nonce": 10542440,
"to_address": "0x8766d42076962De7147d4106f0769546932aD6Ab",
"transaction_index": 68,
"transaction_type": 2,
"value": "0",
"access_list": [],
"receipt_contract_address": null,
"receipt_cumulative_gas_used": 9340339,
"receipt_effective_gas_price": 6681013225,
"receipt_gas_used": 46121,
"receipt_root": null,
"receipt_status": 1,
"type": "transaction"
}
]
}
📍 Type: ERC1155
subscription_connected The user(8350954814192461336) is connected.
registered messageId: 123,
subscriptionId: 5091
subscription Event : subscriptionId: 5091,
eventType: BLOCK_LIST_CALLER,
event: {
"targetAddress": "0xD4416b13d2b3a9aBae7AcD5D6C2BbDBE25686401",
"blockListCaller": "0xdfd5293d8e347dfe59e90efd55b2956a1343963d",
"blockListCallers": [
"0xdfd5293d8e347dfe59e90efd55b2956a1343963d"
],
"messages": [
{
"block_hash": "0xee41f07a79ab5951cee5dda31d87d20937597cf8f88e76ed776dbb3387af56f6",
"block_number": 21570688,
"block_timestamp": 1736229335,
"from_address": "0x74024DCa09dAc188614d837f2ad4f5463946D657",
"gas": 300363,
"gas_price": 5204471625,
"hash": "0x5f4bf87277a4c451e991bff9f87347bd3b7f3495d3cef942b2636720f9c30683",
"input": "0x74694a2b000000000000000000000000000000000000000000000000000000000000010000000000000000000000000074024dca09dac188614d837f2ad4f5463946d6570000000000000000000000000000000000000000000000000000000003c267009923eb940000000304e294da75f36f9db9435da4e16b9843d919b0160f6e2c77000000000000000000000000231b0ee14048e9dccd1d247744d114a4eb5e8e63000000000000000000000000000000000000000000000000000000000000014000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000572656e636f0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000a48b95dd717a91de101d5056fe72687ebf1511c97ac0fece32dead625a2c972bb301c3c8af000000000000000000000000000000000000000000000000000000000000003c0000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000001474024dca09dac188614d837f2ad4f5463946d65700000000000000000000000000000000000000000000000000000000000000000000000000000000",
"max_fee_per_gas": 102000000000,
"max_priority_fee_per_gas": 2000000000,
"nonce": 10542440,
"to_address": "0x74024DCa09dAc188614d837f2ad4f5463946D657",
"transaction_index": 68,
"transaction_type": 2,
"value": "0",
"access_list": [],
"receipt_contract_address": null,
"receipt_cumulative_gas_used": 9340339,
"receipt_effective_gas_price": 6681013225,
"receipt_gas_used": 46121,
"receipt_root": null,
"receipt_status": 1,
"type": "transaction"
}
]
}