Hey there!
In this article, we'll cover how to create a GitHub Action which will run our Anchor program tests!
Anchor Github Action
First create a action.yml file in your project root .github/workflows/action.yml which contains the following:
name: Solana Action name
on:
push:
branches: [main]
env:
SOLANA_VERSION: v1.9.9
ANCHOR_VERSION: 0.24.2
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Use Node.js
- uses: actions/setup-node@v3
with:
node-version: 16.14.2
cache: "npm"
- run: npm install
- run: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
shell: bash
- run: echo "/home/runner/.cargo/bin" >> $GITHUB_PATH
shell: bash
- run: curl -sSfL https://release.solana.com/$SOLANA_VERSION/install | sh
shell: bash
- run: echo "/home/runner/.local/share/solana/install/active_release/bin" >> $GITHUB_PATH
shell: bash
- run: npm i -g @project-serum/anchor-cli@$ANCHOR_VERSION ts-mocha typescript
- run: anchor test
First we use actions/setup-node@v3 for a Node.JS environment considering we will be running out tests with mocha.
After that we install Rust by running curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y.
Next the Solana CLI with curl -sSfL https://release.solana.com/$SOLANA_VERSION/install | sh.
And final dependency is Anchor CLI and ts-mocha.
To run the tests, we execute the anchor test.
Anchor.toml
It's important that we properly setup our Anchor.toml file to spawn a local Solana validator that will run tests. Let's take a look at a sample Anchor.toml file. Make sure that the address in your declare_id! macro and in Anchor.toml match.
[programs.localnet]
sample_program = "3ZALfG4NyQgxy2SWjSiQoUyBPEvXT2xo7rKc5hPYYJ7z"
[registry]
url = "https://anchor.projectserum.com"
[provider]
cluster = "localnet"
wallet = "/home/solana/my_wallet.json"
[scripts]
test = "npx run ts-mocha -p ./tsconfig.json -t 1000000 tests/**/*.ts"
Conclusion
In this article we've seen how to write a Github Action, that will run our Anchor test against a local/test Solana validator, as well as how the Anchor.toml file should be.
That's it! Hope you enjoyed it, happy coding!
Top comments (0)