Toko · Consistency reference

Beneficiaries — states & stages.

Every key state of the Beneficiaries surface, each framed on its own so they can be reviewed and screenshotted side by side. Built with the shared page shell (grey body, white breadcrumb bar, header on grey, white cards) defined in style-guide/page-shell.md.

01Full page · populatedShell + control bar + card grid + add card.
All projects/Ipsum Studio/Beneficiaries
Project · Beneficiaries

Beneficiaries.

Payout identities that earn a royalty on each sale, after fees. Set them up once at the project level, then assign royalties per vendor or per collection.

Ipsum Studio (treasury)
p2x9…hb4q · creator
Live

Creator remainder. Keeps whatever is left after up to 20% in beneficiary royalties and the 1% project cycles fee.

Creator · remainder75%
Used by 3 vendors · 2 collections
Mara Okafor
k1m9…7uvw · person
Live

Lead artist on the founding collection. Paid a standing royalty across every drop she contributes to.

Royalty · % of sale10%
Used by 3 vendors · 2 collectionsLocked
Kai Nguyen
b8x4…aaae · person
Draft

Collaborating engineer. Drafted for the next series — not assigned to a vendor yet.

Royalty · % of sale7%
Used by Not used yet
Open Tools Foundation
q9y7…aaae · charity
Draft

Open-source grants partner. A portion of each sale is earmarked for tooling the community depends on.

Royalty · % of sale3%
Used by Not used yet
02Card stagesCreator remainder (Live, no actions) · Live + in use (locked).
Ipsum Studio (treasury)
p2x9…hb4q · creator
Live

Creator remainder. Keeps whatever is left after up to 20% in beneficiary royalties and the 1% project cycles fee — referral bonuses and per-vendor overrides can reduce it further.

Creator · remainder75%
Used by 3 vendors · 2 collections
Mara Okafor
k1m9…7uvw · person
Live

Lead artist on the founding collection. Paid a standing royalty across every drop she contributes to.

Royalty · % of sale10%
Used by 3 vendors · 2 collectionsLocked
03Card stagesDraft (editable: change stage · edit · delete) · Add card.
Kai Nguyen
b8x4…aaae · person
Draft

Collaborating engineer. Drafted for the next series — not assigned to a vendor yet.

Royalty · % of sale7%
Used by Not used yet
04Status filterShared control bar — All / Draft / Live selected.
05How a sale flowsReal-data worked example with a per-vendor 5% override (default 10%).

How a sale flows.

A live worked example using the Spring drop vendor on Lorem Drop No. 1. Fee and referral percentages are read from that vendor's revenue configuration and the project's cycles setting — real values, not sample data. Mara's royalty is overridden to 5% for this vendor (her project default is 10%). With no vendor assigned, this falls back to platform defaults and is shown for illustration only.

Sale
1.000 ICP
One mint from the Spring drop vendor
Fees
Project · cycles1%
Toko Studios · optional—
Referral · optional—
0.010 ICP · cycles keep the collection running
To recipients
0.990ICP
Ipsum Studio · creator84%
Mara · royalty was 10%5%
Kai · royalty7%
Charity · royalty3%
06Add beneficiary modalDisplay name and principal are required — no raw-principal title fallback.

Add beneficiary

Required. Shown wherever this beneficiary appears in splits — so it never falls back to the raw principal.
Required. Settlement goes directly to this principal.
0.1–10% per beneficiary; royalties total at most 20% across the project.
07Empty stateNo beneficiaries yet — character moment + primary CTA.
All projects/Ipsum Studio/Beneficiaries
Project · Beneficiaries

Beneficiaries.

Payout identities that earn a royalty on each sale, after fees.

Beneficiaries — none yet

Set up who gets paid.

A beneficiary is a payout identity — you, a collaborator, your studio, a charity. Define each one once with a name and a principal, then assign royalties in your vendors. Primary sales and secondary royalties flow to them after fees — the project cycles fee that keeps the collection running, plus an optional Toko Studios fee.

How splits flow

Sale → Fees → Beneficiary splits.

Every primary sale first subtracts fees — a project cycles fee (1–10%) that funds the canister keeping your collection running, plus an optional Toko Studios fee and an optional referral bonus. Beneficiaries then earn a royalty on the sale — each 0.1–10%, up to 20% in total — and the creator keeps the remainder. You can override these per vendor or per collection — useful when one drop is a charity benefit or a collaboration.

Secondary trades carry their own configurable royalty split, capped at 20% of the sale to beneficiaries, paid to the same identities. Settlement is on-chain to each principal — there's no separate Toko wallet in the middle.

SALE · 1.00 ICP
— Project cycles fee 3%
— Toko Studios fee 2% (optional)(+ optional referral)
0.95 ICP to recipients:
Studio · creator75%
You · royalty10%
Collaborator · royalty7%
Charity · royalty3%
01

Project-scoped, vendor-overridable

Set default splits at the project. Override per vendor for one-off collaborations or charity drops.

02

Secondary royalties, set separately

Secondary trades use their own configurable royalty split, capped at 20% of the sale, paid to the same beneficiaries.

03

Cycles keep it running

The project fee funds the canister behind your collection. Settlement is on-chain, direct to each principal — no platform wallet in the middle.

08Detail · draft / review (editable)Not yet Live — name, type, description and royalty are editable; change stage or delete.
All projects/Ipsum Studio/Beneficiaries/Kai Nguyen
Project · Beneficiary

Kai Nguyen Review

b8x4…aaae · person · not assigned to a vendor yet.

Shown wherever this beneficiary appears in splits.
Settlement goes directly to this principal. Locked once set.
0.1–10% per beneficiary; royalties total at most 20% across the project.
09Detail · live (locked)Live and in use by vendors — read-only; duplicate to make an editable copy.
All projects/Ipsum Studio/Beneficiaries/Mara Okafor
Project · Beneficiary

Mara Okafor Live

k1m9…7uvw · person

This beneficiary is Live and in use — locked.
It's referenced by active vendor splits, so its details and royalty can't be changed.
Display name
Mara Okafor
Principal
k1m9-7uvw-aaa1-bb2k-cdef-aaae-q
Type
Person
Description
Lead artist on the founding collection. Paid a standing royalty across every drop she contributes to.
Royalty · % of sale
10%
Used by
3 vendors · 2 collections
10Delete beneficiary · confirmDraft / review only — a Live, in-use beneficiary is locked and can't be deleted.

Delete beneficiary?

Anxious Toko bot

Are you sure?

This permanently deletes the Kai Nguyen beneficiary. It isn't assigned to any vendor yet, so no live splits change. You can't undo this.