Go to file
Jeff Washington (jwash) ce53b84cdc
refactor untar_snapshot_in to push parallelism deeper for further refactoring (#18310)
2021-06-29 18:26:15 -05:00
.buildkite Clear release cache for stable-perf (#17287) 2021-05-17 17:28:52 -06:00
.github
.travis
account-decoder chore: bump zstd from 0.5.3+zstd.1.4.5 to 0.9.0+zstd.1.5.0 (#18299) 2021-06-29 11:12:57 -06:00
accounts-bench calculate_capitalization uses hash calculation (#17443) 2021-06-14 08:53:07 -05:00
accounts-cluster-bench chore: cargo +nightly clippy --fix -Z unstable-options 2021-06-18 10:42:46 -07:00
banking-bench chore: cargo +nightly clippy --fix -Z unstable-options 2021-06-18 10:42:46 -07:00
banks-client chore: bump mio from 0.7.11 to 0.7.13 (#18190) 2021-06-24 22:32:47 -06:00
banks-interface chore: bump mio from 0.7.11 to 0.7.13 (#18190) 2021-06-24 22:32:47 -06:00
banks-server chore: bump mio from 0.7.11 to 0.7.13 (#18190) 2021-06-24 22:32:47 -06:00
bench-exchange chore: bump serde_yaml from 0.8.13 to 0.8.17 (#18169) 2021-06-23 09:44:34 -06:00
bench-streamer chore: cargo +nightly clippy --fix -Z unstable-options 2021-06-18 10:42:46 -07:00
bench-tps chore: bump serde_yaml from 0.8.13 to 0.8.17 (#18169) 2021-06-23 09:44:34 -06:00
ci ci: add wrapper script for running ci locally 2021-06-24 22:14:54 -06:00
clap-utils chore: bump url from 2.2.0 to 2.2.2 (#18170) 2021-06-23 14:54:50 -06:00
cli Cli epoch-info: generate epoch-completed time from block times (#18258) 2021-06-28 15:32:28 -06:00
cli-config chore: bump url from 2.2.0 to 2.2.2 (#18170) 2021-06-23 14:54:50 -06:00
cli-output Cli epoch-info: generate epoch-completed time from block times (#18258) 2021-06-28 15:32:28 -06:00
client chore: bump url from 2.2.0 to 2.2.2 (#18170) 2021-06-23 14:54:50 -06:00
core chore: bump byteorder from 1.3.4 to 1.4.3 (#18300) 2021-06-29 15:08:04 -06:00
crate-features chore: bump curve25519-dalek from 2.1.0 to 3.0.0 (#18188) 2021-06-24 22:32:32 -06:00
docs docs: A-Z sort accepted proposals 2021-06-28 22:10:12 +00:00
dos chore: bump bincode from 1.3.1 to 1.3.3 (#18087) 2021-06-21 16:06:31 +00:00
download-utils chore: bump tar from 0.4.28 to 0.4.35 (#17666) 2021-06-02 14:17:58 -06:00
explorer chore:(deps): bump @solana/spl-token-registry in /explorer (#18296) 2021-06-29 12:07:59 -05:00
faucet chore: bump byteorder from 1.3.4 to 1.4.3 (#18300) 2021-06-29 15:08:04 -06:00
frozen-abi chore: cargo +nightly clippy --fix -Z unstable-options 2021-06-18 10:42:46 -07:00
genesis chore: bump serde_yaml from 0.8.13 to 0.8.17 (#18169) 2021-06-23 09:44:34 -06:00
genesis-utils chore: cargo +nightly clippy --fix -Z unstable-options 2021-06-18 10:42:46 -07:00
gossip debug logs when crds table trim failed (#18307) 2021-06-29 19:39:46 +00:00
install chore: bump url from 2.2.0 to 2.2.2 (#18170) 2021-06-23 14:54:50 -06:00
keygen chore: cargo +nightly clippy --fix -Z unstable-options 2021-06-18 10:42:46 -07:00
ledger chore: bump byteorder from 1.3.4 to 1.4.3 (#18300) 2021-06-29 15:08:04 -06:00
ledger-tool chore: bump csv from 1.1.3 to 1.1.6 (#18261) 2021-06-28 09:56:42 -06:00
local-cluster Ignore flaky tests (#18278) 2021-06-28 21:15:21 +00:00
log-analyzer chore: bump byte-unit from 4.0.9 to 4.0.12 (#18089) 2021-06-21 15:21:10 +00:00
logger chore: bump env_logger from 0.8.3 to 0.8.4 (#18224) 2021-06-25 11:28:09 -06:00
measure chore: cargo +nightly clippy --fix -Z unstable-options 2021-06-18 10:42:46 -07:00
merkle-root-bench Bump version to v1.8.0 (#17541) 2021-05-27 08:51:53 -07:00
merkle-tree chore: bump hex from 0.4.2 to 0.4.3 (#17829) 2021-06-08 09:34:04 -06:00
metrics chore: bump env_logger from 0.8.3 to 0.8.4 (#18224) 2021-06-25 11:28:09 -06:00
multinode-demo Add automated restart test infrastructure (#17491) 2021-06-04 15:55:16 -07:00
net Update init-metrics.sh (#17952) 2021-06-15 04:31:28 +00:00
net-shaper chore: bump serde_json from 1.0.62 to 1.0.64 (#17735) 2021-06-04 17:45:26 +00:00
net-utils chore: bump url from 2.2.0 to 2.2.2 (#18170) 2021-06-23 14:54:50 -06:00
notifier Bump version to v1.8.0 (#17541) 2021-05-27 08:51:53 -07:00
perf chore: bump curve25519-dalek from 2.1.0 to 3.0.0 (#18188) 2021-06-24 22:32:32 -06:00
poh chore: bump bincode from 1.3.1 to 1.3.3 (#18087) 2021-06-21 16:06:31 +00:00
poh-bench chore: bump rayon from 1.5.0 to 1.5.1 (#17869) 2021-06-10 13:18:47 -06:00
program-test chore: bump mio from 0.7.11 to 0.7.13 (#18190) 2021-06-24 22:32:47 -06:00
programs chore: bump byteorder from 1.3.4 to 1.4.3 (#18300) 2021-06-29 15:08:04 -06:00
rayon-threadlimit Bump version to v1.8.0 (#17541) 2021-05-27 08:51:53 -07:00
rbpf-cli chore: cargo +nightly clippy --fix -Z unstable-options 2021-06-18 10:42:46 -07:00
remote-wallet chore: bump hidapi from 1.2.5 to 1.2.6 (#18088) 2021-06-21 11:28:47 -06:00
rpc Add metrics for rpc send-tx failures (#18156) 2021-06-22 19:54:52 -06:00
runtime refactor untar_snapshot_in to push parallelism deeper for further refactoring (#18310) 2021-06-29 18:26:15 -05:00
scripts Remove obsolete stake-monitor command 2021-06-16 16:10:36 -07:00
sdk chore: bump byteorder from 1.3.4 to 1.4.3 (#18300) 2021-06-29 15:08:04 -06:00
stake-accounts chore: cargo +nightly clippy --fix -Z unstable-options 2021-06-18 10:42:46 -07:00
storage-bigtable chore: bump zstd from 0.5.3+zstd.1.4.5 to 0.9.0+zstd.1.5.0 (#18299) 2021-06-29 11:12:57 -06:00
storage-proto chore: bump bincode from 1.3.1 to 1.3.3 (#18087) 2021-06-21 16:06:31 +00:00
streamer Drop Error suffix from enum values to avoid the enum_variant_names clippy lint 2021-06-18 23:02:13 +00:00
sys-tuner chore: bump libc from 0.2.96 to 0.2.97 (#18060) 2021-06-18 11:51:06 -06:00
system-test Restart test without supermajority (#17808) 2021-06-10 12:56:31 -07:00
tokens chore: bump csv from 1.1.3 to 1.1.6 (#18261) 2021-06-28 09:56:42 -06:00
transaction-status tx-status: Don't assume a memo instruction succeeded 2021-06-28 18:23:34 -06:00
upload-perf Update to Rust 1.53.0 2021-06-18 20:20:13 -07:00
validator Remove redundant JsonRpcConfig::identity_pubkey field 2021-06-22 17:20:11 -07:00
version chore: bump rustc_version from 0.2.3 to 0.4.0 (#17854) 2021-06-09 16:57:39 +00:00
watchtower chore: cargo +nightly clippy --fix -Z unstable-options 2021-06-18 10:42:46 -07:00
web3.js chore: bump @typescript-eslint/parser from 4.28.0 to 4.28.1 in /web3.js (#18298) 2021-06-29 08:21:44 +00:00
.clippy.toml
.codecov.yml
.gitignore
.mergify.yml Add label to community contributions (#17876) 2021-06-10 12:28:37 -07:00
.travis.yml explorer: downgrade nodejs version in travis (#16740) 2021-04-22 22:27:50 +08:00
CONTRIBUTING.md
Cargo.lock chore: bump byteorder from 1.3.4 to 1.4.3 (#18300) 2021-06-29 15:08:04 -06:00
Cargo.toml Remove obsolete stake-monitor command 2021-06-16 16:10:36 -07:00
LICENSE
README.md Update README.md (#18191) 2021-06-24 09:29:49 -06:00
RELEASE.md
SECURITY.md Clarify bug bounty payment policy (#16488) 2021-04-12 14:53:15 -06:00
cargo Speed up net.sh builds (#16360) 2021-04-07 14:45:03 +08:00
cargo-build-bpf
cargo-test-bpf
fetch-perf-libs.sh
fetch-spl.sh Load memo v2 into genesis for test validator (#15425) 2021-02-19 15:59:31 +08:00
run.sh Skip leader slots until a vote lands (#15607) 2021-03-25 18:54:51 -07:00
test-abi.sh

README.md

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

Please make sure you are always using the latest stable rust version by running:

$ rustup update

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

$ sudo apt-get update
$ sudo apt-get install libssl-dev libudev-dev pkg-config zlib1g-dev llvm clang make

On Mac M1s, make sure you set up your terminal & homebrew to use Rosetta. You can install it with:

$ softwareupdate --install-rosetta

2. Download the source code.

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

3. Build.

$ cargo build

4. Run a minimal local cluster.

$ ./run.sh

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

  • devnet - stable public cluster for development accessible via devnet.solana.com. Runs 24/7. Learn more about the public clusters

Benchmarking

First install the nightly build of rustc. cargo bench requires 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 Foundation's ("SF") best 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 SF or developer resources that SF provides, are for educational and inspiration purposes only. SF 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 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. As a project based primarily on open-source software, it is possible that such sanctioned persons may nevertheless bypass prohibitions, obtain the code comprising the Solana blockchain protocol (or other project code or applications) and deploy, integrate, or otherwise use it. Accordingly, there is a risk to individuals that other persons using the Solana blockchain protocol may be sanctioned persons and that transactions with such persons would be a violation of U.S. export controls and sanctions law. This risk applies to individuals, organizations, and other ecosystem participants that deploy, integrate, or use the Solana blockchain protocol code directly (e.g., as a node operator), and individuals that transact on the Solana blockchain through light clients, third party interfaces, and/or wallet software.