PACTCLANKER: design docs + PartyClanker PRD (Model B rev 2) by zherring · Pull Request #1 · 0xSplits/splits-pact

zherring · 2026-07-16T17:58:44Z

What this is

Design-docs-only branch for PACTCLANKER — a fork direction that strips PACT down and re-aims it at crowd-launching a vanilla Clanker coin. No code changes yet; this PR exists to collab on the mechanism design before anything gets built.

docs/pactclanker-prd.md — the main document. Two models:
- Model A: stripped-down PACT (kept for contrast)
- Model B rev 2 (working name: PartyClanker) — the favored direction: crowd pools USDC all-or-nothing → one settlement tx does a completely vanilla Clanker v4 launch (DevBuy funded by the pool, Vault as the early-backer bonus, trading fees → a Liquid Split forever). Nobody is paid; the settlement contract is the creator-of-record and provably can't keep anything.
docs/pact-equity.md / docs/pact-note.md — earlier PACT design notes (v1 fixes, waterfall/cap variant), kept as reference; not appropriate for main as-is.

Decided (see Design decisions in the PRD)

DD-2: 0% founder anything at v0 — creator's edge is the time-weighting's natural advantage
DD-3: linear dollar-seconds accumulator (MetaDAO-style, verified against their docs), no fill boost; composes with the vault (vault = why commit before TGE, accumulator = why commit early in the window)
DD-5: raise in USDC, pool pairs WETH, one USDC→ETH swap in finalize (DevBuy is ETH-denominated regardless; USDC isn't a supported Clanker quote token)

Open — input wanted (@abramdawson)

DD-1: withdrawal policy — lock vs withdraw-any-time-with-pro-rata-weight-wipe (leaning withdrawable; both are exploit-free, writeup has pros/cons)
DD-4 params: max-raise cap sizing, min-deposit floor, dust-refund threshold
ClankerUniv4EthDevBuy output routing (first thing to verify in their contracts)
"50+ day-one holders" vs everything-streams tension, vault multiple/stream ratio, unit transferability, platform fee share

🤖 Generated with Claude Code

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

… a product choice Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

… + complexity budget Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

…pose, DD-2/3/5 decided, DD-4 dust/min/max Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

…-model.html) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

…6 readouts Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

…yping preview, model modal, floating mock-state card Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

abramdawson · 2026-07-16T20:07:20Z

+
+## Design changes
+
+### 1. `sweepDistributions()`


hm i need to think about this. seems potentially tricky and confusing. i think if the clanker token is spitting off fees, conceptually that should drive up the share price of the offering, since that's essentially saying "this thing is more valuable now". idk the right mechanism/how to capture this, but conceptually i think that's how it should work (open to feedback/pushback).

which, if the treasury were to use that proceeds to buy tokens from the offering, that would push up the price…

…onfetti yolo, armed Yolo button Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

abramdawson · 2026-07-16T20:09:04Z

+
+### 2. Escrowed unit delivery until `minMet`
+
+Recommended fix for the refund exploit: hold purchased units in the Offering


i don't love separating buy from claim. buying something and not getting it right away feels anti what this tech should enable.

abramdawson · 2026-07-16T20:09:35Z

+
+Alternatives considered:
+
+- Clawback on refund via ERC-1155 operator approval granted at buy time —


strongly against this, since it means "these aren't your tokens" if the project creator can take them from you.

…treatment, steady armed Yolo Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

abramdawson · 2026-07-16T20:12:52Z

+
+## Pricing
+
+Because a unit is a claim on an observable revenue stream, the curve can be


is this true? the early revenue stream is from,, snipers? ig me not understanding this is probably indicative of a lack of deeper understanding…

maybe this is true, and in that case it's really not a pact at all, since this is not a placeholder - you are buying a portion of the revenue stream.

abramdawson · 2026-07-16T20:13:46Z

+
+- Should `sweepDistributions()` run automatically inside `buy()` /
+  `closeAndWithdraw()` to keep balances clean, or stay a separate call?
+- Escrowed delivery changes the buyer receipt UX ("you hold a claim until the


something needs to show up in their wallet.

…fees fixed; math box states the rule Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

abramdawson · 2026-07-16T20:17:10Z

+read that first. Assumes the revenue-first posture (revenue routed before
+launch) and the v1 fixes (distribution sweeping, escrowed unit delivery).
+
+## Thesis: seniority and a cap


something something this is like "a financing in a box" - you bring the business (economically productive asset), the software offers the guardrails/interface/etc for everything else.

…ade fee Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

… copy, Back button, ETH input suffix Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

… to max Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

…-bump state Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

…ling Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

The Party list kept replaying its entrance/flash animations while idle. Root cause was not the FLIP (correctly rank-gated) nor preview-drift, but that `Row` was defined *inside* `Partiers`. Every ambient-drift render (~12.5x/sec while phase==='funding') gave `Row` a new function identity, so React treated it as a different component type and tore down + rebuilt every row's DOM. Each rebuild re-mounted the you-row, replaying the `.enter` pop-in (measured: 125 firings in 10s of pure idle) and re-firing the `.just-bumped` flash on every tick. WAAPI FLIP stayed at 0 the whole time, which is why prior static/reflow-only checks missed it. Fix: hoist `Row` to module scope so its identity is stable across renders. React now preserves row nodes across ambient re-renders — pop-in fires once on real entry, bump-flash once per real active->dust fall, and FLIP still springs on genuine rank changes. `justBumped` is now passed in as a `bumped` prop since the closure no longer lives beside the JSX. Verified via Playwright (animationstart + Element.animate instrumentation): idle and typed-preview scenarios now log ZERO list animations over 10s (down from 125 pop-ins); real entry/overtake/dust-fall still fire exactly the expected one-shot animations. npm test 17/17, build clean. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

…indings Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

…ly share Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

…ec, invariants, references; vendor v0 build prompt + crowd model into docs Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

…les to launcher wallet Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

…her never vanishes Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01ErhEzWHTduozGt7LQKfqaX

…d, launcher never vanishes" This reverts commit af8f028.

…the Party contract Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

… no launcher special-casing Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

zherring and others added 10 commits July 15, 2026 17:53

Add PACT design notes and PACTCLANKER PRD draft

b41e4cf

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

PRD: add Model B — crowdfunded clanker launch, time-weighted pool

1627957

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

PRD: MetaDAO accumulator verified; wipe-on-withdraw is sound, lock is…

ee00486

… a product choice Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

PRD: design decisions (withdrawal policy, founder reserve, weight fn)…

7b4bef6

… + complexity budget Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

PRD: Model B rev 2 — vanilla Clanker path, time-weighting + vault com…

4c0b76a

…pose, DD-2/3/5 decided, DD-4 dust/min/max Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

PRD: min-raise check applies net of dust refunds

d349e92

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

DD-5 revised to ETH raise; add backer-POV launch modeler (pactclanker…

d9e8a05

…-model.html) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

PRD: DD-6 — fixed-multiple vault + mcap >= 2.5x max raise guardrail

e8a9b2c

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Add /party playable mock — five lifecycle states, time-weight UX, DD-…

2bc8c26

…6 readouts Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Party mock v2: rainbow-dark throwaway theme, merged left card, live t…

eff5aec

…yping preview, model modal, floating mock-state card Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

abramdawson reviewed Jul 16, 2026

View reviewed changes

Party mock v3: green/blue palette, FLIP party list, bump sad-faces, c…

3656cbc

…onfetti yolo, armed Yolo button Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

abramdawson reviewed Jul 16, 2026

View reviewed changes

Party mock v4: compact deal line, always-open math box, blue preview …

24c6554

…treatment, steady armed Yolo Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

abramdawson reviewed Jul 16, 2026

View reviewed changes

Modeler enforces house rules: mcap = 2.5x max derived, vault/streams/…

6b33d92

…fees fixed; math box states the rule Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

abramdawson reviewed Jul 16, 2026

View reviewed changes

zherring and others added 11 commits July 16, 2026 14:19

Launched note: units earn share of the launcher fee, not the whole tr…

269dcaa

…ade fee Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Party mock v5: sim controls (backers/crowd/clock+play), floor ratchet…

f298cdf

… copy, Back button, ETH input suffix Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Party mock: live accrual view — hero ticks toward at-close share

2f5a935

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Raise bar: two-stage scale — full bar = goal until met, then rescales…

473cc56

… to max Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Live weight hero: ambient accrual drift + high-precision ticker

1a366a1

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Hero ticker is now the floor — always up; at-close drops on backs

f450591

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Bump UX: guaranteed near-dust backers, animated fall to refunded, own…

a0250ea

…-bump state Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Gets + math box: simple checkmarked lists

785c444

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Party list springs only on rank change

e006bfa

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Ownership stats read as a range: fills-floor vs no-one-else-backs cei…

2e6d998

…ling Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Party list sorts by at-close share — moves only on real events

583b6d3

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

zherring and others added 11 commits July 16, 2026 17:06

PRD: DD-6 rev 2 (mcap = 5x actual raise at finalize) + UX prototype f…

cb843d3

…indings Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

DD-6 rev 2: no mcap floor — micro parties keep the universal 32% supp…

75dc07a

…ly share Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Mock: DD-6 rev 2 — mcap = 5x actual raise, size-invariant deal

56d94c6

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Modeler: DD-6 rev 2 — mcap = 5x actual raise

1f3defe

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Contracts implementation plan: verified Clanker integration, Party sp…

9ffe1ca

…ec, invariants, references; vendor v0 build prompt + crowd model into docs Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

DD-7: launcher admin share (1 unit locked at mint) + non-fee admin ro…

90a34fe

…les to launcher wallet Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Mock: DD-7 launcher admin share — 1 unit locked, 999 quantized, launc…

af8f028

…her never vanishes Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01ErhEzWHTduozGt7LQKfqaX

Revert "Mock: DD-7 launcher admin share — 1 unit locked, 999 quantize…

7f5f448

…d, launcher never vanishes" This reverts commit af8f028.

Reject DD-7 — KISS for v1: no admin share, all admin roles frozen on …

0616049

…the Party contract Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Contracts plan: DD-7 rejection — all admin roles frozen on the Party,…

6c934a0

… no launcher special-casing Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

PACTCLANKER: design docs + PartyClanker PRD (Model B rev 2)#1

PACTCLANKER: design docs + PartyClanker PRD (Model B rev 2)#1
zherring wants to merge 35 commits into
mainfrom
pactclanker

zherring commented Jul 16, 2026

Uh oh!

abramdawson Jul 16, 2026

Uh oh!

abramdawson Jul 16, 2026

Uh oh!

abramdawson Jul 16, 2026

Uh oh!

abramdawson Jul 16, 2026

Uh oh!

abramdawson Jul 16, 2026

Uh oh!

abramdawson Jul 16, 2026

Uh oh!

abramdawson Jul 16, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants


		### 2. Escrowed unit delivery until `minMet`

		Recommended fix for the refund exploit: hold purchased units in the Offering


		Alternatives considered:

		- Clawback on refund via ERC-1155 operator approval granted at buy time —


		## Pricing

		Because a unit is a claim on an observable revenue stream, the curve can be

Uh oh!

Conversation

zherring commented Jul 16, 2026

What this is

Contents

Decided (see Design decisions in the PRD)

Open — input wanted (@abramdawson)

Uh oh!

abramdawson Jul 16, 2026

Choose a reason for hiding this comment

Uh oh!

abramdawson Jul 16, 2026

Choose a reason for hiding this comment

Uh oh!

abramdawson Jul 16, 2026

Choose a reason for hiding this comment

Uh oh!

abramdawson Jul 16, 2026

Choose a reason for hiding this comment

Uh oh!

abramdawson Jul 16, 2026

Choose a reason for hiding this comment

Uh oh!

abramdawson Jul 16, 2026

Choose a reason for hiding this comment

Uh oh!

abramdawson Jul 16, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants