solana-labs/solana

# 请阅读：此仓库现为公共存档 此仓库仍以存档形式存在，欢迎 fork 其中包含的任何参考实现。 请参阅 Anza 开发的 Solana 验证器实现 Agave：

[](https://crates.io/crates/solana-core) [](https://docs.rs/solana-core) [](https://buildkite.com/solana-labs/solana/builds?branch=master) [](https://codecov.io/gh/solana-labs/solana) # 构建 ## **1. 安装 rustc, cargo 和 rustfmt。** ``` $ curl https://sh.rustup.rs -sSf | sh $ source $HOME/.cargo/env $ rustup component add rustfmt ``` 在构建 master 分支时，请通过运行以下命令确保您使用的是最新的稳定版 rust： ``` $ rustup update ``` 在构建特定的发布分支时，您应该检查 `ci/rust-version.sh` 中的 rust 版本，如有必要，通过运行以下命令安装该版本： ``` $ rustup install VERSION ``` 请注意，如果这不是您机器上的最新 rust 版本，cargo 命令可能需要使用[覆盖](https://rust-lang.github.io/rustup/overrides.html)才能使用正确的版本。 在 Linux 系统上，您可能需要安装 libssl-dev, pkg-config, zlib1g-dev, protobuf 等。 在 Ubuntu 上： ``` $ sudo apt-get update $ sudo apt-get install libssl-dev libudev-dev pkg-config zlib1g-dev llvm clang cmake make libprotobuf-dev protobuf-compiler ``` 在 Fedora 上： ``` $ sudo dnf install openssl-devel systemd-devel pkg-config zlib-devel llvm clang cmake make protobuf-devel protobuf-compiler perl-core ``` ## **2. 下载源代码。** ``` $ git clone https://github.com/solana-labs/solana.git $ cd solana ``` ## **3. 构建。** ``` $ ./cargo build ``` # 测试 **运行测试套件：** ``` $ ./cargo test ``` ### 启动本地 testnet 在本地启动您自己的 testnet，说明请见[在线文档](https://docs.solanalabs.com/clusters/benchmark)。 ### 访问远程开发集群 - `devnet` - 稳定的公共开发集群，可通过 devnet.solana.com 访问。24/7 运行。了解更多关于[公共集群](https://docs.solanalabs.com/clusters)的信息 # 基准测试 首先，安装 rustc 的 nightly 版本。`cargo bench` 需要使用仅 nightly 版本中提供的不稳定功能。 ``` $ rustup install nightly ``` 运行基准测试： ``` $ cargo +nightly bench ``` # 发布流程 本项目的发布流程在[此处](RELEASE.md)描述。 # 代码覆盖率 生成代码覆盖率统计信息： ``` $ scripts/coverage.sh $ open target/cov/lcov-local/index.html ``` 为什么要有覆盖率？虽然大多数人将覆盖率视为代码质量指标，但我们主要将其视为开发者生产力指标。当开发者对代码库进行更改时，推测这是针对某个问题的_解决方案_。我们的单元测试套件是我们编码代码库所解决的_问题_集合的方式。运行测试套件应该表明您的更改没有_侵犯_他人的解决方案。添加测试可以_保护_您的解决方案免受未来更改的影响。假设您不明白为什么某行代码存在，尝试删除它并运行单元测试。最近的测试失败应该会告诉您该代码解决了什么问题。如果没有测试失败，请继续提交一个 Pull Request，询问“这段代码解决了什么问题？”另一方面，如果测试确实失败了，而您能想到更好的方法来解决同样的问题，那么非常欢迎您提交包含解决方案的 Pull Request！同样，如果重写测试可以更好地传达它所保护的代码，请将补丁发送给我们！ # 免责声明 本项目中描述的所有声明、内容、设计、算法、估算、路线图、规格和性能测量均基于 Solana Labs, Inc.（“SL”）的诚信努力。读者有责任检查和验证其准确性和真实性。 此外，本项目中的任何内容均不构成投资邀请。 SL 生产的任何内容或 SL 提供的开发者资源仅用于教育和启发目的。SL 不鼓励、引诱或批准违反适用法律或法规部署、集成或使用任何此类应用程序（包括构成 Solana 区块链协议的代码），并在此禁止任何此类部署、集成或使用。这包括读者在以下情况下使用任何此类应用程序： 违反美国或任何其他适用司法管辖区的出口管制或制裁法律， 如果读者位于或通常居住在受美国外国资产控制办公室 (OFAC) 全面制裁的国家或地区，或者 如果读者是或代表特别指定国民 (SDN) 或受类似封锁或被拒绝方禁止令约束的人员。 读者应注意，美国出口管制和制裁法律禁止美国人（以及受此类法律约束的其他人）与某些国家或地区的人员或 SDN 名单上的人员进行交易。因此，个人面临的风险是，使用此仓库中包含的任何代码或其派生代码的其他人可能是受制裁人员，而与这些人员的交易将违反美国出口管制和制裁法律。

标签：Agave, Bash脚本, DApp, DeFi, DNS解析, Layer 1, Rust, Solana, Solana核心, Web3, 公链, 共识机制, 分布式账本, 加密货币, 区块链, 去中心化应用, 去中心化金融, 可视化界面, 开源项目, 智能合约, 权益证明, 网络流量审计, 通知系统, 验证节点