ÉlémentValeur
NomDELTA-BASE (BIND DELTA-BASE du document de spécification)
TAG ID0x1DBL
Codec ID0x00001DB0
Document de spécification0x00000000/codecs/0x00001DB0/ (cible du DECLARE 1DB0)
Section14 1110 (Meta), décalage C dans la section = 27
KindMeta · classe : lignée
TAG WORD0001 1101 1011 LLLL (000K KKKC CCCC LLLL)
Description d’indexCe fichier de version est un diff par rapport à une version de base du même document (ID de version sur 2 WORD) (git packfile delta)
Côté Hugometa/lineage/delta-base.md

Champs (document de spécification)

L’ordre des FIELD dans le document est l’ordre des champs du Payload (document de spécification de Codec).

OrdreChamp (BIND)FIELDLargeurFormat reçu (CODEC)ENUM
1version#2valeur brute 2 WORD0620 UNSIGNED-INTEGER

Marqueur indiquant que ce fichier de version n’est pas un instantané mais un diff par rapport à une version de base du même document (delta d’un packfile git). La version elle-même reste définie comme un instantané. Le hachage du contenu, la liste des versions et les signatures portent tous sur l’instantané restauré par application du diff (stockage par diff).

Disposition

TAG WORD          0001 1101 1011 LLLL      Codec 0x1DBL
ID de version     2 WORD non signés (version de base du même document)
  • Codec : Meta 0x1DBL, classe lignée
  • Payload : ID de version sur 2 WORD (valeur brute)
  • Nombre : au plus un

Interprétation et validité

  • On ne l’emploie que dans un document qui a un DOC-ID. La liste des versions versions.geul, qui n’a pas de DOC-ID, les documents de liste (versions de issuers/) et les documents anonymes n’ont pas de diff.
  • La version de base est une version publiée du même DOC-ID, antérieure à cette version. 0 (aucune version) est invalid.
  • Le hachage du contenu de l’instantané restauré doit être égal au hachage de cette version dans la liste des versions (PUBLICATION). Sinon, ce diff est invalid. C’est pourquoi on n’écrit pas séparément le hachage du résultat dans le diff.
  • Seul un document dont tous les enregistrements du BODY sont des Edge (enregistrements ayant un Edge Id) peut être mis en diff, car l’unité du diff est le LOCAL ID (Edge Id).
  • La règle de restauration de l’instantané suit le stockage par diff. La suppression relève de DELTA-REMOVE.
  • Il n’y a pas de marqueur distinct d’ajout ou de révision. Si l’Edge Id d’un BODY de diff existe dans la base, c’est une révision ; sinon, c’est un ajout. Les ajouts reçoivent leur numéro à partir de NEXT-LOCAL-ID de la liste des versions. Réutiliser un LOCAL ID supprimé est invalid (révision).

Exemple

Diff par rapport à la version de base 3 :

1DB2 0000 0003
  • TAG 1DB2 (Meta 0x1DBL, LLLL=0010, 3 WORD), ID de version 0000 0003.

Problèmes ouverts

  1. Intervalle des instantanés : tous les combien de versions placer un instantané complet (longueur de la chaîne de diffs et coût de restauration).
  2. Faut-il limiter la version de base à la version immédiatement précédente ?
  3. Emplacement de stockage du fichier de diff : à la place du fichier de version (<ID de version>.geul) ou en relation avec l’adresse par hachage du contenu <Issuer>/hashes/ (hashes/ se retrouve par le hachage du contenu de l’instantané).

Texte du document de spécification

Voici le document de spécification 0x00000000/codecs/0x00001DB0/latest.geul tel que lu par geul show (hexadécimal en majuscules).

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001DB000000000
BODY
#1 DECLARE 0x1DB0
#2 FIELD #1 0x0002
#3 BIND #1 "DELTA-BASE"
#4 BIND #2 "version"
#5 CODEC #2 0x0620