Go to file
Slavomir 63f94a4db3 Fix response examples for `getTokenAccountsByOwner` and `getTokenAccountsByDelegate` 2021-10-23 09:24:48 -07:00
.buildkite Clear release cache for stable-perf (#17287) 2021-05-17 17:28:52 -06:00
.github Update explorer.yml 2021-10-23 18:14:32 +05:30
.travis chore(web3): use github actions (#19816) 2021-09-13 16:37:18 -05:00
account-decoder Clippy 2021-10-23 08:21:20 +00:00
accounts-bench hash calc uses all threads during startup (#20735) 2021-10-15 17:41:23 -05:00
accounts-cluster-bench Remove blockhash from fee calculation (#20641) 2021-10-13 13:10:58 -07:00
accountsdb-plugin-interface chore: bump thiserror from 1.0.29 to 1.0.30 (#20583) 2021-10-11 09:46:33 -06:00
accountsdb-plugin-manager Accountsdb plugin metrics (#20606) 2021-10-13 08:36:39 -07:00
accountsdb-plugin-postgres Update to Rust v1.56 2021-10-23 08:21:20 +00:00
banking-bench - make cost_tracker a member of bank, remove shared instance from TPU; (#20627) 2021-10-19 14:37:33 -05:00
banks-client Improve program-test process_transaction() speed by reducing sleep duration in banks-server (#20508) 2021-10-15 18:55:41 +02:00
banks-interface Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
banks-server Divorce the runtime from FeeCalculator (#20737) 2021-10-22 14:32:40 -07:00
bench-streamer Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
bench-tps Remove blockhash from fee calculation (#20641) 2021-10-13 13:10:58 -07:00
book/src/proposals Proposal to handle duplicate blocks (#16127) 2021-07-08 04:36:11 +00:00
bucket_map AcctIdx: stats for buckets on disk, add median (#20528) 2021-10-08 13:58:38 -05:00
ci Update to Rust v1.56 2021-10-23 08:21:20 +00:00
clap-utils Clippy 2021-10-23 08:21:20 +00:00
cli cli: improve feature status arithmatic readability 2021-10-22 23:45:33 -06:00
cli-config Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
cli-output Clippy 2021-10-23 08:21:20 +00:00
client chore: bump reqwest from 0.11.5 to 0.11.6 (#20844) 2021-10-21 12:54:18 -06:00
core Clippy 2021-10-23 08:21:20 +00:00
crate-features solana-sdk now builds for wasm32-unknown-unknown 2021-10-13 13:15:33 -07:00
docs Fix response examples for `getTokenAccountsByOwner` and `getTokenAccountsByDelegate` 2021-10-23 09:24:48 -07:00
dos Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
download-utils chore: bump reqwest from 0.11.5 to 0.11.6 (#20844) 2021-10-21 12:54:18 -06:00
entry Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
explorer explorer: Speed up cluster stats loading (#20916) 2021-10-23 15:51:10 +00:00
faucet Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
frozen-abi Clippy 2021-10-23 08:21:20 +00:00
genesis Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
genesis-utils Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
gossip Make pub IncrementalSnapshotHashes fields (#20727) 2021-10-18 13:38:43 -05:00
install chore: bump reqwest from 0.11.5 to 0.11.6 (#20844) 2021-10-21 12:54:18 -06:00
keygen Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
ledger Clippy 2021-10-23 08:21:20 +00:00
ledger-tool Clippy 2021-10-23 08:21:20 +00:00
local-cluster rpc-send-tx-svc: add with_config constructor 2021-10-20 13:43:27 -06:00
log-analyzer Clippy 2021-10-23 08:21:20 +00:00
logger Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
measure Fix doc tests and examples for Measure::this() (#20833) 2021-10-21 10:07:02 -05:00
merkle-root-bench Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
merkle-tree Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
metrics chore: bump reqwest from 0.11.5 to 0.11.6 (#20844) 2021-10-21 12:54:18 -06:00
multinode-demo s/authorized_withdrawer_pubkey/authorized_withdrawer/ 2021-09-03 16:45:06 -07:00
net Enable easy full-rpc services on testnet nodes (#20529) 2021-10-07 19:08:29 -06:00
net-shaper Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
net-utils Bump nix and ctrlc crate to resolve audit failures (#20558) 2021-10-08 17:18:33 -06:00
notifier chore: bump reqwest from 0.11.5 to 0.11.6 (#20844) 2021-10-21 12:54:18 -06:00
perf Reduce visibility of `Hash` struct contents 2021-10-19 09:30:47 -07:00
poh Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
poh-bench Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
program-runtime Refactor: Cleanup InvokeContext (#20785) 2021-10-21 20:57:42 +02:00
program-test Divorce the runtime from FeeCalculator (#20737) 2021-10-22 14:32:40 -07:00
programs Clippy 2021-10-23 08:21:20 +00:00
rayon-threadlimit Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
rbpf-cli Refactor: Remove program_id from process_instruction() (#20540) 2021-10-10 22:29:18 +02:00
remote-wallet chore: bump console from 0.14.1 to 0.15.0 (#20817) 2021-10-20 21:43:46 +00:00
replica-lib Reduce visibility of `Hash` struct contents 2021-10-19 09:30:47 -07:00
replica-node rpc-send-tx-svc: add with_config constructor 2021-10-20 13:43:27 -06:00
rpc Clippy 2021-10-23 08:21:20 +00:00
runtime Divorce the runtime from FeeCalculator (#20737) 2021-10-22 14:32:40 -07:00
scripts updating with OS_TYPE 2021-10-22 17:46:06 +05:30
sdk Divorce the runtime from FeeCalculator (#20737) 2021-10-22 14:32:40 -07:00
send-transaction-service Divorce the runtime from FeeCalculator (#20737) 2021-10-22 14:32:40 -07:00
stake-accounts Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
storage-bigtable chore: bump libc from 0.2.103 to 0.2.104 (#20764) 2021-10-19 22:38:02 -06:00
storage-proto Include token owners in TransactionTokenBalances (#20642) 2021-10-13 21:46:52 -06:00
streamer chore: bump libc from 0.2.103 to 0.2.104 (#20764) 2021-10-19 22:38:02 -06:00
sys-tuner chore: bump libc from 0.2.103 to 0.2.104 (#20764) 2021-10-19 22:38:02 -06:00
system-test Remove encode in JSON parser (#20489) 2021-10-06 16:59:08 -07:00
tokens Clippy 2021-10-23 08:21:20 +00:00
transaction-status Reduce visibility of `Hash` struct contents 2021-10-19 09:30:47 -07:00
upload-perf Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
validator Clippy 2021-10-23 08:21:20 +00:00
version Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
watchtower Bump version to 1.9.0 2021-10-06 17:57:41 -07:00
web3.js feat: add config option to exclude accounts from supply response (#20887) 2021-10-22 16:12:49 -04:00
.clippy.toml
.codecov.yml
.gitignore Generate a script to rerun the failed sub-command in cargo-test-bpf (#18582) 2021-07-15 01:02:42 +00:00
.mergify.yml CI: fix mergify check for web3 ci status (#20209) 2021-09-25 10:49:32 -04:00
.travis.yml Use node LTS (#20803) 2021-10-19 15:30:35 -06:00
CONTRIBUTING.md
Cargo.lock cli: add software version(s) to feature status 2021-10-22 23:45:33 -06:00
Cargo.toml Remove support for dynamically loaded native programs (#20444) 2021-10-06 14:53:23 -07:00
LICENSE
README.md Update README.md - fix typo and one grammar fix 2021-10-02 09:31:02 -07:00
RELEASE.md
SECURITY.md Update security bounty levels (#20471) 2021-10-06 13:57:52 -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 feature: add new token program feature (#18780) 2021-07-21 14:34:25 +02:00
run.sh add some guidance in place of `./run.sh` 2021-09-11 14:49:17 -06:00
test-abi.sh
vercel.json removing the "autoJobCancelation": false 2021-10-07 20:49:58 +05:30

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

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") 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 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.