1 个稳定版本
1.3.0 | 2020 年 8 月 1 日 |
---|
#24 在 #dapp
67KB
1.5K SLoC
Astar 网络是基于 Substrate 框架和 Polkadot 生态系统内 dApp 的枢纽的一个互操作区块链。通过 Astar 网络和 Shiden 网络,人们可以将他们的代币质押到智能合约中,以奖励对网络提供价值的项目。
关于为该项目做出贡献,请阅读我们的 贡献指南。
从源代码构建
本节假设开发者正在运行 macOS 或 Debian 变体操作系统。对于 Windows,尽管有运行的方法,但我们建议使用 WSL 或虚拟机以获得稳定性。
从您的终端执行以下命令以设置开发环境并构建节点运行时。
# install Substrate development environment via the automatic script
$ curl https://getsubstrate.io -sSf | bash -s -- --fast
# clone the Git repository
$ git clone --recurse-submodules https://github.com/AstarNetwork/Astar.git
# change current working directory
$ cd Astar
# compile the node
# note: you may encounter some errors if `wasm32-unknown-unknown` is not installed, or if the toolchain channel is outdated
$ cargo build --release
# show list of available commands
$ ./target/release/astar-collator --help
使用 Nix 构建
# install Nix package manager:
$ curl https://nixos.org/nix/install | sh
# run from root of the project folder (`Astar/` folder)
$ nix-shell -I nixpkgs=channel:nixos-21.05 third-party/nix/shell.nix --run "cargo build --release"
运行分片节点
要设置分片节点,您必须有一个完全同步的节点和正确的参数,可以使用以下命令完成。
# start the Shiden collator node with
$ ./target/release/astar-collator \
--base-path <path to save blocks> \
--name <node display name> \
--port 30333 \
--rpc-port 9944 \
--telemetry-url 'wss://telemetry.polkadot.io/submit/ 0' \
--rpc-cors all \
--collator
现在,您可以通过发送以下 RPC 有效负载来获取节点的会话密钥。
# send `rotate_keys` request
$ curl -H 'Content-Type: application/json' --data '{ "jsonrpc":"2.0", "method":"author_rotateKeys", "id":1 }' localhost:9933
# should return a long string of hex, which is your session key
{"jsonrpc":"2.0","result":"<session key in hex>","id":1}
完成此步骤后,您应该有一个在线的验证节点和您的节点会话密钥。有关密钥管理和验证者奖励,请参阅我们的 在线验证者指南。
运行 RPC 测试
可以针对任何发布版运行 RPC 测试套件。要运行测试,请转到 https://github.com/AstarNetwork/Astar/actions/workflows/rpcTest.yml。点击运行工作流程,在下拉菜单中输入您要运行测试套件的发布版标签。然后点击绿色运行工作流程按钮以启动测试套件。
处理工作空间依赖项
所有依赖项都应列在工作空间的根 Cargo.toml
文件中。这允许我们轻松地通过修改单个位置中的版本来更改整个仓库使用的 crate 的版本。
目前,如果需要 非标准库,必须在根目录的 Cargo.toml
文件中设置 default-features = false
(与这个 问题 相关)。否则,将没有效果,导致您的编译失败。另外,由于从根到子crate没有正确传播 package
导入,因此应避免定义这些导入。
在根目录的 Cargo.toml
中定义 功能 与具体crate的 Cargo.toml
中定义的功能是可添加的。
添加依赖
- 检查依赖是否已在根
Cargo.toml
中定义- 如果 是,则无需操作,只需注意已启用的功能
- 如果 否,添加它(确保如果依赖项在 no_std 上下文中使用,则使用
default-features = false
)
- 将
new_dependecy = { workspace = true }
添加到所需的crate - 如果依赖项已使用
default-features = false
定义,但您需要在 std 上下文中使用它,请将features = ["std"]
添加到所需的crate。
进一步阅读
依赖项
~8–19MB
~263K SLoC