5个版本
| 0.13.4 | 2024年1月24日 |
|---|---|
| 0.0.4 | 2023年10月31日 |
| 0.0.3 | 2023年4月17日 |
| 0.0.2 | 2023年4月17日 |
| 0.0.1 | 2023年4月4日 |
#968 in 魔法豆
229 每月下载次数
在 22 个crate中（4个直接） 使用
560KB
12K SLoC
Kaspa 在 Rust 中
欢迎使用基于Rust的Kaspa全节点及其辅助库的实现。所包含的节点版本作为现有Golang节点的替代品，迄今为止是Kaspa网络的推荐节点软件，向开发者介绍了Rust在Kaspa网络环境中的可能性。
我们邀请开发者和区块链爱好者合作，测试和优化我们的Rust实现。这里的每一行代码都是为开源区块链运动做出贡献的机会，塑造一个旨在可扩展性和速度，同时不牺牲去中心化的平台。
您的反馈、贡献和问题报告将对我们发展这个代码库，并继续将其作为Kaspa网络中可靠的节点成熟至关重要。
安装
在Linux上构建
-
安装通用先决条件
sudo apt install curl git build-essential libssl-dev pkg-config -
安装Protobuf（gRPC所需的）
sudo apt install protobuf-compiler libprotobuf-dev #Required for gRPC -
安装clang工具链（RocksDB和WASM secp256k1构建所需的）
sudo apt-get install clang-format clang-tidy \ clang-tools clang clangd libc++-dev \ libc++1 libc++abi-dev libc++abi1 \ libclang-dev libclang1 liblldb-dev \ libllvm-ocaml-dev libomp-dev libomp5 \ lld lldb llvm-dev llvm-runtime \ llvm python3-clang -
安装rust工具链
如果您已经安装了 Rust，可以通过运行以下命令来更新它：
rustup update -
安装 wasm-pack
cargo install wasm-pack -
安装 wasm32 目标
rustup target add wasm32-unknown-unknown -
克隆仓库
git clone https://github.com/kaspanet/rusty-kaspa cd rusty-kaspa
在 Windows 上构建
-
安装 Git for Windows 或其他 Git 发行版。
-
安装 Protocol Buffers 并将
bin目录添加到您的Path -
将 LLVM 安装目录的
bin目录（例如C:\Program Files\LLVM\bin）添加到 PATH将
LIBCLANG_PATH环境变量设置为指向bin目录重要：由于 C++ 依赖配置问题，当在 WASM 和本地 C++ 代码编译（本地
RocksDB+secp256k1 与secp256k1的 WASM32 构建之间切换）时，Windows 上 LLVMAR安装可能无法正常工作。不幸的是，手动设置AR环境变量也会使 C++ 构建工具链困惑（它不应为本地设置，而应为 WASM32 目标设置）。目前，解决这个问题最好的方法如下：在 Windows 上安装 LLVM 后，转到目标bin安装目录，并将LLVM_AR.exe复制或重命名为AR.exe。 -
安装rust工具链
如果您已经安装了 Rust，可以通过运行以下命令来更新它：
rustup update -
安装 wasm-pack
cargo install wasm-pack -
安装 wasm32 目标
rustup target add wasm32-unknown-unknown -
克隆仓库
git clone https://github.com/kaspanet/rusty-kaspa cd rusty-kaspa
在 Mac OS 上构建
-
安装Protobuf（gRPC所需的）
brew install protobuf -
安装 llvm。
llvm的默认 XCode 安装不支持 WASM 构建目标。要在 MacOS 上构建 WASM，您需要从 homebrew 安装llvm（在撰写本文时，MacOS 的 llvm 版本为 16.0.1）。brew install llvm注意：根据您的配置，homebrew 可以使用不同的 keg 安装位置。例如
/opt/homebrew/opt/llvm->/opt/homebrew/Cellar/llvm/16.0.1/usr/local/Cellar/llvm/16.0.1
要确定安装位置，您可以使用
brew list llvm命令，然后根据以下路径进行修改% brew list llvm /usr/local/Cellar/llvm/16.0.1/bin/FileCheck /usr/local/Cellar/llvm/16.0.1/bin/UnicodeNameMappingGenerator ...如果您有
/opt/homebrew/Cellar，则可以使用/opt/homebrew/opt/llvm。将以下内容添加到您的
~/.zshrc文件中export PATH="/opt/homebrew/opt/llvm/bin:$PATH" export LDFLAGS="-L/opt/homebrew/opt/llvm/lib" export CPPFLAGS="-I/opt/homebrew/opt/llvm/include" export AR=/opt/homebrew/opt/llvm/bin/llvm-ar重新加载
~/.zshrc文件source ~/.zshrc -
安装rust工具链
如果您已经安装了 Rust，可以通过运行以下命令来更新它：
rustup update -
安装 wasm-pack
cargo install wasm-pack -
安装 wasm32 目标
rustup target add wasm32-unknown-unknown -
克隆仓库
git clone https://github.com/kaspanet/rusty-kaspa cd rusty-kaspa
构建 WASM32 SDK
Rust WebAssembly (WASM) 指的是使用 Rust 编程语言编写代码，该代码可以编译成 WebAssembly，这是一种在网页浏览器和 NodeJs 中运行的二进制指令格式。这允许使用 JavaScript 和 TypeScript 编程语言轻松开发，同时保留 Rust 的优势。
可以通过运行以下命令从源代码构建 WASM SDK 组件： - ./build-release - 构建完整的发布包（包括针对 web 和 nodejs 目标的发布和调试构建） - ./build-docs - 构建 TypeScript 文档 - ./build-web - 发布 web 构建 - ./build-web-dev - 开发 web 构建 - ./build-nodejs - 发布 nodejs 构建 - ./build-nodejs-dev - 开发 nodejs 构建
重要：请勿在生产环境中使用 dev 构建。它们非常大，速度较慢，并包含调试符号。
要求
- NodeJs (v20+): https://node.org.cn/en
- TypeDoc: https://typedoc.org/
构建和文档
- 发布构建： https://github.com/kaspanet/rusty-kaspa/releases
- 开发者构建： https://kaspa.aspectron.org/nightly/downloads/
- 开发者 TypeScript 文档： https://kaspa.aspectron.org/docs/
Kaspa CLI + 钱包
`kaspa-cli` 包提供了对节点的命令行驱动 RPC 接口以及对 Rusty Kaspa 钱包运行时的终端接口。这些钱包与 WASM SDK 钱包 API 和 Kaspa NG 项目兼容。cd cli
cargo run --release
本地网页钱包
在 wallet/wasm/web 文件夹内运行 http 服务器。如果没有，可以使用以下方法
cd wallet/wasm/web
cargo install basic-http-server
basic-http-server
basic-http-server 默认将在端口 4000 上提供服务，因此打开您的网页浏览器并加载 http://localhost:4000
该框架与所有主流桌面和移动浏览器兼容。
运行节点
启动主网节点
cargo run --release --bin kaspad
# or with UTXO-index enabled (needed when using wallets)
cargo run --release --bin kaspad -- --utxoindex
启动测试网节点
cargo run --release --bin kaspad -- --testnet
测试网 11
要参与 10BPS 测试网络（TN11），请参阅以下详细 指南。
使用配置文件
cargo run --release --bin kaspad -- --configfile /path/to/configfile.toml
# or
cargo run --release --bin kaspad -- -C /path/to/configfile.toml
- 配置文件应是一个由换行符分隔的 <CLI argument> = <value> 列表。
- 在等号周围有空格是可以的，
arg=value和arg = value都可以正确解析。 - 包含特殊字符如
.或=的值需要将值引号化，即 <CLI argument> = "<value>"。 - 具有多个值的参数应使用方括号括起来，例如
addpeer = ["10.0.0.1", "1.2.3.4"]。
例如
testnet = true
utxoindex = false
disable-upnp = true
perf-metrics = true
appdir = "some-dir"
netsuffix = 11
addpeer = ["10.0.0.1", "1.2.3.4"]
通过传递 --help 标志来查看所有可能的参数
cargo run --release --bin kaspad -- --help
wRPC
在 kaspad 中默认禁用了 wRPC 子系统，可以通过以下方式启用：
JSON 协议
--rpclisten-json = <interface:port>
# or use the defaults for current network
--rpclisten-json = default
Borsh 协议
--rpclisten-borsh = <interface:port>
# or use the defaults for current network
--rpclisten-borsh = default
旁注
Rusty Kaspa 集成了一个可选的 wRPC 子系统。wRPC 是一个高性能、平台中立、以 Rust 为中心的 WebSocket 封装 RPC 实现，可以使用 Borsh 和 JSON 协议进行编码。
JSON 协议消息类似于 JSON-RPC 1.0，但与规范不同，因为服务器端有通知。
Borsh 编码用于进程间通信。当使用 Borsh 时，客户端和服务器应从相同的代码库构建。
JSON 协议基于 Kaspa 数据结构，与数据结构版本无关。您可以使用任何 WebSocket 库连接到 JSON 端点。Kaspa WASM 框架中提供了内置的 JavaScript 和 TypeScript RPC 客户端，这些客户端能够在网络浏览器和 Node.js 中运行。
基准测试与测试
模拟框架（Simpa）
在 kaspad 和 simpa 中的日志可以通过以下方式 过滤：
当前代码库支持完整的进程内网络模拟，使用虚拟时间构建实际的 DAG，具有虚拟延迟并基准测试验证时间（在模拟生成后）。
要查看可用的命令
cargo run --release --bin simpa -- --help
以下命令将运行一个模拟，生成1000个具有2秒通信延迟和8 BPS（每秒块数）的块，同时尝试在每个块中填充多达200笔交易。
cargo run --release --bin simpa -- -t=200 -d=2 -b=8 -n=1000
堆栈分析
在 kaspad 和 simpa 中进行堆栈分析可以通过启用 heap 功能并使用 --features 参数进行配置
cargo run --bin kaspad --profile heap --features=heap
它将在工作目录的根目录下生成 {bin-name}-heap.json 文件，该文件可以通过 dhat-viewer 进行检查
测试
运行单元测试和大部分集成测试
cd rusty-kaspa
cargo test --release
// or install nextest and run
使用 nextest
cd rusty-kaspa
cargo nextest run --release
基准测试
cd rusty-kaspa
cargo bench
日志记录
在 kaspad 和 simpa 中的日志可以通过以下方式 过滤：
-
定义环境变量
RUST_LOG -
添加类似以下示例的 --loglevel 参数
(cargo run --bin kaspad -- --loglevel info,kaspa_rpc_core=trace,kaspa_grpc_core=trace,consensus=trace,kaspa_core=trace) 2>&1 | tee ~/rusty-kaspa.log在此命令中，我们将
loglevel设置为INFO。
依赖项
~37–55MB
~854K SLoC