Skip to content
Liquid democracy smart contract implementation
Branch: master
Clone or download
Latest commit 77287c2 Jun 11, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
contracts 77 fix truffle compatibility issues and add README details Jun 9, 2018
dApp-Svr-Exp Merge pull request #94 from DemocracyEarth/77-consolidate-readmes Jun 11, 2018
images Added small content to README about delegation Mar 9, 2018
migrations 14 changed deployment scripts, they were failing on initial setup acc… Apr 18, 2018
src HOTFIX mistakenly moved files Mar 13, 2018
test Fix `describe` scopes Jun 6, 2018
.babelrc Add dependencies for async/await testing Apr 6, 2018
.gitignore 54 bower folder should be in another location May 10, 2018 Update start command Jun 11, 2018
package.json Add Heroku support and instructions May 4, 2018
truffle.js Add dependencies for async/await testing Apr 6, 2018

Liquid Democracy as a smart contract

🚨🚧 Everything in this repo is still a work in progress and higly experimental. It is not secure to use any of this code in production (mainnet) until proper security audits have been conducted.

This is a smart contract implementation (dapp) in the Ethereum blockchain of a liquid democracy with three initial main functionalities: vote(), delegate() and revoke(). It mainly consists of LiquidDemocracy.sol and its corresponding test file LiquidDemocracy.test.js. This is the starting point of a roadmap that seeks to bridge Sovereign app with blockchain features. Please make sure you check out the project board and the milestones for more information.

The most recent version of the dapp is available at For desktop usage, you will need Metamask and a Metamask-supported browser to be able to interact with it. For mobile usage, use a dapp browser / wallet like Toshi.


PRs and feedback are welcomed. A good place to start is to review the current open issues, please feel free to engage with us by commenting in a specific issue. Remember you can also check out the project board to understand what's being worked on now and what is coming up next.

Dapp development is discussed actively in the slack channel #developers in

The dapp consists of mailnly two elements, contracts and frontend, located respectively in the following folders:

  • contracts: Solidity contracts, to be deployed to a local or remote blockchain.
  • dApp-Srv-Exp: JS frontend built using npm, bower and http-server

Development dependencies

How to run

Compile, deploy and copy compiled contracts to frontend

Choose the environment. Use development for local environment (start ganache before) or ropsten for Ropsten Ethereum test network in remote environment.

$ npm install
$ truffle compile
$ truffle migrate --network [development / ropsten]
$ cp build/contracts/* dApp-Svr-Exp/contracts/

Start frontend

$ npm start


You will be able to access the dapp at http://localhost:8080 in development mode. Make sure to set Metamask to the right environment (private network or Ropsten), and also make sure to provision necessary gas for each case:

Local environment

Import private keys from Ganache into Metamask (Accounts -> Import account)

Remote environment

Use a Ropsten faucet. e.g.:

You can’t perform that action at this time.