From cb5eaf98b2b51ce643a059746baa3e8314e524bd Mon Sep 17 00:00:00 2001
From: Ana <134174965+anaye1997@users.noreply.github.com>
Date: Tue, 2 Jan 2024 10:06:05 +1100
Subject: [PATCH] :sparkle: update docs on `v4.6.0` polkadot-sdk upgrade (#209)

Signed-off-by: Anathan (Ana) Ye <anaye@duck.com>
---
 .../03-SetupAndRun/02-configuration.md        | 104 ++++++++++++++++++
 .../Collation/03-SetupAndRun/03-running.md    |  24 ++++
 docs/manta-atlantic/Collator Requirement.md   |  40 +++++++
 3 files changed, 168 insertions(+)

diff --git a/docs/manta-atlantic/Collation/03-SetupAndRun/02-configuration.md b/docs/manta-atlantic/Collation/03-SetupAndRun/02-configuration.md
index ea9e4a3c..248f2fb4 100644
--- a/docs/manta-atlantic/Collation/03-SetupAndRun/02-configuration.md
+++ b/docs/manta-atlantic/Collation/03-SetupAndRun/02-configuration.md
@@ -20,6 +20,38 @@ edit the manta service unit file to include collation parameters in the `ExecSta
 
 `/usr/lib/systemd/system/manta.service`
 
+for version `>= v4.6.0` (inclusive)
+```ini
+ExecStart=/usr/bin/manta \
+    --collator \
+    --name 'my parachain collator node name' \
+    --chain /usr/share/substrate/manta.json \
+    --base-path /var/lib/substrate \
+    --port 31333 \
+    --rpc-max-connections 100 \
+    --rpc-port 9144 \
+    --rpc-cors all \
+    --rpc-methods auto \
+    --prometheus-port 9615 \
+    --prometheus-external \
+    --state-cache-size 0 \
+    --bootnodes \
+      /dns/a1.manta.systems/tcp/30333/p2p/12D3KooWCpnkG834s9ETesFTWtGqRDjs6Te1UCXHib3iD8GEmXLU \
+      /dns/a4.manta.systems/tcp/30333/p2p/12D3KooWN9Zud842idiiUypJF9nzQfNrSsuWQRdtRA8D6sqsPXMb \
+      /dns/a5.manta.systems/tcp/30333/p2p/12D3KooWM6Txo8orkxGsSTPByzzWhtTSfdFi2u9KJtd9eWCkry3k \
+      /dns/a7.manta.systems/tcp/30333/p2p/12D3KooWFKMcE12XRLZfktX3crfkZyyBetpHsffDjPopYVhQLXwP \
+      /dns/c1.manta.systems/tcp/30333/p2p/12D3KooWSNwD7tJkqKGdMfCVTJbbzrGFTGbXoeMFZCTwEytpFCM4 \
+    -- \
+    --name 'my embedded relay node name' \
+    --chain /usr/share/substrate/polkadot.json \
+    --port 31334 \
+    --rpc-port 9145 \
+    --prometheus-port 9616 \
+    --prometheus-external \
+    --telemetry-url 'wss://api.telemetry.manta.systems/submit/ 0'
+```
+
+for version `< v4.6.0` (exclusive)
 ```ini
 ExecStart=/usr/bin/manta \
     --collator \
@@ -59,6 +91,42 @@ edit the manta service unit file to include collation parameters in the `ExecSta
 
 `/usr/lib/systemd/system/manta.service`
 
+for version `>= v4.6.0` (inclusive)
+```ini
+ExecStart=/usr/bin/manta \
+    --collator \
+    --name 'my parachain collator node name' \
+    --chain /usr/share/substrate/manta.json \
+    --base-path /var/lib/substrate \
+    --port 31333 \
+    --rpc-max-connections 100 \
+    --rpc-port 9144 \
+    --rpc-cors all \
+    --rpc-methods auto \
+    --prometheus-port 9615 \
+    --prometheus-external \
+    --state-cache-size 0 \
+    --bootnodes \
+      /dns/a1.manta.systems/tcp/30333/p2p/12D3KooWCpnkG834s9ETesFTWtGqRDjs6Te1UCXHib3iD8GEmXLU \
+      /dns/a4.manta.systems/tcp/30333/p2p/12D3KooWN9Zud842idiiUypJF9nzQfNrSsuWQRdtRA8D6sqsPXMb \
+      /dns/a5.manta.systems/tcp/30333/p2p/12D3KooWM6Txo8orkxGsSTPByzzWhtTSfdFi2u9KJtd9eWCkry3k \
+      /dns/a7.manta.systems/tcp/30333/p2p/12D3KooWFKMcE12XRLZfktX3crfkZyyBetpHsffDjPopYVhQLXwP \
+      /dns/c1.manta.systems/tcp/30333/p2p/12D3KooWSNwD7tJkqKGdMfCVTJbbzrGFTGbXoeMFZCTwEytpFCM4 \
+      /dns/c2.manta.systems/tcp/30333/p2p/12D3KooWSyPTkVytQwurRBt73wPQDTgypw88bdhsE4Rb6RnQvCJ9 \
+      /dns/c3.manta.systems/tcp/30333/p2p/12D3KooWJwHqCEjTF46eAUDspKKwxa15TMfs7x8DNr3Gs71Qr64j \
+      /dns/c4.manta.systems/tcp/30333/p2p/12D3KooWAgZYhwfUo7brgZK2TvArK6XNUtZnzk1cSNfyD9kX1rDE \
+      /dns/c5.manta.systems/tcp/30333/p2p/12D3KooWNHVexSGRVeLb7rt7tYS5Y3k5Up9amQn1GyTDCi7L9LLf \
+    -- \
+    --name 'my embedded relay node name' \
+    --chain /usr/share/substrate/polkadot.json \
+    --port 31334 \
+    --rpc-port 9145 \
+    --prometheus-port 9616 \
+    --prometheus-external \
+    --telemetry-url 'wss://api.telemetry.manta.systems/submit/ 0'
+```
+
+for version `< v4.6.0` (exclusive)
 ```ini
 ExecStart=/usr/bin/manta \
     --collator \
@@ -80,6 +148,10 @@ ExecStart=/usr/bin/manta \
       /dns/a5.manta.systems/tcp/30333/p2p/12D3KooWM6Txo8orkxGsSTPByzzWhtTSfdFi2u9KJtd9eWCkry3k \
       /dns/a7.manta.systems/tcp/30333/p2p/12D3KooWFKMcE12XRLZfktX3crfkZyyBetpHsffDjPopYVhQLXwP \
       /dns/c1.manta.systems/tcp/30333/p2p/12D3KooWSNwD7tJkqKGdMfCVTJbbzrGFTGbXoeMFZCTwEytpFCM4 \
+      /dns/c2.manta.systems/tcp/30333/p2p/12D3KooWSyPTkVytQwurRBt73wPQDTgypw88bdhsE4Rb6RnQvCJ9 \
+      /dns/c3.manta.systems/tcp/30333/p2p/12D3KooWJwHqCEjTF46eAUDspKKwxa15TMfs7x8DNr3Gs71Qr64j \
+      /dns/c4.manta.systems/tcp/30333/p2p/12D3KooWAgZYhwfUo7brgZK2TvArK6XNUtZnzk1cSNfyD9kX1rDE \
+      /dns/c5.manta.systems/tcp/30333/p2p/12D3KooWNHVexSGRVeLb7rt7tYS5Y3k5Up9amQn1GyTDCi7L9LLf \
     -- \
     --name 'my embedded relay node name' \
     --chain /usr/share/substrate/polkadot.json \
@@ -98,6 +170,38 @@ edit the manta service unit file to include collation parameters in the `ExecSta
 
 `/etc/systemd/system/manta.service`
 
+for version `>= v4.6.0` (inclusive)
+```ini
+ExecStart=/usr/bin/manta \
+    --collator \
+    --name 'my parachain collator node name' \
+    --chain /usr/share/substrate/manta.json \
+    --base-path /var/lib/substrate \
+    --port 31333 \
+    --rpc-max-connections 100 \
+    --rpc-port 9144 \
+    --rpc-cors all \
+    --rpc-methods auto \
+    --prometheus-port 9615 \
+    --prometheus-external \
+    --state-cache-size 0 \
+    --bootnodes \
+      /dns/a1.manta.systems/tcp/30333/p2p/12D3KooWCpnkG834s9ETesFTWtGqRDjs6Te1UCXHib3iD8GEmXLU \
+      /dns/a4.manta.systems/tcp/30333/p2p/12D3KooWN9Zud842idiiUypJF9nzQfNrSsuWQRdtRA8D6sqsPXMb \
+      /dns/a5.manta.systems/tcp/30333/p2p/12D3KooWM6Txo8orkxGsSTPByzzWhtTSfdFi2u9KJtd9eWCkry3k \
+      /dns/a7.manta.systems/tcp/30333/p2p/12D3KooWFKMcE12XRLZfktX3crfkZyyBetpHsffDjPopYVhQLXwP \
+      /dns/c1.manta.systems/tcp/30333/p2p/12D3KooWSNwD7tJkqKGdMfCVTJbbzrGFTGbXoeMFZCTwEytpFCM4 \
+    -- \
+    --name 'my embedded relay node name' \
+    --chain /usr/share/substrate/polkadot.json \
+    --port 31334 \
+    --rpc-port 9145 \
+    --prometheus-port 9616 \
+    --prometheus-external \
+    --telemetry-url 'wss://api.telemetry.manta.systems/submit/ 0'
+```
+
+for version `< v4.6.0` (exclusive)
 ```ini
 ExecStart=/usr/bin/manta \
     --collator \
diff --git a/docs/manta-atlantic/Collation/03-SetupAndRun/03-running.md b/docs/manta-atlantic/Collation/03-SetupAndRun/03-running.md
index 1fcca8e3..5c69f833 100644
--- a/docs/manta-atlantic/Collation/03-SetupAndRun/03-running.md
+++ b/docs/manta-atlantic/Collation/03-SetupAndRun/03-running.md
@@ -125,6 +125,14 @@ import TabItem from '@theme/TabItem';
 
 - debug manta service configuration (run manta as the manta user, to quickly check for runtime errors):
 
+  for version `>= v4.6.0` (inclusive)
+  ```bash
+  #!/bin/bash
+
+  sudo -H -u manta bash -c '/usr/bin/manta --chain /usr/share/substrate/manta.json --base-path /var/lib/substrate --port 31333 --rpc-max-connections 100 --rpc-port 9144 --rpc-cors all --rpc-methods safe --state-cache-size 0 --bootnodes /dns/a1.manta.systems/tcp/30333/p2p/12D3KooWCpnkG834s9ETesFTWtGqRDjs6Te1UCXHib3iD8GEmXLU /dns/a4.manta.systems/tcp/30333/p2p/12D3KooWN9Zud842idiiUypJF9nzQfNrSsuWQRdtRA8D6sqsPXMb /dns/a5.manta.systems/tcp/30333/p2p/12D3KooWM6Txo8orkxGsSTPByzzWhtTSfdFi2u9KJtd9eWCkry3k /dns/a7.manta.systems/tcp/30333/p2p/12D3KooWFKMcE12XRLZfktX3crfkZyyBetpHsffDjPopYVhQLXwP /dns/c1.manta.systems/tcp/30333/p2p/12D3KooWSNwD7tJkqKGdMfCVTJbbzrGFTGbXoeMFZCTwEytpFCM4 -- --chain /usr/share/substrate/polkadot.json'
+  ```
+
+  for version `< v4.6.0` (exclusive)
   ```bash
   #!/bin/bash
 
@@ -176,6 +184,14 @@ import TabItem from '@theme/TabItem';
 
 - debug manta service configuration (run manta as the manta user, to quickly check for runtime errors):
 
+  for version `>= v4.6.0` (inclusive)
+  ```bash
+  #!/bin/bash
+
+  sudo -H -u manta bash -c '/usr/bin/manta --chain /usr/share/substrate/manta.json --base-path /var/lib/substrate --port 31333 --rpc-max-connections 100 --rpc-port 9144 --rpc-cors all --rpc-methods safe --state-cache-size 0 --bootnodes /dns/a1.manta.systems/tcp/30333/p2p/12D3KooWCpnkG834s9ETesFTWtGqRDjs6Te1UCXHib3iD8GEmXLU /dns/a4.manta.systems/tcp/30333/p2p/12D3KooWN9Zud842idiiUypJF9nzQfNrSsuWQRdtRA8D6sqsPXMb /dns/a5.manta.systems/tcp/30333/p2p/12D3KooWM6Txo8orkxGsSTPByzzWhtTSfdFi2u9KJtd9eWCkry3k /dns/a7.manta.systems/tcp/30333/p2p/12D3KooWFKMcE12XRLZfktX3crfkZyyBetpHsffDjPopYVhQLXwP /dns/c1.manta.systems/tcp/30333/p2p/12D3KooWSNwD7tJkqKGdMfCVTJbbzrGFTGbXoeMFZCTwEytpFCM4 -- --chain /usr/share/substrate/polkadot.json'
+  ```
+
+  for version `< v4.6.0` (exclusive)
   ```bash
   #!/bin/bash
 
@@ -227,6 +243,14 @@ import TabItem from '@theme/TabItem';
 
 - debug manta service configuration (run manta as the manta user, to quickly check for runtime errors):
 
+  for version `>= v4.6.0` (inclusive)
+  ```bash
+  #!/bin/bash
+
+  sudo -H -u manta bash -c '/usr/bin/manta --chain /usr/share/substrate/manta.json --base-path /var/lib/substrate --port 31333 --rpc-max-connections 100 --rpc-port 9144 --rpc-cors all --rpc-methods safe --state-cache-size 0 --bootnodes /dns/a1.manta.systems/tcp/30333/p2p/12D3KooWCpnkG834s9ETesFTWtGqRDjs6Te1UCXHib3iD8GEmXLU /dns/a4.manta.systems/tcp/30333/p2p/12D3KooWN9Zud842idiiUypJF9nzQfNrSsuWQRdtRA8D6sqsPXMb /dns/a5.manta.systems/tcp/30333/p2p/12D3KooWM6Txo8orkxGsSTPByzzWhtTSfdFi2u9KJtd9eWCkry3k /dns/a7.manta.systems/tcp/30333/p2p/12D3KooWFKMcE12XRLZfktX3crfkZyyBetpHsffDjPopYVhQLXwP /dns/c1.manta.systems/tcp/30333/p2p/12D3KooWSNwD7tJkqKGdMfCVTJbbzrGFTGbXoeMFZCTwEytpFCM4 -- --chain /usr/share/substrate/polkadot.json'
+  ```
+
+  for version `< v4.6.0` (exclusive)
   ```bash
   #!/bin/bash
 
diff --git a/docs/manta-atlantic/Collator Requirement.md b/docs/manta-atlantic/Collator Requirement.md
index dcc5234a..8bc19e24 100644
--- a/docs/manta-atlantic/Collator Requirement.md	
+++ b/docs/manta-atlantic/Collator Requirement.md	
@@ -63,6 +63,38 @@ edit the manta service unit file to include collation parameters in the `ExecSt
 
 `/usr/lib/systemd/system/manta.service`
 
+for version `>= v4.6.0` (inclusive)
+```
+ExecStart=/usr/bin/manta \
+    --collator \
+    --name 'my parachain collator node name' \
+    --chain /usr/share/substrate/manta.json \
+    --base-path /var/lib/substrate \
+    --port 31333 \
+    --rpc-max-connections 100 \
+    --rpc-port 9144 \
+    --rpc-cors all \
+    --rpc-methods auto \
+    --prometheus-port 9615 \
+    --prometheus-external \
+    --state-cache-size 0 \
+		--bootnodes \
+		        /dns/a1.manta.systems/tcp/30333/p2p/12D3KooWCpnkG834s9ETesFTWtGqRDjs6Te1UCXHib3iD8GEmXLU \
+		        /dns/a4.manta.systems/tcp/30333/p2p/12D3KooWN9Zud842idiiUypJF9nzQfNrSsuWQRdtRA8D6sqsPXMb \
+		        /dns/a5.manta.systems/tcp/30333/p2p/12D3KooWM6Txo8orkxGsSTPByzzWhtTSfdFi2u9KJtd9eWCkry3k \
+            /dns/a7.manta.systems/tcp/30333/p2p/12D3KooWFKMcE12XRLZfktX3crfkZyyBetpHsffDjPopYVhQLXwP \
+		        /dns/c1.manta.systems/tcp/30333/p2p/12D3KooWSNwD7tJkqKGdMfCVTJbbzrGFTGbXoeMFZCTwEytpFCM4 \
+    -- \
+    --name 'my embedded relay node name' \
+    --chain /usr/share/substrate/polkadot.json \
+    --port 31334 \
+    --rpc-port 9145 \
+    --prometheus-port 9616 \
+    --prometheus-external \
+    --telemetry-url 'wss://api.telemetry.manta.systems/submit/ 0'
+```
+
+for version `< v4.6.0` (exclusive)
 ```
 ExecStart=/usr/bin/manta \
     --collator \
@@ -378,6 +410,14 @@ sudo firewall-cmd --reload
 
     -   debug manta service configuration (run manta as the manta user, to quickly check for runtime errors):
 
+    for version `>= v4.6.0` (inclusive)
+    ```jsx
+    #!/bin/bash
+
+    sudo -H -u manta bash -c '/usr/bin/manta --chain /usr/share/substrate/manta .json --base-path /var/lib/substrate --port 31333 --rpc-max-connections 100 --rpc-port 9144 --rpc-cors all --rpc-methods safe --state-cache-size 0 --bootnodes /dns/crispy.manta.systems/tcp/30333/p2p/12D3KooWNE4LBfkYB2B7D4r9vL54YMMGsfAsXdkhWfBw8VHJSEQc /dns/crunchy.manta.systems/tcp/30333/p2p/12D3KooWL3ELxcoMGA6han3wPQoym5DKbYHqkWkCuqyjaCXpyJTt /dns/hotdog.manta.systems/tcp/30333/p2p/12D3KooWBdto53HnArmLdtf2RXzNWti7hD5mML7DWGZPD8q4cywv /dns/tasty.manta.systems/tcp/30333/p2p/12D3KooWGs2hfnRQ3Y2eAoUyWKUL3g7Jmcsf8FpyhVYeNpXeBMSu /dns/tender.manta.systems/tcp/30333/p2p/12D3KooWNXZeUSEKRPsp1yiDH99qSVawQSWHqG4umPjgHsn1joci -- --chain /usr/share/substrate/polkadot.json'
+    ```
+
+    for version `< v4.6.0` (exclusive)
     ```jsx
     #!/bin/bash