Motivation # In open p2p protocol there is an issue with voting off-chain as there is much room for malicious peers to only include votes that support their case when submitting votes to chain.
Motivation # In open p2p protocol there is an issue with voting off-chain as there is much room for malicious peers to only include votes that support their case when submitting votes to chain.
</ul><p>This spec is a proposition for a voting protocol over Waku V2.</p>
<h1id="motivation">
Motivation
<aclass="anchor"href="#motivation">#</a>
</h1>
<p>In open p2p protocol there is an issue with voting off-chain as there is much room for malicious peers to only include votes that support their case when submitting votes to chain.</p>
<p>Proposed solution is to aggregate votes over waku and allow users to submit votes to smart contract that aren’t already submitted.</p>
<h1id="smart-contract">
Smart contract
<aclass="anchor"href="#smart-contract">#</a>
</h1>
<p>Voting should be finalized on chain so that the finished vote is immutable.
Because of that, smart contract needs to be deployed.
When votes are submitted smart contract has to verify what votes are properly signed and that sender has correct amount of SNT.
When Vote is verified the amount of SNT voted on specific topic by specific sender is saved on chain.</p>
<h2id="double-voting">
Double voting
<aclass="anchor"href="#double-voting">#</a>
</h2>
<p>Smart contract should also keep a list of all signatures so that no one can send the same vote twice.
Another possibility is to allow each sender to only vote once.</p>
<h2id="initializing-vote">
Initializing Vote
<aclass="anchor"href="#initializing-vote">#</a>
</h2>
<p>When someone wants to initialize vote he has to send a transaction to smart contract that will create a new voting session.
When initializing a user has to specify type of vote (Addition, Deletion), amount of his initial SNT to submit and public key of community under vote.
Smart contract will return a ID which is identifier of voting session.
Also there will be function on Smart Contract that when given community public key it will return voting session ID or undefined if community isn’t under vote.</p>
<h1id="voting">
Voting
<aclass="anchor"href="#voting">#</a>
</h1>
<h2id="sending-votes">
Sending votes
<aclass="anchor"href="#sending-votes">#</a>
</h2>
<p>Sending votes is simple every peer is able to send a message to Waku topic specific to given application:</p>
</span></span><spanstyle="display:flex;"><span><spanstyle="color:#a6e22e">sender</span>: <spanstyle="color:#66d9ef">string</span><spanstyle="color:#75715e">// address of the sender
</span></span></span><spanstyle="display:flex;"><span><spanstyle="color:#75715e"></span><spanstyle="color:#a6e22e">vote</span>: <spanstyle="color:#66d9ef">string</span><spanstyle="color:#75715e">// vote sent eg. 'yes''no'
</span></span></span><spanstyle="display:flex;"><span><spanstyle="color:#75715e"></span><spanstyle="color:#a6e22e">sntAmount</span>: <spanstyle="color:#66d9ef">BigNumber</span><spanstyle="color:#75715e">//number of snt cast on vote
</span></span></span><spanstyle="display:flex;"><span><spanstyle="color:#75715e"></span><spanstyle="color:#a6e22e">sign</span>: <spanstyle="color:#66d9ef">string</span><spanstyle="color:#75715e">// cryptographic signature of a transaction (signed fields: sender,vote,sntAmount,nonce,sessionID)
</span></span></span><spanstyle="display:flex;"><span><spanstyle="color:#75715e"></span><spanstyle="color:#a6e22e">nonce</span>: <spanstyle="color:#66d9ef">number</span><spanstyle="color:#75715e">// number of votes cast from this address on current vote (only if we allow multiple votes from the same sender)
</span></span></span><spanstyle="display:flex;"><span><spanstyle="color:#75715e"></span><spanstyle="color:#a6e22e">sessionID</span>: <spanstyle="color:#66d9ef">number</span><spanstyle="color:#75715e">// ID of voting session
<p>Every peer that is opening specific voting session will listen to votes sent over p2p network, and aggregate them for a single transaction to chain.</p>
<h2id="submitting-to-chain">
Submitting to chain
<aclass="anchor"href="#submitting-to-chain">#</a>
</h2>
<p>Every peer that has aggregated at least one vote will be able to send them to smart contract.
When someone votes he will aggregate his own vote and will be able to immediately send it.</p>
<p>Peer doesn’t need to vote to be able to submit the votes to the chain.</p>
<p>Smart contract needs to verify that all votes are valid (eg. all senders had enough SNT, all votes are correctly signed) and that votes aren’t duplicated on smart contract.</p>
<h2id="finalizing">
Finalizing
<aclass="anchor"href="#finalizing">#</a>
</h2>
<p>Once the vote deadline has expired, the smart contract will not accept votes anymore.
Also directory will be updated according to vote results (community added to directory, removed etc.)</p>
