> ## 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

> Ambil peristiwa transaksi terlindung yang cocok dengan tag tampilan atau ring tertentu.

## Riwayat Transaksi

Tag memilih transaksi. Setiap entri dalam `result.data` memuat setiap peristiwa dari satu transaksi Solana yang dipilih, yang dibatasi pada `ringProgramId` jika Anda menyediakannya. Peristiwa mencakup output terenkripsi, pesan, nullifier, dan metadata ring. Dekripsi muatan di dompet Anda untuk memulihkan jumlah dan aset. Lihat [panduan riwayat privat](https://www.helius.dev/docs/id/privacy/guides/read-history.md).

Tag cocok dengan tag tampilan output dan tag tampilan pesan. Array `tags` yang kosong memerlukan `ringProgramId` dan memilih riwayat ring, termasuk transaksi tanpa tag penerima. Jika keduanya disediakan, transaksi harus cocok dengan tag dan ring tersebut.

Lihat [paginasi dan keterkinian](https://www.helius.dev/docs/id/api-reference/privacy.md#paginasi) untuk batas halaman, token kelanjutan, dan pembacaan inkremental.

## Parameter Permintaan

**filters** `object`

Batas slot. Lanjutkan pembacaan tanpa batas yang telah tersinkronisasi dengan menetapkan `slot.gt` ke `context.slot` dari halaman terakhir.

**filters.slot** `object`

Batas slot untuk pembacaan. Batas yang diberikan digabungkan dengan AND.

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

Hanya sertakan transaksi setelah slot ini.

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

Hanya sertakan transaksi pada atau setelah slot ini.

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

Hanya sertakan transaksi sebelum slot ini.

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

Hanya sertakan transaksi pada atau sebelum slot ini.

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

Jumlah maksimum transaksi Solana per halaman, dari 1 hingga 1.000.

**minContextSlot** `number`

Slot pengindeks tersimpan minimum yang diperlukan untuk pembacaan ini. Mengembalikan galat JSON-RPC -32016 jika pengindeks tertinggal.

**paginationToken** `string`

Token kelanjutan dari respons sebelumnya. Kirimkan kembali tanpa perubahan dengan tag, ring, dan filter slot yang sama.

**ringProgramId** `string`

Batasi hasil pada ring yang diotorisasi oleh ID program ini. Wajib jika tags kosong.

**tags** `array` *required*

Tag tampilan 32 byte yang dikodekan dengan Base58. Maksimal 1.000. Array kosong memerlukan ringProgramId dan memilih ring tersebut.


## OpenAPI

````yaml id/openapi/privacy/getShieldedTransactionsByTags.yaml POST /v1/spr/getShieldedTransactionsByTags
openapi: 3.0.3
info:
  title: API Solana Privacy Rings
  version: 0.51.2
  description: >-
    API pengindeks privasi JSON-RPC untuk status terenkripsi, riwayat, bukti,
    dan catatan registri publik.
servers:
  - url: https://devnet.helius-rpc.com
    description: API Solana Privacy Rings Devnet
security: []
paths:
  /v1/spr/getShieldedTransactionsByTags:
    post:
      summary: getShieldedTransactionsByTags
      description: >-
        Ambil peristiwa transaksi terlindung yang cocok dengan tag tampilan atau
        ring tertentu.
      operationId: getShieldedTransactionsByTags
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                id:
                  type: string
                  description: ID untuk mengidentifikasi permintaan.
                  default: '1'
                jsonrpc:
                  type: string
                  description: Versi protokol JSON-RPC.
                  enum:
                    - '2.0'
                  default: '2.0'
                method:
                  type: string
                  description: >-
                    Metode yang akan dipanggil. Harus cocok dengan segmen
                    terakhir jalur URL.
                  enum:
                    - getShieldedTransactionsByTags
                  default: getShieldedTransactionsByTags
                params:
                  type: object
                  required:
                    - tags
                  properties:
                    filters:
                      allOf:
                        - $ref: '#/components/schemas/HistoryFilters'
                      description: >-
                        Batas slot. Lanjutkan pembacaan tanpa batas yang sudah
                        menyusul dengan menetapkan `slot.gt` ke `context.slot`
                        halaman terakhir.
                    limit:
                      type: integer
                      format: uint64
                      maximum: 1000
                      minimum: 1
                      nullable: true
                      default: 1000
                      description: >-
                        Jumlah maksimum transaksi Solana per halaman, dari 1
                        hingga 1.000.
                    minContextSlot:
                      type: integer
                      format: uint64
                      minimum: 0
                      nullable: true
                      description: >-
                        Slot pengindeks tersimpan minimum yang diperlukan untuk
                        pembacaan ini. Mengembalikan kesalahan JSON-RPC -32016
                        jika pengindeks tertinggal.
                    paginationToken:
                      type: string
                      description: >-
                        Token kelanjutan dari respons sebelumnya. Kirimkan
                        kembali tanpa perubahan dengan tag, ring, dan filter
                        slot yang sama.
                      nullable: true
                    ringProgramId:
                      type: string
                      description: >-
                        Batasi hasil ke ring yang diotorisasi oleh ID program
                        ini. Wajib jika tags kosong.
                      nullable: true
                    tags:
                      type: array
                      items:
                        $ref: '#/components/schemas/Hash'
                      description: >-
                        Tag tampilan 32 byte yang dikodekan dengan base58.
                        Maksimal 1.000. Larik kosong memerlukan ringProgramId
                        dan memilih ring tersebut.
                      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: Respons JSON-RPC. Periksa error sebelum membaca result.
          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 permintaan.
                  jsonrpc:
                    type: string
                    description: Versi protokol JSON-RPC.
                    enum:
                      - '2.0'
                  result:
                    type: object
                    description: >-
                      Satu halaman berbatas dari pembacaan riwayat, dengan
                      paginasi bergaya gTFA.
                    required:
                      - context
                      - data
                      - paginationToken
                    properties:
                      context:
                        $ref: '#/components/schemas/Context'
                      data:
                        type: array
                        items:
                          type: object
                          description: >-
                            Peristiwa yang dikembalikan dari satu transaksi
                            Solana, sesuai urutan peristiwa.
                          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 pohon status terbaru yang tidak dijeda. Dihilangkan
                          jika tidak tersedia.
                        minimum: 0
                      paginationToken:
                        type: string
                        description: >-
                          Token untuk halaman berikutnya, null jika tidak ada
                          lagi hasil yang cocok. Pembacaan yang sudah menyusul

                          tanpa batas `lt` atau `lte` dilanjutkan nanti dengan
                          `filters.slot.gt`

                          yang ditetapkan ke `context.slot` halaman ini;
                          pembacaan yang dibatasi hanya mencakup slot hingga

                          batasnya.
                        nullable: true
              example:
                jsonrpc: '2.0'
                id: '1'
                result:
                  context:
                    slot: 4242
                    blockTime: 1730000000
                  data: []
                  paginationToken: null
        '400':
          description: >-
            Ditolak sebelum eksekusi. Ketidakcocokan metode/jalur, kolom metode
            duplikat, atau permintaan batch mengembalikan -32601. Isi yang tidak
            dapat dibaca atau terlalu besar mengembalikan -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 permintaan, atau null jika isi bukan satu panggilan
                      JSON-RPC.
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                      data:
                        type: object
                        additionalProperties: true
        '429':
          description: Batas laju terlampaui.
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: >-
                      ID permintaan, atau null jika isi bukan satu panggilan
                      JSON-RPC.
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                      data:
                        type: object
                        additionalProperties: true
        '500':
          description: Kesalahan server internal.
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: >-
                      ID permintaan, atau null jika isi bukan satu panggilan
                      JSON-RPC.
                  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: Batas slot opsional untuk kueri riwayat.
      properties:
        slot:
          $ref: '#/components/schemas/SlotFilter'
      additionalProperties: false
    Hash:
      type: string
      description: Hash 32 byte yang dikodekan dengan base58.
    Context:
      type: object
      required:
        - blockTime
        - slot
      properties:
        blockTime:
          type: integer
          format: int64
        slot:
          type: integer
          format: uint64
          description: >-
            Slot tertinggi yang telah disimpan pengindeks, untuk pemeriksaan
            keterkinian berbasis slot.
          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: >-
            Slot data yang dipublikasikan dan tidak terikat pada komitmen
            keluaran, dipublikasikan ulang tanpa perubahan.
        nullifiers:
          type: array
          items:
            $ref: '#/components/schemas/Hash'
        outputSlots:
          type: array
          items:
            $ref: '#/components/schemas/RingsOutputSlot'
        proofless:
          type: boolean
          description: >-
            True jika setidaknya satu keluaran dalam transaksi ini tidak
            memiliki bukti.
        ringConfig:
          type: string
          description: >-
            Akun konfigurasi ring (`ring_auth` PDA miliknya). Dihilangkan jika
            tidak ada ring yang mengotorisasi transaksi ini.
        ringProgramId:
          type: string
          description: >-
            Program ring, yang ditentukan melalui pendaftaran terindeks.
            Dihilangkan jika `ringConfig` dihilangkan atau pendaftaran ring
            belum diindeks. Gunakan `ringConfig` untuk membedakan "tanpa ring"
            dari "ring dengan program yang belum diindeks".
        salt:
          type: string
          description: >-
            Salt AES tingkat transaksi yang digunakan bersama oleh setiap
            ciphertext keluaran.
          nullable: true
        slot:
          type: integer
          format: uint64
          minimum: 0
        txSignature:
          $ref: '#/components/schemas/SerializableSignature'
        txViewingPk:
          type: string
          description: String byte yang dikodekan dengan base64.
          nullable: true
    SerializableSignature:
      type: string
      description: Tanda tangan transaksi Solana 64 byte yang dikodekan dengan base58.
    SlotFilter:
      type: object
      description: Batas slot untuk pembacaan. Batas yang diberikan digabungkan dengan AND.
      properties:
        gt:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: Hanya sertakan transaksi setelah slot ini.
        gte:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: Hanya sertakan transaksi pada atau setelah slot ini.
        lt:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: Hanya sertakan transaksi sebelum slot ini.
        lte:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: Hanya sertakan transaksi pada atau sebelum slot ini.
      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: String byte yang dikodekan dengan 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: Akun pohon status. Utamakan treeId; akun pohon diturunkan darinya.
          deprecated: true
        treeId:
          type: integer
          format: uint16
          description: ID pohon mentah yang menjadi dasar hash komitmen keluaran.
          minimum: 0
    SerializablePubkey:
      type: string
      description: Kunci publik Solana yang dikodekan dengan base58.
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: Kunci API Helius Anda.

````

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