> ## 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`의 각 항목에는 선택된 Solana 트랜잭션 하나의 모든 이벤트가 포함되며, `ringProgramId`을 제공하면 해당 링으로 제한됩니다. 이벤트에는 암호화된 출력, 메시지, 무효화자, 링 메타데이터가 포함됩니다. 지갑에서 페이로드를 복호화하여 금액과 자산을 복구하세요. [비공개 내역 가이드](https://www.helius.dev/docs/ko/privacy/guides/read-history.md)를 참조하세요.

태그는 출력 보기 태그 및 메시지 보기 태그와 일치합니다. 빈 `tags` 배열을 사용하려면 `ringProgramId`이 필요하며, 수신자 태그가 없는 트랜잭션을 포함하여 해당 링의 내역을 선택합니다. 둘 다 제공하면 트랜잭션이 태그와 링에 모두 일치해야 합니다.

페이지 제한, 연속 토큰, 증분 읽기에 관한 자세한 내용은 [페이지네이션 및 최신 상태](https://www.helius.dev/docs/ko/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 ko/openapi/privacy/getShieldedTransactionsByTags.yaml POST /v1/spr/getShieldedTransactionsByTags
openapi: 3.0.3
info:
  title: Solana Privacy Rings API
  version: 0.51.2
  description: 암호화된 상태, 기록, 증명 및 공개 레지스트리 레코드를 위한 개인정보 보호 인덱서 JSON-RPC API입니다.
servers:
  - url: https://devnet.helius-rpc.com
    description: Devnet Solana Privacy Rings 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 스타일 페이지네이션을 사용하는 기록 읽기의 제한된 단일 페이지입니다.
                    required:
                      - context
                      - data
                      - paginationToken
                    properties:
                      context:
                        $ref: '#/components/schemas/Context'
                      data:
                        type: array
                        items:
                          type: object
                          description: 한 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: 이 트랜잭션의 출력 중 하나 이상에 증명이 없으면 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.