Go to file
behzad nouri 75d62ca095
improves threads' utilization in processing gossip packets (#12962)
ClusterInfo::process_packets handles incoming packets in a thread_pool:
https://github.com/solana-labs/solana/blob/87311cce7/core/src/cluster_info.rs#L2118-L2134

However, profiling runtime shows that threads are not well utilized and
a lot of the processing is done sequentially.

This commit redistributes the work done in parallel. Testing on a gce
cluster shows 20%+ improvement in processing gossip packets with much
smaller variations.
2020-10-19 19:03:38 +00:00
.buildkite Remove secrets not required by the main public CI 2020-08-31 11:05:28 -07:00
.github Github issues with 1 year of inactivity are now marked stale, and will be closed 7 days later. 2020-09-15 17:51:06 -07:00
.travis Update channel_restriction.sh 2020-10-04 10:18:42 -06:00
account-decoder Bump spl-memo and spl-token versions (#12917) 2020-10-15 18:23:41 +00:00
accounts-bench Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
banking-bench Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
banks-client Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
banks-interface Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
banks-server Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
bench-exchange Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
bench-streamer Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
bench-tps Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
ci CI: Warn when setting up a buildkite agent with no SSH authorized_keys 2020-10-14 17:07:20 -06:00
clap-utils keygen: add more mnemonic language support (#12944) 2020-10-17 10:51:53 +08:00
cli Revert "CLI: Put `deploy` ephemeral keypair behind a flag" (#12983) 2020-10-19 12:44:32 -06:00
cli-config Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
cli-output Improve vote-account "Recent Timestamp" output 2020-10-19 06:20:40 +00:00
client Cleanly handle RPC servers that don't have --enable-rpc-transaction-history enabled 2020-10-13 10:05:44 -07:00
core improves threads' utilization in processing gossip packets (#12962) 2020-10-19 19:03:38 +00:00
crate-features Bump reqwest/rayon to get past `cargo audit` 2020-10-11 18:51:09 +00:00
docs Minor doc typo 2020-10-19 03:09:09 +00:00
dos Bump reqwest/rayon to get past `cargo audit` 2020-10-11 18:51:09 +00:00
download-utils Bump reqwest/rayon to get past `cargo audit` 2020-10-11 18:51:09 +00:00
explorer chore:(deps): bump @types/chart.js from 2.9.25 to 2.9.26 in /explorer (#12974) 2020-10-19 08:26:49 +00:00
faucet Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
genesis Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
gossip Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
install Switch to tempfile 2020-10-11 18:51:09 +00:00
keygen keygen: add more mnemonic language support (#12944) 2020-10-17 10:51:53 +08:00
ledger improves threads' utilization in processing gossip packets (#12962) 2020-10-19 19:03:38 +00:00
ledger-tool Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
local-cluster Follow up to persistent tower with tests and API cleaning (#12350) 2020-10-19 16:37:03 +09:00
log-analyzer Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
logger Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
measure Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
merkle-tree Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
metrics Bump reqwest/rayon to get past `cargo audit` 2020-10-11 18:51:09 +00:00
multinode-demo Add multinode-demo/setup-from-testnet.sh 2020-09-29 04:21:37 +00:00
net Adds public key for alexander@solana.com (#12980) 2020-10-20 01:11:02 +09:00
net-shaper Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
net-utils Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
notifier Bump reqwest/rayon to get past `cargo audit` 2020-10-11 18:51:09 +00:00
perf improves threads' utilization in processing gossip packets (#12962) 2020-10-19 19:03:38 +00:00
poh-bench Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
programs Report compute budget usage (#12931) 2020-10-15 15:55:37 -07:00
ramp-tps Bump reqwest/rayon to get past `cargo audit` 2020-10-11 18:51:09 +00:00
rayon-threadlimit Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
remote-wallet Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
runtime Calculate accounts hash async in accounts background service (#12852) 2020-10-19 09:48:29 -07:00
scripts Release: Use pinned cargo version to install spl-token-cli 2020-10-15 16:59:59 +00:00
sdk Follow up to persistent tower with tests and API cleaning (#12350) 2020-10-19 16:37:03 +09:00
stake-accounts Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
stake-monitor Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
stake-o-matic simulate_transaction_with_config() now passes full config to server 2020-10-11 21:45:00 -07:00
storage-bigtable Convert Blockstore Rewards cf to protobuf (#12860) 2020-10-15 18:04:10 -06:00
storage-proto Convert Blockstore Rewards cf to protobuf (#12860) 2020-10-15 18:04:10 -06:00
streamer Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
sys-tuner Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
system-test Modernize python scripts 2020-09-30 11:25:26 -06:00
tokens Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
transaction-status Convert Blockstore Rewards cf to protobuf (#12860) 2020-10-15 18:04:10 -06:00
upload-perf Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
validator Only fetch snapshot if it's newer than local (#12663) 2020-10-09 15:05:41 +09:00
version Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
vote-signer Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
watchtower Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
web3.js chore: bump @babel/plugin-proposal-class-properties in /web3.js (#12977) 2020-10-19 08:25:08 +00:00
.clippy.toml
.codecov.yml Adjust settings 2018-12-20 12:32:25 -08:00
.gitignore Keep .DS_Store out of the tree 2020-08-04 16:34:45 -07:00
.mergify.yml Mergify backports: add v1.4, drop v1.1 2020-08-05 15:38:56 -06:00
.travis.yml Add ci env to travis config (#12608) 2020-10-01 05:07:47 +00:00
CONTRIBUTING.md Fix link (#11742) 2020-08-20 18:02:36 +00:00
Cargo.lock Follow up to persistent tower with tests and API cleaning (#12350) 2020-10-19 16:37:03 +09:00
Cargo.toml Convert Blockstore Rewards cf to protobuf (#12860) 2020-10-15 18:04:10 -06:00
LICENSE Change documentation introduction to indicate Foundation IP transfer (#10440) 2020-06-13 14:41:05 -07:00
README.md Add disclaimer (#12881) 2020-10-14 19:30:06 -06:00
RELEASE.md Fix typos (#12446) 2020-09-24 07:53:30 +00:00
cargo Support arbitrary toolchains with cargo wrapper script 2020-10-15 18:55:50 +00:00
fetch-perf-libs.sh Take v0.19.3 of perf libs which improves sigverify perf 2x (#11894) 2020-08-28 12:34:25 -07:00
fetch-spl.sh Update to spl-token 2 2020-08-29 09:25:17 -07:00
run.sh Show commit in `--version` and ledger-tool's log (#12636) 2020-10-04 00:30:26 +09:00

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

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 testnet

  • testnet - public stable testnet accessible via devnet.solana.com. Runs 24/7

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 author's best effort. 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 Solana, or developer resources that Solana provides, are for educational and inspiration purposes only. Solana does not encourage, induce or sanction the deployment of any such applications in violation of applicable laws or regulations.