ПунктЗначение
ИмяDELTA-BASE (BIND документа спецификации DELTA-BASE)
TAG ID0x1DBL
Codec ID0x00001DB0
Документ спецификации0x00000000/codecs/0x00001DB0/ (цель DECLARE 1DB0)
Раздел14 1110 (Meta), смещение в разделе C = 27
KindMeta · класс: родословная
TAG WORD0001 1101 1011 LLLL (000K KKKC CCCC LLLL)
Описание в индексеЭтот файл версии — diff относительно базовой версии того же документа (ID версии 2 WORD) (git packfile delta)
Сторона Hugometa/lineage/delta-base.md

Поля (документ спецификации)

Порядок FIELD в документе — это порядок полей Payload (Документ спецификации Codec).

ПорядокПоле (BIND)FIELDШиринаПринимаемый формат (CODEC)ENUM
1version#2простое значение 2 WORD0620 UNSIGNED-INTEGER

Маркер того, что этот файл версии является не снимком, а diff относительно базовой версии того же документа (delta в git packfile). Сама версия по-прежнему определяется как снимок. Хеш содержимого, список версий и подписи — всё это относится к снимку, восстановленному применением diff (Хранение diff).

Раскладка

TAG WORD          0001 1101 1011 LLLL      Codec 0x1DBL
ID версии         2 WORD unsigned (базовая версия того же документа)
  • Codec: Meta 0x1DBL, класс родословной
  • Payload: ID версии 2 WORD (простое значение)
  • Количество: не более одного

Интерпретация и валидность

  • Используется только в документах с DOC-ID. В списке версий versions.geul, документах-списках (версии issuers/) и безымянных документах, где DOC-ID не ставится, diff не используется.
  • Базовая версия — опубликованная версия с тем же DOC-ID, предшествующая этой версии. 0 (нет версии) — invalid.
  • Хеш содержимого восстановленного снимка должен совпадать с хешем этой версии в списке версий (PUBLICATION). Если не совпадает, этот diff invalid. Поэтому итоговый хеш внутри diff отдельно не записывается.
  • В виде diff может храниться только документ, у которого все записи BODY являются Edge (записями с Edge Id). Это потому, что единица diff — LOCAL ID (Edge Id).
  • Правила восстановления снимка следуют Хранению diff. Удаление берёт на себя DELTA-REMOVE.
  • Отдельных маркеров добавления и редакции нет. Если Edge Id из BODY diff есть в базе, это редакция, если нет — добавление. Добавление получает номер, начиная с NEXT-LOCAL-ID списка версий. Повторное использование удалённого LOCAL ID — invalid (Редакция).

Пример

diff относительно базовой версии 3:

1DB2 0000 0003
  • TAG 1DB2 (Meta 0x1DBL, LLLL=0010, 3 WORD), ID версии 0000 0003.

Открытые проблемы

  1. Интервал снимков: через сколько версий ставить полный снимок (длина цепочки diff и стоимость восстановления).
  2. Ограничивать ли базовую версию непосредственно предыдущей.
  3. Место хранения файла diff: класть ли его на место файла версии (<ID версии>.geul); связь с адресом по хешу содержимого <Issuer>/hashes/ (hashes/ ищется по хешу содержимого снимка).

Исходный текст документа спецификации

Документ спецификации 0x00000000/codecs/0x00001DB0/latest.geul, прочитанный командой geul show (16-ричные значения в верхнем регистре).

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