This is a dApp for running ad-hoc unofficial opinion polls for DAO members, or any other group.
The app is a fork of the Oasis Demo Voting App, which is in turn a fork of the OPL Secret Ballot.
This monorepo is set up for pnpm
. Install dependencies by running:
pnpm install
Move to the contracts
folder and build smart contracts:
pnpm build
Next, deploy the contract.
Move to the hardhat
folder and build smart contracts:
Start the hardhat node:
make build
Deploy smart contracts to that local network:
make deploy-localnet
You can use the --gaslessAccounts
and --gaslessFunds
parameters to set
the number of proxy accounts that can be used to pay for the gas for voters
and the amount of tokens each of those accounts will be initially funded.
The deployed DAO contract addresses will be stored
inside the frontend
folder's .env.development
, for example:
VITE_DAO_V1_ADDR=0x5FbDB2315678afecb367f032d93F642f64180aa3
To monitor accounts, use gv-topup
providing DAO address which will show the
balances:
pnpm hardhat --network localhost gv-topup --dryrun 0x5FbDB2315678afecb367f032d93F642f64180aa3
To specify minimum balance for gv-topup
use --min
, remove --dryrun
to
submit the transactions. For example, to top up the accounts so that each
account will have 10 tokens, run:
pnpm hardhat --network localhost gv-topup 0x5FbDB2315678afecb367f032d93F642f64180aa3 --min 10000000000
To add more signer accounts:
pnpm hardhat --network localhost gv-newkp 0x5FbDB2315678afecb367f032d93F642f64180aa3
Use --acl
deployment parameter to define the ACL contract policy to use. Supported
values:
AllowAllACLv1
: anyone can create a new poll, anyone can close any poll,
anyone can vote on any pollAllowVoterACLv1
: anyone can create a new poll, only contract authors can
close the poll, anyone can voteWhitelistVotersACLv1
: anyone can create a new poll, only contract authors
can close the poll, only whitelisted accounts can votenpx hardhat --network localhost deploy --acl AllowVoterACLv1
To whitelist voters for a specific ballot, gather the following information:
VITE_DAO_V1_ADDR
)PRIVATE_KEY
environment variable: export PRIVATE_KEY=0x...
Then, prepare a file containing whitelisted voters addresses, one per line. This list will overwrite any existing whitelisted users. For example:
0x8626f6940E2eb28930eFb4CeF49B2d1F2C9C1199
0xDce075E1C39b1ae0b75D554558b6451A226ffe00
Then, execute the following hardhat task:
npx hardhat --network localhost whitelist-voters 0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512 e386cceaa6ceea2f935d89951e522ac6d7ac777503b234d61b193439de571cfc voters.txt
Prepare your hex-encoded private key and store it as an environment variable:
export PRIVATE_KEY=0x...
To deploy the contracts to the Sapphire Localnet, Testnet or Mainnet, use the following commands respectively:
npx hardhat deploy --network sapphire-localnet
npx hardhat deploy --network sapphire-testnet
npx hardhat deploy --network sapphire
After compiling the backend, updating .env.development
with the corresponding
DAO address and chain ID, move to the frontend
folder to compile and
Hot-Reload frontend for Development:
pnpm dev
This will start the React app, using the contracts deployed to Sapphire Localnet.
Or, you can do:
pnpm dev-staging
This will also start the React app, but it will use the contracts deployed to Sapphire teestnet.
Whichever backend you want to you, after starting the React app, navigate to http://localhost:5173, and you should be able to create a new poll.
If running against localnet, you can use one of the deployed test accounts and associated private key with MetaMask. If you use the same MetaMask accounts on fresh local networks, don't forget to clear your account's activity each time or manually specify the correct account nonce.
You can build assets for deployment by running:
pnpm build
dist
folder will contain the generated HTML artifacts.
If you are running dApp on a non-root base dir, add
BASE_DIR=/my/public/path
to .env.production
and bundle the app with
pnpm build-only --base=/my/public/path/
Then copy the dist
folder to a place of your /my/public/path
location.
This is a demonstration project focused on the confidentiality features of the Oasis network. The smart contract, backend and frontend code is not audited neither can authors of this project, Oasis Foundation or Oasis Labs Inc. be held responsible for any security vulnerabilities, financial and/or data loss or theft.