Aleo之家
一、概述
snarkOS是一个用于私有应用程序的去中心化操作系统。它构成了Aleo的主干，使应用程序能够以可公开验证的方式验证和存储状态。
2. 构建指南
2.1 要求
以下是运行 Aleo 节点的最低要求：
- CPU : 16 核 (首选 32 核)
- RAM：16GB内存（32GB优先）
- 存储：128GB 磁盘空间
- 网络：50 Mbps的上传和下载带宽
请注意，要运行具有竞争力的 Aleo 挖矿节点，机器将需要超过这些要求。
2.2 安装
在开始之前，请确保您的机器已Rust v1.56+安装。可以在此处找到安装 Rust的说明。
首先克隆 snarkOS Github 存储库：
git clone https://github.com/AleoHQ/snarkOS.git --depth 1
接下来，进入 snarkOS 目录：
cd snarkOS
[对于 Ubuntu 用户]提供了安装依赖项的帮助脚本。从 snarkOS 目录，运行：
./testnet2_ubuntu.sh
3a。运行 Aleo 客户端节点
首先按照构建指南中的说明进行操作。
接下来，要从 snarkOS 目录启动客户端节点，请运行：
./run-client.sh
3b。运行 Aleo 挖矿节点
首先按照构建指南中的说明进行操作。
接下来，要生成 Aleo 矿工地址，请运行：
snarkos experimental new_account
或从 snarkOS 目录运行：
cargo run --release -- experimental new_account
这将在终端中输出一个新的 Aleo 帐户。
请记住保存帐户私钥和查看密钥。以下是示例输出：
Attention - Remember to store this account private key and view key.
Private Key APrivateKey1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx <-- Save Me
View Key AViewKey1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx <-- Save Me
Address aleo1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx <-- Use Me For The Next Step
接下来，要启动挖掘节点，从 snarkOS 目录运行：
./run-miner.sh
出现提示时，输入您的 Aleo 矿工地址：
Enter your Aleo miner address:
aleo1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
采矿报告
挖矿节点启动后，会提供一份定期报告，其中包含已开采区块的状态：
INFO Mining Report (confirmed_blocks = 1, pending_blocks = 5, miner_address = aleo1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx)
该报告也可以在挖矿节点已经运行后，通过cargo run --release -- miner stats aleo1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 在 snarkOS 目录中运行，或snarkos miner stats aleo1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.
4. Testnet2 常见问题
1. 我的节点无法编译。
- 确保您的机器已
Rust v1.56+安装。可以在此处找到安装 Rust的说明。 - 如果编译过程中出现大错误，请尝试运行
cargo clean. - 确保 snarkOS 使用
./run-client.sh或启动./run-miner.sh。
2. 我的节点无法连接到网络上的对等节点。
- 确保端口
4132/tcp和3032/tcp在您的路由器和操作系统防火墙上打开。 - 确保 snarkOS 使用
./run-client.sh或启动./run-miner.sh。
3. 无法生成新地址
- 在运行上面的命令之前（
snarkos experimental new_account）尝试source ~/.bashrc - 还要仔细检查
snarkos. 注意目录是/snarkOS，命令是snarkos
4. 我可以跨多个 snarkOS 机器/实例协调挖矿吗？
- 是的。只需在多台机器（不是同一台机器）上启动多个 snarkOS 实例并输入相同的矿工地址。目前，Aleo 没有与任何其他矿池协议（如 stratum）集成。但如果有人想实施，请申请资助！
5.命令行界面
要使用自定义设置运行节点，请参阅 snarkOS CLI 中可用选项和标志的完整列表。
可以通过以下方式查看 CLI 标志和选项的完整列表snarkos --help：
snarkos
The Aleo Team <hello@aleo.org>
USAGE:
snarkos [FLAGS] [OPTIONS] [SUBCOMMAND]
FLAGS:
--display If the flag is set, the node will render a read-only display
-h, --help Prints help information
--norpc If the flag is set, the node will not initialize the RPC server
-V, --version Prints version information
OPTIONS:
--connect <connect> Specify the IP address and port of a peer to connect to
--dev <dev> Enables development mode, specify a unique ID for the local node
--miner <miner> Specify this as a mining node, with the given miner address
--network <network> Specify the network of this node [default: 2]
--node <node> Specify the IP address and port for the node server [default: 0.0.0.0:4132]
--operator <operator> Specify this as an operating node, with the given operator address
--pool <pool> Specify the pool that a prover node is contributing to
--prover <prover> Specify this as a prover node, with the given prover address
--rpc <rpc> Specify the IP address and port for the RPC server [default: 0.0.0.0:3032]
--password <rpc-password> Specify the password for the RPC server [default: pass]
--username <rpc-username> Specify the username for the RPC server [default: root]
--verbosity <verbosity> Specify the verbosity of the node [options: 0, 1, 2, 3] [default: 2]
SUBCOMMANDS:
clean Removes the ledger files from storage
experimental Experimental features
help Prints this message or the help of the given subcommand(s)
miner Miner commands and settings
update Updates snarkOS to the latest version
六、开发指南
在一个终端中，通过运行以下命令启动第一个节点：
cargo run --release -- --dev 1 --node 0.0.0.0:4135 --rpc 0.0.0.0:3035 --miner aleo1d5hg2z3ma00382pngntdp68e74zv54jdxy249qhaujhks9c72yrs33ddah
第一个节点启动后，在第二个终端中运行：
cargo run --release -- --dev 2
我们欢迎所有对 snarkOS 的贡献。请参阅许可中的贡献条款。
