blockworks-foundation
/
solana-program-library
mirror of https://github.com/blockworks-foundation/solana-program-library.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
215 Commits 16 Branches 106 Tags 38 MiB
Rust 88.5%
JavaScript 8.5%
C++ 1.1%
Shell 0.8%
TypeScript 0.6%
Other 0.5%
Go to file
dependabot[bot] 5bf7742620
Bump solana-cli-config from 1.3.1 to 1.3.2 (#263) 
Bumps [solana-cli-config](https://github.com/solana-labs/solana) from 1.3.1 to 1.3.2.
- [Release notes](https://github.com/solana-labs/solana/releases)
- [Changelog](https://github.com/solana-labs/solana/blob/master/RELEASE.md)
- [Commits](https://github.com/solana-labs/solana/compare/v1.3.1...v1.3.2)

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

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
 		2020-08-12 08:44:29 +00:00
.github Simplify dependabot config 2020-08-08 08:05:00 -07:00
.travis Add libudev-dev 2020-08-04 16:10:05 -07:00
ci cbindgen does not produce deterministic header files (#261) 2020-08-11 16:09:36 -07:00
docs Add spl-token documentation 2020-08-10 12:49:28 -07:00
memo Move program READMEs back 2020-08-08 23:04:16 +00:00
token Bump solana-cli-config from 1.3.1 to 1.3.2 (#263) 2020-08-12 08:44:29 +00:00
token-swap Bump @solana/web3.js from 0.64.0 to 0.66.3 in /token-swap/js (#256) 2020-08-10 08:42:43 +00:00
.gitignore Programs can be client dependencies (#181) 2020-07-31 16:35:49 -07:00
.mergify.yml Bring in monorepo mergify rules 2020-08-03 17:22:43 -07:00
.travis.yml Add travis script log folding 2020-08-08 15:25:47 -07:00
Cargo.lock Bump solana-cli-config from 1.3.1 to 1.3.2 (#263) 2020-08-12 08:44:29 +00:00
Cargo.toml Reorganize crates based on program 2020-08-08 15:25:47 -07:00
LICENSE Update contributors (#42) 2020-06-17 14:12:46 -07:00
README.md Add release process docs (#163) 2020-07-29 17:26:04 +00:00
bpf-sdk-install.sh Move up to v1.3.1 2020-08-08 08:05:00 -07:00
do.sh Adapt do.sh to new layout 2020-08-08 15:25:47 -07:00
package-lock.json Add rustdocs (#39) 2020-06-17 11:25:19 -07: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

Building

These programs cannot be built directly via cargo and instead require the build scripts located in Solana's BPF-SDK.

Download or update the BPF-SDK by running:

$ ./do.sh update

To build all programs, run:

$ ./do.sh build all

Or choose a specific program:

$ ./do.sh build <program>

Testing

Unit tests contained within all projects can be built via:

$ ./do.sh test all

Or:

$ ./do.sh test <program>

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

Clippy

Clippy is also supported via:

$ ./do.sh clippy all

Or:

$ ./do.sh clippy <program>

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 ./do.sh build <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. (Currently, programs with generated C bindings fail the final step of verification due to the location of the generated file. Once you are certain the crate is ready, run cargo publish --no-verify to bypass this error.)