Updated 2026-09-24·View as Markdown

Price Discussion Documentation

Price Discussion is a generative art platform on Ethereum — filtered, not curated — where the community discussing prices is the product. Artists deploy fully on-chain generative Projects through a factory contract; collectors mint Outputs at primary and trade on the secondary market; and the platform — PriceOS — treats the resulting price movement as a form of aesthetic discourse.

This documentation covers the three layers of the platform: the app (PriceOS, the software collectors and artists actually use), the smart contracts (the on-chain protocol every Project runs on), and the $PRICE token.

PriceOS is optimized for iPhone (iPhone 12 and up) — and in particular for the installed PWA: add Price Discussion to your Home Screen from Safari's share sheet and it runs full-screen as its own app, which is the platform as it is meant to be experienced. Desktop and other browsers work; the iPhone PWA is the reference.

Choose a starting point

Artists — read How PD Works for Artists, then Submit a Project. Your workspace — uploading, testing, publishing, and managing your Projects — is PD Studio.

Collectors — read How PD Works for Collectors, then Wallet Setup.

Developers — start with the Contract Architecture, then the per-contract references: PDFactory, PDProject, PaymentSplitter.

AI agents — a machine-readable index of every page on this site lives at /llms.txt, the whole site is one fetch at /llms-full.txt, and every page is available as raw markdown by appending .md to its URL.

What Price Discussion is

A filter on Ethereum's existing primitives — a quality floor, not a taste-making gate. Each Project on PD is a separately deployed, immutable ERC-721 contract (PDProject) created by a single factory (PDFactory). The generative script itself is stored on Ethereum — tokenURI returns a self-contained document that renders the artwork from chain data alone, with no server, no IPFS pin, and no external dependency for the art. Royalties are signalled through EIP-2981. A Project's terms at mint are its terms forever: no admin keys, no pausing, no upgrades.

Primary mints happen through the PDProject contract directly. After that, PD runs its own order book — listings, offers and sales live in the app, at /marketplace — and the same Outputs trade anywhere else too, because they are standard ERC-721s: third-party venues that honor EIP-2981 pay the royalty, and PriceOS aggregates and interprets that activity alongside its own.

A machine, not a space

Most art platforms are a space. A gallery, a feed, a storefront: rooms you walk through and look at from a polite distance, all painted the same white.

Price Discussion is a machine. It's a micro-toy you hold in your hand and play with. You paint it your own colorway. You slap stickers on your profile and rearrange them. You hang a charm off your name, flip a coin, get pinged, keep a Spite Book. Every surface has something to press, and pressing it does something.

That puts PD closer to the things collected on it than to the platforms that usually sell them. Like a good collectible, it has a look you choose, parts you swap, a feel in the hand, and a reason to take it out and fiddle with it again tomorrow. You don't visit PD. You carry it (digitally).

What this documentation covers

The App — every PriceOS surface: Projects and minting, Outputs, identity and profiles, the collector toolset, the Spell Book, Pings, achievements, discovery, and display settings.
Stickers — the platform's second economy: on-chain SVG collectibles in sealed sheets, with a store, a marketplace, and a binder of their own.
Smart contracts — the factory, the per-Project ERC-721, the royalty splitters, the sticker shop, and the on-chain library registry, with real function signatures from the deployed source.
$PRICE token — official PD merch: what it is, what it isn't, tokenomics, and the contract reference.
Onboarding — guided paths for artists and collectors.

Who built this

Price Discussion is a solo-founder platform engineered with frontier AI, and says so with pride: the platform — PriceOS, PD Studio, PD-Docs, PDMCP, and the smart-contract suite — was built by Claude (Anthropic's Claude models; the hardest engineering, including the smart contracts, by Claude Fable). Several of the launch catalog's generative art engines were composed with Gemini 3.0 Pro. Every line was specified, directed, reviewed, and shipped by the founder — the AI is the engineering team, not the author of the vision.

We lean into this because it says exactly what we want artists and collectors to know: the craftsmanship is real, the codebase is coherent, and the platform was built in a way that simply wasn't possible before this era. Claude-made communicates quality.

Platform status

The PriceOS app and the contract suite are complete and running against Ethereum's Sepolia test network, where the full suite — factory, Project, splitters, library registry, and the sticker shop — is deployed and exercised end to end. Mainnet deployment is the launch event; contract addresses are published in these docs when they exist. The $PRICE token is already live on Ethereum mainnet.