[Polkadot Wiki Migration] Set up a Full Node #33

CrackTheCode016 · 2024-09-17T17:06:28Z

This page was migrated from https://wiki.polkadot.network/docs/maintain-sync#setup-instructions

infrastructure/general/setup-full.md

github-actions · 2024-09-17T17:06:54Z

infrastructure/general/setup-full.md

+    On [Stakeworld](https://stakeworld.io/docs/dbsize){target=_blank} you can find a list of the database sizes of Polkadot and Kusama nodes.
+
+Archive nodes are used by utilities that need past information - like block explorers, council
+scanners, discussion platforms like [Polkassembly](https://polkassembly.io){target=_blank}, and others. They need


🚫 [vale] _{reported by reviewdog 🐶}
[Papermoon.CustomDictionary] Did you really mean 'Polkassembly'?

@dawnkelly09 should probably add this one if not already added

infrastructure/general/setup-full.md

dawnkelly09 · 2024-09-19T14:35:00Z

Scan for Vale false positives. Resolved convos = made it on the update list and should go away now. I left comments for the legit flags with suggested edits. Thank you!

Co-authored-by: Dawn Kelly <[email protected]>

github-actions · 2024-09-20T21:55:00Z

infrastructure/general/setup-full.md

+
+### Types of Nodes
+
+A blockchain's growth comes from a _genesis block_, _extrinsics_, and _events_.


🚫 [vale] _{reported by reviewdog 🐶}
[Vale.Spelling] Did you really mean 'blockchain's'?

github-actions · 2024-09-20T21:55:00Z

infrastructure/general/setup-full.md

+
+### Types of Nodes
+
+A blockchain's growth comes from a _genesis block_, _extrinsics_, and _events_.


🚫 [vale] _{reported by reviewdog 🐶}
[Papermoon.CustomDictionary] Did you really mean 'blockchain's'?

github-actions · 2024-09-20T21:55:01Z

infrastructure/general/setup-full.md

+
+### Types of Nodes
+
+A blockchain's growth comes from a _genesis block_, _extrinsics_, and _events_.


🚫 [vale] _{reported by reviewdog 🐶}
[Papermoon.CustomDictionary] Did you really mean 'extrinsics'?

github-actions · 2024-09-20T21:55:01Z

infrastructure/general/setup-full.md

+
+<!-- TODO: we should explain this concept of "sealing" -->
+
+When a validator seals block 1, it takes the blockchain's state at block 0. It then applies all


🚫 [vale] _{reported by reviewdog 🐶}
[Papermoon.CustomDictionary] Did you really mean 'blockchain's'?

github-actions · 2024-09-20T21:55:01Z

infrastructure/general/setup-full.md

+
+<!-- TODO: we should explain this concept of "sealing" -->
+
+When a validator seals block 1, it takes the blockchain's state at block 0. It then applies all


🚫 [vale] _{reported by reviewdog 🐶}
[Vale.Spelling] Did you really mean 'blockchain's'?

github-actions · 2024-09-20T21:55:01Z

infrastructure/general/setup-full.md

+avoid needing to sync from genesis with the network and only need the states of blocks past that
+snapshot.
+
+Full nodes allow you to read the current state of the chain and to submit and validate extrinsics


🚫 [vale] _{reported by reviewdog 🐶}
[Papermoon.CustomDictionary] Did you really mean 'extrinsics'?

github-actions · 2024-09-20T21:55:01Z

infrastructure/general/setup-full.md

+Another type of node is a *light node*. A light node has only the runtime and the current state
+but doesn't store past blocks and so cannot read historical data without requesting it from a node
+that has it. Light nodes are useful for resource-restricted devices. An interesting use-case of
+light nodes is a browser extension, which is a node in its own right, running the runtime in WebAssembly


⚠️ [vale] _{reported by reviewdog 🐶}
[Papermoon.WordSwapList] Use 'Wasm' instead of 'WebAssembly'.

github-actions · 2024-09-20T21:55:01Z

infrastructure/general/setup-full.md

+but doesn't store past blocks and so cannot read historical data without requesting it from a node
+that has it. Light nodes are useful for resource-restricted devices. An interesting use-case of
+light nodes is a browser extension, which is a node in its own right, running the runtime in WebAssembly
+format, as well as a full or light node that is completely encapsulated in WebAssembly and can be


⚠️ [vale] _{reported by reviewdog 🐶}
[Papermoon.WordSwapList] Use 'Wasm' instead of 'WebAssembly'.

github-actions · 2024-09-20T21:55:01Z

infrastructure/general/setup-full.md

+
+!!!note Substrate Connect
+    [Substrate Connect](https://github.com/paritytech/substrate-connect){target=_blank} provides a way to interact with
+    substrate-based blockchains in the browser without using an RPC server. It is a light node that runs


🚫 [vale] _{reported by reviewdog 🐶}
[Papermoon.CustomDictionary] Did you really mean 'blockchains'?

github-actions · 2024-09-20T21:55:01Z

infrastructure/general/setup-full.md

+    substrate-based blockchains in the browser without using an RPC server. It is a light node that runs
+    entirely in JavaScript. Substrate Connect uses a
+    [Smoldot Wasm light client](https://github.com/paritytech/smoldot){target=_blank} to securely connect to the
+    blockchain network without relying on specific third parties. Substrate Connect is available on Chrome


🚫 [vale] _{reported by reviewdog 🐶}
[Papermoon.CustomDictionary] Did you really mean 'blockchain'?

nhussein11 · 2024-10-01T12:53:45Z

infrastructure/general/.pages

@@ -1,3 +1,4 @@
 title: General Infrastructure
 nav:
  - index.md
+  - setup-full.md


Suggested change

- setup-full.md

- 'Set up a Full Node': setup-full.md

nhussein11 · 2024-10-01T14:32:14Z

infrastructure/general/setup-full.md

+
+<!-- TODO - maybe we keep this as a "intro" page for the infrastructure section, and make this page more focused post-merge? -->
+
+### Types of Nodes


I think it would be nice to have sub-headers like:

Full Node

Light Node

and so on..

I think it would be nice to have sub-headers like:

Full Node

Light Node

and so on..

This would be better, as now it seems like a massive amount of text

nhussein11 · 2024-10-01T14:33:05Z

infrastructure/general/setup-full.md

+that has it. Light nodes are useful for resource-restricted devices. An interesting use-case of
+light nodes is a browser extension, which is a node in its own right, running the runtime in WebAssembly
+format, as well as a full or light node that is completely encapsulated in WebAssembly and can be
+integrated into web apps: [Smoldot](https://github.com/smol-dot/smoldot.){target=_blank}


This link is broken

nhussein11 · 2024-10-01T14:41:54Z

infrastructure/general/setup-full.md

+    ./polkadot --name "Your Node's Name"
+    ```
+
+    - Find your node on [Telemetry](https://telemetry.polkadot.io/#list/Polkadot){target=_blank}


I'd add that you need to wait until your node is sync and then you will find it there

nhussein11 · 2024-10-01T14:48:57Z

infrastructure/general/setup-full.md

+    - Run the following: `sudo chmod +x polkadot`
+    - Run the following:


This may be nitpicking, but I'd try to avoid this titles since are not super descriptive of the command that the user will run, maybe:

"Provide execution rights to the polkadot binary:"

sudo chmod +x polkadot

nhussein11 · 2024-10-01T14:50:33Z

infrastructure/general/setup-full.md

+    ```bash
+    # Import the [email protected] GPG key
+    gpg --recv-keys --keyserver hkps://keys.mailvelope.com 9D4B2B6EB8F97156D19669A9FF0812D491B96798
+    gpg --export 9D4B2B6EB8F97156D19669A9FF0812D491B96798 > /usr/share/keyrings/parity.gpg
+    # Add the Parity repository and update the package index
+    echo 'deb [signed-by=/usr/share/keyrings/parity.gpg] https://releases.parity.io/deb release main' > /etc/apt/sources.list.d/parity.list
+    apt update
+    # Install the `parity-keyring` package - This will ensure the GPG key
+    # used by APT remains up-to-date
+    apt install parity-keyring
+    # Install polkadot
+    apt install polkadot
+
+    ```


These bash elements should be moved to a code snippet

nhussein11 · 2024-10-01T14:50:59Z

infrastructure/general/setup-full.md

+    ```bash
+    # Install dnf-plugins-core (This might already be installed)
+    dnf install dnf-plugins-core
+    # Add the repository and enable it
+    dnf config-manager --add-repo https://releases.parity.io/rpm/polkadot.repo
+    dnf config-manager --set-enabled polkadot
+    # Install polkadot (You may have to confirm the import of the GPG key, which
+    # should have the following fingerprint: 9D4B2B6EB8F97156D19669A9FF0812D491B96798)
+    dnf install polkadot
+    ```


Please, move this bash elemento to a code snippet :)

nhussein11 · 2024-10-01T14:52:24Z

infrastructure/general/setup-full.md

+The [`paritytech/polkadot`](https://github.com/paritytech/polkadot-sdk/tree/master/polkadot) repository
+master branch contains the latest Polkadot code. To install it as a binary, `cargo` may be used to install directly from a specific release:
+
+<!-- TODO: better instructions for installing polka binary -->


I'm a bit confused with this section, it seems that the content it covers overlaps with the last section here. Could you please take a look at it?

nhussein11 · 2024-10-01T14:53:54Z

infrastructure/general/setup-full.md

+```zsh
+docker run -p 9944:9944 -p 9615:9615 parity/polkadot:v0.9.13 --name "calling_home_from_a_docker_container" --rpc-external --prometheus-external
+```


Suggested change

```zsh

docker run -p 9944:9944 -p 9615:9615 parity/polkadot:v0.9.13 --name "calling_home_from_a_docker_container" --rpc-external --prometheus-external

```

```bash

docker run \

-p 9944:9944 \

-p 9615:9615 parity/polkadot:v0.9.13 \

--name "calling_home_from_a_docker_container" \

--rpc-external \

--prometheus-external

nhussein11 · 2024-10-01T15:01:42Z

infrastructure/general/setup-full.md

+    polkadot --name "Your Node's Name" --chain kusama
+    ```
+
+=== "macOS"


If we plan to migrate https://docs.substrate.io/install/ this section will be duplicated

We can reference that section, but for now, it think it makes sense having it here

0xLucca · 2024-10-03T12:06:04Z

infrastructure/general/setup-full.md

+If you're building dApps or products on a Substrate-based chain like Polkadot, Kusama, or a custom
+Substrate implementation, you want the ability to run a node-as-a-back-end. After all, relying on
+your infrastructure is always better than a third-party-hosted one in this brave new decentralized
+world.


Suggested change

If you're building dApps or products on a Substrate-based chain like Polkadot, Kusama, or a custom

Substrate implementation, you want the ability to run a node-as-a-back-end. After all, relying on

your infrastructure is always better than a third-party-hosted one in this brave new decentralized

world.

## Introduction

If you're building dApps or products on a Polkadot SDK-based chain like Polkadot, Kusama, or a custom implementation, you want the ability to run a node-as-a-back-end. After all, relying on

your infrastructure is always better than a third-party-hosted one in this brave new decentralized

world.

0xLucca · 2024-10-03T12:08:37Z

infrastructure/general/setup-full.md

+This guide will show you how to connect to [Polkadot](https://polkadot.network/), but the
+same process applies to any other [Substrate](https://substrate.io)-based chain.


Suggested change

This guide will show you how to connect to [Polkadot](https://polkadot.network/), but the

same process applies to any other [Substrate](https://substrate.io)-based chain.

This guide will show you how to connect to [Polkadot](https://polkadot.network/){target=\_blank}, but the

same process applies to any other [Polkadot SDK](https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/polkadot_sdk/index.html){target=\_blank}-based chain.

0xLucca · 2024-10-03T12:11:38Z

infrastructure/general/setup-full.md

+
+<!-- TODO - maybe we keep this as a "intro" page for the infrastructure section, and make this page more focused post-merge? -->
+
+### Types of Nodes


I think it would be nice to have sub-headers like:

Full Node

Light Node

and so on..

This would be better, as now it seems like a massive amount of text

0xLucca · 2024-10-03T12:13:10Z

infrastructure/general/setup-full.md

+
+=== "macOS"
+
+    - Install Homebrew within the terminal by running:


There are some formatting issues with this list items. Also, you could use a numeric list instead of -

0xLucca · 2024-10-03T12:15:03Z

infrastructure/general/setup-full.md

+Congratulations, you're now syncing with Polkadot. Keep in mind that the process is identical when
+using any other Polkadot SDK-based chain.
+
+## Running an Archive Node


This section seems out of place

CrackTheCode016 added 3 commits September 17, 2024 12:23

initial content

468bb36

more changes

26cd5af

todos

b022152

CrackTheCode016 added In Progress Infrastructure labels Sep 17, 2024

github-actions bot reviewed Sep 17, 2024

View reviewed changes

Apply suggestions from code review

a175958

Co-authored-by: Dawn Kelly <[email protected]>

github-actions bot reviewed Sep 20, 2024

View reviewed changes

comments

8d36cca

CrackTheCode016 added Ready for Review and removed In Progress labels Sep 20, 2024

nhussein11 reviewed Oct 1, 2024

View reviewed changes

0xLucca requested changes Oct 3, 2024

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[Polkadot Wiki Migration] Set up a Full Node #33

[Polkadot Wiki Migration] Set up a Full Node #33

CrackTheCode016 commented Sep 17, 2024

github-actions bot Sep 17, 2024

CrackTheCode016 Sep 20, 2024

dawnkelly09 commented Sep 19, 2024

github-actions bot Sep 20, 2024

github-actions bot Sep 20, 2024

github-actions bot Sep 20, 2024

github-actions bot Sep 20, 2024

github-actions bot Sep 20, 2024

github-actions bot Sep 20, 2024

github-actions bot Sep 20, 2024

github-actions bot Sep 20, 2024

github-actions bot Sep 20, 2024

github-actions bot Sep 20, 2024

nhussein11 Oct 1, 2024

nhussein11 Oct 1, 2024

0xLucca Oct 3, 2024

nhussein11 Oct 1, 2024

nhussein11 Oct 1, 2024

nhussein11 Oct 1, 2024

nhussein11 Oct 1, 2024

nhussein11 Oct 1, 2024

nhussein11 Oct 1, 2024

nhussein11 Oct 1, 2024

nhussein11 Oct 1, 2024

0xLucca Oct 3, 2024

0xLucca Oct 3, 2024

0xLucca Oct 3, 2024

0xLucca Oct 3, 2024

0xLucca Oct 3, 2024


		### Types of Nodes

		A blockchain's growth comes from a _genesis block_, _extrinsics_, and _events_.


		<!-- TODO: we should explain this concept of "sealing" -->

		When a validator seals block 1, it takes the blockchain's state at block 0. It then applies all


		<!-- TODO - maybe we keep this as a "intro" page for the infrastructure section, and make this page more focused post-merge? -->

		### Types of Nodes

		- Run the following: `sudo chmod +x polkadot`
		- Run the following:

-```zsh
-docker run -p 9944:9944 -p 9615:9615 parity/polkadot:v0.9.13 --name "calling_home_from_a_docker_container" --rpc-external --prometheus-external
-```
+```bash
+docker run \
+-p 9944:9944 \
+-p 9615:9615 parity/polkadot:v0.9.13 \
+--name "calling_home_from_a_docker_container" \
+--rpc-external \
+--prometheus-external

		This guide will show you how to connect to [Polkadot](https://polkadot.network/), but the
		same process applies to any other [Substrate](https://substrate.io)-based chain.


		=== "macOS"

		- Install Homebrew within the terminal by running:

[Polkadot Wiki Migration] Set up a Full Node #33

Are you sure you want to change the base?

[Polkadot Wiki Migration] Set up a Full Node #33

Conversation

CrackTheCode016 commented Sep 17, 2024

github-actions bot Sep 17, 2024

Choose a reason for hiding this comment

Choose a reason for hiding this comment

dawnkelly09 commented Sep 19, 2024

github-actions bot Sep 20, 2024

Choose a reason for hiding this comment

github-actions bot Sep 20, 2024

Choose a reason for hiding this comment

github-actions bot Sep 20, 2024

Choose a reason for hiding this comment

github-actions bot Sep 20, 2024

Choose a reason for hiding this comment

github-actions bot Sep 20, 2024

Choose a reason for hiding this comment

github-actions bot Sep 20, 2024

Choose a reason for hiding this comment

github-actions bot Sep 20, 2024

Choose a reason for hiding this comment

github-actions bot Sep 20, 2024

Choose a reason for hiding this comment

github-actions bot Sep 20, 2024

Choose a reason for hiding this comment

github-actions bot Sep 20, 2024

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Full Node

Light Node

Choose a reason for hiding this comment

Full Node

Light Node

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Full Node

Light Node

Choose a reason for hiding this comment

Choose a reason for hiding this comment