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

## Записи реестра

Укажите от 1 до 100 открытых ключей владельцев Solana. Ответ содержит по одной записи в `result.records` для каждого владельца в порядке запроса. Если у владельца нет записи в реестре в слоте, в котором были прочитаны записи, соответствующая запись имеет значение `null`.

Запись содержит открытый ключ нуллификатора владельца в формате base58 и открытый ключ просмотра в формате base64. Открытый ключ просмотра — это 33-байтовый ключ X25519 с тегом: `0x04`, за которым следует каноническая 32-байтовая u-координата. `mergeEncryption` имеет значение `0`, когда объединение отключено, и `1` для PoseidonCtrV1.

Записи извлекаются из Solana в слоте не ранее `context.slot`. Это публичные регистрационные ключи. Подробнее об управлении ключами кошелька см. в разделе [«Защищённые пары ключей и шифрование»](https://www.helius.dev/docs/ru/privacy/concepts/encryption.md).

## Параметры запроса

**owners** `array` *required*

Открытые ключи Solana, которые нужно найти в реестре пользователей. Не более 100.


## OpenAPI

````yaml ru/openapi/privacy/getUserRecords.yaml POST /v1/spr/getUserRecords
openapi: 3.0.3
info:
  title: API колец конфиденциальности Solana
  version: 0.51.2
  description: >-
    JSON-RPC API индексатора конфиденциальности для зашифрованного состояния,
    истории, доказательств и общедоступных записей реестра.
servers:
  - url: https://devnet.helius-rpc.com
    description: API колец конфиденциальности Solana в Devnet
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: Идентификатор запроса.
                  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. Перед чтением результата проверьте поле 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: Идентификатор запроса.
                  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: >-
                      Идентификатор запроса или null, если тело не является
                      одиночным вызовом JSON-RPC.
                  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: >-
                      Идентификатор запроса или null, если тело не является
                      одиночным вызовом JSON-RPC.
                  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: >-
                      Идентификатор запроса или null, если тело не является
                      одиночным вызовом 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: Публичный ключ Solana в кодировке base58.
    Context:
      type: object
      required:
        - blockTime
        - slot
      properties:
        blockTime:
          type: integer
          format: int64
        slot:
          type: integer
          format: uint64
          description: >-
            Наибольший слот, сохранённый индексатором, для проверок актуальности
            на основе слотов.
          minimum: 0
    Hash:
      type: string
      description: 32-байтовый хеш в кодировке base58.
    Base64String:
      type: string
      description: Строка байтов в кодировке base64.
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: Ваш ключ API Helius.

````

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