From e5af69de7672b3794208673e6f3e832fd4249353 Mon Sep 17 00:00:00 2001 From: Ladd Hoffman Date: Sun, 19 May 2024 16:24:23 -0500 Subject: [PATCH] formatting --- specification/docs/requirements.md | 50 ++++++++++++++++-------------- 1 file changed, 27 insertions(+), 23 deletions(-) diff --git a/specification/docs/requirements.md b/specification/docs/requirements.md index d9f2bf7..6eeed82 100644 --- a/specification/docs/requirements.md +++ b/specification/docs/requirements.md @@ -130,58 +130,62 @@ To achieve such a process, we introduce a Proposal mechanism. The proposal must In the Executive governance section we outline how the DAO polices the REP minting process, and the Legislative governance section we outline how the DAO may modify the rules by which it operates. Now, we need to consider that as the DAO develops new rules, it may wish to reevaluate past REP 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. +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. +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 +1. Anyone may add a Post to the Forum -- A Post must have a unique identifier. +1. A Post must have a unique identifier. - - The Post ID should be a content hash. + 1. The Post ID should be a content hash. - - The Post ID should correspond to an off-chain record housing the Post's content. + 1. The Post ID should correspond to an off-chain record housing the Post's content. -- A Post must have one or more authors. +1. A Post must have one or more authors. - - Each author is identified by their Wallet address. + 1. Each author is identified by their Wallet address. - - Each author has a weight. Author weights must sum to 100%. + 1. Each author has a weight. Author weights must sum to 100%. -- A Post may include zero or more references. +1. A Post may include zero or more references. - - Each reference must include a weight between -1 and 1. + 1. Each reference must include a weight between -1 and 1. - - Sum of negative weights must be >= -1. + 1. Sum of negative weights must be >= -1. - - Sum of positive weights must be <= 1. + 1. Sum of positive weights must be <= 1. - - A Post may reference the Incinerator with 0 <= weight <= 1. + 1. A Post may reference the Incinerator with 0 <= weight <= 1. -This Forum reference mechanism enables executing any conceivable change in the REP awarded to Posts and their authors. + This Forum reference mechanism enables executing any conceivable change in the REP awarded to Posts and their authors. -When a Validation Pool targeting a given Post is accepted, +1. When a Validation Pool targeting a given Post is accepted, -1. The REP that was minted and staked in favor of the VP is transferred to the target Post. + 1. The REP that was minted and staked in favor of the VP is transferred to the target Post. -1. For each Post referenced by the target post, a fraction of the incoming Reputation given by the weight of that reference, is transferred to the referenced post; and so on, recursively, until the Reference Chain Limit is reached. + 1. For each Post referenced by the target Post, a fraction of the incoming Reputation given by the weight of that reference, is transferred to the referenced Post; and so on, recursively, until the Reference Chain Limit is reached. - 1. Positve references donate REP + 1. Positve references donate REP - 1. Negative references leach REP + 1. Negative references leach REP - 1. Negative references have the power to undo the effects of prior references, but a negative reference may not cause a post to lose more Reputation than it had previously gained. + 1. Negative references have the power to undo the effects of prior references, but a negative reference may not cause a Post to lose more REP than it had previously gained. -1. Remaining Reputation after is transferred to the authors of the + 1. Remaining Reputation after donation and leaching, is transferred to the authors of the Post in proportion to their author weights. + + 1. A Post does not retain ownership of any REP + + 1. The REP value of a Post is defined as the amount of Reputation that its authors have gained via that Post. ## Rollup -As described above, in order for REP and fees to be distributed to DAO members, an on-chain Validation Pool must be executed. However, network gas fees must be payed every time a contract is called. Therefore a DAO may wish to batch multiple Posts and the Validation Pools targeting those posts into one consolidated Rollup Post and a single Validation Pool targeting that Rollup Post. To accomplish this, we introduce a Rollup contract. +As described above, in order for REP and fees to be distributed to DAO members, an on-chain Validation Pool must be executed. However, network gas fees must be payed every time a contract is called. Therefore a DAO may wish to batch multiple Posts and the Validation Pools targeting those Posts, into one consolidated Rollup Post and a single Validation Pool targeting that Rollup Post. To accomplish this, we introduce a Rollup contract. The Rollup contract can be thought of as a specialized form of Work Contract (WSC), as it uses the same Availability stakes mechanism to select a batch worker.