Ithaca2 is one of the most important amendments so far. To continue baking after activation, bakers need to upgrade their infrastructure before the end of the adoption period.
Last updated
Was this helpful?
This tutorial provides practical commands to successfully upgrade a baker's infrastructure. As a reminder, we recently wrote an describing the breaking changes regarding Ithaca2 (Psithaca2) and its new consensus algorithm: .
After Ithaca2 is activated, it will be technically impossible to bake without Octez v12.2 or later.
This version contains all binaries (baker and accuser) necessary for Ithaca2 and the associated testnet.
With Tenderbake, endorsement operations now consist of a level, a round, a slot, and a payload hash. A Baker can emit at most one endorsement per round, but it is allowed to emit more endorsements per level. The former high-water mark mechanism used by the signer has been adapted accordingly. The for previous protocols signed messages with the following format:
<magic_byte><chain_id><block|endorsement>
Now, they have the following shape:
<magic_byte><chain_id><block|preendorsement|endorsement>,
where the magic byte has changed from 0x01 (for blocks) and 0x02 (for endorsements), to 0x11 (for blocks), 0x12 (for preendorsements), 0x13 (for endorsements).
The signer is authorized to sign whenever the level is strictly higher than the previous level, or the level is the same, but the round is strictly higher. Octez v12.2 contains the updated signer. Bakers using a Ledger Nano must upgrade their Ledger's software (see ). Any other custom solution must be adapted to the signing logic.
Likewise, if you use tezos-signerdon't forget to update, and relaunch it.
See our official technical documentation .
If you launch your node with a simple docker command, you should use the v12.2 image and the following image to run your node:
Then you can, for example, access the created container and launch your Ithaca2 daemons:
Docker Compose users only need to change the docker image and relaunch the containers to update Octez:
...
services:
[type]-node:
image: tezos/tezos:v12.2
...
Afterward, launch your baking/accuser daemons as you normally do.
Note: it requires basic knowledge of the OPAM package manager and the OCaml packages workflow.
Step 1: Access your tezos repository and execute the following commands:
Step 2: Launch the binaries
Note, that there is no endorser daemon anymore. The baker daemon performs both baking and endorsement operations. Launch your baker:
And the accuser:
Bakers using a Ledger hardware wallet for operation signing will need to upgrade the Tezos Baking app to v.2.2.15 or later. See instructions below.
Henceforth, this is the list of tags supported by the Ledger apps:
To upgrade, bakers will need to
Exit the Tezos Baking app;
Upgrade the Tezos Wallet and Tezos Baking apps using the Ledger Live application;
Authorize the Ledger to bake for their specific key;
Relaunch the Baking App.
To avoid missing assigned baking/endorsing slots, owning a second Ledger Nano can be useful for signing operations while the first Ledger Nano is being upgraded.
The following example uses a Ledger Nano S.
Step 1: Exit Tezos Baking application and launch Ledger Live.
On the bar at the bottom left, access the Manager section and search for Tezos. Upgrade both the Tezos Wallet and Tezos Baking applications to version 2.2.15.
Step 2: Import your Tezos baking address by clicking on Add account, and follow the steps to add your Tezos account.
Step 3: Before launching the baker and accuser daemons, you need to re-authorize your Ledger to bake for your baking key.
Step 4: Your Nano S is now upgraded, and you are ready to bake on Ithaca2. Don't forget to launch the Tezos Baking app! Happy baking!
Only the Tezos Baking app v2.2.15 or later is compatible with Ithaca2 (due to the changes imposed by the adoption of the Tenderbake consensus algorithm). It is however also compatible with the current protocol version, so it is safe (and advisable) to upgrade now.
If you don't see the Tezos Baking app, you may need to activate Ledger Live's .
