Transaction notify Webhook

Matic, Token 전송 이벤트를 추적하기 위한 Webhook 기능에 대한 기술 설명 문서입니다.
해당 API를 사용하면 설정된 주소의 트랜잭션이 발생할 때마다 실시간 상태 변경에 관련된 내용이 제공됩니다.

Webhook IP address#

보안을 위해서 특정 IP만 Webhook 호출을 허용해야 합니다.
해당 IP를 화이트리스트에 추가해 주세요

54.236.136.17
34.237.24.169

전송 유형#

트랜잭션 발생에는 2가지 주요 이벤트가 있습니다.

1. Matic Transfer
Matic 전송에 관련된 이벤트 로그입니다.

2. Token Transfer
토큰 전송에 관련된 이벤트 로그입니다.

Matic Transfer

웹훅 반환값#

Result

Event Object

Activity Object

{
  "webhookId": "wh_gb4a4ofh5pawkozp",
  "id": "whevt_gbjk4s7bue4zqcf5",
  "createdAt": "2022-07-22T19:22:33.313Z",
  "type": "ADDRESS_ACTIVITY",
  "event": {
    "network": "MATIC_MUMBAI", // 트랜잭션이 발생한 네트워크 (Matic Main network는 MATIC_MAINNET)
    "activity": [
      {
        "fromAddress": "0x13e7162e2f165de89bd9ad29a18ace74ae1c77d8", // 전송자 지갑 주소
        "toAddress": "0x92029b49f67785cebe41a5e36b1a9afb4ac2497d", // 수신자 지갑 주소
        "blockNum": "0x1a06937",
        "hash": "0x90c0727cf9fbf0c55d1ed2e95d246aad76678cb61393027ed85d44a68ac72b32",
        "value": 0.0001, // 전송 수량
        "asset": "MATIC", // 토큰명 (토큰명은 중복이 가능하기 때문에 이것으로 토큰을 구분해서는 안됨)
        "category": "external", // Matic Transfer임을 알 수 있는 구분자
        "rawContract": {
          "rawValue": "0x5af3107a4000",
          "decimals": 18
        }
      }
    ]
  }
}

Token Transfer

웹훅 반환값#

Result

Event Object

Activity Object

{
  "webhookId": "wh_gb4a4ofh5pawkozp",
  "id": "whevt_je2z4dl1pabbbdf1",
  "createdAt": "2022-07-22T19:27:54.750Z",
  "type": "ADDRESS_ACTIVITY",
  "event": {
    "network": "MATIC_MUMBAI", // 트랜잭션이 발생한 네트워크 (Matic Main network는 MATIC_MAINNET)
    "activity": [
      {
        "fromAddress": "0x92029b49f67785cebe41a5e36b1a9afb4ac2497d", // 발신자 지갑 주소
        "toAddress": "0x13e7162e2f165de89bd9ad29a18ace74ae1c77d8", // 수신자 지갑 주소
        "blockNum": "0x1a06977",
        "hash": "0x40827a41c7e25da903979d6f1b2ab84a2664251768f9eeb898c8d9a6d013789b",
        "value": 500, // 전송 수량
        "asset": "MBT", // 토큰명 (토큰명은 중복이 가능하기 때문에 이것으로 토큰을 구분해서는 안됨)
        "category": "token", // Token Transfer임을 구분할 수 있는 구분자
        "rawContract": {
          "rawValue": "0x00000000000000000000000000000000000000000000001b1ae4d6e2ef500000",
          "address": "0xceca5de7bbb16c951d6c8f7a70ac7caa9e8d34af", // 토큰 컨트랙트 구분자 (이것으로 토큰 구분해야함)
          "decimals": 18
        },
        "log": {
          "address": "0xceca5de7bbb16c951d6c8f7a70ac7caa9e8d34af",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x00000000000000000000000092029b49f67785cebe41a5e36b1a9afb4ac2497d",
            "0x00000000000000000000000013e7162e2f165de89bd9ad29a18ace74ae1c77d8"
          ],
          "data": "0x00000000000000000000000000000000000000000000001b1ae4d6e2ef500000",
          "blockNumber": "0x1a06977",
          "transactionHash": "0x40827a41c7e25da903979d6f1b2ab84a2664251768f9eeb898c8d9a6d013789b",
          "transactionIndex": "0x5",
          "blockHash": "0x2dd9b88836c448475661980d4621fe1c669560558543fbe06ecb5c0a49f63540",
          "logIndex": "0x9",
          "removed": false
        }
      }
    ]
  }
}