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

> Recherchez les enregistrements publics d’adresses protégées inscrits par les propriétaires de portefeuilles Solana.

## Enregistrements du registre

Fournissez entre 1 et 100 clés publiques de propriétaires Solana. La réponse contient une entrée dans `result.records` par propriétaire, dans l’ordre de la requête. Une entrée vaut `null` lorsque le propriétaire ne possède aucun enregistrement dans le registre au slot où les enregistrements ont été lus.

Un enregistrement comprend la clé publique d’annulation du propriétaire encodée en base58 et sa clé publique de visualisation encodée en base64. La clé publique de visualisation est une clé X25519 étiquetée de 33 octets : `0x04` suivi d’une coordonnée u canonique de 32 octets. `mergeEncryption` vaut `0` lorsque la fusion est désactivée et `1` pour PoseidonCtrV1.

Les enregistrements sont récupérés depuis Solana à un slot qui n’est pas antérieur à `context.slot`. Il s’agit de clés d’inscription publiques ; consultez [les paires de clés protégées et le chiffrement](https://www.helius.dev/docs/fr/privacy/concepts/encryption.md) pour en savoir plus sur la gestion des clés de portefeuille.

## Paramètres de la requête

**owners** `array` *required*

Clés publiques Solana à rechercher dans le registre des utilisateurs. 100 au maximum.


## OpenAPI

````yaml fr/openapi/privacy/getUserRecords.yaml POST /v1/spr/getUserRecords
openapi: 3.0.3
info:
  title: API Solana Privacy Rings
  version: 0.51.2
  description: >-
    API JSON-RPC d'indexation de confidentialité pour les états chiffrés,
    l'historique, les preuves et les enregistrements du registre public.
servers:
  - url: https://devnet.helius-rpc.com
    description: API Solana Privacy Rings sur Devnet
security: []
paths:
  /v1/spr/getUserRecords:
    post:
      summary: getUserRecords
      description: >-
        Recherchez les enregistrements publics d'adresses protégées inscrits par
        les propriétaires de portefeuilles Solana.
      operationId: getUserRecords
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                id:
                  type: string
                  description: Un ID permettant d'identifier la requête.
                  default: '1'
                jsonrpc:
                  type: string
                  description: La version du protocole JSON-RPC.
                  enum:
                    - '2.0'
                  default: '2.0'
                method:
                  type: string
                  description: >-
                    La méthode à invoquer. Elle doit correspondre au dernier
                    segment du chemin de l'URL.
                  enum:
                    - getUserRecords
                  default: getUserRecords
                params:
                  type: object
                  required:
                    - owners
                  properties:
                    owners:
                      type: array
                      items:
                        $ref: '#/components/schemas/SerializablePubkey'
                      description: >-
                        Clés publiques Solana à rechercher dans le registre des
                        utilisateurs. 100 au maximum.
                      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: >-
            Réponse JSON-RPC. Vérifiez le champ error avant de lire le champ
            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: L'ID de la requête.
                  jsonrpc:
                    type: string
                    description: La version du protocole 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 enregistrement du registre des utilisateurs,
                            correspondant à l'adresse protégée publiée par une
                            clé publique Solana.
                          required:
                            - owner
                            - nullifierPubkey
                            - viewingPubkey
                            - mergeEncryption
                          properties:
                            mergeEncryption:
                              type: integer
                              format: uint8
                              description: >-
                                Schéma de chiffrement de la sortie fusionnée
                                accepté par le propriétaire pour
                                `merge_transact`. La valeur 0 désactive la
                                fusion et la valeur 1 sélectionne PoseidonCtrV1.
                                Tant qu'un schéma est sélectionné, tout appelant
                                peut fusionner les UTXO de ce propriétaire selon
                                ce schéma.
                              minimum: 0
                            nullifierPubkey:
                              allOf:
                                - $ref: '#/components/schemas/Hash'
                              description: >-
                                Clé publique d'annulateur commune à l'ensemble
                                du portefeuille. Elle n'est jamais renouvelée.
                            owner:
                              $ref: '#/components/schemas/SerializablePubkey'
                            viewingPubkey:
                              allOf:
                                - $ref: '#/components/schemas/Base64String'
                              description: >-
                                Clé publique de visualisation X25519 étiquetée
                                (0x04 suivi d'une coordonnée u canonique de 32
                                octets).
                          additionalProperties: false
                          nullable: true
                        description: >-
                          Une entrée par propriétaire demandé, dans l'ordre de
                          la requête. `null` lorsque le propriétaire

                          ne possède aucun enregistrement dans le registre au
                          slot où les enregistrements ont été lus, lequel n'est
                          pas

                          antérieur à `context.slot`.
                    additionalProperties: false
              example:
                jsonrpc: '2.0'
                id: '1'
                result:
                  context:
                    slot: 4242
                    blockTime: 1730000000
                  records:
                    - null
        '400':
          description: >-
            Rejetée avant l'exécution. Une incompatibilité entre la méthode et
            le chemin, des champs de méthode en double ou une requête par lots
            renvoient -32601. Un corps illisible ou trop volumineux renvoie
            -32600.
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: >-
                      L'ID de la requête, ou null lorsque le corps ne contient
                      pas un appel JSON-RPC unique.
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                      data:
                        type: object
                        additionalProperties: true
        '429':
          description: Limite de débit dépassée.
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: >-
                      L'ID de la requête, ou null lorsque le corps ne contient
                      pas un appel JSON-RPC unique.
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                      data:
                        type: object
                        additionalProperties: true
        '500':
          description: Erreur interne du serveur.
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: >-
                      L'ID de la requête, ou null lorsque le corps ne contient
                      pas un appel JSON-RPC unique.
                  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: Une clé publique Solana encodée en base58.
    Context:
      type: object
      required:
        - blockTime
        - slot
      properties:
        blockTime:
          type: integer
          format: int64
        slot:
          type: integer
          format: uint64
          description: >-
            Le slot le plus élevé enregistré par l'indexeur, utilisé pour les
            contrôles de fraîcheur basés sur les slots.
          minimum: 0
    Hash:
      type: string
      description: Un hachage de 32 octets encodé en base58.
    Base64String:
      type: string
      description: Une chaîne d'octets encodée en base64.
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: Votre clé API Helius.

````

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