You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Denis K 2da02992b7
Fixed bug with mishmash of traces from different programs in single log (#29605)
4 days ago
.buildkite chore: stop uploading test data to buildkite (#28411) 4 months ago
.github ci: fix commit range in push event (#29755) 2 weeks ago
account-decoder Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
accounts-bench Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
accounts-cluster-bench Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
banking-bench Add fully-reproducible online tracer for banking (#29196) 6 days ago
banks-client Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
banks-interface Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
banks-server Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
bench-streamer Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
bench-tps Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
bloom Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
bucket_map Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
cd Create continuous delivery directory and add readme with canary details. (#27683) 5 months ago
ci Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
clap-utils Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
clap-v3-utils Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
cli Restore compatibility for solana rent --output json command (#29953) 4 days ago
cli-config Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
cli-output Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
client Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
client-test Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
core track repair handle_requests time (#29940) 4 days ago
docs Update turbine documentation (#29906) 4 days ago
dos Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
download-utils Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
entry Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
explorer chore:(deps): bump react-countup from 6.3.2 to 6.4.0 in /explorer (#29926) 6 days ago
faucet doc: Fix documentation warnings and add some links (#29887) 6 days ago
frozen-abi adds new contact-info with forward compatible sockets (#29596) 5 days ago
genesis solana-genesis: fix bpf-program value_name (#29903) 6 days ago
genesis-utils Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
geyser-plugin-interface geyser: add parent slot/blockhash to block (#29855) 6 days ago
geyser-plugin-manager geyser: add parent slot/blockhash to block (#29855) 6 days ago
gossip Inlines variables into format strings (#29945) 5 days ago
install Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
keygen Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
ledger Refactor: remove unused variable (#29955) 4 days ago
ledger-tool ledger-tool: Remove duplicate open_genesis_config_by() call (#29950) 5 days ago
local-cluster Revert "Add run parent directory for accounts files (#29794)" (#29899) 6 days ago
log-analyzer Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
logger Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
measure Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
memory-management Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
merkle-root-bench Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
merkle-tree Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
metrics Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
multinode-demo Added option to turn on UDP for TPU transaction and make UDP based TPU off by default (#27462) 5 months ago
net Use halt-at-slot to specify getting bank-hash for slot 0 (#29873) 7 days ago
net-shaper Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
net-utils Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
notifier Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
perf Move Deduper into a separate file (#29891) 6 days ago
poh Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
poh-bench Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
program-runtime Fixed bug with mishmash of traces from different programs in single log (#29605) 4 days ago
program-test program-test: Add token-2022 to default programs (#29878) 6 days ago
programs Fixed bug with mishmash of traces from different programs in single log (#29605) 4 days ago
pubsub-client Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
quic-client Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
rayon-threadlimit Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
rbpf-cli Fixed bug with mishmash of traces from different programs in single log (#29605) 4 days ago
remote-wallet doc: Fix documentation warnings and add some links (#29887) 6 days ago
rpc Improves RPC path sanitation (#29931) 5 days ago
rpc-client Add Memcmp filter constructor and deprecate fields (#29923) 5 days ago
rpc-client-api Add Memcmp filter constructor and deprecate fields (#29923) 5 days ago
rpc-client-nonce-utils Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
rpc-test Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
runtime Refactor - Simplify program accounts in transaction loading (#29728) 4 days ago
scripts make `scripts/cargo-fmt.sh` $PWD agnostic (#29919) 6 days ago
sdk Inlines variables into format strings (#29945) 5 days ago
send-transaction-service Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
stake-accounts Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
storage-bigtable Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
storage-proto Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
streamer Remove the specific QUIC connection entry that disconnected (#29883) 6 days ago
sys-tuner Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
system-test chore: all gce performance tests use n2-standard-16 (#28509) 3 months ago
test-validator Revert "Add run parent directory for accounts files (#29794)" (#29899) 6 days ago
thin-client Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
tokens Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
tpu-client Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
transaction-dos Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
transaction-status Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
udp-client Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
upload-perf Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
validator chore: Cleanup repeat instances of solana_version!() (#29944) 5 days ago
version Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
watchtower Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
web3.js chore: bump @typescript-eslint/parser from 5.40.1 to 5.47.1 in /web3.js (#29453) 4 weeks ago
web3.js-experimental [web3.js][experimental] Set up test/dev infra (#28950) 2 months ago
zk-token-sdk ledger: Remove `clippy::wrong_self_convention` (#29916) 5 days ago
.clippy.toml
.gitignore Ingest duplicate proofs sent through Gossip (#29227) 2 weeks ago
.mergify.yml Fix mergify, vis-a-vis missing dont-squash-my-commits team (#29909) 6 days ago
.travis.yml closed explorer travis.yml after giving workflow permisssion in github action 1 year ago
CONTRIBUTING.md Update CONTRIBUTING.md for crate creation. (#29637) 6 days ago
Cargo.lock adds new contact-info with forward compatible sockets (#29596) 5 days ago
Cargo.toml Revert "chore: workspace inheritance (#29509)" (#29892) 7 days ago
LICENSE up year in license 1 year ago
README.md Update docs to use ./cargo (#28798) 3 months ago
RELEASE.md RELEASE.md cleanup (#28007) 4 months ago
SECURITY.md security-policy: correct bounty split example 2 weeks ago
cargo
cargo-build-bpf replace ./cargo with cargo in sbf/bpf build scripts (#29371) 1 month ago
cargo-build-sbf replace ./cargo with cargo in sbf/bpf build scripts (#29371) 1 month ago
cargo-test-bpf replace ./cargo with cargo in sbf/bpf build scripts (#29371) 1 month ago
cargo-test-sbf replace ./cargo with cargo in sbf/bpf build scripts (#29371) 1 month ago
codecov.yml chore: tell Codecov about the web3.js move, a few years later (#27633) 5 months ago
fetch-perf-libs.sh
fetch-spl.sh program-test: Add token-2022 to default programs (#29878) 6 days ago
run.sh
rust-toolchain.toml Upgrades to Rust 1.66.1 (#29827) 1 week ago
rustfmt.toml Add rustfmt.toml and `cargo fmt` (#23238) 12 months ago
test-abi.sh
vercel.json

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

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

  • 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 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 Foundation's ("SF") 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 SF or developer resources that SF provides are for educational and inspirational 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 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. 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.