Skip to content

Commit

Permalink
Merge pull request #106 from mrkara/master
Browse files Browse the repository at this point in the history
Testnet upgrade 1.5.3
  • Loading branch information
mrkara committed Sep 29, 2023
2 parents 3a25200 + 8c0bcbc commit cc6b7a2
Show file tree
Hide file tree
Showing 5 changed files with 107 additions and 0 deletions.
1 change: 1 addition & 0 deletions build.sh
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,7 @@ files=(
src/testnet/upgrade-1_4_13.md
src/testnet/upgrade-1_4_15.md
src/testnet/upgrade-1_5_2.md
src/testnet/upgrade-1_5_3.md
src/user-guides/SignerGuide.md
src/user-guides/Connect-a-Wallet.md
src/user-guides/Transfer-CSPR.md
Expand Down
1 change: 1 addition & 0 deletions docs/testnet/testnet-upgrades.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,7 @@
- [TestNet Upgrade to casper-node v1.4.13](upgrade-1_4_13.md)
- [TestNet Upgrade to casper-node v1.4.15](upgrade-1_4_15.md)
- [TestNet Upgrade to casper-node v1.5.2](upgrade-1_5_2.md)
- [TestNet Upgrade to casper-node v1.5.3](upgrade-1_5_3.md)


_Please note that the DEVxDAO's Casper Testnet program is implemented by the [DEVxDAO](https://devxdao.com) by providing rewards
Expand Down
55 changes: 55 additions & 0 deletions docs/testnet/upgrade-1_5_3.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
# Upgrade to casper-node v1.5.3

## Introduction and Timing
We are requesting that all Casper Testnet participants stage the upgrade of their nodes to a new version of `casper_node`
immediately, using the instructions below. "Staging an upgrade" is a process in which you tell your node to download
the upgrade files and prepare them, so that they can automatically be applied at the pre-defined activation point.

For this upgrade, to `casper-node v1.5.3`, the activation point is `Era 10827`, which will be approximately around:
* Monday October 02, 2023 at 14:28 UTC
* Monday October 02, 2023 at 10:28 EST
* Monday October 02, 2023 at 07:28 PST
* Monday October 02, 2023 at 16:28 EU/Zurich
* Monday October 02, 2023 at 22:28 HK

In order to not have points deducted for your Testnet reward score, you have to make sure you have properly staged the
upgrade well ahead of the activation point, so that your node will be upgraded on time.

## Upgrade Staging Instructions

The process to upgrade your node is very straightforward. Log in to your node, and execute the following two commands,
one by one:

```shell
sudo -u casper /etc/casper/node_util.py stage_protocols casper-test.conf
```

## Verifying Successful Staging

After you have successfully executed the above commands, you can verify that your node is correctly staged with the
upgrade by taking a look at your `status` end-point, as follows:

```shell
curl -s http://127.0.0.1:8888/status | jq -r
```

This will print the status of your node to your terminal. Towards the end of the JSON output, you will find an object
called `next_upgrade`, which if you successfully staged your upgrade, will have the following structure and values:

```json
"next_upgrade": {
"activation_point": 10827,
"protocol_version": "1.5.3"
},
```

If you see another value here, for example `null`, then your upgrade staging was not executed successfully.


_Please note that the DEVxDAO's Casper Testnet program is implemented by the [DEVxDAO](https://devxdao.com) by providing rewards
through the [Emerging Technology Association](https://www.emergingte.ch) (ETA), a Swiss nonprofit association which supports open source
and transparent scientific research of emerging technologies for community building.
Any rewards will be granted and calculated by the ETA. MAKE Technology LLC is not affiliated
with the DEVxDAO, the ETA nor the Casper Foundation, and has no control over the program sponsorship or the incentivized
reward program, and is hosting these guides and documents as a service to the DEVxDAO and the Casper community only._

1 change: 1 addition & 0 deletions src/testnet/testnet-upgrades.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,7 @@
- [TestNet Upgrade to casper-node v1.4.13](upgrade-1_4_13.md)
- [TestNet Upgrade to casper-node v1.4.15](upgrade-1_4_15.md)
- [TestNet Upgrade to casper-node v1.5.2](upgrade-1_5_2.md)
- [TestNet Upgrade to casper-node v1.5.3](upgrade-1_5_3.md)

[include ../disclaimer.md]

Expand Down
49 changes: 49 additions & 0 deletions src/testnet/upgrade-1_5_3.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
# Upgrade to casper-node v1.5.3

## Introduction and Timing
We are requesting that all Casper Testnet participants stage the upgrade of their nodes to a new version of `casper_node`
immediately, using the instructions below. "Staging an upgrade" is a process in which you tell your node to download
the upgrade files and prepare them, so that they can automatically be applied at the pre-defined activation point.

For this upgrade, to `casper-node v1.5.3`, the activation point is `Era 10827`, which will be approximately around:
* Monday October 02, 2023 at 14:28 UTC
* Monday October 02, 2023 at 10:28 EST
* Monday October 02, 2023 at 07:28 PST
* Monday October 02, 2023 at 16:28 EU/Zurich
* Monday October 02, 2023 at 22:28 HK

In order to not have points deducted for your Testnet reward score, you have to make sure you have properly staged the
upgrade well ahead of the activation point, so that your node will be upgraded on time.

## Upgrade Staging Instructions

The process to upgrade your node is very straightforward. Log in to your node, and execute the following two commands,
one by one:

```shell
sudo -u casper /etc/casper/node_util.py stage_protocols casper-test.conf
```

## Verifying Successful Staging

After you have successfully executed the above commands, you can verify that your node is correctly staged with the
upgrade by taking a look at your `status` end-point, as follows:

```shell
curl -s http://127.0.0.1:8888/status | jq -r
```

This will print the status of your node to your terminal. Towards the end of the JSON output, you will find an object
called `next_upgrade`, which if you successfully staged your upgrade, will have the following structure and values:

```json
"next_upgrade": {
"activation_point": 10827,
"protocol_version": "1.5.3"
},
```

If you see another value here, for example `null`, then your upgrade staging was not executed successfully.

[include ../disclaimer.md]

0 comments on commit cc6b7a2

Please sign in to comment.