> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# getShieldedTransactionsByTags

> ビュータグまたは特定のリングに一致するシールドトランザクションイベントを取得します。

## トランザクション履歴

タグによってトランザクションを選択します。`result.data` の各エントリには、選択された 1 件の Solana トランザクションのすべてのイベントが格納されます。`ringProgramId` を指定した場合は、それによって制限されます。イベントには、暗号化された出力、メッセージ、無効化子、リングメタデータが含まれます。ウォレット内でペイロードを復号し、金額と資産を復元してください。[プライベート履歴ガイド](https://www.helius.dev/docs/ja/privacy/guides/read-history.md)を参照してください。

タグは、出力ビュータグおよびメッセージビュータグと照合されます。空の `tags` 配列を指定する場合は `ringProgramId` が必要であり、受信者タグのないトランザクションを含む、そのリングの履歴が選択されます。両方を指定した場合、トランザクションはタグとリングの両方に一致する必要があります。

ページ制限、継続トークン、増分読み取りについては、[ページネーションと鮮度](https://www.helius.dev/docs/ja/api-reference/privacy.md#ページネーション)を参照してください。

## リクエストパラメータ

**filters** `object`

スロットの範囲です。上限なしの読み取りが最新状態に追いついた後に再開するには、`slot.gt` を前のページの `context.slot` に設定します。

**filters.slot** `object`

読み取り対象のスロット範囲です。指定した範囲条件は AND で結合されます。

**filters.slot.gt** `number`

このスロットより後のトランザクションのみを含めます。

**filters.slot.gte** `number`

このスロット以降のトランザクションのみを含めます。

**filters.slot.lt** `number`

このスロットより前のトランザクションのみを含めます。

**filters.slot.lte** `number`

このスロット以前のトランザクションのみを含めます。

**limit** `number` (default: 1000)

ページあたりの Solana トランザクションの最大数です。1～1,000 の範囲で指定します。

**minContextSlot** `number`

この読み取りに必要な、永続化済みのインデクサーの最小スロットです。インデクサーが遅れている場合は、JSON-RPC エラー -32016 を返します。

**paginationToken** `string`

前のレスポンスから取得した継続トークンです。同じタグ、リング、スロットフィルターとともに、変更せずに再度渡してください。

**ringProgramId** `string`

結果を、このプログラム ID によって承認されたリングに限定します。tags が空の場合は必須です。

**tags** `array` *required*

Base58 でエンコードされた 32 バイトのビュータグです。最大 1,000 個です。空の配列を指定する場合は ringProgramId が必要であり、そのリングが選択されます。


## OpenAPI

````yaml ja/openapi/privacy/getShieldedTransactionsByTags.yaml POST /v1/spr/getShieldedTransactionsByTags
openapi: 3.0.3
info:
  title: Solana プライバシーリング API
  version: 0.51.2
  description: 暗号化された状態、履歴、証明、公開レジストリレコード向けのプライバシーインデクサー JSON-RPC API。
servers:
  - url: https://devnet.helius-rpc.com
    description: Devnet Solana プライバシーリング API
security: []
paths:
  /v1/spr/getShieldedTransactionsByTags:
    post:
      summary: getShieldedTransactionsByTags
      description: ビュータグまたは特定のリングに一致するシールドトランザクションイベントを取得します。
      operationId: getShieldedTransactionsByTags
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                id:
                  type: string
                  description: リクエストを識別するための ID。
                  default: '1'
                jsonrpc:
                  type: string
                  description: JSON-RPC プロトコルのバージョン。
                  enum:
                    - '2.0'
                  default: '2.0'
                method:
                  type: string
                  description: 呼び出すメソッド。URL パスの最後のセグメントと一致する必要があります。
                  enum:
                    - getShieldedTransactionsByTags
                  default: getShieldedTransactionsByTags
                params:
                  type: object
                  required:
                    - tags
                  properties:
                    filters:
                      allOf:
                        - $ref: '#/components/schemas/HistoryFilters'
                      description: >-
                        スロットの境界。上限のない読み取りが最新状態に追いついた後に再開するには、`slot.gt` を最後のページの
                        `context.slot` に設定します。
                    limit:
                      type: integer
                      format: uint64
                      maximum: 1000
                      minimum: 1
                      nullable: true
                      default: 1000
                      description: ページあたりの Solana トランザクションの最大数。1～1,000。
                    minContextSlot:
                      type: integer
                      format: uint64
                      minimum: 0
                      nullable: true
                      description: >-
                        この読み取りに必要な、永続化済みインデクサーの最小スロット。インデクサーが遅れている場合は JSON-RPC
                        エラー -32016 を返します。
                    paginationToken:
                      type: string
                      description: 前のレスポンスから取得した継続トークン。同じタグ、リング、スロットフィルターとともに、変更せずに渡します。
                      nullable: true
                    ringProgramId:
                      type: string
                      description: 結果を、このプログラム ID によって認可されたリングに限定します。tags が空の場合は必須です。
                      nullable: true
                    tags:
                      type: array
                      items:
                        $ref: '#/components/schemas/Hash'
                      description: >-
                        Base58 でエンコードされた 32 バイトのビュータグ。最大 1,000 件。空の配列を指定する場合は
                        ringProgramId が必要で、そのリングが選択されます。
                      maxItems: 1000
                  additionalProperties: false
                  example:
                    tags:
                      - '11111111111111111111111111111112'
                    limit: 100
            example:
              jsonrpc: '2.0'
              id: '1'
              method: getShieldedTransactionsByTags
              params:
                tags:
                  - '11111111111111111111111111111112'
                limit: 100
        required: true
      responses:
        '200':
          description: JSON-RPC レスポンス。result を読み取る前に error を確認してください。
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                      data:
                        type: object
                        additionalProperties: true
                  id:
                    type: string
                    description: リクエスト ID。
                  jsonrpc:
                    type: string
                    description: JSON-RPC プロトコルのバージョン。
                    enum:
                      - '2.0'
                  result:
                    type: object
                    description: gTFA 形式のページネーションによる、履歴読み取りの境界付きの 1 ページ。
                    required:
                      - context
                      - data
                      - paginationToken
                    properties:
                      context:
                        $ref: '#/components/schemas/Context'
                      data:
                        type: array
                        items:
                          type: object
                          description: 返された 1 件の Solana トランザクションのイベント。イベント順です。
                          required:
                            - slot
                            - signature
                            - events
                          properties:
                            events:
                              type: array
                              items:
                                $ref: '#/components/schemas/ShieldedTransaction'
                            signature:
                              $ref: '#/components/schemas/SerializableSignature'
                            slot:
                              type: integer
                              format: uint64
                              minimum: 0
                          additionalProperties: false
                      outputTreeId:
                        type: integer
                        format: uint16
                        description: 一時停止されていない最新の状態ツリー ID。利用できない場合は省略されます。
                        minimum: 0
                      paginationToken:
                        type: string
                        description: >-
                          次のページ用のトークン。一致する結果がこれ以上ない場合は null です。`lt` または `lte`
                          の境界がない読み取りが最新状態に追いついた場合、後で再開するには `filters.slot.gt`
                          をこのページの `context.slot`
                          に設定します。上限付きの読み取りでは、上限までのスロットのみが対象です。
                        nullable: true
              example:
                jsonrpc: '2.0'
                id: '1'
                result:
                  context:
                    slot: 4242
                    blockTime: 1730000000
                  data: []
                  paginationToken: null
        '400':
          description: >-
            実行前に拒否されました。メソッドとパスの不一致、メソッドフィールドの重複、またはバッチリクエストの場合は -32601
            を返します。読み取れない、またはサイズが大きすぎる本文の場合は -32600 を返します。
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: リクエスト ID。本文が単一の JSON-RPC 呼び出しでない場合は null です。
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                      data:
                        type: object
                        additionalProperties: true
        '429':
          description: レート制限を超過しました。
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: リクエスト ID。本文が単一の JSON-RPC 呼び出しでない場合は null です。
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                      data:
                        type: object
                        additionalProperties: true
        '500':
          description: 内部サーバーエラー。
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: リクエスト ID。本文が単一の JSON-RPC 呼び出しでない場合は null です。
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                      data:
                        type: object
                        additionalProperties: true
      security:
        - ApiKeyQuery: []
components:
  schemas:
    HistoryFilters:
      type: object
      description: 履歴クエリ用のオプションのスロット境界。
      properties:
        slot:
          $ref: '#/components/schemas/SlotFilter'
      additionalProperties: false
    Hash:
      type: string
      description: Base58 でエンコードされた 32 バイトのハッシュ。
    Context:
      type: object
      required:
        - blockTime
        - slot
      properties:
        blockTime:
          type: integer
          format: int64
        slot:
          type: integer
          format: uint64
          description: スロットベースの鮮度チェックに使用する、インデクサーが永続化した最上位のスロット。
          minimum: 0
    ShieldedTransaction:
      type: object
      required:
        - slot
        - txSignature
        - txViewingPk
        - salt
        - outputSlots
        - messages
        - nullifiers
        - proofless
      properties:
        eventIndex:
          type: integer
          format: uint16
          minimum: 0
        messages:
          type: array
          items:
            $ref: '#/components/schemas/RingsMessage'
          description: どの出力コミットメントにもバインドされていない公開データスロット。変更せずに再公開されます。
        nullifiers:
          type: array
          items:
            $ref: '#/components/schemas/Hash'
        outputSlots:
          type: array
          items:
            $ref: '#/components/schemas/RingsOutputSlot'
        proofless:
          type: boolean
          description: このトランザクション内の少なくとも 1 つの出力に証明がない場合は true です。
        ringConfig:
          type: string
          description: リングの設定アカウント（その `ring_auth` PDA）。このトランザクションを認可したリングがない場合は省略されます。
        ringProgramId:
          type: string
          description: >-
            インデックス化された登録を通じて解決されたリングのプログラム。`ringConfig`
            が省略されている場合、またはリングの登録がインデックス化されていない場合は省略されます。「リングなし」と「プログラムがインデックス化されていないリング」を区別するには、`ringConfig`
            を使用します。
        salt:
          type: string
          description: すべての出力暗号文で共有される、トランザクションレベルの AES ソルト。
          nullable: true
        slot:
          type: integer
          format: uint64
          minimum: 0
        txSignature:
          $ref: '#/components/schemas/SerializableSignature'
        txViewingPk:
          type: string
          description: Base64 でエンコードされたバイト文字列。
          nullable: true
    SerializableSignature:
      type: string
      description: Base58 でエンコードされた 64 バイトの Solana トランザクション署名。
    SlotFilter:
      type: object
      description: 読み取りのスロット境界。指定した境界は AND で結合されます。
      properties:
        gt:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: このスロットより後のトランザクションのみを含めます。
        gte:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: このスロット以降のトランザクションのみを含めます。
        lt:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: このスロットより前のトランザクションのみを含めます。
        lte:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: このスロット以前のトランザクションのみを含めます。
      additionalProperties: false
    RingsMessage:
      type: object
      required:
        - viewTag
        - payload
      properties:
        payload:
          $ref: '#/components/schemas/Base64String'
        viewTag:
          $ref: '#/components/schemas/Hash'
    RingsOutputSlot:
      type: object
      required:
        - viewTag
        - outputContext
        - payload
      properties:
        outputContext:
          $ref: '#/components/schemas/RingsOutputContext'
        payload:
          $ref: '#/components/schemas/Base64String'
        viewTag:
          $ref: '#/components/schemas/Hash'
    Base64String:
      type: string
      description: Base64 でエンコードされたバイト文字列。
    RingsOutputContext:
      type: object
      required:
        - hash
        - tree
        - treeId
        - leafIndex
      properties:
        hash:
          $ref: '#/components/schemas/Hash'
        leafIndex:
          type: integer
          format: uint64
          minimum: 0
        tree:
          allOf:
            - $ref: '#/components/schemas/SerializablePubkey'
          description: 状態ツリーアカウント。treeId の使用を推奨します。ツリーアカウントは treeId から導出されます。
          deprecated: true
        treeId:
          type: integer
          format: uint16
          description: 出力のコミットメントのハッシュ化に使用される生のツリー ID。
          minimum: 0
    SerializablePubkey:
      type: string
      description: Base58 でエンコードされた Solana 公開鍵。
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: Helius API キー。

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.