Monorepo containing Cardano GovTool and supporting utilities
The Cardano GovTool enables ada holders to use the governance features described in CIP-1694: register as a DRep, delegate voting power, submit governance actions and vote on them.
Learn more; docs.gov.tools.
Working on the code with an AI coding agent: AGENTS.md at the root, and in govtool, govtool/frontend, govtool/govtool-backend and tests, is written for it.
GovTool backend is a NestJS service that serves governance data over REST. It reads chain data through a provider: DB-Sync following a Cardano Node, Koios, Blockfrost, or a frozen mainnet capture for local development.
GovTool frontend web app communicates with the backend over a REST interface, reading and displaying on-chain governance data. Frontend is able to connect to Cardano wallets over the CIP-30 and CIP-95 standards.
This repository includes a Docker Compose setup for running GovTool services locally. For local setup instructions, see the Docker Compose README.
To run without a Cardano node or DB-Sync, govtool/docker-compose.fixture.yml runs the backend on frozen mainnet data, with the frontend, metadata service and forum backend; its header lists the ports.
tests/devnet runs the whole stack on a local Cardano devnet, for tests that submit transactions.
Thanks for considering contributing and helping us on creating GovTool! 😎
Please checkout our Contributing Documentation.
Questions and setup help: SUPPORT.md.
Security vulnerabilities: follow SECURITY.md rather than opening a public issue.
Everyone participating is expected to follow the Code of Conduct.