Marketplace

Marketplace token (buy) — states gallery

The buyer-facing token view on the Marketplace — a quick-view modal that opens over the browse grid (which stays open behind it), so closing it returns you to your place. Only listed tokens open this view. It mirrors the launchpad claim view — same viewer, same side panel, same confirm-before-settle modal and result — so buying feels like claiming. The difference is the panel: a fixed-price listing (price, floor, last sale) instead of a vendor drop. v1 is Buy Now only — no bidding, no offers. Source: Design Documentation/secondary-marketplace-design.md.

Reached from Marketplace. Related: List for sale · My Tokens

01Listed & buyable — token quick-view (modal)Opened by clicking a listed token in the marketplace grid: a quick-view modal over the browse, which stays open behind it — closing returns you to your place in the grid (so there is no "More from this collection" rail). Left: the viewer with identity, attributes and market history. Right: the buy panel — seller, price, collection floor and last sale, listing expiry, and the primary Buy now CTA. The seller set a referral fee (1–10%) when listing; a higher fee places the listing nearer the top of the marketplace. Only listed tokens open this view.

02Buy confirm — wallet & payment contextBuying is explicit and user-confirmed, identical in shape to the claim confirm. Before anything settles the modal restates what's bought and what's paid from the connected wallet, including the running balance. The buyer pays the list price only — there is no separate network/platform fee added to the buyer. On confirm, settlement is atomic and ownership transfers to the buyer.

02bStack listing — pick a quantity · race errorA stack listing is priced per unit: the buyer picks any quantity up to the remainder (all 12, or just 1) and pays qty × unit price; the rest stays listed at the same terms. Remaining quantity is race-protected (atomic check-and-decrement; first call wins) — if another buyer got there first, the purchase fails cleanly with the remaining count and a one-tap offer to buy all the remaining units (remaining 0 falls through to sold-out). Same ruleset as stack claims on the Launchpad.

03Buy result — success & sold-during-purchaseOn success the token transfers to the wallet. If it sold between opening and confirm (the race the spec calls out), the purchase fails safely with nothing charged and a route to similar listings — never a silent failure or a double-charge. Both results dismiss back to the marketplace behind.

04Guards — insufficient funds & listing expiredBuyer-funds and listing validity are checked at confirm. Not enough balance blocks the buy and points to the wallet; a listing that expired or was cancelled in the meantime resolves to a clean, no-charge dead-end with a route back to similar listings.

Aurora Finch #12