Go to file
dependabot[bot] a30e9f5338
build(deps): bump @solana/web3.js in /token-lending/js (#1559)
Bumps [@solana/web3.js](https://github.com/solana-labs/solana-web3.js) from 1.2.4 to 1.2.5.
- [Release notes](https://github.com/solana-labs/solana-web3.js/releases)
- [Changelog](https://github.com/solana-labs/solana-web3.js/blob/master/.releaserc.json)
- [Commits](https://github.com/solana-labs/solana-web3.js/compare/v1.2.4...v1.2.5)

Signed-off-by: dependabot[bot] <support@github.com>

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2021-04-01 09:45:05 +00:00
.github lending: Update JS tests to solana-test-validator (#1513) 2021-03-27 13:42:16 +01:00
.travis Switch to Github Actions for CI (#768) 2020-11-01 18:42:51 +08:00
associated-token-account/program Update to Solana 1.6.2 2021-03-30 09:38:04 -07:00
binary-oracle-pair Update to Solana 1.6.2 2021-03-30 09:38:04 -07:00
ci lending: Update JS tests to solana-test-validator (#1513) 2021-03-27 13:42:16 +01:00
docs stake-pool: Rename instructions / structs (#1536) 2021-03-30 23:54:06 +02:00
examples Update to Solana 1.6.2 2021-03-30 09:38:04 -07:00
feature-proposal Update to Solana 1.6.2 2021-03-30 09:38:04 -07:00
libraries/math Update to Solana 1.6.2 2021-03-30 09:38:04 -07:00
memo spl-memo: Add back v1 program ID as `spl_memo::v1::id()` 2021-04-01 07:46:09 +00:00
record/program Update to Solana 1.6.2 2021-03-30 09:38:04 -07:00
shared-memory Update to Solana 1.6.2 2021-03-30 09:38:04 -07:00
stake-pool More variable renaming 2021-04-01 07:40:18 +00:00
themis Update to Solana 1.6.2 2021-03-30 09:38:04 -07:00
token spl-token-cli: Use CLI config wallet for nonce authority fallback 2021-04-01 01:41:24 -06:00
token-lending build(deps): bump @solana/web3.js in /token-lending/js (#1559) 2021-04-01 09:45:05 +00:00
token-swap Update to Solana 1.6.2 2021-03-30 09:38:04 -07:00
utils Update to Solana 1.6.2 2021-03-30 09:38:04 -07:00
.gitignore lending: Add overflow check in proptest (#1199) 2021-02-08 14:35:55 +01:00
.mergify.yml Add more checks to mergify due to GitHub Actions migration (#777) 2020-11-02 19:17:00 +01:00
.travis.yml Simplify github action with scripts (#769) 2020-11-04 10:50:07 +08:00
Cargo.lock Bump spl-token-cli to 2.0.10 (#1540) 2021-03-30 17:22:17 -06:00
Cargo.toml Binary oracle implementation (#1347) 2021-03-18 18:18:20 +01:00
LICENSE Update contributors (#42) 2020-06-17 14:12:46 -07:00
README.md bumped version of cli-tools 2021-03-26 11:12:47 -07:00
cbindgen.sh Move c header generation out of build.rs 2020-08-27 23:32:07 -07:00
coverage.sh Fix coverage on macOS 2020-12-14 12:07:16 -08:00
patch.crates-io.sh Add more solana crates to patch scripts 2021-03-26 20:17:44 -07:00
update-solana-dependencies.sh Add solana-vote-program to update script 2021-03-29 14:46:27 +08:00

README.md

Build status

Solana Program Library

The Solana Program Library (SPL) is a collection of on-chain programs targeting the Sealevel parallel runtime. These programs are tested against Solana's implementation of Sealevel, solana-runtime, and deployed to its mainnet. As others implement Sealevel, we will graciously accept patches to ensure the programs here are portable across all implementations.

Full documentation is available at https://spl.solana.com

Development

Environment Setup

  1. Install the latest Rust stable from https://rustup.rs/
  2. Install Solana v1.6.1 or later from https://docs.solana.com/cli/install-solana-cli-tools
  3. Install the libudev development package for your distribution (libudev-dev on Debian-derived distros, libudev-devel on Redhat-derived).

Build

The normal cargo build is available for building programs against your host machine:

$ cargo build

To build a specific program, such as SPL Token, for the Solana BPF target:

$ cd token/program
$ cargo build-bpf

Test

Unit tests contained within all projects can be run with:

$ cargo test      # <-- runs host-based tests
$ cargo test-bpf  # <-- runs BPF program tests

To run a specific program's tests, such as SPL Token:

$ cd token/program
$ cargo test      # <-- runs host-based tests
$ cargo test-bpf  # <-- runs BPF program tests

Integration testing may be performed via the per-project .js bindings. See the token program's js project for an example.

Clippy

$ cargo clippy

Coverage

$ ./coverage.sh  # Please help! Coverage build currently fails on MacOS due to an XCode `grcov` mismatch...

Release Process

SPL programs are currently tagged and released manually. Each program is versioned independently of the others, with all new development occurring on master. Once a program is tested and deemed ready for release:

Bump Version

  • Increment the version number in the program's Cargo.toml
  • Generate a new program ID and replace in <program>/program-id.md and <program>/src/lib.rs
  • Run cargo build-bpf <program> to update relevant C bindings. (Note the location of the generated spl_<program>.so for attaching to the Github release.)
  • Open a PR with these version changes and merge after passing CI.

Create Github tag

Program tags are of the form <program>-vX.Y.Z. Create the new tag at the version-bump commit and push to the solana-program-library repository, eg:

$ git tag token-v1.0.0 b24bfe7
$ git push upstream --tags

Publish Github release

  • Go to GitHub Releases UI
  • Click "Draft new release", and enter the new tag in the "Tag version" box.
  • Title the release "SPL vX.Y.Z", complete the description, and attach the spl_<program>.so binary
  • Click "Publish release"

Publish to Crates.io

Navigate to the program directory and run cargo package to test the build. Then run cargo publish.