104 polkadot substrate : 许可网络

wx468116118

已于 2022-06-21 16:25:31 修改

阅读量743

点赞数

分类专栏： Substrate教程文章标签：网络区块链

于 2022-06-11 02:01:18 首次发布

本文链接：https://blog.csdn.net/wx468116118/article/details/125230597

版权

Substrate教程专栏收录该内容

12 篇文章 4 订阅

订阅专栏

• 介绍
• 学习成果
• 构建节点模板
• 添加node-authorization托盘
• 为我们的托盘添加创世纪存储
• 获取节点密钥和 PeerID
• Alice 和 Bob 启动网络
• 添加 charlie 的节点
• 将 Dave 作为子节点添加到 Charlie
• Substrate Tutorials , Substrate 教程
• Contact 联系方式

• 介绍

在本教程中，您将学习如何使用节点授权托盘使用 Substrate 构建许可网络。本教程大约需要1 小时才能完成。

您可能已经熟悉公共或无需许可的区块链，每个人都可以通过运行节点自由加入网络。在许可网络中，仅允许授权节点执行特定活动，例如验证块和传播交易。可能需要许可区块链的一些示例：

• 私有（或联盟）网络
• 高度监管的数据环境（医疗保健、B2B 分类账等）
• 大规模测试公共网络

在您开始之前，我们希望：

• 您已完成构建 PoE 分散式应用程序教程。
• 您在概念上熟悉 Substrate 中的P2P 网络。我们建议先完成专用网络教程以获取相关经验。

• 学习成果

• 了解如何在运行时使用节点授权托盘
• 了解如何创建由多个节点组成的许可网络

• 构建节点模板

• 克隆节点模板。

git clone https://github.com/substrate-developer-hub/substrate-node-template
git checkout latest

• 构建节点模板。

cd substrate-node-template/
cargo build --release

• 添加node-authorization托盘

• 首先，我们必须将托盘添加到我们的运行时依赖项中：
runtime/Cargo.toml

pallet-node-authorization = { default-features = false, git = "https://github.com/paritytech/substrate.git", branch = "polkadot-v0.9.23" }

#--snip--
[features]
default = ['std']
std = [
    #--snip--
    'pallet-node-authorization/std',
    #--snip--
]

• 我们需要在我们简单的区块链中模拟治理，所以我们只需要一个sudo管理规则，将托盘的接口配置为EnsureRoot. 在生产环境中，我们应该希望在这里实现基于治理的检查。
runtime/src/lib.rs


/* --snip-- */

use frame_system::EnsureRoot;

/* --snip-- */

parameter_types! {
	pub const MaxWellKnownNodes: u32 = 8;
	pub const MaxPeerIdLength: u32 = 128;
}

impl pallet_node_authorization::Config for Runtime {
	type Event = Event;
	type MaxWellKnownNodes = MaxWellKnownNodes;
	type MaxPeerIdLength = MaxPeerIdLength;
	type AddOrigin = EnsureRoot<AccountId>;
	type RemoveOrigin = EnsureRoot<AccountId>;
	type SwapOrigin = EnsureRoot<AccountId>;
	type ResetOrigin = EnsureRoot<AccountId>;
	type WeightInfo = ();
}

/* --snip-- */

• construct_runtime最后，我们准备使用以下额外的代码行将我们的托盘放入宏中：
runtime/src/lib.rs

construct_runtime!(
	pub enum Runtime where
		Block = Block,
		NodeBlock = opaque::Block,
		UncheckedExtrinsic = UncheckedExtrinsic
	{
		/* --snip-- */
		NodeAuthorization: pallet_node_authorization, // <-- add this line
		/* --snip-- */
	}
);

• 为我们的托盘添加创世纪存储

• PeerId以 bs58 格式编码，因此我们需要在node/Cargo.toml中新建一个库bs58来对其进行解码以获取其字节。
node/cargo.toml

[dependencies]
#--snip--
bs58 = "0.4.0"
#--snip--

• 现在我们在node/src/chain_spec.rs添加一个适当的创世存储。同样，导入必要的依赖项：
节点/src/chain_spec.rs

/* --snip-- */
use sp_core::OpaquePeerId; // A struct wraps Vec<u8>, represents as our `PeerId`.
use node_template_runtime::NodeAuthorizationConfig; // The genesis config that serves for our pallet.
/* --snip-- */

• 在辅助函数中添加我们的 genesis 配置testnet_genesis，
节点/src/chain_spec.rs

/// Configure initial storage state for FRAME modules.
fn testnet_genesis(
	wasm_binary: &[u8],
	initial_authorities: Vec<(AuraId, GrandpaId)>,
	root_key: AccountId,
	endowed_accounts: Vec<AccountId>,
	_enable_println: bool,
) -> GenesisConfig {

		/* --snip-- */

	/*** Add This Block Item ***/
		node_authorization: NodeAuthorizationConfig {
			nodes: vec![
				(
					OpaquePeerId(bs58::decode("12D3KooWBmAwcd4PJNJvfV89HwE48nwkRmAgo8Vy3uQEyNNHBox2").into_vec().unwrap()),
					endowed_accounts[0].clone()
				),
				(
					OpaquePeerId(bs58::decode("12D3KooWQYV9dGMFoRzNStwpXztXaBUjtPqi6aU76ZgUriHhKust").into_vec().unwrap()),
					endowed_accounts[1].clone()
				),
			],
		},

	/* --snip-- */

}

• 获取节点密钥和 PeerID

• 对于 Alice 的知名节点：

# Node Key
c12b6d18942f5ee8528c8e2baf4e147b5c5c18710926ea492d09cbd9f6c9f82a

# Peer ID, generated from node key
12D3KooWBmAwcd4PJNJvfV89HwE48nwkRmAgo8Vy3uQEyNNHBox2

# BS58 decoded Peer ID in hex:
0x0024080112201ce5f00ef6e89374afb625f1ae4c1546d31234e87e3c3f51a62b91dd6bfa57df

• 对于 Bob 的知名节点：

# Node Key
6ce3be907dbcabf20a9a5a60a712b4256a54196000a8ed4050d352bc113f8c58

# Peer ID, generated from node key
12D3KooWQYV9dGMFoRzNStwpXztXaBUjtPqi6aU76ZgUriHhKust

# BS58 decoded Peer ID in hex:
0x002408011220dacde7714d8551f674b8bb4b54239383c76a2b286fa436e93b2b7eb226bf4de7

• 对于查理的不知名节点：

# Node Key
3a9d5b35b9fb4c42aafadeca046f6bf56107bd2579687f069b42646684b94d9e

# Peer ID, generated from node key
12D3KooWJvyP3VJYymTqG7eH4PM5rN4T2agk5cdNCfNymAqwqcvZ

# BS58 decoded Peer ID in hex:
0x002408011220876a7b4984f98006dc8d666e28b60de307309835d775e7755cc770328cdacf2e

• 对于 Dave 的子节点

# Node Key
a99331ff4f0e0a0434a6263da0a5823ea3afcfffe590c9f3014e6cf620f2b19a

# Peer ID, generated from node key
12D3KooWPHWFrfaJzxPnqnAYAoRUyAHHKqACmEycGTVmeVhQYuZN

# BS58 decoded Peer ID in hex:
0x002408011220c81bc1d7057a1511eb9496f056f6f53cdfe0e14c8bd5ffca47c70a8d76c1326d

Alice 和 Bob 的节点已经在创世存储中配置并作为众所周知的节点。我们稍后会将 Charlie 的节点添加到众所周知的节点集中。最后，我们将在 Charlie 的节点和 Dave 的节点之间添加连接，而不使 Dave 的节点成为众所周知的节点。

• Alice 和 Bob 启动网络

• 我们先启动 Alice 的节点：

./target/release/node-template \
--chain=local \
--base-path /tmp/validator1 \
--alice \
--node-key=c12b6d18942f5ee8528c8e2baf4e147b5c5c18710926ea492d09cbd9f6c9f82a \
--port 30333 \
--ws-port 9944

• 启动 Bob 的节点：

# In a new terminal, leave Alice running
./target/release/node-template \
--chain=local \
--base-path /tmp/validator2 \
--bob \
--node-key=6ce3be907dbcabf20a9a5a60a712b4256a54196000a8ed4050d352bc113f8c58 \
--port 30334 \
--ws-port 9945

两个节点都启动后，您应该能够在麻烦终端日志中看到创建和完成的新块。现在让我们使用 polkadot.js 应用程序并检查我们区块链的知名节点。不要忘记切换到我们正在运行的本地节点之一：127.0.0.1:9944或127.0.0.1:9945.

然后，我们进入开发者页面，Chain State 子选项卡，查看nodeAuthorization托盘、wellKnownNodesstorage 中存储的数据。您应该能够看到 Alice 和 Bob 节点的 peer id，前缀为0x以十六进制格式显示其字节。

我们也可以通过查询存储来查询一个节点的所有者，owners输入节点的peer id，你应该得到所有者的账户地址。

• 添加 charlie 的节点

• 让我们启动查理的节点，

./target/release/node-template \
--chain=local \
--base-path /tmp/validator3 \
--name charlie  \
--node-key=3a9d5b35b9fb4c42aafadeca046f6bf56107bd2579687f069b42646684b94d9e \
--port 30335 \
--ws-port=9946 \
--offchain-worker always

• 转到应用程序中的开发人员页面，Sudo选项卡，然后使用查理节点的十六进制对等 ID提交nodeAuthorization- 调用，当然所有者是查理。add_well_known_node注意 Alice 是此调用的有效 sudo 来源。

• 将 Dave 作为子节点添加到 Charlie

• 让我们添加 Dave 的节点，不是作为知名节点，而是 Charlie 的“子节点”。Dave 将只能连接到 Charlie 以访问网络。这是一项安全功能：因此 Charlie 独自负责任何连接的子节点对等点。大卫有一个访问控制点，以防他们需要被删除或审核。

使用以下命令启动 Dave 的节点：

./target/release/node-template \
--chain=local \
--base-path /tmp/validator4 \
--name dave \
--node-key=a99331ff4f0e0a0434a6263da0a5823ea3afcfffe590c9f3014e6cf620f2b19a \
--port 30336 \
--ws-port 9947 \
--offchain-worker always

启动后，没有可用的连接。这是一个许可网络，所以首先，Charlie 需要配置他的节点以允许来自 Dave 节点的连接。

在Developer Extrinsics页面中，让 Charlie 提交一个addConnectionsextrinsic。第一个 PeerId 是 Charlie 节点的十六进制对等 ID。连接是 Charlie 节点允许的 peer id 列表，这里我们只添加 Dave 的。
charlie_add_connections

然后，Dave 需要配置他的节点以允许来自 Charlie 节点的连接。但是在他添加这个之前，Dave 需要声明他的节点，希望还不算太晚！
dave_claim_node

同样，Dave 可以从 Charlie 的节点添加连接。
dave_add_connections

您现在应该看到 Dave 正在追赶积木，并且只有一个属于 Charlie 的同伴！重新启动 Dave 的节点，以防它没有立即与 Charlie 连接。

您已完成本教程，并且已经了解了如何构建许可网络。您还可以使用其他可调度的调用，例如 remove_well_known_node, remove_connections。

• Substrate Tutorials , Substrate 教程

CN 中文 Github Substrate 教程 : github.com/565ee/Substrate_CN
CN 中文 CSDN Substrate 教程 : blog.csdn.net/wx468116118
EN 英文 Github Substrate Tutorials : github.com/565ee/Substrate_EN
EN 英文 dev.to Substrate Tutorials : dev.to/565ee

• Contact 联系方式

Homepage : 565.ee
微信公众号 : wx468116118
微信 QQ : 468116118
GitHub : github.com/565ee
CSDN : blog.csdn.net/wx468116118
Email : 468116118@qq.com
微信公众号565 ee