setup github matrix feature

Author: x3c41a

.github/workflows/integration-test.yml

@@ -20,10 +20,28 @@ env:
   NODE_VERSION: 22
 
 jobs:
+  # This generates a matrix with all the required runtimes which will be run in the next step
+  runtime-matrix:
+    runs-on: ubuntu-latest
+    outputs:
+      runtime: ${{ steps.runtime.outputs.runtime }}
+    name: Extract runtimes from matrix
+    steps:
+      - uses: actions/checkout@v4
+      - id: runtime
+        run: |
+          TASKS=$(echo $(cat scripts/runtimes-matrix.json) | sed 's/ //g' )
+          echo $TASKS
+          echo "runtime=$TASKS" >> $GITHUB_OUTPUT
+
   integration-tests:
-    name: Integration Tests
+    needs: [runtime-matrix]
+    name: Integration Tests - ${{ matrix.runtime.name }}
     runs-on: ubuntu-latest
     timeout-minutes: 60
+    strategy:
+      matrix:
+        runtime: ${{ fromJSON(needs.runtime-matrix.outputs.runtime) }}
 
     steps:
       - name: Checkout sources
@@ -67,8 +85,8 @@ jobs:
 
       - name: Run authorize and store (PAPI, smoldot)
         working-directory: examples
-        run: just run-authorize-and-store "smoldot"
+        run: just run-authorize-and-store "smoldot" "${{ matrix.runtime.package }}"
 
       - name: Run authorize and store (PAPI, RPC node)
         working-directory: examples
-        run: just run-authorize-and-store "ws"
+        run: just run-authorize-and-store "ws" "${{ matrix.runtime.package }}"

examples/justfile

@@ -6,11 +6,13 @@
 PID_DIR := "/tmp/bulletin-pids"
 
 # Default recipe - run the complete PAPI workflow test
-default: run-authorize-and-store
+default: (run-authorize-and-store "smoldot" "bulletin-polkadot")
 
 # Build the bulletin chain node in release mode
-build:
-    cargo build --release -p polkadot-bulletin-chain
+# Parameters:
+#   runtime - Runtime name (e.g., "bulletin-polkadot"), taken from ../scripts/runtimes-matrix.json
+build runtime="bulletin-polkadot":
+    cargo build --release -p {{ runtime }}
 
 # Install JavaScript dependencies
 npm-install:
@@ -28,14 +30,35 @@ _ipfs-cmd:
         exit 1
     fi
 
+# Helper function to map runtime package name to zombienet config filename (internal use)
+_zombienet-config-name runtime:
+    #!/usr/bin/env bash
+    case "{{ runtime }}" in
+        "bulletin-polkadot-runtime")
+            echo "bulletin-polkadot-local.toml"
+            ;;
+        "bulletin-westend-runtime")
+            echo "bulletin-westend-local.toml"
+            ;;
+        "polkadot-bulletin-chain-runtime")
+            echo "bulletin-polkadot.toml"
+            ;;
+        *)
+            echo "❌ Error: Unknown runtime '{{ runtime }}'" >&2
+            exit 1
+            ;;
+    esac
+
 # Start start solo chain with zombienet in background
-bulletin-solo-zombienet-start:
+# Parameters:
+#   runtime - Runtime name (e.g., "bulletin-polkadot"), taken from ../scripts/runtimes-matrix.json
+bulletin-solo-zombienet-start runtime="bulletin-polkadot":
     #!/usr/bin/env bash
     set -e
 
     mkdir -p {{ PID_DIR }}
 
-    echo "⚡ Starting Bulletin chain with zombienet..."
+    echo "⚡ Starting Bulletin chain with zombienet (runtime: {{ runtime }})..."
 
     # Find zombienet binary (use env var if set, otherwise search)
     if [ -n "$ZOMBIENET_BINARY" ]; then
@@ -54,8 +77,11 @@ bulletin-solo-zombienet-start:
     echo "   Using zombienet: $ZOMBIENET_BIN"
 
     # Get absolute paths for bulletin binary and config
-    BULLETIN_BINARY=$(cd .. && pwd)/target/release/polkadot-bulletin-chain
-    ZOMBIENET_CONFIG=$(cd .. && pwd)/zombienet/bulletin-polkadot-local.toml
+    BULLETIN_BINARY=$(cd .. && pwd)/target/release/{{ runtime }}
+    ZOMBIENET_TOML=$(just _zombienet-config-name {{ runtime }})
+    ZOMBIENET_CONFIG=$(cd .. && pwd)/zombienet/$ZOMBIENET_TOML
+    
+    echo "   Using config: $ZOMBIENET_CONFIG"
 
     POLKADOT_BULLETIN_BINARY_PATH=$BULLETIN_BINARY $ZOMBIENET_BIN -p native spawn $ZOMBIENET_CONFIG > /tmp/zombienet.log 2>&1 &
     ZOMBIENET_PID=$!
@@ -167,18 +193,20 @@ papi-generate:
     npm run papi:generate
 
 # Setup all services using Docker for IPFS
-setup-services:
+# Parameters:
+#   runtime - Runtime to build and run (e.g., "bulletin-polkadot-runtime", "bulletin-westend-runtime", "polkadot-bulletin-chain-runtime")
+setup-services runtime="bulletin-polkadot":
     #!/usr/bin/env bash
     set -e
 
     echo "🔧 Tearing down Docker services if they are running..."
     just ipfs-shutdown
 
-    echo "🐳 Setting up services with Docker IPFS..."
+    echo "🐳 Setting up services with Docker IPFS (runtime: {{ runtime }})..."
 
     # Start services with Docker
     just ipfs-start
-    just bulletin-solo-zombienet-start
+    just bulletin-solo-zombienet-start "{{ runtime }}"
 
     # Wait a bit longer and verify zombienet is running
     echo "🔍 Verifying zombienet is ready..."
@@ -229,23 +257,24 @@ teardown-services:
 # Run authorize and store example with Docker IPFS
 # Parameters:
 #   mode - Connection mode: "ws" (WebSocket RPC node) or "smoldot" (light client)
-run-authorize-and-store mode="ws": build npm-install
+#   runtime - Runtime name (e.g., "bulletin-polkadot", "bulletin-westend", "bulletin-rococo")
+run-authorize-and-store mode="ws" runtime="bulletin-polkadot": (build runtime) npm-install
     #!/usr/bin/env bash
     set -e
 
     if [ "{{ mode }}" = "smoldot" ]; then
-        echo "🚀 Starting authorize and store workflow test (mode: smoldot)..."
+        echo "🚀 Starting authorize and store workflow test (mode: smoldot, runtime: {{ runtime }})..."
         SCRIPT_NAME="authorize_and_store_papi_smoldot.js"
     elif [ "{{ mode }}" = "ws" ]; then
-        echo "🚀 Starting authorize and store workflow test (mode: ws)..."
+        echo "🚀 Starting authorize and store workflow test (mode: ws, runtime: {{ runtime }})..."
         SCRIPT_NAME="authorize_and_store_papi.js"
     else
         echo "❌ Error: Invalid mode '{{ mode }}'. Must be 'ws' or 'smoldot'"
         exit 1
     fi
     echo ""
 
-    just setup-services
+    just setup-services "{{ runtime }}"
     node $SCRIPT_NAME
     EXAMPLE_EXIT=$?