API Reference
Go to Nodit!

ALLOW_LIST_CALLER

허용 리스트(allow list)에 포함된 주소들이 대상 주소로 토큰을 전송할 때 알림을 제공합니다. 이 리스트에는 신뢰할 수 있는 주소들이 포함되어 있으며, 해당 주소들로부터의 자금 이동은 안전하거나 예상된 활동으로 간주됩니다. 이 이벤트 타입은 허용된 주소들의 활동을 추적하고, 허용 리스트에 포함된 주소로부터의 자금 이체를 확증하고자 할 때 사용됩니다.

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값을 ALLOW_LIST_CALLER로 설정하는 경우, 사용 가능한 condition 객체 필드는 아래와 같습니다.

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

Request Example

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

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": "ALLOW_LIST_CALLER",
  "event": {
    "targetAddress": "0xe4a27d6b7c751b33b2f033019fdf196e8b329d7a",
    "allowListCaller": "0xcc869c4d92c19776d8998dec4688a9539d5c8ae6", // ⚠️ This field will be deprecated soon
    "allowListCallers": [
			"0xcc869c4d92c19776d8998dec4688a9539d5c8ae6",
			"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
		],
    "messages": [
      {
        "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "from_address": "0xcc869c4d92c19776d8998dec4688a9539d5c8ae6",
        "to_address": "0xe4a27d6b7c751b33b2f033019fdf196e8b329d7a",
        "value": "11000000000",
        "transaction_hash": "0xfec28fc60dd99b0813b6c2de254ee504eaa0d83e1f3ebc122bea3d5d4e1c7843",
        "log_index": 395,
        "block_number": 21492661,
        "block_timestamp": 1735288835,
        "type": "erc20"
      }
    ]
  },
  "createdAt": "2024-12-27T08:42:35.452Z"
}

📍 Type: ERC721

{
  "subscriptionId": "4975",
  "description": "{WEBHOOK_DESCRIPTION}",
  "protocol": "ethereum",
  "network": "mainnet",
  "subscriptionType": "WEBHOOK",
  "notification": {
    "webhookUrl": "{WEBHOOK_LISTENER_ENDPOINT}"
  },
  "signingKey": "{signingKey}",
  "eventType": "ALLOW_LIST_CALLER",
  "event": {
    "targetAddress": "0xa099ec99966fa615c29b1ec56ce403fe655bca40",
    "allowListCaller": "0x59ec3e809c2da447d0f5e7f8c19722fa7d6e3dd5", // ⚠️ This field will be deprecated soon
    "allowListCallers": [
			"0x59ec3e809c2da447d0f5e7f8c19722fa7d6e3dd5",
			"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
		],
    "messages": [
      {
        "token_address": "0xb6a37b5d14d502c3ab0ae6f3a0e058bc9517786e",
        "from_address": "0x59ec3e809c2da447d0f5e7f8c19722fa7d6e3dd5",
        "to_address": "0xa099ec99966fa615c29b1ec56ce403fe655bca40",
        "token_id": "6529",
        "transaction_hash": "0xeaad4c6bdc4c922e1e9f8dcaa9cf3961ddbf246840d5b15eeed43ec7bdbd0ce9",
        "log_index": 207,
        "block_number": 21492662,
        "block_timestamp": 1735288847,
        "type": "erc721"
      }
    ]
  },
  "createdAt": "2024-12-27T08:42:46.341Z"
}

📍 Type: ERC1155

{
  "subscriptionId": "4975",
  "description": "{WEBHOOK_DESCRIPTION}",
  "protocol": "ethereum",
  "network": "mainnet",
  "subscriptionType": "WEBHOOK",
  "notification": {
    "webhookUrl": "{WEBHOOK_LISTENER_ENDPOINT}"
  },
  "signingKey": "{signingKey}",
  "eventType": "ALLOW_LIST_CALLER",
  "event": {
    "targetAddress": "0x4a06f2320b17040001174331a4ef89c8214bbf43",
    "allowListCaller": "0xc4dad120712a92117cc65d46514be8b49ed846a1", // ⚠️ This field will be deprecated soon
    "allowListCallers": [
			"0xc4dad120712a92117cc65d46514be8b49ed846a1",
			"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
		],
    "messages": [
      {
        "batch_index": 0,
        "block_number": 21492667,
        "block_timestamp": 1735288907,
        "from_address": "0xc4dad120712a92117cc65d46514be8b49ed846a1",
        "log_index": 195,
        "operator": "0x1e0049783f008a0085193e00003d00cd54003c71",
        "to_address": "0x4a06f2320b17040001174331a4ef89c8214bbf43",
        "token_address": "0x10f62ca5f836a8ed4d80968500ef430fcd8813b0",
        "token_id": "1",
        "transaction_hash": "0xe3e8d0525d16794f7c6317d59fad73495f387f22817b0281bee912ac504b64ca",
        "value": "4",
        "type": "erc1155"
      }
    ]
  },
  "createdAt": "2024-12-27T08:43:28.716Z"
}