No description
Find a file
Tiago Vasconcelos bd49e1b6a4 Update README.md
2023-04-26 10:45:41 +01:00
nostr fix: remove closed websocket 2023-04-11 19:16:05 +03:00
static Fix small typo in customer-stall 2023-04-13 21:25:55 +02:00
templates/nostrmarket feat: add reconnect to nostrclient 2023-04-11 19:03:41 +03:00
.gitignore add .gitignore 2023-02-27 17:47:43 +00:00
__init__.py feat: add reconnect to nostrclient 2023-04-11 19:03:41 +03:00
config.json feat: add icon 2023-03-17 17:45:01 +02:00
crud.py feat: add more images for product 2023-04-03 18:36:14 +03:00
helpers.py fix: shipping cost; update UI on new order 2023-04-03 11:57:55 +03:00
LICENSE add license 2023-03-08 17:24:52 +01:00
manifest.json chore: code format 2023-03-15 22:25:15 +02:00
migrations.py feat: add more images for product 2023-04-03 18:36:14 +03:00
models.py fix: do not erase merchant profile 2023-04-19 10:27:47 +03:00
README.md Update README.md 2023-04-26 10:45:41 +01:00
services.py fix: do not erase merchant profile 2023-04-19 10:27:47 +03:00
tasks.py feat: keep customer profiles up to date 2023-03-30 13:58:14 +03:00
views.py fixing vlad's review comments 2023-03-09 10:02:16 +00:00
views_api.py feat: add reconnect to nostrclient 2023-04-11 19:03:41 +03:00

Nostr Market - LNbits extension

For more about LNBits extension check this tutorial

Nostrmarket uses the 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

Original protocol for 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

Create, or import, a merchant account

As a merchant you need to provide a Nostr key pair, or the extension can generate one for you. create keys

Once you have a merchant "account", you can view the details on the merchant dropdown merchant dropdown

Create a Stall, or shop

To create a stall, you first need to set a Shipping zone. Click on the Zones button and fill in the fields: zone dialog

  • Give your shipping zone a name
  • Select to which countries does this Shipping zone applies to (you can set a "Free" zone for digital goods)
  • Select the unit of account. If your will list products in EUR, the shipping zone must be in the same currency
  • Select the cost to ship

Let's create the stall Click on New Stall button and fill the necessary fields Create stall Stall dialog

  • Give your stall/shop a name
  • An optional description (this can be used by client to search shops)
  • Select which wallet to use for this shop
  • Select the unit
  • select a Shipping Zone (multiple zones can be selected)

Click on the "Plus" button to open the stall details and click "New Product" to create a product create product

Fill the necessary fields on the dialog product dialog

  • The product name
  • Give it a description
  • Add some categories (this can be used by clients to search for products)
  • Supply an URL for your product image (you can upload an image but it's recommended that the images are hosted outside of LNbits)
  • A price for the product, in the currency selected for the shop (this will be converted to sats when a customer buys)
  • The quantity you have in stock, for the product. This will update when orders are made/paid

On the Stall section you can also see (update or delete) the stall details in Stall Info tab stall details

Create, update or delete products in Products tab products tab

And check your orders on the Orders tab orders tab

When you get an order, you can see the details by clicking on the "Plus" sign for the order order details

  • Ordered products
  • The order ID
  • Customer's shipping address
  • Customer's public key
  • Invoice ID

If applicable, you can set as shipped when shipping is processed.

You also have a Chat Box to chat with customer chat box

Diagon Alley Clients

LNbits also provides a Nostr Market client app. You can visit the client from the merchant dashboard by clicking on the "Market client" link market client link

or by visiting https://<LNbits instance URL>/nostrmarket/market

Aditional info

Stall and product are Parameterized Replaceable Events according to NIP-33 and use kind 30017 and 30018 respectivelly. See NIP-45 for more details.

Order placing, invoicing, payment details and order statuses are handled over Nostr using NIP-04.

Customer support is handled over whatever communication method was specified. If communicationg via nostr, NIP-04 is used.