Skip to content

Conversation

@brunopgalvao
Copy link
Contributor

@brunopgalvao brunopgalvao commented Nov 18, 2025

Summary

Resolves #1216
Resolves #1217
Resolves #1185

Refactored the "Nodes and Validators" section to accommodate Polkadot Hub, collators, and system parachains with an emphasis on running a Polkadot Hub RPC node. With this, the section has been renamed to "Node Infrastructure" to better accommodate what is contained in this section (Polkadot Hub RPC node, system parachain RPC node, relay chain nodes, collators, validators, etc)

New content to:

  • setup and run a Polkadot Hub RPC node
  • setup and run a system parachain RPC node
  • setup and run a block-producing collator

- Add comprehensive guide for running system parachain RPC nodes
  - Covers People Chain, Bridge Hub, and Coretime Chain
  - Provides both Docker and systemd deployment options
  - Includes snapshot setup, monitoring, and security best practices
- Add conclusion sections to RPC and collator guides
  - polkadot-hub-rpc.md: summarize benefits and next steps
  - system-parachain-rpc.md: highlight adaptability across system parachains
  - collator.md: emphasize operator role and responsibilities
- Restructure documentation from nodes-and-validators to node-infrastructure
@brunopgalvao brunopgalvao self-assigned this Nov 18, 2025
@brunopgalvao brunopgalvao changed the title Add system parachain RPC guide and enhance documentation Add Polkadot Hub RPC node, system parachain RPC node, and collator pages Nov 18, 2025
@brunopgalvao brunopgalvao added B0 - Needs Review Pull request is ready for review C1 - Medium Medium priority task A0 - New Content Pull request contains new content pages labels Nov 18, 2025
- Resolve conflict in .nav.yml by keeping 'Node Infrastructure' and adding 'Technical Reference'
- Integrate latest changes from staging/product-ia
@brunopgalvao brunopgalvao changed the title Add Polkadot Hub RPC node, system parachain RPC node, and collator pages Add node infrastructure guides and restructure section Nov 18, 2025
Update polkadot-omni-node from stable2506-4 to v1.20.2 and Rust from 1.86 to 1.91.1 in the system parachain RPC documentation. This ensures users are working with the latest stable releases.

Changes:
- Docker image: parity/polkadot-omni-node:v1.20.2
- Cargo package: polkadot-omni-node@0.11.0
- Rust toolchain: 1.91.1

All versions have been tested and verified to work correctly.
Resolve merge conflict in .nav.yml by keeping the Node Infrastructure
navigation structure from this branch.
@brunopgalvao brunopgalvao marked this pull request as ready for review November 19, 2025 09:56
@brunopgalvao brunopgalvao requested a review from a team as a code owner November 19, 2025 09:56
- Update Rust toolchain to 1.91.1 (from 1.86)
- Update polkadot-omni-node to v0.11.0 for collator (from v0.5.0)
- Update Docker image to v1.20.2 for RPC nodes (from stable2506-4)
- Update chain-spec-builder to v14.0.0 (from v10.0.0)
- Update AI-generated page files to reflect latest changes
- Clean up old nodes-and-validators AI page files
Copy link
Collaborator

@dawnkelly09 dawnkelly09 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not done yet but wanted to surface a couple of questions for @brunopgalvao


## Complete Initial Sync

Your collator must sync both the relay chain and parachain before producing blocks.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm confused as to why we are telling them they must do this, but we give no steps/guidance as to how to do it. Is there a guide somewhere else we can at least point them toward?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When they run the collator it will do this automatically.


## Install Dependencies

1. Install Rust using the following commands:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please clarify whether the user should run both of these Rust installation commands (# Install Rust vs # Install specific Rust version) or pick one or the other.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes they should run all commands inside that snippet.

Copy link
Collaborator

@nhussein11 nhussein11 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Left some comment for polkadot-hub-rpc page, but please check that most of them also apply to parachain-rpc.md

@brunopgalvao
Copy link
Contributor Author

Images for collator.md, "Register Collator for Selection" > "Registration Process" section.

collatorSelection.invulnerables()

collatorSelection invulnerables

session.setKeys

session setKeys

collatorSelection.registerAsCandidate

collatorSelection registerAsCandidate

```

The output will be similar to the following:
```bash
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be a termynal element

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is a termynal element that seems broken here

image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A0 - New Content Pull request contains new content pages B0 - Needs Review Pull request is ready for review C1 - Medium Medium priority task

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants