A Next.js dashboard for monitoring and interacting with Aztec's on-chain governance contracts on Sepolia.

• Node.js 20+
• Yarn 1.22+ (pinned via .tool-versions for asdf)
• Foundry (forge) — required only for deploying/seeding contracts
• aztec-packages repo cloned as a sibling directory (../aztec-packages) — required only for deploying/seeding

yarn install
cp .env.local.example .env.local
# Fill in the required values (see Environment Variables below)
yarn dev

We recommend using direnv to manage environment variables per-directory. Install it, then create an .envrc file:

# Install direnv (macOS)
brew install direnv

# Add the hook to your shell (add to ~/.zshrc or ~/.bashrc)
eval "$(direnv hook zsh)"

# Create .envrc that loads .env.local
echo 'dotenv .env.local' > .envrc
direnv allow

This way .env.local values are automatically loaded into your shell, so scripts like deploy-test-governance.sh pick up PRIVATE_KEY and contract addresses without manual export commands.

Start the development server with Turbopack on http://localhost:3000.

Production build.

Run ESLint.

Fetch governance contract addresses from a running Aztec node and write them to .env.local.

# Use default testnet RPC
yarn get-l1-addresses

# Use a custom Aztec node
yarn get-l1-addresses http://localhost:8080

One-command local setup. Deploys governance contracts to Sepolia, seeds them with deposits and 5 test proposals, and updates .env.local — all in one step.

Requires: PRIVATE_KEY, Foundry (forge), ../aztec-packages checkout.

# Full setup with defaults (Sepolia)
PRIVATE_KEY=0x... yarn setup

# With custom paths/chain
PRIVATE_KEY=0x... AZTEC_PACKAGES_PATH=~/aztec-packages RPC_URL=http://localhost:8545 CHAIN_ID=31337 yarn setup

Deploy your own independent governance contract stack to Sepolia (or any EVM chain). Deploys 5 contracts: TestERC20, Registry, GSE, GovernanceProposer, and Governance with test-friendly parameters (60s voting delay, 5min voting window, open deposits).

Automatically updates .env.local with the new addresses.

Requires: PRIVATE_KEY, Foundry (forge), ../aztec-packages checkout.

# Deploy with defaults (Sepolia)
PRIVATE_KEY=0x... ./scripts/deploy-test-governance.sh

# Deploy to a different chain
PRIVATE_KEY=0x... RPC_URL=http://localhost:8545 CHAIN_ID=31337 ./scripts/deploy-test-governance.sh

Seed a deployed governance with token deposits and 5 test proposals using Forge. Creates TestPayload contracts on-chain with sample forum URIs.

Requires: PRIVATE_KEY, STAKING_ASSET_ADDRESS, GOVERNANCE_ADDRESS, Foundry (forge), ../aztec-packages checkout.

PRIVATE_KEY=0x... \
STAKING_ASSET_ADDRESS=0x... \
GOVERNANCE_ADDRESS=0x... \
./scripts/seed-governance.sh

TypeScript alternative for seeding. Mints tokens, approves, and deposits for voting power. Reads contract addresses from .env.local.

PRIVATE_KEY=0x... yarn seed-governance

Note: This script handles deposits only. To create proposals (which require deploying TestPayload contracts), use the Forge-based seed-governance.sh instead.

The fastest path from zero to a running dashboard:

# 1. Deploy + seed in one command
PRIVATE_KEY=0x... yarn setup

# 2. Start dashboard
yarn dev

# 3. Proposals become Active after 60s, then have a 5min voting window

# 1. Deploy your own governance stack
PRIVATE_KEY=0x... ./scripts/deploy-test-governance.sh

# 2. Seed with deposits + proposals
PRIVATE_KEY=0x... \
STAKING_ASSET_ADDRESS=0x... \
GOVERNANCE_ADDRESS=0x... \
./scripts/seed-governance.sh

# 3. Start dashboard
yarn dev

# .env.local already has the addresses from step 1
PRIVATE_KEY=0x... \
STAKING_ASSET_ADDRESS=$NEXT_PUBLIC_STAKING_ASSET_ADDRESS \
GOVERNANCE_ADDRESS=$NEXT_PUBLIC_GOVERNANCE_ADDRESS \
./scripts/seed-governance.sh

The deploy-test-governance.sh script deploys with these parameters: