ci: use solana-zig bootstrap toolchain

Author: DaviRain-Su

.github/workflows/ci.yml

@@ -7,7 +7,7 @@ on:
     branches: [dev, main]
 
 env:
-  ZIG_VERSION: 0.15.2
+  SOLANA_ZIG_VERSION: v1.52.0
 
 jobs:
   format:
@@ -16,21 +16,17 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Install Zig ${{ env.ZIG_VERSION }}
-        id: setup-zig
-        uses: mlugg/setup-zig@v1
+      - name: Cache solana-zig
+        uses: actions/cache@v4
         with:
-          version: ${{ env.ZIG_VERSION }}
-        continue-on-error: true
+          path: solana-zig
+          key: solana-zig-${{ env.SOLANA_ZIG_VERSION }}-${{ runner.os }}
 
-      - name: Install Zig (master fallback)
-        if: ${{ steps.setup-zig.outcome == 'failure' }}
-        uses: mlugg/setup-zig@v1
-        with:
-          version: master
+      - name: Install solana-zig
+        run: bash ./install-solana-zig.sh solana-zig
 
       - name: Check formatting
-        run: zig fmt --check build.zig src
+        run: ./solana-zig/zig fmt --check build.zig src
 
   sdk-test:
     name: SDK Tests
@@ -43,18 +39,14 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Install Zig ${{ env.ZIG_VERSION }}
-        id: setup-zig
-        uses: mlugg/setup-zig@v1
+      - name: Cache solana-zig
+        uses: actions/cache@v4
         with:
-          version: ${{ env.ZIG_VERSION }}
-        continue-on-error: true
+          path: solana-zig
+          key: solana-zig-${{ env.SOLANA_ZIG_VERSION }}-${{ runner.os }}
 
-      - name: Install Zig (master fallback)
-        if: ${{ steps.setup-zig.outcome == 'failure' }}
-        uses: mlugg/setup-zig@v1
-        with:
-          version: master
+      - name: Install solana-zig
+        run: bash ./install-solana-zig.sh solana-zig
 
       - name: Run tests
-        run: zig build test --summary all
+        run: ./solana-zig/zig build test --summary all

.gitignore

@@ -1,2 +1,3 @@
 .zig-cache
 zig-out
+solana-zig

README.md

@@ -11,7 +11,7 @@ A pure Zig port of the Solana SDK core types and common SPL program interfaces.
 - **Pure Zig**: no Solana runtime syscalls; works anywhere Zig runs
 
 ## Requirements
-- Zig **0.15.2** or newer (matches `build.zig.zon`)
+- Zig **0.15.2** or newer (matches `build.zig.zon`). CI pins the [solana-zig bootstrap](https://github.com/joncinque/solana-zig-bootstrap) release `v1.52.0` (bundled Zig 0.15.2); you can fetch the same toolchain locally via `./install-solana-zig.sh`.
 
 ## Getting started
 1. Add the package to your project (for example with `zig fetch --save <git-url>` or a local `.path` entry in `build.zig.zon`).

install-solana-zig.sh

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+
+if [[ -n $SOLANA_ZIG_VERSION ]]; then
+  solana_zig_version="$SOLANA_ZIG_VERSION"
+else
+  solana_zig_version="v1.52.0"
+fi
+solana_zig_release_url="https://github.com/joncinque/solana-zig-bootstrap/releases/download/solana-$solana_zig_version"
+
+output_dir="$1"
+if [[ -z $output_dir ]]; then
+  output_dir="solana-zig"
+fi
+output_dir="$(mkdir -p "$output_dir"; cd "$output_dir"; pwd)"
+cd $output_dir
+
+arch=$(uname -m)
+if [[ "$arch" == "arm64" ]]; then
+  arch="aarch64"
+fi
+case $(uname -s | cut -c1-7) in
+"Linux")
+  os="linux"
+  abi="musl"
+  ;;
+"Darwin")
+  os="macos"
+  abi="none"
+  ;;
+"Windows" | "MINGW64")
+  os="windows"
+  abi="gnu"
+  ;;
+*)
+  echo "install-solana-zig.sh: Unknown OS $(uname -s)" >&2
+  exit 1
+  ;;
+ esac
+
+solana_zig_tar=zig-$arch-$os-$abi.tar.bz2
+url="$solana_zig_release_url/$solana_zig_tar"
+echo "Downloading $url"
+curl --proto '=https' --tlsv1.2 -SfOL "$url"
+echo "Unpacking $solana_zig_tar"
+tar -xjf $solana_zig_tar
+rm $solana_zig_tar
+
+solana_zig_dir="zig-$arch-$os-$abi-baseline"
+mv "$solana_zig_dir"/* .
+rmdir $solana_zig_dir
+echo "solana-zig compiler available at $output_dir"