Skip to content

Commit b70ae1b

Browse files
committed
chore: update summary
1 parent a0efdac commit b70ae1b

19 files changed

+1882
-3
lines changed

.gitbook/SUMMARY.md

Lines changed: 80 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,14 +60,77 @@
6060
* [Modules](developers/modules/README.md)
6161
* [Injective](developers/modules/injective/README.md)
6262
* [Auction](developers/modules/injective/auction/README.md)
63+
* [State](developers/modules/injective/auction/01_state.md)
64+
* [Messages](developers/modules/injective/auction/02_messages.md)
65+
* [EndBlock](developers/modules/injective/auction/03_end_block.md)
66+
* [Events](developers/modules/injective/auction/04_events.md)
67+
* [Params](developers/modules/injective/auction/05_params.md)
6368
* [Exchange](developers/modules/injective/exchange/README.md)
69+
* [Derivative Markets Concepts](developers/modules/injective/exchange/00_derivative_market_concepts.md)
70+
* [Spot Markets Concepts](developers/modules/injective/exchange/01_spot_market_concepts.md)
71+
* [Binary Option Markets Concepts](developers/modules/injective/exchange/02_binary_options_markets.md)
72+
* [Other Concepts](developers/modules/injective/exchange/02_other_concepts.md)
73+
* [State](developers/modules/injective/exchange/03_state.md)
74+
* [State Transitions](developers/modules/injective/exchange/04_state_transitions.md)
75+
* [Messages](developers/modules/injective/exchange/05_messages.md)
76+
* [Proposals](developers/modules/injective/exchange/06_proposals.md)
77+
* [BeginBlock](developers/modules/injective/exchange/07_begin_block.md)
78+
* [EndBlock](developers/modules/injective/exchange/08_end_block.md)
79+
* [Events](developers/modules/injective/exchange/09_events.md)
80+
* [Params](developers/modules/injective/exchange/10_params.md)
81+
* [MsgPrivilegedExecuteContract](developers/modules/injective/exchange/11_msg_privileged_execute_contract.md)
82+
* [Improvements](developers/modules/injective/exchange/07_future_improvements.md)
6483
* [Insurance](developers/modules/injective/insurance/README.md)
84+
* [State](developers/modules/injective/insurance/01_state.md)
85+
* [State Transitions](developers/modules/injective/insurance/02_state_transition.md)
86+
* [Messages](developers/modules/injective/insurance/03_messages.md)
87+
* [EndBlock](developers/modules/injective/insurance/04_end_block.md)
88+
* [Events](developers/modules/injective/insurance/05_events.md)
89+
* [Params](developers/modules/injective/insurance/06_params.md)
90+
* [Improvements](developers/modules/injective/insurance/07_future_improvements.md)
6591
* [OCR](developers/modules/injective/ocr/README.md)
92+
* [Concepts](developers/modules/injective/ocr/01_concepts.md)
93+
* [State](developers/modules/injective/ocr/02_state.md)
94+
* [Messages](developers/modules/injective/ocr/03_messages.md)
95+
* [Proposals](developers/modules/injective/ocr/04_proposals.md)
96+
* [BeginBlock](developers/modules/injective/ocr/05_begin_block.md)
97+
* [Hooks](developers/modules/injective/ocr/06_hooks.md)
98+
* [Events](developers/modules/injective/ocr/07_hooks.md)
99+
* [Params](developers/modules/injective/ocr/08_params.md)
66100
* [Oracle](developers/modules/injective/oracle/README.md)
101+
* [State](developers/modules/injective/oracle/01_state.md)
102+
* [Keeper](developers/modules/injective/oracle/02_keeper.md)
103+
* [Messages](developers/modules/injective/oracle/03_messages.md)
104+
* [Proposals](developers/modules/injective/oracle/04_proposals.md)
105+
* [Events](developers/modules/injective/oracle/05_events.md)
106+
* [Improvements](developers/modules/injective/oracle/06_future_improvements.md)
67107
* [Peggy](developers/modules/injective/peggy/README.md)
108+
* [Definitions](developers/modules/injective/peggy/01_definitions.md)
109+
* [Workflow](developers/modules/injective/peggy/02_workflow.md)
110+
* [State](developers/modules/injective/peggy/03_state.md)
111+
* [Messages](developers/modules/injective/peggy/04_messages.md)
112+
* [Slashing](developers/modules/injective/peggy/05_slashing.md)
113+
* [EndBlock](developers/modules/injective/peggy/06_end_block.md)
114+
* [Events](developers/modules/injective/peggy/07_events.md)
115+
* [Params](developers/modules/injective/peggy/08_params.md)
116+
* [Relay Semantics](developers/modules/injective/peggy/09_relay_semantics.md)
117+
* [Improvements](developers/modules/injective/peggy/10_future_improvements.md)
68118
* [Permissions](developers/modules/injective/permissions/README.md)
119+
* [Concepts](developers/modules/injective/permissions/01_concepts.md)
120+
* [State](developers/modules/injective/permissions/02_state.md)
121+
* [State Transition](developers/modules/injective/permissions/03_state_transitions.md)
69122
* [TokenFactory](developers/modules/injective/tokenfactory/README.md)
123+
* [Concepts](developers/modules/injective/tokenfactory/01_concepts.md)
124+
* [State](developers/modules/injective/tokenfactory/02_state.md)
125+
* [Messages](developers/modules/injective/tokenfactory/03_messages.md)
126+
* [Events](developers/modules/injective/tokenfactory/04_events.md)
127+
* [Params](developers/modules/injective/tokenfactory/05_params.md)
70128
* [WasmX](developers/modules/injective/wasmx/README.md)
129+
* [Concepts](developers/modules/injective/wasmx/01_concepts.md)
130+
* [Data](developers/modules/injective/wasmx/02_data.md)
131+
* [Proposals](developers/modules/injective/wasmx/03_proposals.md)
132+
* [Messages](developers/modules/injective/wasmx/04_messages.md)
133+
* [Params](developers/modules/injective/wasmx/05_params.md)
71134
* [Core](developers/modules/core/README.md)
72135
* [Auth](developers/modules/core/auth/README.md)
73136
* [AuthZ](developers/modules/core/authz/README.md)
@@ -100,7 +163,23 @@
100163
* [Validators](nodes/validators/README.md)
101164
* [Mainnet](nodes/validators/mainnet/README.md)
102165
* [Peggo](nodes/validators/mainnet/peggo.md)
103-
* [Canonical Chain Upgrades](nodes/validators/mainnet/canonical-chain-upgrades.md)
166+
* [Canonical Chain Upgrades](nodes/validators/mainnet/canonical-chain-upgrades/README.md)
167+
* [Upgrade to 10002-rc1](nodes/validators/mainnet/canonical-chain-upgrades/canonical-10002-rc1.md)
168+
* [Upgrade to 10002-rc2](nodes/validators/mainnet/canonical-chain-upgrades/canonical-10002-rc2.md)
169+
* [Upgrade to 10003-rc1](nodes/validators/mainnet/canonical-chain-upgrades/canonical-10003-rc1.md)
170+
* [Upgrade to 10004-rc1](nodes/validators/mainnet/canonical-chain-upgrades/canonical-10004-rc1.md)
171+
* [Upgrade to 10004-rc1-patch](nodes/validators/mainnet/canonical-chain-upgrades/canonical-10004-rc1-patch.md)
172+
* [Upgrade to 10005-rc1](nodes/validators/mainnet/canonical-chain-upgrades/canonical-10005-rc1.md)
173+
* [Upgrade to 10006-rc1](nodes/validators/mainnet/canonical-chain-upgrades/canonical-10006-rc1.md)
174+
* [Upgrade to 10007-rc1](nodes/validators/mainnet/canonical-chain-upgrades/canonical-10007-rc1.md)
175+
* [Upgrade to 10008 - Camelot](nodes/validators/mainnet/canonical-chain-upgrades/canonical-10008.md)
176+
* [Upgrade to 10009](nodes/validators/mainnet/canonical-chain-upgrades/canonical-10009.md)
177+
* [Upgrade to v1.10](nodes/validators/mainnet/canonical-chain-upgrades/canonical-100010.md)
178+
* [Upgrade to v1.11](nodes/validators/mainnet/canonical-chain-upgrades/canonical-10011.md)
179+
* [Upgrade to v1.12.0](nodes/validators/mainnet/canonical-chain-upgrades/canonical-1-12.md)
180+
* [Upgrade to v1.12.1](nodes/validators/mainnet/canonical-chain-upgrades/canonical-1-12-1.md)
181+
* [Upgrade to v1.13.0](nodes/validators/mainnet/canonical-chain-upgrades/canonical-1.13.0.md)
182+
* [Upgrade to v1.13.2](nodes/validators/mainnet/canonical-chain-upgrades/canonical-1.13.2.md)
104183
* [Testnet](nodes/validators/testnet/README.md)
105184
* [Testnet Peggo](nodes/validators/testnet/testnet-peggo.md)
106185
* [Cosmosvisor](nodes/validators/cosmosvisor.md)

.gitbook/nodes/validators/mainnet/canonical-chain-upgrades.md

Lines changed: 0 additions & 2 deletions
This file was deleted.
Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
# Canonical Chain Upgrades
2+
3+
Nov 8th, 2021
4+
5+
The following document describes the necessary steps involved that validators and full node operators must take in order to upgrade from the Injective Canary Chain to the Canonical Chain. The upgrade will take place via an on-chain software upgrade proposal passed by Injective governance. If passed, this proposal would commit the Injective Mainnet to halting the Canary Chain injectived application binary at approximately 14:00 UTC on Nov 8th and starting the application binary for the Injective Canonical Chain.
6+
7+
Injective Canary Chain to the Canonical Chain upgrade follows [proposal #65](https://hub.injective.network/proposals/65)
8+
9+
Following a chain upgrade timeline, as a first step proccedd to Canonical chain release [10002-rc1](canonical-10002-rc1.md) upgrade.
10+
11+
12+
## The History of Canonical Chain Upgrades
13+
14+
---
15+
### Version 10002-rc1
16+
Nov 8th 2021 14:00 UTC
17+
18+
Block number: [4,352,000](https://explorer.injective.network/block/4352000)
19+
20+
Released Artifacts: [Injective Chain 10002-rc1 release](https://github.com/InjectiveLabs/injective-chain-releases/releases/tag/v1.1.0-1636178708)
21+
22+
Following [proposal #65](https://hub.injective.network/proposals/65)
23+
24+
---
25+
### Version 10002-rc2
26+
November 15th 2021
27+
28+
Block number: [4,594,100](https://explorer.injective.network/block/4594100)
29+
30+
Released Artifacts: [Injective Chain 10002-rc2 release](https://github.com/InjectiveLabs/injective-chain-releases/releases/tag/v1.1.1-1636733798)
31+
32+
Following [proposal #70](https://hub.injective.network/proposals/70)
33+
34+
---
35+
### Version 10003-rc1
36+
Thursday Dec 30th 2021
37+
38+
Block number: [6,159,200](https://explorer.injective.network/block/6159200)
39+
40+
Released Artifacts: [Mainnet-10003-rc1-1640627705](https://github.com/InjectiveLabs/injective-chain-releases/releases/tag/v1.1.1-1640627705)
41+
42+
Following [proposal #93](https://hub.injective.network/proposals/93)
43+
44+
---
45+
### Version 10004-rc1
46+
Tuesday Jan 25th 2022
47+
48+
Block number: [7067700](https://explorer.injective.network/block/7067700)
49+
50+
Released Artifacts: [Mainnet-10004-rc1-v1.4.0-1642928125](https://github.com/InjectiveLabs/injective-chain-releases/releases/tag/v1.4.0-1642928125)
51+
52+
Following [proposal #106](https://hub.injective.network/proposals/106)
53+
54+
### Version 10004-rc1-patch
55+
Sunday Feb 20th 2022
56+
57+
Block number: [7941974](https://explorer.injective.network/block/7941974)
58+
59+
Released Artifacts: [Mainnet-10004-rc1-v1.4.0-1645352045](https://github.com/InjectiveLabs/injective-chain-releases/releases/tag/v1.4.0-1645352045)
60+
61+
### Version 10005-rc1
62+
Monday April 11th 2022
63+
64+
Block number: [9614200](https://explorer.injective.network/block/9614200)
65+
66+
Released Artifacts: [Mainnet-v1.5.0-1649280277](https://github.com/InjectiveLabs/injective-chain-releases/releases/tag/v1.5.0-1649280277)
67+
68+
### Version 10006-rc1
69+
Tuesday July 5th 2022
70+
71+
Block number: [12569420](https://explorer.injective.network/block/12569420)
72+
73+
Released Artifacts: [Mainnet-v1.6.0-1656650662](https://github.com/InjectiveLabs/injective-chain-releases/releases/tag/v1.6.0-1656650662)
74+
75+
### Version 10007-rc1
76+
Thursday September 1th 2022
77+
78+
Block number: [14731000](https://explorer.injective.network/block/14731000)
79+
80+
Released Artifacts: [Mainnet-v1.7.0-1661881062](https://github.com/InjectiveLabs/injective-chain-releases/releases/tag/v1.7.0-1661881062)
81+
82+
### Version 10008
83+
Monday November 21th 2022
84+
85+
Block number: [19761600](https://explorer.injective.network/block/19761600)
86+
87+
Released Artifacts: [Mainnet-10008-1668679102](https://github.com/InjectiveLabs/injective-chain-releases/releases/tag/v1.8.0-1668679102)
Lines changed: 109 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,109 @@
1+
---
2+
sidebar_position: 14
3+
---
4+
5+
# Upgrade to v1.12.0
6+
Thursday January 11 2024
7+
8+
Following [proposal 314](https://hub.injective.network/proposals/314/)
9+
This indicates that the upgrade procedure should be performed on block number **57076000**
10+
11+
- [Summary](#summary)
12+
- [Risks](#risks)
13+
- [Recovery](#recovery)
14+
- [Upgrade Procedure](#upgrade-procedure)
15+
- [Notes for Validator Operators](##notes-for-validator-operators)
16+
- [Notes for Service Providers](##notes-for-DEX-relayer-providers)
17+
18+
## Summary
19+
20+
The Injective Canonical Chain will undergo a scheduled enhancement upgrade on **Jan 11th 14:00 UTC**.
21+
22+
The following is a short summary of the upgrade steps:
23+
24+
1. Vote and wait till the node panics at block height **57076000**.
25+
2. Backing up configs, data, and keys used for running the Injective Canonical Chain.
26+
3. Install the [v1.12.0-1704530206](https://github.com/InjectiveLabs/injective-chain-releases/releases/tag/v1)
27+
4. Start your node with the new injectived binary to fulfill the upgrade.
28+
29+
Upgrade coordination and support for validators will be available on the `#validators` private channel of the [Injective Discord](https://discord.gg/injective).
30+
31+
The network upgrade can take the following potential pathways:
32+
1. **Happy path**
33+
Validators successfully upgrade chain without purging the blockchain history and all validators are up within 1-2 hours of the scheduled upgrade.
34+
35+
2. **Not-so-happy path**
36+
Validators have trouble upgrading to latest Canonical chain. This could be some consensus breaking changes not covered in upgrade handler, or compatibility issue of the migrated state with new injectived binary, but validators can at least export the genesis.
37+
38+
3. **Abort path**
39+
In the rare event that the team becomes aware of unnoticed critical issues, the Injective team will attempt to patch all the breaking states and provide another official binary within 36 hours.
40+
If the chain is not successfully resumed within 36 hours, the upgrade will be announced as aborted on the #mainnet-validators channel of [Discord](https://discord.gg/injective), and validators will need to resume running the chain without any updates or changes. A new governance proposal for the upgrade will need to be issued and voted on by the community for the next upgrade.
41+
42+
## Risks
43+
44+
As a validator performing the upgrade procedure on your consensus nodes carries a heightened risk of double-signing and being slashed. The most important piece of this procedure is verifying your software version and genesis file hash before starting your validator and signing.
45+
46+
The riskiest thing a validator can do is discover that they made a mistake and repeat the upgrade procedure again during the network startup. If you discover a mistake in the process, the best thing to do is wait for the network to start before correcting it. If the network is halted and you have started with a different genesis file than the expected one, seek advice from an Injective developer before resetting your validator.
47+
48+
## Recovery
49+
50+
Prior to exporting chain state, validators are encouraged to take a full data snapshot at the export height before proceeding. Snapshotting depends heavily on infrastructure, but generally this can be done by backing up the `.injectived` directory.
51+
52+
It is critically important to backup the `.injectived/data/priv_validator_state.json` file after stopping your injectived process. This file is updated every block as your validator participates in a consensus rounds. It is a critical file needed to prevent double-signing, in case the upgrade fails and the previous chain needs to be restarted.
53+
54+
In the event that the upgrade does not succeed, validators and operators must restore the snapshot and downgrade back to [Injective Chain 10011 release](https://github.com/InjectiveLabs/injective-chain-releases/releases/tag/v1.11.6-1688984159) and continue the chain until next upgrade announcement.
55+
56+
### Upgrade Procedure
57+
58+
## Notes for Validators
59+
Validator operators should configure the **timeout_commit** in **config.toml** to `300ms`.
60+
61+
You must remove the wasm cache before upgrading to the new version (rm -rf .injectived/wasm/wasm/cache/).
62+
63+
1. Verify you are currently running the correct version (`69fb0c5`) of `injectived`:
64+
```bash
65+
injectived version
66+
Version dev (69fb0c5)
67+
Compiled at 20230710-1016 using Go go1.19.3 (amd64)
68+
```
69+
70+
2. After the chain has halted, make a backup of your `.injectived` directory
71+
```bash
72+
cp ~/.injectived ./injectived-backup
73+
```
74+
**NOTE**: It is recommended for validators and operators to take a full data snapshot at the export height before proceeding in case the upgrade does not go as planned or if not enough voting power comes online in a sufficient and agreed upon amount of time. In such a case, the chain will fallback to continue operating the Chain. See [Recovery](#recovery) for details on how to proceed.
75+
76+
3. Download and install the injective-chain `v1.12.0 release`
77+
```bash
78+
wget https://github.com/InjectiveLabs/injective-chain-releases/releases/download/v1.12.0-1704530206/linux-amd64.zip
79+
unzip linux-amd64.zip
80+
sudo mv injectived peggo /usr/bin
81+
sudo mv libwasmvm.x86_64.so /usr/lib
82+
```
83+
84+
4. Verify you are currently running the correct version (`b92723b13`) of `injectived` after downloading the v1.12.0 release:
85+
```bash
86+
injectived version
87+
Version dev (b92723b13)
88+
Compiled at 20240106-0837 using Go go1.19.3 (amd64)
89+
```
90+
91+
5. Coordinate to restart your injectived with other validators
92+
```bash
93+
injectived start
94+
```
95+
The binary will perform the upgrade automatically and continue the next consensus round if everything goes well.
96+
97+
6. Verify you are currently running the correct version (`9e702f1`) of `peggo` after downloading the v1.12.0 release:
98+
```bash
99+
peggo version
100+
Version dev (9e702f1)
101+
Compiled at 20240106-0837 using Go go1.19.3 (amd64)
102+
```
103+
8. Start peggo
104+
```bash
105+
peggo orchestrator
106+
```
107+
108+
## Notes for DEX relayer providers
109+
Relayer upgrade will be available after the chain is successfully upgraded as it relies on several other components that work with injectived.

0 commit comments

Comments
 (0)