Go to file
Michael Vines db989f7a88 drop small swap transactions 2020-12-01 17:27:59 -08:00
.buildkite Don't reuse BPF target build artifacts 2020-10-26 12:01:38 -07:00
.cache/fontconfig Update development docs (#13661) 2020-11-18 09:27:11 +00: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 version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
accounts-bench Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
banking-bench Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
banks-client Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
banks-interface Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
banks-server Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
bench-exchange Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
bench-streamer Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
bench-tps Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
ci audit: Ignore RUSTSEC-2020-0071, potential SEGV in `time` 2020-11-18 22:28:41 -07:00
clap-utils Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
cli Bump to rbpf v0.1.34 (#13874) 2020-12-01 01:43:50 +00:00
cli-config Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
cli-output Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
client Add `flatten` to logs_subscribe commitment (#13861) 2020-11-30 18:00:27 +00:00
core drop small swap transactions 2020-12-01 17:27:59 -08:00
crate-features Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
docs add zsh trouble shooting note to ledger docs (#13854) 2020-11-30 03:33:12 +00:00
dos Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
download-utils Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
explorer Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
faucet Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
frozen-abi caches vote-state de-serialized from vote accounts (#13795) (#13862) 2020-11-30 18:36:23 +00:00
genesis Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
gossip Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
install Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
keygen Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
ledger caches vote-state de-serialized from vote accounts (#13795) (#13862) 2020-11-30 18:36:23 +00:00
ledger-tool caches vote-state de-serialized from vote accounts (#13795) (#13862) 2020-11-30 18:36:23 +00:00
local-cluster Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
log-analyzer Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
logger Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
measure Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
merkle-tree Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
metrics Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00: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 (#13183) 2020-10-27 03:19:32 +00:00
net-shaper Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
net-utils Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
notifier Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
perf Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
poh-bench Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
program-test Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
programs Check that the program was granted access to program_id (bp #13890) (#13893) 2020-12-01 17:49:17 +00:00
ramp-tps Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
rayon-threadlimit Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
remote-wallet Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
runtime Reduce the number of snapshots 2020-12-01 13:05:24 -08:00
scripts Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
sdk Add msg! macro for program logging, deprecate info! macro (#13885) 2020-12-01 06:05:31 +00:00
stake-accounts Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
stake-monitor Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
stake-o-matic Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
storage-bigtable Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
storage-proto Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
streamer Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
sys-tuner Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
system-test Modernize python scripts 2020-09-30 11:25:26 -06:00
tokens solana-tokens: enable confirmation of many transactions (#13876) (#13881) 2020-12-01 04:15:22 +00:00
transaction-status Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
upload-perf Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
validator Fully clean up temporary snapshot staging directories (#13883) 2020-12-01 05:10:53 +00:00
version Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
vote-signer Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
watchtower Bump version to v1.4.14 (#13852) 2020-11-29 18:20:19 +00:00
web3.js Add stable program logging for BPF and native programs 2020-11-14 08:26:54 -08:00
.clippy.toml
.codecov.yml
.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 PATH to GNU readlink 2020-11-07 11:28:28 -08:00
CONTRIBUTING.md Fix link (#11742) 2020-08-20 18:02:36 +00:00
Cargo.lock Bump to rbpf v0.1.34 (#13874) 2020-12-01 01:43:50 +00:00
Cargo.toml Add cargo-test-bpf 2020-11-05 22:42:35 +00:00
LICENSE
README.md Make testnet section less ambiguous (#13504) (#13508) 2020-11-10 17:12:57 +00:00
RELEASE.md Fix typos (#12446) 2020-09-24 07:53:30 +00:00
cargo Support arbitrary toolchains with cargo wrapper script (#12926) 2020-10-15 20:26:35 +00:00
cargo-build-bpf Add cargo-test-bpf 2020-11-05 22:42:35 +00:00
cargo-test-bpf Add cargo-test-bpf 2020-11-05 22:42:35 +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 Add SPL Feature Proposal program (#13683) 2020-11-19 23:04:38 +00:00
run.sh run.sh: Use default client keypair for the faucet (bp #13614) (#13618) 2020-11-17 02:23:01 +00:00
test-abi.sh Separate the "program" feature of `solana-sdk` into a new crate called `solana-program` (bp #12989) (#13131) 2020-10-24 17:25:22 +00: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.