pezkuwichain/pezkuwi-subxt
1
0
Fork 0
mirror of https://github.com/pezkuwichain/pezkuwi-subxt.git synced 2026-05-30 07:01:03 +00:00
Code Issues Packages Projects Releases Wiki Activity

BHs readme nits (#2754)

Browse Source 
* Correct BH readme

* Zombienet renaming

* TOC

* Apply suggestions from code review

Co-authored-by: Adrian Catangiu <adrian@parity.io>

* Updated REAMDE.md

* Alice -> Bob for e2e

---------

Co-authored-by: Adrian Catangiu <adrian@parity.io>
Co-authored-by: parity-processbot <>
This commit is contained in:
Branislav Kontur
2023-07-24 16:16:08 +02:00
committed by GitHub
parent 0b79443be3
commit cd263ace19
4 changed files with 69 additions and 88 deletions
Download Patch File Download Diff File Expand all files Collapse all files
cumulus/parachains/integration-tests/emulated/common/src/constants.rs
+4 -4
View File
@@ -953,19 +953,19 @@ pub mod bridge_hub_rococo {
..Default::default() ..Default::default()
}, },
bridge_wococo_grandpa: bridge_hub_rococo_runtime::BridgeWococoGrandpaConfig { bridge_wococo_grandpa: bridge_hub_rococo_runtime::BridgeWococoGrandpaConfig {
owner: Some(get_account_id_from_seed::<sr25519::Public>("Alice")), owner: Some(get_account_id_from_seed::<sr25519::Public>(accounts::BOB)),
..Default::default() ..Default::default()
}, },
bridge_rococo_grandpa: bridge_hub_rococo_runtime::BridgeRococoGrandpaConfig { bridge_rococo_grandpa: bridge_hub_rococo_runtime::BridgeRococoGrandpaConfig {
owner: Some(get_account_id_from_seed::<sr25519::Public>("Alice")), owner: Some(get_account_id_from_seed::<sr25519::Public>(accounts::BOB)),
..Default::default() ..Default::default()
}, },
bridge_rococo_messages: bridge_hub_rococo_runtime::BridgeRococoMessagesConfig { bridge_rococo_messages: bridge_hub_rococo_runtime::BridgeRococoMessagesConfig {
owner: Some(get_account_id_from_seed::<sr25519::Public>("Alice")), owner: Some(get_account_id_from_seed::<sr25519::Public>(accounts::BOB)),
..Default::default() ..Default::default()
}, },
bridge_wococo_messages: bridge_hub_rococo_runtime::BridgeWococoMessagesConfig { bridge_wococo_messages: bridge_hub_rococo_runtime::BridgeWococoMessagesConfig {
owner: Some(get_account_id_from_seed::<sr25519::Public>("Alice")), owner: Some(get_account_id_from_seed::<sr25519::Public>(accounts::BOB)),
..Default::default() ..Default::default()
}, },
..Default::default() ..Default::default()
cumulus/parachains/runtimes/bridge-hubs/README.md
+61 -80
View File
@@ -1,15 +1,13 @@
- [Bridge-hub Parachains](#bridge-hub-parachains) - [Bridge-hub Parachains](#bridge-hub-parachains)
* [Requirements for local run/testing](#requirements-for-local-run-testing) * [Requirements for local run/testing](#requirements-for-local-runtesting)
* [How to test locally Rococo <-> Wococo bridge](#how-to-test-locally-rococo-----wococo-bridge) * [How to test local Rococo <-> Wococo bridge](#how-to-test-local-rococo---wococo-bridge)
+ [Run chains (Rococo + BridgeHub, Wococo + BridgeHub) with zombienet](#run-chains--rococo---bridgehub--wococo---bridgehub--with-zombienet) + [Run chains (Rococo + BridgeHub, Wococo + BridgeHub) with zombienet](#run-chains-rococo--bridgehub-wococo--bridgehub-with-zombienet)
+ [Run relayer (BridgeHubRococo, BridgeHubWococo)](#run-relayer--bridgehubrococo--bridgehubwococo-) + [Run relayer (BridgeHubRococo, BridgeHubWococo)](#run-relayer-bridgehubrococo-bridgehubwococo)
- [Run with script (alternative 1)](#run-with-script--alternative-1-) - [Run with script (alternative 1)](#run-with-script-alternative-1)
- [Run with binary (alternative 2)](#run-with-binary--alternative-2-) - [Run with binary (alternative 2)](#run-with-binary-alternative-2)
+ [Send messages](#send-messages) + [Send messages - transfer asset over bridge](#send-messages---transfer-asset-over-bridge)
- [Local zombienet run](#local-zombienet-run) * [How to test live BridgeHubRococo/BridgeHubWococo](#how-to-test-live-bridgehubrococobridgehubwococo)
- [Live Rockmine2 to Wockmint](#live-rockmine2-to-wockmint) * [How to test local BridgeHubKusama/BridgeHubPolkadot](#how-to-test-local-bridgehubkusamabridgehubpolkadot)
* [How to test local BridgeHubKusama](#how-to-test-local-bridgehubkusama)
* [How to test local BridgeHubPolkadot](#how-to-test-local-bridgehubpolkadot)
# Bridge-hub Parachains # Bridge-hub Parachains
@@ -41,6 +39,7 @@ mkdir -p ~/local_bridge_testing/logs
Go to: https://github.com/paritytech/zombienet/releases Go to: https://github.com/paritytech/zombienet/releases
Copy the apropriate binary (zombienet-linux) from the latest release to ~/local_bridge_testing/bin Copy the apropriate binary (zombienet-linux) from the latest release to ~/local_bridge_testing/bin
--- ---
# 2. Build polkadot binary # 2. Build polkadot binary
git clone https://github.com/paritytech/polkadot.git git clone https://github.com/paritytech/polkadot.git
@@ -49,60 +48,81 @@ cd polkadot
# if you want to test Kusama/Polkadot bridge, we need "sudo pallet + fast-runtime", # if you want to test Kusama/Polkadot bridge, we need "sudo pallet + fast-runtime",
# so please, find the latest polkadot's repository branch `it/release-vX.Y.Z-fast-sudo` # so please, find the latest polkadot's repository branch `it/release-vX.Y.Z-fast-sudo`
# e.g: # e.g:
# git checkout -b it/release-v0.9.42-fast-sudo --track origin/it/release-v0.9.42-fast-sudo # git checkout -b it/release-v0.9.43-fast-sudo --track origin/it/release-v0.9.43-fast-sudo
cargo build --release --features fast-runtime cargo build --release --features fast-runtime
cp target/release/polkadot ~/local_bridge_testing/bin/polkadot cp target/release/polkadot ~/local_bridge_testing/bin/polkadot
---
# 3. Build cumulus polkadot-parachain binary
cd <cumulus-git-repo-dir>
# checkout desired branch or use master:
# git checkout -b master --track origin/master
cargo build --release --locked -p polkadot-parachain-bin
cp target/release/polkadot-parachain ~/local_bridge_testing/bin/polkadot-parachain
cp target/release/polkadot-parachain ~/local_bridge_testing/bin/polkadot-parachain-mint
--- ---
# 4. Build substrate-relay binary # 3. Build substrate-relay binary
git clone https://github.com/paritytech/parity-bridges-common.git git clone https://github.com/paritytech/parity-bridges-common.git
cd parity-bridges-common cd parity-bridges-common
# checkout desired branch or use master: # checkout desired branch or use master:
# git checkout -b master --track origin/master # git checkout -b master --track origin/master
# `polkadot-staging` (recommended) is stabilized and compatible for Cumulus releases
# `master` is latest development
git checkout -b polkadot-staging --track origin/polkadot-staging git checkout -b polkadot-staging --track origin/polkadot-staging
cargo build --release -p substrate-relay cargo build --release -p substrate-relay
cp target/release/substrate-relay ~/local_bridge_testing/bin/substrate-relay cp target/release/substrate-relay ~/local_bridge_testing/bin/substrate-relay
--- ---
# 5. Build polkadot-parachain-mint binary with `asset-hub-kusama`/`asset-hub-westend` for moving assets # 4. Build cumulus polkadot-parachain binary
cd <cumulus-git-repo-dir> cd <cumulus-git-repo-dir>
# TODO:check-parameter - change this when merged to master
git checkout -b bko-transfer-asset-via-bridge --track origin/bko-transfer-asset-via-bridge # checkout desired branch or use master:
cargo build --release --locked -p polkadot-parachain-bin # git checkout -b master --track origin/master
cp target/release/polkadot-parachain ~/local_bridge_testing/bin/polkadot-parachain-mint
cargo build --release --locked --bin polkadot-parachain
cp target/release/polkadot-parachain ~/local_bridge_testing/bin/polkadot-parachain
cp target/release/polkadot-parachain ~/local_bridge_testing/bin/polkadot-parachain-asset-hub
# !!! READ HERE (TODO remove once all mentioned branches bellow are merged)
# The use case "moving assets over bridge" is not merged yet and is implemented in separate branches.
# So, if you want to try it, you need to checkout different branch and continue with these instructions there.
# For Kusama/Polkadot local bridge testing:
#
# build BridgeHubs (polkadot-parachain) from branch:
# git checkout -b bridge-hub-kusama-polkadot --track origin/bridge-hub-kusama-polkadot
# cargo build --release --locked --bin polkadot-parachain
# cp target/release/polkadot-parachain ~/local_bridge_testing/bin/polkadot-parachain
#
# build AssetHubs (polkadot-parachain-asset-hub) from branch:
# git checkout -b bko-transfer-asset-via-bridge-pallet-xcm --track origin/bko-transfer-asset-via-bridge-pallet-xcm
# cargo build --release --locked --bin polkadot-parachain
# cp target/release/polkadot-parachain ~/local_bridge_testing/bin/polkadot-parachain-asset-hub
# For Rococo/Wococo local bridge testing:
#
# build AssetHubs (polkadot-parachain-asset-hub) from branch:
# git checkout -b bko-transfer-asset-via-bridge-pallet-xcm-ro-wo --track origin/bko-transfer-asset-via-bridge-pallet-xcm-ro-wo
# cargo build --release --locked --bin polkadot-parachain
# cp target/release/polkadot-parachain ~/local_bridge_testing/bin/polkadot-parachain-asset-hub
``` ```
## How to test locally Rococo <-> Wococo bridge ## How to test local Rococo <-> Wococo bridge
### Run chains (Rococo + BridgeHub, Wococo + BridgeHub) with zombienet ### Run chains (Rococo + BridgeHub + AssetHub, Wococo + BridgeHub + AssetHub) with zombienet
``` ```
# Rococo + BridgeHubRococo + Rockmine (mirroring Kusama) # Rococo + BridgeHubRococo + AssetHub for Rococo (mirroring Kusama)
POLKADOT_BINARY_PATH=~/local_bridge_testing/bin/polkadot \ POLKADOT_BINARY_PATH=~/local_bridge_testing/bin/polkadot \
POLKADOT_PARACHAIN_BINARY_PATH=~/local_bridge_testing/bin/polkadot-parachain \ POLKADOT_PARACHAIN_BINARY_PATH=~/local_bridge_testing/bin/polkadot-parachain \
POLKADOT_PARACHAIN_BINARY_PATH_FOR_ROCKMINE=~/local_bridge_testing/bin/polkadot-parachain-mint \ POLKADOT_PARACHAIN_BINARY_PATH_FOR_ASSET_HUB_ROCOCO=~/local_bridge_testing/bin/polkadot-parachain-asset-hub \
~/local_bridge_testing/bin/zombienet-linux --provider native spawn ./zombienet/bridge-hubs/bridge_hub_rococo_local_network.toml ~/local_bridge_testing/bin/zombienet-linux --provider native spawn ./zombienet/bridge-hubs/bridge_hub_rococo_local_network.toml
``` ```
``` ```
# Wococo + BridgeHubWococo + Wockmint (mirroring Polkadot) # Wococo + BridgeHubWococo + AssetHub for Wococo (mirroring Polkadot)
POLKADOT_BINARY_PATH=~/local_bridge_testing/bin/polkadot \ POLKADOT_BINARY_PATH=~/local_bridge_testing/bin/polkadot \
POLKADOT_PARACHAIN_BINARY_PATH=~/local_bridge_testing/bin/polkadot-parachain \ POLKADOT_PARACHAIN_BINARY_PATH=~/local_bridge_testing/bin/polkadot-parachain \
POLKADOT_PARACHAIN_BINARY_PATH_FOR_WOCKMINT=~/local_bridge_testing/bin/polkadot-parachain-mint \ POLKADOT_PARACHAIN_BINARY_PATH_FOR_ASSET_HUB_WOCOCO=~/local_bridge_testing/bin/polkadot-parachain-asset-hub \
~/local_bridge_testing/bin/zombienet-linux --provider native spawn ./zombienet/bridge-hubs/bridge_hub_wococo_local_network.toml ~/local_bridge_testing/bin/zombienet-linux --provider native spawn ./zombienet/bridge-hubs/bridge_hub_wococo_local_network.toml
``` ```
@@ -191,65 +211,26 @@ RUST_LOG=runtime=trace,rpc=trace,bridge=trace \
- Pallet: **bridgeRococoParachain** - Pallet: **bridgeRococoParachain**
- Keys: **bestParaHeads()** - Keys: **bestParaHeads()**
### Send messages ### Send messages - transfer asset over bridge
#### Local zombienet run TODO: see `# !!! READ HERE` above
1. allow bridge transfer on kusama/westend asset hubs (governance-like): ## How to test live BridgeHubRococo/BridgeHubWococo
``` (here is still deployed older PoC from branch `origin/bko-transfer-asset-via-bridge`, which uses custom extrinsic, which is going to be replaced by `pallet_xcm` usage)
./scripts/bridges_rococo_wococo.sh allow-transfers-local
```
2. do (asset) transfer from kusama's asset hub to westend's asset hub:
```
./scripts/bridges_rococo_wococo.sh transfer-asset-from-asset-hub-kusama-local
```
3. do (ping) transfer from kusama's asset hub to westend's asset hub
```
./scripts/bridges_rococo_wococo.sh ping-via-bridge-from-asset-hub-kusama-local
```
- open explorers: (see zombienets)
- Kusama Asset Hub (see events `xcmpQueue.XcmpMessageSent`, `bridgeTransfer.ReserveAssetsDeposited`, `bridgeTransfer.TransferInitiated`) https://polkadot.js.org/apps/?rpc=ws://127.0.0.1:9910#/explorer
- BridgeHubRococo (see `bridgeWococoMessages.MessageAccepted`) https://polkadot.js.org/apps/?rpc=ws://127.0.0.1:8943#/explorer
- BridgeHubWococo (see `bridgeRococoMessages.MessagesReceived`) https://polkadot.js.org/apps/?rpc=ws://127.0.0.1:8945#/explorer
- Westend Asset Hub (see `xcmpQueue.Success` for `transfer-asset` and `xcmpQueue.Fail` for `ping-via-bridge`) https://polkadot.js.org/apps/?rpc=ws://127.0.0.1:9010#/explorer
- BridgeHubRococo (see `bridgeWococoMessages.MessagesDelivered`) https://polkadot.js.org/apps/?rpc=ws://127.0.0.1:8943#/explorer
#### Live Rockmine2 to Wockmint
- uses account seed on Live Rococo:Rockmine2 - uses account seed on Live Rococo:Rockmine2
``` ```
cd <cumulus-git-repo-dir> cd <cumulus-git-repo-dir>
./scripts/bridges_rococo_wococo.sh transfer-asset-from-asset-hub-rococo ./scripts/bridges_rococo_wococo.sh transfer-asset-from-asset-hub-rococo
or
./scripts/bridges_rococo_wococo.sh ping-via-bridge-from-asset-hub-rococo
``` ```
- open explorers: - open explorers:
- Rockmine2 (see events `xcmpQueue.XcmpMessageSent`, `bridgeTransfer.ReserveAssetsDeposited`, `bridgeTransfer.TransferInitiated`) https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Fws-rococo-rockmine2-collator-node-0.parity-testnet.parity.io#/explorer - Rockmine2 (see events `xcmpQueue.XcmpMessageSent`, `bridgeTransfer.ReserveAssetsDeposited`, `bridgeTransfer.TransferInitiated`) https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Fws-rococo-rockmine2-collator-node-0.parity-testnet.parity.io#/explorer
- BridgeHubRococo (see `bridgeWococoMessages.MessageAccepted`) https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Frococo-bridge-hub-rpc.polkadot.io#/explorer - BridgeHubRococo (see `bridgeWococoMessages.MessageAccepted`) https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Frococo-bridge-hub-rpc.polkadot.io#/explorer
- BridgeHubWococo (see `bridgeRococoMessages.MessagesReceived`) https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Fwococo-bridge-hub-rpc.polkadot.io#/explorer - BridgeHubWococo (see `bridgeRococoMessages.MessagesReceived`) https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Fwococo-bridge-hub-rpc.polkadot.io#/explorer
- Wockmint (see `xcmpQueue.Success` for `transfer-asset` and `xcmpQueue.Fail` for `ping-via-bridge`) https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Fws-wococo-wockmint-collator-node-0.parity-testnet.parity.io#/explorer - Wockmint (see `xcmpQueue.Success` for `transfer-asset` and `xcmpQueue.Fail` for `ping-via-bridge`) https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Fwococo-wockmint-rpc.polkadot.io#/explorer
- BridgeHubRococo (see `bridgeWococoMessages.MessagesDelivered`) - BridgeHubRococo (see `bridgeWococoMessages.MessagesDelivered`)
## How to test local BridgeHubKusama
```
cd <base-cumulus-repo-directory>
cargo build --release -p polkadot-parachain-bin
# script expect to have pre-built polkadot binary on the path: ../polkadot/target/release/polkadot ## How to test local BridgeHubKusama/BridgeHubPolkadot
# if using `kusama-local` / `polkadot-local`, build polkadot with `--features fast-runtime`
# BridgeHubKusama TODO: see `# !!! READ HERE` above
zombienet-linux --provider native spawn ./zombienet/examples/bridge_hub_kusama_local_network.toml
or
# BridgeHubPolkadot
zombienet-linux --provider native spawn ./zombienet/examples/bridge_hub_polkadot_local_network.toml
```
## How to test local BridgeHubPolkadot
TODO: from master
cumulus/zombienet/bridge-hubs/bridge_hub_rococo_local_network.toml
+2 -2
View File
@@ -71,7 +71,7 @@ cumulus_based = true
name = "rockmine-collator1" name = "rockmine-collator1"
rpc_port = 9911 rpc_port = 9911
ws_port = 9910 ws_port = 9910
command = "{{POLKADOT_PARACHAIN_BINARY_PATH_FOR_ROCKMINE}}" command = "{{POLKADOT_PARACHAIN_BINARY_PATH_FOR_ASSET_HUB_ROCOCO}}"
args = [ args = [
"-lparachain=debug,xcm=trace,runtime::bridge-transfer=trace", "-lparachain=debug,xcm=trace,runtime::bridge-transfer=trace",
] ]
@@ -82,7 +82,7 @@ cumulus_based = true
[[parachains.collators]] [[parachains.collators]]
name = "rockmine-collator2" name = "rockmine-collator2"
command = "{{POLKADOT_PARACHAIN_BINARY_PATH_FOR_ROCKMINE}}" command = "{{POLKADOT_PARACHAIN_BINARY_PATH_FOR_ASSET_HUB_ROCOCO}}"
args = [ args = [
"-lparachain=debug,xcm=trace,runtime::bridge-transfer=trace", "-lparachain=debug,xcm=trace,runtime::bridge-transfer=trace",
] ]
cumulus/zombienet/bridge-hubs/bridge_hub_wococo_local_network.toml
+2 -2
View File
@@ -71,7 +71,7 @@ cumulus_based = true
name = "wockmint-collator1" name = "wockmint-collator1"
rpc_port = 9011 rpc_port = 9011
ws_port = 9010 ws_port = 9010
command = "{{POLKADOT_PARACHAIN_BINARY_PATH_FOR_WOCKMINT}}" command = "{{POLKADOT_PARACHAIN_BINARY_PATH_FOR_ASSET_HUB_WOCOCO}}"
args = [ args = [
"-lparachain=debug,xcm=trace,runtime::bridge-transfer=trace", "-lparachain=debug,xcm=trace,runtime::bridge-transfer=trace",
] ]
@@ -82,7 +82,7 @@ cumulus_based = true
[[parachains.collators]] [[parachains.collators]]
name = "wockmint-collator2" name = "wockmint-collator2"
command = "{{POLKADOT_PARACHAIN_BINARY_PATH_FOR_WOCKMINT}}" command = "{{POLKADOT_PARACHAIN_BINARY_PATH_FOR_ASSET_HUB_WOCOCO}}"
args = [ args = [
"-lparachain=debug,xcm=trace,runtime::bridge-transfer=trace", "-lparachain=debug,xcm=trace,runtime::bridge-transfer=trace",
] ]