judicial requirements

specification/docs/requirements.md

@@ -1,10 +1,14 @@
 ## Governance
 
-We identify three aspects of governence: Executive, Legislative, and Judicial. Executive governance is focused on the present, day to day operations of the DAO. Legislative governance is focused on the future, and deals with the process of making changes to the operations of the DAO. Judicial governance is focused on the past, providing an opportunity to review and interpret past actions.
+We identify three aspects of governence: Executive, Legislative, and Judicial. Executive governance is focused on the present, day to day operations of a DAO. Legislative governance is focused on the future, and deals with the process of making changes to the operations of a DAO. Judicial governance is focused on the past, providing an opportunity for a DAO to review and reinterpret past actions.
 
 ### Executive
 
-The day to day operations of the DAO are centered around Work Smart Contracts (WSC) and Validation Pools (VPs). Customers request work; the work is assigned to an available worker; the worker submits Work Evidence (WEV); and the Work Evidence is validated by the rest of the DAO in a Validation Pool.
+The day to day operations of a DAO are centered around Work Smart Contracts (WSC) and Validation Pools (VPs). Customers request work; the work is assigned to an available worker; the worker submits Work Evidence (WEV); and the Work Evidence is validated by the rest of the DAO in a Validation Pool.
+
+#### Validation Pool (VP)
+
+#### Work Smart Contract (WSC)
 
 1. A Worker must be able to stake availability toward a Work Contract (WSC), specifying the duration of their availability window.
 
@@ -24,4 +28,70 @@ The day to day operations of the DAO are centered around Work Smart Contracts (W
 
 ### Legislative
 
-### Judicial
+The DAO will need to be able to update the rules by which it operates, in order to respond to changing circumstances or goals. There will not always be unanimous consensus regarding what changes to make. Therefore, we need a legislative governance process that a DAO can use in order to progress from disagreement to agreement.
+
+To achieve such a process, we introduce a Proposal mechanism. The proposal must first reach a certain level of Attestation; then it must progress through a series of Referenda. If all Referenda are accepted, then the Proposal is accepted; otherwise the Proposal is rejected.
+
+#### Proposals
+
+1. Anyone may submit a Proposal
+
+    1. Note that, if desired, this requirement could be strengthened such that only a DAO member may submit a Proposal
+
+1. A DAO member may attest a certain amount of REP to indicate that they are aware of the proposal. The amount must be less than or equal to the DAO member's REP balance.
+
+1. Once the Proposal has reached 10% Attestation, meaning that 10% of the DAO's total supply of REP has been attested, the first Referendum shall be initiated. This referendum should be a Validation Pool that is 0% binding, with a quorum of 1/10 and a win ratio of 2/3.
+
+    1. If the Referendum does not meet quorum, then the Proposal is failed.
+
+    1. If the Referendum is rejected or does not meet a 50% participation rate, then the Referendum may be retried up to 3 times.
+
+1. If the first Referendum is accepted and meets a 50% participation rate, then a second Referendum shall be initiated. This referendum should be a Validation Pool that is 1% binding, with a quorum of 1/10 and a win ratio of 2/3.
+
+    1. If the Referendum does not meet quorum, then the Proposal is failed.
+
+    1. If the Referendum is rejected or does not meet a 50% participation rate, then the Referendum may be retried up to 3 times.
+
+1. If the second Referendum is accepted and meets a 50% participation rate, then a third Referendum shall be initiated. This referendum should be a Validation Pool that is 100% binding, with a quorum of 1/10 and a win ratio of 2/3.
+
+    1. If the Referendum does not meet quorum, then the Proposal is failed.
+
+    1. If the Referendum does not meet a 50% participation rate, then the Referendum may be retried up to 3 times.
+
+    1. If the Referendum is rejected, then the Proposal is failed.
+
+1. If the third Referendum is accepted and meets a 50% participation rate, then the Proposal is accepted.
+
+### Judicial
+
+Validation Pools mint and award Reputation (REP). REP can be used for voting, and entitles the holder to a share of DAO revenues in proportion to their REP balance. In the Executive governance section we outline how the DAO may police this REP minting process, and the Legislative governance section we outline the process by which the rules may be modified. Now, we need to consider that as the DAO develops new rules, it may wish to reevaluate past Reputation rewards in light of new perspectives.
+
+To achieve such reevaluation, we introduce the Forum reference mechanism. The Forum is a collection of Posts. A Post has a unique ID and one or more authors. A post may also include weighted references to other Posts. Each Validation Pool targets a given Post. When a VP is accepted, the minted REP percolates through the Forum, to the author(s) of the targeted Post, and recursively to the Posts referenced by the targeted Post, the Posts referenced by those Posts, and so on, up to a limit determined by the Reference Chain Limit parameter.
+
+Each reference may be positive or negative. A positive reference "donates" Reputation, while a negative reference "leaches" reputation.
+
+A Post may also reference the Incinerator. Any reputation donated to the Incinerator is burned. A post may not leach reputation from the Incinerator.
+
+#### Forum
+
+- Anyone may add a Post to the Forum
+
+    - A Post must have a unique identifier.
+    
+        - The Post ID should be a content hash.
+        
+        - The Post ID should correspond to an off-chain record housing the Post's content.
+
+    - A Post must have one or more authors.
+
+        - Each author is identified by their Wallet address.
+
+        - Each author has a weight. Author weights must sum to 100%.
+
+    - A Post may include zero or more references.
+
+        - Each reference must include a weight between -1 and 1.
+
+        - Sum of negative weights must be >= -1.
+
+        - Sum of positive weights must be <= 1.

specification/docs/terminology.md

@@ -17,4 +17,7 @@
 | Forum Post | A signed contribution with weighted citations |
 | Validation Pool (VP) | Takes CSPR/ETH and author stakes as input. Requires REP-weighted consensus. Mints and distributes REP; distributes CSPR/ETH. |
 | Work Evidence (WEV) | A forum post representing work that fulfills some work request(s) |
-| Work Smart Contract (WSC) | A contract that takes REP stakes from workers and CSPR/ETH from customers, and puts them toward a validation pool (VP) targeting work evidence (WEV). |
+| Work Smart Contract (WSC) | A contract that takes REP stakes from workers and CSPR/ETH from customers, and puts them toward a validation pool (VP) targeting work evidence (WEV). |
+| Proposal | A Post representing some proposed action or change, to be reviewed and approved/rejected by the DAO. |
+| Attestation | Assertion by a DAO member that they are aware of a given Proposal |
+| Referendum | An instance of a Validation Pool targeting a given Proposal |