# Price Discussion Documentation

> Price Discussion (PD) is a filtered generative art platform on Ethereum where
> the community discussing prices is the product. This documentation covers the
> PriceOS app surface, the smart contracts, and the $PRICE token. Every page
> here is also available as raw markdown by appending .md to its URL.

## Start Here

- [Price Discussion Documentation](https://docs.pricediscussion.com/docs): Reference and onboarding for Price Discussion — the generative art platform where the community discussing prices is the product. The app, the smart contracts, and the $PRICE token.
- [Quickstart](https://docs.pricediscussion.com/docs/quickstart): Five paths into Price Discussion: artists submitting work, collectors connecting a wallet, developers reading the contracts, agents fetching markdown, and the curious.
- [Your First Hour](https://docs.pricediscussion.com/docs/first-hour): The checklist that turns a fresh wallet into a set-up PD life: connect, claim your @name, install the app, switch on pings, and make your first moves — with an artist edition below.
- [What's New](https://docs.pricediscussion.com/docs/whats-new): The platform's recent additions, newest first — a running highlights reel of what shipped, each line linking into its own manual page.

## Public & Private

- [What's Public on PD](https://docs.pricediscussion.com/docs/whats-public): Everything on PD anyone can see, feature by feature: the on-chain record, your profile and its surfaces, market activity, the social graph, presence, the war record, and the leaderboards.
- [What's Private on PD](https://docs.pricediscussion.com/docs/whats-private): What stays yours alone on PD: notes, stars, wishlists, working state, settings, sealed price calls, drafts — and the fact that a wallet is the entire account.

## For Artists

- [For Artists — How PD Works](https://docs.pricediscussion.com/docs/for-artists/how-pd-works): The platform from the artist's side: the thesis, what deploying on PD actually means, the economics in plain terms, and what makes PD different.
- [For Artists — Get in Touch](https://docs.pricediscussion.com/docs/for-artists/get-in-touch): How an artist who is curious about Price Discussion actually reaches the platform: every artist relation runs through DMs on X, what to send in that first message, and what happens after it.
- [For Artists — Submit a Project](https://docs.pricediscussion.com/docs/for-artists/submit-a-project): How to submit work to Price Discussion: what to include in the brief, how decisions are made, and what happens between acceptance and deployment.
- [For Artists — Writing for the Chain](https://docs.pricediscussion.com/docs/for-artists/writing-for-the-chain): Everything your script needs to know before it goes on Ethereum: what it receives, the library you can build on (its exact version), how every Output gets its seed, what collectors see in the minutes after a mint, and a checklist before you deploy.
- [For Artists — The Mint Flow](https://docs.pricediscussion.com/docs/for-artists/the-mint-flow): What happens on-chain when a Project deploys and mints: the createProject call, the 1.5 MB script space and staged uploads, per-token hashes, and the payouts inside every mint.
- [For Artists — What are Subtraits?](https://docs.pricediscussion.com/docs/for-artists/what-are-subtraits): Subtraits explained: PD's middle layer between a trait and its values — named buckets that group a trait's value pool, live in the schema, and can be reshaped without touching the chain.
- [For Artists — Royalties](https://docs.pricediscussion.com/docs/for-artists/royalties): The artist economics on Price Discussion: 95% of primary paid at mint time, 5% EIP-2981 secondary royalty split 3% artist / 2% platform, and permissionless withdrawals.

## PD Studio

- [PD Studio — Overview](https://docs.pricediscussion.com/docs/studio/overview): The artist's side of Price Discussion: one mobile-first app to upload work, test it exhaustively, publish it on-chain, and then manage and measure it — PD Studio at studio.pricediscussion.com.
- [PD Studio — Upload & Testing](https://docs.pricediscussion.com/docs/studio/upload-and-testing): How work comes into PD Studio and how it gets proven: private drafts, unlimited test runs on simulated token hashes, the real rendering envelope, and what a test pass should convince you of.
- [PD Studio — Publishing](https://docs.pricediscussion.com/docs/studio/publishing): The road from a tested draft to a live Project: the filter, the Studio's preflight checks, and the deploy you sign from your own wallet — on your phone.
- [PD Studio — The Artist Dashboard](https://docs.pricediscussion.com/docs/studio/the-artist-dashboard): The management side of PD Studio: every Project you've deployed with its mints, holders, market activity, and royalties live in one place — plus the off-chain surround that stays yours to update.

## For Collectors

- [For Collectors — How PD Works](https://docs.pricediscussion.com/docs/for-collectors/how-pd-works): The platform from the collector's side: what you're collecting, how minting and trading work, what's free, and why the discussion of prices is the point.
- [For Collectors — Wallet Setup](https://docs.pricediscussion.com/docs/for-collectors/wallet-setup): Getting onto Price Discussion: wallet compatibility, Sign-In With Ethereum, claiming an @name, and what signing in does and doesn't cost.
- [For Collectors — The Secondary Market](https://docs.pricediscussion.com/docs/for-collectors/the-secondary-market): How PD Outputs trade after mint: PD's own market and offer book, Takeovers, third-party venues, the 5% EIP-2981 royalty, and how to verify authenticity before buying.

## Discord

- [Discord — Overview](https://docs.pricediscussion.com/docs/discord/overview): The PD Discord is where the discussion actually happens. What lives there, how to get in, and how it connects back to the platform.
- [Discord — The Channels](https://docs.pricediscussion.com/docs/discord/the-channels): A map of the PD Discord: what each category is for and which channel you want for what.
- [Discord — The Feeds](https://docs.pricediscussion.com/docs/discord/the-feeds): Every PD sale and every PD listing, posted to Discord within a minute. What each post contains, how people are named, and how the value channels split the flow.
- [Discord — Artist Channels](https://docs.pricediscussion.com/docs/discord/artist-channels): The Artists category: the artist-only public chat, and the fan channel every artist gets when they release their first project.

## $PRICE Token

- [$PRICE Token — Overview](https://docs.pricediscussion.com/docs/price-token/overview): $PRICE is official Price Discussion merch on Ethereum: 100,000,000 fixed supply, given to the communities PD comes from. Hold it, send it, rank on the holders board — no rights, no revenue, no perks.
- [$PRICE Tokenomics](https://docs.pricediscussion.com/docs/price-token/tokenomics): The full $PRICE distribution: 100,000,000 fixed supply allocated 75% fxhash community, 10% founder, 10% WTBS, 5% newpdogs — given away in full at launch, nothing to claim.
- [$PRICE — Official Merch](https://docs.pricediscussion.com/docs/price-token/no-platform-utility): What $PRICE is for: it's official Price Discussion merch. You can hold it, send it to other PDers and rank on the holders board. It gives no rights, no revenue and no perks.
- [$PRICE Contract](https://docs.pricediscussion.com/docs/price-token/contract): The deployed $PRICE ERC-20 on Ethereum mainnet: address, functions, deliberate absences, compiler settings, and verification against the published source.

## Smart Contracts

- [Smart Contracts — Overview](https://docs.pricediscussion.com/docs/contracts/overview): The PD protocol layer: one factory, one immutable ERC-721 per Project, per-Project royalty splitters, the on-chain library registry, the ERC-1155 sticker shop, and the keychain capsule machine. Architecture and guarantees.
- [Contracts — PDFactory](https://docs.pricediscussion.com/docs/contracts/pd-factory): The single deployed factory behind every PD Project: createProject, staged uploads for big scripts, the artist whitelist, the 60-day cooldown, supply bounds, platform wallets, and the storage-fee corridor.
- [Contracts — PDProject](https://docs.pricediscussion.com/docs/contracts/pd-project): The per-Project ERC-721: fully on-chain generative art via SSTORE2 and data-URI tokenURI, payouts inside every mint that no wallet can block, per-token hashes, marketplace attributes, the entry window, and EIP-2981.
- [Contracts — PaymentSplitter](https://docs.pricediscussion.com/docs/contracts/payment-splitter): The per-Project secondary royalty splitter: receives the 5% EIP-2981 royalty, splits it 60/40 (3% artist / 2% platform), with permissionless ETH and ERC-20 withdrawals.
- [Contracts — PDStickers](https://docs.pricediscussion.com/docs/contracts/pd-stickers): The sticker shop on-chain: ERC-1155 with fully on-chain SVG art, the sealed-sheet token model, FIXED and PACK peel modes, in-transaction payout splits, and StickerSplitter royalty vaults.
- [Contracts — PDKeychains](https://docs.pricediscussion.com/docs/contracts/pd-keychains): The capsule machine's ERC-721: one-of-one living charms drawn entirely on-chain, luck-tilted rarity rolls, the polish attestation, the keeper bond, and the christened name.
- [Contracts — PDLibraryRegistry](https://docs.pricediscussion.com/docs/contracts/library-registry): The append-only on-chain store for blessed JavaScript libraries (at launch, p5.js and the gzip inflater) that PD Projects bind and render from — frozen forever once finalized.

## Fair Draw

- [Fair Draw — Overview](https://docs.pricediscussion.com/docs/fair-draw/overview): When more collectors want a drop than there are Outputs, PD settles it with a human-speed race and a provably fair draw — no gas wars, no auctions, no allowlists, one tap.
- [Fair Draw — How a Drop Settles](https://docs.pricediscussion.com/docs/fair-draw/how-a-drop-settles): The entry window, entry receipts, the CONTESTED flip, the lock and the draw, seats on a fixed beat, the seal, the public record, and the fail-open guarantee — the full life of an oversubscribed drop.
- [Fair Draw — Fair Play](https://docs.pricediscussion.com/docs/fair-draw/fair-play): Who has priority when a drop is contested — the public ladder of collecting on PD — and what happens to bots, wallet armies, and their infrastructure.

## The App

- [The App — Overview](https://docs.pricediscussion.com/docs/app/overview): A map of PriceOS: the shell, Projects and minting, Outputs, identity, the collector toolset, the Spell Book, Pings, achievements, discovery, and display settings.
- [The App — The Shell](https://docs.pricediscussion.com/docs/app/the-shell): PriceOS's persistent layer: the Tape ticker, the navbar, the footer's live readouts and easter eggs, the installable PWA, and the colorway system.
- [The App — Projects & Minting](https://docs.pricediscussion.com/docs/app/projects-and-minting): The Project page: minting from the UI, live presence, traits and the Genome, grid sorts and grouping, project milestones, symbols, and per-Project color.
- [The App — Outputs](https://docs.pricediscussion.com/docs/app/outputs): The individual artwork surface: live on-chain rendering, fullscreen, attributes and rarity receipts, the action row, the ASCII backup, and Output-level follows.
- [The App — Identity & Profiles](https://docs.pricediscussion.com/docs/app/identity-and-profiles): The identity layer: @names, PriceSprites, profile pages and their owner's color, Showcase modes, and the Collected / Starred / Wishlist / Albums system.
- [The App — Collector Tools](https://docs.pricediscussion.com/docs/app/collector-tools): The OS-tools layer of PriceOS: To-Dos with ETH targets, private Notes, the Cart, the drag-only Bench, the Calc, the Calendar, Workflows, and the Portfolio.
- [The App — The Spell Book](https://docs.pricediscussion.com/docs/app/spell-book): Every spell documented: how to open the Spell Book (triple-tap MY PD), how spells stack, and what each of the 23 pills actually does — from Celestial Tracker to Tribunal to the ???? button.
- [The App — Achievements](https://docs.pricediscussion.com/docs/app/achievements): The unlock system: thirteen categories from minting to myth, how unlocks surface, and how achievements feed PriceRank.
- [The App — Discovery](https://docs.pricediscussion.com/docs/app/discovery): Finding work on PriceOS: the home page and its carousels, the live feed and milestones, global search, artist surfaces, and PriceRank.
- [The App — Settings & Display](https://docs.pricediscussion.com/docs/app/settings-and-display): MY PD in full: the colorway picker and Haze, every display-mode pill on both rows, Setup Codes, the Default Sort row, Workspaces and Spaces, and the door to the Spell Book.

## The Marketplace

- [The Marketplace](https://docs.pricediscussion.com/docs/marketplace): PD's own market floor: every live listing by project, the market tape, and the two Pals — Purchase Pal builds your buying path, Profit Pal reads your exits.

## PriceScore

- [PriceScore](https://docs.pricediscussion.com/docs/pricescore): The one number that says how real your PD life is: the sum of every achievement you've unlocked, and the ten PriceRank tiers it climbs through.

## Feature Atlas

- [The Feature Atlas](https://docs.pricediscussion.com/docs/features): The canonical numbered catalog of every named PriceOS feature, sortable and filterable by section. Markdown form at https://docs.pricediscussion.com/docs/features.md.

## Albums

- [Albums ◰](https://docs.pricediscussion.com/docs/albums): Albums are numbered, public shelves of Outputs you curate — living mosaic covers, a full-screen show, and a maker's name on every one. Anyone can see an album and who built it.

## Verified Alts

- [Verified Alts ¤](https://docs.pricediscussion.com/docs/verified-alts): Link your other wallets to your PD account with one free signature from each. Anyone can see an account's Verified Alts on its profile.

## Cartography

- [Cartography ◫](https://docs.pricediscussion.com/docs/cartography): The living map of the whole platform: Projects as territories, collectors as inhabitants, sales as movement — real-time, zoomable, opened by long-pressing the Price Discussion name.

## Colorpedia

- [Colorpedia](https://docs.pricediscussion.com/docs/colorpedia): The book about one color: exact hex, RGB, HSL, HSV, CMYK, LAB and LCH, the color's name and history, its harmonies, and a search that reads names, hex and numbers alike.

## Command Stone

- [The Command Stone ⌘](https://docs.pricediscussion.com/docs/command-stone): PD's command line: triple-tap the background of any page to summon it, then find anything, ask the ledger a question, do math, convert money, resolve a date, rank the whole platform, etch a to-do or note, cast a spell by name, or summon a widget.
- [Command Stone — Abilities](https://docs.pricediscussion.com/docs/command-stone/abilities): The complete command reference for the Command Stone: search, ledger questions, math, currency, dates, rankings, holdings slices, compound sentences, sentinel sentences, bulk acts, prophecy, the news, cozy mood, the fun bench, etching and casting.

## Composer

- [Composer ⊚](https://docs.pricediscussion.com/docs/composer): PD's visual query builder: compose a question about the whole catalog from tappable rules, watch it answer live, save it as a Program, and act on the result in bulk.

## Dispatch

- [Dispatch ❡](https://docs.pricediscussion.com/docs/dispatch): PD's morning paper: printed once every day at 9AM, covering the prior day from the real ledger. Permanent, citable URLs — an edition reads the same forever.

## Exchange

- [Exchange ⇌](https://docs.pricediscussion.com/docs/exchange): PD's trading floor, built on the Grand Exchange: trade Outputs, sealed sticker sheets and keychains, direct to one collector or open to anyone on the board. Eight slots, a live board, a record of every trade. No fee, ever.

## Factions

- [Factions ⚐](https://docs.pricediscussion.com/docs/factions): The color war: your Sigil is who you are, your color is who you fight for, and every artwork remembers both. Allegiance, the Marginalia, sieges, conquests, and the Book of Conquests — the full rules of PD's quiet war.

## Fingerprint

- [Fingerprint ⌾](https://docs.pricediscussion.com/docs/fingerprint): PD's objective read of every artwork: what the Output literally looks like, measured from its actually rendered pixels — color, light, composition, countable shapes, and the four taste axes.

## Platform Gen Art

- [Platform Gen Art](https://docs.pricediscussion.com/docs/platform-gen-art): PD's own live character art: Tabstract in your browser tab, and Formula — your own generative art, worn as a profile tag.

## The Gnomes

- [The Gnomes — Overview](https://docs.pricediscussion.com/docs/gnomes/overview): PD's real-fake NFT collection: one guardian gnome per project, free to awaken, alive in its tab, owned and traded entirely inside Price Discussion.
- [The Gnomes — The Awakening](https://docs.pricediscussion.com/docs/gnomes/the-awakening): How a gnome becomes yours: the shut hill, the hidden waking threshold, striking the hour with a mint, and the respect ladder.
- [The Gnomes — the mushroom market](https://docs.pricediscussion.com/docs/gnomes/the-mushroom-market): The gnome market hall: hanging a FOR SALE sign, striking the deal, the no-fee schedule (gnome ore fees), and why gnomes trade only on Price Discussion.
- [The Gnomes — the gnomewallet](https://docs.pricediscussion.com/docs/gnomes/the-gnomewallet): Your side of the gnome world: the burrow, the gnomenclature (6n0m3… addresses and .gnome names), and the lowercase world behind the settings pill.

## Keychains

- [Keychains — Overview](https://docs.pricediscussion.com/docs/keychains/overview): Charms from Le Depanneur's capsule machine: one-of-one generative characters drawn entirely onchain, with rare finishes and chains your PriceStreak buys better odds on. The full cast, every trait, every odds table.
- [Keychains — Le Depanneur](https://docs.pricediscussion.com/docs/keychains/the-depanneur): The keychain shop: crank the capsule machine, get a random one-of-one charm. The exact mechanics, the provably fair roll, the money math, and what you actually own.
- [Keychains — The Living Charm](https://docs.pricediscussion.com/docs/keychains/the-living-charm): Luck, the three rarity rolls, polish, the keeper bond, christening, and wearing your charm — the complete rulebook for a Keychain's life.

## Lists

- [Lists ≡](https://docs.pricediscussion.com/docs/lists): Lists are your own named groupings of anything you've starred: artworks, projects, traits, artists, collectors, soundtracks, transactions. Private, portable, and priced.

## Pings

- [Pings — Overview](https://docs.pricediscussion.com/docs/pings/overview): PD's notification system in full: what earns a ping, the inbox and its read-by-scroll model, every glyph, and how pings reach your screen, your toasts, and your phone.
- [Pings — Controls](https://docs.pricediscussion.com/docs/pings/controls): Every switch you own: the MY PINGS toggle bank explained pill by pill, the four Pingtoasts modes, enabling lock-screen push on iPhone step by step, and Silent Mode.
- [Pings — Artist Push](https://docs.pricediscussion.com/docs/pings/artist-push): The artists' channel: one ping per month, per project, to every holder — preset messages, delivered to inboxes and lock screens, rate-limited by the platform.

## PriceOS Suite

- [PriceOS Suite](https://docs.pricediscussion.com/docs/suite): PD's productivity super-app: Today, PriceCal, PriceTask, PriceFlows, PriceBooks, PriceCalc, PriceCall, PriceWrite, and PriceCalm in one place — your calendar, to-dos, workflows, and notes, expanded.
- [To-Dos & Workflows ❍☇](https://docs.pricediscussion.com/docs/todos-and-workflows): The collector's task list, with ETH targets the platform watches for you — and Workflows, the built automations that arm a trigger once and fire when the market moves.

## PriceStream

- [PriceStream ⇈](https://docs.pricediscussion.com/docs/pricestream): The full-screen swipe feed: one Output of the catalog per swipe, with the star, the soundtrack, the share link, the zoom and the cart all on the card. It never ends.

## Rarity Labs

- [Rarity Labs](https://docs.pricediscussion.com/docs/rarity-labs): PD's provable rarity system: the seed-deterministic census, the PD Rarity headline with edition rank, POP counts, NONE HIGHER, and the project-wide Pop Table.

## Rewind

- [Rewind ◄](https://docs.pricediscussion.com/docs/rewind): The whole-OS time scrubber: triple-tap the Price Discussion name and browse PD exactly as it stood on any past PriceDay — read-only, day by day, with the way back always one tap away.

## Stickers

- [Stickers — Overview](https://docs.pricediscussion.com/docs/stickers/overview): PD's second economy: collectible on-chain SVG stickers sold in sealed sheets. The Sticker Exchange, the sealed-and-peel model, what stickers are for, and what they cost.
- [Stickers — The Store](https://docs.pricediscussion.com/docs/stickers/the-store): The primary sticker market: the seventeen launch sheets and what's inside each, buying with one confirm, print runs and restocks, and the peel — the drag that opens a sealed sheet.
- [Stickers — The Marketplace](https://docs.pricediscussion.com/docs/stickers/the-marketplace): The sticker secondary market: per-sheet order books with partial fills, listings and offers, gifting with a note, the want-list, the 5% fee split — and swaps, which trade on the Exchange board.
- [Stickers — The Binder & Your Profile](https://docs.pricediscussion.com/docs/stickers/the-binder-and-your-profile): Completing the collection and wearing it: the Binder's got/need pages, the profile sticker hero, the Sticker Manager's layout controls, hand-placed compositions, and Sticker Setup Codes.
- [Stickers — The Sticker Channel](https://docs.pricediscussion.com/docs/stickers/the-sticker-channel): The LCD panel above the shelf: a 22-second episode every day, 365 a year, plus the ad breaks. What it is, why it changes daily, and why missing one costs you a year.

## Takeover

- [Takeover ⚑](https://docs.pricediscussion.com/docs/takeover): Wall Street's most dramatic move, translated to collecting: one blanket premium offer on another collector's entire position in a project. 72 hours, public, non-cancellable.

## Build on PD

- [Building on PD](https://docs.pricediscussion.com/docs/building-on-pd): PD wants community-built tools: what you can build on today (the fully open chain surface), what's coming to the API reference, and the conventions that make agents and tools first-class citizens.
- [PDMCP — the PD MCP Server](https://docs.pricediscussion.com/docs/mcp): Connect any AI agent to Price Discussion: the PDMCP server's endpoint, every tool with its exact arguments and answer shapes, how to render PD artwork inline in a chat, trait × market analytics, and the guarantees behind the data.

## Reference

- [When Something Looks Wrong](https://docs.pricediscussion.com/docs/troubleshooting): The predictable panics and their calm answers: wallet refusals, sealed Outputs, missing pushes, vanished listings, quiet achievements, empty rails, and the other moments PD is working exactly as designed.
- [Glossary](https://docs.pricediscussion.com/docs/reference/glossary): Plain-English definitions for Price Discussion's vocabulary: Project, Output, Artwork, Token, @name, the sticker economy, the war, and the platform's locked nomenclature.
- [Privacy & Terms](https://docs.pricediscussion.com/docs/privacy-and-terms): PD's privacy policy and terms of use in plain language: a wallet is the entire account, what the platform stores and why, what's on-chain forever, and the terms you accept by using it.

## Optional

- [Full documentation as one file](https://docs.pricediscussion.com/llms-full.txt): every page of this site concatenated as plain markdown.