dev.jisaku.mosimo.priority

配送優先度ヒントPriority · 投稿の拡張

著者が投稿に付ける配送優先度のヒントと、受信ノードがそれを用いて実効優先度を決める規則を定義する。認可されていない発信者のヒントによって優先度が引き上げられることはない。

OVERVIEW / 要点02 EXTENSIONS
  1. level は 0 bulk、1 normal(既定)、2 important、3 urgent の四段階である。
  2. 実効優先度は、発信者が署名チェーンまたは転載サーバーの認可を通っていれば hint、そうでなければ min(hint, 1) とする。
  3. 受信者は実効優先度をさらに下げてよいが、組織名や自己署名だけで引き上げてはならない。
  4. 優先度は資源上限内での順序の決定であり、上限の解除ではない。
  5. 実効優先度は送信順・満杯時の退避順・受信の見送りに用い、受信経路(近接リンク・リレー)では区別しない。

目的

本プロトコルは、著者が投稿に付ける配送優先度のヒントと、受信ノードがそれを用いて実効優先度を決める規則を定義する。メッシュの接触時交換やリレーの取得順で、緊急性の高い情報を先に運べるようにすることが目的である。

本書が保証するのは、著者の署名したヒントがそのまま保持されることと、受信ノードが認可されていない発信者のヒントによって優先度を引き上げられないことである。署名された level は著者の要求であり、受信ノードの実効優先度はローカルの信頼・地域関連・鮮度・資源状況で決まる。実効優先度は送信順と、保存枠が満杯のときの退避順・受信の見送りの決定に用い、鍵署名・失効・配送期限・資源上限はそれぞれ独立に適用される。

前提

識別子 文書 依存する理由
dev.jisaku.mosimo コア 拡張の共通構造と運び方、同名フィールドの独立性
dev.jisaku.mosimo.attest.chain 署名チェーン 発信者が verified であることと役割の確認。認可済み発信者のヒントだけを採用するため
dev.jisaku.mosimo.attest.importer 転載サーバー 受信者による転載サーバーの認可。認可済み転載のヒントを採用するため
dev.jisaku.mosimo.pds PDS リレーの MOSIMO-REQ による実効優先度順の取得

1. 型

type PriorityExtension = {
  $type: "dev.jisaku.mosimo.priority";
  level: 0 | 1 | 2 | 3;
};
level 名称 用途
0 bulk 急がない情報
1 normal 既定。拡張がない投稿はこの値として扱う
2 important 重要な情報
3 urgent 緊急の情報

正規の定義は lexicon.json である。

2. 実効優先度

受信ノードは次の規則で実効優先度を決める。

hint = 有効な priority 拡張がちょうど 1 個 ? level : 1
effectivePriority = 発信者が認可済み ? hint : min(hint, 1)

「認可済み」とは、投稿の署名チェーンの検証結果が verified であること、または転載サーバーの受信者認可を通ったことである。どの役割の鍵にヒントどおりの実効優先度を認めるかは実装の方針であり、public-information と import の役割に限る、といった絞り込みをしてよい。

いいえ はい はい いいえ 投稿を受信 priority 拡張がちょうど 1 個で有効か hint = 1 hint = level 発信者は認可済みか effectivePriority = hint effectivePriority = min(hint, 1) ローカルの地域関連・鮮度・資源でさらに下げてよい
  • priority 拡張が複数ある、または level が不正な投稿のヒントは採用せず level 1 とする。より高い値へ修復してはならない。修復は著者が署名していない優先度を与えることになるためである。
  • 受信者は実効優先度をさらに下げてよい。組織名、自己署名の証明、外部形式の値、独自型内の同名フィールドだけから引き上げてはならない。これらは署名チェーンによる認可を経ていないためである。
  • 実効優先度を署名済みイベントへ書き戻してはならない。実効優先度は受信ノードごとの判断であり、書き戻すと署名が無効になるためである。
  • level 3 にも帯域・保存量の上限を適用する。優先度は資源上限の解除ではなく、上限内での順序の決定である。具体的なメッシュのスケジューリングと公平性は受信ノードのローカルな方針である。
  • 実効優先度は受信経路(近接リンク・Nostr リレー・PDS)に依存しない。同じイベントにはどの経路で受け取っても同じ規則を適用する。

2.1 メッシュでの適用

場面 規則
送信順 実効優先度の高いイベントを先に送る。同順位内は鮮度・地域等で並べる(mesh §9)
退避順 保存枠が満杯のとき、転送対象外のイベントの次に、実効優先度の最も低いイベントを退避する(mesh §11)
受信の見送り 転送対象のイベントだけで満杯のとき、新しいイベントの実効優先度が保持中のどれよりも低ければ受け取らない

これにより、資源が限られても上位の情報は下位の流入で押し出されず、下位の情報も枠が空いている限り運ばれる。

3. Nostr 上の表現

コア §7.3の自己完結した拡張タグで運ぶ。

["mosimo:ext:dev.jisaku.mosimo.priority", B64(C({level}))]

C は atproto deterministic CBOR、B64 は padding なしの通常 Base64 である。リレーが実効優先度順に保存済みイベントを返す任意機能は PDS の MOSIMO-REQ に従う。リレーは自身のルート鍵・失効状態・ローカル選択で実効優先度を評価し、受信者はリレーの順序を信用して自身の認可検証を省略してはならない。リレーの評価は受信者の信頼の起点と一致しないためである。

参照

Lexicon

正規の型定義

dev.jisaku.mosimo.priority#main/protocol/priority/lexicon.json ↗
protocol/mosimo/priority/lexicon.json を表示
{
  "lexicon": 1,
  "id": "dev.jisaku.mosimo.priority",
  "defs": {
    "main": {
      "type": "object",
      "description": "The author's delivery priority hint. Receivers derive an effective priority from local trust, area relevance, freshness and resources; the hint alone never raises priority above level 1 for unauthorized senders.",
      "required": ["level"],
      "properties": {
        "level": {
          "type": "integer",
          "description": "0 = bulk, 1 = normal (default when absent), 2 = important, 3 = urgent.",
          "minimum": 0,
          "maximum": 3
        }
      }
    }
  }
}