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
380 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] f229456e15
Bump solana-cli-config from 1.3.9 to 1.3.11 (#451) 
Bumps [solana-cli-config](https://github.com/solana-labs/solana) from 1.3.9 to 1.3.11.
- [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.9...v1.3.11)

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

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
 		2020-09-16 08:41:57 +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 Re-enable token-swap ci (#442) 2020-09-14 16:56:00 +02:00
docs Javascript -> JavaScript (#409) 2020-09-09 17:57:30 -06:00
memo Bump dependencies from 1.3.8 to 1.3.9 (#415) 2020-09-10 17:25:43 +08:00
token Bump solana-cli-config from 1.3.9 to 1.3.11 (#451) 2020-09-16 08:41:57 +00:00
token-swap Bump prettier from 2.1.1 to 2.1.2 in /token-swap/js (#449) 2020-09-16 08:39:56 +00:00
utils Add token/program2 for next changeset (#412) 2020-09-10 16:04:50 -06: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 Only build master branch 2020-08-14 14:58:25 -07:00
Cargo.lock Bump solana-cli-config from 1.3.9 to 1.3.11 (#451) 2020-09-16 08:41:57 +00:00
Cargo.toml Add token/program2 for next changeset (#412) 2020-09-10 16:04:50 -06: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 Bump dependencies from 1.3.8 to 1.3.9 (#415) 2020-09-10 17:25:43 +08:00
cbindgen.sh Move c header generation out of build.rs 2020-08-27 23:32:07 -07:00
coverage.sh Relocate program2 into program 2020-08-26 23:10:18 -07:00
do.sh Fix an issue in do.sh where the 'all' argument didn't work, e.g. for do.sh build all (#299) 2020-08-21 16:15:45 +00: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.)