Toko · Consistency reference
Vendors — Management.
The running side of vendors: the vendor list, the vendor detail page, lifecycle controls, and runtime states. The create-a-vendor wizard (Type → … → Summary) and its Draft → Review → Live stages live in vendor-creation-states-gallery; gacha-only states live in gacha-vendor-states-gallery. The public claim side is Launchpad. Launch scope is Market vendors only (Gacha deferred).
01Manage vendors — listEvery vendor for the collection. Each card shows the two independent state axes — Stage and Runtime — plus inventory and claimed progress. The blurred "status" of the old flow is replaced by these explicit signals, because every lifecycle control depends on a combination of them.
Project · Vendors
Vendors.
Project-scoped distribution mechanisms. Inventory can be drawn from any of the project's collections; rules are applied publicly on Launchpad.
Spring Launch
Market · 3 collections
LiveRunning
Claimed142 / 300
Holders Drop
Market · Whitelist + NNS
LivePaused
Claimed60 / 120
Founders Sale
Market · ICP claim
ReviewSetup
Reviewed and stocked — set Live to publish to Launchpad.
Summer Teaser
Market · ICP claim
DraftSetup
Configuration in progress — finish setup, then set Live.
Glitch Drop
Market · ICP claim
LiveEmpty
Inventory exhausted — add stock and restart to keep selling.
02Vendors — first load (empty)What you see on first load with no vendors set up. Uses the shared no_vendors hero, a single CTA — "Set up your first vendor" — plus a short explainer beneath the hero of what a vendor is and how it works.
Project · Vendors
Vendors.
Distribution mechanisms for this project — inventory can come from any of its collections. The public claim side is Launchpad.
Get your tokens to collectors.
A vendor lists your minted tokens on Launchpad for collectors to claim — for a price, or against a rule like a whitelist or a neuron stake.
How it works
Rules in, claims out.
A vendor is a project-scoped distribution mechanism. You allocate minted tokens into it — from any of the project's collections — and set what a collector must pay or prove to claim one — a cost, a whitelist, a neuron stake. Once it's set Live, it appears on Launchpad, where collectors claim and revenue is split to your beneficiaries after fees. Each token is validated individually at its own go-live, so the vendor itself just needs to be set Live. Launch supports Market vendors; Gacha comes later.
1
Define costs & rules
Per-tier price and claim requirements.
2
Allocate inventory
Move minted tokens in from any collection.
3
Publish to Launchpad
Set Live and collectors start claiming.
03Live vendor — overview (read-only)A Live vendor's landing, organised by the same stage separations as the creation wizard shown read-only as view/manage tabs. Overview is a concise snapshot — state, the inventory total, and the lifecycle controls; each section (Storefront · Lifecycle · Costs & rules · Revenue) opens on its own tab (03b–03e), and Inventory has its own screens (09–12). Lifecycle controls are gated by Stage + Runtime — unavailable controls are greyed with the reason on hover.
Project · Vendor — Spring Launch
Market vendor on Launchpad. Read-only view of the vendor's settings — aesthetics stay editable; core policy is locked.
LiveRunning
Inventory
Claimed142 / 300
Remaining158
Inventory policyFlexible
Drawn fromSpring Foxes, Night Market, Winter Tales
Lifecycle controls
Available actions depend on Stage + RuntimeDelete isn't available on a Live vendor — only an ended & empty vendor can be deleted (see the Ended state).
03bStorefront tab — editable (Live)The Storefront tab opens the editable storefront form directly — the same page as the creation step, not a modal. Aesthetics are editable on a Live vendor whether it's running or paused — storefront edits don't require pausing. The page auto-saves and changes show on Launchpad immediately; saving a new thumbnail or banner runs the project cycle check (06–08). Lifecycle, Costs & rules and Revenue stay read-only on Live (03c–03e).
Project · Vendor — Spring Launch
How buyers see this vendor on Launchpad. Editable on Live — changes save automatically.
LiveRunningSaved · just now
Customise your storefront
Editable on LiveSquare thumbnail (min 512×512) and a wide banner. Saving a new image runs the project cycle check — see 06–08.
03cLifecycle tab — read-only (Live)The Lifecycle policy on its own tab, read-only because the vendor is Live — collectors are claiming against it, so activation, control mode and end behaviour are frozen. (On a Draft vendor this tab is the editable lifecycle form, same as the creation step.)
Project · Vendor — Spring Launch
How this vendor opens and ends. Locked once Live.
LiveLocked
Lifecycle policy was fixed when the vendor went Live. Collectors are claiming against it, so it can't change.
Activation — how it opens
ModeStart manually
Started2 Jun 2026 · 09:14
Control mode — how it runs
ModeAdmin controlled
Earliest stop14 Jun 2026 · reached
When it stops — unclaimed inventory
End behaviourReturns to the collection
03dCosts & rules tab — read-only (Live)Per-tier claim cost and requirements, copied from the collection's claim defaults at creation and editable per vendor in Draft. Read-only on Live.
Project · Vendor — Spring Launch
What collectors pay and must prove to claim, per tier. Locked once Live.
LiveLocked
Costs & rules
3 / 3 tiers pricedCommon1.5 ICPOpen · no gates
Rare4 ICPWhitelist
Epic8 ICPICP NeuronWhitelist
Copied from the collection's claim defaults when the vendor was created, then editable per vendor in Draft. Requirements combine with AND.
03eRevenue tab — read-only (Live)Where claim proceeds go — the applied revenue preset's fees and royalties — plus what's collected so far. For a time-limited royalty it shows the time remaining and the current (tapered) amount; once a period ends the beneficiary stays on record with a "time period ended" label. Locked on Live.
Project · Vendor — Spring Launch
Claim proceeds, fees and the beneficiary split. Locked once Live.
LiveLocked
Collected
Preset · Founders SplitClaims142
Gross collected186.5 ICP
Project / cycles funding (3%)5.60 ICP
Toko contribution (0%)0 ICP
Net to beneficiaries180.90 ICP
Royalties
LockedStudio Treasury
Linear taper · started 8%5.2% now
4 of 12 months left
Linear taper · started 8%5.2% now
4 of 12 months left
Lead Artist
Was 4% for 12 monthsTime period ended
Was 4% for 12 monthsTime period ended
Community Fund
Forever · no taper3%
Forever · no taper3%
Royalties come from the applied preset (Founders Split), copied when this vendor was created. Tapering amounts update over time; an ended period stops paying but the beneficiary stays on record. Locked once Live.
03fRevenue tab — royalty tapering over timeA Live vendor whose preset includes a time-limited, tapering royalty. The Revenue tab shows the beneficiary's current (tapered) share vs its starting share, the taper type, and time left in the period. Read-only — the values were copied from the preset at creation; the taper advances automatically with elapsed time.
Project · Vendor — Spring Launch
Claim proceeds and the beneficiary split. Locked once Live.
LiveLocked
Royalties
Preset · Founders SplitStudio Treasury k1m9…7uvw
Linear taperStarting share
8%
→
Current share (now)
5.2%
Period elapsed8 of 12 months · 4 left
TaperLinear · over 12 months
Started → ends14 Jun 2026 → 14 Jun 2027
Paid to date62.1 ICP
Lead Artist7% now · Curve · 2 mo left
Community Fund3% · forever
Tapering shares recalculate from elapsed time, so the "now" figure updates automatically. Copied from the preset at creation; locked on Live.
03gRevenue tab — royalty period expiredA Live vendor whose preset includes a time-limited royalty that has reached the end of its period. The beneficiary stays on the record with a "Time period ended" label and a 0% current share — it no longer receives a cut, but its history (what it was, how long, total paid) remains visible for transparency.
Project · Vendor — Spring Launch
Claim proceeds and the beneficiary split. Locked once Live.
LiveLocked
Royalties
Preset · Founders SplitLead Artist 9xa2…b3kk
Time period endedCurrent share0% · no longer paying
Was4% · no taper · 12 months
Ran10 Jun 2025 → 10 Jun 2026 · ended
Total paid54.55 ICP
Studio Treasury5.2% now · Linear · 4 mo left
Community Fund3% · forever
An ended royalty stays on the record for transparency but pays 0% going forward — it is never removed automatically. Copied from the preset at creation; locked on Live.
04Lifecycle confirms — Pause · Resume · Restart · EndEvery lifecycle control and its confirm. Pause and Resume are quick, reversible toggles on claiming. Restart brings an emptied vendor back once it's restocked (and errors if it has no tokens). End is terminal and applies the vendor's end behaviour — unclaimed inventory returns to its collections or is burned, per the lifecycle setting; ending an already-empty vendor just needs a simple confirm.
Pause Spring Launch?
There are 158 tokens in this vendor — are you sure? Pausing closes all claims on Launchpad immediately. Inventory and configuration are unchanged, and you can resume anytime.
RuntimeRunning → Paused
Resume Holders Drop?
Re-opens claiming on Launchpad. Requires the vendor to be Live with inventory remaining.
RuntimePaused → Running
Restart Glitch Drop?
Bring this vendor back to running? It was emptied and re-stocked, so claiming can re-open on Launchpad.
Inventory120 tokens staged
RuntimeEmpty → Running
Can't restart Glitch Drop
This vendor has no tokens, so it can't be restarted. Its inventory is Flexible — add tokens and try again. (A Locked-inventory vendor can't be restocked, so it can only be ended.)
Tokens in vendor0
End Spring Launch?
This ends the vendor for good. Claiming closes and it can't be restarted. This vendor's end behaviour returns unclaimed tokens to their collections.
Unclaimed inventory158 → returned to collections
RuntimeRunning → Ended
End Founders Sale?
This ends the vendor for good. Claiming closes and it can't be restarted. This vendor's end behaviour burns unclaimed tokens — they're permanently destroyed and don't return to any collection.
Unclaimed inventory84 → burned
RuntimeRunning → Ended
End Glitch Drop?
This vendor is empty — end it? Every token has been claimed, so there's nothing to return or burn. Ending closes it for good and it can't be restarted.
Unclaimed inventory0 · nothing to return
RuntimeEmpty → Ended
05Runtime state on the page — Empty (inventory exhausted)How a runtime state actually appears — in context at the top of the vendor's page, not a modal. The banner pins above the content with the matching badge and actions. Empty means every token has been claimed: Restart after restocking, or End. Low stock is the same banner on a still-Running vendor that has stock left (additive / flexible only). Ended is the terminal state — see 14b.
Project · Vendor — Glitch Drop
Glitch Drop · every token has been claimed.
LiveEmpty
Inventory exhausted — all 200 tokens claimed. Pause to add inventory, then Restart to re-open claiming — or End the vendor. Restart becomes available once at least one token is added.
No tokens left
Every minted token in this vendor has been claimed. Pause to add inventory and Restart to re-open claiming on Launchpad, or End the vendor to close it.
06Storefront media edit · cycle check (balance OK)Replacing a live vendor's thumbnail or banner stores the new image in blob storage, funded from project cycles. Before it saves, Toko estimates the cost and checks the balance — the same guard used for every upload (see the Cycles & uploads gallery). With headroom, it saves normally.
Upload assets
spring-launch-banner.png staged · 2.8 MB · uploaded & held
Estimated cost
~0.03 T cycles
Project balance
2.040 T
After upload
~2.01 T
Enough cycles to store this image and keep your reserve. Toko moves project cycles into blob storage automatically. The previous image is replaced once the new one lands.
07Storefront media edit · low balanceThe estimate exceeds the balance. The new image stays staged — the live vendor keeps its current image until the replacement lands — and the primary action becomes Top up & upload.
Upload assets
spring-launch-banner.png staged · 2.8 MB · uploaded & held
Estimated cost
~0.03 T cycles
Project balance
0.010 T
Shortfall
~0.02 T + reserve
Not quite enough cycles to store this image. It stays staged and the live vendor keeps its current image — top up and the replacement saves straight away. Nothing is lost if you top up now.
08Top up to continue · image stagedThe inline top-up. The staged image is shown at the top so it's clear nothing was cancelled; once cycles land in blob storage, the replacement saves automatically.
Top up to continue upload
spring-launch-banner.png staged · 2.8 MB · ready to save
This upload (est.)~0.03 T
Project balance0.010 T
Recommended top-up (cost + reserve)1.000 T
Top up amount
T cycles · ≈ 0.30 ICP
from your wallet to the project canister
Cycles are sent to the project canister; Toko moves what's needed into blob storage. After it lands, the staged image saves automatically.
09Inventory — running (must pause to edit)A live vendor's inventory, opened while it's Running. The tokens are shown read-only and the add/remove controls are disabled — you must pause claims before altering inventory, so a collector can't buy a token mid-edit. Additive & Flexible vendors only; a Locked-inventory vendor has no edit affordances at all.
Project · Vendor — Spring Launch
Minted tokens staged in Spring Launch, drawn from across the project's collections. Policy: Flexible.
LiveRunning
Pause to change inventory. This vendor is Running, so adding or removing tokens is locked — a collector could be claiming a token at the same moment. Pause claims, edit inventory, then resume.
🦊
🏮
🦊
❄️
🎆
🦊
×410Inventory — paused & populated (flexible)Paused, so editable. Filter by collection and rarity tier; the grid mirrors the Minted-token management cards. Flexible inventory can also remove tokens — Select turns on per-card checkboxes and the bulk bar, and removing returns those tokens to their collections. (An Additive vendor shows Add only, no Select/Remove.)
Project · Vendor — Spring Launch
Spring Launch is paused, so inventory is editable. Policy: Flexible — add and remove. Tick a token to start a selection.
LivePausedEditable · paused
This vendor is paused — claims are closed on Launchpad. While paused you can add and remove inventory; resume to re-open claiming.
🦊
🏮
🦊
❄️
🎆
🦊
×411Add tokens (aligned with creation)Opened from "+ Add tokens" on a paused vendor — the same picker used in the creation Inventory step. Choose a source collection, multi-select from the minted tokens it holds, page through large collections. Only minted, collection-held tokens appear. The primary button counts the selection.
Add tokens to Spring Launch
Move minted tokens held by a collection in Vault One into this vendor. Only minted tokens the collection currently holds can be added — unminted definitions and externally-held tokens can't.
3 of 620
🎭
🏮
🎆
🏮
🧧
×4🥮
🎭
🎇
Showing 1–18 of 620 held
12Remove tokens — confirm (flexible)From the bulk bar's "Remove from vendor". Removing returns the tokens to their collections' held inventory — they leave the vendor and can't be claimed here until re-added. Flexible vendors only.
Remove 3 tokens from Spring Launch?
These tokens leave the vendor. They return to their collections' held inventory and can't be claimed here until you add them again. The vendor is paused, so no claim is in flight.
Spring Foxes2 → returned to collection
Night Market1 → returned to collection
14Scheduled state — on the pageA Live vendor set to open at a future time, shown on its Overview tab; the banner pins to every tab until it opens. It starts automatically at the set time — collectors can't claim before then — and the creator can start early or reschedule. Draft vendors aren't managed in this section at all: the list card's "Continue setup" reopens the creation wizard (see 01 and vendor-creation-states-gallery) — there's no Draft page here, by design.
Project · Vendor — Summer Teaser
Market vendor · scheduled to open.
LiveScheduled
Live, scheduled to open 20 Jun 2026 · 14:00 UTC. It starts automatically — collectors can't claim before then. This banner shows on every tab until it opens.
Schedule
Opens20 Jun 2026 · 14:00 UTC
Time until open2 days
Inventory staged200
14bEnded state — on the page (read-only record)A terminated vendor on its Overview tab. It's a read-only record — not on Launchpad (no public link) and, as a Live-stage vendor with on-chain history, it can't be deleted. Per its end behaviour, unclaimed tokens were returned to their collections (or burned).
Project · Vendor — Winter Drop
Ended — a read-only record.
LiveEnded
This vendor has ended. Per its end behaviour, unclaimed inventory was returned to its collections. It's no longer on Launchpad, and a Live-stage vendor can't be deleted — this is a read-only record.
Final record
Ended18 Jun 2026 · 11:40 UTC
Claimed142
Returned to collections158
Revenue collected186.5 ICP
14cPaused state — on the page (banner on every tab)A paused vendor on its Overview tab. Claims are closed on Launchpad and the banner pins to the top of every tab — Overview, Storefront, Lifecycle, Inventory, Costs & rules, Revenue — until it's resumed. Resume re-opens claiming; while paused, aesthetics and inventory stay editable.
Project · Vendor — Holders Drop
Market vendor · paused.
LivePaused
This vendor is paused — claims are closed on Launchpad. This banner shows on every tab until you resume.
Inventory
Claimed60 / 120
Remaining60