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

# getShieldedTransactionsByTags

> Récupérez les événements de transactions protégées correspondant à des balises de visualisation ou à un anneau spécifique.

## Historique des transactions

Les balises sélectionnent les transactions. Chaque entrée dans `result.data` contient tous les événements d'une transaction Solana sélectionnée, limités à `ringProgramId` lorsque vous le fournissez. Les événements comprennent les sorties chiffrées, les messages, les annulateurs et les métadonnées de l'anneau. Déchiffrez les charges utiles dans votre portefeuille pour récupérer les montants et les actifs. Consultez le [guide de l'historique privé](https://www.helius.dev/docs/fr/privacy/guides/read-history.md).

Les balises correspondent aux balises de visualisation des sorties et des messages. Un tableau `tags` vide nécessite `ringProgramId` et sélectionne l'historique de l'anneau, y compris les transactions sans balise de destinataire. Lorsque les deux sont fournis, les transactions doivent correspondre aux balises et à l'anneau.

Consultez la section [pagination et fraîcheur des données](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. Pour reprendre une lecture sans limite ayant rattrapé son retard, définissez `slot.gt` sur la valeur `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 à partir de ce slot inclus.

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

Inclut uniquement les transactions antérieures à ce slot.

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

Inclut uniquement les transactions jusqu'à ce slot inclus.

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

Nombre maximal de transactions Solana par page, de 1 à 1 000.

**minContextSlot** `number`

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

**paginationToken** `string`

Jeton de continuation de la réponse précédente. Renvoyez-le sans modification avec les mêmes balises, le même anneau et les mêmes filtres de slots.

**ringProgramId** `string`

Limite les résultats à l'anneau autorisé par cet ID de programme. Obligatoire lorsque le tableau des balises est vide.

**tags** `array` *required*

Balises de visualisation de 32 octets encodées en Base58. Maximum : 1 000. Un tableau vide nécessite ringProgramId et sélectionne cet anneau.


## OpenAPI

````yaml fr/openapi/privacy/getShieldedTransactionsByTags.yaml POST /v1/spr/getShieldedTransactionsByTags
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/getShieldedTransactionsByTags:
    post:
      summary: getShieldedTransactionsByTags
      description: >-
        Récupère les événements de transactions protégées correspondant à des
        balises de visualisation ou à un ring spécifique.
      operationId: getShieldedTransactionsByTags
      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:
                    - getShieldedTransactionsByTags
                  default: getShieldedTransactionsByTags
                params:
                  type: object
                  required:
                    - tags
                  properties:
                    filters:
                      allOf:
                        - $ref: '#/components/schemas/HistoryFilters'
                      description: >-
                        Limites de slots. Pour reprendre une lecture à jour et
                        sans limite, 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 conservé par l’indexeur requis pour cette
                        lecture. Renvoie l’erreur JSON-RPC -32016 si l’indexeur
                        est en retard.
                    paginationToken:
                      type: string
                      description: >-
                        Jeton de continuation provenant de la réponse
                        précédente. Renvoyez-le sans le modifier avec les mêmes
                        balises et les mêmes filtres de ring et de slots.
                      nullable: true
                    ringProgramId:
                      type: string
                      description: >-
                        Limite les résultats au ring autorisé par cet ID de
                        programme. Requis lorsque tags est vide.
                      nullable: true
                    tags:
                      type: array
                      items:
                        $ref: '#/components/schemas/Hash'
                      description: >-
                        Balises de visualisation de 32 octets encodées en
                        base58. 1 000 au maximum. Un tableau vide nécessite
                        ringProgramId et sélectionne ce ring.
                      maxItems: 1000
                  additionalProperties: false
                  example:
                    tags:
                      - '11111111111111111111111111111112'
                    limit: 100
            example:
              jsonrpc: '2.0'
              id: '1'
              method: getShieldedTransactionsByTags
              params:
                tags:
                  - '11111111111111111111111111111112'
                limit: 100
        required: true
      responses:
        '200':
          description: Réponse JSON-RPC. Examinez error avant de lire 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 délimitée d’une lecture d’historique, avec une
                      pagination de type 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 lorsqu’il n’est pas disponible.
                        minimum: 0
                      paginationToken:
                        type: string
                        description: >-
                          Jeton pour la page suivante, null lorsqu’aucun autre
                          résultat ne correspond. Une lecture à jour

                          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 non-correspondance 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 ne contient
                      pas un seul appel JSON-RPC.
                  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 seul appel JSON-RPC.
                  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 seul appel JSON-RPC.
                  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é conservé par l’indexeur, utilisé pour vérifier
            l’actualisation en fonction des 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és qui ne sont liés à aucun engagement de
            sortie et sont 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: >-
            Compte de configuration du ring (son PDA `ring_auth`). Omis
            lorsqu’aucun ring n’a autorisé cette transaction.
        ringProgramId:
          type: string
          description: >-
            Programme du ring, résolu à partir des enregistrements indexés. Omis
            lorsque `ringConfig` est omis ou que l’enregistrement du ring n’a
            pas été indexé. Utilisez `ringConfig` pour distinguer « aucun ring »
            d’un « ring associé à un programme non indexé ».
        salt:
          type: string
          description: >-
            Sel AES au niveau de la transaction, partagé par chaque texte
            chiffré 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: Inclut uniquement les transactions postérieures à ce slot.
        gte:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: >-
            Inclut uniquement les transactions de ce slot ou d’un slot
            ultérieur.
        lt:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: Inclut uniquement les transactions antérieures à ce slot.
        lte:
          type: integer
          format: uint64
          minimum: 0
          nullable: true
          description: >-
            Inclut 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. Préférez 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.