csharp.yml

name: CSharp

on:
  push:
    paths:
      - 'CSharp/**'
      - '.github/workflows/csharp.yml'
  pull_request:
    types: [opened, synchronize, reopened, ready_for_review]
  # No cron: nightly.yml calls this, so the whole nightly is ONE run
  # and therefore one triage writer. See nightly.yml's header.
  workflow_call:
    inputs:
      caller_run_id:
        description: 'run id of the calling workflow; keeps a called run in its own concurrency group'
        type: string
        default: ''
  workflow_dispatch:

# Hardcode this workflow's OWN name: github.workflow is the CALLER's in a called
# workflow, so keying on it put all 12 targets in one group -- and GitHub cancels
# the previously-pending run in a group, so only the last target survived.
concurrency:
  group: ${{ inputs.caller_run_id && format('csharp-call-{0}', inputs.caller_run_id) || format('csharp-{0}', github.ref) }}
  cancel-in-progress: ${{ !inputs.caller_run_id }}

permissions:
  contents: read

jobs:
  resolve:
    uses: ./.github/workflows/_resolve-wolfssl.yml
    with:
      stable_count: 1

  csharp:
    needs: resolve
    name: Run / csharp (${{ matrix.example }}) wolfSSL ${{ matrix.wolfssl_ref }}
    runs-on: ubuntu-24.04
    strategy:
      fail-fast: false
      matrix:
        wolfssl_ref: ${{ fromJson(needs.resolve.outputs.refs_json) }}
        # both server variants play the same client; full paths so the
        # coverage gate can see which dirs this job builds
        example:
          - CSharp/wolfSSL-TLS-pq-Server
          - CSharp/wolfSSL-TLS-pq-ServerThreaded
    timeout-minutes: 25
    steps:
      - uses: actions/checkout@v5

      - name: Install mono
        run: |
          sudo apt-get update -qq
          sudo apt-get install -y --no-install-recommends mono-complete >/dev/null

      # The .csproj targets .NET Framework v4.8 and references wolfSSL's own
      # wolfSSL_CSharp.csproj, so it cannot be built here. wolfSSL's mono.yml
      # compiles the wrapper .cs directly with mcs instead; do the same.
      - name: Build wolfSSL with the C# wrapper's user_settings.h
        run: |
          set -euo pipefail
          git clone -q --depth 1 --branch '${{ matrix.wolfssl_ref }}' \
            https://github.com/wolfSSL/wolfssl /tmp/wolfssl
          cd /tmp/wolfssl
          # wrapper/CSharp/user_settings.h already enables ML-KEM, ML-DSA and
          # SHAKE, which is what the pq examples need
          ./autogen.sh >/dev/null 2>&1
          ./configure --enable-usersettings --enable-static --enable-shared \
            CPPFLAGS=-I/tmp/wolfssl/wrapper/CSharp >/dev/null
          make -j"$(nproc)" >/dev/null
          sudo make install >/dev/null
          sudo ldconfig

      # A green build proves nothing if the wrapper silently lost the PQ API the
      # examples call, so assert the exact symbols rather than trusting configure.
      - name: Verify the wrapper still exposes the PQ API
        run: |
          set -euo pipefail
          W=/tmp/wolfssl/wrapper/CSharp/wolfSSL_CSharp
          grep -q 'WOLFSSL_ML_KEM_1024' "$W/wolfSSL.cs" \
            || { echo "FAIL: NamedGroup.WOLFSSL_ML_KEM_1024 gone from the wrapper"; exit 1; }
          grep -q 'public static int UseKeyShare' "$W/wolfSSL.cs" \
            || { echo "FAIL: UseKeyShare() gone from the wrapper"; exit 1; }
          echo "verified: WOLFSSL_ML_KEM_1024 + UseKeyShare present"

      # wolfSSL's own mono.yml runs this, but only against its PR head -- nothing
      # runs it against a RELEASE. This job builds master AND the latest stable, so
      # it is the only place the shipped wrapper gets exercised. A failure here is
      # a wolfSSL bug, not an example bug; that is the point.
      - name: Run wolfCrypt-Test through the wrapper
        # One leg only: the suite is per-wolfSSL-ref, and the example axis would
        # otherwise run the identical tests twice per ref for nothing.
        if: matrix.example == 'CSharp/wolfSSL-TLS-pq-Server'
        env:
          LD_LIBRARY_PATH: /usr/local/lib
        working-directory: /tmp/wolfssl/wrapper/CSharp
        run: |
          set -euo pipefail
          cp /usr/local/lib/libwolfssl.so wolfssl.dll
          cp /usr/local/lib/libwolfssl.so libwolfssl.so
          mcs wolfCrypt-Test/wolfCrypt-Test.cs wolfSSL_CSharp/wolfCrypt.cs \
              wolfSSL_CSharp/wolfSSL.cs wolfSSL_CSharp/X509.cs -OUT:wolfcrypttest.exe
          mono wolfcrypttest.exe | tee wct.log
          # exit 0 is not enough: the suite prints per-test results and only says
          # this once every one of them passed.
          grep -q 'All tests completed successfully' wct.log \
            || { echo "FAIL: wolfCrypt-Test did not report all tests passing"; exit 1; }

      # wolfssl.setPath() returns a RELATIVE ../../certs/, so the exes must run
      # from CSharp/<project>/ for it to land on this repo's mldsa87 chain.
      # Building them anywhere else silently resolves to the wrong certs.
      - name: Compile the pair with mcs
        run: |
          set -euo pipefail
          W=/tmp/wolfssl/wrapper/CSharp/wolfSSL_CSharp
          mcs "$W/wolfSSL.cs" "$W/X509.cs" \
            '${{ matrix.example }}'/*.cs \
            -OUT:'${{ matrix.example }}/server.exe'
          mcs "$W/wolfCrypt.cs" "$W/wolfSSL.cs" "$W/X509.cs" \
            CSharp/wolfSSL-TLS-pq-Client/wolfSSL-TLS-Client.cs \
            -OUT:CSharp/wolfSSL-TLS-pq-Client/client.exe
          for d in '${{ matrix.example }}' CSharp/wolfSSL-TLS-pq-Client; do
            cp /usr/local/lib/libwolfssl.so "$d/wolfssl.dll"
            cp /usr/local/lib/libwolfssl.so "$d/libwolfssl.so"
          done

      - name: Run the ML-KEM-1024 / ML-DSA-87 handshake
        env:
          LD_LIBRARY_PATH: /usr/local/lib
        run: |
          set -euo pipefail
          ( cd '${{ matrix.example }}' && timeout 30s mono server.exe ) \
            > server.log 2>&1 &
          for _ in $(seq 1 100); do
            ss -tln | grep -q ':11111 ' && break
            sleep 0.1
          done
          ss -tln | grep -q ':11111 ' \
            || { echo "FAIL: server never listened on 11111"; cat server.log; exit 1; }

          rc=0
          ( cd CSharp/wolfSSL-TLS-pq-Client && timeout 30s mono client.exe ) \
            > client.log 2>&1 || rc=$?
          if [ "$rc" -ne 0 ]; then
            echo "FAIL: client exited $rc"; echo "--- client:"; cat client.log
            echo "--- server:"; cat server.log; exit 1
          fi

          # exit 0 alone does not prove a handshake, so assert on the negotiated
          # session the way wolfSSL's own mono.yml does
          grep -q 'SSL version is' client.log && grep -q 'SSL cipher suite is' client.log \
            || { echo "FAIL: no TLS session reported"; echo "--- client:"; cat client.log
                 echo "--- server:"; cat server.log; exit 1; }
          echo "verified: PQ TLS 1.3 handshake"
          grep -E 'SSL version is|SSL cipher suite is' client.log