feat(platform)!: decision proposals open masternode yes/no polls (PV15)

.codecov.yml

@@ -55,6 +55,7 @@ ignore:
   - "packages/keyword-search-contract/src/**"
   - "packages/app-connect-contract/src/**"
   - "packages/moderation-charters-contract/src/**"
+  - "packages/decision-proposals-contract/src/**"
   - "packages/masternode-reward-shares-contract/src/**"
   - "packages/token-history-contract/src/**"
   - "packages/wallet-utils-contract/src/**"

.github/package-filters/js-packages-direct.yml

@@ -16,6 +16,9 @@
 '@dashevo/moderation-charters-contract':
   - packages/moderation-charters-contract/**
 
+'@dashevo/decision-proposals-contract':
+  - packages/decision-proposals-contract/**
+
 '@dashevo/dashpay-contract':
   - packages/dashpay-contract/**
 

.github/package-filters/js-packages-no-workflows.yml

@@ -16,6 +16,9 @@
 '@dashevo/moderation-charters-contract': &moderation-charters-contract
   - packages/moderation-charters-contract/**
 
+'@dashevo/decision-proposals-contract': &decision-proposals-contract
+  - packages/decision-proposals-contract/**
+
 '@dashevo/dashpay-contract': &dashpay-contract
   - packages/dashpay-contract/**
 
@@ -43,6 +46,7 @@
   - *keyword-search-contract
   - *app-connect-contract
   - *moderation-charters-contract
+  - *decision-proposals-contract
   - packages/rs-platform-serialization/**
   - packages/rs-platform-serialization-derive/**
   - packages/rs-platform-value/**

.github/package-filters/js-packages.yml

@@ -22,6 +22,10 @@
   - .github/workflows/tests*
   - packages/moderation-charters-contract/**
 
+'@dashevo/decision-proposals-contract': &decision-proposals-contract
+  - .github/workflows/tests*
+  - packages/decision-proposals-contract/**
+
 '@dashevo/dashpay-contract': &dashpay-contract
   - .github/workflows/tests*
   - packages/dashpay-contract/**
@@ -55,6 +59,7 @@
   - *keyword-search-contract
   - *app-connect-contract
   - *moderation-charters-contract
+  - *decision-proposals-contract
   - packages/rs-platform-serialization/**
   - packages/rs-platform-serialization-derive/**
   - packages/rs-platform-value/**

.github/package-filters/rs-packages-direct.yml

@@ -28,6 +28,11 @@ moderation-charters-contract:
   - packages/moderation-charters-contract/schema/**
   - packages/moderation-charters-contract/Cargo.toml
 
+decision-proposals-contract:
+  - packages/decision-proposals-contract/src/**
+  - packages/decision-proposals-contract/schema/**
+  - packages/decision-proposals-contract/Cargo.toml
+
 dashpay-contract:
   - packages/dashpay-contract/src/**
   - packages/dashpay-contract/schema/**

.github/package-filters/rs-packages-no-workflows.yml

@@ -28,6 +28,11 @@ moderation-charters-contract: &moderation-charters-contract
   - packages/moderation-charters-contract/schema/**
   - packages/moderation-charters-contract/Cargo.toml
 
+decision-proposals-contract: &decision-proposals-contract
+  - packages/decision-proposals-contract/src/**
+  - packages/decision-proposals-contract/schema/**
+  - packages/decision-proposals-contract/Cargo.toml
+
 dashpay-contract: &dashpay-contract
   - packages/dashpay-contract/src/**
   - packages/dashpay-contract/schema/**
@@ -63,6 +68,7 @@ data-contracts: &data-contracts
   - *document-history-contract
   - *app-connect-contract
   - *moderation-charters-contract
+  - *decision-proposals-contract
 
 dpp: &dpp
   - packages/rs-dpp/**

.github/package-filters/rs-packages.yml

@@ -34,6 +34,12 @@ moderation-charters-contract: &moderation-charters-contract
   - packages/moderation-charters-contract/schema/**
   - packages/moderation-charters-contract/Cargo.toml
 
+decision-proposals-contract: &decision-proposals-contract
+  - .github/workflows/tests*
+  - packages/decision-proposals-contract/src/**
+  - packages/decision-proposals-contract/schema/**
+  - packages/decision-proposals-contract/Cargo.toml
+
 dashpay-contract: &dashpay-contract
   - .github/workflows/tests*
   - packages/dashpay-contract/src/**
@@ -75,6 +81,7 @@ data-contracts: &data-contracts
   - *document-history-contract
   - *app-connect-contract
   - *moderation-charters-contract
+  - *decision-proposals-contract
 
 dpp: &dpp
   - .github/workflows/tests*

.github/package-filters/test-suite-triggers.yml

@@ -32,6 +32,7 @@ run:
   - packages/keyword-search-contract/**
   - packages/app-connect-contract/**
   - packages/moderation-charters-contract/**
+  - packages/decision-proposals-contract/**
   - packages/wallet-utils-contract/**
   # Local network scripts and action
   - .github/actions/local-network/**

.github/workflows/tests-rs-workspace.yml

@@ -480,6 +480,7 @@ jobs:
             --package keyword-search-contract \
             --package app-connect-contract \
             --package moderation-charters-contract \
+            --package decision-proposals-contract \
             --all-features \
             --locked \
             -E '(not test(~shield) or (package(=platform-wallet-storage) and not test(~wallet::shielded::))) and (not binary_id(=drive-abci::strategy_tests) or test(~comprehensive_mixed_operations) or test(~process_proposal_collision))'

.github/workflows/tests.yml

@@ -352,6 +352,7 @@ jobs:
               - packages/swift-sdk/**
               - packages/app-connect-contract/**
               - packages/moderation-charters-contract/**
+              - packages/decision-proposals-contract/**
               - packages/dapi-grpc/**
               - packages/dashpay-contract/**
               - packages/data-contracts/**

Cargo.toml

@@ -40,6 +40,7 @@ members = [
     "packages/keyword-search-contract",
     "packages/app-connect-contract",
     "packages/moderation-charters-contract",
+    "packages/decision-proposals-contract",
     "packages/rs-sdk-ffi",
     "packages/wasm-drive-verify",
     "packages/dash-platform-balance-checker",

Dockerfile

@@ -213,7 +213,7 @@
 ARG SCCACHE_BUCKET
 ARG AWS_PROFILE
 ARG SCCACHE_REGION
 ARG SCCACHE_S3_KEY_PREFIX
 ARG SCCACHE_ENDPOINT
 
 # Generate sccache configuration variables and save them to /root/env
@@ -405,6 +405,7 @@
     packages/keyword-search-contract \
     packages/app-connect-contract \
     packages/moderation-charters-contract \
+    packages/decision-proposals-contract \
     packages/data-contracts \
     packages/strategy-tests \
     packages/simple-signer \
@@ -530,6 +531,7 @@
     packages/keyword-search-contract \
     packages/app-connect-contract \
     packages/moderation-charters-contract \
+    packages/decision-proposals-contract \
     packages/withdrawals-contract \
     packages/masternode-reward-shares-contract \
     packages/dpns-contract \
@@ -716,6 +718,7 @@
     packages/keyword-search-contract \
     packages/app-connect-contract \
     packages/moderation-charters-contract \
+    packages/decision-proposals-contract \
     packages/masternode-reward-shares-contract \
     packages/dpns-contract \
     packages/data-contracts \
@@ -863,6 +866,7 @@
 COPY --from=build-dashmate-helper /platform/packages/keyword-search-contract packages/keyword-search-contract
 COPY --from=build-dashmate-helper /platform/packages/app-connect-contract packages/app-connect-contract
 COPY --from=build-dashmate-helper /platform/packages/moderation-charters-contract packages/moderation-charters-contract
+COPY --from=build-dashmate-helper /platform/packages/decision-proposals-contract packages/decision-proposals-contract
 COPY --from=build-dashmate-helper /platform/packages/withdrawals-contract packages/withdrawals-contract
 COPY --from=build-dashmate-helper /platform/packages/masternode-reward-shares-contract packages/masternode-reward-shares-contract
 COPY --from=build-dashmate-helper /platform/packages/dpns-contract packages/dpns-contract
@@ -968,6 +972,7 @@
     packages/keyword-search-contract \
     packages/app-connect-contract \
     packages/moderation-charters-contract \
+    packages/decision-proposals-contract \
     packages/withdrawals-contract \
     packages/masternode-reward-shares-contract \
     packages/dpns-contract \

book/src/architecture/overview.md

@@ -281,7 +281,7 @@ Here is a simplified view of every Rust workspace member, grouped by role:
 | **gRPC definitions** | `dapi-grpc` |
 | **WASM bindings** | `wasm-dpp`, `wasm-dpp2`, `wasm-sdk`, `wasm-drive-verify` |
 | **iOS/FFI** | `rs-sdk-ffi` |
-| **System contracts** | `dpns-contract`, `dashpay-contract`, `withdrawals-contract`, `masternode-reward-shares-contract`, `wallet-utils-contract`, `token-history-contract`, `keyword-search-contract`, `document-history-contract`, `app-connect-contract`, `moderation-charters-contract`, `data-contracts` |
+| **System contracts** | `dpns-contract`, `dashpay-contract`, `withdrawals-contract`, `masternode-reward-shares-contract`, `wallet-utils-contract`, `token-history-contract`, `keyword-search-contract`, `document-history-contract`, `app-connect-contract`, `moderation-charters-contract`, `decision-proposals-contract`, `data-contracts` |
 | **Tooling** | `dashmate` (JS), `strategy-tests`, `simple-signer`, `check-features`, `json-schema-compatibility-validator` |
 | **Other** | `dash-platform-macros`, `rs-dash-event-bus`, `rs-platform-wallet`, `dash-platform-balance-checker`, `rs-dapi` |
 

book/src/error-handling/error-codes.md

@@ -61,6 +61,7 @@ Error codes are organized into ranges that correspond to error categories and su
 | 10800-10818 | Address | `TransitionOverMaxInputsError` (10800), `WithdrawalBelowMinAmountError` (10818) |
 | 10819-10827 | Shielded | `ShieldedNoActionsError` (10819), `ShieldedTooManyActionsError` (10825), `ShieldedImplicitFeeCapExceededError` (10826), `ShieldedInvalidDenominationError` (10827 — `IdentityCreateFromShieldedPool` exit amount not a member of the versioned denomination set) |
 | 10900-10949 | Contract Moderation | `InvalidContractModerationConfigError` (10900), `ContractModerationSelfTargetError` (10901), `DocumentActionFeesWithoutModerationError` (10902), `ContractModerationReasonTooLongError` (10903), `InvalidContractModerationReasonDocumentsError` (10904), `InvalidContractModerationDocumentFieldsError` (10905) |
+| 11100-11149 | Decision Proposals | `DecisionProposalFundMismatchError` (11100), `InvalidDecisionProposalRuleError` (11101) |
 
 ### SignatureError codes (20000-20012)
 
@@ -119,6 +120,7 @@ The fee category currently has a single code. The 30000 range is reserved for fu
 | 41000-41003 | Contract Groups | `ContractGroupAlreadyExistsError` (41000), `ContractGroupNotFoundError` (41001), `IdentityNotContractGroupOwnerOrAdminError` (41002), `ContractGroupAdminNotFoundError` (41003) |
 | 41100-41124 | Contract Moderation | `ContractModerationNotEnabledError` (41100), `IdentityNotContractModeratorError` (41101), `ContractUserBannedError` (41107), `ContractUserSuspendedError` (41108), `ContractModerationTargetNotFoundError` (41109), `ContractModeratorIdentityNotFoundError` (41110), `ContractFeesAlreadyClaimedThisEpochError` (41111), `ContractFeesNothingToClaimError` (41112), `ContractFeeClaimNotAllowedError` (41113), `ContractModerationCounterpartyBarredError` (41114), `DocumentTypeNotDeletableByModeratorsError` (41115), `DocumentModerationWindowElapsedError` (41116), `ContractUserNotWarnedError` (41117), `ContractUserWarningLimitReachedError` (41118), `ContractDocumentRemovalNotFoundError` (41119), `DocumentRestoreWindowElapsedError` (41120), `DocumentRestoreHashMismatchError` (41121), `ContractDocumentAlreadyRestoredError` (41122), `DocumentFieldNotChangeableByModeratorsError` (41123), `DocumentModeratorFieldNotWritableError` (41124) |
 | 41200-41299 | Contract Moderation Teams | `ContractModeratedDocumentTypeNotYetUsableError` (41200), `ContractModerationAbilityNotGrantedError` (41201), `ModerationCharterAddedModeratorLimitReachedError` (41202), `ModerationReasonNotListedError` (41203), `DocumentTypeNotDeletableOnceSettledError` (41204), `ContractModerationTeamNotSeatedError` (41205), `DocumentNotSettledError` (41206), `ContractTeamActionDoesNotExistError` (41207), `ContractTeamActionAlreadySignedError` (41208), `SettledDeletionNotRestorableError` (41209), `ContractTeamActionAlreadyCompletedError` (41210), `ContractTeamActionDocumentChangedError` (41211), `ContractTeamMemberAddedAfterDocumentError` (41212) |
+| 41300-41349 | Decision Proposals | `DecisionProposalEndDateOutOfRangeError` (41300) |
 
 Notice how the `DataTriggerError` sub-enum has its own `ErrorWithCode` implementation that the `StateError` delegates to:
 

book/src/fees/overview.md

@@ -151,15 +151,22 @@ contest's prefunded balance, each vote takes a fixed cost from it, and what is
 left when the contest ends is released as processing fees. The amounts are
 `VoteResolutionFundFees` in the fee version:
 
-| Component | Protocol versions 1 to 13 | Protocol version 14 |
-|---|---|---|
-| Contested document fund (DPNS and every other contest) | 0.2 Dash | 0.1 Dash |
-| Moderation election fund (an `electedCharter` application) | none exist | 0.5 Dash |
-| One vote | 0.0001 Dash | 0.00002 Dash |
-
-`required_vote_resolution_fund` in `rs-dpp` picks between the two funds; the
-schedules before 14 carry the contested document amount in the moderation
-field, so the choice changes nothing there.
+| Component | Protocol versions 1 to 13 | Protocol version 14 | Protocol version 15 |
+|---|---|---|---|
+| Contested document fund (DPNS and every other contest) | 0.2 Dash | 0.1 Dash | 0.1 Dash |
+| Moderation election fund (an `electedCharter` application) | none exist | 0.5 Dash | 0.5 Dash |
+| Decision proposal fund (a `proposal` on the decision proposals contract) | none exist | none exist | 0.5 Dash |
+| One vote | 0.0001 Dash | 0.00002 Dash | 0.00002 Dash |
+
+`required_vote_resolution_fund` in `rs-dpp` picks between the two contest
+funds; the schedules before 14 carry the contested document amount in the
+moderation field, so the choice changes nothing there.
+
+A decision proposal (see `docs/protocol/decision-proposals.md`) opens a yes/no
+vote poll rather than a contest, and its fund
+(`decision_proposal_fund_required_amount`, added in `FEE_VERSION4` for
+protocol version 15) prefunds that poll's votes the same way. The schedules
+before 15 carry 0 there, unread.
 
 ## User Fee Increase