A GitHub Action for installing and setting up the Arcium CLI and tooling.

Here's an example workflow:

name: example-workflow
on: [push]
jobs:
  run-arcium-build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: arcium-hq/setup-arcium@v0.6.3
        with:
          runner-arch-os: x86_64_linux
      - run: arcium build
        shell: bash

This will use the default versions:

• Arcium: 0.6.3
• Anchor: 0.32.1
• Node.js: 20.18.0
• Solana CLI: 2.3.0

The runner-arch-os parameter is required. Options: x86_64_linux, aarch64_macos.

steps:
  - uses: actions/checkout@v4
  - uses: arcium-hq/setup-arcium@v0.6.3
    with:
      arcium-version: "0.6.3"
      anchor-version: "0.32.1"
      solana-cli-version: "2.3.0"
      node-version: "20.18.0"
      runner-arch-os: x86_64_linux

When running arcium test on Linux CI, you must increase the file descriptor limit in the same shell to prevent Too many open files errors from solana-test-validator:

- name: Test
  run: |
    sudo prlimit --pid $$ --nofile=1048576:1048576
    arcium test
  shell: bash

Note: This is required because each GitHub Actions step runs in a separate shell. A future arcium CLI version will handle this automatically.

This repo includes a weekly workflow that checks crates.io for new Arcium releases and automatically creates a PR when a new version is detected.

To manually update to a new Arcium version:

# Update all version references and regenerate lock files
./scripts/sync-version.sh 0.6.3

# Create release branch
git checkout -b v0.6.3
git add -A
git commit -m "chore: bump arcium to v0.6.3"
git push -u origin v0.6.3

# Create PR - after merge, auto-release creates GitHub release
gh pr create --title "Release v0.6.3" --body "Update Arcium to v0.6.3"

CI validates that all version references are consistent across:

• action.yaml (arcium-version default)
• test_project/package.json (@arcium-hq/client)
• test_project/*/Cargo.toml (arcium-* crates)

The scripts and documentation in this project are released under the MIT License.