NIP-99
案内広告リスト(Classified Listings)
このNIPは kind:30402 を定義する: これは、任意の商品、サービス、その他の売り物を掲載する案内広告(classified)のリストを表現するのに十分な構造化されたメタデータを含む、パラメータつき上書き可能イベントである。
広告のカテゴリは、物理的な商品、サービス、求人、賃貸(rentals)、無料の景品(free givaways)、個人広告(personals 訳注: 交際相手を探す広告)など非常に多岐にわたる。これは
NIP-15で定義される、非常に限定された販路を通し特定の商品を大量に売る、より厳密に構造化されたマーケットプレイスとは異なる。
このイベントの構造は
NIP-23の長文コンテンツイベントと非常によく似ている。
下書き/非アクティブリスト
kind:30403 は kind:30402 と同じ構造を持ち、下書きまたは非アクティブな案内広告リストを保存するのに用いる。
Content
content フィールドは何が誰によって提供されるのかを説明する、Markdown形式の文字列とすべきである。
発行者(Author)
pubkey フィールドは、リストを作成した当事者として扱われる。
メタデータ
「タグ」/「ハッシュタグ」(リストに関連するカテゴリやキーワード)を表すには、
NIP-12の
t タグを用いるべきである
画像については、Markdownコンテンツに含まれているか否かにかかわらず、クライアントは
NIP-58で定めれらている
image タグを用いるべきである(SHOULD)。これにより、クライアントは簡単に画像をカルーセル形式で表示できる。
以下の、構造化メタデータに用いるタグを標準化する。これらは( kind:30402 のイベントに)含めるべきである(SHOULD)。必要に応じて他のタグを追加してもよい。
title : リストのタイトル
summary : リストのための短いキャッチフレーズ(tagline)や概要
published_at : リストがはじめて公開された時刻(文字列化した秒単位のunixtime)
location : 場所
price : 掲載されているものの価格。次のような形式の配列: ["price", "<数値>", "<通貨>", "<頻度>"]
"price" : タグ名
"<数値>" : 価格の数値(ただし、タグには文字列として含める)
"<通貨>" : 3文字の ISO 4217形式の通貨単位、またはISO 4217風の通貨コード(例: "btc" , "eth" )
"<頻度>" : 任意で、継続的な支払いを表現するのに使う。名詞形式(hour, day, week, month, year)とするべき
price の例
50ドル 1回払い ["price", "50", "USD"]
月額 15ユーロ ["price", "15", "EUR", "month"]
年額 50,000ポンド ["price", "50000", "GBP", "year"]
有用と思われる他の標準タグ
g : ( location に比べて)より正確な場所を表すgeohash
イベント例
30402.json{
"kind": 30402,
"created_at": 1675642635,
// Markdown コンテンツ
"content": "Lorem [ipsum][nostr:nevent1qqst8cujky046negxgwwm5ynqwn53t8aqjr6afd8g59nfqwxpdhylpcpzamhxue69uhhyetvv9ujuetcv9khqmr99e3k7mg8arnc9] dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.\n\nRead more at nostr:naddr1qqzkjurnw4ksz9thwden5te0wfjkccte9ehx7um5wghx7un8qgs2d90kkcq3nk2jry62dyf50k0h36rhpdtd594my40w9pkal876jxgrqsqqqa28pccpzu.",
"tags": [
["d", "lorem-ipsum"],
["title", "Lorem Ipsum"],
["published_at", "1296962229"],
["t", "electronics"],
["image", "https://url.to.img", "256x256"],
["summary", "More lorem ipsum that is a little more than the title"],
["location", "NYC"],
["price", "100", "USD"],
[
"e",
"b3e392b11f5d4f28321cedd09303a748acfd0487aea5a7450b3481c60b6e4f87",
"wss://relay.example.com"
],
[
"a",
"30023:a695f6b60119d9521934a691347d9f78e8770b56da16bb255ee286ddf9fda919:ipsum",
"wss://relay.nostr.org"
]
],
"pubkey": "...",
"id": "..."
}