Create a Github Action to run Solana Anchor tests

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 nameon:  push:    branches: [main]env:  SOLANA_VERSION: v1.9.9  ANCHOR_VERSION: 0.24.2jobs:  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!