GETMéthode GET/passport/01/{gtin}/proof

Code HTTP 200.

{
  "passport_version": 3,
  "data_hash": "1111111111111111111111111111111111111111111111111111111111111111",
  "ipfs_uri": "ipfs://bafybeiaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "ipfs_gateway_url": "https://ipfs.io/ipfs/bafybeiaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "passport_anchor": {
    "chain": "base",
    "chain_id": 8453,
    "tx_hash": "0x2222222222222222222222222222222222222222222222222222222222222222",
    "basescan_url": "https://basescan.org/tx/0x2222222222222222222222222222222222222222222222222222222222222222",
    "merkle_root": "0x3333333333333333333333333333333333333333333333333333333333333333",
    "leaf": "0x4444444444444444444444444444444444444444444444444444444444444444",
    "leaf_index": 7,
    "proof": [
      "0x5555555555555555555555555555555555555555555555555555555555555555",
      "0x6666666666666666666666666666666666666666666666666666666666666666"
    ],
    "anchored_at": "2026-08-14T09:12:44.318000+00:00",
    "data_hash_matches": true,
    "proves": "content_existed_at_or_before_tx"
  },
  "seal": {
    "sealed": true,
    "sealed_at": "2026-08-12T10:04:11.882000+00:00",
    "algorithm": "st-dpp-chain-v1",
    "version_hash": "7777777777777777777777777777777777777777777777777777777777777777",
    "prev_version_hash": "8888888888888888888888888888888888888888888888888888888888888888",
    "linked": true,
    "chain_link_match": true
  },
  "vc": {
    "issued": true,
    "vct": "https://schema.sealtrust.io/vct/digital-product-passport",
    "issued_at": "2026-08-12T10:04:12.140000+00:00"
  },
  "level": "model",
  "gtin": "03701234567890"
}

La réponse porte aussi l'en-tête Cache-Control: no-store, max-age=0. Ne mettez cette réponse dans aucun cache partagé. Pour réduire le nombre de vos appels, gardez le résultat dans votre propre cache applicatif, avec la durée de fraîcheur que votre usage tolère.

Cinq champs sont toujours présents : passport_version, seal, vc, et, propres à ce point d'entrée, level et gtin. Les autres champs n'apparaissent que lorsque la preuve correspondante est établie. Une absence recouvre deux situations que la réponse ne distingue pas : la preuve n'existe pas encore, ou nous n'avons pas pu l'établir au moment de votre appel. Ne lisez jamais une absence comme une altération.

#Le bloc passport_anchor

Ce bloc établit une seule chose : le contenu de cette version existait au plus tard au moment de la transaction. C'est ce que dit son champ proves, dont la valeur est content_existed_at_or_before_tx. Il ne rend pas le contenu vrai, et il n'empêche pas la marque de publier une correction plus tard.

Vous pouvez recalculer la racine vous-même. Vous partez de leaf. Pour chaque élément de proof, dans l'ordre, vous mettez les deux valeurs de 32 octets côte à côte, la plus petite des deux d'abord, puis vous appliquez keccak256 à la concaténation. Le résultat devient la nouvelle valeur de travail. Après le dernier élément de proof, vous devez obtenir exactement merkle_root. C'est la convention de vérification d'OpenZeppelin. Nous trions les voisins à chaque étage, donc la preuve n'a pas besoin d'indiquer un sens.

Il vous reste à vérifier que merkle_root est bien la valeur inscrite sur la chaîne. Ouvrez basescan_url pour lire la transaction d'inscription.

Un passport_anchor absent ne veut pas dire que le passeport n'est pas fiable. L'inscription sur la chaîne est une opération que SealTrust déclenche. Une marque ne la commande pas depuis sa console, et beaucoup de versions publiées ne sont jamais inscrites. Publier une version reste une écriture en base de données, sans transaction sur la chaîne. Le bloc seal, lui, est présent sur toute version scellée, et c'est lui qui rend visible une réécriture tant qu'aucune inscription ne couvre la version.

#Le bloc seal

Nous fixons le sceau à la première publication d'une version. Il chaîne cette version à la précédente du même passeport, ce qui rend visible une réécriture survenue après coup.

#Le bloc vc

L'attestation est le passeport rendu sous forme d'un document signé, au format SD-JWT-VC. La clef privée de signature ne quitte pas un module matériel de sécurité.

#Pourquoi ipfs_uri peut manquer

Nous n'annonçons la copie IPFS que lorsque nous avons vérifié, au moment de votre appel, que son contenu est exactement le passeport public que la marque publie aujourd'hui. Nous allons chercher la copie, nous la hachons, et nous ne publions le lien qu'en cas de correspondance.

Trois situations produisent donc une réponse sans ipfs_uri : aucune copie n'a été épinglée, la copie n'a pas pu être récupérée au moment de votre appel, ou son contenu ne correspond plus à ce que la marque publie. Une marque qui change ses règles d'accès change ce que montre son passeport public, donc une copie épinglée avant ce changement cesse d'être annoncée tant qu'elle n'a pas été épinglée de nouveau. Le champ ne distingue pas ces trois cas. Ne lisez jamais son absence comme une preuve que la copie a été altérée.