NIP-15

Nostr Marketplace (for resilient marketplaces)

Nostrクライアント同士で商店を開けるようになる仕組み。

用語

Nostrマーケットプレイス クライアント

出店者が商店や商品を作成・更新・削除したり、売上・支払・顧客とのやり取りを行うための場所。

出店者向け管理ソフトは純粋なクライアントサイド実装であってもよいが、利便性と動作可能時間(の向上)の目的で、Nostrイベントをlistenするサーバを持つことになるだろう。

マーケットプレイス

マーケットプレイスソフトは100%クライアントサイド実装(スタンドアロンアプリ、またはフロントエンドのみで成立するWebページ)となるだろう。顧客が出店者のNostr公開鍵を使って出店者・商店・商品をリストアップ・検索できるようにする。マーケットプレイスクライアントは、買い物かごや精算機能を持つ他のEコマースサイトに似たものとなる。マーケットプレイスは、出店者とのダイレクトメッセージを使ったやり取りを行う顧客サポート機能を持つことが望ましい。

出店者による商品の公開・更新

出店者は、以下のイベントを発行できる:

table:出店関連イベント

kind 説明

0 set_meta 出店者の説明]

30017 set_stall 商店の作成・更新

30018 set_product 商品の作成・更新

4 direct_message 顧客とのやり取り メッセージはプレーンテキストまたはJSON

5 delete 商品や商店の削除

イベント 30017: 商店の作成・更新

Content:

code:30017_content.json

{

"name": <String, 商店の名前>,

"description": <String (任意), 商店の説明>,

"currency": <String, 通用する通貨>,

"shipping": [

{

"id": <String, 配送区分のUUID。出店者が生成する>,

"name": <String (任意), 配送区分の名前>,

"cost": <float, 基本送料。 通貨は商店レベルで定義>,

}

]

}

要説明のフィールド:

shipping

商店が対応している配送区分の配列。

顧客はちょうど1つの配送区分を選択しなければならない(MUST)

区分ごとに送料は異なる。送料無料の商品もある(例: デジタルなもの)

各配送区分は、その区分への注文に対する基本送料を持つが、特定の商品の送料が基本送料よりも高額になる場合、商品ごとの送料を設定することもできる。

Tags:

code:30017_tags.json

イベント 30018: 商品の作成・更新

Content:

code:30018_content.json

{

"stall_id": <String, この商品が陳列される商店のUUID>,

"name": <String, 商品名>,

"description": <String (任意), 商品の説明>,

"currency": <String, 通貨>,

"price": <float, 商品の価格>,

"quantity": <int, 商品の数量>,

"specs": [

],

"shipping": [

{

"id": <String, 配送区分のUUID。商店(イベント)で定義された地域のどれか1つに一致しなければならない>,

"cost": <float, 追加送料。通貨は商店(イベント)で定義される>

}

]

}

要説明のフィールド:

specs

key-valueペアの配列(任意)。製品仕様を構造化された形で表示できるようにする。商品間の比較も可能となる。

配送区分ごとの追加送料(任意)。商店(イベント)で決められた基本送料に追加で特別な配送コストが必要となる商品のみに対し使われる

ユーザは精算時に配送方法を選択する。その後、ある注文に対する送料の合計を計算するにあたり、クライアントは以下のコストを考慮しなければならない:

選択された配送方法における、商店の基本送料

商品に対し設定された(追加)送料に購入数を掛けた結果(あれば)

Tags:

code:30018_tags.json

"tags": [

...

]

精算イベント(Checkout events)

table:精算イベントのtype

type 送信者 説明

0 顧客 新しい注文

1 出店者 支払い請求

2 出店者 注文のステータス更新

ステップ1: 顧客による注文

code:order.json

{

"id": <String, UUID(顧客が生成)>,

"type": 0,

"name": <String (任意), ???>,

"address": <String (任意), 物理的な商品の場合は住所(配送先?)を含める>

"message": <String (任意), 出店者へのメッセージ>,

"contact": {

"nostr": <(顧客の)公開鍵(32バイト・16進文字列)>,

"phone": <String (任意), 顧客が電話での連絡を希望する場合>,

"email": <String (任意), 顧客がEメールでの連絡を希望する場合>,

},

"items": [

{

"product_id": <String, 商品のUUID>,

"quantity": <int, 注文数量>

}

],

"shipping_id": <String, 配送区分のUUID>

}

ステップ2: 出店者による支払い請求

支払い請求のために出店者から折返し送信される。出店者が確認できる限り、任意の支払い手段が有効。

code:request_payment.json

{

"id": <String, 注文のUUID>,

"type": 1,

"message": <String, 顧客へのメッセージ, 任意>,

"payment_options": [

{

"type": <String, 支払い手段>,

"link": <String, URL、BTCアドレス、LNインボイス ほか>

},

{

"type": <String, 支払い手段>,

"link": <String, URL、BTCアドレス、LNインボイス ほか>

}

]

}

ステップ3: 出店者による支払い確認・出荷

出店者が支払いを領収・処理した時点で送信。

code:verify_payment.json

{

"id": <String, 注文のUUID>,

"type": 2,

"message": <String, 顧客へのメッセージ>,

"paid": <Bool, true/false 支払い領収済みか>,

"shipped": <Bool, true/false 出荷済みか>,

}

顧客サポートイベント(Customer support events)

追加情報