Cumulus Tutorial Refactor & Update

.prettierignore

@@ -0,0 +1,7 @@
+# Ignore build/dev artifacts:
+.cache
+node_modules
+public
+
+# Ignore files that don't need *text* formatting
+src/images

gatsby-config.js

@@ -127,7 +127,7 @@ module.exports = {
     {
       resolve: `gatsby-source-filesystem`,
       options: {
-        path: `${__dirname}/v3/tutorials/09-cumulus-workshop/`,
+        path: `${__dirname}/v3/tutorials/09-cumulus/`,
         name: `cumulus`,
       },
     },

gatsby-node.js

@@ -89,8 +89,8 @@ const tutsInfo = [
   },
   {
     name: 'cumulus',
-    navSlug: 'cumulusWorkshop',
-    version: '3.0',
+    navSlug: 'cumulusTutorial',
+    version: 'polkadot-v0.9.10',
   },
   {
     name: 'frontier',

src/components/DevNavMenu.tsx

@@ -685,22 +685,26 @@ DevNavMenuTuts.set('inkWorkshop', [
     ],
   },
 ])
-DevNavMenuTuts.set('cumulusWorkshop', [
+DevNavMenuTuts.set('cumulusTutorial', [
   {
-    name: `Substrate Cumulus Workshop`,
+    name: `Cumulus Tutorial`,
     items: [
       {
-        title: `Getting Started`,
-        link: '/tutorials/v3/cumulus-workshop/pt1',
+        title: `Start a relay chain`,
+        link: '/tutorials/v3/cumulus/pt1',
       },
       {
-        title: `Connecting to a Relay Chain`,
-        link: '/tutorials/v3/cumulus-workshop/pt2',
+        title: `Connect a parachain`,
+        link: '/tutorials/v3/cumulus/pt2',
       },
       {
-        title: `Launch a Development Environment`,
-        link: '/tutorials/v3/cumulus-workshop/pt3',
+        title: `Launch a parachain testnet`,
+        link: '/tutorials/v3/cumulus/pt3',
       },
+      //   {
+      //     title: `Register on Rococo`,
+      //     link: '/tutorials/v3/cumulus/pt4',
+      //   },
     ],
   },
 ])

src/pages/tutorials/v3.tsx

@@ -11,9 +11,7 @@ export default function tutorials({ data }: any) {
     <Layout>
       <SEO title="Tutorials" />
       <div className="px-4">
-        <h1 className="text-center my-8 lg:my-12">
-          {intl.formatMessage({ id: 'nav-tutorials' })}
-        </h1>
+        <h1 className="text-center my-8 lg:my-12">{intl.formatMessage({ id: 'nav-tutorials' })}</h1>
         <div className="mb-40 flex flex-col items-center md:flex-row md:flex-wrap md:justify-center">
           <TutorialCard
             title={`Create Your First Substrate Chain`}
@@ -116,14 +114,14 @@ export default function tutorials({ data }: any) {
             link={`/tutorials/v3/frontier`}
           />
           <TutorialCard
-            title={`Cumulus Workshop`}
+            title={`Create a Parachain with Cumulus`}
             image={data.tutorialNine}
-            description={`A workshop to configure a Substrate node as a Parachain`}
+            description={`Learn to use the parachain template in local testnet`}
             time={`3 Hours`}
             difficulty={3}
             prerequisites={true}
-            version={`V3.0.0`}
-            link={`/tutorials/v3/cumulus-workshop/pt1`}
+            version={`polkadot-0.9.10`}
+            link={`/tutorials/v3/cumulus/pt1`}
           />
         </div>
       </div>

static/_redirects

@@ -37,10 +37,10 @@
 /docs/en/tutorials/frontier/*                  /tutorials/v3/frontier/*                301!
 
 ### Tutorial - Cumulus Workshop
-/tutorials/substrate-cumulus-workshop               /tutorials/v3/cumulus-workshop          301!
-/tutorials/substrate-cumulus-workshop/*             /tutorials/v3/cumulus-workshop          301!
-/cumulus-workshop                                   /tutorials/v3/cumulus-workshop          301!
-/cumulus-workshop/*                                 /tutorials/v3/cumulus-workshop          301!
+/tutorials/substrate-cumulus-workshop               /tutorials/v3/cumulus/p1                301!
+/tutorials/substrate-cumulus-workshop/*             /tutorials/v3/cumulus/p1                301!
+/cumulus-workshop                                   /tutorials/v3/cumulus/p1                301!
+/cumulus-workshop/*                                 /tutorials/v3/cumulus/p1                301!
 
 ### Tutorial - Kitties Workshop
 /tutorials/kitties                                  /tutorials/v3/kitties                   301!

static/assets/tutorials/cumulus/node-start-local-testing.sh

@@ -0,0 +1,37 @@
+# Build Spec
+./target/release/polkadot build-spec --chain rococo-local --disable-default-bootnode > rococo-custom-2-plain.json
+./target/release/polkadot build-spec --chain rococo-custom-2-plain.json --raw --disable-default-bootnode > rococo-custom-2-raw.json
+
+# modify from snipets to copy and make 3 & 4 validator plain specs
+
+./target/release/polkadot build-spec --chain rococo-custom-3-plain.json --raw --disable-default-bootnode > rococo-custom-3-raw.json
+./target/release/polkadot build-spec --chain rococo-custom-4-plain.json --raw --disable-default-bootnode > rococo-custom-4-raw.json
+
+# Clear old DBs
+
+rm -rf /tmp/relay /tmp/parachain
+
+# Relay Validators with 2 validator chainspec
+./target/release/polkadot --alice --validator --base-path /tmp/relay/alice --chain ../cumulus-workshop/shared/chainspecs/rococo-custom-2-raw.json --port 30333 --ws-port 9944
+
+./target/release/polkadot --bob --validator --base-path /tmp/relay/bob --chain ../cumulus-workshop/shared/chainspecs/rococo-custom-2-raw.json --port 30334 --ws-port 9945
+
+# ./target/release/polkadot --charlie --validator --base-path /tmp/relay/charlie --chain ../cumulus-workshop/shared/chainspecs/rococo-custom-2-raw.json --port 30335 --ws-port 9946
+
+# Register para ID 2000 with `Charlie`
+# https://polkadot.js.org/apps/?rpc=ws%3A%2F%2F127.0.0.1%3A9944#/parachains/parathreads
+
+# Parachain collators gen state
+./target/release/parachain-collator export-genesis-state --parachain-id 2000 > para-2000-genesis
+# Parachain collators gen wasm
+./target/release/parachain-collator export-genesis-wasm > para-2000-wasm
+
+# Submit (as sudo) parasSudoWrapper -> sudoScheduleParaInitialize(id, genesis) for parachain 2000
+# https://polkadot.js.org/apps/?rpc=ws%3A%2F%2F127.0.0.1%3A9944#/sudo
+# Parachain = Yes (true)
+
+# Parachain collator launch
+./target/release/parachain-collator --alice --collator --force-authoring --parachain-id 2000 --base-path /tmp/parachain/alice --port 40333 --ws-port 8844 -- --execution wasm --chain ../cumulus-workshop/shared/chainspecs/rococo-custom-2-raw.json --port 30343 --ws-port 9977
+
+# Force que action to speed up (as sudo): paras -> forceQueueAction(para) for 2000
+# https://polkadot.js.org/apps/?rpc=ws%3A%2F%2F127.0.0.1%3A9944#/sudo

v3/how-to-guides/07-parachains/c-reserve-id/index.mdx

@@ -1,8 +1,8 @@
 ---
 title: How to reserve a ParaID
 slug: /how-to-guides/v3/parachains/reserve-id
-keywords: parachains, paraID
-version: 3.0 
+keywords: parachains, para ID
+version: 3.0
 section: how to guides
 category: parachains
 difficulty: 1
@@ -34,4 +34,5 @@ creating channels to other parachains for XCM, starting a crowdloan, etc.
 - Reserve the ParaID. This operation requires a deposit.
 
 ## Examples
+
 [TODO]

v3/how-to-guides/07-parachains/d-register/index.mdx

@@ -34,11 +34,11 @@ To register your parachain you need to provide your ParaID, genesis state and
 your compressed WASM validation logic.
 
 - Generate
-  [parachain Genesis state](/tutorials/v3/cumulus-workshop/pt2#3-generate-parachain-genesis-state)
-- [Obtain WASM runtime validation logic](/tutorials/v3/cumulus-workshop/pt2#4-obtain-wasm-runtime-validation-function).
+  [parachain Genesis state](/tutorials/v3/cumulus/pt2#3-generate-parachain-genesis-state)
+- [Obtain WASM runtime validation logic](/tutorials/v3/cumulus/pt2#4-obtain-wasm-runtime-validation-function).
   maximum size of the WASM blob is 750 kilobytes on Kusama
 - Compress WASM validation logic
-- [Register the parachain](/tutorials/v3/cumulus-workshop/pt2#parachain-registration).
+- [Register the parachain](/tutorials/v3/cumulus/pt2#parachain-registration).
   This transaction requires a deposit. The amount of the deposit depends on the
   size of the WASM blob and the genesis states.
 - Check and calculate the exact formulas for deposit calculation for
@@ -48,5 +48,5 @@ your compressed WASM validation logic.
 
 ## Examples
 
-[register-paraid]: /tutorials/v3/cumulus-workshop/pt2#1-reserve-a-para-id
+[register-paraid]: /tutorials/v3/cumulus/pt2#1-reserve-a-para-id
 [crowdloan-paraid]: https://wiki.polkadot.network/docs/learn-crowdloans

v3/how-to-guides/07-parachains/e-start-collator-node/index.mdx

@@ -68,11 +68,11 @@ become a collator. Use the democracy pallet to elect these members and define th
 
 ### 2. Starting a collator node
 
-Refer to [this guide](/tutorials/v3/cumulus-workshop/pt2#5-start-the-collator-node) to start and set up a collator node.
+Refer to [this guide](/tutorials/v3/cumulus/pt2#5-start-the-collator-node) to start and set up a collator node.
 
 ### 3. Adding collators
 
-Refer to [this instruction](/tutorials/v3/cumulus-workshop/pt2#1-start-the-second-collator) to add more collators.
+Refer to [this instruction](/tutorials/v3/cumulus/pt2#1-start-the-second-collator) to add more collators.
 
 ## Examples
 

v3/how-to-guides/07-parachains/f-start-testnet/index.mdx

@@ -1,14 +1,16 @@
 ---
 title: Start a testnet on Rococo
 slug: /how-to-guides/v3/parachains/rococo
-keywords: parachains, paraID
-version: 3.0 
+keywords: parachains, para ID
+version: 3.0
 section: how to guides
 category: parachains
 ---
 
 ## Goal
+
 Start up a local testnetwork on Rococo.
+
 ## Use cases
 
 ## Overview
@@ -31,7 +33,7 @@ cargo run -- \
 
 ### 2. Start Bob
 
-Use Alice's  local node identity as shown in the stdout logs to declare as a bootnode.
+Use Alice's local node identity as shown in the stdout logs to declare as a bootnode.
 
 ```bash
 cargo run -- \
@@ -55,6 +57,6 @@ cargo run -- \
 
 #### Docs
 
-#### Other 
+#### Other
 
-- [Polkadot Wiki on Using Rococo](https://wiki.polkadot.network/docs/build-pdk#testing-a-parachain-rococo-testnet)
+- [Polkadot Wiki on Using Rococo](https://wiki.polkadot.network/docs/build-pdk#testing-a-parachain-rococo-testnet)