Spécifications du protocole

Le corpus normatif du Protocole de Transparence Canaliste (PTC) est composé de trois documents aux fonctions distinctes. Aucun document n'assume plus d'une fonction normative.

Relations entre documents

Spécification

Spécification du texte canonique du Protocole de transparence du Canal (PTC)

R-01 · v 1.1
Publié

Définit l'objet canonique : règles de normalisation du texte, calcul des trois hachages cryptographiques et algorithme d'extraction du bloc PTC. C'est le fondement technique qui permet à deux implémentations indépendantes de produire le même résultat.

Spécification

Spécification fonctionnelle du Protocole de transparence du Canal (PTC)

PTC-F · v 1.2
Publié

Définit les champs du bloc PTC : noms, ordre normatif, valeurs valides et la sémantique que l'opérateur s'engage à respecter en utilisant chaque valeur. Distingue la conformité syntaxique de la véracité de la déclaration.

Architecture

Architecture normative du Protocole de transparence du Canal (PTC)

ARCH · v 0.3
Publié

Définit les relations entre les spécifications : gouvernance du corpus, tableau des propriétaires normatifs, modes de fonctionnement, architecture des adaptateurs et l'implémentation conforme de référence.

Téléchargements du corpus complet

Copies de distribution pour lecture et archivage : Markdown (ES/EN/FR) · DOCX (ES/EN/FR)

Implémentation conforme de référence

validator.es est l’implémentation de référence conforme au protocole PTC. Ce n’est pas le protocole : il le met en œuvre. Un tiers peut construire une autre implémentation conforme en lisant uniquement R-01, PTC-F et ARCH.

Questions pour les implémenteurs

Que dois-je lire pour implémenter le protocole ?
Les trois documents du corpus : R-01 (normalisation et hachages), PTC-F (champs et sémantique) et l'Architecture Normative (relations et adaptateurs). C'est l'ordre de lecture recommandé.
Comment vérifier que mon implémentation est conforme ?
Exécutez les cas de conformité définis dans R-01 et PTC-F et vérifiez aussi les exigences architecturales d’ARCH. Les cas sont nécessaires, mais la conformité exige de respecter l’ensemble du corpus actuel.
Que signifie version: R-01 dans un bloc PTC ?
Cela indique que l'artefact a été généré sous le profil actuel R-01 v1.1 / PTC-F v1.2. Les artefacts avec version: 6 ont été générés sous ACS-6, la génération fondatrice antérieure, et ne sont pas validés par cette implémentation.
Puis-je implémenter le protocole dans n'importe quel langage de programmation ?
Oui. Le protocole spécifie un comportement, pas une implémentation. Vous avez besoin d'une fonction SHA-256, de la gestion du texte UTF-8 et des règles de normalisation de R-01.
Où signaler les incohérences dans les spécifications ?
Les spécifications sont des documents versionnés. Les incohérences, résultats d’interopérabilité et propositions de mise en œuvre peuvent être envoyés à contacto@validator.es.