Pubky Market
Pubky Market adds shops and product listings to Pubky, with buyers paying sellers directly. Sellers publish a catalog under their Pubky identity, and buyers discover products and follow their orders. Pubky Market supports physical and digital goods, with sale formats such as fixed-price listings, auctions, and timed releases called drops.
How Pubky Market uses Pubky
Section titled “How Pubky Market uses Pubky”A seller’s shop and listings are public records on their Homeserver. Reviews and related public commerce records use shared formats so compatible clients and indexers can read them. Pubky Market’s catalog is therefore more than data held inside one shop interface.
A dedicated marketplace Nexus indexes those records for browsing and search. Its catalog views are derived data; the seller’s Homeserver records remain the source of their published catalog.
Publishing a listing and completing a sale are separate actions. A transaction service coordinates shared decisions such as reserving stock, accepting an offer, closing an auction, and advancing an order. A cached listing or a Homeserver write cannot establish that a buyer reserved the last item or paid for it. The transaction-authority explanation describes this division of responsibilities.
From listing to order
Section titled “From listing to order”- A seller publishes a shop and listing, with prices, inventory, delivery options, and sale terms.
- A buyer finds the listing and starts checkout. The transaction service coordinates the reservation and records the order’s agreed terms.
- The buyer pays the seller through an available payment method. The service reconciles the payment result before advancing the order.
- The seller fulfills the order, or the buyer receives the purchased digital delivery. Order history and signed receipts help the participants retain evidence of the transaction.
Paykit coordinates payment discovery and requests, while Pubky Locks controls access to purchased content, such as paid articles and downloadable files. Pubky Market integrates these building blocks with its order workflow. They do not replace the transaction service’s inventory and order decisions.
Payments and trust
Section titled “Payments and trust”Payments go to the seller; Pubky Market does not custody funds or send refunds from a platform balance. Buyers and sellers still rely on the chosen payment method, the seller’s fulfillment, and the transaction service’s order decisions.
Explore or build
Section titled “Explore or build”- Try Pubky Market: Open Pubky Market to browse shops and listings.
- Contribute to the Pubky Market web app: Follow the developer guide to set up Pubky Market locally and contribute features or bug fixes.
- Build compatible records: Use Pubky Market Specs for the data model and Rust and JavaScript libraries.
- Automate shop operations: Use the seller automation API to synchronize inventory, export orders, receive order notifications, and update shipping or tracking information.