項目値
名前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)
索引の説明このバージョンファイルは同じドキュメントの基準バージョン(2 WORD のバージョン ID)に対する diff である (git packfile delta)
Hugo 側meta/lineage/delta-base.md

フィールド (規格ドキュメント)

FIELD のドキュメント内の順序が Payload フィールドの順序である(Codec 規格ドキュメント)。

順序フィールド(BIND)FIELD幅受ける形式(CODEC)ENUM
1version#2生値 2 WORD0620 UNSIGNED-INTEGER

このバージョンファイルがスナップショットではなく、同じドキュメントの基準バージョンに対する diff であることを示すマーカーである(git packfile の delta)。バージョン自体は依然としてスナップショットとして定義される。コンテンツハッシュ、バージョン一覧、署名はすべて、diff を適用して復元したスナップショットが基準である(diff の保存)。

レイアウト

TAG WORD          0001 1101 1011 LLLL      Codec 0x1DBL
バージョン ID     2 WORD unsigned (同じドキュメントの基準バージョン)
  • Codec: Meta 0x1DBL、系譜クラス
  • Payload: 2 WORD のバージョン ID(生値)
  • 個数: 多くても 1 つ

解釈と有効性

  • DOC-ID のあるドキュメントにのみ使う。DOC-ID を置かないバージョン一覧 versions.geul、一覧ドキュメント(issuers/ のバージョン)、名前のないドキュメントには diff を置かない。
  • 基準バージョンは同じ DOC-ID の公表済みバージョンであり、このバージョンより前のものである。0(バージョンなし)は invalid である。
  • 復元したスナップショットのコンテンツハッシュが、バージョン一覧(PUBLICATION)のこのバージョンのハッシュと同じでなければならない。異なる場合、この diff は invalid である。そのため diff の中に結果のハッシュを別途記さない。
  • BODY のすべてのレコードが Edge(Edge Id を持つレコード)であるドキュメントだけが diff にできる。diff の単位が LOCAL ID(Edge Id)だからである。
  • スナップショットの復元規則は diff の保存に従う。削除は DELTA-REMOVE が担う。
  • 追加・改訂のマーカーは別に置かない。diff BODY の Edge Id が基準にあれば改訂、なければ追加である。追加はバージョン一覧の NEXT-LOCAL-ID から番号を受ける。削除した LOCAL ID を再び使うと invalid である(改訂)。

例

基準バージョン 3 に対する diff:

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