Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
21d5e01
Add system parachain RPC guide and enhance documentation
brunopgalvao Nov 18, 2025
43339dc
Merge branch 'staging/product-ia' into bruno/infra/running-a-collator
brunopgalvao Nov 18, 2025
cb3ac55
Update system parachain RPC guide to latest versions
brunopgalvao Nov 19, 2025
6dc4298
Merge staging/product-ia into bruno/infra/running-a-collator
brunopgalvao Nov 19, 2025
9105f65
Update software versions and dependencies
brunopgalvao Nov 19, 2025
ed97e71
Update content
brunopgalvao Nov 20, 2025
656920e
initial look at collator.md
dawnkelly09 Nov 20, 2025
b04156a
tweak admo
dawnkelly09 Nov 20, 2025
dbd2d98
wip - collator page
dawnkelly09 Nov 21, 2025
fc25788
finish collator pre-tech review pass
dawnkelly09 Nov 21, 2025
2de9f46
clean up formatting for RPC node page
dawnkelly09 Nov 21, 2025
3b791ac
formatting edits
dawnkelly09 Nov 21, 2025
b84d71d
Update guides
brunopgalvao Nov 24, 2025
7870c65
Merge remote changes with tabbed content structure
brunopgalvao Nov 24, 2025
a9f8340
Use polkadot-parachain binary instead of polkadot-omni-node
brunopgalvao Nov 24, 2025
35d51a0
Update llms
brunopgalvao Nov 24, 2025
fda3e1c
Download polkadot-parachain binary from GitHub releases instead of Do…
brunopgalvao Nov 24, 2025
e517594
Use MkDocs admonition syntax for notes and warnings
brunopgalvao Nov 24, 2025
1c3288f
Fix GitHub release tag to polkadot-stable2509-2
brunopgalvao Nov 24, 2025
1859915
Restructure parachain-rpc.md to use tabbed content layout
brunopgalvao Nov 24, 2025
f645cca
Add Docker commands to collator.md monitoring and maintenance sections
brunopgalvao Nov 24, 2025
1a74bf4
Update content
brunopgalvao Nov 24, 2025
6822d57
wip rpc page cleanup
dawnkelly09 Nov 24, 2025
65132ed
Update content
brunopgalvao Nov 26, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
86 changes: 86 additions & 0 deletions .ai/pages/node-infrastructure-overview.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,86 @@
---
title: Node Infrastructure
description: Overview of running nodes in the Polkadot ecosystem, including RPC nodes, collators, and validators.
categories: Infrastructure
url: https://docs.polkadot.com/node-infrastructure/overview/
---

# Node Infrastructure Overview

## Introduction

The Polkadot network relies on various types of nodes to maintain security, provide data access, and produce blocks. This section covers everything you need to know about running infrastructure for the Polkadot ecosystem.

Whether you want to provide RPC endpoints for applications, produce blocks for a parachain, or secure the relay chain as a validator, this guide will help you understand your options and get started.

## Node Types

### RPC Nodes

RPC nodes provide API access to blockchain data without participating in consensus. They are essential infrastructure for:

- **Applications and dApps**: Query blockchain state and submit transactions
- **Block explorers**: Index and display blockchain data
- **Wallets**: Check balances and broadcast transactions
- **Development**: Test and debug applications

RPC nodes can be run for both the relay chain and parachains, with varying levels of data retention:

- **Pruned Nodes**: Keep recent state and a limited number of finalized blocks. Suitable for most applications that only need current state and recent history. More efficient in terms of storage and sync time.
- **Archive Nodes**: Maintain complete historical state and all blocks since genesis. Required for block explorers, analytics platforms, or applications that need to query historical data at any point in time.

**Transaction Broadcasting**: RPC nodes play a crucial role in transaction submission and propagation. When a client submits a transaction via RPC methods like `author_submitExtrinsic`, the node validates the transaction format, adds it to its local transaction pool, and broadcasts it across the P2P network. Block producers (collators or validators) then pick up these transactions from their pools for inclusion in blocks. This makes RPC nodes the primary gateway for users and applications to interact with the blockchain.

### Collators

Collators are block producers for parachains. They perform critical functions:

- **Collect transactions**: Aggregate user transactions into blocks
- **Produce blocks**: Create parachain block candidates
- **Generate and package PoV**: Generate the Proof-of-Validity containing the state transition proof and necessary witness data for validation
- **Submit to validators**: Send block candidates and PoVs to relay chain validators

Unlike validators, collators do not provide security guarantees—that responsibility lies with relay chain validators. However, collators are essential for parachain liveness and censorship resistance.

### Validators

Validators secure the Polkadot relay chain through [Nominated Proof of Stake (NPoS)](https://wiki.polkadot.network/docs/learn-staking){target=\_blank}. They:

- **Validate blocks**: Verify parachain blocks and relay chain transactions
- **Participate in consensus**: Run [BABE](https://wiki.polkadot.network/docs/learn-consensus#babe-block-production){target=\_blank} and [GRANDPA](https://wiki.polkadot.network/docs/learn-consensus#grandpa-finality-gadget){target=\_blank} protocols
- **Earn rewards**: Receive staking rewards for honest behavior
- **Risk slashing**: Face penalties for misbehavior or downtime

Running a validator requires significant technical expertise, reliable infrastructure, and a stake of DOT tokens.

## Next Steps

Choose your path based on your goals:

<div class="grid cards" markdown>

- :material-api:{ .lg .middle } **Run RPC Nodes**

---

Provide API access for applications, explorers, and wallets

[:octicons-arrow-right-24: Run a Node](/node-infrastructure/run-a-node/parachain-rpc/)

- :material-cube-outline:{ .lg .middle } **Run a Collator**

---

Produce blocks for system parachains or your own parachain

[:octicons-arrow-right-24: Run a Collator](/node-infrastructure/run-a-collator/collator/)

- :material-shield-check:{ .lg .middle } **Run a Validator**

---

Secure the relay chain and earn staking rewards

[:octicons-arrow-right-24: Run a Validator](/node-infrastructure/run-a-validator/requirements/)

</div>
Loading
Loading