doc: update validators docs

Author: sameh-farouk

docs/misc/adding_validators.md

@@ -56,7 +56,7 @@ Take note of the following:
 - **Public Key (hex)**
 - **SS58 Address**: This is your validator's account address.
 
-This key will serve as your validator controller account and session key for Aura. It'll used also to derive the GRANDPA key.
+This key will serve as your validator controller account and session key for Aura (validator node/author account). It'll used also to derive the GRANDPA key.
 
 ### 1.2 Generate the Node (aka Network) Key
 
@@ -335,6 +335,59 @@ Insert the Aura and GRANDPA keys into your node's keystore.
 
 You can restart your node at this point.
 
+#### 2.4 Managing TFChain with systemd (Optional)
+
+Example systemd file:
+
+```ini
+    [Unit]
+    Description=TFchain service
+    After=network.target
+    StartLimitIntervalSec=0
+
+    [Service]
+    Type=simple
+    Restart=always
+    RestartSec=1
+    User=user
+    ExecStart=/home/user/tfchain/substrate-node/target/release/tfchain --chain /home/user/tfchain/substrate-node/chainspecs/dev/chainSpec.json --pruning=archive --bootnodes /ip4/185.206.122.7/tcp/30333/p2p/12D3KooWLcMLBg9itjQL1EXsAqkJFPhqESHqJKY7CBKmhhhL8fdp --validator --telemetry-url 'wss://shard1.telemetry.tfchain.grid.tf/submit 1'
+
+    [Install]
+    WantedBy=multi-user.target
+```
+
+Replace `user` by your username.
+
+```bash
+sudo vim /etc/systemd/system/tfchain.service
+```
+
+then paste the file content, save and exit vim.
+
+Starting service:
+
+```bash
+sudo systemctl start tfchain
+```
+
+Stopping service:
+
+```bash
+sudo systemctl stop tfchain
+```
+
+Reload config:
+
+```bash
+sudo systemctl stop tfchain
+```
+
+Edit File:
+
+```bash
+sudo systemctl start tfchain
+```
+
 ## 3. Synchronize the Node Using Warp Sync
 
 With warp sync enabled, your node will sync much faster by downloading key block headers and skipping state transitions. To monitor the syncing progress, you can view the logs.

docs/misc/validatorship.md

@@ -0,0 +1,56 @@
+# Apply for a Validatorship
+
+## Requirements
+
+Check [adding validators guide](./adding_validators.md) and make sure you meet the [Prerequisites](./adding_validators.md#prerequisites) and hardware [requiremnts](./adding_validators.md#hardware).
+
+## 1 Generate Keys
+
+Follow [step 1](./adding_validators.md#1-generate-keys)
+
+Optionally, generate a third account (a stash account) similary to how you [genrate the validator account key](./adding_validators.md#11-generate-the-validator-account-key)
+
+## 2 Insert AURA/GRAN Keys
+
+Follow [step 2](./adding_validators.md#2-start-the-validator-node) and [step 3](./adding_validators.md#3-synchronize-the-node-using-warp-sync)
+
+## 3 Connect The Session Key To The Controller Account
+
+Follow [step 4](./adding_validators.md#4-set-session-keys-on-chain)
+
+Your node is now running in validator mode. Next up you need to apply for a Validatorship and manualy activate the validator.
+
+## 4 Setup a Stash Account (Optional)
+
+Bonding an account is optional, you can skip this step and continue to the next step.
+
+- Open the Polkadot.js browser extension.
+- Import your stach account using the mnemonic from step 1 in this document.
+- Go to `Developer` -> `Extrinsicis` and Select your `Stash` account. Now from the left dropdown (modules) search `validator`
+- Select `bond(validator)` and select the target account to be your account that manages the Validator and manages your council membership (voting). (You previously created).
+- Now click `Submit Transaction`.
+
+![bond](../assets/bond.png)
+
+## 5 Apply for a Validatorship
+
+- Now go to `Developer` -> `Extrinsicis` and Select your `VALIDATOR_ACCOUNT` account. Now from the left dropdown (modules) search `validator` and select the method: `createValidator(...)`
+- This call needs to be signed with your account (`VALIDATOR_ACCOUNT`) that manages the Validator and manages your council membership (voting). (You previously created).
+- Information needed:
+  - validator\_node\_account: Account ID generated from previous step (`VALIDATOR_NODE_ACCOUNT`)
+  - stash\_account: Stash account, can be your `VALIDATOR_ACCOUNT`
+  - description: Reason why I want to become a validator
+  - tfconnectid: Your Threefold connect name
+  - info: link to webpage or linked in profile
+- If all information is filled in correctly. Click on `Submit transaction` and sign. If all goes well, the Council will approve your request.
+
+![create](../assets/create_val.png)
+
+## 6 Activate The Validator
+
+If your request is approved by the council AND your tfchain node is fully synced with the network you can activate your validator. This will kickstart block production after 2 era.
+
+- go to `Developer` -> `Extrinsicis` and Select your account that manages the Validator and manages your council membership (voting). (You previously created).. Now from the left dropdown (modules) search `validator`.
+- Select `ActivateValidatorNode` and click Submit Transaction.
+
+![activate](../assets/activate.png)