Automatically merged updates to draft EIP(s) 1202

Hi, I'm a bot! This change was automatically merged because: - It only modifies existing Draft or Last Call EIP(s) - The PR was approved or written by at least one author of each modified EIP - The build is passing
2018-07-25 17:07:52 +04:00 · 2018-07-25 17:07:52 +04:00 · ae8c494d42
parent 4daebf1316
commit ae8c494d42
1 changed files with 107 additions and 10 deletions
--- a/EIPS/eip-1202.md
+++ b/EIPS/eip-1202.md
@ -1,7 +1,7 @@
 ---
 eip: 1202
 title: Voting Standard
-author: Zainan Victor Zhou (@xinbenlv), Evan (@evbots)
+author: Zainan Victor Zhou (@xinbenlv), Evan (@evbots), Yin Xu (@yingogobot)
 type: Standards Track
 category: ERC
 status: Draft
@ -9,13 +9,27 @@ created: 2018-07-08
 discussions-to: https://github.com/ethereum/EIPs/issues/1202
 ---

-Note: we are still open to have co-author to collaborate.
+## Note to Readers
+
+1. We are still open to have co-author to collaborate, in particular, we are looking for co-authors of the 
+following category:
+ - standard designers who are experienced in application-layer standard design, or 
+ - developers who have experience with blockchain-based voting system in practice
+ - researchers with research interest in crypto/zero-knowledge-proof voting
+ 
+
+2. We have two discussion destinations: 
+ - [Github Ethereum EIP Issue #1202](https://github.com/ethereum/EIPs/issues/1202) for long and more mature thoughts
+ - [Telegram Channel t.me/erc1202](https://t.me/erc1202) for real-time and related random chat.
+ 
+3. We are actively working on updating this draft as many feedbacks have come in since it merged into official EIP repo.
+If you are viewing a snapshot of this draft, please be adviced the latest dev version of ERC 1202 can be found [here](https://github.com/xinbenlv/eip-1202-draft/blob/master/EIP-1202.md)

 ## Simple Summary
 Propose a standard interface for voting.

 ## Abstract
-This proposal creates a standard API for implementing voting within smart contract. This standard provides basic functionality to voting as well as to view the vote result and set voting status.
+This proposal creates a standard API for implementing voting within smart contract. This standard provides functionalities to voting as well as to view the vote result and set voting status.

 ## Motivation
 Voting is one of the earliest example of EVM programming, and also a key to DAO/organizational governance process. We foresee many DAOs will ultimately need to leverage voting as one of the important part of their governance. By creating a voting standard for smart contract / token, we can have the following benefits
@ -121,8 +135,20 @@ We made the following design decisions and here are the rationales.
      * It's assumes for each individual address, they can only vote for one decision. They can distribute their available voting power into more granular level. If implementor wants allow this, they ask the user to create another wallet address and grant the new address certain power. For example, a token based voting where voting weight is determined by the amount of token held by a voter, a voter who wants to distribute its voting power in two different option(option set) can transfer some of the tokens to the new account and cast the votes from both accounts.
  
 - **Weight**: We assume there are `weight` of votes and can be checked by calling `weightOf(address addr)`, and the weight distribution is either internally determined or determined by constructor. However we have not been considering updating the weight distribution. Please comment on this design decision as we want to learn how likely an implementor would want to be able to update the voting weight distributions.  
+ 
+### Security and Privacy of Voting
+// TODO

-## Examples
+## Backward Compatibility
+There is no backward compatibility issue we are aware of.
+
+
+## Interactions with other ERCs
+// TODO add interaction discussion for the following ERCs
+ERC20, ERC721, ERC735, ERC780, ERC165
+
+
+## Simple Code Examples
 ### Example 1: Simplest Version: Single Issue Yes/No Question Per Smart Contract Address Per Non-Weighted Vote

 - [Source Code](https://github.com/xinbenlv/eip-1202-draft/blob/master/contracts/simple-version/SimplestVote1202.sol)
@ -136,6 +162,58 @@ We made the following design decisions and here are the rationales.
 - [Source Code](https://github.com/xinbenlv/eip-1202-draft/blob/master/contracts/advanced-version/AdvancedTokenVote1202.sol)
 - [Deployment (Ropsten)](https://ropsten.etherscan.io/address/0xfd8b3be5f9db4662d1c9269f948345b46e37fd26#code)

+## Comprehensive Application Examples
+
+### Example 1: Joint Wallet Account Spending Approval
+// TODO
+
+### Example 2: Secret Vote
+// TODO
+
+### Example 3: Token Re-issue
+// TODO
+
+### Example 4: Multi-input Oracle 
+// TODO
+
+
+## Case Study
+
+### Existing Voting Systems in Blockchain World
+// TODO
+
+#### Carbon Vote
+// TODO
+
+#### PLACE Voting
+https://medium.com/@jameson.quinn/how-place-voting-works-617a5e8ac422
+
+#### PLCR Voting
+[PLCR Voting: ](https://github.com/ConsenSys/PLCRVoting)
+https://medium.com/metax-publication/a-walkthrough-of-plcr-voting-in-solidity-92420bd5b87c
+
+#### 
+
+### Exiting Voting Systems in Real World
+// TODO
+
+#### Simple Majority Vote Requiring Quorum (e.g. Company Board)
+// TODO, and a small variant: ZaiGeZaiGu function committee approval (1/2 as quorum, majority vote)
+
+
+#### Two-tiered Shareholder Vote (e.g. GOOG, FB)
+// TODO
+
+#### Jury Decision of US Federal Criminal Court (All Ayle for Guity, 5/5 for Tie)
+// TODO
+
+#### US Presidential Election: Different Vote Time, Multi-Reginal, Two-level (General and Editorial(delegate))    
+// TODO
+
+#### Super-Girl China 2005: Idol Ranking Vote, Multiple Votes Allowed
+// TODO
+
+
 ## Summary of Discussions

 ### Early Feedback Questions (2018-07-08)
@ -166,6 +244,8 @@ Here are a few early questions I'd like to ask people here.
 - [EIP-20: ERC-20 Token Standard (a.k.a. ERC-20)](https://eips.ethereum.org/EIPS/eip-20)
 - [EIP-165: Standard Interface Detection](https://eips.ethereum.org/EIPS/eip-165)
 - [EIP-721: Non-Fungible Token Standard(a.k.a. ERC-721)](https://eips.ethereum.org/EIPS/eip-721)
+ - [EIP-735: ERC: Claim Holder](https://github.com/ethereum/EIPs/issues/735)
+ - [EIP-780: ERC: Ethereum Claims Registry](https://github.com/ethereum/EIPs/issues/780)
 - [EIP-777: A New Advanced Token Standard](https://eips.ethereum.org/EIPS/eip-777)
 - [EIP-897: ERC DelegateProxy](https://eips.ethereum.org/EIPS/eip-897)
 - [EIP-1155: Crypto Item Standard](https://eips.ethereum.org/EIPS/eip-1155)
@ -173,26 +253,43 @@ Here are a few early questions I'd like to ask people here.
 - [EIP-1167: Minimal Proxy Contract](https://eips.ethereum.org/EIPS/eip-1167)
 - [EIP-1203: Multi-class Token Standard(ERC-20 Extension)](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1203.md)

-### Related Projects
+### Worthnoting Projects
 - [Ethereum DAO: How to build a DEMOCRACY on the blockchain](https://www.ethereum.org/dao)
 - [Carbon Vote](http://carbonvote.com/)
+ - [Paper: A Smart Contract for Boardroom Voting with Maximum Voter Privacy](https://eprint.iacr.org/2017/110.pdf) - *Suggested by @aodhgan*
+ - [Private Voting for TCR](https://blog.enigma.co/private-voting-for-tcrs-with-enigma-b441b5d4fa7b)
+ 
+### Worthnoting Academic Papers

-### Request for Comment
+
+## Request for Comment
 We kindly request the community for comments, in particular, the following ERC and projects related authors:

 - ERC-20: @frozeman, @vbuterin
 - ERC-721: @fulldecent, Dieter Shirley, Jacob Evans, Nastassia Sachs
 - Carbon Vote: @lgn21st, @Aaaaaashu
- 
+ - Alex Van de Sande (Mist) and Nick Johnson (ENS) * - suggested by Fabian (@frozeman)*
+ - Will Warren, 0xProject a project who cares a lot about governance. * - nominated by Evan()@evanbots)*
+
 Your comments and suggestions will be greatly appreciated.

-## EIP WIP Work Logs
+## Acknowledgement
+The authors of EIP 1202 greatly appreciate the valuable input from distinguished community members including: @frozeman, @fulldecent, @bingen, @aodhgan.
+
+## EIP Work Logs

 - 2018-07-08: (@xinbenlv) Created early feedback request. Asked around discussion channels suggested in [EIP-1](https://eips.ethereum.org/EIPS/eip-1), such as [Ethereum-Magicians](https://ethereum-magicians.org/t/eip-x-voting-standard-early-feedback-wanted/670/2), [Gitter](https://gitter.im/ethereum/EIPs), [Reddit](https://www.reddit.com/r/ethereum/comments/8x6k11/early_feedback_request_for_eipx_voting_standard/)
- 2018-07-09: (@xinbenlv)Added examples layout. Request for co-author.
+- 2018-07-09: (@xinbenlv)Added examples outline. Request for co-author.
 - 2018-07-17: (@xinbenlv)Added co-author. @evbots, added two simple examples.
 - 2018-07-19: (@xinbenlv)Added interface-like specification. Moved content from [issue](https://github.com/ethereum/EIPs/issues/1202) to [xinbenlv's Github repo](https://github.com/xinbenlv/eip-1202-draft/blob/master/EIP-1202.md) . Added TokenVote example.
- 2018-07-20: (@xinbenlv)Added advanced token vote exmaple.
+- 2018-07-20: (@xinbenlv)Added advanced token vote example.
+- 2018-07-22: (@xinbenlv)Moved official discussion thread from [github issue](https://github.com/ethereum/EIPs/issues/1202) to [ethereum-magicians](https://ethereum-magicians.org/t/erc-1202-voting-standard-official-discussion-thread/670) - moved back  as it's ok to use GitHub issue as official discussion thread.
+- 2018-07-23: (@xinbenlv)
+  - added co-author Yin Xu (@yingogobot)
+  - added outline for a few applications and case studies for further drafting.
+  - added citation of ERC-735 and ERC-780
+- 2018-07-25: (@xinbenlv) Added input from @fulldecent, @bingen, @aodhgan to mention the privacy casting, PLCR etc, and
+added placeholders for related session.
 
 ## Copyright