magick.market docs
In development

A GRIN-only marketplace on Nostr.

Buy as nobody, sell as yourself, and pay in Grin. Listings and orders live on the Nostr network, money moves straight to the seller's wallet, and there is no company in the middle.

magick.market is a fork of Plebeian Market, stripped to Grin only. It is in active development: the core marketplace and the Grin payment handoff work; some seller tooling is still being polished. Nothing here is a guarantee of a finished product yet.

What it is

magick.market is a decentralized marketplace. Every listing, order, and message is a signed Nostr event on public relays, so there is no central database and no operator who can freeze a shop or a buyer. Prices are set in Grin, and payment happens directly between buyer and seller with the Goblin wallet. Grin is confidential digital cash: amounts are hidden and there are no addresses on the chain.

Buying

  1. Browse listings on the marketplace. No account needed.
  2. Check out as a guest. You get a one-time private order key, so your purchase is not tied to a public identity. Your shipping details are sent to the seller sealed and encrypted.
  3. Pay in Grin. The order shows a Goblin payment code carrying the order's invoice number. Open it with the Goblin wallet, approve, and the Grin goes straight to the seller.
  4. Confirmation. The order is settled either by the seller's receipt or by your own Grin payment proof.

Selling

  1. Create a seller identity (a Nostr key) in the dashboard.
  2. List products priced in Grin. Listings are published as Nostr events (NIP-99), so they are portable across compatible clients.
  3. Get paid to your wallet. Buyers pay in Grin via their Goblin wallet to your profile; the invoice number ties the payment to the order.

Note: magick.market is Grin only. Lightning and Cashu payment paths from the upstream project are removed.

Self-hosting

magick.market is open source and self-hostable. It is a single Bun app that talks to Nostr relays; there is no database to run.

git clone https://git.us-ea.st/GRIN/magick.market
cd magick.market/market
bun install
cp .env.example .env      # set APP_RELAY_URL + APP_PRIVATE_KEY
bun run build:production
bun start

A Docker-first deployment lives under deploy-simple/ in the repo. See the repository README for the full guide.

Source