TallyZero for Arbitrum DAO

Decentralized Governance Tracking for Arbitrum DAO

Upstream · Issues

What is this

A fork of TallyZero purpose-built for Arbitrum DAO governance. It uses the @gzeoneth/gov-tracker SDK to track the full proposal lifecycle across L1 and L2, from voting through timelock execution and retryable ticket redemption.

Key Features

• Dual-governor support — Core Governor (constitutional, 4.5% quorum) and Treasury Governor (funding, 3% quorum)
• Full lifecycle tracking — Tracks proposals through all stages: voting → L2 timelock → L1 challenge period → L1 timelock → retryable tickets → final execution
• Security Council election support — View and participate in Security Council member elections
• Zero backend — All data fetched directly from the blockchain via RPC; no centralized API dependency
• Bundled cache — Ships with pre-built tracking checkpoints for instant resume without RPC calls
• Delegate insights — Pre-indexed delegate cache with voting power rankings

Tech Stack

• Next.js 14 (App Router, static export)
• TypeScript / React
• Ethers.js v5
• Wagmi v2 + Reown AppKit (wallet connection)
• @arbitrum/sdk (L1↔L2 message tracking)
• @gzeoneth/gov-tracker (proposal lifecycle + delegate indexing)
• TanStack Table + React Query
• Radix UI + Shadcn + Tailwind CSS

Getting Started

# Install dependencies
yarn

# Create .env.local with your Reown (WalletConnect) project ID
echo 'NEXT_PUBLIC_REOWN_PROJECT_ID=<your-id>' > .env.local

# Start dev server
yarn dev

Get a project ID from WalletConnect Cloud.

Commands

yarn dev        # Development server (port 3000)
yarn build      # Production build (static export)
yarn lint       # ESLint with auto-fix
yarn test       # Lint + typecheck + Vitest

License

See upstream TallyZero repository.