diff --git a/README.md b/README.md index f6151d1d..cab99f09 100755 --- a/README.md +++ b/README.md @@ -74,4 +74,4 @@ General [Setup instructions](https://github.com/KomodoPlatform/Documentation/blo | MCL | [marmarachain](https://github.com/marmarachain/marmara) | [c675fcb](https://github.com/marmarachain/marmara/tree/c675fcb5bce34b6bb2ae8032109302a7473035cb) | [![dPOW Status](https://badges.komodo.earth/svg/MCL_badge.svg?maxAge=60)](https://komodostats.com) | dPoW-3p | | MIL | [mil](https://github.com/emc2foundation/mil) | [5df2e4d](https://github.com/emc2foundation/mil/tree/5df2e4d569e546c71e730aa85ad2a0813f3b6369) | [![dPOW Status](https://badges.komodo.earth/svg/MIL_badge.svg?maxAge=60)](https://komodostats.com) | dPoW-3P | | TOKEL | [tokel](https://github.com/TokelPlatform/tokel) | [f1fc997](https://github.com/TokelPlatform/tokel/tree/f1fc997c5b66ea53992c77a8478aa5a157c4fbc3) | [![dPOW Status](https://badges.komodo.earth/svg/TOKEL_badge.svg?maxAge=60)](https://komodostats.com) | dPoW-3P | -| VRSC | [verus](https://github.com/VerusCoin/VerusCoin) | [25f82df](https://github.com/VerusCoin/VerusCoin/tree/25f82df12aee24c64681ca69ddd21ae19528fe25) | [![dPOW Status](https://badges.komodo.earth/svg/VRSC_badge.svg?maxAge=60)](https://komodostats.com) | dPoW-3P | +| VRSC | [verus](https://github.com/VerusCoin/VerusCoin) | [bdcad5e](https://github.com/VerusCoin/VerusCoin/tree/bdcad5eba2f26e6b78a0831fc1656ce8eadb156c) | [![dPOW Status](https://badges.komodo.earth/svg/VRSC_badge.svg?maxAge=60)](https://komodostats.com) | dPoW-3P | diff --git a/doc/bible.md b/doc/bible.md index dcff8b25..eaa2bca7 100644 --- a/doc/bible.md +++ b/doc/bible.md @@ -1,6 +1,6 @@ # Notary Node Bible v1.2 -Introduction: This is the Komodo Platform Notary Node Bible, a compendium with essential information, instructions, rules, policies, election procedures for the Komodo Notary Node network, links to other important documents, and more. This iteration of the NN bible comes into effect at the start of NN Season 6 (date TBA). Please read carefully. +Introduction: This is the Komodo Platform Notary Node Bible, a compendium with essential information, instructions, rules, policies, election procedures for the Komodo Notary Node network, links to other important documents, and more. This iteration of the NN bible comes into effect at the start of NN Season 7. Please read carefully. # @@ -13,7 +13,9 @@ 4. [Responsibilities of a NN](#responsibilities-rights-and-duties-of-a-notary-node-operator) 5. [Notary Node regions](#notary-node-regions) 6. [Guidelines, general information and policies](#guidelines-general-information-and-policies) -7. [Code of Conduct](#code-of-conduct) +7. [dPoW Inprovement Proposals](#dpow-improvement-proposals) +8. [Code of Conduct](#code-of-conduct) + # @@ -377,16 +379,48 @@ Operators are also encouraged to ask questions relating to setup and operation i - Bandwidth: 100 Mbps or higher -### Polls and Voting: +## dPoW Improvement Proposals -Polls are executed on Github in form of an issue ticket and voting takes place by posting a signed message with your selection. A poll will remain open for a minimum of 30 days before being subject to closing. The Third Party KMD key it to be used for the signing your vote. +The dPoW Improvement Proposals [DIPS](https://github.com/KomodoPlatform/dips/) repository serves as a platform to facilitate discussion, collaboration and the review of proposed changes to dPow and the notary node operations. We believe that having an open and transparent process helps foster good governance and trust between the Komodo community and our development teams. -Poll outcomes will be ratified and enacted if a majority of signatures supports the poll, provided there is participation of > 43 nodes (67%) +Any external collaborator pull requests to the dPoW repository should be accompanied by DIP to explain the proposed changes. DIPs can also be submitted to discuss rule changes to the Notary Node bible (this document). -The Komodo team reserves the right to amend this guideline (governing participation in the dPoW operations) at any time. Modifications are transparently published on Github. +Once a DIP has been submitted: + - There will be a minimum of 2 weeks for comments regarding a DIP to be given after which it may be closed, or may proceed to a vote in order to ratify or reject the proposal. + - Upcoming votes will be announced in the #notary-nodes channel on the Komodo Discord server a minimum of 2 weeks prior to the initiation of a vote. + - The voting period will run for one week, with any past or present notary node eligible to vote. + - Votes will be validated by the Komodo team, and the results will be announced in the #notary-nodes channel on the Komodo Discord server no later than one week after the voting period ends. + - Votes are allocated 1:1 for each address used to run a main server notary node, for each season it was in use. + - Votes are to be cast via a signed message, generated by the address used in a notary's main notary node, for each season in was in use. + - The vote schedule will be determined by a consensus of current DEV node notaries, with respect to the nature of the proposed changes and the time remaining until a hardfork. + - Proposals which only attract 20 votes or less will be considered invalid, and the proposal rejected. + - Votes which attract at least 21 votes, but less than 33 votes will require a 2/3rds majority be considered valid. If this threshold is not achieved, the proposal will be reset and a new vote scheduled. -
+Signed messages must conform to the following format to be considered valid: + +`{NOTARYNAME}_{REGION} S{SEASON_NUM} [supports|rejects] {DIP_NUM}` + +For example: +``` +$ komodo-cli signmessage RDragoNHdwovvsDLSLMiAEzEArAD3kq6FN "dragonhound_DEV S6 supports DIP0001" +> IDETpoMoWojS/bXCcLdMWyCRas1aL7NRnideIns0ega4HQYwJWjOfIv3hKNfSsZADxT+ZbWM2govNxCFh+esOtI= +``` + +The vote is then cast in the relevant DIP thread as a comment as below: +``` + Notary: dragonhound_DEV + Season: S6 + Address: RDragoNHdwovvsDLSLMiAEzEArAD3kq6FN + Message: "dragonhound_DEV S6 supports DIP0001" + Signature: IDETpoMoWojS/bXCcLdMWyCRas1aL7NRnideIns0ega4HQYwJWjOfIv3hKNfSsZADxT+ZbWM2govNxCFh+esOtI= +``` + +It can then be validated with: +``` +$ komodo-cli verifymessage RDragoNHdwovvsDLSLMiAEzEArAD3kq6FN "IDETpoMoWojS/bXCcLdMWyCRas1aL7NRnideIns0ega4HQYwJWjOfIv3hKNfSsZADxT+ZbWM2govNxCFh+esOtI=" "dragonhound_DEV S6 supports DIP0001"` +> true +``` ## Code of Conduct diff --git a/doc/changelog.md b/doc/changelog.md index db525e8c..5e0fa056 100644 --- a/doc/changelog.md +++ b/doc/changelog.md @@ -1,5 +1,10 @@ # Changelog +## 0.7.7 + +- Updates VRSC to [`bdcad5e`](https://github.com/VerusCoin/VerusCoin/tree/bdcad5eba2f26e6b78a0831fc1656ce8eadb156c) +- Updates Seednodes API version to [``]() + ## 0.7.6 - Updates VRSC to [`25f82df`](https://github.com/VerusCoin/VerusCoin/tree/25f82df12aee24c64681ca69ddd21ae19528fe25) diff --git a/doc/seed_version_epochs.json b/doc/seed_version_epochs.json index 5204fd5e..692c37c2 100644 --- a/doc/seed_version_epochs.json +++ b/doc/seed_version_epochs.json @@ -19,6 +19,10 @@ }, "371595d6c": { "version": "1.0.4", + "end": "TBA" + }, + "": { + "version": "1.1.0", "end": 1987654321 } } diff --git a/doc/update077.md b/doc/update077.md new file mode 100644 index 00000000..0667bb12 --- /dev/null +++ b/doc/update077.md @@ -0,0 +1,64 @@ +### dPoW 0.7.7 update information + +- On your 3P node, update your Verus Coin's codebase to [`bdcad5e`](https://github.com/VerusCoin/VerusCoin/tree/bdcad5eba2f26e6b78a0831fc1656ce8eadb156c), build it and then restart it. + +#### If using smk's docker setup + +```bash +cd notary_docker_3p +git pull +./update vrsc # supply sudo password when asked +./start vrsc +./update mm2 # supply sudo password when asked +./start mm2 +``` + +#### If custom setup + +- Build Verus Coin + +```bash +vrsc_commit='bdcad5e' +cd ~/VerusCoin +git pull +git checkout ${vrsc_commit} +./zcutil/build.sh -j$(expr $(nproc) - 1) +``` + +- Restart it + +```bash +cd ~/VerusCoin/src +./verus stop +source ~/dPoW/iguana/pubkey.txt +./verusd -pubkey=$pubkey & +``` + +- Update your seednode + +```bash +cd ~/nn_mm2_seed +git pull +./update_mm2.sh +./update_conf.py +./run_mm2.sh && tail -f mm2.log +``` + +#### Update your dPoW repo + +```bash +cd ~/dPoW +git checkout master +git pull +``` + +Make sure your 3P iguana is running properly and notarising. +Confirm your MM2 node is running, your certificates are up to date, and your node is finding peers on netID 8762. + +```bash +sudo apt install snapd +sudo snap install certbot --classic +sudo certbot certonly -d ${DOMAIN} +# or, if certs exist already +sudo certbot renew +``` diff --git a/iguana/version b/iguana/version index c0062185..879be8a9 100644 --- a/iguana/version +++ b/iguana/version @@ -1 +1 @@ -0.7.6 +0.7.7