[FIX] - update deploy-to-testnet.md to note deprecation of para_id in chain specs
#775
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
nhussein11
added
B0 - Needs Review
nhussein11
added
the
A2 - Maintenance Minor
There was a problem hiding this comment.
Pull Request Overview
This PR updates the parachain deployment documentation to note the deprecation and upcoming removal of the para_id field in chain specifications and guides developers to implement the GetParachainInfo runtime API.
- Add a deprecation note about
para_idindeploy-to-testnet.md - Mirror the same note in
llms.txtfor generated docs
Reviewed Changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| tutorials/polkadot-sdk/parachains/zero-to-hero/deploy-to-testnet.md | Added deprecation notice and upgrade guidance |
| llms.txt | Updated generated docs with the same deprecation note |
Comments suppressed due to low confidence (1)
tutorials/polkadot-sdk/parachains/zero-to-hero/deploy-to-testnet.md:154
- The introduction version
stable2509conflicts with the PR description mentioning deprecation starting instable2512. Please align these version numbers to avoid confusion.
The `para_id` field in JSON chain specifications, added through the [`chain-spec-builder`](https://paritytech.github.io/polkadot-sdk/master/staging_chain_spec_builder/index.html){target=\_blank} command, is currently used by nodes for configuration purposes. However, beginning with Polkadot SDK release `stable2509`, the `para_id` field will no longer be required in chain specifications. Instead, runtimes need to be updated to implement the [`cumulus_primitives_core::GetParachainInfo`](https://paritytech.github.io/polkadot-sdk/master/cumulus_primitives_core/trait.GetParachainInfo.html){target=\_blank} trait to successfully operate with nodes using chain specs that omit the `para_id` field.
brunopgalvao
approved these changes
Jul 11, 2025
eshaben
approved these changes
Jul 14, 2025
eshaben
deleted the
689-polkadot-omni-node-para_id-key-from-generated-chain-specs-is-deprecated
branch
iulianbarbu
reviewed
Jul 15, 2025
|
|
||
| The `para_id` field in JSON chain specifications, added through the [`chain-spec-builder`](https://paritytech.github.io/polkadot-sdk/master/staging_chain_spec_builder/index.html){target=\_blank} command, is currently used by nodes for configuration purposes. However, beginning with Polkadot SDK release `stable2509`, the `para_id` field will no longer be required in chain specifications. Instead, runtimes need to be updated to implement the [`cumulus_primitives_core::GetParachainInfo`](https://paritytech.github.io/polkadot-sdk/master/cumulus_primitives_core/trait.GetParachainInfo.html){target=\_blank} trait to successfully operate with nodes using chain specs that omit the `para_id` field. | ||
|
|
||
| With the upcoming `stable2512` release, the `para_id` field will be completely removed from chain specifications in favor of the new runtime API. New nodes will be unable to start with chain specs containing the `para_id` field unless the runtime implements the `GetParachainInfo` trait. Ensure your runtime is updated to maintain compatibility with future node versions. |
There was a problem hiding this comment.
Hey @nhussein11 ! Sorry for the trouble, FYI see this: paritytech/polkadot-sdk#8740 (comment). We'll need to update this section, and I'll open an issue soon.
iulianbarbu
reviewed
Jul 15, 2025
|
|
||
| The `para_id` field in JSON chain specifications, added through the [`chain-spec-builder`](https://paritytech.github.io/polkadot-sdk/master/staging_chain_spec_builder/index.html){target=\_blank} command, is currently used by nodes for configuration purposes. However, beginning with Polkadot SDK release `stable2509`, the `para_id` field will no longer be required in chain specifications. Instead, runtimes need to be updated to implement the [`cumulus_primitives_core::GetParachainInfo`](https://paritytech.github.io/polkadot-sdk/master/cumulus_primitives_core/trait.GetParachainInfo.html){target=\_blank} trait to successfully operate with nodes using chain specs that omit the `para_id` field. | ||
|
|
||
| With the upcoming `stable2512` release, the `para_id` field will be completely removed from chain specifications in favor of the new runtime API. New nodes will be unable to start with chain specs containing the `para_id` field unless the runtime implements the `GetParachainInfo` trait. Ensure your runtime is updated to maintain compatibility with future node versions. |
There was a problem hiding this comment.
an update is required here too
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This pull request updates documentation to reflect the deprecation of the
para_idfield in Polkadot SDK chain specifications. It introduces guidance for transitioning to the new runtime API using theGetParachainInfotrait.DISCLAIMER: This PR uses the following url:
tutorials/polkadot-sdk/parachains/zero-to-hero/runtime-upgradewhich is introduced by #760Updates to documentation on
para_iddeprecation:llms.txt: Added a note explaining the upcoming removal of thepara_idfield in chain specifications starting with Polkadot SDK releasestable2512. It provides details on updating runtimes to implement thecumulus_primitives_core::GetParachainInfotrait and links to a runtime upgrade tutorial for further guidance.tutorials/polkadot-sdk/parachains/zero-to-hero/deploy-to-testnet.md: Included the same note about the deprecation of thepara_idfield, emphasizing the need for runtime updates and compatibility with future node versions.Fixes #689