qv-contracts
v0.0.2
Published
Quadratic Voting contracts
Downloads
1
Readme
Quadratic Voting Contracts
This project is about Ethereum smart contracts for running quadratic voting (QV). It can also be used as a starter to build more complicated QV applications with minimal anti-collusion infrastructure (MACI).
Getting started
Run tests
- Run
yarn
to install the dependencies - Run
yarn build
to compile the contracts and generate typechain files. - Run
yarn run test test/QuadraticVoting.ts
to run the tests.
Run scripts
- Run
yarn start
to start localhost network. - Run
yarn hardhat run scripts/maci-cycle/0-deploy.ts --network localhost
to deploy contracts. - Run
yarn hardhat run scripts/maci-cycle/6-genProofs.ts --network localhost
to generate proofs with docker-compose. (Note that you should have this maci docker image and the generated zkeys and witnesses.) - Run
./test/runScripts0-8.sh
to run through the cycle of maci.
How to design a QV application?
Quadratic voting is a way of making collective decisions, also a tool to elicit individual preferences over a given set of alternatives.
The idea is to associate a cost with a vote. Voters buy as many votes as they wish by paying the square of the votes they buy using some currency which is called “voice credit”. Each voter pays some voice credits for her votes, and a vote pricing rule is a quadratic function:
Cost to the voter = (Number of votes)^2
The cost to the voter, which is the the payment for votes, may be through either an artificial currency or real money. So our degree of freedom is the design of the voice credit and the way of applying the voting results.
There are two main considerations in designing a QV app:
- What's a unit of voice credit, how to distribute voice credits to the voters, and whether voters can retain voice credits for future votes?
- What functions do you want to execute according to the voting results?
Application: Quadratic Hackathon [WIP]
The prize pool will be split among winners pro-rata to the number of votes they received.