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

> Consulte os registros públicos de endereços protegidos registrados pelos proprietários de carteiras Solana.

## Registros do registro

Forneça entre 1 e 100 chaves públicas de proprietários Solana. A resposta contém uma entrada em `result.records` para cada proprietário, na ordem da solicitação. Uma entrada é `null` quando o proprietário não tem nenhum registro no slot em que os registros foram lidos.

Um registro inclui a chave pública anuladora do proprietário em base58 e a chave pública de visualização em base64. A chave pública de visualização é uma chave X25519 de 33 bytes com tag: `0x04` seguida por uma coordenada u canônica de 32 bytes. `mergeEncryption` é `0` quando a mesclagem está desativada e `1` para PoseidonCtrV1.

Os registros são obtidos da Solana em um slot não anterior a `context.slot`. Essas são chaves públicas de registro; consulte [pares de chaves protegidas e criptografia](https://www.helius.dev/docs/pt-BR/privacy/concepts/encryption.md) para saber como gerenciar as chaves da carteira.

## Parâmetros da solicitação

**owners** `array` *required*

Chaves públicas Solana a serem consultadas no registro de usuários. No máximo 100.


## OpenAPI

````yaml pt-BR/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 do indexador de privacidade para estado criptografado,
    histórico, provas e registros públicos.
servers:
  - url: https://devnet.helius-rpc.com
    description: API Solana Privacy Rings da Devnet
security: []
paths:
  /v1/spr/getUserRecords:
    post:
      summary: getUserRecords
      description: >-
        Consulte os registros públicos de endereços protegidos cadastrados pelos
        proprietários de carteiras Solana.
      operationId: getUserRecords
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                id:
                  type: string
                  description: Um ID para identificar a solicitação.
                  default: '1'
                jsonrpc:
                  type: string
                  description: A versão do protocolo JSON-RPC.
                  enum:
                    - '2.0'
                  default: '2.0'
                method:
                  type: string
                  description: >-
                    O método a ser invocado. Deve corresponder ao segmento final
                    do caminho da URL.
                  enum:
                    - getUserRecords
                  default: getUserRecords
                params:
                  type: object
                  required:
                    - owners
                  properties:
                    owners:
                      type: array
                      items:
                        $ref: '#/components/schemas/SerializablePubkey'
                      description: >-
                        Chaves públicas da Solana a serem consultadas no
                        registro de usuários. No 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: Resposta JSON-RPC. Verifique `error` antes de ler `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: O ID da solicitação.
                  jsonrpc:
                    type: string
                    description: A versão do 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: >-
                            Um registro do cadastro de usuários, o endereço
                            protegido que uma chave pública da Solana publica.
                          required:
                            - owner
                            - nullifierPubkey
                            - viewingPubkey
                            - mergeEncryption
                          properties:
                            mergeEncryption:
                              type: integer
                              format: uint8
                              description: >-
                                Esquema de criptografia da saída da mesclagem
                                aceito pelo proprietário para `merge_transact`.
                                O valor 0 desativa a mesclagem e o valor 1
                                seleciona PoseidonCtrV1. Enquanto um esquema
                                estiver selecionado, qualquer chamador poderá
                                mesclar as UTXOs desse proprietário usando esse
                                esquema.
                              minimum: 0
                            nullifierPubkey:
                              allOf:
                                - $ref: '#/components/schemas/Hash'
                              description: >-
                                Chave pública do nulificador para toda a
                                carteira. Nunca é rotacionada.
                            owner:
                              $ref: '#/components/schemas/SerializablePubkey'
                            viewingPubkey:
                              allOf:
                                - $ref: '#/components/schemas/Base64String'
                              description: >-
                                Chave pública de visualização X25519 com tag
                                (0x04 seguido por uma coordenada u canônica de
                                32 bytes).
                          additionalProperties: false
                          nullable: true
                        description: >-
                          Uma entrada por proprietário solicitado, na ordem da
                          solicitação. `null` quando o proprietário

                          não tem registro no cadastro no slot em que os
                          registros foram lidos, que não é

                          anterior a `context.slot`.
                    additionalProperties: false
              example:
                jsonrpc: '2.0'
                id: '1'
                result:
                  context:
                    slot: 4242
                    blockTime: 1730000000
                  records:
                    - null
        '400':
          description: >-
            Rejeitada antes da execução. Uma incompatibilidade entre método e
            caminho, campos de método duplicados ou uma solicitação em lote
            retorna -32601. Um corpo ilegível ou muito grande retorna -32600.
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: >-
                      O ID da solicitação ou `null` quando o corpo não é uma
                      única chamada JSON-RPC.
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                      data:
                        type: object
                        additionalProperties: true
        '429':
          description: Limite de requisições excedido.
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: >-
                      O ID da solicitação ou `null` quando o corpo não é uma
                      única chamada JSON-RPC.
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                      data:
                        type: object
                        additionalProperties: true
        '500':
          description: Erro interno do servidor.
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: >-
                      O ID da solicitação ou `null` quando o corpo não é uma
                      única chamada 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: Uma chave pública da Solana codificada em base58.
    Context:
      type: object
      required:
        - blockTime
        - slot
      properties:
        blockTime:
          type: integer
          format: int64
        slot:
          type: integer
          format: uint64
          description: >-
            O slot mais alto que o indexador persistiu, usado para verificações
            de atualização baseadas em slot.
          minimum: 0
    Hash:
      type: string
      description: Um hash de 32 bytes codificado em base58.
    Base64String:
      type: string
      description: Uma cadeia de bytes codificada em base64.
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: Sua chave de API da Helius.

````

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