메인 콘텐츠로 건너뛰기
Solana 프라이버시 링 API는 프라이버시 인덱서를 조회합니다. 암호화된 상태와 공개 트랜잭션 메타데이터를 반환합니다. 지갑은 페이로드를 복호화하여 비공개 잔액과 기록을 읽습니다. 개념은 프라이버시 개요를, 입금, 전송, 출금 흐름은 SDK를 참조하세요.

공개 잔액과 비공개 잔액

비공개 잔액은 UTXO(미사용 트랜잭션 출력)에 저장됩니다. UTXO는 Solana 계정이 아닙니다. 비공개 잔액의 저장 및 사용 방식은 비공개 상태와 UTXO를 참조하세요.

엔드포인트 및 인증

Helius API 키를 사용하여 메서드 경로로 JSON-RPC 2.0 요청을 보내세요.
method는 최종 URL 경로 세그먼트와 일치해야 합니다. 메서드 경로는 단일 요청만 허용합니다. 배치, 중복된 method 필드, 경로와 본문의 불일치는 실행 전에 HTTP 400을 반환합니다. 로컬 개발에서는 로컬 스택을 시작한 후 http://127.0.0.1:8784/{method}를 사용하세요.

메서드

getEncryptedUtxosByTags

보기 태그 또는 링으로 암호화된 출력을 검색합니다.

getShieldedTransactionsByTags

보기 태그 또는 링으로 차폐된 트랜잭션 기록을 조회합니다.

getShieldedTransactionsBySignature

하나의 Solana 트랜잭션에 대한 차폐된 이벤트를 가져옵니다.

getShieldedTransactionsByNullifiers

제공된 무효화자를 사용한 트랜잭션을 찾습니다.

getMerkleProofs

상태 트리 커밋먼트의 포함 증명을 가져옵니다.

getNonInclusionProofs

무효화자 값의 비포함 증명을 가져옵니다.

getNullifierQueueElements

대기열에 있는 무효화자를 시퀀스 순서로 읽습니다.

getUserRecords

공개 차폐 주소 등록을 조회합니다.

페이지네이션

getEncryptedUtxosByTags, getShieldedTransactionsByTags, getShieldedTransactionsByNullifiers는 result에 페이지를 반환합니다.
  • data는 결과를 Solana 트랜잭션별로 그룹화하며 슬롯과 서명의 오름차순으로 정렬합니다. 암호화된 UTXO 메서드는 각 그룹에서 outputs 배열을 사용하고, 트랜잭션 기록 메서드는 events 배열을 사용합니다.
  • limit는 Solana 트랜잭션 수를 나타내며 범위는 1~1,000이고 기본값은 1,000입니다. 한 트랜잭션에서 일치하는 출력 또는 이벤트는 하나의 페이지에 함께 유지됩니다.
  • null이 아닌 paginationToken를 동일한 태그 또는 무효화자, 링, 슬롯 필터와 함께 변경하지 않고 다시 전달하세요. 응답 토큰이 null가 될 때까지 계속하세요.
  • filters.slot는 gt, gte, lt, lte 경계를 허용합니다. 제공된 경계는 AND 조건으로 결합됩니다. 상한이 없는 읽기가 null 토큰에 도달하면 해당 페이지의 context.slot를 저장하고, 나중에 filters.slot.gt를 해당 값으로 설정하여 재개하세요. lt 또는 lte로 제한된 읽기는 해당 상한까지의 슬롯만 포함합니다. context.slot가 아니라 해당 상한부터 재개하세요.
  • 최소 영구 저장 인덱서 슬롯을 요구하려면 minContextSlot를 설정하세요. 인덱서는 paginationToken의 슬롯과 모든 gt 또는 gte 필터의 슬롯도 충족해야 합니다. 인덱서가 이 중 하나라도 따라잡지 못한 경우 error.data.contextSlot와 함께 오류 -32016를 반환합니다. 인덱서가 따라잡은 후 다시 시도하세요.
기록 응답에는 일시 중지되지 않은 최신 상태 트리 ID인 outputTreeId가 포함될 수도 있습니다. 사용할 수 없으면 생략됩니다. 개별 출력은 outputContext.treeId로 자체 트리를 식별합니다. getNullifierQueueElements는 시퀀스 기반 페이지네이션을 사용합니다. 자세한 내용은 메서드 페이지를 참조하세요.

데이터 인코딩

오류

HTTP 상태가 200인 경우를 포함하여 result를 읽기 전에 JSON-RPC error 필드를 확인하세요. HTTP 429는 요청 속도 제한을 나타냅니다. 요청 속도 제한을 참조하세요. API 키 설정은 인증을 참조하세요.