- Add README for @settlekit/attribution (reuse-detection, lineage, proofs) - Add README for apps/creator-dashboard (real-domain-logic earnings view) - Move attribution + creator-dashboard from 'not yet built' to 'built & green' in docs/LEPTON_REMAINING.md; bump health to 948 tests + 27 contract tests - List creator-dashboard in the README apps tree
4.7 KiB
Lepton — What's Left
Status of the SettleKit Lepton submission (Canteen × Circle × Arc hackathon, Jun 15 → Jun 29 2026), ordered by judging-criteria impact. Companion to ../LEPTON_PRODUCTION_PLAN.md. Verified against the repo on 2026-06-20.
Judging weights: Agentic 30% · Traction 30% · Circle tools 20% · Innovation 20%.
0. The one blocker that matters most — Traction (30%)
Nothing has settled real test-USDC on Arc yet. The entire settlement spine
runs on the local provider; the worker's three lepton-* jobs
(lepton-payout-sweep, lepton-settlement-reconcile, lepton-stream-refund)
are wired but no-op until a settlementProvider + an Arc-indexer
confirmationSource are injected at deploy.
Going live needs interactive auth (cannot be automated):
uv tool install git+https://github.com/the-canteen-dev/ARC-cli && arc-canteen loginnpm install -g @circle-fin/cli- Deploy contracts with a faucet-funded key:
cd contracts && forge script script/DeployLepton.s.sol --rpc-url https://rpc.testnet.arc.network --private-key $DEPLOYER_KEY --broadcast - Set
SETTLEMENT_PROVIDER=circle+ARC_INDEXER_URLand point one sidecar (recommendrsshub-citation-toll— agents are the payers, so volume is self-generating) at a real RSSHub/Navidrome/Owncast instance.
Runbook: ../LEPTON_PRODUCTION_PLAN.md → "Live testnet runbook".
1. Built & green (no work needed)
- Settlement spine —
@settlekit/settlement-core(Gateway/Circle/local providers, idempotency, batch accumulator, on-chain reconcile). - Sidecars (3) —
rsshub-citation-toll,navidrome-scrobble,owncast-stream, each with optional bearer auth on money-moving routes. @settlekit/oss-fund— manifest → graph → conserved allocation → per-leg-reconciled, idempotent settlement → one-tx distributor calldata.- On-chain contracts (3) —
RecursiveSplitDistributor,LeptonStreamSettlement,AgentReputationBond; Foundry-tested (25 tests), one-command deploy viacontracts/script/DeployLepton.s.sol. - End-to-end demo —
pnpm --filter @settlekit/examples lepton. - Worker jobs — three
lepton-*jobs wired into the scheduler. @settlekit/attribution(RFB 6.01) — reuse-detection, weighted provenance lineage, and HMAC-signed proofs-of-citation; wired live into thersshub-citation-tollsidecar (POST /attribution/{detect,proof,verify}) and persisted viaPgLineageStore/PgProofStore.apps/creator-dashboard— a Next.js earnings view in the Statement greenbar-ledger design system, driven by real domain logic (createSource+computeRoyaltyDistribution+detectReuse, not mocks).next buildgreen.
Health: 948 unit/integration tests + 27 contract tests green.
2. Planned in the production plan but not yet built
Verified absent on disk.
| Component | Path | Serves | Autonomous? |
|---|---|---|---|
| Operator CLI | clis/lepton |
Circle-tools / DX | ✅ yes |
| Agent console | apps/agent-console |
Agentic / Innovation | ✅ yes |
| Stream meter UI | apps/stream-meter |
Innovation, RFB 4 | ✅ yes |
| Fiat off-ramp | packages/payouts-cpn |
Creator cash-out | ⚠️ stub only (needs Circle CPN creds to be real) |
| Agent-run Pg store | packages/persistence |
persistence (deferred) | ✅ yes, small |
3. Submission deliverables (not code)
- Public GitHub repo
- <3min video demo (required) — the
leptondemo script is built for this - Live deployed link (encouraged) — frontends on Vercel + API on Render are up, but the sidecars are not deployed
- Submission form (forms.gle) with traction numbers (users onboarded, payments flowing)
4. Recommended order
- Go live on Arc (section 0) — unlocks the 30% Traction criterion; the rest is theater without real USDC moving.
- Deploy
apps/creator-dashboard— gives a live link + a visible "creators getting paid" surface for the video. (Built and green; ✅ done in code.) - Record the <3min video and submit (submit early/often; resubmission allowed).
✅
packages/attribution(citation reuse-detection + signed proof-of-citation) andapps/creator-dashboardare now built, merged, and green — see section 1.
5. Open decisions (need a human call)
- Which sidecar goes live first for real traction (recommend
rsshub-citation-toll). - Fiat off-ramp now or later — include
payouts-cpnfor the submission or defer. - On-chain vs. off-chain settlement — how much moves to the deployed contracts
vs. staying in
settlement-corefor the demo window.