Changelog
Go to Nodit!
Start typing to search…
Back to All
Added

Flexible Webhook: Filter Smarter, Receive Only What Matters

2 days ago

원하는 온체인 이벤트만, 원하는 형태로 받아보세요. Flexible Webhook은 CEL 기반 필터링과 선택적 출력 필드로 Webhook을 완전히 커스터마이징합니다. 조건 설정부터 테스트, 실패 재전송까지 콘솔 하나로 완결됩니다.

Flexible Webhook

기존 Classic Webhook은 Event Type별로 고정된 조건과 페이로드를 제공합니다. Flexible Webhook은 CEL 표현식으로 필터 조건을 직접 정의하고, 필요한 필드만 선택하여 수신할 수 있습니다. 콘솔에서 생성부터 테스트, 재전송까지 한 곳에서 관리합니다.


Supported Stream Types

6개의 스트림 타입을 지원합니다. EVM 호환 체인 공통이며, 모든 지원 체인에서 동일한 구조를 가집니다.

  • Block — 블록 생성 이벤트
  • ERC-20 Transfer — ERC-20 토큰 전송
  • ERC-721 Transfer — ERC-721 NFT 전송
  • ERC-1155 Transfer — ERC-1155 멀티토큰 전송
  • Log — 스마트 컨트랙트 이벤트 로그
  • Transaction Receipt — 트랜잭션 실행 결과

Key Features

  • Precise Condition Builder: 비주얼 모드(노코드 UI)와 텍스트 모드(CEL 표현식)로 필터 조건을 구성합니다. AND/OR 논리 그룹을 지원하며, bigint_gt, address_eq 등 블록체인 특화 커스텀 함수를 제공합니다.
  • Usable Templates: USDC Whale Transfer, Token Burn, Failed Transaction 등 자주 사용되는 조건 패턴을 Preset으로 제공합니다. 선택 시 조건과 출력 필드가 자동 설정됩니다.
  • Live Testing: 웹훅 생성 전에 실제 온체인 데이터로 설정을 검증합니다. Live Sample로 선택한 스트림의 최근 이벤트를 확인하고, Test Webhook으로 Endpoint 수신 여부를 테스트합니다.
  • Selective Output Fields: 웹훅 페이로드에 포함할 필드를 직접 선택합니다. 불필요한 필드를 제외하여 페이로드 크기를 줄일 수 있습니다.
  • Easy Resend: 전송 히스토리에서 실패 메시지를 선택하여 콘솔에서 즉시 재전송합니다.

이 외에도 Instant Webhook 옵션으로 블록 컨펌을 기다리지 않고 메시지를 빠르게 수신할 수 있습니다. 기본값은 Off이며, 활성화 시 reorg로 인한 데이터 변경 가능성이 있습니다.


Security & Reliability

  • 서명 검증: 모든 메시지의 x-signature 헤더에 HMAC-SHA256 서명을 포함합니다. Signing Key는 콘솔에서 조회할 수 있습니다.
  • 자동 재시도: 200 OK를 받지 못하면 15초 후 최대 1회 재시도합니다.
  • 멱등성 지원: 스트림 타입별 Idempotency Key 조합을 제공하여 중복 처리를 방지합니다.

Documentation