fix: add ccip-025 implementation draft

Linked to citycoins/governance#47 and citycoins/governance#48

Clarinet.toml

@@ -201,6 +201,11 @@ path = "contracts/proposals/ccip019-pox-4-stacking.clar"
 clarity_version = 2
 epoch = 2.5
 
+[contracts.ccip025-extend-sunset-period-3]
+path = "contracts/proposals/ccip025-extend-sunset-period-3.clar"
+clarity_version = 2
+epoch = 2.5
+
 # CITYCOINS PROTOCOL TRAITS
 
 [contracts.extension-trait]

contracts/proposals/ccip025-extend-sunset-period-3.clar

@@ -0,0 +1,276 @@
+;; TRAITS
+
+(impl-trait .proposal-trait.proposal-trait)
+(impl-trait .ccip015-trait.ccip015-trait)
+
+;; ERRORS
+
+(define-constant ERR_PANIC (err u25000))
+(define-constant ERR_VOTED_ALREADY (err u25001))
+(define-constant ERR_NOTHING_STACKED (err u25002))
+(define-constant ERR_USER_NOT_FOUND (err u25003))
+(define-constant ERR_PROPOSAL_NOT_ACTIVE (err u25004))
+(define-constant ERR_PROPOSAL_STILL_ACTIVE (err u25005))
+(define-constant ERR_NO_CITY_ID (err u25006))
+(define-constant ERR_VOTE_FAILED (err u25007))
+(define-constant ERR_SAVING_VOTE (err u25008))
+
+;; CONSTANTS
+
+(define-constant SELF (as-contract tx-sender))
+(define-constant CCIP_025 {
+  name: "Extend Direct Execute Sunset Period 3",
+  link: "https://github.com/citycoins/governance/blob/feat/add-ccip-025/ccips/ccip-025/ccip-025-extend-direct-execute-sunset-period-3.md",
+  hash: "TBD",
+})
+
+(define-constant VOTE_SCALE_FACTOR (pow u10 u16)) ;; 16 decimal places
+(define-constant SUNSET_BLOCK u199668)
+
+;; set city ID
+(define-constant MIA_ID (default-to u1 (contract-call? .ccd004-city-registry get-city-id "mia")))
+
+;; DATA VARS
+
+;; vote block heights
+(define-data-var voteActive bool true)
+(define-data-var voteStart uint u0)
+(define-data-var voteEnd uint u0)
+
+(var-set voteStart block-height)
+
+;; vote tracking
+(define-data-var yesVotes uint u0)
+(define-data-var yesTotal uint u0)
+(define-data-var noVotes uint u0)
+(define-data-var noTotal uint u0)
+
+;; DATA MAPS
+
+(define-map CityVotes
+  uint ;; city ID
+  { ;; vote
+    totalAmountYes: uint,
+    totalAmountNo: uint,
+    totalVotesYes: uint,
+    totalVotesNo: uint,
+  }
+)
+
+(define-map UserVotes
+  uint ;; user ID
+  { ;; vote
+    vote: bool,
+    mia: uint,
+  }
+)
+
+;; PUBLIC FUNCTIONS
+
+(define-public (execute (sender principal))
+  (begin
+    ;; check vote complete/passed
+    (try! (is-executable))
+    ;; update vote variables
+    (var-set voteEnd block-height)
+    (var-set voteActive false)
+    ;; extend sunset height in ccd001-direct-execute
+    (try! (contract-call? .ccd001-direct-execute set-sunset-block SUNSET_BLOCK))
+    (ok true)
+  )
+)
+
+(define-public (vote-on-proposal (vote bool))
+  (let
+    (
+      (voterId (unwrap! (contract-call? .ccd003-user-registry get-user-id contract-caller) ERR_USER_NOT_FOUND))
+      (voterRecord (map-get? UserVotes voterId))
+    )
+    ;; check if vote is active
+    (asserts! (is-vote-active) ERR_PROPOSAL_NOT_ACTIVE)
+    ;; check if vote record exists for user
+    (match voterRecord record
+      ;; if the voterRecord exists
+      (let
+        (
+          (oldVote (get vote record))
+          (miaVoteAmount (get mia record))
+        )
+        ;; check vote is not the same as before
+        (asserts! (not (is-eq oldVote vote)) ERR_VOTED_ALREADY)
+        ;; record the new vote for the user
+        (map-set UserVotes voterId
+          (merge record { vote: vote })
+        )
+        ;; update vote stats for MIA
+        (update-city-votes MIA_ID miaVoteAmount vote true)
+        ;; print voter info
+        (print {
+          notification: "vote-on-ccip-025", 
+          payload: (get-voter-info voterId)
+        })
+        (ok true)
+      )
+      ;; if the voterRecord does not exist
+      (let
+        (
+          (miaVoteAmount (scale-down (default-to u0 (get-mia-vote voterId true))))
+        )
+        ;; check that the user has a positive vote
+        (asserts! (> miaVoteAmount u0) ERR_NOTHING_STACKED)
+        ;; insert new user vote record
+        (asserts! (map-insert UserVotes voterId {
+          vote: vote,
+          mia: miaVoteAmount
+        }) ERR_SAVING_VOTE)
+        ;; update vote stats for MIA
+        (update-city-votes MIA_ID miaVoteAmount vote false)
+        ;; print voter info
+        (print {
+          notification: "vote-on-ccip-025", 
+          payload: (get-voter-info voterId)
+        })
+        (ok true)
+      )
+    )
+  )
+)
+
+;; READ ONLY FUNCTIONS
+
+(define-read-only (is-executable)
+  (begin
+    ;; check that there is at least one vote
+    (asserts! (or (> (var-get yesVotes) u0) (> (var-get noVotes) u0)) ERR_VOTE_FAILED)
+    ;; check that yes total is more than no total
+    (asserts! (> (var-get yesTotal) (var-get noTotal)) ERR_VOTE_FAILED)
+    (ok true)
+  )
+)
+
+(define-read-only (is-vote-active)
+  (var-get voteActive)
+)
+
+(define-read-only (get-proposal-info)
+  (some CCIP_025)
+)
+
+(define-read-only (get-vote-period)
+  (if (and
+    (> (var-get voteStart) u0)
+    (> (var-get voteEnd) u0))
+    ;; if both are set, return values
+    (some {
+      startBlock: (var-get voteStart),
+      endBlock: (var-get voteEnd),
+      length: (- (var-get voteEnd) (var-get voteStart))
+    })
+    ;; else return none
+    none
+  )
+)
+
+(define-read-only (get-vote-total-mia)
+  (map-get? CityVotes MIA_ID)
+)
+
+(define-read-only (get-vote-total-mia-or-default)
+  (default-to { totalAmountYes: u0, totalAmountNo: u0, totalVotesYes: u0, totalVotesNo: u0 } (get-vote-total-mia))
+)
+
+(define-read-only (get-vote-totals)
+  (let
+    (
+      (miaRecord (get-vote-total-mia-or-default))
+    )
+    (some {
+      mia: miaRecord,
+      totals: {
+        totalAmountYes: (get totalAmountYes miaRecord),
+        totalAmountNo: (get totalAmountNo miaRecord),
+        totalVotesYes: (get totalVotesYes miaRecord),
+        totalVotesNo: (get totalVotesNo miaRecord),
+      }
+    })
+  )
+)
+
+(define-read-only (get-voter-info (id uint))
+  (map-get? UserVotes id)
+)
+
+;; MIA vote calculation
+;; returns (some uint) or (none)
+;; optionally scaled by VOTE_SCALE_FACTOR (10^6)
+(define-read-only (get-mia-vote (userId uint) (scaled bool))
+  (let
+    (
+      ;; MAINNET: MIA cycle 82 / first block BTC 838,250 STX 145,643
+      ;; cycle 2 / u4500 used in tests
+      (cycle82Hash (unwrap! (get-block-hash u4500) none))
+      (cycle82Data (at-block cycle82Hash (contract-call? .ccd007-citycoin-stacking get-stacker MIA_ID u2 userId)))
+      (cycle82Amount (get stacked cycle82Data))
+      ;; MAINNET: MIA cycle 83 / first block BTC 840,350 STX 147,282
+      ;; cycle 3 / u6600 used in tests
+      (cycle83Hash (unwrap! (get-block-hash u6600) none))
+      (cycle83Data (at-block cycle83Hash (contract-call? .ccd007-citycoin-stacking get-stacker MIA_ID u3 userId)))
+      (cycle83Amount (get stacked cycle83Data))
+      ;; MIA vote calculation
+      (scaledVote (/ (+ (scale-up cycle82Amount) (scale-up cycle83Amount)) u2))
+    )
+    ;; check that at least one value is positive
+    (asserts! (or (> cycle82Amount u0) (> cycle83Amount u0)) none)
+    ;; return scaled or unscaled value
+    (if scaled (some scaledVote) (some (/ scaledVote VOTE_SCALE_FACTOR)))
+  )
+)
+
+;; PRIVATE FUNCTIONS
+
+;; update city vote map
+(define-private (update-city-votes (cityId uint) (voteAmount uint) (vote bool) (changedVote bool))
+  (let
+    (
+      (cityRecord (default-to
+        { totalAmountYes: u0, totalAmountNo: u0, totalVotesYes: u0, totalVotesNo: u0 }
+        (map-get? CityVotes cityId)))
+    )
+    ;; do not record if amount is 0
+    (if (> voteAmount u0)
+      ;; handle vote
+      (if vote
+        ;; handle yes vote
+        (map-set CityVotes cityId {
+          totalAmountYes: (+ voteAmount (get totalAmountYes cityRecord)),
+          totalVotesYes: (+ u1 (get totalVotesYes cityRecord)),
+          totalAmountNo: (if changedVote (- (get totalAmountNo cityRecord) voteAmount) (get totalAmountNo cityRecord)),
+          totalVotesNo: (if changedVote (- (get totalVotesNo cityRecord) u1) (get totalVotesNo cityRecord))
+        })
+        ;; handle no vote
+        (map-set CityVotes cityId {
+          totalAmountYes: (if changedVote (- (get totalAmountYes cityRecord) voteAmount) (get totalAmountYes cityRecord)),
+          totalVotesYes: (if changedVote (- (get totalVotesYes cityRecord) u1) (get totalVotesYes cityRecord)),
+          totalAmountNo: (+ voteAmount (get totalAmountNo cityRecord)),
+          totalVotesNo: (+ u1 (get totalVotesNo cityRecord)),
+        })
+      )
+      ;; ignore calls with vote amount equal to 0
+      false)
+  )
+)
+
+;; get block hash by height
+(define-private (get-block-hash (blockHeight uint))
+  (get-block-info? id-header-hash blockHeight)
+)
+
+;; CREDIT: ALEX math-fixed-point-16.clar
+
+(define-private (scale-up (a uint))
+  (* a VOTE_SCALE_FACTOR)
+)
+
+(define-private (scale-down (a uint))
+  (/ a VOTE_SCALE_FACTOR)
+)