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

# getShieldedTransactionsByNullifiers

> Récupérez les événements de transactions protégées qui dépensent les nullificateurs fournis.

## Rechercher les transactions de dépense

Utilisez les nullificateurs dérivés par votre portefeuille pour trouver les transactions qui ont dépensé ses entrées. Les nullificateurs sélectionnent les transactions. Chaque entrée de `result.data` contient tous les événements d'une transaction Solana sélectionnée, avec ses `slot` et `signature`.

Fournissez entre 1 et 1 000 nullificateurs. Consultez la section [pagination et actualisation](https://www.helius.dev/docs/fr/api-reference/privacy.md#pagination) pour connaître les limites de page, les jetons de continuation et les lectures incrémentielles.

## Paramètres de la requête

**filters** `object`

Limites de slots. Reprenez une lecture sans limite ayant rattrapé son retard en définissant `slot.gt` sur le `context.slot` de la dernière page.

**filters.slot** `object`

Limites de slots pour la lecture. Les limites fournies sont combinées avec l'opérateur AND.

**filters.slot.gt** `number`

Inclut uniquement les transactions postérieures à ce slot.

**filters.slot.gte** `number`

Inclut uniquement les transactions de ce slot ou d'un slot ultérieur.

**filters.slot.lt** `number`

Inclut uniquement les transactions antérieures à ce slot.

**filters.slot.lte** `number`

Inclut uniquement les transactions de ce slot ou d'un slot antérieur.

**limit** `number` (default: 1000)

Nombre maximal de transactions Solana par page, compris entre 1 et 1 000.

**minContextSlot** `number`

Slot minimal persisté de l'indexeur requis pour cette lecture. Renvoie l'erreur JSON-RPC -32016 si l'indexeur est en retard.

**nullifiers** `array` *required*

Nullificateurs de 32 octets encodés en Base58 à comparer aux entrées dépensées.

**paginationToken** `string`

Jeton de continuation de la réponse précédente. Renvoyez-le sans le modifier avec les mêmes nullificateurs et filtres de slots.


## OpenAPI

````yaml fr/openapi/privacy/getShieldedTransactionsByNullifiers.yaml POST /v1/spr/getShieldedTransactionsByNullifiers
openapi: 3.0.3
info:
  title: API des anneaux de confidentialité Solana
  version: 0.51.2
  description: >-
    API JSON-RPC d'indexation de la confidentialité pour l'état chiffré,
    l'historique, les preuves et les enregistrements du registre public.
servers:
  - url: https://devnet.helius-rpc.com
    description: API des anneaux de confidentialité Solana sur Devnet
security: []
paths:
  /v1/spr/getShieldedTransactionsByNullifiers:
    post:
      summary: getShieldedTransactionsByNullifiers
      description: >-
        Récupérez les événements de transactions protégées qui dépensent les
        nullificateurs fournis.
      operationId: getShieldedTransactionsByNullifiers
      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 à appeler. Elle doit correspondre au dernier
                    segment du chemin de l'URL.
                  enum:
                    - getShieldedTransactionsByNullifiers
                  default: getShieldedTransactionsByNullifiers
                params:
                  type: object
                  required:
                    - nullifiers
                  properties:
                    filters:
                      allOf:
                        - $ref: '#/components/schemas/HistoryFilters'
                      description: >-
                        Limites de slots. Pour reprendre une lecture sans
                        plafond ayant rattrapé son retard, définissez `slot.gt`
                        sur la valeur `context.slot` de la dernière page.
                    limit:
                      type: integer
                      format: uint64
                      maximum: 1000
                      minimum: 1
                      nullable: true
                      default: 1000
                      description: >-
                        Nombre maximal de transactions Solana par page, de 1 à 1
                        000.
                    minContextSlot:
                      type: integer
                      format: uint64
                      minimum: 0
                      nullable: true
                      description: >-
                        Slot minimal persisté par l'indexeur requis pour cette
                        lecture. Renvoie l'erreur JSON-RPC -32016 si l'indexeur
                        est en retard.
                    nullifiers:
                      type: array
                      items:
                        $ref: '#/components/schemas/Hash'
                      minItems: 1
                      maxItems: 1000
                      description: >-
                        Nullificateurs de 32 octets encodés en base58 à comparer
                        aux entrées dépensées.
                    paginationToken:
                      type: string
                      description: >-
                        Jeton de continuation de la réponse précédente.
                        Renvoyez-le sans le modifier, avec les mêmes
                        nullificateurs et filtres de slots.
                      nullable: true
                  additionalProperties: false
                  example:
                    nullifiers:
                      - '11111111111111111111111111111112'
                    limit: 100
            example:
              jsonrpc: '2.0'
              id: '1'
              method: getShieldedTransactionsByNullifiers
              params:
                nullifiers:
                  - '11111111111111111111111111111112'
                limit: 100
        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
                    description: >-
                      Une page limitée d'une lecture d'historique, avec une
                      pagination de style gTFA.
                    required:
                      - context
                      - data
                      - paginationToken
                    properties:
                      context:
                        $ref: '#/components/schemas/Context'
                      data:
                        type: array
                        items:
                          type: object
                          description: >-
                            Les événements renvoyés pour une transaction Solana,
                            dans l'ordre des événements.
                          required:
                            - slot
                            - signature
                            - events
                          properties:
                            events:
                              type: array
                              items:
                                $ref: '#/components/schemas/ShieldedTransaction'
                            signature:
                              $ref: '#/components/schemas/SerializableSignature'
                            slot:
                              type: integer
                              format: uint64
                              minimum: 0
                          additionalProperties: false
                      outputTreeId:
                        type: integer
                        format: uint16
                        description: >-
                          L'ID de l'arbre d'état non suspendu le plus récent.
                          Omis s'il n'est pas disponible.
                        minimum: 0
                      paginationToken:
                        type: string
                        description: >-
                          Jeton de la page suivante, null lorsqu'aucun autre
                          résultat ne correspond. Une lecture ayant rattrapé son
                          retard

                          sans limite `lt` ou `lte` reprend ultérieurement avec
                          `filters.slot.gt`

                          défini sur la valeur `context.slot` de cette page ;
                          une lecture plafonnée couvre uniquement les slots
                          jusqu'à

                          sa limite.
                        nullable: true
              example:
                jsonrpc: '2.0'
                id: '1'
                result:
                  context:
                    slot: 4242
                    blockTime: 1730000000
                  data: []
                  paginationToken: null
        '400':
          description: >-
            Rejetée avant l'exécution. Une incohérence entre la méthode et le
            chemin, des champs de méthode en double ou une requête par lot
            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 n'est 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 n'est 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 n'est 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:
    HistoryFilters:
      type: object
      description: Limites de slots facultatives pour la requête d'historique.
      properties:
        slot:
          $ref: '#/components/schemas/SlotFilter'
      additionalProperties: false
    Hash:
      type: string
      description: Un hachage de 32 octets encodé en base58.
    Context:
      type: object
      required:
        - blockTime
        - slot
      properties:
        blockTime:
          type: integer
          format: int64
        slot:
          type: integer
          format: uint64
          description: >-
            Slot le plus élevé persisté par l'indexeur, utilisé pour les
            vérifications d'actualité basées sur les slots.
          minimum: 0
    ShieldedTransaction:
      type: object
      required:
        - slot
        - txSignature
        - txViewingPk
        - salt
        - outputSlots
        - messages
        - nullifiers
        - proofless
      properties:
        eventIndex:
          type: integer
          format: uint16
          minimum: 0
        messages:
          type: array
          items:
            $ref: '#/components/schemas/RingsMessage'
          description: >-
            Slots de données publiées qui ne sont liés à aucun engagement de
            sortie, republiés à l'identique.
        nullifiers:
          type: array
          items:
            $ref: '#/components/schemas/Hash'
        outputSlots:
          type: array
          items:
            $ref: '#/components/schemas/RingsOutputSlot'
        proofless:
          type: boolean
          description: >-
            True lorsqu'au moins une sortie de cette transaction est dépourvue
            de preuve.
        ringConfig:
          type: string
          description: >-
            Le compte de configuration de l'anneau (son PDA `ring_auth`). Omis
            lorsqu'aucun anneau n'a autorisé cette transaction.
        ringProgramId:
          type: string
          description: >-
            Le programme de l'anneau, résolu à partir des enregistrements
            indexés. Omis lorsque `ringConfig` est omis ou que l'enregistrement
            de l'anneau n'a pas été indexé. Utilisez `ringConfig` pour
            distinguer « aucun anneau » de « anneau avec un programme non indexé
            ».
        salt:
          type: string
          description: >-
            Sel AES au niveau de la transaction, partagé par tous les textes
            chiffrés de sortie.
          nullable: true
        slot:
          type: integer
          format: uint64
          minimum: 0
        txSignature:
          $ref: '#/components/schemas/SerializableSignature'
        txViewingPk:
          type: string
          description: Une chaîne d'octets encodée en base64.
          nullable: true
    SerializableSignature:
      type: string
      description: Une signature de transaction Solana de 64 octets encodée en base58.
    SlotFilter:
      type: object
      description: >-
        Limites de slots pour la lecture. Les limites fournies sont combinées
        avec AND.
      properties:
        gt:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: Incluez uniquement les transactions postérieures à ce slot.
        gte:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: >-
            Incluez uniquement les transactions de ce slot ou d'un slot
            ultérieur.
        lt:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: Incluez uniquement les transactions antérieures à ce slot.
        lte:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: >-
            Incluez uniquement les transactions de ce slot ou d'un slot
            antérieur.
      additionalProperties: false
    RingsMessage:
      type: object
      required:
        - viewTag
        - payload
      properties:
        payload:
          $ref: '#/components/schemas/Base64String'
        viewTag:
          $ref: '#/components/schemas/Hash'
    RingsOutputSlot:
      type: object
      required:
        - viewTag
        - outputContext
        - payload
      properties:
        outputContext:
          $ref: '#/components/schemas/RingsOutputContext'
        payload:
          $ref: '#/components/schemas/Base64String'
        viewTag:
          $ref: '#/components/schemas/Hash'
    Base64String:
      type: string
      description: Une chaîne d'octets encodée en base64.
    RingsOutputContext:
      type: object
      required:
        - hash
        - tree
        - treeId
        - leafIndex
      properties:
        hash:
          $ref: '#/components/schemas/Hash'
        leafIndex:
          type: integer
          format: uint64
          minimum: 0
        tree:
          allOf:
            - $ref: '#/components/schemas/SerializablePubkey'
          description: >-
            Compte de l'arbre d'état. Privilégiez treeId ; le compte de l'arbre
            en est dérivé.
          deprecated: true
        treeId:
          type: integer
          format: uint16
          description: >-
            L'ID brut de l'arbre sous lequel l'engagement de la sortie est
            haché.
          minimum: 0
    SerializablePubkey:
      type: string
      description: Une clé publique Solana encodée en base58.
  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.