Setup Arcium

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

Usage

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.

Custom Versions

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

Running Tests on 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.

Updating to New Arcium Versions

Automated Detection

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.

Manual Update

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"

Version Validation

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)

License

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