From b6ce9fc40526de1c0252d56411fce4ef228251cf Mon Sep 17 00:00:00 2001
From: sweexordious <chamirachid1@gmail.com>
Date: Sat, 25 Nov 2023 22:01:14 +0100
Subject: [PATCH] docs: document updating the EVM address for validators

---
 docs/orchestrator.md | 64 +++++++-------------------------------------
 1 file changed, 9 insertions(+), 55 deletions(-)

diff --git a/docs/orchestrator.md b/docs/orchestrator.md
index ed15cfd1..6a9fdd48 100644
--- a/docs/orchestrator.md
+++ b/docs/orchestrator.md
@@ -215,61 +215,7 @@ code: 0
 codespace: ""
 data: 12300A2E2F63656C65737469612E7167622E76312E4D7367526567697374657245564D41646472657373526573706F6E7365
 events:
-- attributes:
-  - index: true
-    key: c3BlbmRlcg==
-    value: Y2VsZXN0aWExcDkzcmd6Mnl5MG5hMnN5OWc3a3NzanY2MDY2dWxqcWV3cGpwZ2c=
-  - index: true
-    key: YW1vdW50
-    value: MzAwMDB1dGlh
-  type: coin_spent
-- attributes:
-  - index: true
-    key: cmVjZWl2ZXI=
-    value: Y2VsZXN0aWExN3hwZnZha20yYW1nOTYyeWxzNmY4NHoza2VsbDhjNWxwbmpzM3M=
-  - index: true
-    key: YW1vdW50
-    value: MzAwMDB1dGlh
-  type: coin_received
-- attributes:
-  - index: true
-    key: cmVjaXBpZW50
-    value: Y2VsZXN0aWExN3hwZnZha20yYW1nOTYyeWxzNmY4NHoza2VsbDhjNWxwbmpzM3M=
-  - index: true
-    key: c2VuZGVy
-    value: Y2VsZXN0aWExcDkzcmd6Mnl5MG5hMnN5OWc3a3NzanY2MDY2dWxqcWV3cGpwZ2c=
-  - index: true
-    key: YW1vdW50
-    value: MzAwMDB1dGlh
-  type: transfer
-- attributes:
-  - index: true
-    key: c2VuZGVy
-    value: Y2VsZXN0aWExcDkzcmd6Mnl5MG5hMnN5OWc3a3NzanY2MDY2dWxqcWV3cGpwZ2c=
-  type: message
-- attributes:
-  - index: true
-    key: ZmVl
-    value: MzAwMDB1dGlh
-  - index: true
-    key: ZmVlX3BheWVy
-    value: Y2VsZXN0aWExcDkzcmd6Mnl5MG5hMnN5OWc3a3NzanY2MDY2dWxqcWV3cGpwZ2c=
-  type: tx
-- attributes:
-  - index: true
-    key: YWNjX3NlcQ==
-    value: Y2VsZXN0aWExcDkzcmd6Mnl5MG5hMnN5OWc3a3NzanY2MDY2dWxqcWV3cGpwZ2cvMQ==
-  type: tx
-- attributes:
-  - index: true
-    key: c2lnbmF0dXJl
-    value: cE5ZS0pqWEZlOFVTaEZUdDdzRHVETWZNWW55YjZTT01iZnlBSkZGYnZpVk45bGJ2L2tUeXhEWWxHK2VjRE94bFlSajJIMmlWNGJLWVhMNDBQM1F4TUE9PQ==
-  type: tx
-- attributes:
-  - index: true
-    key: YWN0aW9u
-    value: L2NlbGVzdGlhLnFnYi52MS5Nc2dSZWdpc3RlckVWTUFkZHJlc3M=
-  type: message
+...
 gas_used: "66959"
 gas_wanted: "210000"
 height: "3"
@@ -298,6 +244,14 @@ Now, you can restart the orchestrator, and it should start signing.
 
 Note: A validator set change is triggered if more than 5% of the total staking power of the network changes. This means that even if you change your EVM address, and you don't see your orchestrator signing, it's alright. Just wait until the validator set changes, and then your orchestrator will automatically start signing.
 
+### Updating the EVM address if its corresponding private key is lost
+
+If, for some reason, the private key, corresponding to the EVM account that was registered above, was lost, or some validator wanted to change it for some reason, then they can re-register another EVM address for their validator using the same above command using the new EVM address and it should work.
+
+If the validator still has access to the previous running orchestrator, it would be safer to keep it running in a separate process, and initializing a new orchestrator in a new home directory, and running it using the new EVM address. Then, once the new orchestrator starts signing, the old one can be stopped.
+
+Running a second orchestrator in the same machine would require using different P2P listening ports, i.e. changing the `listen-addr` value in the `<orchestrator_home>/config/config.toml` file and using different ports between the two instances. 
+
 #### Systemd service
 
 If you want to start the orchestrator as a `systemd` service, you could use the following: