Marketplace Guide

The zKPnote Marketplace lets you sell, buy, and auction notes peer-to-peer using SOL. Every transaction is executed on-chain via smart contract — no middlemen, no platform commissions beyond a flat 2% fee.

Listing a Note for Sale

  1. Open the note you want to sell in the editor
  2. Click the Sell button in the toolbar
  3. Choose your listing type:
    • Copies — Sell unlimited copies. You keep the original.
    • Original — One-time sale. The note transfers to the buyer and is removed from your vault.
    • Auction — Timed bidding. The highest bidder wins.
  4. Set a price (in SOL)
  5. Choose a category (Tutorial, Research, Template, Guide, Course, Recipe, Cheatsheet, General)
  6. Select a preview mode (see below)
  7. Submit your listing

Preview Modes

When listing, you control how much buyers can see before purchasing:

ModeWhat Buyers See
MaskedRedacted structure — headings, lists, and paragraph shapes are visible, but all text is replaced with blocks. Shows the note's structure without revealing content.
PartialFirst N characters of the note. You control how much via a slider (50–2000 chars).
FullThe entire note is visible before purchase.

Buying a Note

  1. Browse the marketplace or use the search bar and category filters
  2. Click on a listing to see the preview and details
  3. Click Buy Now
  4. Confirm the transaction — the smart contract splits the payment: 98% to the seller, 2% to the zKPnote treasury
  5. The note appears in your vault immediately after purchase

Purchased notes are tagged with their source listing. You cannot resell purchased notes.

Auctions

Creating an Auction

  1. Select Auction as the listing type
  2. Set a starting bid and optional reserve price
  3. Choose a duration: 1 hour to 7 days
  4. Submit — a live countdown appears on the listing

Bidding

  • Enter a bid amount (must exceed the current highest bid by at least 0.001 SOL)
  • Bidding is off-chain — no SOL is locked during bidding
  • You can see the full bid history on the listing

Settlement

  • When the auction ends, the winner sees a Pay & Claim Note button
  • Clicking it executes the execute_sale smart contract instruction
  • If the reserve price is not met, the auction ends with no sale

Content Protection

Similarity Detection

When you create a listing, zKPnote runs two layers of similarity checking using word-trigram Jaccard similarity:

  1. Marketplace check (70% threshold): Your content is compared against all existing marketplace listings from other sellers. If your content is 70%+ similar to another seller's listing, the listing is rejected.
  2. Proof check (90% threshold): Your content is compared against all on-chain proved content from other authors. If your content is 90%+ similar to another author's proved work, the listing is rejected — even if that content was never listed for sale.

You can always list your own content (your wallet address is excluded from both comparisons).

Purchase Tagging

Notes you buy from the marketplace are tagged with purchasedFrom. The Sell button is disabled for tagged notes, and the API also rejects listing attempts for purchased content.

Analytics

Visit the Analytics page (accessible from the marketplace nav) to see:

  • Total sales volume
  • Transaction history
  • Revenue statistics
  • Number of unique buyers and sellers
  • Active listing count

Fees

FeeAmountHow
Marketplace fee2% of sale priceDeducted automatically by the smart contract
Transaction fee~0.00001 SOLStandard Solana network fee

The seller receives 98% of the sale price directly to their wallet. The 2% fee goes to the zKPnote treasury. There are no monthly subscriptions, no payment processor fees, and no minimum payout thresholds.