preconfSubscribe란 무엇인가요?
preconfSubscribe는 Helius WebSocket 메서드로, 사전 확인 — 즉, 분해되기 전에 예정된 거래 단계를 전달합니다. 이는 Helius가 제공하는 가장 낮은 대기 시간의 거래 신호입니다. Professional 플랜 이상의 가입이 필요합니다 — 가격을 참조하세요.
스트림은 연속적이지 않습니다. 커버리지는 Helius로 전달된 지분의 비율에 비례하므로, 메시지가 없는 슬롯이 존재할 수 있습니다 — 이러한 간극을 잘 처리하십시오. 커버리지를 참조하세요.
preconfSubscribe는 mainnet.helius-rpc.com 대신 Helius Gatekeeper 엔드포인트인 wss://beta.helius-rpc.com에서 제공됩니다. API 키로 쿼리 매개변수를 통해 인증하십시오.
beta 호스트명은 Gatekeeper 롤아웃을 언급하며,
사전 확인의 성숙도를 나타내지 않습니다. 사전 확인은 Gatekeeper 엔드포인트에서 처음
시작됩니다; Helius가 트래픽을 Gatekeeper로 마이그레이션하면서 표준 엔드포인트가 될 것입니다.구독
preconfSubscribe 메서드를 사용하여 JSON-RPC 요청을 전송하십시오. 서버는 구독 ID로 응답한 후 각 예정된 거래에 대한 알림을 스트리밍합니다. 일치하는 거래만 받기 위해 첫 번째 params 요소로 선택적 필터를 전달하십시오; 전체 스트림을 받으려면 params를 생략하십시오.
구독 응답
result를 저장하십시오 — 이는 구독 취소에 사용되는 구독 ID입니다. 이 확인 후, 알림은 바이너리 프레임으로 스트리밍됩니다 (아래 참조).
필터링
기본적으로preconfSubscribe는 모든 예정된 거래를 스트리밍합니다. 스트림을 좁히려면 첫 번째 요소로 필터 개체를 params에 전달하십시오. 필터링은 서버 측에서 수행되므로, 관심 있는 거래만 받으며 비용을 지불합니다.
params 없음)는 모든 거래에 일치합니다.
필터 규칙:
- 모든 조건자는 AND로 결합되어 평가 순서는
regionInclude→accountExclude→accountRequired→accountInclude입니다. - 계정은 base58로 인코딩된 공개키입니다. 잘못된 값은 JSON-RPC 오류
-32602(잘못된 매개변수)를 반환합니다. - 각 계정 목록은 500개 항목으로 제한됩니다.
주소 조회 테이블 (ALT) 해석
계정 필터는 거래의 정적 계정 키보다 더 많은 것을 일치합니다 — Helius는 v0 주소 조회 테이블을 서버 측에서 해석하므로accountInclude, accountExclude 및 accountRequired는 거래가 ALT를 통해 로드하는 계정도 일치합니다.
이렇게 하면 조회 테이블 뒤에만 나타나더라도 거래가 건드리는 모든 계정에 대해 필터링 할 수 있습니다 — ALT 매핑을 유지하거나 테이블을 직접 해석할 필요가 없습니다. 계정의 공개키를 전달하면 Helius가 필터링이 적용되기 전에 해석을 처리합니다.
지역 필터링
특정 Helius 지역에서 시작된 거래만 받으려면regionInclude를 사용하십시오. 하나 이상의 지역 코드를 전달하십시오; 거래의 원산지 지역이 이 중 하나와 일치하면 거래가 통과됩니다.
regionInclude가 설정되면 지역 정보를 포함하지 않은 거래는 삭제됩니다. 인식되지 않은 지역 코드는 JSON-RPC 오류 -32602 (잘못된 매개변수)를 반환합니다.알림 페이로드
알림은 바이너리 WebSocket 프레임으로 전달됩니다 (JSON 아님). 각 프레임은 단일 예정된 거래를 전송하는 압축 바이트 레이아웃입니다:
필드를 순서대로 읽은 다음, 남은 바이트를
VersionedTransaction로 bincode-역직렬화하여 명령, 계정 및 서명을 읽습니다.
사전 확인은 초기 신호이지 보장이 아닙니다. 거래는 아직 온체인에 기록되지 않았으며 실패하거나 삭제될 수 있습니다. 마지막으로 처리하기 전에 표준 커밋 확인을 통해 기록 여부를 확인하십시오.
예시
구독 취소
알림 수신을 중지하려면preconfSubscribe에서 반환된 구독 ID를 사용하여 preconfUnsubscribe을 호출하십시오.
가격
사전 확인은 Professional 플랜 이상이 필요하며 메시지당 10 크레딧이 소요됩니다 — 스트리밍된 거래당 한 메시지입니다 — 폐하의 플랜에서 청구됩니다. 자세한 내용은 크레딧을 참조하세요.사전 확인은 새로운 제품이며 가격은 변경될 수 있습니다.
관련 항목
사전 확인 개요
사전 확인이란 무엇이며 검증자 파이프라인에서의 위치.
transactionSubscribe
풍부한 필터링으로 확인된 커밋 거래를 스트리밍합니다.
preconfSubscribe API 참조
요청 매개변수, 필터 필드 및 바이너리 알림 레이아웃.