API Reference
Go to Nodit!

FAILED_TRANSACTION

특정 주소가 발송한 트랜잭션이 실패했을 때 알림을 제공합니다. 이 이벤트는 트랜잭션이 블록체인 네트워크에 의해 거부되거나, 실행 중 오류가 발생하여 완료되지 못했을 경우 발생합니다. 이를 통해 사용자는 트랜잭션 실패의 원인을 신속하게 파악하고, 필요한 조치를 취할 수 있습니다. 실패 이윤이 가스 부족, 계약 조건 불충족 등 다양한 기술적 문제로 인해 발생할 수 있으며, 이 이벤트는 블록체인 상의 트랜잭션 관리와 오류 추적을 보다 효과적으로 수행할 수 있게 도와줍니다.

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

KeyTypeRequiredDescriptionExample Value
addressesArray of Stringtrue모니터링 하고자 하는 트랜잭션의 sender 주소 목록. 배열에 포함된 주소 중 하나라도 from에 포함된 트랜잭션이 발생하는 경우 알림을 수신할 수 있습니다.["0x80bad9274698b29ff66ad0b564c622600571801f",
"0x56Eddb7aa87536c09CCc2793473599fD21A8b17F"]

Request Example

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

Response Example

{
  "subscriptionId": "4975",
  "description": "{WEBHOOK_DESCRIPTION}",
  "protocol": "ethereum",
  "network": "mainnet",
  "subscriptionType": "WEBHOOK",
  "notification": {
    "webhookUrl": "{WEBHOOK_LISTENER_ENDPOINT}"
  },
  "signingKey": "{signingKey}",
  "eventType": "FAILED_TRANSACTION",
  "event": {
    "targetAddress": "0x80bad9274698b29ff66ad0b564c622600571801f", // ⚠️ This field will be deprecated soon
    "targetAddresses": [
			"0x80bad9274698b29ff66ad0b564c622600571801f",
			"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
		],
    "messages": [
      {
        "block_hash": "0xb0ce231f5309b5a344dd82a3f93589a2e93af6f581ca593888e92bf3e31f4df8",
        "block_number": 21492093,
        "block_timestamp": 1735281935,
        "from_address": "0x80bad9274698b29ff66ad0b564c622600571801f",
        "gas": 39616,
        "gas_price": 4302402300,
        "hash": "0x90b2f514a100e353d3b0a2925f259e8e51c60c8c597d7efd5ec29704ce935a9d",
        "input": "0x2e1a7d4d0000000000000000000000000000000000000000000000000027147114878000",
        "max_fee_per_gas": 5811335067,
        "max_priority_fee_per_gas": 899405285,
        "nonce": 38,
        "to_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "transaction_index": 88,
        "transaction_type": 2,
        "value": "0",
        "access_list": [],
        "receipt_contract_address": null,
        "receipt_cumulative_gas_used": 8324968,
        "receipt_effective_gas_price": 4302402300,
        "receipt_gas_used": 23731,
        "receipt_root": null,
        "receipt_status": 0,
        "type": "transaction"
      }
    ]
  },
  "createdAt": "2024-12-27T06:47:35.992Z"
}