forked from paritytech/polkadot-sdk
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add Westend & Rococo primitives (paritytech#808)
* Move chain primitives to a sub-folder. * Update workspace members. * Extract core parts of polkadot. * cargo fmt --all * Remove TODO. * cargo fmt --all * Fix crate names. * Add to the latest API. * cargo fmt --all * Add nested lock files to ignore (generated during cargo fmt) * Fix compilation. * cargo fmt --all * Fix ignore pattern. * Address review comments.
- Loading branch information
Showing
29 changed files
with
706 additions
and
387 deletions.
There are no files selected for viewing
This file contains 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
This file contains 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
This file contains 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
This file contains 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
This file contains 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
This file contains 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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,28 @@ | ||
[package] | ||
name = "bp-kusama" | ||
description = "Primitives of Kusama runtime." | ||
version = "0.1.0" | ||
authors = ["Parity Technologies <admin@parity.io>"] | ||
edition = "2018" | ||
license = "GPL-3.0-or-later WITH Classpath-exception-2.0" | ||
|
||
[dependencies] | ||
|
||
# Bridge Dependencies | ||
bp-message-lane = { path = "../../message-lane", default-features = false } | ||
bp-polkadot-core = { path = "../../polkadot-core", default-features = false } | ||
bp-runtime = { path = "../../runtime", default-features = false } | ||
|
||
# Substrate Based Dependencies | ||
sp-api = { git = "https://github.com/paritytech/substrate", branch = "master" , default-features = false } | ||
sp-std = { git = "https://github.com/paritytech/substrate", branch = "master", default-features = false } | ||
|
||
[features] | ||
default = ["std"] | ||
std = [ | ||
"bp-message-lane/std", | ||
"bp-polkadot-core/std", | ||
"bp-runtime/std", | ||
"sp-api/std", | ||
"sp-std/std", | ||
] |
This file contains 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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,117 @@ | ||
// Copyright 2019-2021 Parity Technologies (UK) Ltd. | ||
// This file is part of Parity Bridges Common. | ||
|
||
// Parity Bridges Common is free software: you can redistribute it and/or modify | ||
// it under the terms of the GNU General Public License as published by | ||
// the Free Software Foundation, either version 3 of the License, or | ||
// (at your option) any later version. | ||
|
||
// Parity Bridges Common is distributed in the hope that it will be useful, | ||
// but WITHOUT ANY WARRANTY; without even the implied warranty of | ||
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | ||
// GNU General Public License for more details. | ||
|
||
// You should have received a copy of the GNU General Public License | ||
// along with Parity Bridges Common. If not, see <http://www.gnu.org/licenses/>. | ||
|
||
#![cfg_attr(not(feature = "std"), no_std)] | ||
// RuntimeApi generated functions | ||
#![allow(clippy::too_many_arguments)] | ||
// Runtime-generated DecodeLimit::decode_all_with_depth_limit | ||
#![allow(clippy::unnecessary_mut_passed)] | ||
|
||
use bp_message_lane::{LaneId, MessageNonce, UnrewardedRelayersState, Weight}; | ||
use sp_std::prelude::*; | ||
|
||
pub use bp_polkadot_core::*; | ||
|
||
/// Kusama Chain | ||
pub type Kusama = PolkadotLike; | ||
|
||
// We use this to get the account on Kusama (target) which is derived from Polkadot's (source) | ||
// account. | ||
pub fn derive_account_from_polkadot_id(id: bp_runtime::SourceAccount<AccountId>) -> AccountId { | ||
let encoded_id = bp_runtime::derive_account_id(bp_runtime::POLKADOT_BRIDGE_INSTANCE, id); | ||
AccountIdConverter::convert(encoded_id) | ||
} | ||
|
||
/// Name of the `KusamaFinalityApi::best_finalized` runtime method. | ||
pub const BEST_FINALIZED_KUSAMA_HEADER_METHOD: &str = "KusamaFinalityApi_best_finalized"; | ||
/// Name of the `KusamaFinalityApi::is_known_header` runtime method. | ||
pub const IS_KNOWN_KUSAMA_HEADER_METHOD: &str = "KusamaFinalityApi_is_known_header"; | ||
|
||
/// Name of the `ToKusamaOutboundLaneApi::estimate_message_delivery_and_dispatch_fee` runtime method. | ||
pub const TO_KUSAMA_ESTIMATE_MESSAGE_FEE_METHOD: &str = | ||
"ToKusamaOutboundLaneApi_estimate_message_delivery_and_dispatch_fee"; | ||
/// Name of the `ToKusamaOutboundLaneApi::messages_dispatch_weight` runtime method. | ||
pub const TO_KUSAMA_MESSAGES_DISPATCH_WEIGHT_METHOD: &str = "ToKusamaOutboundLaneApi_messages_dispatch_weight"; | ||
/// Name of the `ToKusamaOutboundLaneApi::latest_generated_nonce` runtime method. | ||
pub const TO_KUSAMA_LATEST_GENERATED_NONCE_METHOD: &str = "ToKusamaOutboundLaneApi_latest_generated_nonce"; | ||
/// Name of the `ToKusamaOutboundLaneApi::latest_received_nonce` runtime method. | ||
pub const TO_KUSAMA_LATEST_RECEIVED_NONCE_METHOD: &str = "ToKusamaOutboundLaneApi_latest_received_nonce"; | ||
|
||
/// Name of the `FromKusamaInboundLaneApi::latest_received_nonce` runtime method. | ||
pub const FROM_KUSAMA_LATEST_RECEIVED_NONCE_METHOD: &str = "FromKusamaInboundLaneApi_latest_received_nonce"; | ||
/// Name of the `FromKusamaInboundLaneApi::latest_onfirmed_nonce` runtime method. | ||
pub const FROM_KUSAMA_LATEST_CONFIRMED_NONCE_METHOD: &str = "FromKusamaInboundLaneApi_latest_confirmed_nonce"; | ||
/// Name of the `FromKusamaInboundLaneApi::unrewarded_relayers_state` runtime method. | ||
pub const FROM_KUSAMA_UNREWARDED_RELAYERS_STATE: &str = "FromKusamaInboundLaneApi_unrewarded_relayers_state"; | ||
|
||
sp_api::decl_runtime_apis! { | ||
/// API for querying information about the finalized Kusama headers. | ||
/// | ||
/// This API is implemented by runtimes that are bridging with the Kusama chain, not the | ||
/// Kusama runtime itself. | ||
pub trait KusamaFinalityApi { | ||
/// Returns number and hash of the best finalized header known to the bridge module. | ||
fn best_finalized() -> (BlockNumber, Hash); | ||
/// Returns true if the header is known to the runtime. | ||
fn is_known_header(hash: Hash) -> bool; | ||
} | ||
|
||
/// Outbound message lane API for messages that are sent to Kusama chain. | ||
/// | ||
/// This API is implemented by runtimes that are sending messages to Kusama chain, not the | ||
/// Kusama runtime itself. | ||
pub trait ToKusamaOutboundLaneApi<OutboundMessageFee: Parameter, OutboundPayload: Parameter> { | ||
/// Estimate message delivery and dispatch fee that needs to be paid by the sender on | ||
/// this chain. | ||
/// | ||
/// Returns `None` if message is too expensive to be sent to Kusama from this chain. | ||
/// | ||
/// Please keep in mind that this method returns lowest message fee required for message | ||
/// to be accepted to the lane. It may be good idea to pay a bit over this price to account | ||
/// future exchange rate changes and guarantee that relayer would deliver your message | ||
/// to the target chain. | ||
fn estimate_message_delivery_and_dispatch_fee( | ||
lane_id: LaneId, | ||
payload: OutboundPayload, | ||
) -> Option<OutboundMessageFee>; | ||
/// Returns total dispatch weight and encoded payload size of all messages in given inclusive range. | ||
/// | ||
/// If some (or all) messages are missing from the storage, they'll also will | ||
/// be missing from the resulting vector. The vector is ordered by the nonce. | ||
fn messages_dispatch_weight( | ||
lane: LaneId, | ||
begin: MessageNonce, | ||
end: MessageNonce, | ||
) -> Vec<(MessageNonce, Weight, u32)>; | ||
/// Returns nonce of the latest message, received by bridged chain. | ||
fn latest_received_nonce(lane: LaneId) -> MessageNonce; | ||
/// Returns nonce of the latest message, generated by given lane. | ||
fn latest_generated_nonce(lane: LaneId) -> MessageNonce; | ||
} | ||
|
||
/// Inbound message lane API for messages sent by Kusama chain. | ||
/// | ||
/// This API is implemented by runtimes that are receiving messages from Kusama chain, not the | ||
/// Kusama runtime itself. | ||
pub trait FromKusamaInboundLaneApi { | ||
/// Returns nonce of the latest message, received by given lane. | ||
fn latest_received_nonce(lane: LaneId) -> MessageNonce; | ||
/// Nonce of latest message that has been confirmed to the bridged chain. | ||
fn latest_confirmed_nonce(lane: LaneId) -> MessageNonce; | ||
/// State of the unrewarded relayers set at given lane. | ||
fn unrewarded_relayers_state(lane: LaneId) -> UnrewardedRelayersState; | ||
} | ||
} |
This file contains 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
File renamed without changes.
File renamed without changes.
This file contains 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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,29 @@ | ||
[package] | ||
name = "bp-polkadot" | ||
description = "Primitives of Polkadot runtime." | ||
version = "0.1.0" | ||
authors = ["Parity Technologies <admin@parity.io>"] | ||
edition = "2018" | ||
license = "GPL-3.0-or-later WITH Classpath-exception-2.0" | ||
|
||
[dependencies] | ||
|
||
# Bridge Dependencies | ||
bp-message-lane = { path = "../../message-lane", default-features = false } | ||
bp-polkadot-core = { path = "../../polkadot-core", default-features = false } | ||
bp-runtime = { path = "../../runtime", default-features = false } | ||
|
||
# Substrate Based Dependencies | ||
|
||
sp-api = { git = "https://github.com/paritytech/substrate", branch = "master" , default-features = false } | ||
sp-std = { git = "https://github.com/paritytech/substrate", branch = "master", default-features = false } | ||
|
||
[features] | ||
default = ["std"] | ||
std = [ | ||
"bp-message-lane/std", | ||
"bp-polkadot-core/std", | ||
"bp-runtime/std", | ||
"sp-api/std", | ||
"sp-std/std", | ||
] |
This file contains 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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,117 @@ | ||
// Copyright 2019-2021 Parity Technologies (UK) Ltd. | ||
// This file is part of Parity Bridges Common. | ||
|
||
// Parity Bridges Common is free software: you can redistribute it and/or modify | ||
// it under the terms of the GNU General Public License as published by | ||
// the Free Software Foundation, either version 3 of the License, or | ||
// (at your option) any later version. | ||
|
||
// Parity Bridges Common is distributed in the hope that it will be useful, | ||
// but WITHOUT ANY WARRANTY; without even the implied warranty of | ||
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | ||
// GNU General Public License for more details. | ||
|
||
// You should have received a copy of the GNU General Public License | ||
// along with Parity Bridges Common. If not, see <http://www.gnu.org/licenses/>. | ||
|
||
#![cfg_attr(not(feature = "std"), no_std)] | ||
// RuntimeApi generated functions | ||
#![allow(clippy::too_many_arguments)] | ||
// Runtime-generated DecodeLimit::decode_all_with_depth_limit | ||
#![allow(clippy::unnecessary_mut_passed)] | ||
|
||
use bp_message_lane::{LaneId, MessageNonce, UnrewardedRelayersState, Weight}; | ||
use sp_std::prelude::*; | ||
|
||
pub use bp_polkadot_core::*; | ||
|
||
/// Polkadot Chain | ||
pub type Polkadot = PolkadotLike; | ||
|
||
// We use this to get the account on Polkadot (target) which is derived from Kusama's (source) | ||
// account. | ||
pub fn derive_account_from_kusama_id(id: bp_runtime::SourceAccount<AccountId>) -> AccountId { | ||
let encoded_id = bp_runtime::derive_account_id(bp_runtime::KUSAMA_BRIDGE_INSTANCE, id); | ||
AccountIdConverter::convert(encoded_id) | ||
} | ||
|
||
/// Name of the `PolkadotFinalityApi::best_finalized` runtime method. | ||
pub const BEST_FINALIZED_POLKADOT_HEADER_METHOD: &str = "PolkadotFinalityApi_best_finalized"; | ||
/// Name of the `PolkadotFinalityApi::is_known_header` runtime method. | ||
pub const IS_KNOWN_POLKADOT_HEADER_METHOD: &str = "PolkadotFinalityApi_is_known_header"; | ||
|
||
/// Name of the `ToPolkadotOutboundLaneApi::estimate_message_delivery_and_dispatch_fee` runtime method. | ||
pub const TO_POLKADOT_ESTIMATE_MESSAGE_FEE_METHOD: &str = | ||
"ToPolkadotOutboundLaneApi_estimate_message_delivery_and_dispatch_fee"; | ||
/// Name of the `ToPolkadotOutboundLaneApi::messages_dispatch_weight` runtime method. | ||
pub const TO_POLKADOT_MESSAGES_DISPATCH_WEIGHT_METHOD: &str = "ToPolkadotOutboundLaneApi_messages_dispatch_weight"; | ||
/// Name of the `ToPolkadotOutboundLaneApi::latest_generated_nonce` runtime method. | ||
pub const TO_POLKADOT_LATEST_GENERATED_NONCE_METHOD: &str = "ToPolkadotOutboundLaneApi_latest_generated_nonce"; | ||
/// Name of the `ToPolkadotOutboundLaneApi::latest_received_nonce` runtime method. | ||
pub const TO_POLKADOT_LATEST_RECEIVED_NONCE_METHOD: &str = "ToPolkadotOutboundLaneApi_latest_received_nonce"; | ||
|
||
/// Name of the `FromPolkadotInboundLaneApi::latest_received_nonce` runtime method. | ||
pub const FROM_POLKADOT_LATEST_RECEIVED_NONCE_METHOD: &str = "FromPolkadotInboundLaneApi_latest_received_nonce"; | ||
/// Name of the `FromPolkadotInboundLaneApi::latest_onfirmed_nonce` runtime method. | ||
pub const FROM_POLKADOT_LATEST_CONFIRMED_NONCE_METHOD: &str = "FromPolkadotInboundLaneApi_latest_confirmed_nonce"; | ||
/// Name of the `FromPolkadotInboundLaneApi::unrewarded_relayers_state` runtime method. | ||
pub const FROM_POLKADOT_UNREWARDED_RELAYERS_STATE: &str = "FromPolkadotInboundLaneApi_unrewarded_relayers_state"; | ||
|
||
sp_api::decl_runtime_apis! { | ||
/// API for querying information about the finalized Polkadot headers. | ||
/// | ||
/// This API is implemented by runtimes that are bridging with the Polkadot chain, not the | ||
/// Polkadot runtime itself. | ||
pub trait PolkadotFinalityApi { | ||
/// Returns number and hash of the best finalized header known to the bridge module. | ||
fn best_finalized() -> (BlockNumber, Hash); | ||
/// Returns true if the header is known to the runtime. | ||
fn is_known_header(hash: Hash) -> bool; | ||
} | ||
|
||
/// Outbound message lane API for messages that are sent to Polkadot chain. | ||
/// | ||
/// This API is implemented by runtimes that are sending messages to Polkadot chain, not the | ||
/// Polkadot runtime itself. | ||
pub trait ToPolkadotOutboundLaneApi<OutboundMessageFee: Parameter, OutboundPayload: Parameter> { | ||
/// Estimate message delivery and dispatch fee that needs to be paid by the sender on | ||
/// this chain. | ||
/// | ||
/// Returns `None` if message is too expensive to be sent to Polkadot from this chain. | ||
/// | ||
/// Please keep in mind that this method returns lowest message fee required for message | ||
/// to be accepted to the lane. It may be good idea to pay a bit over this price to account | ||
/// future exchange rate changes and guarantee that relayer would deliver your message | ||
/// to the target chain. | ||
fn estimate_message_delivery_and_dispatch_fee( | ||
lane_id: LaneId, | ||
payload: OutboundPayload, | ||
) -> Option<OutboundMessageFee>; | ||
/// Returns total dispatch weight and encoded payload size of all messages in given inclusive range. | ||
/// | ||
/// If some (or all) messages are missing from the storage, they'll also will | ||
/// be missing from the resulting vector. The vector is ordered by the nonce. | ||
fn messages_dispatch_weight( | ||
lane: LaneId, | ||
begin: MessageNonce, | ||
end: MessageNonce, | ||
) -> Vec<(MessageNonce, Weight, u32)>; | ||
/// Returns nonce of the latest message, received by bridged chain. | ||
fn latest_received_nonce(lane: LaneId) -> MessageNonce; | ||
/// Returns nonce of the latest message, generated by given lane. | ||
fn latest_generated_nonce(lane: LaneId) -> MessageNonce; | ||
} | ||
|
||
/// Inbound message lane API for messages sent by Polkadot chain. | ||
/// | ||
/// This API is implemented by runtimes that are receiving messages from Polkadot chain, not the | ||
/// Polkadot runtime itself. | ||
pub trait FromPolkadotInboundLaneApi { | ||
/// Returns nonce of the latest message, received by given lane. | ||
fn latest_received_nonce(lane: LaneId) -> MessageNonce; | ||
/// Nonce of latest message that has been confirmed to the bridged chain. | ||
fn latest_confirmed_nonce(lane: LaneId) -> MessageNonce; | ||
/// State of the unrewarded relayers set at given lane. | ||
fn unrewarded_relayers_state(lane: LaneId) -> UnrewardedRelayersState; | ||
} | ||
} |
This file contains 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
File renamed without changes.
This file contains 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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,28 @@ | ||
[package] | ||
name = "bp-rococo" | ||
description = "Primitives of Rococo runtime." | ||
version = "0.1.0" | ||
authors = ["Parity Technologies <admin@parity.io>"] | ||
edition = "2018" | ||
license = "GPL-3.0-or-later WITH Classpath-exception-2.0" | ||
|
||
[dependencies] | ||
|
||
# Bridge Dependencies | ||
bp-message-lane = { path = "../../message-lane", default-features = false } | ||
bp-polkadot-core = { path = "../../polkadot-core", default-features = false } | ||
bp-runtime = { path = "../../runtime", default-features = false } | ||
|
||
# Substrate Based Dependencies | ||
sp-api = { git = "https://github.com/paritytech/substrate", branch = "master" , default-features = false } | ||
sp-std = { git = "https://github.com/paritytech/substrate", branch = "master", default-features = false } | ||
|
||
[features] | ||
default = ["std"] | ||
std = [ | ||
"bp-message-lane/std", | ||
"bp-polkadot-core/std", | ||
"bp-runtime/std", | ||
"sp-api/std", | ||
"sp-std/std", | ||
] |
Oops, something went wrong.