cmake.yml

# Copyright (c) 2023-present The Bitcoin Core developers
# Distributed under the MIT software license, see the accompanying
# file COPYING or https://opensource.org/license/mit/.

name: CMake
on:
  # Running for pushes is enough in the cmake-staging branch.
  # pull_request:
  push:
    branches:
      - '**'
    tags-ignore:
      - '**'

concurrency:
  group: ${{ github.workflow }}${{ github.event_name != 'pull_request' && github.run_id || github.ref }}
  cancel-in-progress: true

jobs:
  build-info:
    name: 'Test obj/build.h generation'
    runs-on: ubuntu-latest

    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - run: cp cmake/script/GenerateBuildInfo.cmake ${{ runner.temp }}

      - name: Test at HEAD
        run: |
          rm -rf src/obj build/src/obj
          mkdir -p src/obj build/src/obj
          ./share/genbuild.sh ${PWD}/src/obj/build.h ${PWD}
          cmake -DBUILD_INFO_HEADER_PATH=${PWD}/build/src/obj/build.h -DSOURCE_DIR=${PWD} -P ${{ runner.temp }}/GenerateBuildInfo.cmake
          cat src/obj/build.h
          diff -u src/obj/build.h build/src/obj/build.h

      - name: Test out of tree
        run: |
          rm -rf src/obj build/src/obj
          mkdir -p src/obj build/src/obj
          ./share/genbuild.sh ${PWD}/src/obj/build.h ${{ runner.temp }}
          cmake -DBUILD_INFO_HEADER_PATH=${PWD}/build/src/obj/build.h -DSOURCE_DIR=${{ runner.temp }} -P ${{ runner.temp }}/GenerateBuildInfo.cmake
          cat src/obj/build.h
          diff -u src/obj/build.h build/src/obj/build.h

      - name: Test at tag
        run: |
          rm -rf src/obj build/src/obj
          mkdir -p src/obj build/src/obj
          git -c advice.detachedHead=false checkout v25.1
          ./share/genbuild.sh ${PWD}/src/obj/build.h ${PWD}
          cmake -DBUILD_INFO_HEADER_PATH=${PWD}/build/src/obj/build.h -DSOURCE_DIR=${PWD} -P ${{ runner.temp }}/GenerateBuildInfo.cmake
          cat src/obj/build.h
          diff -u src/obj/build.h build/src/obj/build.h

      - name: Test dirty tree
        run: |
          rm -rf src/obj build/src/obj
          mkdir -p src/obj build/src/obj
          echo "test" >> README.md
          ./share/genbuild.sh ${PWD}/src/obj/build.h ${PWD}
          cmake -DBUILD_INFO_HEADER_PATH=${PWD}/build/src/obj/build.h -DSOURCE_DIR=${PWD} -P ${{ runner.temp }}/GenerateBuildInfo.cmake
          cat src/obj/build.h
          diff -u src/obj/build.h build/src/obj/build.h

      - name: Test BITCOIN_GENBUILD_NO_GIT
        env:
          BITCOIN_GENBUILD_NO_GIT: '1'
        run: |
          rm -rf src/obj build/src/obj
          mkdir -p src/obj build/src/obj
          ./share/genbuild.sh ${PWD}/src/obj/build.h ${PWD}
          cmake -DBUILD_INFO_HEADER_PATH=${PWD}/build/src/obj/build.h -DSOURCE_DIR=${PWD} -P ${{ runner.temp }}/GenerateBuildInfo.cmake
          cat src/obj/build.h
          diff -u src/obj/build.h build/src/obj/build.h


  deps-search:
    name: 'Test dependency search'
    runs-on: ubuntu-latest

    strategy:
      fail-fast: false
      matrix:
        conf:
          # Boost: Header-only. Using CMake's FindBoost module.
          # Libevent: Using CMake's FindPkgConfig module.
          - system_packages: ''
            depends_options: 'NO_BOOST=1 NO_LIBEVENT=1 NO_WALLET=1 NO_USDT=1'
            build_options: ''
            expected: 'fail'
          - system_packages: 'libboost-dev libevent-dev'
            depends_options: 'NO_BOOST=1 NO_LIBEVENT=1 NO_WALLET=1 NO_USDT=1'
            build_options: ''
            expected: 'fail'
          - system_packages: 'libboost-dev libevent-dev'
            depends_options: 'NO_LIBEVENT=1 NO_WALLET=1 NO_USDT=1'
            build_options: ''
            expected: 'fail'
          - system_packages: 'libboost-dev libevent-dev'
            depends_options: 'NO_BOOST=1 NO_WALLET=1 NO_USDT=1'
            build_options: ''
            expected: 'fail'
          - system_packages: 'libboost-dev libevent-dev'
            depends_options: 'NO_WALLET=1 NO_USDT=1'
            build_options: ''
            expected: 'pass'

          # BerkeleyDB: Using our own FindBerkeleyDB module.
          - system_packages: 'libboost-dev libevent-dev'
            depends_options: 'NO_BDB=1 NO_SQLITE=1 NO_USDT=1'
            build_options: '-DWITH_BDB=ON'
            expected: 'fail'
          - system_packages: 'libboost-dev libevent-dev libdb-dev libdb++-dev'
            depends_options: 'NO_BDB=1 NO_SQLITE=1 NO_USDT=1'
            build_options: '-DWITH_BDB=ON'
            expected: 'fail'
          - system_packages: 'libboost-dev libevent-dev'
            depends_options: 'NO_SQLITE=1 NO_USDT=1'
            build_options: '-DWITH_BDB=ON'
            expected: 'pass'

          # SQLite: Using CMake's FindSQLite3 module.
          - system_packages: 'libboost-dev libevent-dev'
            depends_options: 'NO_BDB=1 NO_SQLITE=1 NO_USDT=1'
            build_options: '-DWITH_SQLITE=ON'
            expected: 'fail'
          - system_packages: 'libboost-dev libevent-dev libsqlite3-dev'
            depends_options: 'NO_BDB=1 NO_SQLITE=1 NO_USDT=1'
            build_options: '-DWITH_SQLITE=ON'
            expected: 'fail'
          - system_packages: 'libboost-dev libevent-dev'
            depends_options: 'NO_BDB=1 NO_USDT=1'
            build_options: '-DWITH_SQLITE=ON'
            expected: 'pass'

          # USDT: Header-only. Using CMake's find_path function.
          - system_packages: 'libboost-dev libevent-dev'
            depends_options: 'NO_WALLET=1 NO_USDT=1'
            build_options: '-DWITH_USDT=ON'
            expected: 'fail'
          - system_packages: 'libboost-dev libevent-dev systemtap-sdt-dev'
            depends_options: 'NO_WALLET=1 NO_USDT=1'
            build_options: '-DWITH_USDT=ON'
            expected: 'fail'
          - system_packages: 'libboost-dev libevent-dev'
            depends_options: 'NO_WALLET=1'
            build_options: '-DWITH_USDT=ON'
            expected: 'pass'

    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Install system packages
        if: ${{ matrix.conf.system_packages != '' }}
        run: |
          sudo apt-get update
          sudo apt-get install --no-install-recommends ${{ matrix.conf.system_packages }}

      - name: Build depends
        working-directory: depends
        run: |
          make -j $(nproc) ${{ matrix.conf.depends_options }} NO_QT=1 NO_ZMQ=1 NO_UPNP=1 NO_NATPMP=1 LOG=1

      - name: Generate build system. Expected to FAIL
        if: ${{ matrix.conf.expected == 'fail' }}
        run: |
          ! cmake -B build -DCMAKE_TOOLCHAIN_FILE=depends/x86_64-pc-linux-gnu/share/toolchain.cmake ${{ matrix.conf.build_options }}

      - name: Generate build system. Expected to PASS
        if: ${{ matrix.conf.expected == 'pass' }}
        run: |
          cmake -B build -DCMAKE_TOOLCHAIN_FILE=depends/x86_64-pc-linux-gnu/share/toolchain.cmake


  ubuntu-focal-native:
    name: 'Ubuntu 20.04, CMake 3.16, downloaded Boost'
    runs-on: ubuntu-20.04

    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Remove preinstalled CMake
        run: |
          sudo rm /usr/local/bin/cmake /usr/local/bin/ctest

      - name: Install packages
        run: |
          sudo apt-get update
          sudo apt-get install --no-install-recommends curl g++10 cmake ccache libevent-dev libsqlite3-dev libdb-dev libdb++-dev libminiupnpc-dev libnatpmp-dev libzmq3-dev systemtap-sdt-dev
          echo "CCACHE_DIR=${{ runner.temp }}/ccache" >> "$GITHUB_ENV"

      - name: CMake version
        run: |
          cmake --version
          ctest --version

      - name: Download Boost
        run: |
          curl --location --remote-name https://boostorg.jfrog.io/artifactory/main/release/1.84.0/source/boost_1_84_0.tar.gz
          tar -xf boost_1_84_0.tar.gz

      - name: Restore Ccache cache
        uses: actions/cache/restore@v3
        id: ccache-cache
        with:
          path: ${{ env.CCACHE_DIR }}
          key: ${{ github.job }}-ccache-${{ github.run_id }}
          restore-keys: ${{ github.job }}-ccache-

      - name: Generate build system
        run: |
          cmake -B build -DCMAKE_C_COMPILER=gcc-10 -DCMAKE_CXX_COMPILER=g++-10 -DBoost_INCLUDE_DIR="${PWD}/boost_1_84_0" -DENABLE_WALLET=ON -DWITH_MINIUPNPC=ON -DWITH_NATPMP=ON -DWITH_ZMQ=ON -DWITH_USDT=ON -DWERROR=ON

      - name: Build
        working-directory: build
        run: |
          cmake --build . -j $(nproc)

      - name: Ccache stats
        run: |
          ccache --version | head -n 1
          ccache --show-stats

      - name: Save Ccache cache
        uses: actions/cache/save@v3
        if: github.event_name != 'pull_request' && steps.ccache-cache.outputs.cache-hit != 'true'
        with:
          path: ${{ env.CCACHE_DIR }}
          key: ${{ github.job }}-ccache-${{ github.run_id }}

      - name: Test
        working-directory: build
        run: |
          ctest -j $(nproc)

      - name: Install
        run: |
          cmake --install build --prefix install
          tree install


  cross-build:
    name: ${{ matrix.host.name }}
    runs-on: ubuntu-22.04

    strategy:
      fail-fast: false
      matrix:
        host:
          - name: 'Linux 32-bit, Clang, link to libatomic'
            triplet: 'i686-pc-linux-gnu'
            packages: 'clang-14 g++-multilib'
            c_compiler: 'clang-14 -m32'
            cxx_compiler: 'clang++-14 -m32'
            depends_options: 'NO_QT=1'
            configure_options: '-DWERROR=ON'
          - name: 'MinGW-w64'
            triplet: 'x86_64-w64-mingw32'
            packages: 'g++-mingw-w64-x86-64-posix'
            depends_options: 'NO_QT=1'
            exe_extension: '.exe'
          - name: 'MinGW-w64, debug'
            triplet: 'x86_64-w64-mingw32'
            packages: 'g++-mingw-w64-x86-64-posix'
            depends_options: 'NO_QT=1 DEBUG=1'
            configure_options: '-DCMAKE_BUILD_TYPE=Debug'
            cache_suffix: '-debug'
            exe_extension: '.exe'

    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Install dependency packages
        run: |
          sudo apt-get update
          sudo apt-get install --no-install-recommends ccache ${{ matrix.host.packages }}
          echo "CCACHE_DIR=${{ runner.temp }}/ccache" >> "$GITHUB_ENV"

      - name: Depends fingerprint (1)
        if: ${{ matrix.host.c_compiler != '' }}
        run: |
          ${{ matrix.host.c_compiler }} -v 2>&1 | tee depends/c_compiler_version

      - name: Depends fingerprint (2)
        if: ${{ matrix.host.cxx_compiler != '' }}
        run: |
          ${{ matrix.host.cxx_compiler }} -v 2>&1 | tee depends/cxx_compiler_version

      - name: Depends fingerprint (3)
        run: |
          echo ${{ matrix.host.depends_options }} > depends/depends_options

      - name: Depends fingerprint (4)
        id: depends_fingerprint
        run: |
          echo "hash=${{ hashFiles('depends/**') }}" >> "$GITHUB_OUTPUT"

      - name: Depends cache
        id: depends_cache
        uses: actions/cache@v3
        with:
          path: |
            depends/built
          key: ${{ matrix.host.triplet }}${{ matrix.host.cache_suffix }}-depends-${{ steps.depends_fingerprint.outputs.hash }}

      - name: Build depends
        working-directory: depends
        env:
          CC: ${{ matrix.host.c_compiler }}
          CXX: ${{ matrix.host.cxx_compiler }}
        run: |
          make -j$(nproc) HOST=${{ matrix.host.triplet }} ${{ matrix.host.depends_options }} LOG=1

      - name: Restore Ccache cache
        uses: actions/cache/restore@v3
        id: ccache-cache
        with:
          path: ${{ env.CCACHE_DIR }}
          key: ${{ matrix.host.triplet }}${{ matrix.host.cache_suffix }}-ccache-${{ github.run_id }}
          restore-keys: ${{ matrix.host.triplet }}${{ matrix.host.cache_suffix }}-ccache-

      - name: Generate build system
        run: |
          cmake -B build --toolchain depends/${{ matrix.host.triplet }}/share/toolchain.cmake ${{ matrix.host.configure_options }}

      - name: Build
        run: |
          ccache --zero-stats
          cmake --build build -j $(nproc)
          file build/src/bitcoind${{ matrix.host.exe_extension }}

      - name: Ccache stats
        run: |
          ccache --version | head -n 1
          ccache --show-stats --verbose

      - name: Save Ccache cache
        uses: actions/cache/save@v3
        if: github.event_name != 'pull_request' && steps.ccache-cache.outputs.cache-hit != 'true'
        with:
          path: ${{ env.CCACHE_DIR }}
          key: ${{ matrix.host.triplet }}${{ matrix.host.cache_suffix }}-ccache-${{ github.run_id }}

      - name: Test
        if: ${{ matrix.host.triplet == 'i686-pc-linux-gnu' }}
        run: |
          ctest --test-dir build -j $(nproc)

      - name: Install
        run: |
          cmake --install build --prefix install
          tree install


  win64-native-builtin-tools:
    name: 'Win64 native, VS 2022, built-in tools'
    runs-on: windows-2022

    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Remove non-MSVC tool installations
        run: |
          Remove-Item -Path "$env:ProgramFiles/CMake" -Recurse -Force
          Remove-Item -Path "$env:VCPKG_INSTALLATION_ROOT" -Recurse -Force

      - name: Configure Visual Studio Developer PowerShell
        # Using microsoft/setup-msbuild is not enough as it does not add other Visual Studio tools to PATH.
        uses: ilammy/msvc-dev-cmd@v1

      - name: Check build tools
        run: |
          cmake --version | Out-File -FilePath "cmake_version"
          Get-Content -Path "cmake_version"
          Write-Output "---"
          msbuild -version | Out-File -FilePath "msbuild_version"
          Get-Content -Path "msbuild_version"
          Write-Output "---"
          $env:VCToolsVersion | Out-File -FilePath "toolset_version"
          Get-Content -Path "toolset_version"
          # GHA Windows images have different versions of MSVC toolsets being installed
          # side-by-side. Therefore, the VCPKG_PLATFORM_TOOLSET_VERSION must be set explicitly
          # to avoid linker errors when using vcpkg in the manifest mode.
          # See: https://github.com/bitcoin/bitcoin/pull/28934
          Add-Content -Path "$env:VCPKG_ROOT\triplets\x64-windows-static.cmake" -Value "set(VCPKG_PLATFORM_TOOLSET_VERSION $env:VCToolsVersion)"

      - name: Restore vcpkg binary cache
        uses: actions/cache/restore@v3
        id: vcpkg-binary-cache
        with:
          path: ~/AppData/Local/vcpkg/archives
          key: ${{ runner.os }}-${{ runner.arch }}-vcpkg-binary-${{ hashFiles('cmake_version', 'msbuild_version', 'toolset_version', 'vcpkg.json') }}

      - name: Generate build system
        run: |
          cmake -B build -A x64 --toolchain $env:VCPKG_ROOT\scripts\buildsystems\vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-windows-static -DWITH_NATPMP=OFF

      - name: Save vcpkg binary cache
        uses: actions/cache/save@v3
        if: github.event_name != 'pull_request' && steps.vcpkg-binary-cache.outputs.cache-hit != 'true'
        with:
          path: ~/AppData/Local/vcpkg/archives
          key: ${{ runner.os }}-${{ runner.arch }}-vcpkg-binary-${{ hashFiles('cmake_version', 'msbuild_version', 'toolset_version', 'vcpkg.json') }}

      - name: Build Release configuration
        run: |
          cmake --build build -j $env:NUMBER_OF_PROCESSORS --config Release

      - name: Test Release configuration
        run: |
          ctest --test-dir build -j $env:NUMBER_OF_PROCESSORS -C Release

      - name: Install Release configuration
        run: |
          cmake --install build --prefix install --config Release
          tree /f install


  macos-native-x86_64:
    name: ${{ matrix.conf.name }}
    runs-on:  macos-13

    strategy:
      fail-fast: false
      matrix:
        conf:
          - name: 'macOS 13 native, x86_64, Xcode 14.3.1'
            xcode_path: '/Applications/Xcode_14.3.1.app'
            ccache_id: 'macos-13-xcode-14.3.1'
          - name: 'macOS 13 native, x86_64, Xcode 15.1'
            xcode_path: '/Applications/Xcode_15.1.app'
            ccache_id: 'macos-13-xcode-15.1'

    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Clang version
        run: |
          sudo xcode-select --switch ${{ matrix.conf.xcode_path }}
          clang --version

      - name: Install Homebrew packages
        env:
          HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK: 1
        run: |
          brew install ccache cmake pkg-config boost libevent berkeley-db@4 libnatpmp miniupnpc zeromq tree
          echo "CCACHE_DIR=${{ runner.temp }}/ccache" >> "$GITHUB_ENV"

      - name: CMake version
        run: |
          cmake --version
          ctest --version

      - name: Restore Ccache cache
        uses: actions/cache/restore@v3
        id: ccache-cache
        with:
          path: ${{ env.CCACHE_DIR }}
          key: ${{ matrix.conf.ccache_id }}-ccache-${{ github.run_id }}
          restore-keys: ${{ matrix.conf.ccache_id }}-ccache-

      - name: Generate build system
        run: |
          cmake -B build

      - name: Build
        run: |
          ccache --zero-stats
          cmake --build build -j $(sysctl -n hw.logicalcpu)

      - name: Ccache stats
        run: |
          ccache --version | head -n 1
          ccache --show-stats --verbose

      - name: Save Ccache cache
        uses: actions/cache/save@v3
        if: github.event_name != 'pull_request' && steps.ccache-cache.outputs.cache-hit != 'true'
        with:
          path: ${{ env.CCACHE_DIR }}
          key: ${{ matrix.conf.ccache_id }}-ccache-${{ github.run_id }}

      - name: Test
        run: |
          ctest --test-dir build -j $(sysctl -n hw.logicalcpu)

      - name: Install
        run: |
          cmake --install build --prefix install
          tree install