TallyZero for ArbitrumDAO

Decentralized Governance Tracking for ArbitrumDAO

Upstream · Issues

What is this

A fork of TallyZero purpose-built for ArbitrumDAO 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) and Treasury Governor (funding)
• 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
• RPC-direct governance data. Proposals, delegates, lifecycle state, and Snapshot data are fetched directly from the blockchain or from CORS-enabled APIs. The only server-side code is a small first-party proxy used when importing a proposal description from the governance forum (which lacks CORS).
• 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 16 (App Router)
• 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
yarn lint       # ESLint with auto-fix
yarn test       # Lint + typecheck + Vitest

License

See upstream TallyZero repository.