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

> Busca los registros públicos de direcciones protegidas registrados por los propietarios de billeteras de Solana.

## Registros del registro

Proporciona entre 1 y 100 claves públicas de propietarios de Solana. La respuesta contiene una entrada en `result.records` por propietario, en el orden de la solicitud. Una entrada es `null` cuando el propietario no tiene ningún registro en el slot en el que se leyeron los registros.

Un registro incluye la clave pública del anulador en base58 del propietario y la clave pública de visualización en base64. La clave pública de visualización es una clave X25519 etiquetada de 33 bytes: `0x04` seguida de una coordenada u canónica de 32 bytes. `mergeEncryption` es `0` cuando la fusión está deshabilitada y `1` para PoseidonCtrV1.

Los registros se obtienen de Solana en un slot no anterior a `context.slot`. Estas son claves públicas de registro; consulta [pares de claves protegidas y cifrado](https://www.helius.dev/docs/es/privacy/concepts/encryption.md) para obtener información sobre la gestión de claves de la billetera.

## Parámetros de la solicitud

**owners** `array` *required*

Claves públicas de Solana que se buscarán en el registro de usuarios. Como máximo, 100.


## OpenAPI

````yaml es/openapi/privacy/getUserRecords.yaml POST /v1/spr/getUserRecords
openapi: 3.0.3
info:
  title: API de anillos de privacidad de Solana
  version: 0.51.2
  description: >-
    API JSON-RPC del indexador de privacidad para estados cifrados, historial,
    pruebas y registros públicos.
servers:
  - url: https://devnet.helius-rpc.com
    description: API de anillos de privacidad de Solana en Devnet
security: []
paths:
  /v1/spr/getUserRecords:
    post:
      summary: getUserRecords
      description: >-
        Busca los registros públicos de direcciones protegidas que registraron
        los propietarios de billeteras de Solana.
      operationId: getUserRecords
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                id:
                  type: string
                  description: Un ID para identificar la solicitud.
                  default: '1'
                jsonrpc:
                  type: string
                  description: La versión del protocolo JSON-RPC.
                  enum:
                    - '2.0'
                  default: '2.0'
                method:
                  type: string
                  description: >-
                    El método que se invocará. Debe coincidir con el segmento
                    final de la ruta de la URL.
                  enum:
                    - getUserRecords
                  default: getUserRecords
                params:
                  type: object
                  required:
                    - owners
                  properties:
                    owners:
                      type: array
                      items:
                        $ref: '#/components/schemas/SerializablePubkey'
                      description: >-
                        Claves públicas de Solana que se buscarán en el registro
                        de usuarios. Como máximo, 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: Respuesta JSON-RPC. Revisa el error antes de leer el resultado.
          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: El ID de la solicitud.
                  jsonrpc:
                    type: string
                    description: La versión del protocolo JSON-RPC.
                    enum:
                      - '2.0'
                  result:
                    type: object
                    required:
                      - context
                      - records
                    properties:
                      context:
                        $ref: '#/components/schemas/Context'
                      records:
                        type: array
                        items:
                          type: object
                          description: >-
                            Un registro del registro de usuarios: la dirección
                            protegida que publica una clave pública de Solana.
                          required:
                            - owner
                            - nullifierPubkey
                            - viewingPubkey
                            - mergeEncryption
                          properties:
                            mergeEncryption:
                              type: integer
                              format: uint8
                              description: >-
                                Esquema de cifrado de la salida combinada que
                                acepta el propietario para `merge_transact`. El
                                valor 0 desactiva la combinación y el valor 1
                                selecciona PoseidonCtrV1. Mientras haya un
                                esquema seleccionado, cualquier solicitante
                                puede combinar los UTXO de este propietario con
                                ese esquema.
                              minimum: 0
                            nullifierPubkey:
                              allOf:
                                - $ref: '#/components/schemas/Hash'
                              description: >-
                                Clave pública del anulador para toda la
                                billetera. Nunca rota.
                            owner:
                              $ref: '#/components/schemas/SerializablePubkey'
                            viewingPubkey:
                              allOf:
                                - $ref: '#/components/schemas/Base64String'
                              description: >-
                                Clave pública de visualización X25519 etiquetada
                                (0x04 seguido de una coordenada u canónica de 32
                                bytes).
                          additionalProperties: false
                          nullable: true
                        description: >-
                          Una entrada por cada propietario solicitado, en el
                          orden de la solicitud. `null` cuando el propietario

                          no tiene un registro en el registro de usuarios en el
                          slot en que se leyeron los registros, que no es

                          anterior a `context.slot`.
                    additionalProperties: false
              example:
                jsonrpc: '2.0'
                id: '1'
                result:
                  context:
                    slot: 4242
                    blockTime: 1730000000
                  records:
                    - null
        '400':
          description: >-
            Rechazada antes de la ejecución. Si el método y la ruta no
            coinciden, hay campos de método duplicados o se trata de una
            solicitud por lotes, se devuelve -32601. Si el cuerpo no se puede
            leer o es demasiado grande, se devuelve -32600.
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: >-
                      El ID de la solicitud, o null cuando el cuerpo no contiene
                      una única llamada JSON-RPC.
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                      data:
                        type: object
                        additionalProperties: true
        '429':
          description: Se excedió el límite de solicitudes.
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: >-
                      El ID de la solicitud, o null cuando el cuerpo no contiene
                      una única llamada JSON-RPC.
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                      data:
                        type: object
                        additionalProperties: true
        '500':
          description: Error interno del servidor.
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: >-
                      El ID de la solicitud, o null cuando el cuerpo no contiene
                      una única llamada 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: Una clave pública de Solana codificada en base58.
    Context:
      type: object
      required:
        - blockTime
        - slot
      properties:
        blockTime:
          type: integer
          format: int64
        slot:
          type: integer
          format: uint64
          description: >-
            El slot más alto que el indexador ha almacenado, para comprobar la
            actualización según el slot.
          minimum: 0
    Hash:
      type: string
      description: Un hash de 32 bytes codificado en base58.
    Base64String:
      type: string
      description: Una cadena de bytes codificada en base64.
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: Tu clave de API de Helius.

````

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