astrix ノードダウンロード - astrix ノードソースコードのダウンロード

astrix node

その他のソースコード

v0.14.1

ダウンロード

アストリックスノード

Astrix フルノードとその補助ライブラリ。

私たちは開発者とブロックチェーン愛好家を招待し、Rust 実装の協力、テスト、最適化を行います。ここにあるコードの各行は、オープンソースのブロックチェーン運動に貢献する機会であり、分散化を損なうことなくスケーラビリティと速度を考慮して設計されたプラットフォームを形成します。

皆様のフィードバック、貢献、問題レポートは、このコードベースを進化させ、Astrix ネットワークの信頼できるノードとして成熟し続けるために不可欠です。

インストール

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/astrix-network/astrix-node
cd astrix-node

Windows 上で構築する

Git for Windows または代替の Git ディストリビューションをインストールします。
プロトコルバッファーをインストールし、 Pathにbinディレクトリを追加します。
LLVM-15.0.6-win64.exeをインストールする
LLVM インストールのbinディレクトリ ( C:Program FilesLLVMbin ) を PATH に追加します。
LIBCLANG_PATH環境変数もbinディレクトリを指すように設定します
重要: C++ の依存関係構成の問題により、WASM とネイティブ C++ コードコンパイル (ネイティブRocksDB+secp256k1とsecp256k1の WASM32 ビルド) を切り替えるときに、Windows での LLVM ARインストールが正しく機能しない可能性があります。残念ながら、 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/astrix-network/astrix-node
cd astrix-node

Mac OS 上で構築する

Protobuf のインストール (gRPC に必要)
```
brew install protobuf
```
llvmをインストールします。
llvmのデフォルトの XCode インストールは、WASM ビルドターゲットをサポートしません。 MacOS 上で WASM を構築するには、homebrew からllvmインストールする必要があります (この記事の執筆時点では、MacOS の llvm バージョンは 16.0.1 です)。
```
brew install llvm
```
注: Homebrew は、構成に応じて異なる樽のインストール場所を使用できます。例えば：
- /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/astrix-network/astrix-node
cd astrix-node

WASM32 SDKの構築

Rust WebAssembly (WASM) とは、Rust プログラミング言語を使用して、Web ブラウザーおよび NodeJ で実行されるバイナリ命令形式である WebAssembly にコンパイルできるコードを記述することを指します。これにより、Rust の利点を維持しながら、JavaScript および TypeScript プログラミング言語を使用した簡単な開発が可能になります。

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://nodejs.org/en
TypeDoc: https://typedoc.org/

Astrix CLI + ウォレット

「astrix-cli」クレートは、ノードへの cli 駆動の RPC インターフェイスと、Astrix Node Wallet ランタイムへのターミナルインターフェイスを提供します。これらのウォレットは、WASM SDK ウォレット API および Astrix 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 で機能するため、Web ブラウザを開いて http://localhost:4000 をロードします。

このフレームワークは、すべての主要なデスクトップおよびモバイルブラウザーと互換性があります。

ノードの実行

メインネットノードを開始する

cargo run --release --bin astrixd
# or with UTXO-index enabled (needed when using wallets)
cargo run --release --bin astrixd -- --utxoindex

設定ファイルの使用

cargo run --release --bin astrixd -- --configfile /path/to/configfile.toml
# or
cargo run --release --bin astrixd -- -C /path/to/configfile.toml

設定ファイルは、改行で区切られた = <値> のリストである必要があります。
=の前後の空白は問題なく、 arg=valueとarg = value両方とも正しく解析されます。
のような特殊文字を含む値.または=では、値を引用符で囲む必要があります ( = "<値>")。
複数の値を持つ引数はaddpeer = ["10.0.0.1", "1.2.3.4"]のように括弧で囲む必要があります。

例えば：

 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 astrixd -- --help

wRPC

wRPC サブシステムはastrixdではデフォルトで無効になっており、次の方法で有効にできます。

JSONプロトコル:

--rpclisten-json = < interface:port >
# or use the defaults for current network
--rpclisten-json = default

ボルシュプロトコル:

--rpclisten-borsh = < interface:port >
# or use the defaults for current network
--rpclisten-borsh = default

補足:

Astrix Node は、オプションの wRPC サブシステムを統合します。 wRPC は、Borsh および JSON プロトコルエンコーディングを使用できる、高性能、プラットフォーム中立、Rust 中心の WebSocket フレーム化 RPC 実装です。

JSON プロトコルメッセージングは JSON-RPC 1.0 に似ていますが、サーバー側の通知により仕様とは異なります。

Borsh エンコーディングはプロセス間通信を目的としています。 Borsh を使用する場合は、クライアントとサーバーの両方を同じコードベースから構築する必要があります。

JSON プロトコルは Astrix データ構造に基づいており、データ構造のバージョンに依存しません。任意の WebSocket ライブラリを使用して JSON エンドポイントに接続できます。 Web ブラウザおよび Node.js で実行できる JavaScript および TypeScript 用の組み込み RPC クライアントは、Astrix WASM フレームワークの一部として利用できます。

ベンチマークとテスト

シミュレーションフレームワーク（Simpa）

astrixdおよびsimpaへのログインは、次のいずれかでフィルタリングできます。

現在のコードベースは、完全なインプロセスネットワークシミュレーションをサポートしており、仮想遅延とベンチマーク検証時間 (シミュレーション生成後) を使用して仮想時間にわたって実際の DAG を構築します。

使用可能なコマンドを確認するには

cargo run --release --bin simpa -- --help

次のコマンドは、通信遅延 2 秒、BPS (1 秒あたりのブロック数) で 1000 個のブロックを生成するシミュレーションを実行し、各ブロックに最大 200 個のトランザクションを埋めようとします。

cargo run --release --bin simpa -- -t=200 -d=2 -b=8 -n=1000

ヒーププロファイリング

astrixdおよびsimpaでのヒーププロファイリングは、 --features引数を使用してheap機能とプロファイルを有効にすることで実行できます。

cargo run --bin astrixd --profile heap --features=heap

workdir のルートに{bin-name}-heap.jsonファイルが生成され、dhat-viewer で検査できます。

テスト

単体テストとほとんどの統合テストを実行する

 cd astrix-node
cargo test --release
// or install nextest and run

次のを使用する

 cd astrix-node
cargo nextest run --release

ベンチマーク

 cd astrix-node
cargo bench

ロギング

astrixdおよびsimpaへのログインは、次のいずれかでフィルタリングできます。

環境変数RUST_LOGの定義

次の例のように --loglevel 引数を追加します。

 (cargo run --bin astrixd -- --loglevel info,astrix_rpc_core=trace,astrix_grpc_core=trace,consensus=trace,astrix_core=trace) 2>&1 | tee ~/astrix-node.log

このコマンドでは、 loglevel INFOに設定します。

拡大する

追加情報