Compatibility tests

.github/actions/dispatch-compatibility-tests/action.yml

@@ -0,0 +1,40 @@
+name: 'Dispatch compatibility tests'
+description: 'Dispatch compatibility tests workflow to a target repository'
+
+inputs:
+  repo:
+    description: 'Target repository (e.g., software-mansion/starknet.py)'
+    required: true
+  ref:
+    description: 'Git reference (branch, tag, or commit SHA) to use'
+    required: true
+  rpc-version:
+    description: 'RPC version path segment (e.g., v0_10)'
+    required: true
+  workflow-file:
+    description: 'Workflow file name to dispatch'
+    required: false
+    default: 'compatibility-tests.yml'
+  gh-token:
+    description: 'GitHub token for API authentication. It should be private access token wit permission to trigger workflows in SDK repositories.'
+    required: true
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Dispatch workflow
+      shell: bash
+      env:
+        REPO: ${{ inputs.repo }}
+        REF: ${{ inputs.ref }}
+        RPC_VERSION: ${{ inputs.rpc-version }}
+        WORKFLOW_FILE: ${{ inputs.workflow-file }}
+        GH_TOKEN: ${{ inputs.gh-token }}
+      run: |
+        gh workflow run "${WORKFLOW_FILE}" \
+          --repo "${REPO}" \
+          --ref "${REF}" \
+          -f rpc-version="${RPC_VERSION}"
+
+        echo "Dispatched ${REPO}@${REF} workflow ${WORKFLOW_FILE} with rpc-version=${RPC_VERSION}"
+

.github/workflows/compatibility-tests-dispatcher.yml

@@ -0,0 +1,70 @@
+name: Run compatibility tests with multiple RPC versions
+
+on:
+  workflow_dispatch:
+
+jobs:
+  dispatch:
+    name: Dispatch (RPC ${{ matrix.rpc-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - rpc-version: "v0_8"
+            # TODO(#1708): Run once compatibility tests are available
+            # py_ref: "0.26.0"
+            # jvm_ref: "x.y.z"
+            # swift_ref: "x.y.z"
+            # rust_ref: "x.y.z"
+          - rpc-version: "v0_9"
+            # TODO(#1708): Run once compatibility tests are available
+            # py_ref: "0.28.1"
+            # jvm_ref: "x.y.z"
+            # swift_ref: "x.y.z"
+            # rust_ref: "x.y.z"
+          - rpc-version: "v0_10"
+            py_ref: "compatibility-tests"
+            # TODO(#1708): Run once compatibility tests are available
+            # jvm_ref: "x.y.z"
+            # swift_ref: "x.y.z"
+            # rust_ref: "x.y.z"
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Dispatch starknet.py workflow
+        if: matrix.py_ref
+        uses: ./.github/actions/dispatch-compatibility-tests
+        with:
+          repo: software-mansion/starknet.py
+          ref: ${{ matrix.py_ref }}
+          rpc-version: ${{ matrix.rpc-version }}
+          gh-token: ${{ secrets.CI_DISPATCH_TOKEN }}
+
+      - name: Dispatch starknet-jvm workflow
+        if: matrix.jvm_ref
+        uses: ./.github/actions/dispatch-compatibility-tests
+        with:
+          repo: software-mansion/starknet-jvm
+          ref: ${{ matrix.jvm_ref }}
+          rpc-version: ${{ matrix.rpc-version }}
+          gh-token: ${{ secrets.CI_DISPATCH_TOKEN }}
+
+      - name: Dispatch starknet.swift workflow
+        if: matrix.swift_ref
+        uses: ./.github/actions/dispatch-compatibility-tests
+        with:
+          repo: software-mansion/starknet.swift
+          ref: ${{ matrix.swift_ref }}
+          rpc-version: ${{ matrix.rpc-version }}
+          gh-token: ${{ secrets.CI_DISPATCH_TOKEN }}
+
+      - name: Dispatch starknet-rust workflow
+        if: matrix.rust_ref
+        uses: ./.github/actions/dispatch-compatibility-tests
+        with:
+          repo: software-mansion/starknet-rust
+          ref: ${{ matrix.rust_ref }}
+          rpc-version: ${{ matrix.rpc-version }}
+          gh-token: ${{ secrets.CI_DISPATCH_TOKEN }}

.github/workflows/compatibility-tests.yml

@@ -0,0 +1,101 @@
+name: Compatibility tests
+
+on:
+  pull_request:
+  workflow_dispatch:
+    inputs:
+      rpc-version:
+        description: "RPC version path segment, e.g. v0_10"
+        required: true
+        type: string
+
+concurrency:
+  group: compatibility-tests
+  cancel-in-progress: true
+
+
+jobs:
+    setup-tests:
+        name: Setup Tests
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v6
+            - uses: asdf-vm/actions/setup@4f8f7939dd917fc656bb7c3575969a5988c28364 # v3.0.0
+
+            - name: Install poetry
+              run: |
+                  python -m pip install --upgrade pip
+                  pip install poetry
+
+            - name: Set up Python 3.14
+              uses: actions/setup-python@v5
+              with:
+                  python-version: "3.14"
+                  cache: 'poetry'
+
+            - name: Install dependencies
+              run: |
+                  poetry install
+
+            - name: Compile contracts_v2 (without cache, so we use salted contracts)
+              uses: ./.github/actions/compile-contracts
+              with:
+                package: contracts_v2
+                cache: false
+
+            - name: Upload contracts artifacts
+              uses: actions/upload-artifact@v7
+              with:
+                  name: contract-artifacts
+                  path: starknet_py/tests/e2e/mock/
+
+    run-network-tests:
+        name: Network tests (testnet) with RPC version ${{ inputs.rpc-version }}
+        needs: setup-tests
+        runs-on: ubuntu-latest
+        strategy:
+            fail-fast: false
+        env:
+            SEPOLIA_RPC_URL: ${{ secrets.SEPOLIA_RPC_URL }}
+            SEPOLIA_ACCOUNT_ADDRESS: ${{ secrets.SEPOLIA_ACCOUNT_ADDRESS }}
+            SEPOLIA_ACCOUNT_PRIVATE_KEY: ${{ secrets.SEPOLIA_ACCOUNT_PRIVATE_KEY }}
+        steps:
+            - uses: actions/checkout@v6
+
+            - name: Download contracts
+              uses: actions/download-artifact@v4
+              with:
+                  name: contract-artifacts
+                  path: starknet_py/tests/e2e/mock/
+
+            - name: Install poetry
+              run: |
+                  python -m pip install --upgrade pip
+                  pip install poetry
+
+            - name: Set up Python 3.14
+              uses: actions/setup-python@v5
+              with:
+                  python-version: "3.14"
+                  cache: 'poetry'
+
+            - uses: asdf-vm/actions/setup@4f8f7939dd917fc656bb7c3575969a5988c28364 # v3.0.0
+
+            - name: Update RPC url with version from inputs
+              run: |
+                URL="${SEPOLIA_RPC_URL}"
+                RPC_VERSION="${{ inputs.rpc-version }}"
+                URL="${URL%/}" # Remove trailing slash if any
+                URL="${URL%/*}" # Get base URL without version
+                RPC_URL="${URL}/${RPC_VERSION}"
+                echo "SEPOLIA_RPC_URL=${RPC_URL}" >> "$GITHUB_ENV"
+
+            - name: Run tests (extended)
+              run: poetry run poe test_ci_on_networks_extended
+
+            - name: Generate coverage in XML
+              run: |
+                  poetry run coverage xml
+
+            - name: Upload coverage to Codecov
+              uses: codecov/codecov-action@v5