Go to file
Greg Fitzgerald 2660b44d91
Remove need for BanksClientExt trait (#13519)
2020-11-10 19:30:25 -07:00
.buildkite Don't reuse BPF target build artifacts 2020-10-26 00:10:50 -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-token and spl-memo crate versions 2020-11-04 21:44:33 +00:00
accounts-bench Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
banking-bench Remove unused pubkey::Pubkey imports 2020-10-21 19:08:13 -07:00
banks-client Remove need for BanksClientExt trait (#13519) 2020-11-10 19:30:25 -07:00
banks-interface Upgrade tarpc and tokio (#13293) 2020-10-29 19:21:18 -06:00
banks-server start_local_server() now works with Banks > 0 2020-10-31 18:12:24 -07:00
bench-exchange Remove Entrypoint type 2020-10-29 21:45:24 -07: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 fix running local test-sanity (#13482) 2020-11-09 15:03:44 -08:00
clap-utils Run `codemod --extensions rs Pubkey::new_rand solana_sdk::pubkey::new_rand` 2020-10-21 19:08:13 -07:00
cli Don't abort for missing epoch rewards; intead display warn (#13457) 2020-11-07 09:32:29 +00:00
cli-config Switch to dirs-next 2020-10-31 18:56:20 +00:00
cli-output CLI: Make clear that nonce account 'Nonce' field is a blockhash 2020-11-06 23:16:19 +00:00
client Refine transaction log count message 2020-11-04 05:30:52 +00:00
core Fix signature access (#13491) 2020-11-10 08:35:03 -08:00
crate-features Bump reqwest/rayon to get past `cargo audit` 2020-10-11 18:51:09 +00:00
docs docs: Consistent used of "jsonParsed" throughout RPC reference 2020-11-09 20:28:04 -07:00
dos Remove unused pubkey::Pubkey imports 2020-10-21 19:08:13 -07:00
download-utils Add non-progress bar download status (#13370) 2020-11-04 10:32:27 -08:00
explorer chore:(deps): bump @types/node from 14.14.6 to 14.14.7 in /explorer (#13494) 2020-11-10 09:13:11 +00:00
faucet Remove unused pubkey::Pubkey imports 2020-10-21 19:08:13 -07:00
frozen-abi Add cargo-build-bpf 2020-10-21 18:56:40 -07:00
genesis Remove unused pubkey::Pubkey imports 2020-10-21 19:08:13 -07:00
gossip Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
install CI: Use branch-versioned cargo throughout 2020-11-05 05:05:57 +00:00
keygen Switch to dirs-next 2020-10-31 18:56:20 +00:00
ledger Add back shredding broadcast stats (#13463) 2020-11-09 23:04:27 -08:00
ledger-tool Output more inflation calc details in ledger-tool (#13345) 2020-11-08 16:43:50 +09:00
local-cluster Fix duplicate records of inner instructions (#13380) 2020-11-05 15:23:52 +08: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 Remove unsupported metrics tarball from release artifacts 2020-10-20 13:10:33 -07:00
multinode-demo Add multinode-demo/setup-from-testnet.sh 2020-09-29 04:21:37 +00:00
net Add SSH key for buildkite-agent on achille 2020-10-27 01:57:25 +00: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 drops older gossip packets when load shedding (#13364) 2020-11-05 17:14:28 +00:00
poh-bench Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
program-test cargo-test-bpf now sets the "test-bpf" feature for crate tests 2020-11-06 10:21:07 -08:00
programs provide full Rust panic messages in BPF and add memory optimizations (#13455) 2020-11-09 13:40:26 -08:00
ramp-tps move Account to solana-sdk (#13198) 2020-10-28 22:01:07 -07:00
rayon-threadlimit Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
remote-wallet Run `codemod --extensions rs Pubkey::new_rand solana_sdk::pubkey::new_rand` 2020-10-21 19:08:13 -07:00
runtime Refactor function (#13294) 2020-11-10 17:20:35 -08:00
scripts increment-cargo-version.sh: Add check subcommand 2020-11-06 01:32:01 +00:00
sdk Fix parsing CreateAccountWithSeed instructions (#13513) 2020-11-10 23:51:53 +00:00
stake-accounts Run `codemod --extensions rs Pubkey::new_rand solana_sdk::pubkey::new_rand` 2020-10-21 19:08:13 -07:00
stake-monitor Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
stake-o-matic Add remaining stage 9 TdS validators 2020-11-04 13:44:57 -07:00
storage-bigtable CI: Use branch-versioned cargo throughout 2020-11-05 05:05:57 +00:00
storage-proto Fix reward type encoding 2020-10-26 00:10:50 -07: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 Remove need for BanksClientExt trait (#13519) 2020-11-10 19:30:25 -07:00
transaction-status Fix parsing CreateAccountWithSeed instructions (#13513) 2020-11-10 23:51:53 +00:00
upload-perf Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
validator Add non-progress bar download status (#13370) 2020-11-04 10:32:27 -08:00
version Native/builtin programs now receive an InvokeContext 2020-10-29 21:45:24 -07:00
vote-signer Bump version to v1.5.0 2020-10-08 04:51:36 +00:00
watchtower watchtower: Fix all clear duration message 2020-11-10 09:20:39 -08:00
web3.js chore: bump marked from 1.2.2 to 1.2.3 in /web3.js (#13417) 2020-11-06 09:58:48 +08:00
.clippy.toml
.codecov.yml
.gitignore
.mergify.yml
.travis.yml Add PATH to GNU readlink 2020-11-07 11:27:32 -08:00
CONTRIBUTING.md
Cargo.lock Remove need for BanksClientExt trait (#13519) 2020-11-10 19:30:25 -07:00
Cargo.toml Add cargo-test-bpf 2020-11-05 14:29:17 -08:00
LICENSE
README.md Make testnet section less ambiguous (#13504) 2020-11-10 10:03:57 -07: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
cargo-build-bpf Add cargo-test-bpf 2020-11-05 14:29:17 -08:00
cargo-test-bpf Add cargo-test-bpf 2020-11-05 14:29:17 -08: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 Bump token version fetched for localnet (#13490) 2020-11-10 10:00:08 -07:00
run.sh Show commit in `--version` and ledger-tool's log (#12636) 2020-10-04 00:30:26 +09:00
test-abi.sh Update frozen_abi hashes 2020-10-24 08:37:55 -07: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 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 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.