technodemocracy.app

From magical internet money to magical internet votes.

An implementation of Balaji Srinivasan's technodemocracy spec: digital political parties with binding, scoped, OAuth-style franchise grants. Built on Base.

What it is

Each "party" is a binding social smart contract. Joining grants the party president a cryptographically scoped franchise over your wallet: annual dues, slashable stake, delegated voting weight, follow-the-slate. Like Google OAuth, but for political parties.

• Universal candidacy. Any wallet may found a party.
• Universal franchise. Any wallet may grant the franchise to any party.
• Streaming votes. Every vote registers onchain the moment it's cast.
• Provably limited government. The president can never exceed the slashing cap, the dues amount, or the registered delegated voting weight.
• Soulbound vote receipts. Every vote mints an "I Voted" NFT: verifiable on Basescan, can't be sold.
• Bidirectional with the real world. NFT-gated doors, drones, and infrastructure.

The 12-contract suite (/contracts)

Solidity 0.8.27, Cancun EVM, viaIR, OpenZeppelin v5.

Contract	Role
PartyRegistry	Universal candidacy; party metadata + president
NormsRegistry	Versioned norms with content hashes
MembershipNFT	Soulbound; minted on franchise grant, burned on revoke
Franchise	Typed Scope enum; per-scope revoke; provably bounded slashing
Cabinet	Typed Power enum; digital delegation
DisputeResolver	Binding verdicts; gates slashMember
IVotedNFT	Soulbound on-chain SVG vote receipts
Voting	Streaming votes + delegated weight
Election	Periodic president elections (365-day term)
Treasury	3 spend lanes: small / voted / 2-of-N emergency
Census	Soulbound proof-of-attendance / proof-of-residence stamps
AccessGate	Bidirectional NFT-gated real-world access (Chainlink hook)

10 end-to-end Hardhat tests covering every flow in the spec.

Frontend (/src)

Next.js 14 (App Router), TypeScript, Tailwind, RainbowKit + wagmi (Base + Base Sepolia).

Routes:

/                                    landing + legitimacy meter
/parties                             search/sort/filter
/parties/[id]                        Twitter/Farcaster-style party page
/parties/[id]/dashboard              president-only: cabinet, norms, disputes, treasury
/parties/[id]/election               streaming election or past results
/parties/[id]/proposals/[pid]        vote + I Voted NFT mint screen
/parties/[id]/proposals/new
/parties/new                         universal candidacy form
/feed                                global Twitter-like activity stream
/profile                             multi-party franchises + NFT collection
/join-quiz                           ideology quiz → party match

Run locally

# Frontend
pnpm install
pnpm dev

# Contracts
cd contracts
pnpm install
pnpm compile
pnpm test

Try the full flow locally (no wallet extension needed)

cd contracts && pnpm install && pnpm compile && pnpm node     # terminal 1: local chain
cd contracts && pnpm deploy:local && pnpm e2e:local            # terminal 2: deploy + seed + self-test
echo NEXT_PUBLIC_CHAIN=local > .env.local && pnpm dev          # terminal 3: app

Connect with Local dev wallet (Hardhat account #1), open a party, hit Apply: Follow, Fund (test USDC faucet + approve dues), Franchise (grant scopes, vote for the slate). Each step is a real transaction; the I Voted receipt is a real soulbound NFT with an onchain SVG. Revoke from your profile. Founding a party from /parties/new runs createParty, registerFranchise, founder join, and opens the slate vote.

What is onchain: parties, presidents, member counts, franchise terms, grants, scopes, dues escrow, slate votes, I Voted receipts, revocation. What is still seeded demo content: posts, avatars, ideology vectors, events, the feed, the quiz, elections, the president dashboard.

Deploy contracts (Base Sepolia)

cd contracts
cp ../.env.example ../.env  # set DEPLOYER_PRIVATE_KEY + BASE_SEPOLIA_RPC_URL
pnpm deploy:sepolia   # also writes src/lib/chain/deployments.json

Addresses are written to contracts/deployed-addresses.json.

Sister project

interneta.world: the network state.

---

The financial crisis of 2008 motivated cryptocurrency. The political crisis of 2024 motivates technodemocracy.

License

MIT. See LICENSE. Fork it, run your own party, send a pull request.