3 个版本 (破坏性更新)

0.2.0 2019 年 11 月 8 日
0.1.0 2019 年 5 月 24 日
0.0.0 2019 年 2 月 4 日

#17 in #nimiq


用于 4 个 crate(3 个直接使用)

Apache-2.0

1MB
19K SLoC

Nimiq 核心实现,使用 Rust (core-rs)

nimiq

Rust 对 Nimiq 区块链核心的实现

Nimiq 是一个无缝的网页支付协议。

此存储库已归档。您可以使用 JavaScript 实现。或者如果您正在寻找 Albatross Rust 实现,请查看相应的存储库。

Nimiq Rust 客户端不包含钱包,目前无法用于发送交易。不过,作为骨干节点,它比 JavaScript 实现性能更好。

目录

背景

安装

除了 Rust 夜间版本本身之外,还需要以下包才能编译此源代码

  • gcc
  • pkg-config
  • libssl-dev(在 Debian/Ubuntu 上)或 openssl-devel(在 Fedora/Red Hat 上)

从 crates.io

要从 crates.io 下载,请编译和安装客户端

cargo +nightly install nimiq-client

二进制文件将被安装到您的 Cargo 目录中,通常是 $HOME/.cargo/bin,并且应该在您的 $PATH 中可用。

从 Git

通过 cargo 编译项目

git clone https://github.com/nimiq/core-rs
cd core-rs
cargo +nightly build

请注意,这将以调试模式构建,这并不那么高效。为了从客户端中获得最佳速度,请以发布模式构建。

cargo +nightly build --release

如果您想将客户端安装到您的系统(到 $HOME/.cargo/bin),请运行

cargo +nightly install --path client/

或者您可以直接从git安装

cargo +nightly install --git https://github.com/nimiq/core-rs.git

安装客户端后,您可以使用它,就像您从 crates.io 下载一样。

使用方法

安装后,您可以像这样直接运行客户端

nimiq-client

配置

默认情况下,客户端将在 $HOME/.nimiq/client.config 中查找配置文件。您需要自己创建此文件

nimiq-client                                                   # Run the client. This will create the example config file.
cp $HOME/.nimiq/client.example.toml $HOME/.nimiq/client.toml   # Create your config from the example.
nano $HOME/.nimiq/client.toml                                  # Edit the config. Explanations are included in the file.

您也可以指定自己的配置文件

nimiq-client -c path/to/client.toml

请查看 client/client.example.toml 以了解所有配置选项。

贡献

如果您想为Nimiq的开发做出贡献,请遵循我们的 行为准则贡献指南

小贴士:如果您正在编辑README,请遵守 标准README规范

许可

本项目遵循 Apache License 2.0 许可。

依赖项

~23–34MB
~635K SLoC