mirror of
https://github.com/pezkuwichain/pezkuwi-subxt.git
synced 2026-04-24 03:08:02 +00:00
Bastian Köcher
eb23023c45
* Rename `rococo-collator` to `polkadot-collator` Also contains some other small changes. * Test fixes and some further search&replace
124 lines
4.8 KiB
Markdown
124 lines
4.8 KiB
Markdown
# Cumulus :cloud:
|
|
|
|
A set of tools for writing [Substrate](https://substrate.dev/)-based
|
|
[Polkadot](https://wiki.polkadot.network/en/)
|
|
[parachains](https://wiki.polkadot.network/docs/en/learn-parachains). Refer to the included
|
|
[overview](docs/overview.md) for architectural details, and the
|
|
[Cumulus workshop](https://substrate.dev/cumulus-workshop) for a hand-holding walkthrough
|
|
of using these tools.
|
|
|
|
It's easy to write blockchains using Substrate, and the overhead of writing parachains'
|
|
distribution, p2p, database, and synchronization layers should be just as low. This project aims to
|
|
make it easy to write parachains for Polkadot by leveraging the power of Substrate.
|
|
|
|
Cumulus clouds are shaped sort of like dots; together they form a system that is intricate,
|
|
beautiful and functional.
|
|
|
|
## Consensus
|
|
|
|
[`cumulus-consensus`](consensus) is a
|
|
[consensus engine](https://substrate.dev/docs/en/knowledgebase/advanced/consensus) for Substrate
|
|
that follows a Polkadot
|
|
[relay chain](https://wiki.polkadot.network/docs/en/learn-architecture#relay-chain). This will run a
|
|
Polkadot node internally, and dictate to the client and synchronization algorithms which chain to
|
|
follow,
|
|
[finalize](https://wiki.polkadot.network/docs/en/learn-consensus#probabilistic-vs-provable-finality),
|
|
and treat as best.
|
|
|
|
## Collator
|
|
|
|
A Polkadot [collator](https://wiki.polkadot.network/docs/en/learn-collator) for the parachain is
|
|
implemented by [`cumulus-collator`](collator).
|
|
|
|
# Rococo :crown:
|
|
|
|
[Rococo](https://polkadot.js.org/apps/?rpc=wss://rococo-rpc.polkadot.io) is the testnet for
|
|
parachains. It currently runs the parachains
|
|
[Tick](https://polkadot.js.org/apps/?rpc=wss://tick-rpc.polkadot.io),
|
|
[Trick](https://polkadot.js.org/apps/?rpc=wss://trick-rpc.polkadot.io) and
|
|
[Track](https://polkadot.js.org/apps/?rpc=wss://track-rpc.polkadot.io).
|
|
|
|
Rococo is an elaborate style of design and the name describes the painstaking effort that has gone
|
|
into this project. Tick, Trick and Track are the German names for the cartoon ducks known to English
|
|
speakers as Huey, Dewey and Louie.
|
|
|
|
## Build & Launch Rococo Collators
|
|
|
|
Collators are similar to validators in the relay chain. These nodes build the blocks that will
|
|
eventually be included by the relay chain for a parachain.
|
|
|
|
To run a Rococo collator you will need to compile the following binary:
|
|
|
|
```
|
|
cargo build --release -p polkadot-collator
|
|
```
|
|
|
|
Once the executable is built, launch collators for each parachain (repeat once each for chain
|
|
`tick`, `trick`, `track`):
|
|
|
|
```
|
|
./target/release/polkadot-collator --chain $CHAIN --validator
|
|
```
|
|
|
|
## Parachains
|
|
|
|
The parachains of Rococo all use the same runtime code. The only difference between them is the
|
|
parachain ID used for registration with the relay chain:
|
|
|
|
- Tick: 100
|
|
- Trick: 110
|
|
- Track: 120
|
|
|
|
The network uses horizontal message passing (HRMP) to enable communication between parachains and
|
|
the relay chain and, in turn, between parachains. This means that every message is sent to the relay
|
|
chain, and from the relay chain to its destination parachain.
|
|
|
|
## Launch a local setup including a Relay Chain and a Parachain
|
|
|
|
### Launch the Relay Chain
|
|
|
|
```bash
|
|
# Compile Polkadot with the real overseer feature
|
|
git clone https://github.com/paritytech/polkadot
|
|
git fetch
|
|
git checkout rococo-v1
|
|
cargo build --release
|
|
|
|
# Generate a raw chain spec
|
|
./target/release/polkadot build-spec --chain rococo-local --disable-default-bootnode --raw > rococo-local-cfde.json
|
|
|
|
# Alice
|
|
./target/release/polkadot --chain rococo-local-cfde.json --alice --tmp
|
|
|
|
# Bob (In a separate terminal)
|
|
./target/release/polkadot --chain rococo-local-cfde.json --bob --tmp --port 30334
|
|
```
|
|
|
|
### Launch the Parachain
|
|
|
|
```bash
|
|
# Compile
|
|
git clone https://github.com/paritytech/cumulus
|
|
git fetch
|
|
git checkout rococo-v1
|
|
cargo build --release
|
|
|
|
# Export genesis state
|
|
# --parachain-id 200 as an example that can be chosen freely. Make sure to everywhere use the same parachain id
|
|
./target/release/polkadot-collator export-genesis-state --parachain-id 200 > genesis-state
|
|
|
|
# Export genesis wasm
|
|
./target/release/polkadot-collator export-genesis-wasm > genesis-wasm
|
|
|
|
# Collator1
|
|
./target/release/polkadot-collator --collator --tmp --parachain-id <parachain_id_u32_type_range> --port 40335 --ws-port 9946 -- --execution wasm --chain ../polkadot/rococo-local-cfde.json --port 30335
|
|
|
|
# Collator2
|
|
./target/release/polkadot-collator --collator --tmp --parachain-id <parachain_id_u32_type_range> --port 40336 --ws-port 9947 -- --execution wasm --chain ../polkadot/rococo-local-cfde.json --port 30336
|
|
|
|
# Parachain Full Node 1
|
|
./target/release/polkadot-collator --tmp --parachain-id <parachain_id_u32_type_range> --port 40337 --ws-port 9948 -- --execution wasm --chain ../polkadot/rococo-local-cfde.json --port 30337
|
|
```
|
|
### Register the parachain
|
|
|