Add an intermediate tuto for baking using a Ledger device #506
Conversation
|
@spalmer25 is attempting to deploy a commit to the Trili Tech Team on Vercel. A member of the Team first needs to authorize it. |
|
|
||
| :::note | ||
|
|
||
| You won't need `Ledger Live` for the rest of the tutorial. |
There was a problem hiding this comment.
You dont need to mention this note.
|
|
||
| ## Download `Tezos Wallet (XTZ)` | ||
|
|
||
| The `Tezos Baking` application does not allow you to sign some operations used in this tutorial. You will also need the `Tezos Wallet (XTZ)` application to sign them. |
There was a problem hiding this comment.
Rephrase it like , to sign operations to setup baking you need Tezos wallet app. No need to mention tezos baking does not allow ...
| ``` | ||
|
|
||
| A validation from your Ledger device will be required. | ||
|
|
There was a problem hiding this comment.
a series of screenshots might help here. Not sure.
There was a problem hiding this comment.
I've added the screen flows.
The original document can be found here :
https://lucid.app/lucidchart/26df7357-40e6-4c1b-8ffe-0e4b8eebf707/edit?beaconFlowId=D98D3B908C0603CC&invitationId=inv_08b134b7-3e40-4429-af31-101e36489cc3&page=0_0#
Do you have access to it?
| In a new terminal, run: | ||
|
|
||
| ```bash | ||
| octez-client -R 'tcp://localhost:7732' config update |
There was a problem hiding this comment.
Does this end here? Need to complete the command and some text below
There was a problem hiding this comment.
The command is complete.
I will add an explanatory text below.
|
|
||
| In the `Tezos Baking` application, in order to avoid signing blocks or operations that could lead to double-baking, double-attesting or double-preattesting, checks are carried out on the blocks and operations whose signature has been requested. | ||
| These verifications require a High Watermark (HWM) to be stored in the RAM of your Ledger device. Saving information in RAM can be slow and can therefore slow down the performance of your device during baking. | ||
| You can disable this by disabling the `High Watermark` option in the `Settings` section of the `Tezos Baking` application. However, when this option is no longer active, it becomes possible to sign operations that would lead to double-baking, double-attesting or double-preattesting. You are therefore strongly advised not to deactivate this option if your block and operations provider does not also prevent double-baking, double-attesting and double-preattesting. |
There was a problem hiding this comment.
Not a wording we want, also incorrect.
THe HWM is stored in NVRAM (non-volatile memory) .
Refer to the wording i have put in word document.
There was a problem hiding this comment.
You're right, I will use the text of the reference doc.
spalmer25
force-pushed
the
palmer@functori@tuto-running-baker-with-ledger
branch
from
e91e9b9 to
cfd18d4
Compare
docs/tutorials/bake-with-ledger.md
Outdated
| In this tutorial, we'll look at: | ||
| - how to install the Tezos baking application on your Ledger device | ||
| - how to configure your Ledger device so that the [Ledger baking application of Tezos](https://github.com/trilitech/ledger-app-tezos-baking) works properly | ||
| - how to launch a baker daemon by signing from your Ledger device using `octez-signer` |
There was a problem hiding this comment.
How to use an external signer (octez-signer) while running your baker for enhanced protection
| ``` | ||
|
|
||
| A validation from your Ledger device will be required. | ||
|
|
|
|
||
| :::note Warning | ||
|
|
||
| This step is not necessary to be able to bake. However, if the HWM is not initialized, the first level encountered in an operation or block to be signed will be used as the initialization level. For this first operation or block, double baking, double-attesting or double pre-attesting will not be detected. It is therefore **strongly recommended** to at least initialize the HWM with the level of the block at the head of the chain. |
There was a problem hiding this comment.
Dont give extra information. make it compulsory for the user.
LIne 30 to 36 can be replaced by
"Always reset HWM to highest block value before starting to bake. The highest block can be obtained from Tzkt"
Co-authored-by: Ajinkya <145996984+ajinkyaraj-23@users.noreply.github.com>
spalmer25
force-pushed
the
palmer@functori@tuto-running-baker-with-ledger
branch
from
9c9a8a9 to
6d92a85
Compare
This PR adds an intermediate tutorial to present how to bake with a Ledger device.
It is presented all steps from the installation of the Ledger baking app of Tezos to security verifications.
Reference: Ledger maintainance announcement for Tezos Bakers