mirror of
https://github.com/pezkuwichain/pezkuwi-subxt.git
synced 2026-04-26 21:37:56 +00:00
Bastian Köcher
ca5f10567a
The `BlockBuilderProvider` was a trait that was defined in `sc-block-builder`. The trait was implemented for `Client`. This basically meant that you needed to import `sc-block-builder` any way to have access to the block builder. So, this trait was not providing any real value. This pull request is removing the said trait. Instead of the trait it introduces a builder for creating a `BlockBuilder`. The builder currently has the quite fabulous name `BlockBuilderBuilder` (I'm open to any better name 😅). The rest of the pull request is about replacing the old trait with the new builder. # Downstream code changes If you used `new_block` or `new_block_at` before you now need to switch it over to the new `BlockBuilderBuilder` pattern: ```rust // `new` requires a type that implements `CallApiAt`. let mut block_builder = BlockBuilderBuilder::new(client) // Then you need to specify the hash of the parent block the block will be build on top of .on_parent_block(at) // The block builder also needs the block number of the parent block. // Here it is fetched from the given `client` using the `HeaderBackend` // However, there also exists `with_parent_block_number` for directly passing the number .fetch_parent_block_number(client) .unwrap() // Enable proof recording if required. This call is optional. .enable_proof_recording() // Pass the digests. This call is optional. .with_inherent_digests(digests) .build() .expect("Creates new block builder"); ``` --------- Co-authored-by: Sebastian Kunert <skunert49@gmail.com> Co-authored-by: command-bot <>
547 lines
14 KiB
Rust
547 lines
14 KiB
Rust
// This file is part of Substrate.
|
|
|
|
// Copyright (C) Parity Technologies (UK) Ltd.
|
|
// SPDX-License-Identifier: Apache-2.0
|
|
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
//! tests that should hold for all implementations of certain traits.
|
|
//! to test implementations without duplication.
|
|
|
|
#![allow(missing_docs)]
|
|
|
|
use std::sync::Arc;
|
|
|
|
use crate::{
|
|
AccountKeyring, BlockBuilderExt, ClientBlockImportExt, TestClientBuilder, TestClientBuilderExt,
|
|
};
|
|
use futures::executor::block_on;
|
|
use sc_block_builder::BlockBuilderBuilder;
|
|
use sc_client_api::{
|
|
backend,
|
|
blockchain::{Backend as BlockChainBackendT, HeaderBackend},
|
|
};
|
|
use sp_consensus::BlockOrigin;
|
|
use sp_runtime::traits::Block as BlockT;
|
|
use substrate_test_runtime::Transfer;
|
|
|
|
/// helper to test the `leaves` implementation for various backends
|
|
pub fn test_leaves_for_backend<B: 'static>(backend: Arc<B>)
|
|
where
|
|
B: backend::Backend<substrate_test_runtime::Block>,
|
|
{
|
|
// block tree:
|
|
// G -> A1 -> A2 -> A3 -> A4 -> A5
|
|
// A1 -> B2 -> B3 -> B4
|
|
// B2 -> C3
|
|
// A1 -> D2
|
|
|
|
let mut client = TestClientBuilder::with_backend(backend.clone()).build();
|
|
let blockchain = backend.blockchain();
|
|
|
|
let genesis_hash = client.chain_info().genesis_hash;
|
|
|
|
assert_eq!(blockchain.leaves().unwrap(), vec![genesis_hash]);
|
|
|
|
// G -> A1
|
|
let a1 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(genesis_hash)
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
block_on(client.import(BlockOrigin::Own, a1.clone())).unwrap();
|
|
assert_eq!(blockchain.leaves().unwrap(), vec![a1.hash()]);
|
|
|
|
// A1 -> A2
|
|
let a2 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(a1.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
block_on(client.import(BlockOrigin::Own, a2.clone())).unwrap();
|
|
|
|
assert_eq!(blockchain.leaves().unwrap(), vec![a2.hash()]);
|
|
|
|
// A2 -> A3
|
|
let a3 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(a2.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
block_on(client.import(BlockOrigin::Own, a3.clone())).unwrap();
|
|
|
|
assert_eq!(blockchain.leaves().unwrap(), vec![a3.hash()]);
|
|
|
|
// A3 -> A4
|
|
let a4 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(a3.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
block_on(client.import(BlockOrigin::Own, a4.clone())).unwrap();
|
|
assert_eq!(blockchain.leaves().unwrap(), vec![a4.hash()]);
|
|
|
|
// A4 -> A5
|
|
let a5 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(a4.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
|
|
block_on(client.import(BlockOrigin::Own, a5.clone())).unwrap();
|
|
assert_eq!(blockchain.leaves().unwrap(), vec![a5.hash()]);
|
|
|
|
// A1 -> B2
|
|
let mut builder = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(a1.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap();
|
|
|
|
// this push is required as otherwise B2 has the same hash as A2 and won't get imported
|
|
builder
|
|
.push_transfer(Transfer {
|
|
from: AccountKeyring::Alice.into(),
|
|
to: AccountKeyring::Ferdie.into(),
|
|
amount: 41,
|
|
nonce: 0,
|
|
})
|
|
.unwrap();
|
|
let b2 = builder.build().unwrap().block;
|
|
block_on(client.import(BlockOrigin::Own, b2.clone())).unwrap();
|
|
assert_eq!(blockchain.leaves().unwrap(), vec![a5.hash(), b2.hash()]);
|
|
|
|
// B2 -> B3
|
|
let b3 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(b2.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
|
|
block_on(client.import(BlockOrigin::Own, b3.clone())).unwrap();
|
|
assert_eq!(blockchain.leaves().unwrap(), vec![a5.hash(), b3.hash()]);
|
|
|
|
// B3 -> B4
|
|
let b4 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(b3.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
block_on(client.import(BlockOrigin::Own, b4.clone())).unwrap();
|
|
assert_eq!(blockchain.leaves().unwrap(), vec![a5.hash(), b4.hash()]);
|
|
|
|
// // B2 -> C3
|
|
let mut builder = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(b2.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap();
|
|
// this push is required as otherwise C3 has the same hash as B3 and won't get imported
|
|
builder
|
|
.push_transfer(Transfer {
|
|
from: AccountKeyring::Alice.into(),
|
|
to: AccountKeyring::Ferdie.into(),
|
|
amount: 1,
|
|
nonce: 1,
|
|
})
|
|
.unwrap();
|
|
let c3 = builder.build().unwrap().block;
|
|
block_on(client.import(BlockOrigin::Own, c3.clone())).unwrap();
|
|
assert_eq!(blockchain.leaves().unwrap(), vec![a5.hash(), b4.hash(), c3.hash()]);
|
|
|
|
// A1 -> D2
|
|
let mut builder = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(a1.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap();
|
|
// this push is required as otherwise D2 has the same hash as B2 and won't get imported
|
|
builder
|
|
.push_transfer(Transfer {
|
|
from: AccountKeyring::Alice.into(),
|
|
to: AccountKeyring::Ferdie.into(),
|
|
amount: 1,
|
|
nonce: 0,
|
|
})
|
|
.unwrap();
|
|
let d2 = builder.build().unwrap().block;
|
|
block_on(client.import(BlockOrigin::Own, d2.clone())).unwrap();
|
|
assert_eq!(blockchain.leaves().unwrap(), vec![a5.hash(), b4.hash(), c3.hash(), d2.hash()]);
|
|
}
|
|
|
|
/// helper to test the `children` implementation for various backends
|
|
pub fn test_children_for_backend<B: 'static>(backend: Arc<B>)
|
|
where
|
|
B: backend::LocalBackend<substrate_test_runtime::Block>,
|
|
{
|
|
// block tree:
|
|
// G -> A1 -> A2 -> A3 -> A4 -> A5
|
|
// A1 -> B2 -> B3 -> B4
|
|
// B2 -> C3
|
|
// A1 -> D2
|
|
|
|
let mut client = TestClientBuilder::with_backend(backend.clone()).build();
|
|
let blockchain = backend.blockchain();
|
|
let genesis_hash = client.chain_info().genesis_hash;
|
|
|
|
// G -> A1
|
|
let a1 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(genesis_hash)
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
block_on(client.import(BlockOrigin::Own, a1.clone())).unwrap();
|
|
|
|
// A1 -> A2
|
|
let a2 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(a1.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
block_on(client.import(BlockOrigin::Own, a2.clone())).unwrap();
|
|
|
|
// A2 -> A3
|
|
let a3 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(a2.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
block_on(client.import(BlockOrigin::Own, a3.clone())).unwrap();
|
|
|
|
// A3 -> A4
|
|
let a4 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(a3.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
block_on(client.import(BlockOrigin::Own, a4.clone())).unwrap();
|
|
|
|
// A4 -> A5
|
|
let a5 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(a4.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
block_on(client.import(BlockOrigin::Own, a5.clone())).unwrap();
|
|
|
|
// A1 -> B2
|
|
let mut builder = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(a1.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap();
|
|
// this push is required as otherwise B2 has the same hash as A2 and won't get imported
|
|
builder
|
|
.push_transfer(Transfer {
|
|
from: AccountKeyring::Alice.into(),
|
|
to: AccountKeyring::Ferdie.into(),
|
|
amount: 41,
|
|
nonce: 0,
|
|
})
|
|
.unwrap();
|
|
let b2 = builder.build().unwrap().block;
|
|
block_on(client.import(BlockOrigin::Own, b2.clone())).unwrap();
|
|
|
|
// B2 -> B3
|
|
let b3 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(b2.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
block_on(client.import(BlockOrigin::Own, b3.clone())).unwrap();
|
|
|
|
// B3 -> B4
|
|
let b4 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(b3.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
block_on(client.import(BlockOrigin::Own, b4)).unwrap();
|
|
|
|
// // B2 -> C3
|
|
let mut builder = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(b2.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap();
|
|
// this push is required as otherwise C3 has the same hash as B3 and won't get imported
|
|
builder
|
|
.push_transfer(Transfer {
|
|
from: AccountKeyring::Alice.into(),
|
|
to: AccountKeyring::Ferdie.into(),
|
|
amount: 1,
|
|
nonce: 1,
|
|
})
|
|
.unwrap();
|
|
let c3 = builder.build().unwrap().block;
|
|
block_on(client.import(BlockOrigin::Own, c3.clone())).unwrap();
|
|
|
|
// A1 -> D2
|
|
let mut builder = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(a1.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap();
|
|
// this push is required as otherwise D2 has the same hash as B2 and won't get imported
|
|
builder
|
|
.push_transfer(Transfer {
|
|
from: AccountKeyring::Alice.into(),
|
|
to: AccountKeyring::Ferdie.into(),
|
|
amount: 1,
|
|
nonce: 0,
|
|
})
|
|
.unwrap();
|
|
let d2 = builder.build().unwrap().block;
|
|
block_on(client.import(BlockOrigin::Own, d2.clone())).unwrap();
|
|
|
|
let genesis_hash = client.chain_info().genesis_hash;
|
|
|
|
let children1 = blockchain.children(a4.hash()).unwrap();
|
|
assert_eq!(vec![a5.hash()], children1);
|
|
|
|
let children2 = blockchain.children(a1.hash()).unwrap();
|
|
assert_eq!(vec![a2.hash(), b2.hash(), d2.hash()], children2);
|
|
|
|
let children3 = blockchain.children(genesis_hash).unwrap();
|
|
assert_eq!(vec![a1.hash()], children3);
|
|
|
|
let children4 = blockchain.children(b2.hash()).unwrap();
|
|
assert_eq!(vec![b3.hash(), c3.hash()], children4);
|
|
}
|
|
|
|
pub fn test_blockchain_query_by_number_gets_canonical<B: 'static>(backend: Arc<B>)
|
|
where
|
|
B: backend::LocalBackend<substrate_test_runtime::Block>,
|
|
{
|
|
// block tree:
|
|
// G -> A1 -> A2 -> A3 -> A4 -> A5
|
|
// A1 -> B2 -> B3 -> B4
|
|
// B2 -> C3
|
|
// A1 -> D2
|
|
let mut client = TestClientBuilder::with_backend(backend.clone()).build();
|
|
let blockchain = backend.blockchain();
|
|
let genesis_hash = client.chain_info().genesis_hash;
|
|
|
|
// G -> A1
|
|
let a1 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(genesis_hash)
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
block_on(client.import(BlockOrigin::Own, a1.clone())).unwrap();
|
|
|
|
// A1 -> A2
|
|
let a2 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(a1.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
block_on(client.import(BlockOrigin::Own, a2.clone())).unwrap();
|
|
|
|
// A2 -> A3
|
|
let a3 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(a2.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
block_on(client.import(BlockOrigin::Own, a3.clone())).unwrap();
|
|
|
|
// A3 -> A4
|
|
let a4 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(a3.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
block_on(client.import(BlockOrigin::Own, a4.clone())).unwrap();
|
|
|
|
// A4 -> A5
|
|
let a5 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(a4.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
block_on(client.import(BlockOrigin::Own, a5.clone())).unwrap();
|
|
|
|
// A1 -> B2
|
|
let mut builder = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(a1.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap();
|
|
// this push is required as otherwise B2 has the same hash as A2 and won't get imported
|
|
builder
|
|
.push_transfer(Transfer {
|
|
from: AccountKeyring::Alice.into(),
|
|
to: AccountKeyring::Ferdie.into(),
|
|
amount: 41,
|
|
nonce: 0,
|
|
})
|
|
.unwrap();
|
|
let b2 = builder.build().unwrap().block;
|
|
block_on(client.import(BlockOrigin::Own, b2.clone())).unwrap();
|
|
|
|
// B2 -> B3
|
|
let b3 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(b2.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
block_on(client.import(BlockOrigin::Own, b3.clone())).unwrap();
|
|
|
|
// B3 -> B4
|
|
let b4 = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(b3.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.build()
|
|
.unwrap()
|
|
.block;
|
|
block_on(client.import(BlockOrigin::Own, b4)).unwrap();
|
|
|
|
// // B2 -> C3
|
|
let mut builder = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(b2.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap();
|
|
// this push is required as otherwise C3 has the same hash as B3 and won't get imported
|
|
builder
|
|
.push_transfer(Transfer {
|
|
from: AccountKeyring::Alice.into(),
|
|
to: AccountKeyring::Ferdie.into(),
|
|
amount: 1,
|
|
nonce: 1,
|
|
})
|
|
.unwrap();
|
|
let c3 = builder.build().unwrap().block;
|
|
block_on(client.import(BlockOrigin::Own, c3)).unwrap();
|
|
|
|
// A1 -> D2
|
|
let mut builder = BlockBuilderBuilder::new(&client)
|
|
.on_parent_block(a1.hash())
|
|
.fetch_parent_block_number(&client)
|
|
.unwrap()
|
|
.build()
|
|
.unwrap();
|
|
// this push is required as otherwise D2 has the same hash as B2 and won't get imported
|
|
builder
|
|
.push_transfer(Transfer {
|
|
from: AccountKeyring::Alice.into(),
|
|
to: AccountKeyring::Ferdie.into(),
|
|
amount: 1,
|
|
nonce: 0,
|
|
})
|
|
.unwrap();
|
|
let d2 = builder.build().unwrap().block;
|
|
block_on(client.import(BlockOrigin::Own, d2)).unwrap();
|
|
|
|
let genesis_hash = client.chain_info().genesis_hash;
|
|
|
|
assert_eq!(blockchain.hash(0).unwrap().unwrap(), genesis_hash);
|
|
assert_eq!(blockchain.hash(1).unwrap().unwrap(), a1.hash());
|
|
assert_eq!(blockchain.hash(2).unwrap().unwrap(), a2.hash());
|
|
assert_eq!(blockchain.hash(3).unwrap().unwrap(), a3.hash());
|
|
assert_eq!(blockchain.hash(4).unwrap().unwrap(), a4.hash());
|
|
assert_eq!(blockchain.hash(5).unwrap().unwrap(), a5.hash());
|
|
}
|