ADR-0021 — Format canonique pour operation.payload pré-hash
| Statut | Proposé |
|---|---|
| Date | 2026-02-15 |
| Auteurs | Julien Jorry |
Contexte
Le hash chain des Operation dépend d'une sérialisation déterministe : deux serveurs ou deux versions de PHP doivent produire le même hash à partir des mêmes données. Sans canonicalization stricte, l'ordre des clés JSON peut varier.
Décision
À formaliser. Sérialisation JCS (RFC 8785) ou équivalent : clés triées lex, pas d'espaces, encodage UTF-8 NFC, nombres sans notation scientifique.
Conséquences positives
À documenter.
Conséquences négatives
À documenter.
Alternatives examinées
- JSON natif PHP — rejeté : ordre non garanti.
- MessagePack — binaire, moins lisible.
- JCS (RFC 8785) — lisible, déterministe.