NIP-73は、Nostrイベントの中で外部コンテンツを参照するための標準的な方法を定義しています。識別子そのものにはiタグを、識別子の種類にはkタグを使います。これによりクライアントは、同じ書籍、ウェブサイト、ポッドキャストのエピソード、場所、ハッシュタグ、ブロックチェーン上のオブジェクトをめぐる議論をまとめることができます。現行の仕様は、ドラフトかつオプションと位置づけられています。

仕組み

NIP-73を使うイベントには、正規化された外部識別子を入れたiタグと、識別子のファミリーを示すkタグが含まれます。クライアントは、iで特定の1つの対象を、kでファミリー全体を、それぞれリレーに問い合わせることができます。NIP-73は独自のイベントkindを追加しません。これらのタグは、コメント、レビュー、その他のイベントに付けられます。

タグの断片であり、完全なイベントではありません:

{
  "tags": [
    ["i", "isbn:9780765382030"],
    ["k", "isbn"]
  ]
}

ウェブページの場合は、正規化したURLをiに入れ、kをwebに設定します。仕様は複数の識別子ファミリーを扱っており、次のものが含まれます:

  • フラグメントを含まない正規化済みのウェブURL
  • 書籍のISBN
  • 映画のISAN
  • DOI
  • ジオハッシュ、およびISO 3166の国コードまたは地域区分コード
  • ポッドキャストのフィード、エピソード、パブリッシャーのGUID
  • ハッシュタグ
  • ブロックチェーンのトランザクションおよびアドレスの識別子

正規化ルール

照合は文字列の完全一致に依存するため、仕様はファミリーごとに1つの表記形式を定めています。仕様に挙げられている例:

  • ジオハッシュはgeo:<value>の形式を使い、小文字でなければならない
  • 国コードと地域区分コードはiso3166:<code>の形式を使い、大文字でなければならない
  • ISBNはハイフンを省く
  • DOIは小文字にする
  • ウェブURLはフラグメントを取り除く
  • ブロックチェーンのトランザクションハッシュは小文字の16進数を使う

正規化で決まるのは、1つの識別子の書き方です。別名をまとめるものではありません。版ごとに異なるISBNや、正規化後も異なる文字列になるURLは、別々の識別子のままです。そのため、1冊の書籍や1本の記事についての議論が、複数のi値に分散することは依然としてあり得ます。

URLヒント

iタグには、配列の3番目の要素として任意のURLヒントを含めることができます。これはタグ名の後に続く2番目の値にあたります。その識別子の種類に対応する独自のレンダラーを持たないクライアントは、このヒントをフォールバック用のリンクとして使えます。

タグの断片: ["i", "isbn:9780765382030", "<url-hint>"]

ヒントを選ぶのは作成者です。ヒントは識別子の一部ではありません。所有権を証明するものでも、正規のサイトを示すものでもありません。

信頼とコンテキスト

同じ識別子を持つ2つのイベントは同じ会話にまとめられますが、識別子が共通であることから言えるのはそこまでです。署名済みイベントは、その作成者を特定します。参照先の書籍、サイト、ポッドキャストのパブリッシャーを認証するものではありません。それらを誰が管理しているかを示すものでもありません。

iタグが何を意味するかは、イベントによって異なります。NIP-22のコメントでは、大文字のI/Kがルートのスコープを、小文字のi/kが親を示します。このスレッド構造はNIP-22によるもので、NIP-73はコメントのkindを定義していません。NIP-39はプロフィール内の外部アイデンティティにiを使うため、すべてのiタグがNIP-73の対象を表すわけではありません。

NIP-85のTrusted Assertionsも、書籍、ウェブサイト、ハッシュタグ、場所といったNIP-73の識別子を対象にできます。

実装

rust-nostrのコミット4c8099a時点のnip73.rsは、既知のプレフィックスを解析して型付きのExternalContentIdにし、任意のヒントを型付きのURLに変換します。タグの3番目の要素を書き込むのは、ヒントがある場合だけです。テストでは、ハイフン付きのISBNがそのまま残っています。パーサーはプレフィックスを取り除いた残りを、仕様の正規化を適用せずに保存します。そのため、型付きで解析できても、正規の文字列になるとは限りません。チェーンIDはファミリーに含めず、ethereum:100:tx:<hash>をethereum:txに対応付けます。このリビジョンには、iso3166の国を表すバリアントがありません。

Amethystのコミット553f761時点のDisplayExternalId.ktは、ジオハッシュ、ハッシュタグ、URLの識別子をそれぞれ専用の表示に回し、サポート対象のその他の種類は汎用のスコープチップとして表示します。URLを選ぶと、そのページに対応するアプリ独自のスレッドルートが開きます。プレビューが無効の場合、通常の表示ではプレーンなリンクチップだけが表示され、プレビューは要求されません。プレビューが有効の場合、まだないプレビューを取得する際に、対象サイトへ接続することがあります。どちらのファイルからも、リリース済みバージョンでの動作はわかりません。

一次情報源:

言及された号:

関連項目: