From f00848d232d7d7fed12d088514f1c8c251b9dec9 Mon Sep 17 00:00:00 2001 From: Vlad Stan Date: Mon, 8 May 2023 11:23:46 +0300 Subject: [PATCH 1/3] doc: nostrclient details --- README.md | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 6f87e96..90b26fe 100644 --- a/README.md +++ b/README.md @@ -1,17 +1,20 @@ -# Nostr Market - [LNbits](https://github.com/lnbits/lnbits) extension -For more about LNBits extension check [this tutorial](https://github.com/lnbits/lnbits/wiki/LNbits-Extensions) +# Nostr Market ([NIP-15](https://github.com/nostr-protocol/nips/blob/master/15.md)) - [LNbits](https://github.com/lnbits/lnbits) extension +For more about LNBits extension check [this tutorial](https://github.com/lnbits/lnbits/wiki/LNbits-Extensions). -Nostrmarket uses the [Nostrclient](https://github.com/lnbits/nostrclient), an extension that makes _nostrfying_ other extensions easy -**Demo at Nostrica https://www.youtube.com/live/2NueacYJovA?feature=share&t=6846** - -**This extension follows [NIP-15](https://github.com/nostr-protocol/nips/blob/master/15.md)** +**Demo at Nostrica here**. **Original protocol for [Diagon Alley](https://github.com/lnbits/Diagon-Alley) (resilient marketplaces)** > The concepts around resilience in Diagon Alley helped influence the creation of the NOSTR protocol, now we get to build Diagon Alley on NOSTR! -#### For further information about NOSTR, see https://github.com/nostr-protocol/nostr + +## Prerequisites +This extension uses the LNbits [nostrclient](https://github.com/lnbits/nostrclient) extension, an extension that makes _nostrfying_ other extensions easy. +![image](https://user-images.githubusercontent.com/2951406/236773044-81d3f30b-1ce7-4c5d-bdaf-b4a80ddddc58.png) +Before you continue, please make sure that [nostrclient](https://github.com/lnbits/nostrclient) extension is installed, activated and correctly configured. +[Nostrclient](https://github.com/lnbits/nostrclient) is usually installed as admin-only extension, so if you do not have admin access please ask an admin to confirm that [nostrclient](https://github.com/lnbits/nostrclient) is OK. + ## Create, or import, a merchant account From e4b7a58341b97e315d33cdfa8aaa54d8bb012f14 Mon Sep 17 00:00:00 2001 From: Vlad Stan Date: Mon, 8 May 2023 11:46:41 +0300 Subject: [PATCH 2/3] doc: add Troubleshoot --- README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/README.md b/README.md index 90b26fe..09ce13d 100644 --- a/README.md +++ b/README.md @@ -92,6 +92,20 @@ LNbits also provides a Nostr Market client app. You can visit the client from th or by visiting `https:///nostrmarket/market` +## Troubleshoot +### Check communication with Nostr +In order to test that the integration with Nostr is working fine, one can add an `npub` to the chat box and check that DMs are working as expected: + +https://user-images.githubusercontent.com/2951406/236777983-259f81d8-136f-48b3-bb73-80749819b5f9.mov + +### Restart connection to Nostr +If the communication with Nostr is not working then an admin user can `Restart` the Nostr connection. + +Merchants can afterwards re-publish their products. + +https://user-images.githubusercontent.com/2951406/236778651-7ada9f6d-07a1-491c-ac9c-55530326c32a.mp4 + + ## Aditional info Stall and product are _Parameterized Replaceable Events_ according to [NIP-33](https://github.com/nostr-protocol/nips/blob/master/33.md) and use kind `30017` and `30018` respectivelly. See [NIP-45](https://github.com/nostr-protocol/nips/blob/master/45.md) for more details. From 203a5e7f24073b8b8a48e79bcdc67e4b83bcb2aa Mon Sep 17 00:00:00 2001 From: Vlad Stan Date: Mon, 8 May 2023 12:03:53 +0300 Subject: [PATCH 3/3] doc: link to `nostrclient` troubleshooting --- README.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 09ce13d..ccc6722 100644 --- a/README.md +++ b/README.md @@ -12,8 +12,9 @@ ## Prerequisites This extension uses the LNbits [nostrclient](https://github.com/lnbits/nostrclient) extension, an extension that makes _nostrfying_ other extensions easy. ![image](https://user-images.githubusercontent.com/2951406/236773044-81d3f30b-1ce7-4c5d-bdaf-b4a80ddddc58.png) -Before you continue, please make sure that [nostrclient](https://github.com/lnbits/nostrclient) extension is installed, activated and correctly configured. -[Nostrclient](https://github.com/lnbits/nostrclient) is usually installed as admin-only extension, so if you do not have admin access please ask an admin to confirm that [nostrclient](https://github.com/lnbits/nostrclient) is OK. +- before you continue, please make sure that [nostrclient](https://github.com/lnbits/nostrclient) extension is installed, activated and correctly configured. +- [nostrclient](https://github.com/lnbits/nostrclient) is usually installed as admin-only extension, so if you do not have admin access please ask an admin to confirm that [nostrclient](https://github.com/lnbits/nostrclient) is OK. +- see the [Troubleshoot](https://github.com/lnbits/nostrclient#troubleshoot) section for more details on how to check the health of `nostrclient` extension ## Create, or import, a merchant account @@ -105,6 +106,9 @@ Merchants can afterwards re-publish their products. https://user-images.githubusercontent.com/2951406/236778651-7ada9f6d-07a1-491c-ac9c-55530326c32a.mp4 +### Check Nostrclient extension +- see the [Troubleshoot](https://github.com/lnbits/nostrclient#troubleshoot) section for more details on how to check the health of `nostrclient` extension + ## Aditional info