From 451c06a3c572a13afe45c1d80616f8e6dd9bb1de Mon Sep 17 00:00:00 2001 From: Jeff Gardner <202880+erskingardner@users.noreply.github.com> Date: Thu, 13 Jul 2023 15:14:19 +0200 Subject: [PATCH 1/7] Add initial draft for classifieds NIP --- 402.md | 71 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 71 insertions(+) create mode 100644 402.md diff --git a/402.md b/402.md new file mode 100644 index 00000000..c0eee147 --- /dev/null +++ b/402.md @@ -0,0 +1,71 @@ +# NIP-402 + +## Classifieds + +`draft` `optional` `author:erskingardner` + +This NIP defines `kind:30402`: a parameterized replaceable event to describe classified listings that list any arbitrary product, service, or other thing for sale or offer and includes enough structured metadata to make them useful. + +The category of classifieds includes a very broad range of physical goods, services, work opportunities, rentals, free giveaways, personals, etc. and is distinct from the more strictly structured marketplaces defined in [NIP-15](https://github.com/nostr-protocol/nips/blob/master/15.md) that often sell many units of specific products through very specific channels. + +The structure of these events is very similar to [NIP-23](https://github.com/nostr-protocol/nips/blob/master/23.md) long-form content events. + +### Draft / Inactive Listings + +`kind:30403` has the same structure as `kind:30402` and is used to save draft or inactive classified listings. + +### Content + +The `.content` field should be a description of what is being offered and by whom. These events should be a string in Markdown syntax. + +### Author + +The `.pubkey` field of these events are treated as the party creating the listing. + +### Metadata + +- For "tags"/"hashtags" (i.e. categories or keywords of relevance for the listing) the `"t"` event tag should be used, as per [NIP-12](https://github.com/nostr-protocol/nips/blob/master/12.md). + +The following tags, used for structured metadata, are standardized and SHOULD be included. Other tags may be added as necessary. + +- `"title"`, a title for the listing +- `"summary"`, for short tagline or summary for the listing +- `"published_at"`, for the timestamp (in unix seconds – converted to string) of the first time the listing was published. +- `"location"`, for the location. +- `"price"`, for the price of the thing being listed. This is a free-form string. e.g. `€2,000/week` or `$22 per hour` or `$500` + +Other standard tags that might be useful. + +- `"g"`, a geohash for more precise location + +## Example Event + +```json +{ + "kind": 30402, + "created_at": 1675642635, + // Markdown content + "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"], + ["summary", "More lorem ipsum that is a little more than the title"], + ["location", "NYC"], + ["price", "$100"], + [ + "e", + "b3e392b11f5d4f28321cedd09303a748acfd0487aea5a7450b3481c60b6e4f87", + "wss://relay.example.com" + ], + [ + "a", + "30023:a695f6b60119d9521934a691347d9f78e8770b56da16bb255ee286ddf9fda919:ipsum", + "wss://relay.nostr.org" + ] + ], + "pubkey": "...", + "id": "..." +} +``` From f065a40ee60d3b0f48f4f09e3daf12d6045cc0ae Mon Sep 17 00:00:00 2001 From: Jeff Gardner <202880+erskingardner@users.noreply.github.com> Date: Fri, 14 Jul 2023 00:05:02 +0200 Subject: [PATCH 2/7] Add image tags and change format of the price tag. --- 402.md | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/402.md b/402.md index c0eee147..5e725c7b 100644 --- a/402.md +++ b/402.md @@ -25,6 +25,7 @@ The `.pubkey` field of these events are treated as the party creating the listin ### Metadata - For "tags"/"hashtags" (i.e. categories or keywords of relevance for the listing) the `"t"` event tag should be used, as per [NIP-12](https://github.com/nostr-protocol/nips/blob/master/12.md). +- For images, whether included in the markdown content or not, clients SHOULD use `image` tags as described in [NIP-58](https://github.com/nostr-protocol/nips/blob/master/58.md). This allows clients to display images in carousel format more easily. The following tags, used for structured metadata, are standardized and SHOULD be included. Other tags may be added as necessary. @@ -32,7 +33,17 @@ The following tags, used for structured metadata, are standardized and SHOULD be - `"summary"`, for short tagline or summary for the listing - `"published_at"`, for the timestamp (in unix seconds – converted to string) of the first time the listing was published. - `"location"`, for the location. -- `"price"`, for the price of the thing being listed. This is a free-form string. e.g. `€2,000/week` or `$22 per hour` or `$500` +- `"price"`, for the price of the thing being listed. This is an array in the format `[ "price", "", "", "" ]`. + - `"price"` is the name of the tag + - `""` is the amount in numeric format (but included in the tag as a string) + - `""` is the currency unit in 3-character ISO 4217 format. + - `""` is optional and can be used to describe recurring payments. + +#### `price` examples + +- $50 one-time payment `["price", "50", "USD", ""]` +- €15 per month `["price", "15", "EUR", "monthly"]` +- £50,000 per year `["price", "50000", "GBP", "yearly"]` Other standard tags that might be useful. @@ -51,9 +62,10 @@ Other standard tags that might be useful. ["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"], + ["price", "100", "USD"], [ "e", "b3e392b11f5d4f28321cedd09303a748acfd0487aea5a7450b3481c60b6e4f87", From 629c787d284c6bf27853f8b272888d86bd48d1dc Mon Sep 17 00:00:00 2001 From: Jeff Gardner <202880+erskingardner@users.noreply.github.com> Date: Mon, 17 Jul 2023 12:34:24 +0200 Subject: [PATCH 3/7] Update for feedback on format of price array --- 402.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/402.md b/402.md index 5e725c7b..e63e97ad 100644 --- a/402.md +++ b/402.md @@ -37,13 +37,13 @@ The following tags, used for structured metadata, are standardized and SHOULD be - `"price"` is the name of the tag - `""` is the amount in numeric format (but included in the tag as a string) - `""` is the currency unit in 3-character ISO 4217 format. - - `""` is optional and can be used to describe recurring payments. + - `""` is optional and can be used to describe recurring payments. SHOULD be in noun format (hour, day, week, month, year, etc.) #### `price` examples -- $50 one-time payment `["price", "50", "USD", ""]` -- €15 per month `["price", "15", "EUR", "monthly"]` -- £50,000 per year `["price", "50000", "GBP", "yearly"]` +- $50 one-time payment `["price", "50", "USD"]` +- €15 per month `["price", "15", "EUR", "month"]` +- £50,000 per year `["price", "50000", "GBP", "year"]` Other standard tags that might be useful. From 63718d6d89269819807b1e1c996d304f7aca64b0 Mon Sep 17 00:00:00 2001 From: Jeff Gardner <202880+erskingardner@users.noreply.github.com> Date: Tue, 18 Jul 2023 15:20:32 +0200 Subject: [PATCH 4/7] Update price detail --- 402.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/402.md b/402.md index e63e97ad..d5df9241 100644 --- a/402.md +++ b/402.md @@ -36,7 +36,7 @@ The following tags, used for structured metadata, are standardized and SHOULD be - `"price"`, for the price of the thing being listed. This is an array in the format `[ "price", "", "", "" ]`. - `"price"` is the name of the tag - `""` is the amount in numeric format (but included in the tag as a string) - - `""` is the currency unit in 3-character ISO 4217 format. + - `""` is the currency unit in 3-character ISO 4217 format or ISO 4217-like currency code (e.g. 'btc', 'eth'). - `""` is optional and can be used to describe recurring payments. SHOULD be in noun format (hour, day, week, month, year, etc.) #### `price` examples From b480624ac27e7083ed01c7f3d2157fddf7bd692a Mon Sep 17 00:00:00 2001 From: Jeff Gardner <202880+erskingardner@users.noreply.github.com> Date: Tue, 18 Jul 2023 15:22:56 +0200 Subject: [PATCH 5/7] Improve formatting --- 402.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/402.md b/402.md index d5df9241..c316670f 100644 --- a/402.md +++ b/402.md @@ -36,7 +36,7 @@ The following tags, used for structured metadata, are standardized and SHOULD be - `"price"`, for the price of the thing being listed. This is an array in the format `[ "price", "", "", "" ]`. - `"price"` is the name of the tag - `""` is the amount in numeric format (but included in the tag as a string) - - `""` is the currency unit in 3-character ISO 4217 format or ISO 4217-like currency code (e.g. 'btc', 'eth'). + - `""` is the currency unit in 3-character ISO 4217 format or ISO 4217-like currency code (e.g. `"btc"`, `"eth"`). - `""` is optional and can be used to describe recurring payments. SHOULD be in noun format (hour, day, week, month, year, etc.) #### `price` examples From 859bd471fe22ce18bcf208581040fbfa3b06dee4 Mon Sep 17 00:00:00 2001 From: Jeff Gardner <202880+erskingardner@users.noreply.github.com> Date: Tue, 18 Jul 2023 22:48:23 +0200 Subject: [PATCH 6/7] Update readme, change NIP number --- 402.md => 99.md | 2 +- README.md | 4 ++++ 2 files changed, 5 insertions(+), 1 deletion(-) rename 402.md => 99.md (99%) diff --git a/402.md b/99.md similarity index 99% rename from 402.md rename to 99.md index c316670f..e974a5e3 100644 --- a/402.md +++ b/99.md @@ -1,4 +1,4 @@ -# NIP-402 +# NIP-99 ## Classifieds diff --git a/README.md b/README.md index 6da74cd9..9ffff275 100644 --- a/README.md +++ b/README.md @@ -67,6 +67,7 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos - [NIP-89: Recommended Application Handlers](89.md) - [NIP-94: File Metadata](94.md) - [NIP-98: HTTP Auth](98.md) +- [NIP-99: Classified Listings](99.md) ## Event Kinds @@ -111,6 +112,7 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos | `30023` | Long-form Content | [23](23.md) | | `30078` | Application-specific Data | [78](78.md) | | `30311` | Live Event | [53](53.md) | +| `30402` | Classified Listing | [99](99.md) | | `31989` | Handler recommendation | [89](89.md) | | `31990` | Handler information | [89](89.md) | @@ -177,9 +179,11 @@ When experimenting with kinds, keep in mind the classification introduced by [NI | `expiration` | unix timestamp (string) | -- | [40](40.md) | | `image` | image URL | dimensions in pixels | [23](23.md), [58](58.md) | | `lnurl` | `bech32` encoded `lnurl` | -- | [57](57.md) | +| `location` | location string | -- | [99](99.md) | | `name` | badge name | -- | [58](58.md) | | `nonce` | random | -- | [13](13.md) | | `preimage` | hash of `bolt11` invoice | -- | [57](57.md) | +| `price` | price | currency, frequency | [99](99.md) | | `published_at` | unix timestamp (string) | -- | [23](23.md) | | `relay` | relay url | -- | [42](42.md) | | `relays` | relay list | -- | [57](57.md) | From 8efa0e76b471593396690941f234c570830449e4 Mon Sep 17 00:00:00 2001 From: Jeff Gardner <202880+erskingardner@users.noreply.github.com> Date: Tue, 18 Jul 2023 22:52:18 +0200 Subject: [PATCH 7/7] Update title --- 99.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/99.md b/99.md index e974a5e3..274e5afb 100644 --- a/99.md +++ b/99.md @@ -1,6 +1,6 @@ # NIP-99 -## Classifieds +## Classified Listings `draft` `optional` `author:erskingardner`