Skip to main content

Solana 웹훅이란?

Solana 웹훅은 온체인 이벤트가 발생할 때 애플리케이션에 실시간으로 전송되는 HTTP 알림입니다. 지속적으로 블록체인을 폴링하는 대신, Helius는 지갑이 자금을 이체하거나 NFT가 판매되거나 감시 중인 거래 유형이 발생할 때마다 구문 분석된 거래 데이터를 직접 엔드포인트로 푸시합니다. 웹훅을 사용하여 트레이딩 봇, 분석 대시보드, 컴플라이언스 파이프라인 및 이벤트 기반 자동화를 구현하세요. 사용자 친화적인 인터페이스, 프로그래매틱 API 및 SDK 액세스를 제공하여 웹훅을 쉽게 생성하고 관리할 수 있습니다. 자주 묻는 질문은 웹훅 FAQ를 참조하세요.
Helius는 서버가 성공적으로 응답하지 않으면 웹훅 전송을 재시도할 수 있으며, 중복 이벤트를 받을 수 있습니다. 재시도와 중복 처리에 대한 자세한 내용은 웹훅 FAQ를 참조하세요.

가격

Helius가 이벤트를 처리하고 엔드포인트로 전송할 때 웹훅 이벤트는 1 크레딧이 청구됩니다. 엔드포인트가 웹훅을 성공적으로 처리했는지와 관계없이 청구됩니다. API를 통해 웹훅을 편집, 추가 또는 삭제할 때는 요청당 100 크레딧이 소모됩니다.

웹훅의 유형

현재 다양한 요구에 맞춘 여러 종류의 웹훅을 제공하고 있습니다:

향상된 거래 웹훅

감시하는 주소와 관련된 특정 거래 유형(예: NFT 판매)에 대한 사람이 읽을 수 있는 구문 분석된 데이터를 제공합니다. 필터링된 실행 가능한 인사이트가 필요한 경우에 이상적입니다.

원시 거래 웹훅

감시하는 주소와 관련된 모든 거래에 대한 원시 거래 데이터를 전달합니다. 거래 유형별 필터링은 허용되지 않습니다.
원시 거래 웹훅은 이벤트 유형을 구문 분석하지 않으므로 낮은 지연 시간을 제공합니다.

Discord 웹훅

지정된 Discord 채널로 특정 거래 유형에 대한 업데이트를 형식화된 메시지로 직접 스트림합니다. 이 옵션을 사용하려면 Discord 웹훅 URL을 제출해야 합니다.

이벤트 페이로드 예제

시작하기

웹훅 빠른 시작

대시보드, REST API 또는 공식 TypeScript / Rust SDK를 통해 첫 번째 웹훅을 생성하세요.

실패하는 웹훅의 자동 비활성화

Helius는 웹훅 엔드포인트의 상태를 모니터링하고 지속적으로 전송에 실패하는 웹훅을 자동으로 비활성화합니다. 이는 도달할 수 없거나 고장 난 엔드포인트에 대한 전송 시도를 낭비하지 않도록 합니다.

작동 방식

  • 유료 플랜 (개발자 및 그 이상): 7일 동안 ≥ 95% 실패율을 보이는 웹훅은 자동으로 비활성화됩니다.
  • 무료 플랜: 24시간 동안 동일한 실패 임계값으로 웹훅이 평가됩니다.
시스템은 4시간마다 웹훅 상태를 확인합니다. 웹훅이 비활성화되면 수초 내로 전송이 중지됩니다.

이메일 알림

개발자 플랜 이상의 사용자에게는 웹훅이 자동으로 비활성화될 때 이메일 알림이 발송됩니다.

비활성화된 웹훅 다시 활성화하기

1

엔드포인트 수정

전송 실패의 원인을 해결하세요 (예: 서버 다운타임, 잘못된 URL, 엔드포인트 오류).
2

Helius 대시보드에 로그인

Helius 대시보드로 이동하세요.
3

웹훅 다시 활성화

비활성화된 웹훅을 찾아 다시 켜세요.
Toggle Webhook API endpoint를 통해 프로그래밍 방식으로 웹훅을 다시 활성화할 수도 있습니다.
다시 활성화한 후, 웹훅은 24시간 유예 기간에 들어가며 그동안 자동으로 비활성화되지 않습니다. 이 시간을 활용하여 엔드포인트가 제대로 작동하는지 확인하세요.

사용 예시

  • NFT가 마켓플레이스 X에 상장되면 “NFT 구매” 작업을 트리거합니다.
  • 마진 포지션이 불안정할 때 “청산” 작업을 트리거합니다.

모니터링 및 경고

  • 프로그램에서 특정 로그가 방출되면 PagerDuty 통합을 트리거합니다.
  • 토큰 계정 잔액이 X% 이상 변경될 때 Dialect를 사용하여 경고 작업을 전달합니다.

이벤트 기반 인덱싱

  • 지정된 프로그램에 대한 거래가 발생하면 직접 데이터베이스나 백엔드로 전송됩니다.

알림 및 활동 추적

  • 지갑 X에서 지갑 Y로 전송될 때 Slack 알림 또는 이메일을 전송합니다.

분석 및 로그

  • 이벤트 X가 발생하면 ETL 파이프라인에 보낸 후 시간을 두고 트렌드를 파악하기 위해 Helius에 직접 저장합니다.

워크플로 자동화

  • 이벤트 X가 발생하면 일련의 작업을 트리거합니다.