Skip to content
Merged
Show file tree
Hide file tree
Changes from 8 commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
6d57b2e
fix: adding reference to tutorials on asset hub page
nhussein11 Dec 2, 2024
2c16109
Add xcm channels
0xLucca Dec 2, 2024
f85450b
Add runtime upgrades
0xLucca Dec 2, 2024
d1fb936
Add chain spec
0xLucca Dec 2, 2024
766fc14
Add custom parachains
0xLucca Dec 2, 2024
63159d8
fix: adding chopsticks
nhussein11 Dec 2, 2024
3941779
fix: zombienet
nhussein11 Dec 2, 2024
aaca161
Update develop/parachains/get-started/build-custom-parachains.md
0xLucca Dec 2, 2024
df4e18a
fix: xcm channels references
nhussein11 Dec 12, 2024
3c03cbd
fix: generate chain specs references
nhussein11 Dec 12, 2024
5188773
fix: generate chain specs 'where to go next'
nhussein11 Dec 12, 2024
5c7c15b
fix: build custom parachains references
nhussein11 Dec 12, 2024
cf15894
fix: runtime upgrades references
nhussein11 Dec 12, 2024
b323b64
fix: chopsticks get started references
nhussein11 Dec 12, 2024
02e1197
fix: zombienet get started references
nhussein11 Dec 12, 2024
de48c98
fix: asset hub references
nhussein11 Dec 12, 2024
1c37779
fix: add existing pallets references
nhussein11 Dec 12, 2024
ec3a6ac
fix: add smart contract funcionality references
nhussein11 Dec 12, 2024
e713da8
fix: make custom pallet references
nhussein11 Dec 12, 2024
3c9c8d6
fix: pallet testing references
nhussein11 Dec 12, 2024
eae507a
fix: generate chain specs references
nhussein11 Dec 12, 2024
721205d
fix: adding comment in build custom parachains
nhussein11 Dec 12, 2024
4c6139f
fix: deploy parachain to polkadot references
nhussein11 Dec 12, 2024
afe1551
fix: setup references
nhussein11 Dec 12, 2024
dd21c2c
fix: consensus get started references removed
nhussein11 Dec 12, 2024
95970ab
fix: architecture parachains references
nhussein11 Dec 12, 2024
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
23 changes: 20 additions & 3 deletions develop/interoperability/xcm-channels.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,9 +55,26 @@ Parachain developers have a few options for triggering the required extrinsic ca
- **Governance** - the parachain's governance system, such as a council or OpenGov, can be used to authorize the channel opening calls
- **Privileged accounts** - the parachain may have other designated privileged accounts that are allowed to dispatch the HRMP channel opening extrinsics

## Where to Go Next
## Tutorials

Explore the following tutorials for detailed, step-by-step guidance on setting up cross-chain communication channels in Polkadot:

- [Opening HRMP Channels Between Parachains](/tutorials/interoperability/xcm-channels/para-to-para/)
- [Opening HRMP Channels with System Parachains](/tutorials/interoperability/xcm-channels/para-to-system/)
<div class="grid cards" markdown>

- __Opening HRMP Channels Between Parachains__

---

Learn how to open HRMP channels between parachains on Polkadot. Discover the step-by-step process for establishing uni- and bidirectional communication.

[:octicons-arrow-right-24: Reference](/tutorials/interoperability/xcm-channels/para-to-para/)

- __Opening HRMP Channels with System Parachains__

---

Learn how to open HRMP channels with Polkadot system parachains. Discover the process for establishing bi-directional communication using a single XCM message.

[:octicons-arrow-right-24: Reference](/tutorials/interoperability/xcm-channels/para-to-system/)

</div>
16 changes: 16 additions & 0 deletions develop/parachains/deployment/generate-chain-specs.md
Original file line number Diff line number Diff line change
Expand Up @@ -134,3 +134,19 @@ After generating a chain specification, you can use it to initialize the genesis
- [**Obtain Coretime**](/develop/parachains/deployment/obtain-coretime/) - learn how to obtain the necessary coretime configuration to synchronize your blockchain’s timestamping and enhance its performance
- [**Deployment**](/develop/parachains/deployment/) - explore the steps required to deploy your chain specification, ensuring a smooth launch of your network and proper node operation
- [**Maintenance**](/develop/parachains/maintenance/) - discover best practices for maintaining your blockchain post-deployment, including how to manage upgrades and monitor network health

## Tutorials



<div class="grid cards" markdown>

- __Spin Your Own Nodes__

---

Launch a blockchain with a private set of authorized validators. Generate keys, create a custom chain spec, and start a two-node network with Aura consensus.

[:octicons-arrow-right-24: Reference](tutorials/polkadot-sdk/parachains/local-chain/spin-your-nodes/)

</div>
22 changes: 22 additions & 0 deletions develop/parachains/get-started/build-custom-parachains.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,3 +57,25 @@ Each of these steps is designed to build on the last, helping ensure that your c
Once your chain is functional locally, depending on your project’s goals, you can deploy to a TestNet to monitor performance and gather feedback or launch directly on a MainNet. To learn more about this process, check the [Deploy a Parachain](/develop/parachains/deployment/) section of the documentation.

After deployment, regular monitoring and maintenance are essential to ensure that the chain is functioning as expected. Developers need to be able to monitor the chain's performance, identify issues, and troubleshoot problems. Key activities include tracking network health, node performance, and transaction throughput. It's also essential to test the blockchain’s scalability under high load and perform security audits regularly to prevent vulnerabilities. For more information on monitoring and maintenance, refer to the [Maintenance](/develop/parachains/maintenance/) section.

## Tutorials

<div class="grid cards" markdown>

- __Build a Local Solochain__

---

Learn to build and manage Polkadot SDK-based local solochains. Covers setup, networking, authorization, monitoring, and upgrades.

[:octicons-arrow-right-24: Reference](tutorials/polkadot-sdk/parachains/local-chain/)

- __Connect to a Relay Chain__

---

Learn how to set up a local relay chain for parachain testing, including managing the genesis state, TestNet deployment, and managing the collator nodes.

[:octicons-arrow-right-24: Reference](tutorials/polkadot-sdk/parachains/connect-to-relay-chain/)

</div>
12 changes: 12 additions & 0 deletions develop/parachains/maintenance/runtime-upgrades.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,4 +71,16 @@ FRAME storage migrations run in this order:
2. System `frame_system::on_runtime_upgrade` functions
3. All `on_runtime_upgrade` functions defined in the runtime starting with the last pallet in the `construct_runtime!` macro

## Tutorials

<div class="grid cards" markdown>

- __Upgrade a Running Network__

---

Learn how to perform forkless runtime upgrades on a Polkadot SDK-based blockchain. Add features and modify parameters without network disruption.

[:octicons-arrow-right-24: Reference](tutorials/polkadot-sdk/parachains/local-chain/upgrade-a-running-network/)

</div>
Original file line number Diff line number Diff line change
Expand Up @@ -189,6 +189,16 @@ These are the methods that can be invoked and their parameters:
--8<-- 'code/develop/toolkit/parachains/fork-chains/chopsticks/get-started/dev-timeTravel-example.js'
```

## Where to Go Next
## Tutorials

- Visit the [Fork a Chain with Chopsticks](/tutorials/polkadot-sdk/testing/fork-live-chains/){target=\_blank} guide for step-by-step instructions for configuring and interacting with your forked chain.
<div class="grid cards" markdown>

- __Fork a Chain with Chopsticks__

---

Visit this guide for step-by-step instructions for configuring and interacting with your forked chain.

[:octicons-arrow-right-24: Reference](/tutorials/polkadot-sdk/testing/fork-live-chains/)

</div>
Original file line number Diff line number Diff line change
Expand Up @@ -840,4 +840,16 @@ You can use the `hrmp_channels` keyword to define further parameters for the XCM
- `max_capacity` ++"number"++ - maximum capacity of the HRMP channel
- `max_message_size` ++"number"++ - maximum message size allowed in the HRMP channel

## Tutorials

<div class="grid cards" markdown>

- __Spawn a Basic Chain with Zombienet__

---

Learn to spawn, connect to and monitor a basic blockchain network with Zombienet, using customizable configurations for streamlined development and debugging.

[:octicons-arrow-right-24: Reference](/tutorials/polkadot-sdk/testing/spawn-basic-chain/)

</div>
32 changes: 31 additions & 1 deletion polkadot-protocol/architecture/system-chains/asset-hub.md
Original file line number Diff line number Diff line change
Expand Up @@ -200,4 +200,34 @@ Sometimes, XCM transfers may fail due to liquidity or other errors. Failed trans
- **Relay chain to system parachain** - look for the `dmpqueue(ExecutedDownward)` event on the parachain with an `Incomplete` outcome and an error type such as `UntrustedReserveLocation`
- **Parachain to parachain** - monitor for `xcmpqueue(Fail)` on the destination parachain with error types like `TooExpensive`

For detailed error management in XCM, see Gavin Wood's blog post on [XCM Execution and Error Management](https://www.polkadot.network/blog/xcm-part-three-execution-and-error-management){target=\_blank}.
For detailed error management in XCM, see Gavin Wood's blog post on [XCM Execution and Error Management](https://www.polkadot.network/blog/xcm-part-three-execution-and-error-management){target=\_blank}.

## Tutorials

<div class="grid cards" markdown>

- __Register a Local Asset__

---

Comprehensive guide to registering a local asset on the Asset Hub system parachain, including step-by-step instructions.

[:octicons-arrow-right-24: Reference](/tutorials/polkadot-sdk/system-chains/asset-hub/register-local-asset/)

- __Register a Foreign Asset__

---

An in-depth guide to registering a foreign asset on the Asset Hub parachain, providing clear, step-by-step instructions.

[:octicons-arrow-right-24: Reference](/tutorials/polkadot-sdk/system-chains/asset-hub/register-foreign-asset/)

- __Convert Assets__

---

A guide detailing the step-by-step process of converting assets on Asset Hub, helping users efficiently navigate asset management on the platform.

[:octicons-arrow-right-24: Reference](/tutorials/polkadot-sdk/system-chains/asset-hub/asset-conversion/)

</div>