メインコンテンツへスキップ
POST
getEncryptedUtxosByTags

暗号化済み出力

このメソッドを使用して、クライアント側で復号するための暗号化済み UTXO を取得します。ウォレットは出力を復号し、各資産の未使用額を合計してプライベート残高を算出します。 これは、アドレスが所有する SPL Token アカウントを返す Solana の getTokenAccountsByOwner に相当します。プライベート残高は Solana アカウントではなく UTXO に保存されるため、専用の RPC メソッドが必要です。詳しくは、プライベートステートと UTXO を参照してください。 このメソッドは、一致する出力を result.data に Solana トランザクションごとにグループ化して返します。各エントリには、トランザクションの slot と signature が含まれます。出力には、暗号文、ビュータグ、コミットメント、ツリー ID、リーフインデックスが含まれます。 レスポンスには、すでに使用済みである可能性のある過去の出力も含まれます。使用可能残高を算出するには、ウォレットで Nullifier を追跡する必要があります。プライベート残高ガイドを参照してください。 空の tags 配列を指定する場合は ringProgramId が必要であり、そのリングから出力を選択します。両方を指定した場合、出力はタグとリングの両方に一致する必要があります。 ページ制限、継続トークン、増分読み取りについては、ページネーションと鮮度を参照してください。

リクエストパラメータ

object
スロットの範囲です。上限なしの読み取りが最新状態に追いついた後で再開するには、slot.gt を最後のページの context.slot に設定します。
object
読み取り対象のスロット範囲です。指定した範囲条件は AND で結合されます。
number
このスロットより後のトランザクションのみを含めます。
number
このスロット以降のトランザクションのみを含めます。
number
このスロットより前のトランザクションのみを含めます。
number
このスロット以前のトランザクションのみを含めます。
number
デフォルト:"1000"
1 ページあたりの Solana トランザクションの最大数です。1〜1,000 の範囲で指定します。
number
この読み取りに必要な、永続化済みインデクサーの最小スロットです。インデクサーが遅れている場合は、JSON-RPC エラー -32016 を返します。
string
前のレスポンスから取得した継続トークンです。同じタグ、リング、スロットフィルターとともに、変更せずに渡してください。
string
このプログラム ID によって認可されたリングに結果を限定します。tags が空の場合は必須です。
array
必須
Base58 でエンコードされた 32 バイトのビュータグです。最大 1,000 個です。空の配列を指定する場合は ringProgramId が必要であり、そのリングが選択されます。

承認

api-key
string
query
必須

Helius API キーです。

ボディ

application/json
id
string
デフォルト:1
必須

リクエストを識別するための ID です。

jsonrpc
enum<string>
デフォルト:2.0
必須

JSON-RPC プロトコルのバージョンです。

利用可能なオプション:
2.0
method
enum<string>
デフォルト:getEncryptedUtxosByTags
必須

呼び出すメソッドです。URL パスの最後のセグメントと一致する必要があります。

利用可能なオプション:
getEncryptedUtxosByTags
params
object
必須
例:

レスポンス

JSON-RPC レスポンスです。result を読み取る前に error を確認してください。

id
string
必須

リクエスト ID です。

jsonrpc
enum<string>
必須

JSON-RPC プロトコルのバージョンです。

利用可能なオプション:
2.0
error
object
result
object

gTFA 形式のページネーションを使用する、履歴読み取りの範囲が限定された 1 ページです。