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

# getUserRecords

> Solana 지갑 소유자가 등록한 공개 보호 주소 레코드를 조회합니다.

## 레지스트리 레코드

Solana 소유자 공개 키를 1개에서 100개까지 제공합니다. 응답에는 요청 순서에 따라 소유자별 항목 하나가 `result.records`에 포함됩니다. 레코드를 읽은 슬롯에 소유자의 레지스트리 레코드가 없으면 해당 항목은 `null`입니다.

레코드에는 소유자의 base58 널리파이어 공개 키와 base64 뷰잉 공개 키가 포함됩니다. 뷰잉 공개 키는 33바이트의 태그가 지정된 X25519 키로, `0x04` 뒤에 정규 32바이트 u 좌표가 옵니다. 병합이 비활성화된 경우 `mergeEncryption`은 `0`이고, PoseidonCtrV1의 경우 `1`입니다.

레코드는 `context.slot`보다 이전이 아닌 슬롯에서 Solana로부터 가져옵니다. 이는 공개 등록 키입니다. 지갑 키 처리에 대한 자세한 내용은 [보호 키 쌍 및 암호화](https://www.helius.dev/docs/ko/privacy/concepts/encryption.md)를 참조하세요.

## 요청 매개변수

**owners** `array` *required*

사용자 레지스트리에서 조회할 Solana 공개 키입니다. 최대 100개입니다.


## OpenAPI

````yaml ko/openapi/privacy/getUserRecords.yaml POST /v1/spr/getUserRecords
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/getUserRecords:
    post:
      summary: getUserRecords
      description: Solana 지갑 소유자가 등록한 공개 차폐 주소 레코드를 조회합니다.
      operationId: getUserRecords
      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:
                    - getUserRecords
                  default: getUserRecords
                params:
                  type: object
                  required:
                    - owners
                  properties:
                    owners:
                      type: array
                      items:
                        $ref: '#/components/schemas/SerializablePubkey'
                      description: 사용자 레지스트리에서 조회할 Solana 공개 키입니다. 최대 100개까지 지정할 수 있습니다.
                      maxItems: 100
                      minItems: 1
                  additionalProperties: false
                  example:
                    owners:
                      - '11111111111111111111111111111111'
            example:
              jsonrpc: '2.0'
              id: '1'
              method: getUserRecords
              params:
                owners:
                  - '11111111111111111111111111111111'
        required: true
      responses:
        '200':
          description: JSON-RPC 응답입니다. 결과를 읽기 전에 오류를 확인하세요.
          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
                    required:
                      - context
                      - records
                    properties:
                      context:
                        $ref: '#/components/schemas/Context'
                      records:
                        type: array
                        items:
                          type: object
                          description: 사용자 레지스트리 레코드로, Solana 공개 키가 게시하는 차폐 주소입니다.
                          required:
                            - owner
                            - nullifierPubkey
                            - viewingPubkey
                            - mergeEncryption
                          properties:
                            mergeEncryption:
                              type: integer
                              format: uint8
                              description: >-
                                소유자가 `merge_transact`에 허용하는 병합 출력 암호화 방식입니다. 0은
                                병합을 비활성화하고 1은 PoseidonCtrV1을 선택합니다. 방식이 선택되어 있는
                                동안에는 모든 호출자가 해당 방식으로 이 소유자의 UTXO를 병합할 수 있습니다.
                              minimum: 0
                            nullifierPubkey:
                              allOf:
                                - $ref: '#/components/schemas/Hash'
                              description: 지갑 전체에서 사용하는 널리파이어 공개 키입니다. 절대 교체되지 않습니다.
                            owner:
                              $ref: '#/components/schemas/SerializablePubkey'
                            viewingPubkey:
                              allOf:
                                - $ref: '#/components/schemas/Base64String'
                              description: >-
                                태그가 지정된 X25519 뷰잉 공개 키입니다(0x04 뒤에 정규 32바이트 u 좌표가
                                이어짐).
                          additionalProperties: false
                          nullable: true
                        description: >-
                          요청된 소유자마다 요청 순서대로 하나의 항목이 반환됩니다. 레코드를 읽은 슬롯에서 소유자에게
                          레지스트리 레코드가 없으면 `null`이며, 해당 슬롯은 `context.slot`보다 이전일 수
                          없습니다.
                    additionalProperties: false
              example:
                jsonrpc: '2.0'
                id: '1'
                result:
                  context:
                    slot: 4242
                    blockTime: 1730000000
                  records:
                    - 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:
    SerializablePubkey:
      type: string
      description: base58로 인코딩된 Solana 공개 키입니다.
    Context:
      type: object
      required:
        - blockTime
        - slot
      properties:
        blockTime:
          type: integer
          format: int64
        slot:
          type: integer
          format: uint64
          description: 슬롯 기반 최신성 확인을 위해 인덱서가 영구 저장한 가장 높은 슬롯입니다.
          minimum: 0
    Hash:
      type: string
      description: base58로 인코딩된 32바이트 해시입니다.
    Base64String:
      type: string
      description: base64로 인코딩된 바이트 문자열입니다.
  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.