チェーン上のファイル（DFS）

ZooBC にはファイルを保持する方法が 2 つあります。DFS ファイルは小さな内容のためのものです。ファイルは自身のトランザクションの中で運ばれ、チェーンはそれをオーナーのデータセットの行として記録します。より大きなファイルは 分散ストレージプール に送られ、決してチェーンに触れないピースに分割されます。この記事では DFS ファイルを扱います。

レコードと内容

あるオーナーのあるパスにある DFS ファイルは、データセットの行 (owner, owner, "dfs:" + path) です。設定者と受取人はどちらもオーナーで、プロパティは dfs: にパスを続けたものです。行の値は、次のメタデータのレコードを 16 進にしたものです。

• 内容の SHA3-256 ハッシュとそのサイズ
• パーミッション（0644）
• 2 つのタイムスタンプ
• チャンクの数と各チャンクのハッシュ

内容そのものはトランザクションの本体の中で運ばれます。本体は最大 65,536 バイトなので、DFS ファイルは最大約 64 KiB を保持します。ノードはそのバイト列を、チェーンの傍らにあるローカルのチャンクテーブルに保持します。それはコンセンサスの状態の一部ではありません。チェーン上の行がハッシュを保持しているため、誰でも内容をそれと照合できます。

パス

パスは / で始まり、長さは最大 1,024 バイトです。//、..、NUL バイト、復帰、改行を含んではなりません。末尾の / は取り除かれるため、/a/b/ と /a/b は同じファイルを指します。dfs: または dfs:dir: の下に行を書き込めるのは DFS のトランザクションだけで、どちらかのプレフィックスを持つ SetupAccountDataset は拒否されます。

作成、更新、削除

既存のファイルに対する作成や、存在しないファイルの更新や削除は、有料の空操作です。手数料は徴収され、何も変わりません。したがってアプリは、作成と更新のどちらにするかを選ぶ前に、パスの行を読むべきです。

レントと返金

DFS の行は、他と同じデータセットオブジェクトです。誰でも資金を入れられる独自のデポジットアドレス（ZBS_…）を持ち、そのバイト数（プロパティと 16 進の値）に対して期間ごとにデータセットレントを支払います。mainnet の開始時の価格では、1 期間・1 MiB あたり 0.05 ZBC です。レントはデポジットから、次にオーナーから引かれ、ロンジェビティプールに入金されます。どちらも支払えなければ、他のデータセットと同様に行は無効になります。

DFS ファイルを削除すると、オーナーを含む各支払者に、デポジットのうちそれぞれの未使用分が戻ります。お金は先入れ先出しで消費されます。最も古い支払いが使い切られてから次の支払いに手が付けられるため、最も最近の支払者が最も多く取り戻します。

DFS ファイルか、保存されたファイルか

どちらの方法も、ZooBC Foundation のマシンにもアップロードした人のコンピューターにも依存しません。

関連項目

• データセット
• 分散ストレージプール
• データ保持のための支払い（ロンジェビティ）
• データとストレージ