Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

CCIP-019: PoX 4 update #35

Merged
merged 23 commits into from
Aug 9, 2024
Merged
Changes from 6 commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
6dc9860
fix: add draft ccip-019
whoabuddy Jan 4, 2024
e829ec9
remove block height changes
friedger Mar 22, 2024
8aa1a02
Update backwards compatibility
friedger Mar 22, 2024
64bfb71
Merge branch 'main' into feat/add-ccip-019
friedger May 4, 2024
f2fb3a4
update to Stacks 2.5
friedger May 4, 2024
1e4c4b0
chore: clarify the distribution of rewards
friedger May 4, 2024
b202029
Update ccips/ccip-019/ccip-019-pox-4-stacking.md
friedger May 12, 2024
3cccf19
remove nyc, address comments
friedger May 13, 2024
35ed665
Update and rename ccip-019-pox-4-stacking.md to ccip-019-mia-pox-4-st…
friedger Jul 12, 2024
6a5fcb3
Update ccip-019-mia-pox-4-stacking.md
friedger Jul 12, 2024
490e121
Merge branch 'main' into feat/add-ccip-019
friedger Jul 15, 2024
f457594
Merge branch 'feat/add-ccip-019' of github.com:citycoins/governance i…
friedger Jul 15, 2024
0f36aeb
Update ccip-019-mia-pox-4-stacking.md
friedger Jul 21, 2024
5e0ca6a
clarify acceptance criteria
friedger Jul 21, 2024
372108e
fix: update title and file name
whoabuddy Jul 30, 2024
dc45a16
fix: update intro text
whoabuddy Jul 30, 2024
f01bb87
fix: add detail and update contract names
whoabuddy Jul 31, 2024
f480dad
fix: update delegated stacking and backwards compatibility
whoabuddy Jul 31, 2024
d4f9747
fix: reword vote criteria and reference implementation
whoabuddy Jul 31, 2024
35f80fa
fix: add vote calculation spreadsheet
whoabuddy Aug 1, 2024
c600b87
Merge pull request #42 from citycoins/fix/update-ccip-019
whoabuddy Aug 7, 2024
973846c
fix: add more detail about new treasury and delegation
whoabuddy Aug 8, 2024
214fb59
fix: update ccip status
whoabuddy Aug 8, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
68 changes: 68 additions & 0 deletions ccips/ccip-019/ccip-019-pox-4-stacking.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
# CCIP-019

## Preamble

| CCIP Number | 019 |
| ------------- | -------------------------------------- |
| Title | PoX 4 Stacking |
| Author(s) | Jason Schrader [email protected] |
| | Tim Butterfield [email protected] |
| | Friedger Müffke [email protected] |
| Consideration | Governance, Economic, Technical |
| Type | Standard |
| Status | Draft |
| Created | 2024-01-04 |
| License | BSD-2-Clause |
| Supplements | CCIP-006, CCIP-012, CCIP-013, CCIP-014 |
friedger marked this conversation as resolved.
Show resolved Hide resolved

## Introduction

With the Stacks Nakomoto release[^1], a new version of the PoX contract `.pox-4` was released. The previous versions of the PoX contracts are used by the treasury contracts to perform delegated stacking (STX).

The CCIP-020 has disabled stacking and mining City coin tokens. However, the future of the treasury has not been finalized. There is a strong opinion in the community to liquidate the treasury. The details will be described in CCIP-022.
friedger marked this conversation as resolved.
Show resolved Hide resolved

CCIP-022 can define to stop deelgated stacking. The treasury can be unlocked after each cycle.
friedger marked this conversation as resolved.
Show resolved Hide resolved

Based on the uncertainty of the details in CCIP-022, this CCIP intends to:

- update .pox-3 to .pox-4 for delegated stacking in city treasury contracts in continuation of the current delegated stacking process.
friedger marked this conversation as resolved.
Show resolved Hide resolved

## Specification

### Treasury Contracts

The current treasury contracts used with mining directly call the `.pox-3` contract, which was replaced with `.pox-4` in the Stacks 2.5 release[^1].

CCIP-019 will implement a new version of the treasury contract `ccd002-treasury-v3` that replaces `.pox-3` with `.pox-4`, as well as move the balances and perform the delegated stacking.

The pool operator send stacking rewards to a new reward-treasury contract. The community will vote on how to spend the stacking rewards in the future.
friedger marked this conversation as resolved.
Show resolved Hide resolved

> Note: this only affects the mining treasuries for each city, the addresses for the stacking treasuries will remain the same
friedger marked this conversation as resolved.
Show resolved Hide resolved

| City | Current | New |
| ---- | ------------------------- | ------------------------- |
| MIA | ccd002-treasury-mining-v2 | ccd002-treasury-mining-v3 |
| MIA | ccd002-treasury-stacking | _(no change)_ |
| NYC | ccd002-treasury-mining-v2 | ccd002-treasury-mining-v3 |
| NYC | ccd002-treasury-stacking | _(no change)_ |

### Proposal Voting

This proposal is a continuation of the current delegated stacking process and does not require a vote.
friedger marked this conversation as resolved.
Show resolved Hide resolved

## Backwards Compatibility

This CCIP only changes the treasury contract. All traits etc. are unchanged. The treasury continues to receive rewards.
friedger marked this conversation as resolved.
Show resolved Hide resolved

## Activation

The CCIP would be activate via direct execution defined in CCIP-001.

## Reference Implementations

The reference implementation is published in the protocol repo[^2].

## Footnotes

[^1]: https://stacks.org/halving-on-horizon-nakamoto
[^2]: https://github.com/citycoins/protocol/pull/67