solana README

The project's README from github.com/solana-labs/solana. As one markdown file: README.md.

PLEASE READ: This repo is now a public archive

This repo still exists in archived form, feel free to fork any reference implementations it still contains.

See Agave, the Solana validator implementation from Anza: https://github.com/anza-xyz/agave

Solana

Solana crate Solana documentation Build status codecov

Building

1. Install rustc, cargo and rustfmt.

$ curl https://sh.rustup.rs -sSf | sh
$ source $HOME/.cargo/env
$ rustup component add rustfmt

When building the master branch, please make sure you are using the latest stable rust version by running:

$ rustup update

When building a specific release branch, you should check the rust version in ci/rust-version.sh and if necessary, install that version by running:

$ rustup install VERSION

Note that if this is not the latest rust version on your machine, cargo commands may require an override in order to use the correct version.

On Linux systems you may need to install libssl-dev, pkg-config, zlib1g-dev, protobuf etc.

On 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

On Fedora:

$ sudo dnf install openssl-devel systemd-devel pkg-config zlib-devel llvm clang cmake make protobuf-devel protobuf-compiler perl-core

2. Download the source code.

$ git clone https://github.com/solana-labs/solana.git
$ cd solana

3. Build.

$ ./cargo build

Testing

Run the test suite:

$ ./cargo test

Starting a local testnet

Start your own testnet locally, instructions are in the online docs.

Accessing the remote development cluster

Benchmarking

First, install the nightly build of rustc. cargo bench requires the use of the unstable features only available in the nightly build.

$ rustup install nightly

Run the benchmarks:

$ cargo +nightly bench

Release Process

The release process for this project is described here.

Code coverage

To generate code coverage statistics:

$ scripts/coverage.sh
$ open target/cov/lcov-local/index.html

Why coverage? While most see coverage as a code quality metric, we see it primarily as a developer productivity metric. When a developer makes a change to the codebase, presumably it's a solution to some problem. Our unit-test suite is how we encode the set of problems the codebase solves. Running the test suite should indicate that your change didn't infringe on anyone else's solutions. Adding a test protects your solution from future changes. Say you don't understand why a line of code exists, try deleting it and running the unit-tests. The nearest test failure should tell you what problem was solved by that code. If no test fails, go ahead and submit a Pull Request that asks, "what problem is solved by this code?" On the other hand, if a test does fail and you can think of a better way to solve the same problem, a Pull Request with your solution would most certainly be welcome! Likewise, if rewriting a test can better communicate what code it's protecting, please send us that patch!

Disclaimer

All claims, content, designs, algorithms, estimates, roadmaps, specifications, and performance measurements described in this project are done with the Solana Labs, Inc. (“SL”) good faith efforts. It is up to the reader to check and validate their accuracy and truthfulness. Furthermore, nothing in this project constitutes a solicitation for investment.

Any content produced by SL or developer resources that SL provides are for educational and inspirational purposes only. SL does not encourage, induce or sanction the deployment, integration or use of any such applications (including the code comprising the Solana blockchain protocol) in violation of applicable laws or regulations and hereby prohibits any such deployment, integration or use. This includes the use of any such applications by the reader (a) in violation of export control or sanctions laws of the United States or any other applicable jurisdiction, (b) if the reader is located in or ordinarily resident in a country or territory subject to comprehensive sanctions administered by the U.S. Office of Foreign Assets Control (OFAC), or (c) if the reader is or is working on behalf of a Specially Designated National (SDN) or a person subject to similar blocking or denied party prohibitions.

The reader should be aware that U.S. export control and sanctions laws prohibit U.S. persons (and other persons that are subject to such laws) from transacting with persons in certain countries and territories or that are on the SDN list. Accordingly, there is a risk to individuals that other persons using any of the code contained in this repo, or a derivation thereof, may be sanctioned persons and that transactions with such persons would be a violation of U.S. export controls and sanctions law.

solana (solana-labs/solana)

cryptocurrency
Searching Database…

15K ·GitHub
Solana
archived
What is this?This is the original Rust implementation of the Solana blockchain validator and ledger — a web-scale, high-performance blockchain protocol for decentralized apps and marketplaces. The repo is now archived and kept only as a historical reference.
Is this a library I import, or the actual node software?It's the full node/validator and ledger codebase you build and run, not a library you add to another project.
How do I build it?Install rustc, cargo and rustfmt, download the source, then build with cargo. There's also an online docs guide for starting a local testnet.
What do I need installed before building?You need the latest stable Rust toolchain (rustc, cargo, rustfmt); on Linux you may also need libssl-dev, pkg-config, zlib1g-dev and protobuf.
Can I still use this for a real validator?No — the repo is now a public archive and no longer maintained. The README points readers to Agave, Anza's active Solana validator implementation, for the real thing.
Who was this actually for?Rust developers and node operators building, testing, or running the Solana network — not end users of apps built on it.
What is Agave?Agave is the actively maintained Solana validator implementation from Anza that this archived repo now points readers to.
Can I still fork and build this code?Yes, forking reference implementations from this repo is fine, but it won't receive further updates or support.
What is devnet for?Devnet is Solana's public development cluster at devnet.solana.com, running 24/7 so developers can test against a live network.
Why does the project care so much about code coverage?The team treats coverage as a developer-productivity signal rather than just a quality metric: a nearby failing test when you delete a line tells you what problem that code was solving.
What are similar projects?diem, nuvex, bitcoin, quip-validator, shardeum, gun, solana-classic, anoma
Which topics is it in?validator, solana, bitcoin, decentralized, cryptocurrency, cryptography, p2p, web3, blockchain, distributed-systems, deprecated, rust
Creator
solana-labs
Size
438.3 MB
Stars
15K
Updated
CommitJan 22Releasev1.18.26Oct 12
Age
8y
Commits · 90 Days