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

> Cari catatan alamat terlindungi publik yang didaftarkan oleh pemilik dompet Solana.

## Catatan Registri

Berikan antara 1 hingga 100 kunci publik pemilik Solana. Respons berisi satu entri dalam `result.records` untuk setiap pemilik, sesuai urutan permintaan. Entri bernilai `null` jika pemilik tidak memiliki catatan registri pada slot saat catatan dibaca.

Catatan mencakup kunci publik nullifier base58 milik pemilik dan kunci publik tampilan base64. Kunci publik tampilan adalah kunci X25519 bertanda sepanjang 33 byte: `0x04` diikuti koordinat-u kanonis sepanjang 32 byte. `mergeEncryption` bernilai `0` saat penggabungan dinonaktifkan dan `1` untuk PoseidonCtrV1.

Catatan diambil dari Solana pada slot yang tidak lebih awal dari `context.slot`. Ini adalah kunci pendaftaran publik; lihat [pasangan kunci terlindungi dan enkripsi](https://www.helius.dev/docs/id/privacy/concepts/encryption.md) untuk penanganan kunci dompet.

## Parameter Permintaan

**owners** `array` *required*

Kunci publik Solana yang akan dicari dalam registri pengguna. Maksimal 100.


## OpenAPI

````yaml id/openapi/privacy/getUserRecords.yaml POST /v1/spr/getUserRecords
openapi: 3.0.3
info:
  title: API Cincin Privasi Solana
  version: 0.51.2
  description: >-
    API JSON-RPC pengindeks privasi untuk status terenkripsi, riwayat, bukti,
    dan catatan registri publik.
servers:
  - url: https://devnet.helius-rpc.com
    description: API Cincin Privasi Solana Devnet
security: []
paths:
  /v1/spr/getUserRecords:
    post:
      summary: getUserRecords
      description: >-
        Cari catatan alamat terlindung publik yang didaftarkan oleh pemilik
        dompet Solana.
      operationId: getUserRecords
      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:
                    - getUserRecords
                  default: getUserRecords
                params:
                  type: object
                  required:
                    - owners
                  properties:
                    owners:
                      type: array
                      items:
                        $ref: '#/components/schemas/SerializablePubkey'
                      description: >-
                        Kunci publik Solana yang akan dicari dalam registri
                        pengguna. Maksimal 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: 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
                    required:
                      - context
                      - records
                    properties:
                      context:
                        $ref: '#/components/schemas/Context'
                      records:
                        type: array
                        items:
                          type: object
                          description: >-
                            Catatan registri pengguna, yaitu alamat terlindung
                            yang dipublikasikan oleh kunci publik Solana.
                          required:
                            - owner
                            - nullifierPubkey
                            - viewingPubkey
                            - mergeEncryption
                          properties:
                            mergeEncryption:
                              type: integer
                              format: uint8
                              description: >-
                                Skema enkripsi keluaran penggabungan yang
                                diterima pemilik untuk `merge_transact`. Nilai 0
                                menonaktifkan penggabungan dan 1 memilih
                                PoseidonCtrV1. Selama suatu skema dipilih,
                                pemanggil mana pun dapat menggabungkan UTXO
                                milik pemilik ini berdasarkan skema tersebut.
                              minimum: 0
                            nullifierPubkey:
                              allOf:
                                - $ref: '#/components/schemas/Hash'
                              description: >-
                                Kunci publik nullifier untuk seluruh dompet.
                                Tidak pernah dirotasi.
                            owner:
                              $ref: '#/components/schemas/SerializablePubkey'
                            viewingPubkey:
                              allOf:
                                - $ref: '#/components/schemas/Base64String'
                              description: >-
                                Kunci publik penayangan X25519 bertag (0x04
                                diikuti koordinat-u kanonis sepanjang 32 byte).
                          additionalProperties: false
                          nullable: true
                        description: >-
                          Satu entri untuk setiap pemilik yang diminta, sesuai
                          urutan permintaan. Bernilai `null` jika pemilik

                          tidak memiliki catatan registri pada slot saat catatan
                          dibaca, yang waktunya tidak

                          lebih awal dari `context.slot`.
                    additionalProperties: false
              example:
                jsonrpc: '2.0'
                id: '1'
                result:
                  context:
                    slot: 4242
                    blockTime: 1730000000
                  records:
                    - null
        '400':
          description: >-
            Ditolak sebelum eksekusi. Ketidakcocokan metode/jalur, kolom metode
            duplikat, atau permintaan batch akan menghasilkan -32601. Isi yang
            tidak dapat dibaca atau terlalu besar akan menghasilkan -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:
    SerializablePubkey:
      type: string
      description: Kunci publik Solana 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 dipersistenkan oleh pengindeks, untuk
            pemeriksaan kebaruan berbasis slot.
          minimum: 0
    Hash:
      type: string
      description: Hash 32 byte yang dikodekan dengan base58.
    Base64String:
      type: string
      description: String byte yang dikodekan dengan base64.
  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.