← Watch feed
net: handle multi-part netlink responses
Public commit record
80/100 · Strong
What the developer wrote
Authored by willcl-ark
net: handle multi-part netlink responses
Handle multi-part netlink responses to prevent truncated results from
large routing tables.
Previously, we only made a single recv call, which led to incomplete
results when the kernel split the message into multiple responses (which
happens frequently with NLM_F_DUMP).
Also guard against a potential hanging issue where the code would
indefinitely wait for NLMSG_DONE for non-multi-part responses by
detecting the NLM_F_MULTI flag and only continue waiting when necessary.
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Explains rationale or failure mode
What changed, and why it matters
This commit fixes how Bitcoin Core reads network routing information from the Linux kernel. Previously, the code only made one request and could receive incomplete routing data on systems with large routing tables, or could hang waiting for a 'done' signal that never comes. The fix loops to collect all kernel response parts and only waits for the 'done' marker when the kernel says the response is multi-part. This is a reliability bug fix, not a direct money-stealing vulnerability, but incorrect routing data could affect how the node connects to peers.
Recommended action
Apply the patch. It is a low-risk correctness fix. If running a node on Linux with large routing tables, ensure the fix is included to avoid incomplete local network discovery or startup hangs.
Security signals we found
01
Incorrect routing table parsing could lead to wrong local address detection
02
Potential hang when NLMSG_DONE is not sent for non-multi-part responses
03
Fixes kernel netlink protocol handling for NLM_F_DUMP
04
No direct cryptographic, consensus, or remote-exploitable vector visible in the diff
Evidence from the diff
The change is in the netlink-based local network discovery/routing code. Before the patch, a single recv() was issued for an NLM_F_DUMP request, so large routing tables produced truncated results. The code also unconditionally waited for NLMSG_DONE, which can hang for non-multi-part responses. The patch adds a loop to reassemble multi-part netlink messages and checks the NLM_F_MULTI flag before expecting NLMSG_DONE. This is a correctness/reliability fix in local network interface enumeration.
Changed components
src/common/netif.cppsrc/common/netif.hLinux netlink routing table parsingInspect captured patch +910080 / −0
diff --git a/.cirrus.yml b/.cirrus.yml
new file mode 100644
index 00000000..c047bacd
--- /dev/null
+++ b/.cirrus.yml
@@ -0,0 +1,199 @@
+env: # Global defaults
+ CIRRUS_CLONE_DEPTH: 1
+ CIRRUS_LOG_TIMESTAMP: true
+ MAKEJOBS: "-j10"
+ TEST_RUNNER_PORT_MIN: "14000" # Must be larger than 12321, which is used for the http cache. See https://cirrus-ci.org/guide/writing-tasks/#http-cache
+ CI_FAILFAST_TEST_LEAVE_DANGLING: "1" # Cirrus CI does not care about dangling processes and setting this variable avoids killing the CI script itself on error
+
+# A self-hosted machine(s) can be used via Cirrus CI. It can be configured with
+# multiple users to run tasks in parallel. No sudo permission is required.
+#
+# https://cirrus-ci.org/guide/persistent-workers/
+#
+# Generally, a persistent worker must run Ubuntu 23.04+ or Debian 12+.
+#
+# The following specific types should exist, with the following requirements:
+# - small: For an x86_64 machine, with at least 2 vCPUs and 8 GB of memory.
+# - medium: For an x86_64 machine, with at least 4 vCPUs and 16 GB of memory.
+# - arm64: For an aarch64 machine, with at least 2 vCPUs and 8 GB of memory.
+#
+# CI jobs for the latter configuration can be run on x86_64 hardware
+# by installing qemu-user-static, which works out of the box with
+# podman or docker. Background: https://stackoverflow.com/a/72890225/313633
+#
+# The above machine types are matched to each task by their label. Refer to the
+# Cirrus CI docs for more details.
+#
+# When a contributor maintains a fork of the repo, any pull request they make
+# to their own fork, or to the main repository, will trigger two CI runs:
+# one for the branch push and one for the pull request.
+# This can be avoided by setting SKIP_BRANCH_PUSH=true as a custom env variable
+# in Cirrus repository settings, accessible from
+# https://cirrus-ci.com/github/my-organization/my-repository
+#
+# On machines that are persisted between CI jobs, RESTART_CI_DOCKER_BEFORE_RUN=1
+# ensures that previous containers and artifacts are cleared before each run.
+# This requires installing Podman instead of Docker.
+#
+# Futhermore:
+# - podman-docker-4.1+ is required due to the bugfix in 4.1
+# (https://github.com/bitcoin/bitcoin/pull/21652#issuecomment-1657098200)
+# - The ./ci/ dependencies (with cirrus-cli) should be installed. One-liner example
+# for a single user setup with sudo permission:
+#
+# ```
+# apt update && apt install git screen python3 bash podman-docker uidmap slirp4netns curl -y && curl -L -o cirrus "https://github.com/cirruslabs/cirrus-cli/releases/latest/download/cirrus-linux-$(dpkg --print-architecture)" && mv cirrus /usr/local/bin/cirrus && chmod +x /usr/local/bin/cirrus
+# ```
+#
+# - There are no strict requirements on the hardware. Having fewer CPU threads
+# than recommended merely causes the CI script to run slower.
+# To avoid rare and intermittent OOM due to short memory usage spikes,
+# it is recommended to add (and persist) swap:
+#
+# ```
+# fallocate -l 16G /swapfile_ci && chmod 600 /swapfile_ci && mkswap /swapfile_ci && swapon /swapfile_ci && ( echo '/swapfile_ci none swap sw 0 0' | tee -a /etc/fstab )
+# ```
+#
+# - To register the persistent worker, open a `screen` session and run:
+#
+# ```
+# RESTART_CI_DOCKER_BEFORE_RUN=1 screen cirrus worker run --labels type=todo_fill_in_type --token todo_fill_in_token
+# ```
+
+# https://cirrus-ci.org/guide/tips-and-tricks/#sharing-configuration-between-tasks
+filter_template: &FILTER_TEMPLATE
+ # Allow forks to specify SKIP_BRANCH_PUSH=true and skip CI runs when a branch is pushed,
+ # but still run CI when a PR is created.
+ # https://cirrus-ci.org/guide/writing-tasks/#conditional-task-execution
+ skip: $SKIP_BRANCH_PUSH == "true" && $CIRRUS_PR == ""
+ stateful: false # https://cirrus-ci.org/guide/writing-tasks/#stateful-tasks
+
+base_template: &BASE_TEMPLATE
+ << : *FILTER_TEMPLATE
+ merge_base_script:
+ # Require git (used in fingerprint_script).
+ - git --version || ( apt-get update && apt-get install -y git )
+ - if [ "$CIRRUS_PR" = "" ]; then exit 0; fi
+ - git fetch --depth=1 $CIRRUS_REPO_CLONE_URL "pull/${CIRRUS_PR}/merge"
+ - git checkout FETCH_HEAD # Use merged changes to detect silent merge conflicts
+ # Also, the merge commit is used to lint COMMIT_RANGE="HEAD~..HEAD"
+
+main_template: &MAIN_TEMPLATE
+ timeout_in: 120m # https://cirrus-ci.org/faq/#instance-timed-out
+ ci_script:
+ - ./ci/test_run_all.sh
+
+global_task_template: &GLOBAL_TASK_TEMPLATE
+ << : *BASE_TEMPLATE
+ << : *MAIN_TEMPLATE
+
+compute_credits_template: &CREDITS_TEMPLATE
+ # https://cirrus-ci.org/pricing/#compute-credits
+ # Only use credits for pull requests to the main repo
+ use_compute_credits: $CIRRUS_REPO_FULL_NAME == 'bitcoin/bitcoin' && $CIRRUS_PR != ""
+
+task:
+ name: 'lint'
+ << : *BASE_TEMPLATE
+ container:
+ dockerfile: ci/lint_imagefile
+ cpu: 1
+ memory: 1G
+ # For faster CI feedback, immediately schedule the linters
+ << : *CREDITS_TEMPLATE
+ unshallow_script:
+ - git fetch --unshallow --no-tags
+ lint_script:
+ - ./ci/lint_run.sh
+
+task:
+ name: 'tidy'
+ << : *GLOBAL_TASK_TEMPLATE
+ persistent_worker:
+ labels:
+ type: medium
+ env:
+ FILE_ENV: "./ci/test/00_setup_env_native_tidy.sh"
+
+task:
+ name: 'ARM, unit tests, no functional tests'
+ << : *GLOBAL_TASK_TEMPLATE
+ persistent_worker:
+ labels:
+ type: arm64 # Use arm64 worker to sidestep qemu and avoid a slow CI: https://github.com/bitcoin/bitcoin/pull/28087#issuecomment-1649399453
+ env:
+ FILE_ENV: "./ci/test/00_setup_env_arm.sh"
+
+task:
+ name: 'CentOS, depends, gui'
+ << : *GLOBAL_TASK_TEMPLATE
+ persistent_worker:
+ labels:
+ type: small
+ env:
+ FILE_ENV: "./ci/test/00_setup_env_native_centos.sh"
+
+task:
+ name: 'previous releases, depends DEBUG'
+ << : *GLOBAL_TASK_TEMPLATE
+ persistent_worker:
+ labels:
+ type: small
+ env:
+ FILE_ENV: "./ci/test/00_setup_env_native_previous_releases.sh"
+
+task:
+ name: 'TSan, depends, gui'
+ << : *GLOBAL_TASK_TEMPLATE
+ persistent_worker:
+ labels:
+ type: medium
+ env:
+ FILE_ENV: "./ci/test/00_setup_env_native_tsan.sh"
+
+task:
+ name: 'MSan, depends'
+ << : *GLOBAL_TASK_TEMPLATE
+ persistent_worker:
+ labels:
+ type: small
+ timeout_in: 300m # Use longer timeout for the *rare* case where a full build (llvm + msan + depends + ...) needs to be done.
+ env:
+ FILE_ENV: "./ci/test/00_setup_env_native_msan.sh"
+
+task:
+ name: 'fuzzer,address,undefined,integer, no depends'
+ << : *GLOBAL_TASK_TEMPLATE
+ persistent_worker:
+ labels:
+ type: medium
+ timeout_in: 240m # larger timeout, due to the high CPU demand
+ env:
+ FILE_ENV: "./ci/test/00_setup_env_native_fuzz.sh"
+
+task:
+ name: 'multiprocess, i686, DEBUG'
+ << : *GLOBAL_TASK_TEMPLATE
+ persistent_worker:
+ labels:
+ type: medium
+ env:
+ FILE_ENV: "./ci/test/00_setup_env_i686_multiprocess.sh"
+
+task:
+ name: 'no wallet, libbitcoinkernel'
+ << : *GLOBAL_TASK_TEMPLATE
+ persistent_worker:
+ labels:
+ type: small
+ env:
+ FILE_ENV: "./ci/test/00_setup_env_native_nowallet_libbitcoinkernel.sh"
+
+task:
+ name: 'macOS-cross, gui, no tests'
+ << : *GLOBAL_TASK_TEMPLATE
+ persistent_worker:
+ labels:
+ type: small
+ env:
+ FILE_ENV: "./ci/test/00_setup_env_mac_cross.sh"
diff --git a/.editorconfig b/.editorconfig
new file mode 100644
index 00000000..c5f3028c
--- /dev/null
+++ b/.editorconfig
@@ -0,0 +1,26 @@
+# This is the top-most EditorConfig file.
+root = true
+
+# For all files.
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+# Source code files
+[*.{h,cpp,rs,py,sh}]
+indent_size = 4
+
+# .cirrus.yml, etc.
+[*.yml]
+indent_size = 2
+
+# Makefiles (only relevant for depends build)
+[Makefile]
+indent_style = tab
+
+# CMake files
+[{CMakeLists.txt,*.cmake,*.cmake.in}]
+indent_size = 2
diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 00000000..c9cf4a7d
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1 @@
+src/clientversion.cpp export-subst
diff --git a/.github/ISSUE_TEMPLATE/bug.yml b/.github/ISSUE_TEMPLATE/bug.yml
new file mode 100644
index 00000000..83922b54
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug.yml
@@ -0,0 +1,93 @@
+name: Bug report
+description: Submit a new bug report.
+labels: [bug]
+body:
+ - type: markdown
+ attributes:
+ value: |
+ ## This issue tracker is only for technical issues related to Bitcoin Core.
+
+ * General bitcoin questions and/or support requests should use Bitcoin StackExchange at https://bitcoin.stackexchange.com.
+ * For reporting security issues, please read instructions at https://bitcoincore.org/en/contact/.
+ * If the node is "stuck" during sync or giving "block checksum mismatch" errors, please ensure your hardware is stable by running `memtest` and observe CPU temperature with a load-test tool such as `linpack` before creating an issue.
+
+ ----
+ - type: checkboxes
+ attributes:
+ label: Is there an existing issue for this?
+ description: Please search to see if an issue already exists for the bug you encountered.
+ options:
+ - label: I have searched the existing issues
+ required: true
+ - type: textarea
+ id: current-behaviour
+ attributes:
+ label: Current behaviour
+ description: Tell us what went wrong
+ validations:
+ required: true
+ - type: textarea
+ id: expected-behaviour
+ attributes:
+ label: Expected behaviour
+ description: Tell us what you expected to happen
+ validations:
+ required: true
+ - type: textarea
+ id: reproduction-steps
+ attributes:
+ label: Steps to reproduce
+ description: |
+ Tell us how to reproduce your bug. Please attach related screenshots if necessary.
+ * Run-time or compile-time configuration options
+ * Actions taken
+ validations:
+ required: true
+ - type: textarea
+ id: logs
+ attributes:
+ label: Relevant log output
+ description: |
+ Please copy and paste any relevant log output or attach a debug log file.
+
+ You can find the debug.log in your [data dir.](https://github.com/bitcoin/bitcoin/blob/master/doc/files.md#data-directory-location)
+
+ Please be aware that the debug log might contain personally identifying information.
+ validations:
+ required: false
+ - type: dropdown
+ attributes:
+ label: How did you obtain Bitcoin Core
+ multiple: false
+ options:
+ - Compiled from source
+ - Pre-built binaries
+ - Package manager
+ - Other
+ validations:
+ required: true
+ - type: input
+ id: core-version
+ attributes:
+ label: What version of Bitcoin Core are you using?
+ description: Run `bitcoind --version` or in Bitcoin-QT use `Help > About Bitcoin Core`
+ placeholder: e.g. v24.0.1 or master@e1bf547
+ validations:
+ required: true
+ - type: input
+ id: os
+ attributes:
+ label: Operating system and version
+ placeholder: e.g. "MacOS Ventura 13.2" or "Ubuntu 22.04 LTS"
+ validations:
+ required: true
+ - type: textarea
+ id: machine-specs
+ attributes:
+ label: Machine specifications
+ description: |
+ What are the specifications of the host machine?
+ e.g. OS/CPU and disk type, network connectivity
+ validations:
+ required: false
+
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 00000000..40370284
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,8 @@
+blank_issues_enabled: true
+contact_links:
+ - name: Bitcoin Core Security Policy
+ url: https://github.com/bitcoin/bitcoin/blob/master/SECURITY.md
+ about: View security policy
+ - name: Bitcoin Core Developers
+ url: https://bitcoincore.org
+ about: Bitcoin Core homepage
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
new file mode 100644
index 00000000..4622fd98
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -0,0 +1,36 @@
+name: Feature Request
+description: Suggest an idea for this project.
+labels: [Feature]
+body:
+ - type: textarea
+ id: feature
+ attributes:
+ label: Please describe the feature you'd like to see added.
+ description: Attach screenshots or logs if applicable.
+ validations:
+ required: true
+ - type: textarea
+ id: related-problem
+ attributes:
+ label: Is your feature related to a problem, if so please describe it.
+ description: Attach screenshots or logs if applicable.
+ validations:
+ required: false
+ - type: textarea
+ id: solution
+ attributes:
+ label: Describe the solution you'd like
+ validations:
+ required: false
+ - type: textarea
+ id: alternatives
+ attributes:
+ label: Describe any alternatives you've considered
+ validations:
+ required: false
+ - type: textarea
+ id: additional-context
+ attributes:
+ label: Please leave any additional context
+ validations:
+ required: false
diff --git a/.github/ISSUE_TEMPLATE/good_first_issue.yml b/.github/ISSUE_TEMPLATE/good_first_issue.yml
new file mode 100644
index 00000000..133937c0
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/good_first_issue.yml
@@ -0,0 +1,44 @@
+name: Good First Issue
+description: (Regular devs only) Suggest a new good first issue
+labels: [good first issue]
+body:
+ - type: markdown
+ attributes:
+ value: |
+ Please add the label "good first issue" manually before or after opening
+
+ A good first issue is an uncontroversial issue, that has a relatively unique and obvious solution
+
+ Motivate the issue and explain the solution briefly
+ - type: textarea
+ id: motivation
+ attributes:
+ label: Motivation
+ description: Motivate the issue
+ validations:
+ required: true
+ - type: textarea
+ id: solution
+ attributes:
+ label: Possible solution
+ description: Describe a possible solution
+ validations:
+ required: false
+ - type: textarea
+ id: useful-skills
+ attributes:
+ label: Useful Skills
+ description: For example, “`std::thread`”, “Qt5 GUI and async GUI design” or “basic understanding of Bitcoin mining and the Bitcoin Core RPC interface”.
+ value: |
+ * Compiling Bitcoin Core from source
+ * Running the C++ unit tests and the Python functional tests
+ * ...
+ - type: textarea
+ attributes:
+ label: Guidance for new contributors
+ description: Please leave this to automatically add the footer for new contributors
+ value: |
+ Want to work on this issue?
+
+ For guidance on contributing, please read [CONTRIBUTING.md](https://github.com/bitcoin/bitcoin/blob/master/CONTRIBUTING.md) before opening your pull request.
+
diff --git a/.github/ISSUE_TEMPLATE/gui_issue.yml b/.github/ISSUE_TEMPLATE/gui_issue.yml
new file mode 100644
index 00000000..4fe578e9
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/gui_issue.yml
@@ -0,0 +1,18 @@
+name: Issue or feature request related to the GUI
+description: Any report, issue or feature request related to the GUI
+labels: [GUI]
+body:
+- type: checkboxes
+ id: acknowledgement
+ attributes:
+ label: Issues, reports or feature requests related to the GUI should be opened directly on the GUI repo
+ description: https://github.com/bitcoin-core/gui/issues/
+ options:
+ - label: I still think this issue should be opened here
+ required: true
+- type: textarea
+ id: gui-request
+ attributes:
+ label: Report
+ validations:
+ required: true
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 00000000..ae92fc78
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,43 @@
+<!--
+*** Please remove the following help text before submitting: ***
+
+Pull requests without a rationale and clear improvement may be closed
+immediately.
+
+GUI-related pull requests should be opened against
+https://github.com/bitcoin-core/gui
+first. See CONTRIBUTING.md
+-->
+
+<!--
+Please provide clear motivation for your patch and explain how it improves
+Bitcoin Core user experience or Bitcoin Core developer experience
+significantly:
+
+* Any test improvements or new tests that improve coverage are always welcome.
+* All other changes should have accompanying unit tests (see `src/test/`) or
+ functional tests (see `test/`). Contributors should note which tests cover
+ modified code. If no tests exist for a region of modified code, new tests
+ should accompany the change.
+* Bug fixes are most welcome when they come with steps to reproduce or an
+ explanation of the potential issue as well as reasoning for the way the bug
+ was fixed.
+* Features are welcome, but might be rejected due to design or scope issues.
+ If a feature is based on a lot of dependencies, contributors should first
+ consider building the system outside of Bitcoin Core, if possible.
+* Refactoring changes are only accepted if they are required for a feature or
+ bug fix or otherwise improve developer experience significantly. For example,
+ most "code style" refactoring changes require a thorough explanation why they
+ are useful, what downsides they have and why they *significantly* improve
+ developer experience or avoid serious programming bugs. Note that code style
+ is often a subjective matter. Unless they are explicitly mentioned to be
+ preferred in the [developer notes](/doc/developer-notes.md), stylistic code
+ changes are usually rejected.
+-->
+
+<!--
+Bitcoin Core has a thorough review process and even the most trivial change
+needs to pass a lot of eyes and requires non-zero or even substantial time
+effort to review. There is a huge lack of active reviewers on the project, so
+patches often sit for a long time.
+-->
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 00000000..e279b1c6
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,418 @@
+# Copyright (c) 2023-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+name: CI
+on:
+ # See: https://docs.github.com/en/actions/writing-workflows/choosing-when-your-workflow-runs/events-that-trigger-workflows#pull_request.
+ pull_request:
+ # See: https://docs.github.com/en/actions/writing-workflows/choosing-when-your-workflow-runs/events-that-trigger-workflows#push.
+ push:
+ branches:
+ - '**'
+ tags-ignore:
+ - '**'
+
+concurrency:
+ group: ${{ github.event_name != 'pull_request' && github.run_id || github.ref }}
+ cancel-in-progress: true
+
+env:
+ CI_FAILFAST_TEST_LEAVE_DANGLING: 1 # GHA does not care about dangling processes and setting this variable avoids killing the CI script itself on error
+ MAKEJOBS: '-j10'
+
+defaults:
+ run:
+ # Enforce fail-fast behavior for all platforms.
+ # See: https://docs.github.com/en/actions/writing-workflows/workflow-syntax-for-github-actions#exit-codes-and-error-action-preference
+ shell: bash
+
+jobs:
+ test-each-commit:
+ name: 'test each commit'
+ runs-on: ubuntu-24.04
+ if: github.event_name == 'pull_request' && github.event.pull_request.commits != 1
+ timeout-minutes: 360 # Use maximum time, see https://docs.github.com/en/actions/writing-workflows/workflow-syntax-for-github-actions#jobsjob_idtimeout-minutes. Assuming a worst case time of 1 hour per commit, this leads to a --max-count=6 below.
+ env:
+ MAX_COUNT: 6
+ steps:
+ - name: Determine fetch depth
+ run: echo "FETCH_DEPTH=$((${{ github.event.pull_request.commits }} + 2))" >> "$GITHUB_ENV"
+ - uses: actions/checkout@v4
+ with:
+ ref: ${{ github.event.pull_request.head.sha }}
+ fetch-depth: ${{ env.FETCH_DEPTH }}
+ - name: Determine commit range
+ run: |
+ # Checkout HEAD~ and find the test base commit
+ # Checkout HEAD~ because it would be wasteful to rerun tests on the PR
+ # head commit that are already run by other jobs.
+ git checkout HEAD~
+ # Figure out test base commit by listing ancestors of HEAD, excluding
+ # ancestors of the most recent merge commit, limiting the list to the
+ # newest MAX_COUNT ancestors, ordering it from oldest to newest, and
+ # taking the first one.
+ #
+ # If the branch contains up to MAX_COUNT ancestor commits after the
+ # most recent merge commit, all of those commits will be tested. If it
+ # contains more, only the most recent MAX_COUNT commits will be
+ # tested.
+ #
+ # In the command below, the ^@ suffix is used to refer to all parents
+ # of the merge commit as described in:
+ # https://git-scm.com/docs/git-rev-parse#_other_rev_parent_shorthand_notations
+ # and the ^ prefix is used to exclude these parents and all their
+ # ancestors from the rev-list output as described in:
+ # https://git-scm.com/docs/git-rev-list
+ MERGE_BASE=$(git rev-list -n1 --merges HEAD)
+ EXCLUDE_MERGE_BASE_ANCESTORS=
+ # MERGE_BASE can be empty due to limited fetch-depth
+ if test -n "$MERGE_BASE"; then
+ EXCLUDE_MERGE_BASE_ANCESTORS=^${MERGE_BASE}^@
+ fi
+ echo "TEST_BASE=$(git rev-list -n$((${{ env.MAX_COUNT }} + 1)) --reverse HEAD $EXCLUDE_MERGE_BASE_ANCESTORS | head -1)" >> "$GITHUB_ENV"
+ - run: |
+ sudo apt-get update
+ sudo apt-get install clang ccache build-essential cmake pkgconf python3-zmq libevent-dev libboost-dev libsqlite3-dev libdb++-dev systemtap-sdt-dev libzmq3-dev qtbase5-dev qttools5-dev qttools5-dev-tools qtwayland5 libqrencode-dev -y
+ - name: Compile and run tests
+ run: |
+ # Run tests on commits after the last merge commit and before the PR head commit
+ # Use clang++, because it is a bit faster and uses less memory than g++
+ git rebase --exec "echo Running test-one-commit on \$( git log -1 ) && CC=clang CXX=clang++ cmake -B build -DWERROR=ON -DWITH_ZMQ=ON -DBUILD_GUI=ON -DBUILD_BENCH=ON -DBUILD_FUZZ_BINARY=ON -DWITH_BDB=ON -DWITH_USDT=ON -DCMAKE_CXX_FLAGS='-Wno-error=unused-member-function' && cmake --build build -j $(nproc) && ctest --output-on-failure --stop-on-failure --test-dir build -j $(nproc) && ./build/test/functional/test_runner.py -j $(( $(nproc) * 2 )) --combinedlogslen=99999999" ${{ env.TEST_BASE }}
+
+ macos-native-arm64:
+ name: ${{ matrix.job-name }}
+ # Use any image to support the xcode-select below, but hardcode version to avoid silent upgrades (and breaks).
+ # See: https://github.com/actions/runner-images#available-images.
+ runs-on: macos-14
+
+ # When a contributor maintains a fork of the repo, any pull request they make
+ # to their own fork, or to the main repository, will trigger two CI runs:
+ # one for the branch push and one for the pull request.
+ # This can be avoided by setting SKIP_BRANCH_PUSH=true as a custom env variable
+ # in Github repository settings.
+ if: ${{ vars.SKIP_BRANCH_PUSH != 'true' || github.event_name == 'pull_request' }}
+
+ timeout-minutes: 120
+
+ strategy:
+ fail-fast: false
+ matrix:
+ job-type: [standard, fuzz]
+ include:
+ - job-type: standard
+ file-env: './ci/test/00_setup_env_mac_native.sh'
+ job-name: 'macOS 14 native, arm64, no depends, sqlite only, gui'
+ - job-type: fuzz
+ file-env: './ci/test/00_setup_env_mac_native_fuzz.sh'
+ job-name: 'macOS 14 native, arm64, fuzz'
+
+ env:
+ DANGER_RUN_CI_ON_HOST: 1
+ BASE_ROOT_DIR: ${{ github.workspace }}
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Clang version
+ run: |
+ # Use the earliest Xcode supported by the version of macOS denoted in
+ # doc/release-notes-empty-template.md and providing at least the
+ # minimum clang version denoted in doc/dependencies.md.
+ # See: https://developer.apple.com/documentation/xcode-release-notes/xcode-15-release-notes
+ sudo xcode-select --switch /Applications/Xcode_15.0.app
+ clang --version
+
+ - name: Install Homebrew packages
+ env:
+ HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK: 1
+ run: |
+ # A workaround for "The `brew link` step did not complete successfully" error.
+ brew install --quiet python@3 || brew link --overwrite python@3
+ brew install --quiet coreutils ninja pkgconf gnu-getopt ccache boost libevent zeromq qt@5 qrencode
+
+ - name: Set Ccache directory
+ run: echo "CCACHE_DIR=${RUNNER_TEMP}/ccache_dir" >> "$GITHUB_ENV"
+
+ - name: Restore Ccache cache
+ id: ccache-cache
+ uses: actions/cache/restore@v4
+ with:
+ path: ${{ env.CCACHE_DIR }}
+ key: ${{ github.job }}-${{ matrix.job-type }}-ccache-${{ github.run_id }}
+ restore-keys: ${{ github.job }}-${{ matrix.job-type }}-ccache-
+
+ - name: CI script
+ run: ./ci/test_run_all.sh
+ env:
+ FILE_ENV: ${{ matrix.file-env }}
+
+ - name: Save Ccache cache
+ uses: actions/cache/save@v4
+ if: github.event_name != 'pull_request' && steps.ccache-cache.outputs.cache-hit != 'true'
+ with:
+ path: ${{ env.CCACHE_DIR }}
+ # https://github.com/actions/cache/blob/main/tips-and-workarounds.md#update-a-cache
+ key: ${{ github.job }}-${{ matrix.job-type }}-ccache-${{ github.run_id }}
+
+ windows-native:
+ name: ${{ matrix.job-name }}
+ # Use latest image, but hardcode version to avoid silent upgrades (and breaks).
+ # See: https://github.com/actions/runner-images#available-images.
+ runs-on: windows-2022
+
+ if: ${{ vars.SKIP_BRANCH_PUSH != 'true' || github.event_name == 'pull_request' }}
+
+ env:
+ PYTHONUTF8: 1
+ TEST_RUNNER_TIMEOUT_FACTOR: 40
+
+ strategy:
+ fail-fast: false
+ matrix:
+ job-type: [standard, fuzz]
+ include:
+ - job-type: standard
+ generate-options: '-DBUILD_GUI=ON -DWITH_BDB=ON -DWITH_ZMQ=ON -DBUILD_BENCH=ON -DWERROR=ON'
+ job-name: 'Windows native, VS 2022'
+ - job-type: fuzz
+ generate-options: '-DVCPKG_MANIFEST_NO_DEFAULT_FEATURES=ON -DVCPKG_MANIFEST_FEATURES="wallet" -DBUILD_GUI=OFF -DBUILD_FOR_FUZZING=ON -DWERROR=ON'
+ job-name: 'Windows native, fuzz, VS 2022'
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Configure Developer Command Prompt for Microsoft Visual C++
+ # Using microsoft/setup-msbuild is not enough.
+ uses: ilammy/msvc-dev-cmd@v1
+ with:
+ arch: x64
+
+ - name: Get tool information
+ shell: pwsh
+ run: |
+ cmake -version | Tee-Object -FilePath "cmake_version"
+ Write-Output "---"
+ msbuild -version | Tee-Object -FilePath "msbuild_version"
+ $env:VCToolsVersion | Tee-Object -FilePath "toolset_version"
+ py -3 --version
+ Write-Host "PowerShell version $($PSVersionTable.PSVersion.ToString())"
+ bash --version
+
+ - name: Using vcpkg with MSBuild
+ run: |
+ echo "set(VCPKG_BUILD_TYPE release)" >> "${VCPKG_INSTALLATION_ROOT}/triplets/x64-windows.cmake"
+ echo "set(VCPKG_BUILD_TYPE release)" >> "${VCPKG_INSTALLATION_ROOT}/triplets/x64-windows-static.cmake"
+
+ - name: vcpkg tools cache
+ uses: actions/cache@v4
+ with:
+ path: C:/vcpkg/downloads/tools
+ key: ${{ github.job }}-vcpkg-tools
+
+ - name: Restore vcpkg binary cache
+ uses: actions/cache/restore@v4
+ id: vcpkg-binary-cache
+ with:
+ path: ~/AppData/Local/vcpkg/archives
+ key: ${{ github.job }}-vcpkg-binary-${{ hashFiles('cmake_version', 'msbuild_version', 'toolset_version', 'vcpkg.json') }}
+
+ - name: Generate build system
+ run: |
+ cmake -B build --preset vs2022-static -DCMAKE_TOOLCHAIN_FILE="${VCPKG_INSTALLATION_ROOT}/scripts/buildsystems/vcpkg.cmake" ${{ matrix.generate-options }}
+
+ - name: Save vcpkg binary cache
+ uses: actions/cache/save@v4
+ if: github.event_name != 'pull_request' && steps.vcpkg-binary-cache.outputs.cache-hit != 'true' && matrix.job-type == 'standard'
+ with:
+ path: ~/AppData/Local/vcpkg/archives
+ key: ${{ github.job }}-vcpkg-binary-${{ hashFiles('cmake_version', 'msbuild_version', 'toolset_version', 'vcpkg.json') }}
+
+ - name: Build
+ working-directory: build
+ run: |
+ cmake --build . -j $NUMBER_OF_PROCESSORS --config Release
+
+ - name: Run test suite
+ if: matrix.job-type == 'standard'
+ working-directory: build
+ run: |
+ ctest --output-on-failure --stop-on-failure -j $NUMBER_OF_PROCESSORS -C Release
+
+ - name: Run functional tests
+ if: matrix.job-type == 'standard'
+ working-directory: build
+ env:
+ BITCOIND: '${{ github.workspace }}\build\bin\Release\bitcoind.exe'
+ BITCOINCLI: '${{ github.workspace }}\build\bin\Release\bitcoin-cli.exe'
+ BITCOINUTIL: '${{ github.workspace }}\build\bin\Release\bitcoin-util.exe'
+ BITCOINWALLET: '${{ github.workspace }}\build\bin\Release\bitcoin-wallet.exe'
+ TEST_RUNNER_EXTRA: ${{ github.event_name != 'pull_request' && '--extended' || '' }}
+ run: py -3 test/functional/test_runner.py --jobs $NUMBER_OF_PROCESSORS --ci --quiet --tmpdirprefix="${RUNNER_TEMP}" --combinedlogslen=99999999 --timeout-factor=${TEST_RUNNER_TIMEOUT_FACTOR} ${TEST_RUNNER_EXTRA}
+
+ - name: Clone corpora
+ if: matrix.job-type == 'fuzz'
+ run: |
+ git clone --depth=1 https://github.com/bitcoin-core/qa-assets "${RUNNER_TEMP}/qa-assets"
+ cd "${RUNNER_TEMP}/qa-assets"
+ echo "Using qa-assets repo from commit ..."
+ git log -1
+
+ - name: Run fuzz tests
+ if: matrix.job-type == 'fuzz'
+ working-directory: build
+ env:
+ BITCOINFUZZ: '${{ github.workspace }}\build\bin\Release\fuzz.exe'
+ run: |
+ py -3 test/fuzz/test_runner.py --par $NUMBER_OF_PROCESSORS --loglevel DEBUG "${RUNNER_TEMP}/qa-assets/fuzz_corpora"
+
+ windows-cross:
+ name: 'Linux->Windows cross, no tests'
+ runs-on: ubuntu-latest
+ if: ${{ vars.SKIP_BRANCH_PUSH != 'true' || github.event_name == 'pull_request' }}
+
+ env:
+ FILE_ENV: './ci/test/00_setup_env_win64.sh'
+ DANGER_CI_ON_HOST_FOLDERS: 1
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Set CI directories
+ run: |
+ echo "CCACHE_DIR=${{ runner.temp }}/ccache_dir" >> "$GITHUB_ENV"
+ echo "BASE_ROOT_DIR=${{ runner.temp }}" >> "$GITHUB_ENV"
+ echo "DEPENDS_DIR=${{ runner.temp }}/depends" >> "$GITHUB_ENV"
+ echo "BASE_BUILD_DIR=${{ runner.temp }}/build" >> "$GITHUB_ENV"
+
+ - name: Depends cache
+ uses: actions/cache@v4
+ with:
+ path: ${{ env.DEPENDS_DIR }}/built
+ key: ${{ github.job }}-depends-${{ hashFiles('depends/**', 'ci/test/00_setup_env_win64.sh') }}
+
+ - name: Restore Ccache cache
+ id: ccache-cache
+ uses: actions/cache/restore@v4
+ with:
+ path: ${{ env.CCACHE_DIR }}
+ key: ${{ github.job }}-ccache-${{ github.run_id }}
+ restore-keys: ${{ github.job }}-ccache-
+
+ - name: CI script
+ run: ./ci/test_run_all.sh
+
+ - name: Save Ccache cache
+ uses: actions/cache/save@v4
+ 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: Upload built executables
+ uses: actions/upload-artifact@v4
+ with:
+ name: x86_64-w64-mingw32-executables-${{ github.run_id }}
+ path: |
+ ${{ env.BASE_BUILD_DIR }}/bin/*.exe
+ ${{ env.BASE_BUILD_DIR }}/src/secp256k1/bin/*.exe
+ ${{ env.BASE_BUILD_DIR }}/src/univalue/*.exe
+ ${{ env.BASE_BUILD_DIR }}/test/config.ini
+
+ windows-native-test:
+ name: 'Windows, test cross-built'
+ runs-on: windows-2022
+ needs: windows-cross
+
+ env:
+ PYTHONUTF8: 1
+ TEST_RUNNER_TIMEOUT_FACTOR: 40
+
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Download built executables
+ uses: actions/download-artifact@v4
+ with:
+ name: x86_64-w64-mingw32-executables-${{ github.run_id }}
+
+ - name: Run bitcoind.exe
+ run: ./bin/bitcoind.exe -version
+
+ - name: Run unit tests
+ # Can't use ctest here like other jobs as we don't have a CMake build tree.
+ run: |
+ ./bin/test_bitcoin.exe -l test_suite
+ ./src/secp256k1/bin/exhaustive_tests.exe
+ ./src/secp256k1/bin/noverify_tests.exe
+ ./src/secp256k1/bin/tests.exe
+ ./src/univalue/object.exe
+ ./src/univalue/unitester.exe
+
+ - name: Run benchmarks
+ run: ./bin/bench_bitcoin.exe -sanity-check -priority-level=high
+
+ - name: Adjust paths in test/config.ini
+ shell: pwsh
+ run: |
+ (Get-Content "test/config.ini") -replace '(?<=^SRCDIR=).*', '${{ github.workspace }}' -replace '(?<=^BUILDDIR=).*', '${{ github.workspace }}' -replace '(?<=^RPCAUTH=).*', '${{ github.workspace }}/share/rpcauth/rpcauth.py' | Set-Content "test/config.ini"
+ Get-Content "test/config.ini"
+
+ - name: Run util tests
+ run: py -3 test/util/test_runner.py
+
+ - name: Run rpcauth test
+ run: py -3 test/util/rpcauth-test.py
+
+ - name: Run functional tests
+ env:
+ # TODO: Fix the excluded tests and re-enable them.
+ EXCLUDE: '--exclude wallet_migration.py,wallet_multiwallet.py'
+ TEST_RUNNER_EXTRA: ${{ github.event_name != 'pull_request' && '--extended' || '' }}
+ run: py -3 test/functional/test_runner.py --jobs $NUMBER_OF_PROCESSORS --ci --quiet --tmpdirprefix="$RUNNER_TEMP" --combinedlogslen=99999999 --timeout-factor=$TEST_RUNNER_TIMEOUT_FACTOR $EXCLUDE $TEST_RUNNER_EXTRA
+
+ asan-lsan-ubsan-integer-no-depends-usdt:
+ name: 'ASan + LSan + UBSan + integer, no depends, USDT'
+ runs-on: ubuntu-24.04 # has to match container in ci/test/00_setup_env_native_asan.sh for tracing tools
+ if: ${{ vars.SKIP_BRANCH_PUSH != 'true' || github.event_name == 'pull_request' }}
+ timeout-minutes: 120
+ env:
+ FILE_ENV: "./ci/test/00_setup_env_native_asan.sh"
+ DANGER_CI_ON_HOST_FOLDERS: 1
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Set CI directories
+ run: |
+ echo "CCACHE_DIR=${{ runner.temp }}/ccache_dir" >> "$GITHUB_ENV"
+ echo "BASE_ROOT_DIR=${{ runner.temp }}" >> "$GITHUB_ENV"
+ echo "BASE_BUILD_DIR=${{ runner.temp }}/build-asan" >> "$GITHUB_ENV"
+
+ - name: Restore Ccache cache
+ id: ccache-cache
+ uses: actions/cache/restore@v4
+ with:
+ path: ${{ env.CCACHE_DIR }}
+ key: ${{ github.job }}-ccache-${{ github.run_id }}
+ restore-keys: ${{ github.job }}-ccache-
+
+ - name: Enable bpfcc script
+ # In the image build step, no external environment variables are available,
+ # so any settings will need to be written to the settings env file:
+ run: sed -i "s|\${INSTALL_BCC_TRACING_TOOLS}|true|g" ./ci/test/00_setup_env_native_asan.sh
+
+ - name: CI script
+ run: ./ci/test_run_all.sh
+
+ - name: Save Ccache cache
+ uses: actions/cache/save@v4
+ if: github.event_name != 'pull_request' && steps.ccache-cache.outputs.cache-hit != 'true'
+ with:
+ path: ${{ env.CCACHE_DIR }}
+ # https://github.com/actions/cache/blob/main/tips-and-workarounds.md#update-a-cache
+ key: ${{ github.job }}-ccache-${{ github.run_id }}
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 00000000..f77d3a49
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,23 @@
+# Build subdirectories.
+/*build*
+!/build-aux
+!/build_msvc
+
+*.pyc
+
+# Only ignore unexpected patches
+*.patch
+!contrib/guix/patches/*.patch
+!depends/patches/**/*.patch
+
+/CMakeUserPresets.json
+
+# Previous releases
+/releases
+
+# cargo default target dir
+target/
+
+/guix-build-*
+
+/ci/scratch/
diff --git a/.python-version b/.python-version
new file mode 100644
index 00000000..1445aee8
--- /dev/null
+++ b/.python-version
@@ -0,0 +1 @@
+3.10.14
diff --git a/.style.yapf b/.style.yapf
new file mode 100644
index 00000000..350ac638
--- /dev/null
+++ b/.style.yapf
@@ -0,0 +1,261 @@
+[style]
+# Align closing bracket with visual indentation.
+align_closing_bracket_with_visual_indent=True
+
+# Allow dictionary keys to exist on multiple lines. For example:
+#
+# x = {
+# ('this is the first element of a tuple',
+# 'this is the second element of a tuple'):
+# value,
+# }
+allow_multiline_dictionary_keys=False
+
+# Allow lambdas to be formatted on more than one line.
+allow_multiline_lambdas=False
+
+# Allow splits before the dictionary value.
+allow_split_before_dict_value=True
+
+# Number of blank lines surrounding top-level function and class
+# definitions.
+blank_lines_around_top_level_definition=2
+
+# Insert a blank line before a class-level docstring.
+blank_line_before_class_docstring=False
+
+# Insert a blank line before a module docstring.
+blank_line_before_module_docstring=False
+
+# Insert a blank line before a 'def' or 'class' immediately nested
+# within another 'def' or 'class'. For example:
+#
+# class Foo:
+# # <------ this blank line
+# def method():
+# ...
+blank_line_before_nested_class_or_def=False
+
+# Do not split consecutive brackets. Only relevant when
+# dedent_closing_brackets is set. For example:
+#
+# call_func_that_takes_a_dict(
+# {
+# 'key1': 'value1',
+# 'key2': 'value2',
+# }
+# )
+#
+# would reformat to:
+#
+# call_func_that_takes_a_dict({
+# 'key1': 'value1',
+# 'key2': 'value2',
+# })
+coalesce_brackets=False
+
+# The column limit.
+column_limit=160
+
+# The style for continuation alignment. Possible values are:
+#
+# - SPACE: Use spaces for continuation alignment. This is default behavior.
+# - FIXED: Use fixed number (CONTINUATION_INDENT_WIDTH) of columns
+# (ie: CONTINUATION_INDENT_WIDTH/INDENT_WIDTH tabs) for continuation
+# alignment.
+# - LESS: Slightly left if cannot vertically align continuation lines with
+# indent characters.
+# - VALIGN-RIGHT: Vertically align continuation lines with indent
+# characters. Slightly right (one more indent character) if cannot
+# vertically align continuation lines with indent characters.
+#
+# For options FIXED, and VALIGN-RIGHT are only available when USE_TABS is
+# enabled.
+continuation_align_style=SPACE
+
+# Indent width used for line continuations.
+continuation_indent_width=4
+
+# Put closing brackets on a separate line, dedented, if the bracketed
+# expression can't fit in a single line. Applies to all kinds of brackets,
+# including function definitions and calls. For example:
+#
+# config = {
+# 'key1': 'value1',
+# 'key2': 'value2',
+# } # <--- this bracket is dedented and on a separate line
+#
+# time_series = self.remote_client.query_entity_counters(
+# entity='dev3246.region1',
+# key='dns.query_latency_tcp',
+# transform=Transformation.AVERAGE(window=timedelta(seconds=60)),
+# start_ts=now()-timedelta(days=3),
+# end_ts=now(),
+# ) # <--- this bracket is dedented and on a separate line
+dedent_closing_brackets=False
+
+# Disable the heuristic which places each list element on a separate line
+# if the list is comma-terminated.
+disable_ending_comma_heuristic=False
+
+# Place each dictionary entry onto its own line.
+each_dict_entry_on_separate_line=True
+
+# The regex for an i18n comment. The presence of this comment stops
+# reformatting of that line, because the comments are required to be
+# next to the string they translate.
+i18n_comment=
+
+# The i18n function call names. The presence of this function stops
+# reformatting on that line, because the string it has cannot be moved
+# away from the i18n comment.
+i18n_function_call=
+
+# Indent the dictionary value if it cannot fit on the same line as the
+# dictionary key. For example:
+#
+# config = {
+# 'key1':
+# 'value1',
+# 'key2': value1 +
+# value2,
+# }
+indent_dictionary_value=False
+
+# The number of columns to use for indentation.
+indent_width=4
+
+# Join short lines into one line. E.g., single line 'if' statements.
+join_multiple_lines=True
+
+# Do not include spaces around selected binary operators. For example:
+#
+# 1 + 2 * 3 - 4 / 5
+#
+# will be formatted as follows when configured with "*,/":
+#
+# 1 + 2*3 - 4/5
+#
+no_spaces_around_selected_binary_operators=
+
+# Use spaces around default or named assigns.
+spaces_around_default_or_named_assign=False
+
+# Use spaces around the power operator.
+spaces_around_power_operator=False
+
+# The number of spaces required before a trailing comment.
+spaces_before_comment=2
+
+# Insert a space between the ending comma and closing bracket of a list,
+# etc.
+space_between_ending_comma_and_closing_bracket=True
+
+# Split before arguments
+split_all_comma_separated_values=False
+
+# Split before arguments if the argument list is terminated by a
+# comma.
+split_arguments_when_comma_terminated=False
+
+# Set to True to prefer splitting before '&', '|' or '^' rather than
+# after.
+split_before_bitwise_operator=True
+
+# Split before the closing bracket if a list or dict literal doesn't fit on
+# a single line.
+split_before_closing_bracket=True
+
+# Split before a dictionary or set generator (comp_for). For example, note
+# the split before the 'for':
+#
+# foo = {
+# variable: 'Hello world, have a nice day!'
+# for variable in bar if variable != 42
+# }
+split_before_dict_set_generator=True
+
+# Split before the '.' if we need to split a longer expression:
+#
+# foo = ('This is a really long string: {}, {}, {}, {}'.format(a, b, c, d))
+#
+# would reformat to something like:
+#
+# foo = ('This is a really long string: {}, {}, {}, {}'
+# .format(a, b, c, d))
+split_before_dot=False
+
+# Split after the opening paren which surrounds an expression if it doesn't
+# fit on a single line.
+split_before_expression_after_opening_paren=False
+
+# If an argument / parameter list is going to be split, then split before
+# the first argument.
+split_before_first_argument=False
+
+# Set to True to prefer splitting before 'and' or 'or' rather than
+# after.
+split_before_logical_operator=True
+
+# Split named assignments onto individual lines.
+split_before_named_assigns=True
+
+# Set to True to split list comprehensions and generators that have
+# non-trivial expressions and multiple clauses before each of these
+# clauses. For example:
+#
+# result = [
+# a_long_var + 100 for a_long_var in xrange(1000)
+# if a_long_var % 10]
+#
+# would reformat to something like:
+#
+# result = [
+# a_long_var + 100
+# for a_long_var in xrange(1000)
+# if a_long_var % 10]
+split_complex_comprehension=False
+
+# The penalty for splitting right after the opening bracket.
+split_penalty_after_opening_bracket=30
+
+# The penalty for splitting the line after a unary operator.
+split_penalty_after_unary_operator=10000
+
+# The penalty for splitting right before an if expression.
+split_penalty_before_if_expr=0
+
+# The penalty of splitting the line around the '&', '|', and '^'
+# operators.
+split_penalty_bitwise_operator=300
+
+# The penalty for splitting a list comprehension or generator
+# expression.
+split_penalty_comprehension=80
+
+# The penalty for characters over the column limit.
+split_penalty_excess_character=7000
+
+# The penalty incurred by adding a line split to the unwrapped line. The
+# more line splits added the higher the penalty.
+split_penalty_for_added_line_split=30
+
+# The penalty of splitting a list of "import as" names. For example:
+#
+# from a_very_long_or_indented_module_name_yada_yad import (long_argument_1,
+# long_argument_2,
+# long_argument_3)
+#
+# would reformat to something like:
+#
+# from a_very_long_or_indented_module_name_yada_yad import (
+# long_argument_1, long_argument_2, long_argument_3)
+split_penalty_import_names=0
+
+# The penalty of splitting the line around the 'and' and 'or'
+# operators.
+split_penalty_logical_operator=300
+
+# Use the Tab character for indentation.
+use_tabs=False
+
diff --git a/.tx/config b/.tx/config
new file mode 100644
index 00000000..b5a9abaa
--- /dev/null
+++ b/.tx/config
@@ -0,0 +1,7 @@
+[main]
+host = https://www.transifex.com
+
+[o:bitcoin:p:bitcoin:r:qt-translation-029x]
+file_filter = src/qt/locale/bitcoin_<lang>.xlf
+source_file = src/qt/locale/bitcoin_en.xlf
+source_lang = en
diff --git a/CMakeLists.txt b/CMakeLists.txt
new file mode 100644
index 00000000..c5ebd2f0
--- /dev/null
+++ b/CMakeLists.txt
@@ -0,0 +1,708 @@
+# 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/.
+
+# Ubuntu 22.04 LTS Jammy Jellyfish, https://wiki.ubuntu.com/Releases, EOSS in June 2027:
+# - CMake 3.22.1, https://packages.ubuntu.com/jammy/cmake
+#
+# Centos Stream 9, https://www.centos.org/cl-vs-cs/#end-of-life, EOL in May 2027:
+# - CMake 3.26.5, https://mirror.stream.centos.org/9-stream/AppStream/x86_64/os/Packages/
+cmake_minimum_required(VERSION 3.22)
+
+if(CMAKE_SOURCE_DIR STREQUAL CMAKE_BINARY_DIR)
+ message(FATAL_ERROR "In-source builds are not allowed.")
+endif()
+
+if(POLICY CMP0171)
+ # `codegen` is a reserved target name.
+ # See: https://cmake.org/cmake/help/latest/policy/CMP0171.html
+ cmake_policy(SET CMP0171 NEW)
+endif()
+
+#=============================
+# Project / Package metadata
+#=============================
+set(CLIENT_NAME "Bitcoin Core")
+set(CLIENT_VERSION_MAJOR 29)
+set(CLIENT_VERSION_MINOR 99)
+set(CLIENT_VERSION_BUILD 0)
+set(CLIENT_VERSION_RC 0)
+set(CLIENT_VERSION_IS_RELEASE "false")
+set(COPYRIGHT_YEAR "2025")
+
+# During the enabling of the CXX and CXXOBJ languages, we modify
+# CMake's compiler/linker invocation strings by appending the content
+# of the user-defined `APPEND_*` variables, which allows overriding
+# any flag. We also ensure that the APPEND_* flags are considered
+# during CMake's tests, which use the `try_compile()` command.
+#
+# CMake's docs state that the `CMAKE_TRY_COMPILE_PLATFORM_VARIABLES`
+# variable "is meant to be set by CMake's platform information modules
+# for the current toolchain, or by a toolchain file." We do our best
+# to set it before the `project()` command.
+set(CMAKE_TRY_COMPILE_PLATFORM_VARIABLES
+ CMAKE_CXX_COMPILE_OBJECT
+ CMAKE_OBJCXX_COMPILE_OBJECT
+ CMAKE_CXX_LINK_EXECUTABLE
+)
+
+project(BitcoinCore
+ VERSION ${CLIENT_VERSION_MAJOR}.${CLIENT_VERSION_MINOR}.${CLIENT_VERSION_BUILD}
+ DESCRIPTION "Bitcoin client software"
+ HOMEPAGE_URL "https://bitcoincore.org/"
+ LANGUAGES NONE
+)
+
+set(CLIENT_VERSION_STRING ${PROJECT_VERSION})
+if(CLIENT_VERSION_RC GREATER 0)
+ string(APPEND CLIENT_VERSION_STRING "rc${CLIENT_VERSION_RC}")
+endif()
+
+set(COPYRIGHT_HOLDERS "The %s developers")
+set(COPYRIGHT_HOLDERS_FINAL "The ${CLIENT_NAME} developers")
+set(CLIENT_BUGREPORT "https://github.com/bitcoin/bitcoin/issues")
+
+#=============================
+# Language setup
+#=============================
+if(CMAKE_SYSTEM_NAME STREQUAL "Darwin" AND NOT CMAKE_HOST_APPLE)
+ # We do not use the install_name_tool when cross-compiling for macOS.
+ # So disable this tool check in further enable_language() commands.
+ set(CMAKE_PLATFORM_HAS_INSTALLNAME FALSE)
+endif()
+enable_language(CXX)
+set(CMAKE_CXX_STANDARD 20)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+
+list(APPEND CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/cmake/module)
+include(ProcessConfigurations)
+
+# Flatten static lib dependencies.
+# Without this, if libfoo.a depends on libbar.a, libfoo's objects can't begin
+# to be compiled until libbar.a has been created.
+if (NOT DEFINED CMAKE_OPTIMIZE_DEPENDENCIES)
+ set(CMAKE_OPTIMIZE_DEPENDENCIES TRUE)
+endif()
+
+#=============================
+# Configurable options
+#=============================
+include(CMakeDependentOption)
+# When adding a new option, end the <help_text> with a full stop for consistency.
+option(BUILD_DAEMON "Build bitcoind executable." ON)
+option(BUILD_GUI "Build bitcoin-qt executable." OFF)
+option(BUILD_CLI "Build bitcoin-cli executable." ON)
+
+option(BUILD_TESTS "Build test_bitcoin executable." ON)
+option(BUILD_TX "Build bitcoin-tx executable." ${BUILD_TESTS})
+option(BUILD_UTIL "Build bitcoin-util executable." ${BUILD_TESTS})
+
+option(BUILD_UTIL_CHAINSTATE "Build experimental bitcoin-chainstate executable." OFF)
+option(BUILD_KERNEL_LIB "Build experimental bitcoinkernel library." ${BUILD_UTIL_CHAINSTATE})
+
+option(ENABLE_WALLET "Enable wallet." ON)
+if(ENABLE_WALLET)
+ if(VCPKG_TARGET_TRIPLET)
+ # Use of the `unofficial::` namespace is a vcpkg package manager convention.
+ find_package(unofficial-sqlite3 CONFIG REQUIRED)
+ else()
+ find_package(SQLite3 3.7.17 REQUIRED)
+ endif()
+endif()
+option(WITH_BDB "Enable Berkeley DB (BDB) wallet support." OFF)
+cmake_dependent_option(WARN_INCOMPATIBLE_BDB "Warn when using a Berkeley DB (BDB) version other than 4.8." ON "WITH_BDB" OFF)
+if(WITH_BDB)
+ find_package(BerkeleyDB 4.8 MODULE REQUIRED)
+ set(USE_BDB ON)
+ if(NOT BerkeleyDB_VERSION VERSION_EQUAL 4.8)
+ message(WARNING "Found Berkeley DB (BDB) other than 4.8.\n"
+ "BDB (legacy) wallets opened by this build will not be portable!"
+ )
+ if(WARN_INCOMPATIBLE_BDB)
+ message(WARNING "If this is intended, pass \"-DWARN_INCOMPATIBLE_BDB=OFF\".\n"
+ "Passing \"-DWITH_BDB=OFF\" will suppress this warning."
+ )
+ endif()
+ endif()
+endif()
+cmake_dependent_option(BUILD_WALLET_TOOL "Build bitcoin-wallet tool." ${BUILD_TESTS} "ENABLE_WALLET" OFF)
+
+option(ENABLE_HARDENING "Attempt to harden the resulting executables." ON)
+option(REDUCE_EXPORTS "Attempt to reduce exported symbols in the resulting executables." OFF)
+option(WERROR "Treat compiler warnings as errors." OFF)
+option(WITH_CCACHE "Attempt to use ccache for compiling." ON)
+
+option(WITH_ZMQ "Enable ZMQ notifications." OFF)
+if(WITH_ZMQ)
+ find_package(ZeroMQ 4.0.0 MODULE REQUIRED)
+endif()
+
+option(WITH_USDT "Enable tracepoints for Userspace, Statically Defined Tracing." OFF)
+if(WITH_USDT)
+ find_package(USDT MODULE REQUIRED)
+endif()
+
+cmake_dependent_option(ENABLE_EXTERNAL_SIGNER "Enable external signer support." ON "NOT WIN32" OFF)
+
+cmake_dependent_option(WITH_QRENCODE "Enable QR code support." ON "BUILD_GUI" OFF)
+if(WITH_QRENCODE)
+ find_package(QRencode MODULE REQUIRED)
+ set(USE_QRCODE TRUE)
+endif()
+
+cmake_dependent_option(WITH_DBUS "Enable DBus support." ON "CMAKE_SYSTEM_NAME STREQUAL \"Linux\" AND BUILD_GUI" OFF)
+
+option(WITH_MULTIPROCESS "Build multiprocess bitcoin-node and bitcoin-gui executables in addition to monolithic bitcoind and bitcoin-qt executables. Requires libmultiprocess library. Experimental." OFF)
+if(WITH_MULTIPROCESS)
+ find_package(Libmultiprocess REQUIRED COMPONENTS Lib)
+ find_package(LibmultiprocessNative REQUIRED COMPONENTS Bin
+ NAMES Libmultiprocess
+ )
+endif()
+
+cmake_dependent_option(BUILD_GUI_TESTS "Build test_bitcoin-qt executable." ON "BUILD_GUI;BUILD_TESTS" OFF)
+if(BUILD_GUI)
+ set(qt_components Core Gui Widgets LinguistTools)
+ if(ENABLE_WALLET)
+ list(APPEND qt_components Network)
+ endif()
+ if(WITH_DBUS)
+ list(APPEND qt_components DBus)
+ set(USE_DBUS TRUE)
+ endif()
+ if(BUILD_GUI_TESTS)
+ list(APPEND qt_components Test)
+ endif()
+ find_package(Qt 5.11.3 MODULE REQUIRED
+ COMPONENTS ${qt_components}
+ )
+ unset(qt_components)
+endif()
+
+option(BUILD_BENCH "Build bench_bitcoin executable." OFF)
+option(BUILD_FUZZ_BINARY "Build fuzz binary." OFF)
+option(BUILD_FOR_FUZZING "Build for fuzzing. Enabling this will disable all other targets and override BUILD_FUZZ_BINARY." OFF)
+
+option(INSTALL_MAN "Install man pages." ON)
+
+set(APPEND_CPPFLAGS "" CACHE STRING "Preprocessor flags that are appended to the command line after all other flags added by the build system. This variable is intended for debugging and special builds.")
+set(APPEND_CFLAGS "" CACHE STRING "C compiler flags that are appended to the command line after all other flags added by the build system. This variable is intended for debugging and special builds.")
+set(APPEND_CXXFLAGS "" CACHE STRING "(Objective) C++ compiler flags that are appended to the command line after all other flags added by the build system. This variable is intended for debugging and special builds.")
+set(APPEND_LDFLAGS "" CACHE STRING "Linker flags that are appended to the command line after all other flags added by the build system. This variable is intended for debugging and special builds.")
+# Appending to this low-level rule variables is the only way to
+# guarantee that the flags appear at the end of the command line.
+string(APPEND CMAKE_CXX_COMPILE_OBJECT " ${APPEND_CPPFLAGS} ${APPEND_CXXFLAGS}")
+string(APPEND CMAKE_CXX_CREATE_SHARED_LIBRARY " ${APPEND_LDFLAGS}")
+string(APPEND CMAKE_CXX_LINK_EXECUTABLE " ${APPEND_LDFLAGS}")
+
+set(configure_warnings)
+
+include(CheckLinkerSupportsPIE)
+check_linker_supports_pie(configure_warnings)
+
+# The core_interface library aims to encapsulate common build flags.
+# It is a usage requirement for all targets except for secp256k1, which
+# gets its flags by other means.
+add_library(core_interface INTERFACE)
+add_library(core_interface_relwithdebinfo INTERFACE)
+add_library(core_interface_debug INTERFACE)
+target_link_libraries(core_interface INTERFACE
+ $<$<CONFIG:RelWithDebInfo>:core_interface_relwithdebinfo>
+ $<$<CONFIG:Debug>:core_interface_debug>
+)
+
+if(BUILD_FOR_FUZZING)
+ message(WARNING "BUILD_FOR_FUZZING=ON will disable all other targets and force BUILD_FUZZ_BINARY=ON.")
+ set(BUILD_DAEMON OFF)
+ set(BUILD_CLI OFF)
+ set(BUILD_TX OFF)
+ set(BUILD_UTIL OFF)
+ set(BUILD_UTIL_CHAINSTATE OFF)
+ set(BUILD_KERNEL_LIB OFF)
+ set(BUILD_WALLET_TOOL OFF)
+ set(BUILD_GUI OFF)
+ set(ENABLE_EXTERNAL_SIGNER OFF)
+ set(WITH_ZMQ OFF)
+ set(BUILD_TESTS OFF)
+ set(BUILD_GUI_TESTS OFF)
+ set(BUILD_BENCH OFF)
+ set(BUILD_FUZZ_BINARY ON)
+
+ target_compile_definitions(core_interface INTERFACE
+ FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION
+ )
+endif()
+
+include(TryAppendCXXFlags)
+include(TryAppendLinkerFlag)
+
+# Redefine/adjust per-configuration flags.
+target_compile_definitions(core_interface_debug INTERFACE
+ DEBUG
+ DEBUG_LOCKORDER
+ DEBUG_LOCKCONTENTION
+ RPC_DOC_CHECK
+ ABORT_ON_FAILED_ASSUME
+)
+
+if(WIN32)
+ #[=[
+ This build system supports two ways to build binaries for Windows.
+
+ 1. Building on Windows using MSVC.
+ Implementation notes:
+ - /DWIN32 and /D_WINDOWS definitions are included into the CMAKE_CXX_FLAGS_INIT
+ and CMAKE_CXX_FLAGS_INIT variables by default.
+ - A run-time library is selected using the CMAKE_MSVC_RUNTIME_LIBRARY variable.
+ - MSVC-specific options, for example, /Zc:__cplusplus, are additionally required.
+
+ 2. Cross-compiling using MinGW.
+ Implementation notes:
+ - WIN32 and _WINDOWS definitions must be provided explicitly.
+ - A run-time library must be specified explicitly using _MT definition.
+ ]=]
+
+ target_compile_definitions(core_interface INTERFACE
+ _WIN32_WINNT=0x0A00
+ _WIN32_IE=0x0A00
+ WIN32_LEAN_AND_MEAN
+ NOMINMAX
+ )
+
+ if(MSVC)
+ if(VCPKG_TARGET_TRIPLET MATCHES "-static")
+ set(msvc_library_linkage "")
+ else()
+ set(msvc_library_linkage "DLL")
+ endif()
+ set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>${msvc_library_linkage}")
+ unset(msvc_library_linkage)
+
+ target_compile_definitions(core_interface INTERFACE
+ _UNICODE;UNICODE
+ )
+ target_compile_options(core_interface INTERFACE
+ /utf-8
+ /Zc:preprocessor
+ /Zc:__cplusplus
+ /sdl
+ )
+ # Improve parallelism in MSBuild.
+ # See: https://devblogs.microsoft.com/cppblog/improved-parallelism-in-msbuild/.
+ list(APPEND CMAKE_VS_GLOBALS "UseMultiToolTask=true")
+ endif()
+
+ if(MINGW)
+ target_compile_definitions(core_interface INTERFACE
+ WIN32
+ _WINDOWS
+ _MT
+ )
+ # Avoid the use of aligned vector instructions when building for Windows.
+ # See https://gcc.gnu.org/bugzilla/show_bug.cgi?id=54412.
+ try_append_cxx_flags("-Wa,-muse-unaligned-vector-move" TARGET core_interface SKIP_LINK)
+ try_append_linker_flag("-static" TARGET core_interface)
+ # We support Windows 10+, however it's not possible to set these values accordingly,
+ # due to a bug in mingw-w64. See https://sourceforge.net/p/mingw-w64/bugs/968/.
+ # As a best effort, target Windows 8.
+ try_append_linker_flag("-Wl,--major-subsystem-version,6" TARGET core_interface)
+ try_append_linker_flag("-Wl,--minor-subsystem-version,2" TARGET core_interface)
+ endif()
+
+ # Workaround producing large object files, which cannot be handled by the assembler.
+ # More likely to happen with no, or lower levels of optimisation.
+ # See discussion in https://github.com/bitcoin/bitcoin/issues/28109.
+ if(CMAKE_CXX_COMPILER_ID STREQUAL "MSVC")
+ try_append_cxx_flags("/bigobj" TARGET core_interface_debug SKIP_LINK)
+ else()
+ try_append_cxx_flags("-Wa,-mbig-obj" TARGET core_interface_debug SKIP_LINK)
+ endif()
+endif()
+
+# Use 64-bit off_t on 32-bit Linux.
+if (CMAKE_SYSTEM_NAME STREQUAL "Linux" AND CMAKE_SIZEOF_VOID_P EQUAL 4)
+ # Ensure 64-bit offsets are used for filesystem accesses for 32-bit compilation.
+ target_compile_definitions(core_interface INTERFACE
+ _FILE_OFFSET_BITS=64
+ )
+endif()
+
+if(CMAKE_SYSTEM_NAME STREQUAL "Darwin")
+ target_compile_definitions(core_interface INTERFACE OBJC_OLD_DISPATCH_PROTOTYPES=0)
+ # These flags are specific to ld64, and may cause issues with other linkers.
+ # For example: GNU ld will interpret -dead_strip as -de and then try and use
+ # "ad_strip" as the symbol for the entry point.
+ try_append_linker_flag("-Wl,-dead_strip" TARGET core_interface)
+ try_append_linker_flag("-Wl,-dead_strip_dylibs" TARGET core_interface)
+ if(CMAKE_HOST_APPLE)
+ try_append_linker_flag("-Wl,-headerpad_max_install_names" TARGET core_interface)
+ endif()
+endif()
+
+set(THREADS_PREFER_PTHREAD_FLAG ON)
+find_package(Threads REQUIRED)
+target_link_libraries(core_interface INTERFACE
+ Threads::Threads
+)
+
+# Define sanitize_interface with -fsanitize flags intended to apply to all
+# libraries and executables.
+add_library(sanitize_interface INTERFACE)
+target_link_libraries(core_interface INTERFACE sanitize_interface)
+if(SANITIZERS)
+ # Transform list of sanitizers into -fsanitize flags, replacing "fuzzer" with
+ # "fuzzer-no-link" in sanitize_interface flags, and moving "fuzzer" to
+ # fuzzer_interface flags. If -DSANITIZERS=fuzzer is specified, the fuzz test
+ # binary should be built with -fsanitize=fuzzer (so it can use libFuzzer's
+ # main function), but libraries should be built with -fsanitize=fuzzer-no-link
+ # (so they can be linked into other executables that have their own main
+ # functions).
+ string(REGEX REPLACE "(^|,)fuzzer($|,)" "\\1fuzzer-no-link\\2" sanitize_opts "${SANITIZERS}")
+ set(fuzz_flag "")
+ if(NOT sanitize_opts STREQUAL SANITIZERS)
+ set(fuzz_flag "-fsanitize=fuzzer")
+ endif()
+
+ # First check if the compiler accepts flags. If an incompatible pair like
+ # -fsanitize=address,thread is used here, this check will fail. This will also
+ # fail if a bad argument is passed, e.g. -fsanitize=undfeined
+ try_append_cxx_flags("-fsanitize=${sanitize_opts}" TARGET sanitize_interface
+ RESULT_VAR cxx_supports_sanitizers
+ SKIP_LINK
+ )
+ if(NOT cxx_supports_sanitizers)
+ message(FATAL_ERROR "Compiler did not accept requested flags.")
+ endif()
+
+ # Some compilers (e.g. GCC) require additional libraries like libasan,
+ # libtsan, libubsan, etc. Make sure linking still works with the sanitize
+ # flag. This is a separate check so we can give a better error message when
+ # the sanitize flags are supported by the compiler but the actual sanitizer
+ # libs are missing.
+ try_append_linker_flag("-fsanitize=${sanitize_opts}" VAR SANITIZER_LDFLAGS
+ SOURCE "
+ #include <cstdint>
+ #include <cstddef>
+ extern \"C\" int LLVMFuzzerTestOneInput(const uint8_t* data, size_t size) { return 0; }
+ int main() { return 0; }
+ "
+ RESULT_VAR linker_supports_sanitizers
+ NO_CACHE_IF_FAILED
+ )
+ if(NOT linker_supports_sanitizers)
+ message(FATAL_ERROR "Linker did not accept requested flags, you are missing required libraries.")
+ endif()
+endif()
+target_link_options(sanitize_interface INTERFACE ${SANITIZER_LDFLAGS})
+
+# Define fuzzer_interface with flags intended to apply to the fuzz test binary,
+# and perform a test compilation to determine correct value of
+# FUZZ_BINARY_LINKS_WITHOUT_MAIN_FUNCTION.
+if(BUILD_FUZZ_BINARY)
+ include(CheckSourceCompilesWithFlags)
+ check_cxx_source_compiles_with_flags("
+ #include <cstdint>
+ #include <cstddef>
+ extern \"C\" int LLVMFuzzerTestOneInput(const uint8_t* data, size_t size) { return 0; }
+ // No main() function.
+ " FUZZ_BINARY_LINKS_WITHOUT_MAIN_FUNCTION
+ LDFLAGS ${SANITIZER_LDFLAGS} ${fuzz_flag}
+ LINK_LIBRARIES ${FUZZ_LIBS}
+ )
+ add_library(fuzzer_interface INTERFACE)
+ target_link_options(fuzzer_interface INTERFACE ${fuzz_flag})
+ target_link_libraries(fuzzer_interface INTERFACE ${FUZZ_LIBS})
+endif()
+
+include(AddBoostIfNeeded)
+add_boost_if_needed()
+
+if(BUILD_DAEMON OR BUILD_GUI OR BUILD_CLI OR BUILD_TESTS OR BUILD_BENCH OR BUILD_FUZZ_BINARY)
+ find_package(Libevent 2.1.8 MODULE REQUIRED)
+endif()
+
+include(cmake/introspection.cmake)
+
+include(cmake/ccache.cmake)
+
+add_library(warn_interface INTERFACE)
+target_link_libraries(core_interface INTERFACE warn_interface)
+if(MSVC)
+ try_append_cxx_flags("/W3" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("/wd4018" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("/wd4146" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("/wd4244" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("/wd4267" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("/wd4715" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("/wd4805" TARGET warn_interface SKIP_LINK)
+ target_compile_definitions(warn_interface INTERFACE
+ _CRT_SECURE_NO_WARNINGS
+ _SILENCE_CXX17_CODECVT_HEADER_DEPRECATION_WARNING
+ )
+else()
+ try_append_cxx_flags("-Wall" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wextra" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wgnu" TARGET warn_interface SKIP_LINK)
+ # Some compilers will ignore -Wformat-security without -Wformat, so just combine the two here.
+ try_append_cxx_flags("-Wformat -Wformat-security" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wvla" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wshadow-field" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wthread-safety" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wloop-analysis" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wredundant-decls" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wunused-member-function" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wdate-time" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wconditional-uninitialized" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wduplicated-branches" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wduplicated-cond" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wlogical-op" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Woverloaded-virtual" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wsuggest-override" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wimplicit-fallthrough" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wunreachable-code" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wdocumentation" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wself-assign" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wbidi-chars=any" TARGET warn_interface SKIP_LINK)
+ try_append_cxx_flags("-Wundef" TARGET warn_interface SKIP_LINK)
+
+ # Some compilers (gcc) ignore unknown -Wno-* options, but warn about all
+ # unknown options if any other warning is produced. Test the -Wfoo case, and
+ # set the -Wno-foo case if it works.
+ try_append_cxx_flags("-Wunused-parameter" TARGET warn_interface SKIP_LINK
+ IF_CHECK_PASSED "-Wno-unused-parameter"
+ )
+endif()
+
+configure_file(cmake/script/Coverage.cmake Coverage.cmake USE_SOURCE_PERMISSIONS COPYONLY)
+configure_file(cmake/script/CoverageFuzz.cmake CoverageFuzz.cmake USE_SOURCE_PERMISSIONS COPYONLY)
+configure_file(cmake/script/CoverageInclude.cmake.in CoverageInclude.cmake USE_SOURCE_PERMISSIONS @ONLY)
+configure_file(cmake/script/cov_tool_wrapper.sh.in cov_tool_wrapper.sh.in USE_SOURCE_PERMISSIONS COPYONLY)
+configure_file(contrib/filter-lcov.py filter-lcov.py USE_SOURCE_PERMISSIONS COPYONLY)
+
+# Don't allow extended (non-ASCII) symbols in identifiers. This is easier for code review.
+try_append_cxx_flags("-fno-extended-identifiers" TARGET core_interface SKIP_LINK)
+
+# Avoiding the `-ffile-prefix-map` compiler option because it implies
+# `-fcoverage-prefix-map` on Clang or `-fprofile-prefix-map` on GCC,
+# which can cause issues with coverage builds, particularly when using
+# Clang in the OSS-Fuzz environment due to its use of other options
+# and a third party script, or with GCC.
+try_append_cxx_flags("-fdebug-prefix-map=A=B" TARGET core_interface SKIP_LINK
+ IF_CHECK_PASSED "-fdebug-prefix-map=${PROJECT_SOURCE_DIR}/src=."
+)
+try_append_cxx_flags("-fmacro-prefix-map=A=B" TARGET core_interface SKIP_LINK
+ IF_CHECK_PASSED "-fmacro-prefix-map=${PROJECT_SOURCE_DIR}/src=."
+)
+
+# Currently all versions of gcc are subject to a class of bugs, see the
+# gccbug_90348 test case (only reproduces on GCC 11 and earlier) and
+# https://gcc.gnu.org/bugzilla/show_bug.cgi?id=111843. To work around that, set
+# -fstack-reuse=none for all gcc builds. (Only gcc understands this flag).
+try_append_cxx_flags("-fstack-reuse=none" TARGET core_interface)
+
+if(ENABLE_HARDENING)
+ add_library(hardening_interface INTERFACE)
+ target_link_libraries(core_interface INTERFACE hardening_interface)
+ if(MSVC)
+ try_append_linker_flag("/DYNAMICBASE" TARGET hardening_interface)
+ try_append_linker_flag("/HIGHENTROPYVA" TARGET hardening_interface)
+ try_append_linker_flag("/NXCOMPAT" TARGET hardening_interface)
+ else()
+
+ # _FORTIFY_SOURCE requires that there is some level of optimization,
+ # otherwise it does nothing and just creates a compiler warning.
+ try_append_cxx_flags("-U_FORTIFY_SOURCE -D_FORTIFY_SOURCE=3"
+ RESULT_VAR cxx_supports_fortify_source
+ SOURCE "int main() {
+ # if !defined __OPTIMIZE__ || __OPTIMIZE__ <= 0
+ #error
+ #endif
+ }"
+ )
+ if(cxx_supports_fortify_source)
+ target_compile_options(hardening_interface INTERFACE
+ -U_FORTIFY_SOURCE
+ -D_FORTIFY_SOURCE=3
+ )
+ endif()
+ unset(cxx_supports_fortify_source)
+
+ try_append_cxx_flags("-Wstack-protector" TARGET hardening_interface SKIP_LINK)
+ try_append_cxx_flags("-fstack-protector-all" TARGET hardening_interface)
+ try_append_cxx_flags("-fcf-protection=full" TARGET hardening_interface)
+
+ if(MINGW)
+ # stack-clash-protection is a no-op for Windows.
+ # See https://gcc.gnu.org/bugzilla/show_bug.cgi?id=90458 for more details.
+ else()
+ try_append_cxx_flags("-fstack-clash-protection" TARGET hardening_interface)
+ endif()
+
+ if(CMAKE_SYSTEM_PROCESSOR STREQUAL "aarch64" OR CMAKE_SYSTEM_PROCESSOR STREQUAL "arm64")
+ if(CMAKE_SYSTEM_NAME STREQUAL "Darwin")
+ try_append_cxx_flags("-mbranch-protection=bti" TARGET hardening_interface SKIP_LINK)
+ else()
+ try_append_cxx_flags("-mbranch-protection=standard" TARGET hardening_interface SKIP_LINK)
+ endif()
+ endif()
+
+ try_append_linker_flag("-Wl,--enable-reloc-section" TARGET hardening_interface)
+ try_append_linker_flag("-Wl,--dynamicbase" TARGET hardening_interface)
+ try_append_linker_flag("-Wl,--nxcompat" TARGET hardening_interface)
+ try_append_linker_flag("-Wl,--high-entropy-va" TARGET hardening_interface)
+ try_append_linker_flag("-Wl,-z,relro" TARGET hardening_interface)
+ try_append_linker_flag("-Wl,-z,now" TARGET hardening_interface)
+ try_append_linker_flag("-Wl,-z,separate-code" TARGET hardening_interface)
+ if(CMAKE_SYSTEM_NAME STREQUAL "Darwin")
+ try_append_linker_flag("-Wl,-fixup_chains" TARGET hardening_interface)
+ endif()
+ endif()
+endif()
+
+if(REDUCE_EXPORTS)
+ set(CMAKE_CXX_VISIBILITY_PRESET hidden)
+ try_append_linker_flag("-Wl,--exclude-libs,ALL" TARGET core_interface)
+ try_append_linker_flag("-Wl,-no_exported_symbols" VAR CMAKE_EXE_LINKER_FLAGS)
+endif()
+
+if(WERROR)
+ if(MSVC)
+ set(werror_flag "/WX")
+ else()
+ set(werror_flag "-Werror")
+ endif()
+ try_append_cxx_flags(${werror_flag} TARGET core_interface SKIP_LINK RESULT_VAR compiler_supports_werror)
+ if(NOT compiler_supports_werror)
+ message(FATAL_ERROR "WERROR set but ${werror_flag} is not usable.")
+ endif()
+ unset(werror_flag)
+endif()
+
+# Prefer Unix-style package components over frameworks on macOS.
+# This improves compatibility with Python version managers.
+set(Python3_FIND_FRAMEWORK LAST CACHE STRING "")
+# Search for generic names before more specialized ones. This
+# improves compatibility with Python version managers that use shims.
+set(Python3_FIND_UNVERSIONED_NAMES FIRST CACHE STRING "")
+mark_as_advanced(Python3_FIND_FRAMEWORK Python3_FIND_UNVERSIONED_NAMES)
+find_package(Python3 3.10 COMPONENTS Interpreter)
+if(Python3_EXECUTABLE)
+ set(PYTHON_COMMAND ${Python3_EXECUTABLE})
+else()
+ list(APPEND configure_warnings
+ "Minimum required Python not found. Utils and rpcauth tests are disabled."
+ )
+endif()
+
+target_compile_definitions(core_interface INTERFACE ${DEPENDS_COMPILE_DEFINITIONS})
+target_compile_definitions(core_interface_relwithdebinfo INTERFACE ${DEPENDS_COMPILE_DEFINITIONS_RELWITHDEBINFO})
+target_compile_definitions(core_interface_debug INTERFACE ${DEPENDS_COMPILE_DEFINITIONS_DEBUG})
+
+# If the {CXX,LD}FLAGS environment variables are defined during building depends
+# and configuring this build system, their content might be duplicated.
+if(DEFINED ENV{CXXFLAGS})
+ deduplicate_flags(CMAKE_CXX_FLAGS)
+endif()
+if(DEFINED ENV{LDFLAGS})
+ deduplicate_flags(CMAKE_EXE_LINKER_FLAGS)
+endif()
+
+if(BUILD_TESTS)
+ enable_testing()
+endif()
+
+if(CMAKE_VERSION VERSION_GREATER_EQUAL 3.29)
+ # have "make test" depend on "make all"
+ set(CMAKE_SKIP_TEST_ALL_DEPENDENCY FALSE)
+endif()
+
+# TODO: The `CMAKE_SKIP_BUILD_RPATH` variable setting can be deleted
+# in the future after reordering Guix script commands to
+# perform binary checks after the installation step.
+# Relevant discussions:
+# - https://github.com/hebasto/bitcoin/pull/236#issuecomment-2183120953
+# - https://github.com/bitcoin/bitcoin/pull/30312#issuecomment-2191235833
+# NetBSD always requires runtime paths to be set for executables.
+if(CMAKE_SYSTEM_NAME STREQUAL "NetBSD")
+ set(CMAKE_INSTALL_RPATH_USE_LINK_PATH TRUE)
+else()
+ set(CMAKE_SKIP_BUILD_RPATH TRUE)
+ set(CMAKE_SKIP_INSTALL_RPATH TRUE)
+endif()
+add_subdirectory(test)
+add_subdirectory(doc)
+
+add_subdirectory(src)
+
+include(cmake/tests.cmake)
+
+include(Maintenance)
+setup_split_debug_script()
+add_maintenance_targets()
+add_windows_deploy_target()
+add_macos_deploy_target()
+
+message("\n")
+message("Configure summary")
+message("=================")
+message("Executables:")
+message(" bitcoind ............................ ${BUILD_DAEMON}")
+if(BUILD_DAEMON AND WITH_MULTIPROCESS)
+ set(bitcoin_daemon_status ON)
+else()
+ set(bitcoin_daemon_status OFF)
+endif()
+message(" bitcoin-node (multiprocess) ......... ${bitcoin_daemon_status}")
+message(" bitcoin-qt (GUI) .................... ${BUILD_GUI}")
+if(BUILD_GUI AND WITH_MULTIPROCESS)
+ set(bitcoin_gui_status ON)
+else()
+ set(bitcoin_gui_status OFF)
+endif()
+message(" bitcoin-gui (GUI, multiprocess) ..... ${bitcoin_gui_status}")
+message(" bitcoin-cli ......................... ${BUILD_CLI}")
+message(" bitcoin-tx .......................... ${BUILD_TX}")
+message(" bitcoin-util ........................ ${BUILD_UTIL}")
+message(" bitcoin-wallet ...................... ${BUILD_WALLET_TOOL}")
+message(" bitcoin-chainstate (experimental) ... ${BUILD_UTIL_CHAINSTATE}")
+message(" libbitcoinkernel (experimental) ..... ${BUILD_KERNEL_LIB}")
+message("Optional features:")
+message(" wallet support ...................... ${ENABLE_WALLET}")
+if(ENABLE_WALLET)
+ message(" - legacy wallets (Berkeley DB) ..... ${WITH_BDB}")
+endif()
+message(" external signer ..................... ${ENABLE_EXTERNAL_SIGNER}")
+message(" ZeroMQ .............................. ${WITH_ZMQ}")
+message(" USDT tracing ........................ ${WITH_USDT}")
+message(" QR code (GUI) ....................... ${WITH_QRENCODE}")
+message(" DBus (GUI, Linux only) .............. ${WITH_DBUS}")
+message("Tests:")
+message(" test_bitcoin ........................ ${BUILD_TESTS}")
+message(" test_bitcoin-qt ..................... ${BUILD_GUI_TESTS}")
+message(" bench_bitcoin ....................... ${BUILD_BENCH}")
+message(" fuzz binary ......................... ${BUILD_FUZZ_BINARY}")
+message("")
+if(CMAKE_CROSSCOMPILING)
+ set(cross_status "TRUE, for ${CMAKE_SYSTEM_NAME}, ${CMAKE_SYSTEM_PROCESSOR}")
+else()
+ set(cross_status "FALSE")
+endif()
+message("Cross compiling ....................... ${cross_status}")
+message("C++ compiler .......................... ${CMAKE_CXX_COMPILER_ID} ${CMAKE_CXX_COMPILER_VERSION}, ${CMAKE_CXX_COMPILER}")
+include(FlagsSummary)
+flags_summary()
+message("Attempt to harden executables ......... ${ENABLE_HARDENING}")
+message("Treat compiler warnings as errors ..... ${WERROR}")
+message("Use ccache for compiling .............. ${WITH_CCACHE}")
+message("\n")
+if(configure_warnings)
+ message(" ******\n")
+ foreach(warning IN LISTS configure_warnings)
+ message(WARNING "${warning}")
+ endforeach()
+ message(" ******\n")
+endif()
+
+# We want all build properties to be encapsulated properly.
+include(WarnAboutGlobalProperties)
diff --git a/CMakePresets.json b/CMakePresets.json
new file mode 100644
index 00000000..31cba7e3
--- /dev/null
+++ b/CMakePresets.json
@@ -0,0 +1,91 @@
+{
+ "version": 3,
+ "cmakeMinimumRequired": {"major": 3, "minor": 21, "patch": 0},
+ "configurePresets": [
+ {
+ "name": "vs2022",
+ "displayName": "Build using 'Visual Studio 17 2022' generator and 'x64-windows' triplet",
+ "condition": {
+ "type": "equals",
+ "lhs": "${hostSystemName}",
+ "rhs": "Windows"
+ },
+ "generator": "Visual Studio 17 2022",
+ "architecture": "x64",
+ "toolchainFile": "$env{VCPKG_ROOT}\\scripts\\buildsystems\\vcpkg.cmake",
+ "cacheVariables": {
+ "VCPKG_TARGET_TRIPLET": "x64-windows",
+ "BUILD_GUI": "ON"
+ }
+ },
+ {
+ "name": "vs2022-static",
+ "displayName": "Build using 'Visual Studio 17 2022' generator and 'x64-windows-static' triplet",
+ "condition": {
+ "type": "equals",
+ "lhs": "${hostSystemName}",
+ "rhs": "Windows"
+ },
+ "generator": "Visual Studio 17 2022",
+ "architecture": "x64",
+ "toolchainFile": "$env{VCPKG_ROOT}\\scripts\\buildsystems\\vcpkg.cmake",
+ "cacheVariables": {
+ "VCPKG_TARGET_TRIPLET": "x64-windows-static",
+ "BUILD_GUI": "ON"
+ }
+ },
+ {
+ "name": "libfuzzer",
+ "displayName": "Build for fuzzing with libfuzzer, and sanitizers enabled",
+ "binaryDir": "${sourceDir}/build_fuzz",
+ "cacheVariables": {
+ "BUILD_FOR_FUZZING": "ON",
+ "CMAKE_C_COMPILER": "clang",
+ "CMAKE_C_FLAGS": "-ftrivial-auto-var-init=pattern",
+ "CMAKE_CXX_COMPILER": "clang++",
+ "CMAKE_CXX_FLAGS": "-ftrivial-auto-var-init=pattern",
+ "SANITIZERS": "undefined,address,fuzzer"
+ }
+ },
+ {
+ "name": "libfuzzer-nosan",
+ "displayName": "Build for fuzzing with libfuzzer, and sanitizers disabled",
+ "binaryDir": "${sourceDir}/build_fuzz_nosan",
+ "cacheVariables": {
+ "BUILD_FOR_FUZZING": "ON",
+ "CMAKE_C_COMPILER": "clang",
+ "CMAKE_CXX_COMPILER": "clang++",
+ "SANITIZERS": "fuzzer"
+ }
+ },
+ {
+ "name": "dev-mode",
+ "displayName": "Developer mode, with all features/dependencies enabled",
+ "binaryDir": "${sourceDir}/build_dev_mode",
+ "cacheVariables": {
+ "BUILD_BENCH": "ON",
+ "BUILD_CLI": "ON",
+ "BUILD_DAEMON": "ON",
+ "BUILD_FUZZ_BINARY": "ON",
+ "BUILD_GUI": "ON",
+ "BUILD_GUI_TESTS": "ON",
+ "BUILD_KERNEL_LIB": "ON",
+ "BUILD_SHARED_LIBS": "ON",
+ "BUILD_TESTS": "ON",
+ "BUILD_TX": "ON",
+ "BUILD_UTIL": "ON",
+ "BUILD_UTIL_CHAINSTATE": "ON",
+ "BUILD_WALLET_TOOL": "ON",
+ "ENABLE_EXTERNAL_SIGNER": "ON",
+ "ENABLE_HARDENING": "ON",
+ "ENABLE_WALLET": "ON",
+ "WARN_INCOMPATIBLE_BDB": "OFF",
+ "WITH_BDB": "ON",
+ "WITH_MULTIPROCESS": "ON",
+ "WITH_QRENCODE": "ON",
+ "WITH_USDT": "ON",
+ "WITH_ZMQ": "ON"
+ }
+ }
+ ]
+}
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 00000000..25637b40
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,443 @@
+Contributing to Bitcoin Core
+============================
+
+The Bitcoin Core project operates an open contributor model where anyone is
+welcome to contribute towards development in the form of peer review, testing
+and patches. This document explains the practical process and guidelines for
+contributing.
+
+First, in terms of structure, there is no particular concept of "Bitcoin Core
+developers" in the sense of privileged people. Open source often naturally
+revolves around a meritocracy where contributors earn trust from the developer
+community over time. Nevertheless, some hierarchy is necessary for practical
+purposes. As such, there are repository maintainers who are responsible for
+merging pull requests, the [release cycle](/doc/release-process.md), and
+moderation.
+
+Getting Started
+---------------
+
+New contributors are very welcome and needed.
+
+Reviewing and testing is highly valued and the most effective way you can contribute
+as a new contributor. It also will teach you much more about the code and
+process than opening pull requests. Please refer to the [peer review](#peer-review)
+section below.
+
+Before you start contributing, familiarize yourself with the Bitcoin Core build
+system and tests. Refer to the documentation in the repository on how to build
+Bitcoin Core and how to run the unit tests, functional tests, and fuzz tests.
+
+There are many open issues of varying difficulty waiting to be fixed.
+If you're looking for somewhere to start contributing, check out the
+[good first issue](https://github.com/bitcoin/bitcoin/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)
+list or changes that are
+[up for grabs](https://github.com/bitcoin/bitcoin/issues?utf8=%E2%9C%93&q=label%3A%22Up+for+grabs%22).
+Some of them might no longer be applicable. So if you are interested, but
+unsure, you might want to leave a comment on the issue first.
+
+You may also participate in the [Bitcoin Core PR Review Club](https://bitcoincore.reviews/).
+
+### Good First Issue Label
+
+The purpose of the `good first issue` label is to highlight which issues are
+suitable for a new contributor without a deep understanding of the codebase.
+
+However, good first issues can be solved by anyone. If they remain unsolved
+for a longer time, a frequent contributor might address them.
+
+You do not need to request permission to start working on an issue. However,
+you are encouraged to leave a comment if you are planning to work on it. This
+will help other contributors monitor which issues are actively being addressed
+and is also an effective way to request assistance if and when you need it.
+
+Communication Channels
+----------------------
+
+Most communication about Bitcoin Core development happens on IRC, in the
+`#bitcoin-core-dev` channel on Libera Chat. The easiest way to participate on IRC is
+with the web client, [web.libera.chat](https://web.libera.chat/#bitcoin-core-dev). Chat
+history logs can be found
+on [https://www.erisian.com.au/bitcoin-core-dev/](https://www.erisian.com.au/bitcoin-core-dev/)
+and [https://gnusha.org/bitcoin-core-dev/](https://gnusha.org/bitcoin-core-dev/).
+
+Discussion about codebase improvements happens in GitHub issues and pull
+requests.
+
+The developer
+[mailing list](https://groups.google.com/g/bitcoindev)
+should be used to discuss complicated or controversial consensus or P2P protocol changes before working on
+a patch set.
+Archives can be found on [https://gnusha.org/pi/bitcoindev/](https://gnusha.org/pi/bitcoindev/).
+
+
+Contributor Workflow
+--------------------
+
+The codebase is maintained using the "contributor workflow" where everyone
+without exception contributes patch proposals using "pull requests" (PRs). This
+facilitates social contribution, easy testing and peer review.
+
+To contribute a patch, the workflow is as follows:
+
+ 1. Fork repository ([only for the first time](https://docs.github.com/en/get-started/quickstart/fork-a-repo))
+ 1. Create topic branch
+ 1. Commit patches
+
+For GUI-related issues or pull requests, the https://github.com/bitcoin-core/gui repository should be used.
+For all other issues and pull requests, the https://github.com/bitcoin/bitcoin node repository should be used.
+
+The master branch for all monotree repositories is identical.
+
+As a rule of thumb, everything that only modifies `src/qt` is a GUI-only pull
+request. However:
+
+* For global refactoring or other transversal changes the node repository
+ should be used.
+* For GUI-related build system changes, the node repository should be used
+ because the change needs review by the build systems reviewers.
+* Changes in `src/interfaces` need to go to the node repository because they
+ might affect other components like the wallet.
+
+For large GUI changes that include build system and interface changes, it is
+recommended to first open a pull request against the GUI repository. When there
+is agreement to proceed with the changes, a pull request with the build system
+and interfaces changes can be submitted to the node repository.
+
+The project coding conventions in the [developer notes](doc/developer-notes.md)
+must be followed.
+
+### Committing Patches
+
+In general, [commits should be atomic](https://en.wikipedia.org/wiki/Atomic_commit#Atomic_commit_convention)
+and diffs should be easy to read. For this reason, do not mix any formatting
+fixes or code moves with actual code changes.
+
+Make sure each individual commit is hygienic: that it builds successfully on its
+own without warnings, errors, regressions, or test failures.
+
+Commit messages should be verbose by default consisting of a short subject line
+(50 chars max), a blank line and detailed explanatory text as separate
+paragraph(s), unless the title alone is self-explanatory (like "Correct typo
+in init.cpp") in which case a single title line is sufficient. Commit messages should be
+helpful to people reading your code in the future, so explain the reasoning for
+your decisions. Further explanation [here](https://chris.beams.io/posts/git-commit/).
+
+If a particular commit references another issue, please add the reference. For
+example: `refs #1234` or `fixes #4321`. Using the `fixes` or `closes` keywords
+will cause the corresponding issue to be closed when the pull request is merged.
+
+Commit messages should never contain any `@` mentions (usernames prefixed with "@").
+
+Please refer to the [Git manual](https://git-scm.com/doc) for more information
+about Git.
+
+ - Push changes to your fork
+ - Create pull request
+
+### Creating the Pull Request
+
+The title of the pull request should be prefixed by the component or area that
+the pull request affects. Valid areas as:
+
+ - `consensus` for changes to consensus critical code
+ - `doc` for changes to the documentation
+ - `qt` or `gui` for changes to bitcoin-qt
+ - `log` for changes to log messages
+ - `mining` for changes to the mining code
+ - `net` or `p2p` for changes to the peer-to-peer network code
+ - `refactor` for structural changes that do not change behavior
+ - `rpc`, `rest` or `zmq` for changes to the RPC, REST or ZMQ APIs
+ - `contrib` or `cli` for changes to the scripts and tools
+ - `test`, `qa` or `ci` for changes to the unit tests, QA tests or CI code
+ - `util` or `lib` for changes to the utils or libraries
+ - `wallet` for changes to the wallet code
+ - `build` for changes to CMake
+ - `guix` for changes to the GUIX reproducible builds
+
+Examples:
+
+ consensus: Add new opcode for BIP-XXXX OP_CHECKAWESOMESIG
+ net: Automatically create onion service, listen on Tor
+ qt: Add feed bump button
+ log: Fix typo in log message
+
+The body of the pull request should contain sufficient description of *what* the
+patch does, and even more importantly, *why*, with justification and reasoning.
+You should include references to any discussions (for example, other issues or
+mailing list discussions).
+
+The description for a new pull request should not contain any `@` mentions. The
+PR description will be included in the commit message when the PR is merged and
+any users mentioned in the description will be annoyingly notified each time a
+fork of Bitcoin Core copies the merge. Instead, make any username mentions in a
+subsequent comment to the PR.
+
+### Translation changes
+
+Note that translations should not be submitted as pull requests. Please see
+[Translation Process](https://github.com/bitcoin/bitcoin/blob/master/doc/translation_process.md)
+for more information on helping with translations.
+
+### Work in Progress Changes and Requests for Comments
+
+If a pull request is not to be considered for merging (yet), please
+prefix the title with [WIP] or use [Tasks Lists](https://docs.github.com/en/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#task-lists)
+in the body of the pull request to indicate tasks are pending.
+
+### Address Feedback
+
+At this stage, one should expect comments and review from other contributors. You
+can add more commits to your pull request by committing them locally and pushing
+to your fork.
+
+You are expected to reply to any review comments before your pull request is
+merged. You may update the code or reject the feedback if you do not agree with
+it, but you should express so in a reply. If there is outstanding feedback and
+you are not actively working on it, your pull request may be closed.
+
+Please refer to the [peer review](#peer-review) section below for more details.
+
+### Squashing Commits
+
+If your pull request contains fixup commits (commits that change the same line of code repeatedly) or too fine-grained
+commits, you may be asked to [squash](https://git-scm.com/docs/git-rebase#_interactive_mode) your commits
+before it will be reviewed. The basic squashing workflow is shown below.
+
+ git checkout your_branch_name
+ git rebase -i HEAD~n
+ # n is normally the number of commits in the pull request.
+ # Set commits (except the one in the first line) from 'pick' to 'squash', save and quit.
+ # On the next screen, edit/refine commit messages.
+ # Save and quit.
+ git push -f # (force push to GitHub)
+
+Please update the resulting commit message, if needed. It should read as a
+coherent message. In most cases, this means not just listing the interim
+commits.
+
+If your change contains a merge commit, the above workflow may not work and you
+will need to remove the merge commit first. See the next section for details on
+how to rebase.
+
+Please refrain from creating several pull requests for the same change.
+Use the pull request that is already open (or was created earlier) to amend
+changes. This preserves the discussion and review that happened earlier for
+the respective change set.
+
+The length of time required for peer review is unpredictable and will vary from
+pull request to pull request.
+
+### Rebasing Changes
+
+When a pull request conflicts with the target branch, you may be asked to rebase it on top of the current target branch.
+
+ git fetch https://github.com/bitcoin/bitcoin # Fetch the latest upstream commit
+ git rebase FETCH_HEAD # Rebuild commits on top of the new base
+
+This project aims to have a clean git history, where code changes are only made in non-merge commits. This simplifies
+auditability because merge commits can be assumed to not contain arbitrary code changes. Merge commits should be signed,
+and the resulting git tree hash must be deterministic and reproducible. The script in
+[/contrib/verify-commits](/contrib/verify-commits) checks that.
+
+After a rebase, reviewers are encouraged to sign off on the force push. This should be relatively straightforward with
+the `git range-diff` tool explained in the [productivity
+notes](/doc/productivity.md#diff-the-diffs-with-git-range-diff). To avoid needless review churn, maintainers will
+generally merge pull requests that received the most review attention first.
+
+Pull Request Philosophy
+-----------------------
+
+Patchsets should always be focused. For example, a pull request could add a
+feature, fix a bug, or refactor code; but not a mixture. Please also avoid super
+pull requests which attempt to do too much, are overly large, or overly complex
+as this makes review difficult.
+
+
+### Features
+
+When adding a new feature, thought must be given to the long term technical debt
+and maintenance that feature may require after inclusion. Before proposing a new
+feature that will require maintenance, please consider if you are willing to
+maintain it (including bug fixing). If features get orphaned with no maintainer
+in the future, they may be removed by the Repository Maintainer.
+
+
+### Refactoring
+
+Refactoring is a necessary part of any software project's evolution. The
+following guidelines cover refactoring pull requests for the project.
+
+There are three categories of refactoring: code-only moves, code style fixes, and
+code refactoring. In general, refactoring pull requests should not mix these
+three kinds of activities in order to make refactoring pull requests easy to
+review and uncontroversial. In all cases, refactoring PRs must not change the
+behaviour of code within the pull request (bugs must be preserved as is).
+
+Project maintainers aim for a quick turnaround on refactoring pull requests, so
+where possible keep them short, uncomplex and easy to verify.
+
+Pull requests that refactor the code should not be made by new contributors. It
+requires a certain level of experience to know where the code belongs to and to
+understand the full ramification (including rebase effort of open pull requests).
+
+Trivial pull requests or pull requests that refactor the code with no clear
+benefits may be immediately closed by the maintainers to reduce unnecessary
+workload on reviewing.
+
+
+"Decision Making" Process
+-------------------------
+
+The following applies to code changes to the Bitcoin Core project (and related
+projects such as libsecp256k1), and is not to be confused with overall Bitcoin
+Network Protocol consensus changes.
+
+Whether a pull request is merged into Bitcoin Core rests with the project merge
+maintainers.
+
+Maintainers will take into consideration if a patch is in line with the general
+principles of the project; meets the minimum standards for inclusion; and will
+judge the general consensus of contributors.
+
+In general, all pull requests must:
+
+ - Have a clear use case, fix a demonstrable bug or serve the greater good of
+ the project (for example refactoring for modularisation);
+ - Be well peer-reviewed;
+ - Have unit tests, functional tests, and fuzz tests, where appropriate;
+ - Follow code style guidelines ([C++](doc/developer-notes.md), [functional tests](test/functional/README.md));
+ - Not break the existing test suite;
+ - Where bugs are fixed, where possible, there should be unit tests
+ demonstrating the bug and also proving the fix. This helps prevent regression.
+ - Change relevant comments and documentation when behaviour of code changes.
+
+Patches that change Bitcoin consensus rules are considerably more involved than
+normal because they affect the entire ecosystem and so must be preceded by
+extensive mailing list discussions and have a numbered BIP. While each case will
+be different, one should be prepared to expend more time and effort than for
+other kinds of patches because of increased peer review and consensus building
+requirements.
+
+
+### Peer Review
+
+Anyone may participate in peer review which is expressed by comments in the pull
+request. Typically reviewers will review the code for obvious errors, as well as
+test out the patch set and opine on the technical merits of the patch. Project
+maintainers take into account the peer review when determining if there is
+consensus to merge a pull request (remember that discussions may have been
+spread out over GitHub, mailing list and IRC discussions).
+
+Code review is a burdensome but important part of the development process, and
+as such, certain types of pull requests are rejected. In general, if the
+**improvements** do not warrant the **review effort** required, the PR has a
+high chance of being rejected. It is up to the PR author to convince the
+reviewers that the changes warrant the review effort, and if reviewers are
+"Concept NACK'ing" the PR, the author may need to present arguments and/or do
+research backing their suggested changes.
+
+#### Conceptual Review
+
+A review can be a conceptual review, where the reviewer leaves a comment
+ * `Concept (N)ACK`, meaning "I do (not) agree with the general goal of this pull
+ request",
+ * `Approach (N)ACK`, meaning `Concept ACK`, but "I do (not) agree with the
+ approach of this change".
+
+A `NACK` needs to include a rationale why the change is not worthwhile.
+NACKs without accompanying reasoning may be disregarded.
+
+#### Code Review
+
+After conceptual agreement on the change, code review can be provided. A review
+begins with `ACK BRANCH_COMMIT`, where `BRANCH_COMMIT` is the top of the PR
+branch, followed by a description of how the reviewer did the review. The
+following language is used within pull request comments:
+
+ - "I have tested the code", involving change-specific manual testing in
+ addition to running the unit, functional, or fuzz tests, and in case it is
+ not obvious how the manual testing was done, it should be described;
+ - "I have not tested the code, but I have reviewed it and it looks
+ OK, I agree it can be merged";
+ - A "nit" refers to a trivial, often non-blocking issue.
+
+Project maintainers reserve the right to weigh the opinions of peer reviewers
+using common sense judgement and may also weigh based on merit. Reviewers that
+have demonstrated a deeper commitment and understanding of the project over time
+or who have clear domain expertise may naturally have more weight, as one would
+expect in all walks of life.
+
+Where a patch set affects consensus-critical code, the bar will be much
+higher in terms of discussion and peer review requirements, keeping in mind that
+mistakes could be very costly to the wider community. This includes refactoring
+of consensus-critical code.
+
+Where a patch set proposes to change the Bitcoin consensus, it must have been
+discussed extensively on the mailing list and IRC, be accompanied by a widely
+discussed BIP and have a generally widely perceived technical consensus of being
+a worthwhile change based on the judgement of the maintainers.
+
+### Finding Reviewers
+
+As most reviewers are themselves developers with their own projects, the review
+process can be quite lengthy, and some amount of patience is required. If you find
+that you've been waiting for a pull request to be given attention for several
+months, there may be a number of reasons for this, some of which you can do something
+about:
+
+ - It may be because of a feature freeze due to an upcoming release. During this time,
+ only bug fixes are taken into consideration. If your pull request is a new feature,
+ it will not be prioritized until after the release. Wait for the release.
+ - It may be because the changes you are suggesting do not appeal to people. Rather than
+ nits and critique, which require effort and means they care enough to spend time on your
+ contribution, thundering silence is a good sign of widespread (mild) dislike of a given change
+ (because people don't assume *others* won't actually like the proposal). Don't take
+ that personally, though! Instead, take another critical look at what you are suggesting
+ and see if it: changes too much, is too broad, doesn't adhere to the
+ [developer notes](doc/developer-notes.md), is dangerous or insecure, is messily written, etc.
+ Identify and address any of the issues you find. Then ask e.g. on IRC if someone could give
+ their opinion on the concept itself.
+ - It may be because your code is too complex for all but a few people, and those people
+ may not have realized your pull request even exists. A great way to find people who
+ are qualified and care about the code you are touching is the
+ [Git Blame feature](https://docs.github.com/en/github/managing-files-in-a-repository/managing-files-on-github/tracking-changes-in-a-file). Simply
+ look up who last modified the code you are changing and see if you can find
+ them and give them a nudge. Don't be incessant about the nudging, though.
+ - Finally, if all else fails, ask on IRC or elsewhere for someone to give your pull request
+ a look. If you think you've been waiting for an unreasonably long time (say,
+ more than a month) for no particular reason (a few lines changed, etc.),
+ this is totally fine. Try to return the favor when someone else is asking
+ for feedback on their code, and the universe balances out.
+ - Remember that the best thing you can do while waiting is give review to others!
+
+
+Backporting
+-----------
+
+Security and bug fixes can be backported from `master` to release
+branches.
+Maintainers will do backports in batches and
+use the proper `Needs backport (...)` labels
+when needed (the original author does not need to worry about it).
+
+A backport should contain the following metadata in the commit body:
+
+```
+Github-Pull: #<PR number>
+Rebased-From: <commit hash of the original commit>
+```
+
+Have a look at [an example backport PR](
+https://github.com/bitcoin/bitcoin/pull/16189).
+
+Also see the [backport.py script](
+https://github.com/bitcoin-core/bitcoin-maintainer-tools#backport).
+
+Copyright
+---------
+
+By contributing to this repository, you agree to license your work under the
+MIT license unless specified otherwise in `contrib/debian/copyright` or at
+the top of the file itself. Any work contributed where you are not the original
+author must contain its license header with the original author(s) and source.
diff --git a/COPYING b/COPYING
new file mode 100644
index 00000000..23dc5e90
--- /dev/null
+++ b/COPYING
@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2009-2025 The Bitcoin Core developers
+Copyright (c) 2009-2025 Bitcoin Developers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
diff --git a/INSTALL.md b/INSTALL.md
new file mode 100644
index 00000000..4cead030
--- /dev/null
+++ b/INSTALL.md
@@ -0,0 +1 @@
+See [doc/build-\*.md](/doc)
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100644
index 00000000..c5b6ce45
--- /dev/null
+++ b/README.md
@@ -0,0 +1,79 @@
+Bitcoin Core integration/staging tree
+=====================================
+
+https://bitcoincore.org
+
+For an immediately usable, binary version of the Bitcoin Core software, see
+https://bitcoincore.org/en/download/.
+
+What is Bitcoin Core?
+---------------------
+
+Bitcoin Core connects to the Bitcoin peer-to-peer network to download and fully
+validate blocks and transactions. It also includes a wallet and graphical user
+interface, which can be optionally built.
+
+Further information about Bitcoin Core is available in the [doc folder](/doc).
+
+License
+-------
+
+Bitcoin Core is released under the terms of the MIT license. See [COPYING](COPYING) for more
+information or see https://opensource.org/licenses/MIT.
+
+Development Process
+-------------------
+
+The `master` branch is regularly built (see `doc/build-*.md` for instructions) and tested, but it is not guaranteed to be
+completely stable. [Tags](https://github.com/bitcoin/bitcoin/tags) are created
+regularly from release branches to indicate new official, stable release versions of Bitcoin Core.
+
+The https://github.com/bitcoin-core/gui repository is used exclusively for the
+development of the GUI. Its master branch is identical in all monotree
+repositories. Release branches and tags do not exist, so please do not fork
+that repository unless it is for development reasons.
+
+The contribution workflow is described in [CONTRIBUTING.md](CONTRIBUTING.md)
+and useful hints for developers can be found in [doc/developer-notes.md](doc/developer-notes.md).
+
+Testing
+-------
+
+Testing and code review is the bottleneck for development; we get more pull
+requests than we can review and test on short notice. Please be patient and help out by testing
+other people's pull requests, and remember this is a security-critical project where any mistake might cost people
+lots of money.
+
+### Automated Testing
+
+Developers are strongly encouraged to write [unit tests](src/test/README.md) for new code, and to
+submit new unit tests for old code. Unit tests can be compiled and run
+(assuming they weren't disabled during the generation of the build system) with: `ctest`. Further details on running
+and extending unit tests can be found in [/src/test/README.md](/src/test/README.md).
+
+There are also [regression and integration tests](/test), written
+in Python.
+These tests can be run (if the [test dependencies](/test) are installed) with: `build/test/functional/test_runner.py`
+(assuming `build` is your build directory).
+
+The CI (Continuous Integration) systems make sure that every pull request is built for Windows, Linux, and macOS,
+and that unit/sanity tests are run automatically.
+
+### Manual Quality Assurance (QA) Testing
+
+Changes should be tested by somebody other than the developer who wrote the
+code. This is especially important for large or high-risk changes. It is useful
+to add a test plan to the pull request description if testing the changes is
+not straightforward.
+
+Translations
+------------
+
+Changes to translations as well as new translations can be submitted to
+[Bitcoin Core's Transifex page](https://www.transifex.com/bitcoin/bitcoin/).
+
+Translations are periodically pulled from Transifex and merged into the git repository. See the
+[translation process](doc/translation_process.md) for details on how this works.
+
+**Important**: We do not accept translation changes as GitHub pull requests because the next
+pull from Transifex would automatically overwrite them again.
diff --git a/SECURITY.md b/SECURITY.md
new file mode 100644
index 00000000..fd4c61d1
--- /dev/null
+++ b/SECURITY.md
@@ -0,0 +1,20 @@
+# Security Policy
+
+## Supported Versions
+
+See our website for versions of Bitcoin Core that are currently supported with
+security updates: https://bitcoincore.org/en/lifecycle/#schedule
+
+## Reporting a Vulnerability
+
+To report security issues send an email to security@bitcoincore.org (not for support).
+
+The following keys may be used to communicate sensitive information to developers:
+
+| Name | Fingerprint |
+|------|-------------|
+| Pieter Wuille | 133E AC17 9436 F14A 5CF1 B794 860F EB80 4E66 9320 |
+| Michael Ford | E777 299F C265 DD04 7930 70EB 944D 35F9 AC3D B76A |
+| Ava Chow | 1528 1230 0785 C964 44D3 334D 1756 5732 E08E 5E41 |
+
+You can import a key by running the following command with that individual’s fingerprint: `gpg --keyserver hkps://keys.openpgp.org --recv-keys "<fingerprint>"` Ensure that you put quotes around fingerprints containing spaces.
diff --git a/ci/README.md b/ci/README.md
new file mode 100644
index 00000000..377aae7f
--- /dev/null
+++ b/ci/README.md
@@ -0,0 +1,56 @@
+## CI Scripts
+
+This directory contains scripts for each build step in each build stage.
+
+### Running a Stage Locally
+
+Be aware that the tests will be built and run in-place, so please run at your own risk.
+If the repository is not a fresh git clone, you might have to clean files from previous builds or test runs first.
+
+The ci needs to perform various sysadmin tasks such as installing packages or writing to the user's home directory.
+While it should be fine to run
+the ci system locally on your development box, the ci scripts can generally be assumed to have received less review and
+testing compared to other parts of the codebase. If you want to keep the work tree clean, you might want to run the ci
+system in a virtual machine with a Linux operating system of your choice.
+
+To allow for a wide range of tested environments, but also ensure reproducibility to some extent, the test stage
+requires `bash`, `docker`, and `python3` to be installed. To run on different architectures than the host `qemu` is also required. To install all requirements on Ubuntu, run
+
+```
+sudo apt install bash docker.io python3 qemu-user-static
+```
+
+It is recommended to run the ci system in a clean env. To run the test stage
+with a specific configuration,
+
+```
+env -i HOME="$HOME" PATH="$PATH" USER="$USER" bash -c 'FILE_ENV="./ci/test/00_setup_env_arm.sh" ./ci/test_run_all.sh'
+```
+
+### Configurations
+
+The test files (`FILE_ENV`) are constructed to test a wide range of
+configurations, rather than a single pass/fail. This helps to catch build
+failures and logic errors that present on platforms other than the ones the
+author has tested.
+
+Some builders use the dependency-generator in `./depends`, rather than using
+the system package manager to install build dependencies. This guarantees that
+the tester is using the same versions as the release builds, which also use
+`./depends`.
+
+It is also possible to force a specific configuration without modifying the
+file. For example,
+
+```
+env -i HOME="$HOME" PATH="$PATH" USER="$USER" bash -c 'MAKEJOBS="-j1" FILE_ENV="./ci/test/00_setup_env_arm.sh" ./ci/test_run_all.sh'
+```
+
+The files starting with `0n` (`n` greater than 0) are the scripts that are run
+in order.
+
+### Cache
+
+In order to avoid rebuilding all dependencies for each build, the binaries are
+cached and reused when possible. Changes in the dependency-generator will
+trigger cache-invalidation and rebuilds as necessary.
diff --git a/ci/lint/04_install.sh b/ci/lint/04_install.sh
new file mode 100755
index 00000000..9ef1f37c
--- /dev/null
+++ b/ci/lint/04_install.sh
@@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2018-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C
+
+export CI_RETRY_EXE="/ci_retry --"
+
+pushd "/"
+
+${CI_RETRY_EXE} apt-get update
+# Lint dependencies:
+# - curl/xz-utils (to install shellcheck)
+# - git (used in many lint scripts)
+# - gpg (used by verify-commits)
+${CI_RETRY_EXE} apt-get install -y curl xz-utils git gpg
+
+PYTHON_PATH="/python_build"
+if [ ! -d "${PYTHON_PATH}/bin" ]; then
+ (
+ ${CI_RETRY_EXE} git clone --depth=1 https://github.com/pyenv/pyenv.git
+ cd pyenv/plugins/python-build || exit 1
+ ./install.sh
+ )
+ # For dependencies see https://github.com/pyenv/pyenv/wiki#suggested-build-environment
+ ${CI_RETRY_EXE} apt-get install -y build-essential libssl-dev zlib1g-dev \
+ libbz2-dev libreadline-dev libsqlite3-dev curl llvm \
+ libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev \
+ clang
+ env CC=clang python-build "$(cat "/.python-version")" "${PYTHON_PATH}"
+fi
+export PATH="${PYTHON_PATH}/bin:${PATH}"
+command -v python3
+python3 --version
+
+export LINT_RUNNER_PATH="/lint_test_runner"
+if [ ! -d "${LINT_RUNNER_PATH}" ]; then
+ ${CI_RETRY_EXE} apt-get install -y cargo
+ (
+ cd "/test/lint/test_runner" || exit 1
+ cargo build
+ mkdir -p "${LINT_RUNNER_PATH}"
+ mv target/debug/test_runner "${LINT_RUNNER_PATH}"
+ )
+fi
+
+${CI_RETRY_EXE} pip3 install \
+ codespell==2.2.6 \
+ lief==0.13.2 \
+ mypy==1.4.1 \
+ pyzmq==25.1.0 \
+ ruff==0.5.5 \
+ vulture==2.6
+
+SHELLCHECK_VERSION=v0.8.0
+curl -sL "https://github.com/koalaman/shellcheck/releases/download/${SHELLCHECK_VERSION}/shellcheck-${SHELLCHECK_VERSION}.linux.x86_64.tar.xz" | \
+ tar --xz -xf - --directory /tmp/
+mv "/tmp/shellcheck-${SHELLCHECK_VERSION}/shellcheck" /usr/bin/
+
+MLC_VERSION=v0.19.0
+MLC_BIN=mlc-x86_64-linux
+curl -sL "https://github.com/becheran/mlc/releases/download/${MLC_VERSION}/${MLC_BIN}" -o "/usr/bin/mlc"
+chmod +x /usr/bin/mlc
+
+popd || exit
diff --git a/ci/lint/06_script.sh b/ci/lint/06_script.sh
new file mode 100755
index 00000000..7e271970
--- /dev/null
+++ b/ci/lint/06_script.sh
@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2018-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C
+
+set -ex
+
+if [ -n "$CIRRUS_PR" ]; then
+ export COMMIT_RANGE="HEAD~..HEAD"
+ if [ "$(git rev-list -1 HEAD)" != "$(git rev-list -1 --merges HEAD)" ]; then
+ echo "Error: The top commit must be a merge commit, usually the remote 'pull/${PR_NUMBER}/merge' branch."
+ false
+ fi
+fi
+
+RUST_BACKTRACE=1 "${LINT_RUNNER_PATH}/test_runner"
+
+if [ "$CIRRUS_REPO_FULL_NAME" = "bitcoin/bitcoin" ] && [ "$CIRRUS_PR" = "" ] ; then
+ # Sanity check only the last few commits to get notified of missing sigs,
+ # missing keys, or expired keys. Usually there is only one new merge commit
+ # per push on the master branch and a few commits on release branches, so
+ # sanity checking only a few (10) commits seems sufficient and cheap.
+ git log HEAD~10 -1 --format='%H' > ./contrib/verify-commits/trusted-sha512-root-commit
+ git log HEAD~10 -1 --format='%H' > ./contrib/verify-commits/trusted-git-root
+ mapfile -t KEYS < contrib/verify-commits/trusted-keys
+ git config user.email "ci@ci.ci"
+ git config user.name "ci"
+ ${CI_RETRY_EXE} gpg --keyserver hkps://keys.openpgp.org --recv-keys "${KEYS[@]}" &&
+ ./contrib/verify-commits/verify-commits.py;
+fi
diff --git a/ci/lint/container-entrypoint.sh b/ci/lint/container-entrypoint.sh
new file mode 100755
index 00000000..c8519a39
--- /dev/null
+++ b/ci/lint/container-entrypoint.sh
@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or https://opensource.org/license/mit/.
+
+export LC_ALL=C
+
+# Fixes permission issues when there is a container UID/GID mismatch with the owner
+# of the mounted bitcoin src dir.
+git config --global --add safe.directory /bitcoin
+
+export PATH="/python_build/bin:${PATH}"
+export LINT_RUNNER_PATH="/lint_test_runner"
+
+if [ -z "$1" ]; then
+ bash -ic "./ci/lint/06_script.sh"
+else
+ exec "$@"
+fi
diff --git a/ci/lint_imagefile b/ci/lint_imagefile
new file mode 100644
index 00000000..c05f2108
--- /dev/null
+++ b/ci/lint_imagefile
@@ -0,0 +1,25 @@
+# Copyright (c) The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or https://opensource.org/license/mit/.
+
+# See test/lint/README.md for usage.
+
+FROM mirror.gcr.io/debian:bookworm
+
+ENV DEBIAN_FRONTEND=noninteractive
+ENV LC_ALL=C.UTF-8
+
+COPY ./ci/retry/retry /ci_retry
+COPY ./.python-version /.python-version
+COPY ./ci/lint/container-entrypoint.sh /entrypoint.sh
+COPY ./ci/lint/04_install.sh /install.sh
+COPY ./test/lint/test_runner /test/lint/test_runner
+
+RUN /install.sh && \
+ echo 'alias lint="./ci/lint/06_script.sh"' >> ~/.bashrc && \
+ chmod 755 /entrypoint.sh && \
+ rm -rf /var/lib/apt/lists/*
+
+
+WORKDIR /bitcoin
+ENTRYPOINT ["/entrypoint.sh"]
diff --git a/ci/lint_run.sh b/ci/lint_run.sh
new file mode 100755
index 00000000..319cdc21
--- /dev/null
+++ b/ci/lint_run.sh
@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+set -o errexit -o pipefail -o xtrace
+
+# Only used in .cirrus.yml. Refer to test/lint/README.md on how to run locally.
+export PATH="/python_build/bin:${PATH}"
+export LINT_RUNNER_PATH="/lint_test_runner"
+./ci/lint/06_script.sh
diff --git a/ci/lint_run_all.sh b/ci/lint_run_all.sh
new file mode 100755
index 00000000..ab3f4392
--- /dev/null
+++ b/ci/lint_run_all.sh
@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2019-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+# Only used in .cirrus.yml for stale re-runs of old pull request tasks. This
+# file can be removed in September 2025.
+
+cp "./ci/retry/retry" "/ci_retry"
+cp "./.python-version" "/.python-version"
+mkdir --parents "/test/lint"
+cp --recursive "./test/lint/test_runner" "/test/lint/"
+set -o errexit; source ./ci/lint/04_install.sh
+set -o errexit
+./ci/lint/06_script.sh
diff --git a/ci/retry/README.md b/ci/retry/README.md
new file mode 100644
index 00000000..1b03c652
--- /dev/null
+++ b/ci/retry/README.md
@@ -0,0 +1,123 @@
+retry - The command line retry tool
+------------------------------------------
+
+Retry any shell command with exponential backoff or constant delay.
+
+### Instructions
+
+Install:
+
+retry is a shell script, so drop it somewhere and make sure it's added to your $PATH. Or you can use the following one-liner:
+
+```sh
+sudo sh -c "curl https://raw.githubusercontent.com/kadwanev/retry/master/retry -o /usr/local/bin/retry && chmod +x /usr/local/bin/retry"
+```
+
+If you're on OS X, retry is also on Homebrew:
+
+```
+brew pull 27283
+brew install retry
+```
+Not popular enough for homebrew-core. Please star this project to help.
+
+### Usage
+
+Help:
+
+`retry -?`
+
+ Usage: retry [options] -- execute command
+ -h, -?, --help
+ -v, --verbose Verbose output
+ -t, --tries=# Set max retries: Default 10
+ -s, --sleep=secs Constant sleep amount (seconds)
+ -m, --min=secs Exponential Backoff: minimum sleep amount (seconds): Default 0.3
+ -x, --max=secs Exponential Backoff: maximum sleep amount (seconds): Default 60
+ -f, --fail="script +cmds" Fail Script: run in case of final failure
+
+### Examples
+
+No problem:
+
+`retry echo u work good`
+
+ u work good
+
+Test functionality:
+
+`retry 'echo "y u no work"; false'`
+
+ y u no work
+ Before retry #1: sleeping 0.3 seconds
+ y u no work
+ Before retry #2: sleeping 0.6 seconds
+ y u no work
+ Before retry #3: sleeping 1.2 seconds
+ y u no work
+ Before retry #4: sleeping 2.4 seconds
+ y u no work
+ Before retry #5: sleeping 4.8 seconds
+ y u no work
+ Before retry #6: sleeping 9.6 seconds
+ y u no work
+ Before retry #7: sleeping 19.2 seconds
+ y u no work
+ Before retry #8: sleeping 38.4 seconds
+ y u no work
+ Before retry #9: sleeping 60.0 seconds
+ y u no work
+ Before retry #10: sleeping 60.0 seconds
+ y u no work
+ etc..
+
+Limit retries:
+
+`retry -t 4 'echo "y u no work"; false'`
+
+ y u no work
+ Before retry #1: sleeping 0.3 seconds
+ y u no work
+ Before retry #2: sleeping 0.6 seconds
+ y u no work
+ Before retry #3: sleeping 1.2 seconds
+ y u no work
+ Before retry #4: sleeping 2.4 seconds
+ y u no work
+ Retries exhausted
+
+Bad command:
+
+`retry poop`
+
+ bash: poop: command not found
+
+Fail command:
+
+`retry -t 3 -f 'echo "oh poopsickles"' 'echo "y u no work"; false'`
+
+ y u no work
+ Before retry #1: sleeping 0.3 seconds
+ y u no work
+ Before retry #2: sleeping 0.6 seconds
+ y u no work
+ Before retry #3: sleeping 1.2 seconds
+ y u no work
+ Retries exhausted, running fail script
+ oh poopsickles
+
+Last attempt passed:
+
+`retry -t 3 -- 'if [ $RETRY_ATTEMPT -eq 3 ]; then echo Passed at attempt $RETRY_ATTEMPT; true; else echo Failed at attempt $RETRY_ATTEMPT; false; fi;'`
+
+ Failed at attempt 0
+ Before retry #1: sleeping 0.3 seconds
+ Failed at attempt 1
+ Before retry #2: sleeping 0.6 seconds
+ Failed at attempt 2
+ Before retry #3: sleeping 1.2 seconds
+ Passed at attempt 3
+
+### License
+
+Apache 2.0 - go nuts
diff --git a/ci/retry/retry b/ci/retry/retry
new file mode 100755
index 00000000..3c06519d
--- /dev/null
+++ b/ci/retry/retry
@@ -0,0 +1,163 @@
+#!/usr/bin/env bash
+
+GETOPT_BIN=$IN_GETOPT_BIN
+GETOPT_BIN=${GETOPT_BIN:-getopt}
+
+__sleep_amount() {
+ if [ -n "$constant_sleep" ]; then
+ sleep_time=$constant_sleep
+ else
+ #TODO: check for awk
+ #TODO: check if user would rather use one of the other possible dependencies: python, ruby, bc, dc
+ sleep_time=`awk "BEGIN {t = $min_sleep * $(( (1<<($attempts -1)) )); print (t > $max_sleep ? $max_sleep : t)}"`
+ fi
+}
+
+__log_out() {
+ echo "$1" 1>&2
+}
+
+# Parameters: max_tries min_sleep max_sleep constant_sleep fail_script EXECUTION_COMMAND
+retry()
+{
+ local max_tries="$1"; shift
+ local min_sleep="$1"; shift
+ local max_sleep="$1"; shift
+ local constant_sleep="$1"; shift
+ local fail_script="$1"; shift
+ if [ -n "$VERBOSE" ]; then
+ __log_out "Retry Parameters: max_tries=$max_tries min_sleep=$min_sleep max_sleep=$max_sleep constant_sleep=$constant_sleep"
+ if [ -n "$fail_script" ]; then __log_out "Fail script: $fail_script"; fi
+ __log_out ""
+ __log_out "Execution Command: $*"
+ __log_out ""
+ fi
+
+ local attempts=0
+ local return_code=1
+
+
+ while [[ $return_code -ne 0 && $attempts -le $max_tries ]]; do
+ if [ $attempts -gt 0 ]; then
+ __sleep_amount
+ __log_out "Before retry #$attempts: sleeping $sleep_time seconds"
+ sleep $sleep_time
+ fi
+
+ P="$1"
+ for param in "${@:2}"; do P="$P '$param'"; done
+ #TODO: replace single quotes in each arg with '"'"' ?
+ export RETRY_ATTEMPT=$attempts
+ bash -c "$P"
+ return_code=$?
+ #__log_out "Process returned $return_code on attempt $attempts"
+ if [ $return_code -eq 127 ]; then
+ # command not found
+ exit $return_code
+ elif [ $return_code -ne 0 ]; then
+ attempts=$[$attempts +1]
+ fi
+ done
+
+ if [ $attempts -gt $max_tries ]; then
+ if [ -n "$fail_script" ]; then
+ __log_out "Retries exhausted, running fail script"
+ eval $fail_script
+ else
+ __log_out "Retries exhausted"
+ fi
+ fi
+
+ exit $return_code
+}
+
+# If we're being sourced, don't worry about such things
+if [ "$BASH_SOURCE" == "$0" ]; then
+ # Prints the help text
+ help()
+ {
+ local retry=$(basename $0)
+ cat <<EOF
+Usage: $retry [options] -- execute command
+ -h, -?, --help
+ -v, --verbose Verbose output
+ -t, --tries=# Set max retries: Default 10
+ -s, --sleep=secs Constant sleep amount (seconds)
+ -m, --min=secs Exponential Backoff: minimum sleep amount (seconds): Default 0.3
+ -x, --max=secs Exponential Backoff: maximum sleep amount (seconds): Default 60
+ -f, --fail="script +cmds" Fail Script: run in case of final failure
+EOF
+ }
+
+ # show help for no arguments if stdin is a terminal
+ if { [ -z "$1" ] && [ -t 0 ] ; } || [ "$1" == '-h' ] || [ "$1" == '-?' ] || [ "$1" == '--help' ]
+ then
+ help
+ exit 0
+ fi
+
+ $GETOPT_BIN --test > /dev/null
+ if [[ $? -ne 4 ]]; then
+ echo "I’m sorry, 'getopt --test' failed in this environment. Please load GNU getopt."
+ exit 1
+ fi
+
+ OPTIONS=vt:s:m:x:f:
+ LONGOPTIONS=verbose,tries:,sleep:,min:,max:,fail:
+
+ PARSED=$($GETOPT_BIN --options="$OPTIONS" --longoptions="$LONGOPTIONS" --name "$0" -- "$@")
+ if [[ $? -ne 0 ]]; then
+ # e.g. $? == 1
+ # then getopt has complained about wrong arguments to stdout
+ exit 2
+ fi
+ # read getopt’s output this way to handle the quoting right:
+ eval set -- "$PARSED"
+
+ max_tries=10
+ min_sleep=0.3
+ max_sleep=60.0
+ constant_sleep=
+ fail_script=
+
+ # now enjoy the options in order and nicely split until we see --
+ while true; do
+ case "$1" in
+ -v|--verbose)
+ VERBOSE=true
+ shift
+ ;;
+ -t|--tries)
+ max_tries="$2"
+ shift 2
+ ;;
+ -s|--sleep)
+ constant_sleep="$2"
+ shift 2
+ ;;
+ -m|--min)
+ min_sleep="$2"
+ shift 2
+ ;;
+ -x|--max)
+ max_sleep="$2"
+ shift 2
+ ;;
+ -f|--fail)
+ fail_script="$2"
+ shift 2
+ ;;
+ --)
+ shift
+ break
+ ;;
+ *)
+ echo "Programming error"
+ exit 3
+ ;;
+ esac
+ done
+
+ retry "$max_tries" "$min_sleep" "$max_sleep" "$constant_sleep" "$fail_script" "$@"
+
+fi
diff --git a/ci/test/00_setup_env.sh b/ci/test/00_setup_env.sh
new file mode 100755
index 00000000..9f794c25
--- /dev/null
+++ b/ci/test/00_setup_env.sh
@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2019-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+set -ex
+
+# The source root dir, usually from git, usually read-only.
+# The ci system copies this folder.
+BASE_READ_ONLY_DIR=$( cd "$( dirname "${BASH_SOURCE[0]}" )"/../../ >/dev/null 2>&1 && pwd )
+export BASE_READ_ONLY_DIR
+# The destination root dir inside the container.
+# This folder will also hold any SDKs.
+# This folder only exists on the ci guest and will be a copy of BASE_READ_ONLY_DIR
+export BASE_ROOT_DIR="${BASE_ROOT_DIR:-/ci_container_base}"
+# The depends dir.
+# This folder exists only on the ci guest, and on the ci host as a volume.
+export DEPENDS_DIR=${DEPENDS_DIR:-$BASE_ROOT_DIR/depends}
+# A folder for the ci system to put temporary files (build result, datadirs for tests, ...)
+# This folder only exists on the ci guest.
+export BASE_SCRATCH_DIR=${BASE_SCRATCH_DIR:-$BASE_ROOT_DIR/ci/scratch}
+# A folder for the ci system to put executables.
+# This folder only exists on the ci guest.
+export BINS_SCRATCH_DIR="${BASE_SCRATCH_DIR}/bins/"
+
+echo "Setting specific values in env"
+if [ -n "${FILE_ENV}" ]; then
+ set -o errexit;
+ # shellcheck disable=SC1090
+ source "${FILE_ENV}"
+fi
+
+echo "Fallback to default values in env (if not yet set)"
+# The number of parallel jobs to pass down to make and test_runner.py
+export MAKEJOBS=${MAKEJOBS:--j4}
+# Whether to prefer BusyBox over GNU utilities
+export USE_BUSY_BOX=${USE_BUSY_BOX:-false}
+
+export RUN_UNIT_TESTS=${RUN_UNIT_TESTS:-true}
+export RUN_FUNCTIONAL_TESTS=${RUN_FUNCTIONAL_TESTS:-true}
+export RUN_TIDY=${RUN_TIDY:-false}
+# By how much to scale the test_runner timeouts (option --timeout-factor).
+# This is needed because some ci machines have slow CPU or disk, so sanitizers
+# might be slow or a reindex might be waiting on disk IO.
+export TEST_RUNNER_TIMEOUT_FACTOR=${TEST_RUNNER_TIMEOUT_FACTOR:-40}
+export RUN_FUZZ_TESTS=${RUN_FUZZ_TESTS:-false}
+
+# Randomize test order.
+# See https://www.boost.org/doc/libs/1_71_0/libs/test/doc/html/boost_test/utf_reference/rt_param_reference/random.html
+export BOOST_TEST_RANDOM=${BOOST_TEST_RANDOM:-1}
+# See man 7 debconf
+export DEBIAN_FRONTEND=noninteractive
+export CCACHE_MAXSIZE=${CCACHE_MAXSIZE:-500M}
+export CCACHE_TEMPDIR=${CCACHE_TEMPDIR:-/tmp/.ccache-temp}
+export CCACHE_COMPRESS=${CCACHE_COMPRESS:-1}
+# The cache dir.
+# This folder exists only on the ci guest, and on the ci host as a volume.
+export CCACHE_DIR="${CCACHE_DIR:-$BASE_SCRATCH_DIR/ccache}"
+# Folder where the build result is put (bin and lib).
+export BASE_OUTDIR=${BASE_OUTDIR:-$BASE_SCRATCH_DIR/out}
+# The folder for previous release binaries.
+# This folder exists only on the ci guest, and on the ci host as a volume.
+export PREVIOUS_RELEASES_DIR=${PREVIOUS_RELEASES_DIR:-$BASE_ROOT_DIR/prev_releases}
+export CI_BASE_PACKAGES=${CI_BASE_PACKAGES:-build-essential pkgconf curl ca-certificates ccache python3 rsync git procps bison e2fsprogs cmake}
+export GOAL=${GOAL:-install}
+export DIR_QA_ASSETS=${DIR_QA_ASSETS:-${BASE_SCRATCH_DIR}/qa-assets}
+export CI_RETRY_EXE=${CI_RETRY_EXE:-"retry --"}
+
+# The --platform argument used with `docker build` and `docker run`.
+export CI_IMAGE_PLATFORM=${CI_IMAGE_PLATFORM:-"linux"} # Force linux, but use native arch by default
diff --git a/ci/test/00_setup_env_arm.sh b/ci/test/00_setup_env_arm.sh
new file mode 100755
index 00000000..dfeb7221
--- /dev/null
+++ b/ci/test/00_setup_env_arm.sh
@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2019-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+export HOST=arm-linux-gnueabihf
+export DPKG_ADD_ARCH="armhf"
+export PACKAGES="python3-zmq g++-arm-linux-gnueabihf busybox libc6:armhf libstdc++6:armhf libfontconfig1:armhf libxcb1:armhf"
+export CONTAINER_NAME=ci_arm_linux
+export CI_IMAGE_NAME_TAG="mirror.gcr.io/ubuntu:noble" # Check that https://packages.ubuntu.com/noble/g++-arm-linux-gnueabihf (version 13.3, similar to guix) can cross-compile
+export CI_IMAGE_PLATFORM="linux/arm64"
+export USE_BUSY_BOX=true
+export RUN_UNIT_TESTS=true
+export RUN_FUNCTIONAL_TESTS=false
+export GOAL="install"
+# -Wno-psabi is to disable ABI warnings: "note: parameter passing for argument of type ... changed in GCC 7.1"
+# This could be removed once the ABI change warning does not show up by default
+export BITCOIN_CONFIG="-DREDUCE_EXPORTS=ON -DCMAKE_CXX_FLAGS='-Wno-psabi -Wno-error=maybe-uninitialized'"
diff --git a/ci/test/00_setup_env_i686_multiprocess.sh b/ci/test/00_setup_env_i686_multiprocess.sh
new file mode 100755
index 00000000..d7c8e3ef
--- /dev/null
+++ b/ci/test/00_setup_env_i686_multiprocess.sh
@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2020-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+export HOST=i686-pc-linux-gnu
+export CONTAINER_NAME=ci_i686_multiprocess
+export CI_IMAGE_NAME_TAG="mirror.gcr.io/ubuntu:24.04"
+export CI_IMAGE_PLATFORM="linux/amd64"
+export PACKAGES="llvm clang g++-multilib"
+export DEP_OPTS="DEBUG=1 MULTIPROCESS=1"
+export GOAL="install"
+export TEST_RUNNER_EXTRA="--v2transport"
+export BITCOIN_CONFIG="\
+ -DCMAKE_BUILD_TYPE=Debug \
+ -DCMAKE_C_COMPILER='clang;-m32' \
+ -DCMAKE_CXX_COMPILER='clang++;-m32' \
+ -DAPPEND_CPPFLAGS='-DBOOST_MULTI_INDEX_ENABLE_SAFE_MODE' \
+"
+export BITCOIND=bitcoin-node # Used in functional tests
diff --git a/ci/test/00_setup_env_mac_cross.sh b/ci/test/00_setup_env_mac_cross.sh
new file mode 100755
index 00000000..a0d9082f
--- /dev/null
+++ b/ci/test/00_setup_env_mac_cross.sh
@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2019-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+export SDK_URL=${SDK_URL:-https://bitcoincore.org/depends-sources/sdks}
+
+export CONTAINER_NAME=ci_macos_cross
+export CI_IMAGE_NAME_TAG="mirror.gcr.io/ubuntu:24.04"
+export HOST=x86_64-apple-darwin
+export PACKAGES="clang lld llvm zip"
+export XCODE_VERSION=15.0
+export XCODE_BUILD_ID=15A240d
+export RUN_UNIT_TESTS=false
+export RUN_FUNCTIONAL_TESTS=false
+export GOAL="deploy"
+export BITCOIN_CONFIG="-DBUILD_GUI=ON -DREDUCE_EXPORTS=ON"
diff --git a/ci/test/00_setup_env_mac_native.sh b/ci/test/00_setup_env_mac_native.sh
new file mode 100755
index 00000000..e01a5689
--- /dev/null
+++ b/ci/test/00_setup_env_mac_native.sh
@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2019-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+# Homebrew's python@3.12 is marked as externally managed (PEP 668).
+# Therefore, `--break-system-packages` is needed.
+export PIP_PACKAGES="--break-system-packages zmq"
+export GOAL="install"
+export CMAKE_GENERATOR="Ninja"
+export BITCOIN_CONFIG="-DBUILD_GUI=ON -DWITH_ZMQ=ON -DREDUCE_EXPORTS=ON"
+export CI_OS_NAME="macos"
+export NO_DEPENDS=1
+export OSX_SDK=""
diff --git a/ci/test/00_setup_env_mac_native_fuzz.sh b/ci/test/00_setup_env_mac_native_fuzz.sh
new file mode 100755
index 00000000..cacf2423
--- /dev/null
+++ b/ci/test/00_setup_env_mac_native_fuzz.sh
@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+export CMAKE_GENERATOR="Ninja"
+export BITCOIN_CONFIG="-DBUILD_FOR_FUZZING=ON"
+export CI_OS_NAME="macos"
+export NO_DEPENDS=1
+export OSX_SDK=""
+export RUN_UNIT_TESTS=false
+export RUN_FUNCTIONAL_TESTS=false
+export RUN_FUZZ_TESTS=true
+export GOAL="all"
diff --git a/ci/test/00_setup_env_native_asan.sh b/ci/test/00_setup_env_native_asan.sh
new file mode 100755
index 00000000..4066b14f
--- /dev/null
+++ b/ci/test/00_setup_env_native_asan.sh
@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2019-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+export CI_IMAGE_NAME_TAG="mirror.gcr.io/ubuntu:24.04"
+
+# Only install BCC tracing packages in CI. Container has to match the host for BCC to work.
+if [[ "${INSTALL_BCC_TRACING_TOOLS}" == "true" ]]; then
+ # Required for USDT functional tests to run
+ BPFCC_PACKAGE="bpfcc-tools linux-headers-$(uname --kernel-release)"
+ export CI_CONTAINER_CAP="--privileged -v /sys/kernel:/sys/kernel:rw"
+else
+ BPFCC_PACKAGE=""
+ export CI_CONTAINER_CAP="--cap-add SYS_PTRACE" # If run with (ASan + LSan), the container needs access to ptrace (https://github.com/google/sanitizers/issues/764)
+fi
+
+export CONTAINER_NAME=ci_native_asan
+export APT_LLVM_V="20"
+export PACKAGES="systemtap-sdt-dev clang-${APT_LLVM_V} llvm-${APT_LLVM_V} libclang-rt-${APT_LLVM_V}-dev python3-zmq qtbase5-dev qttools5-dev qttools5-dev-tools libevent-dev libboost-dev libdb5.3++-dev libzmq3-dev libqrencode-dev libsqlite3-dev ${BPFCC_PACKAGE}"
+export NO_DEPENDS=1
+export GOAL="install"
+export BITCOIN_CONFIG="\
+ -DWITH_USDT=ON -DWITH_ZMQ=ON -DWITH_BDB=ON -DWARN_INCOMPATIBLE_BDB=OFF -DBUILD_GUI=ON \
+ -DSANITIZERS=address,float-divide-by-zero,integer,undefined \
+ -DCMAKE_C_COMPILER=clang-${APT_LLVM_V} \
+ -DCMAKE_CXX_COMPILER=clang++-${APT_LLVM_V} \
+ -DCMAKE_C_FLAGS='-ftrivial-auto-var-init=pattern' \
+ -DCMAKE_CXX_FLAGS='-ftrivial-auto-var-init=pattern' \
+ -DAPPEND_CXXFLAGS='-std=c++23' \
+ -DAPPEND_CPPFLAGS='-DARENA_DEBUG -DDEBUG_LOCKORDER' \
+"
diff --git a/ci/test/00_setup_env_native_centos.sh b/ci/test/00_setup_env_native_centos.sh
new file mode 100755
index 00000000..c423d788
--- /dev/null
+++ b/ci/test/00_setup_env_native_centos.sh
@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2020-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+export CONTAINER_NAME=ci_native_centos
+export CI_IMAGE_NAME_TAG="quay.io/centos/centos:stream10"
+export CI_BASE_PACKAGES="gcc-c++ glibc-devel libstdc++-devel ccache make git python3 python3-pip which patch xz procps-ng ksh rsync coreutils bison e2fsprogs cmake"
+export PIP_PACKAGES="pyzmq"
+export DEP_OPTS="DEBUG=1" # Temporarily enable a DEBUG=1 build to check for GCC-bug-117966 regressions. This can be removed once the minimum GCC version is bumped to 12 in the previous releases task, see https://github.com/bitcoin/bitcoin/issues/31436#issuecomment-2530717875
+export GOAL="install"
+export BITCOIN_CONFIG="-DWITH_ZMQ=ON -DBUILD_GUI=ON -DREDUCE_EXPORTS=ON -DCMAKE_BUILD_TYPE=Debug"
diff --git a/ci/test/00_setup_env_native_fuzz.sh b/ci/test/00_setup_env_native_fuzz.sh
new file mode 100755
index 00000000..c5220211
--- /dev/null
+++ b/ci/test/00_setup_env_native_fuzz.sh
@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2019-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+export CI_IMAGE_NAME_TAG="mirror.gcr.io/ubuntu:24.04"
+export CONTAINER_NAME=ci_native_fuzz
+export APT_LLVM_V="20"
+export PACKAGES="clang-${APT_LLVM_V} llvm-${APT_LLVM_V} libclang-rt-${APT_LLVM_V}-dev libevent-dev libboost-dev libsqlite3-dev"
+export NO_DEPENDS=1
+export RUN_UNIT_TESTS=false
+export RUN_FUNCTIONAL_TESTS=false
+export RUN_FUZZ_TESTS=true
+export GOAL="all"
+export CI_CONTAINER_CAP="--cap-add SYS_PTRACE" # If run with (ASan + LSan), the container needs access to ptrace (https://github.com/google/sanitizers/issues/764)
+export BITCOIN_CONFIG="\
+ -DBUILD_FOR_FUZZING=ON \
+ -DSANITIZERS=fuzzer,address,undefined,float-divide-by-zero,integer \
+ -DCMAKE_C_COMPILER=clang-${APT_LLVM_V} \
+ -DCMAKE_CXX_COMPILER=clang++-${APT_LLVM_V} \
+ -DCMAKE_C_FLAGS='-ftrivial-auto-var-init=pattern' \
+ -DCMAKE_CXX_FLAGS='-ftrivial-auto-var-init=pattern' \
+"
+export LLVM_SYMBOLIZER_PATH="/usr/bin/llvm-symbolizer-${APT_LLVM_V}"
diff --git a/ci/test/00_setup_env_native_fuzz_with_msan.sh b/ci/test/00_setup_env_native_fuzz_with_msan.sh
new file mode 100755
index 00000000..a6e53dc8
--- /dev/null
+++ b/ci/test/00_setup_env_native_fuzz_with_msan.sh
@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2020-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+export CI_IMAGE_NAME_TAG="mirror.gcr.io/ubuntu:24.04"
+LIBCXX_DIR="/msan/cxx_build/"
+export MSAN_FLAGS="-fsanitize=memory -fsanitize-memory-track-origins=2 -fno-omit-frame-pointer -g -O1 -fno-optimize-sibling-calls"
+LIBCXX_FLAGS="-nostdinc++ -nostdlib++ -isystem ${LIBCXX_DIR}include/c++/v1 -L${LIBCXX_DIR}lib -Wl,-rpath,${LIBCXX_DIR}lib -lc++ -lc++abi -lpthread -Wno-unused-command-line-argument"
+export MSAN_AND_LIBCXX_FLAGS="${MSAN_FLAGS} ${LIBCXX_FLAGS}"
+
+export CONTAINER_NAME="ci_native_fuzz_msan"
+export PACKAGES="ninja-build"
+# BDB generates false-positives and will be removed in future
+export DEP_OPTS="DEBUG=1 NO_BDB=1 NO_QT=1 CC=clang CXX=clang++ CFLAGS='${MSAN_FLAGS}' CXXFLAGS='${MSAN_AND_LIBCXX_FLAGS}'"
+export GOAL="all"
+# Setting CMAKE_{C,CXX}_FLAGS_DEBUG flags to an empty string ensures that the flags set in MSAN_FLAGS remain unaltered.
+# _FORTIFY_SOURCE is not compatible with MSAN.
+export BITCOIN_CONFIG="\
+ -DCMAKE_BUILD_TYPE=Debug \
+ -DCMAKE_C_FLAGS_DEBUG='' \
+ -DCMAKE_CXX_FLAGS_DEBUG='' \
+ -DBUILD_FOR_FUZZING=ON \
+ -DSANITIZERS=fuzzer,memory \
+ -DAPPEND_CPPFLAGS='-DBOOST_MULTI_INDEX_ENABLE_SAFE_MODE -U_FORTIFY_SOURCE' \
+"
+export USE_MEMORY_SANITIZER="true"
+export RUN_UNIT_TESTS="false"
+export RUN_FUNCTIONAL_TESTS="false"
+export RUN_FUZZ_TESTS=true
diff --git a/ci/test/00_setup_env_native_fuzz_with_valgrind.sh b/ci/test/00_setup_env_native_fuzz_with_valgrind.sh
new file mode 100755
index 00000000..2e500abf
--- /dev/null
+++ b/ci/test/00_setup_env_native_fuzz_with_valgrind.sh
@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2019-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+export CI_IMAGE_NAME_TAG="mirror.gcr.io/ubuntu:24.04"
+export CONTAINER_NAME=ci_native_fuzz_valgrind
+export PACKAGES="clang-16 llvm-16 libclang-rt-16-dev libevent-dev libboost-dev libsqlite3-dev valgrind"
+export NO_DEPENDS=1
+export RUN_UNIT_TESTS=false
+export RUN_FUNCTIONAL_TESTS=false
+export RUN_FUZZ_TESTS=true
+export FUZZ_TESTS_CONFIG="--valgrind"
+export GOAL="all"
+export BITCOIN_CONFIG="\
+ -DBUILD_FOR_FUZZING=ON \
+ -DSANITIZERS=fuzzer \
+ -DCMAKE_C_COMPILER=clang-16 \
+ -DCMAKE_CXX_COMPILER=clang++-16 \
+"
+export LLVM_SYMBOLIZER_PATH="/usr/bin/llvm-symbolizer-16"
diff --git a/ci/test/00_setup_env_native_msan.sh b/ci/test/00_setup_env_native_msan.sh
new file mode 100755
index 00000000..8784aaa5
--- /dev/null
+++ b/ci/test/00_setup_env_native_msan.sh
@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2020-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+export CI_IMAGE_NAME_TAG="mirror.gcr.io/ubuntu:24.04"
+LIBCXX_DIR="/msan/cxx_build/"
+export MSAN_FLAGS="-fsanitize=memory -fsanitize-memory-track-origins=2 -fno-omit-frame-pointer -g -O1 -fno-optimize-sibling-calls"
+LIBCXX_FLAGS="-nostdinc++ -nostdlib++ -isystem ${LIBCXX_DIR}include/c++/v1 -L${LIBCXX_DIR}lib -Wl,-rpath,${LIBCXX_DIR}lib -lc++ -lc++abi -lpthread -Wno-unused-command-line-argument"
+export MSAN_AND_LIBCXX_FLAGS="${MSAN_FLAGS} ${LIBCXX_FLAGS}"
+
+export CONTAINER_NAME="ci_native_msan"
+export PACKAGES="ninja-build"
+# BDB generates false-positives and will be removed in future
+export DEP_OPTS="DEBUG=1 NO_BDB=1 NO_QT=1 CC=clang CXX=clang++ CFLAGS='${MSAN_FLAGS}' CXXFLAGS='${MSAN_AND_LIBCXX_FLAGS}'"
+export GOAL="install"
+# Setting CMAKE_{C,CXX}_FLAGS_DEBUG flags to an empty string ensures that the flags set in MSAN_FLAGS remain unaltered.
+# _FORTIFY_SOURCE is not compatible with MSAN.
+export BITCOIN_CONFIG="\
+ -DCMAKE_BUILD_TYPE=Debug \
+ -DCMAKE_C_FLAGS_DEBUG='' \
+ -DCMAKE_CXX_FLAGS_DEBUG='' \
+ -DSANITIZERS=memory \
+ -DAPPEND_CPPFLAGS='-U_FORTIFY_SOURCE' \
+"
+export USE_MEMORY_SANITIZER="true"
diff --git a/ci/test/00_setup_env_native_nowallet_libbitcoinkernel.sh b/ci/test/00_setup_env_native_nowallet_libbitcoinkernel.sh
new file mode 100755
index 00000000..74bc891a
--- /dev/null
+++ b/ci/test/00_setup_env_native_nowallet_libbitcoinkernel.sh
@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2019-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+export CONTAINER_NAME=ci_native_nowallet_libbitcoinkernel
+export CI_IMAGE_NAME_TAG="mirror.gcr.io/debian:bookworm"
+# Use minimum supported python3.10 (or best-effort 3.11) and clang-16, see doc/dependencies.md
+export PACKAGES="python3-zmq clang-16 llvm-16 libc++abi-16-dev libc++-16-dev"
+export DEP_OPTS="NO_WALLET=1 CC=clang-16 CXX='clang++-16 -stdlib=libc++'"
+export GOAL="install"
+export BITCOIN_CONFIG="-DREDUCE_EXPORTS=ON -DBUILD_UTIL_CHAINSTATE=ON -DBUILD_KERNEL_LIB=ON -DBUILD_SHARED_LIBS=ON"
diff --git a/ci/test/00_setup_env_native_previous_releases.sh b/ci/test/00_setup_env_native_previous_releases.sh
new file mode 100755
index 00000000..66d454b9
--- /dev/null
+++ b/ci/test/00_setup_env_native_previous_releases.sh
@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2019-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+export CONTAINER_NAME=ci_native_previous_releases
+export CI_IMAGE_NAME_TAG="mirror.gcr.io/ubuntu:22.04"
+# Use minimum supported python3.10 and gcc-11, see doc/dependencies.md
+export PACKAGES="gcc-11 g++-11 python3-zmq"
+export DEP_OPTS="DEBUG=1 CC=gcc-11 CXX=g++-11"
+export TEST_RUNNER_EXTRA="--previous-releases --coverage --extended --exclude feature_dbcrash" # Run extended tests so that coverage does not fail, but exclude the very slow dbcrash
+export RUN_UNIT_TESTS_SEQUENTIAL="true"
+export RUN_UNIT_TESTS="false"
+export GOAL="install"
+export DOWNLOAD_PREVIOUS_RELEASES="true"
+export BITCOIN_CONFIG="\
+ -DWITH_ZMQ=ON -DBUILD_GUI=ON -DREDUCE_EXPORTS=ON \
+ -DCMAKE_BUILD_TYPE=Debug \
+ -DCMAKE_C_FLAGS='-funsigned-char' \
+ -DCMAKE_C_FLAGS_DEBUG='-g0 -O2' \
+ -DCMAKE_CXX_FLAGS='-funsigned-char' \
+ -DCMAKE_CXX_FLAGS_DEBUG='-g0 -O2' \
+ -DAPPEND_CPPFLAGS='-DBOOST_MULTI_INDEX_ENABLE_SAFE_MODE' \
+"
diff --git a/ci/test/00_setup_env_native_tidy.sh b/ci/test/00_setup_env_native_tidy.sh
new file mode 100755
index 00000000..b5277d13
--- /dev/null
+++ b/ci/test/00_setup_env_native_tidy.sh
@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2023-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+export CI_IMAGE_NAME_TAG="mirror.gcr.io/ubuntu:24.04"
+export CONTAINER_NAME=ci_native_tidy
+export TIDY_LLVM_V="19"
+export APT_LLVM_V="${TIDY_LLVM_V}"
+export PACKAGES="clang-${TIDY_LLVM_V} libclang-${TIDY_LLVM_V}-dev llvm-${TIDY_LLVM_V}-dev libomp-${TIDY_LLVM_V}-dev clang-tidy-${TIDY_LLVM_V} jq libevent-dev libboost-dev libzmq3-dev systemtap-sdt-dev qtbase5-dev qttools5-dev qttools5-dev-tools libqrencode-dev libsqlite3-dev libdb++-dev"
+export NO_DEPENDS=1
+export RUN_UNIT_TESTS=false
+export RUN_FUNCTIONAL_TESTS=false
+export RUN_FUZZ_TESTS=false
+export RUN_CHECK_DEPS=true
+export RUN_TIDY=true
+export GOAL="install"
+export BITCOIN_CONFIG="\
+ -DWITH_ZMQ=ON -DBUILD_GUI=ON -DBUILD_BENCH=ON -DWITH_USDT=ON -DWITH_BDB=ON -DWARN_INCOMPATIBLE_BDB=OFF \
+ -DCMAKE_C_COMPILER=clang-${TIDY_LLVM_V} \
+ -DCMAKE_CXX_COMPILER=clang++-${TIDY_LLVM_V} \
+ -DCMAKE_C_FLAGS_RELWITHDEBINFO='-O0 -g0' \
+ -DCMAKE_CXX_FLAGS_RELWITHDEBINFO='-O0 -g0' \
+"
diff --git a/ci/test/00_setup_env_native_tsan.sh b/ci/test/00_setup_env_native_tsan.sh
new file mode 100755
index 00000000..b341adfe
--- /dev/null
+++ b/ci/test/00_setup_env_native_tsan.sh
@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2019-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+export CONTAINER_NAME=ci_native_tsan
+export CI_IMAGE_NAME_TAG="mirror.gcr.io/ubuntu:24.04"
+export APT_LLVM_V="20"
+export PACKAGES="clang-${APT_LLVM_V} llvm-${APT_LLVM_V} libclang-rt-${APT_LLVM_V}-dev libc++abi-${APT_LLVM_V}-dev libc++-${APT_LLVM_V}-dev python3-zmq"
+export DEP_OPTS="CC=clang-${APT_LLVM_V} CXX='clang++-${APT_LLVM_V} -stdlib=libc++'"
+export GOAL="install"
+export BITCOIN_CONFIG="-DWITH_ZMQ=ON -DSANITIZERS=thread \
+-DAPPEND_CPPFLAGS='-DARENA_DEBUG -DDEBUG_LOCKORDER -DDEBUG_LOCKCONTENTION -D_LIBCPP_REMOVE_TRANSITIVE_INCLUDES'"
diff --git a/ci/test/00_setup_env_native_valgrind.sh b/ci/test/00_setup_env_native_valgrind.sh
new file mode 100755
index 00000000..22d9d812
--- /dev/null
+++ b/ci/test/00_setup_env_native_valgrind.sh
@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2019-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+export CI_IMAGE_NAME_TAG="mirror.gcr.io/ubuntu:24.04"
+export CONTAINER_NAME=ci_native_valgrind
+export PACKAGES="valgrind clang-16 llvm-16 libclang-rt-16-dev python3-zmq libevent-dev libboost-dev libdb5.3++-dev libzmq3-dev libsqlite3-dev"
+export USE_VALGRIND=1
+export NO_DEPENDS=1
+export TEST_RUNNER_EXTRA="--exclude feature_init,rpc_bind,feature_bind_extra" # feature_init excluded for now, see https://github.com/bitcoin/bitcoin/issues/30011 ; bind tests excluded for now, see https://github.com/bitcoin/bitcoin/issues/17765#issuecomment-602068547
+export GOAL="install"
+# TODO enable GUI
+export BITCOIN_CONFIG="\
+ -DWITH_ZMQ=ON -DWITH_BDB=ON -DWARN_INCOMPATIBLE_BDB=OFF -DBUILD_GUI=OFF \
+ -DCMAKE_C_COMPILER=clang-16 \
+ -DCMAKE_CXX_COMPILER=clang++-16 \
+"
diff --git a/ci/test/00_setup_env_s390x.sh b/ci/test/00_setup_env_s390x.sh
new file mode 100755
index 00000000..b84d9907
--- /dev/null
+++ b/ci/test/00_setup_env_s390x.sh
@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2019-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+export HOST=s390x-linux-gnu
+export PACKAGES="python3-zmq"
+export CONTAINER_NAME=ci_s390x
+export CI_IMAGE_NAME_TAG="mirror.gcr.io/ubuntu:24.04"
+export CI_IMAGE_PLATFORM="linux/s390x"
+export TEST_RUNNER_EXTRA="--exclude rpc_bind,feature_bind_extra" # Excluded for now, see https://github.com/bitcoin/bitcoin/issues/17765#issuecomment-602068547
+export RUN_FUNCTIONAL_TESTS=true
+export GOAL="install"
+export BITCOIN_CONFIG="-DREDUCE_EXPORTS=ON"
diff --git a/ci/test/00_setup_env_win64.sh b/ci/test/00_setup_env_win64.sh
new file mode 100755
index 00000000..ba67af26
--- /dev/null
+++ b/ci/test/00_setup_env_win64.sh
@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2019-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+export CONTAINER_NAME=ci_win64
+export CI_IMAGE_NAME_TAG="mirror.gcr.io/ubuntu:noble" # Check that g++-mingw-w64-x86-64-posix (version 13.2, similar to guix) can cross-compile
+export CI_IMAGE_PLATFORM="linux/amd64"
+export HOST=x86_64-w64-mingw32
+export PACKAGES="g++-mingw-w64-x86-64-posix nsis"
+export RUN_UNIT_TESTS=false
+export RUN_FUNCTIONAL_TESTS=false
+export GOAL="deploy"
+export BITCOIN_CONFIG="-DREDUCE_EXPORTS=ON -DBUILD_GUI_TESTS=OFF \
+-DCMAKE_CXX_FLAGS='-Wno-error=maybe-uninitialized -Wno-error=array-bounds'"
diff --git a/ci/test/01_base_install.sh b/ci/test/01_base_install.sh
new file mode 100755
index 00000000..13445632
--- /dev/null
+++ b/ci/test/01_base_install.sh
@@ -0,0 +1,107 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2018-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+set -ex
+
+CFG_DONE="ci.base-install-done" # Use a global git setting to remember whether this script ran to avoid running it twice
+
+if [ "$(git config --global ${CFG_DONE})" == "true" ]; then
+ echo "Skip base install"
+ exit 0
+fi
+
+MAKEJOBS="-j$( nproc )" # Use nproc, because MAKEJOBS is the default in docker image builds.
+
+if [ -n "$DPKG_ADD_ARCH" ]; then
+ dpkg --add-architecture "$DPKG_ADD_ARCH"
+fi
+
+if [ -n "${APT_LLVM_V}" ]; then
+ ${CI_RETRY_EXE} apt-get update
+ ${CI_RETRY_EXE} apt-get install curl -y
+ curl "https://apt.llvm.org/llvm-snapshot.gpg.key" | tee "/etc/apt/trusted.gpg.d/apt.llvm.org.asc"
+ (
+ # shellcheck disable=SC2034
+ source /etc/os-release
+ echo "deb http://apt.llvm.org/${VERSION_CODENAME}/ llvm-toolchain-${VERSION_CODENAME}-${APT_LLVM_V} main" > "/etc/apt/sources.list.d/llvm-toolchain-${VERSION_CODENAME}-${APT_LLVM_V}.list"
+ )
+fi
+
+if [[ $CI_IMAGE_NAME_TAG == *centos* ]]; then
+ bash -c "dnf -y install epel-release"
+ bash -c "dnf -y --allowerasing install $CI_BASE_PACKAGES $PACKAGES"
+elif [ "$CI_OS_NAME" != "macos" ]; then
+ if [[ -n "${APPEND_APT_SOURCES_LIST}" ]]; then
+ echo "${APPEND_APT_SOURCES_LIST}" >> /etc/apt/sources.list
+ fi
+ ${CI_RETRY_EXE} apt-get update
+ ${CI_RETRY_EXE} bash -c "apt-get install --no-install-recommends --no-upgrade -y $PACKAGES $CI_BASE_PACKAGES"
+fi
+
+if [ -n "$PIP_PACKAGES" ]; then
+ # shellcheck disable=SC2086
+ ${CI_RETRY_EXE} pip3 install --user $PIP_PACKAGES
+fi
+
+if [[ ${USE_MEMORY_SANITIZER} == "true" ]]; then
+ ${CI_RETRY_EXE} git clone --depth=1 https://github.com/llvm/llvm-project -b "llvmorg-20.1.0" /msan/llvm-project
+
+ cmake -G Ninja -B /msan/clang_build/ \
+ -DLLVM_ENABLE_PROJECTS="clang" \
+ -DCMAKE_BUILD_TYPE=Release \
+ -DLLVM_TARGETS_TO_BUILD=Native \
+ -DLLVM_ENABLE_RUNTIMES="compiler-rt;libcxx;libcxxabi;libunwind" \
+ -S /msan/llvm-project/llvm
+
+ ninja -C /msan/clang_build/ "$MAKEJOBS"
+ ninja -C /msan/clang_build/ install-runtimes
+
+ update-alternatives --install /usr/bin/clang++ clang++ /msan/clang_build/bin/clang++ 100
+ update-alternatives --install /usr/bin/clang clang /msan/clang_build/bin/clang 100
+ update-alternatives --install /usr/bin/llvm-symbolizer llvm-symbolizer /msan/clang_build/bin/llvm-symbolizer 100
+
+ cmake -G Ninja -B /msan/cxx_build/ \
+ -DLLVM_ENABLE_RUNTIMES="libcxx;libcxxabi;libunwind" \
+ -DCMAKE_BUILD_TYPE=Release \
+ -DLLVM_USE_SANITIZER=MemoryWithOrigins \
+ -DCMAKE_C_COMPILER=clang \
+ -DCMAKE_CXX_COMPILER=clang++ \
+ -DLLVM_TARGETS_TO_BUILD=Native \
+ -DLLVM_ENABLE_PER_TARGET_RUNTIME_DIR=OFF \
+ -DLIBCXXABI_USE_LLVM_UNWINDER=OFF \
+ -DLIBCXX_ABI_DEFINES="_LIBCPP_ABI_BOUNDED_ITERATORS;_LIBCPP_ABI_BOUNDED_ITERATORS_IN_STD_ARRAY;_LIBCPP_ABI_BOUNDED_ITERATORS_IN_STRING;_LIBCPP_ABI_BOUNDED_ITERATORS_IN_VECTOR;_LIBCPP_ABI_BOUNDED_UNIQUE_PTR" \
+ -DLIBCXX_HARDENING_MODE=debug \
+ -S /msan/llvm-project/runtimes
+
+ ninja -C /msan/cxx_build/ "$MAKEJOBS"
+
+ # Clear no longer needed source folder
+ du -sh /msan/llvm-project
+ rm -rf /msan/llvm-project
+fi
+
+if [[ "${RUN_TIDY}" == "true" ]]; then
+ ${CI_RETRY_EXE} git clone --depth=1 https://github.com/include-what-you-use/include-what-you-use -b clang_"${TIDY_LLVM_V}" /include-what-you-use
+ cmake -B /iwyu-build/ -G 'Unix Makefiles' -DCMAKE_PREFIX_PATH=/usr/lib/llvm-"${TIDY_LLVM_V}" -S /include-what-you-use
+ make -C /iwyu-build/ install "$MAKEJOBS"
+fi
+
+mkdir -p "${DEPENDS_DIR}/SDKs" "${DEPENDS_DIR}/sdk-sources"
+
+OSX_SDK_BASENAME="Xcode-${XCODE_VERSION}-${XCODE_BUILD_ID}-extracted-SDK-with-libcxx-headers"
+
+if [ -n "$XCODE_VERSION" ] && [ ! -d "${DEPENDS_DIR}/SDKs/${OSX_SDK_BASENAME}" ]; then
+ OSX_SDK_FILENAME="${OSX_SDK_BASENAME}.tar.gz"
+ OSX_SDK_PATH="${DEPENDS_DIR}/sdk-sources/${OSX_SDK_FILENAME}"
+ if [ ! -f "$OSX_SDK_PATH" ]; then
+ ${CI_RETRY_EXE} curl --location --fail "${SDK_URL}/${OSX_SDK_FILENAME}" -o "$OSX_SDK_PATH"
+ fi
+ tar -C "${DEPENDS_DIR}/SDKs" -xf "$OSX_SDK_PATH"
+fi
+
+git config --global ${CFG_DONE} "true"
diff --git a/ci/test/02_run_container.sh b/ci/test/02_run_container.sh
new file mode 100755
index 00000000..9616018e
--- /dev/null
+++ b/ci/test/02_run_container.sh
@@ -0,0 +1,170 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2018-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+export CI_IMAGE_LABEL="bitcoin-ci-test"
+
+set -o errexit -o pipefail -o xtrace
+
+if [ -z "$DANGER_RUN_CI_ON_HOST" ]; then
+ # Export all env vars to avoid missing some.
+ # Though, exclude those with newlines to avoid parsing problems.
+ python3 -c 'import os; [print(f"{key}={value}") for key, value in os.environ.items() if "\n" not in value and "HOME" != key and "PATH" != key and "USER" != key]' | tee "/tmp/env-$USER-$CONTAINER_NAME"
+
+ # Env vars during the build can not be changed. For example, a modified
+ # $MAKEJOBS is ignored in the build process. Use --cpuset-cpus as an
+ # approximation to respect $MAKEJOBS somewhat, if cpuset is available.
+ MAYBE_CPUSET=""
+ if [ "$HAVE_CGROUP_CPUSET" ]; then
+ MAYBE_CPUSET="--cpuset-cpus=$( python3 -c "import random;P=$( nproc );M=min(P,int('$MAKEJOBS'.lstrip('-j')));print(','.join(map(str,sorted(random.sample(range(P),M)))))" )"
+ fi
+ echo "Creating $CI_IMAGE_NAME_TAG container to run in"
+
+ DOCKER_BUILD_CACHE_ARG=""
+ DOCKER_BUILD_CACHE_TEMPDIR=""
+ DOCKER_BUILD_CACHE_OLD_DIR=""
+ DOCKER_BUILD_CACHE_NEW_DIR=""
+ # If set, use an `docker build` cache directory on the CI host
+ # to cache docker image layers for the CI container image.
+ # This cache can be multiple GB in size. Prefixed with DANGER
+ # as setting it removes (old cache) files from the host.
+ if [ "$DANGER_DOCKER_BUILD_CACHE_HOST_DIR" ]; then
+ # Directory where the current cache for this run could be. If not existing
+ # or empty, "docker build" will warn, but treat it as cache-miss and continue.
+ DOCKER_BUILD_CACHE_OLD_DIR="${DANGER_DOCKER_BUILD_CACHE_HOST_DIR}/${CONTAINER_NAME}"
+ # Temporary directory for a newly created cache. We can't write the new
+ # cache into OLD_DIR directly, as old cache layers would not be removed.
+ # The NEW_DIR contents are moved to OLD_DIR after OLD_DIR has been cleared.
+ # This happens after `docker build`. If a task fails or is aborted, the
+ # DOCKER_BUILD_CACHE_TEMPDIR might be retained on the host. If the host isn't
+ # ephemeral, it has to take care of cleaning old TEMPDIR's up.
+ DOCKER_BUILD_CACHE_TEMPDIR="$(mktemp --directory ci-docker-build-cache-XXXXXXXXXX)"
+ DOCKER_BUILD_CACHE_NEW_DIR="${DOCKER_BUILD_CACHE_TEMPDIR}/${CONTAINER_NAME}"
+ DOCKER_BUILD_CACHE_ARG="--cache-from type=local,src=${DOCKER_BUILD_CACHE_OLD_DIR} --cache-to type=local,dest=${DOCKER_BUILD_CACHE_NEW_DIR},mode=max"
+ fi
+
+ # shellcheck disable=SC2086
+ DOCKER_BUILDKIT=1 docker build \
+ --file "${BASE_READ_ONLY_DIR}/ci/test_imagefile" \
+ --build-arg "CI_IMAGE_NAME_TAG=${CI_IMAGE_NAME_TAG}" \
+ --build-arg "FILE_ENV=${FILE_ENV}" \
+ $MAYBE_CPUSET \
+ --platform="${CI_IMAGE_PLATFORM}" \
+ --label="${CI_IMAGE_LABEL}" \
+ --tag="${CONTAINER_NAME}" \
+ $DOCKER_BUILD_CACHE_ARG \
+ "${BASE_READ_ONLY_DIR}"
+
+ if [ "$DANGER_DOCKER_BUILD_CACHE_HOST_DIR" ]; then
+ if [ -e "${DOCKER_BUILD_CACHE_NEW_DIR}/index.json" ]; then
+ echo "Removing the existing docker build cache in ${DOCKER_BUILD_CACHE_OLD_DIR}"
+ rm -rf "${DOCKER_BUILD_CACHE_OLD_DIR}"
+ echo "Moving the contents of ${DOCKER_BUILD_CACHE_NEW_DIR} to ${DOCKER_BUILD_CACHE_OLD_DIR}"
+ mv "${DOCKER_BUILD_CACHE_NEW_DIR}" "${DOCKER_BUILD_CACHE_OLD_DIR}"
+ fi
+ fi
+
+ docker volume create "${CONTAINER_NAME}_ccache" || true
+ docker volume create "${CONTAINER_NAME}_depends" || true
+ docker volume create "${CONTAINER_NAME}_depends_sources" || true
+ docker volume create "${CONTAINER_NAME}_previous_releases" || true
+
+ CI_CCACHE_MOUNT="type=volume,src=${CONTAINER_NAME}_ccache,dst=$CCACHE_DIR"
+ CI_DEPENDS_MOUNT="type=volume,src=${CONTAINER_NAME}_depends,dst=$DEPENDS_DIR/built"
+ CI_DEPENDS_SOURCES_MOUNT="type=volume,src=${CONTAINER_NAME}_depends_sources,dst=$DEPENDS_DIR/sources"
+ CI_PREVIOUS_RELEASES_MOUNT="type=volume,src=${CONTAINER_NAME}_previous_releases,dst=$PREVIOUS_RELEASES_DIR"
+ CI_BUILD_MOUNT=""
+
+ if [ "$DANGER_CI_ON_HOST_FOLDERS" ]; then
+ # ensure the directories exist
+ mkdir -p "${CCACHE_DIR}"
+ mkdir -p "${DEPENDS_DIR}/built"
+ mkdir -p "${DEPENDS_DIR}/sources"
+ mkdir -p "${PREVIOUS_RELEASES_DIR}"
+ mkdir -p "${BASE_BUILD_DIR}" # Unset by default, must be defined externally
+
+ CI_CCACHE_MOUNT="type=bind,src=${CCACHE_DIR},dst=$CCACHE_DIR"
+ CI_DEPENDS_MOUNT="type=bind,src=${DEPENDS_DIR}/built,dst=$DEPENDS_DIR/built"
+ CI_DEPENDS_SOURCES_MOUNT="type=bind,src=${DEPENDS_DIR}/sources,dst=$DEPENDS_DIR/sources"
+ CI_PREVIOUS_RELEASES_MOUNT="type=bind,src=${PREVIOUS_RELEASES_DIR},dst=$PREVIOUS_RELEASES_DIR"
+ CI_BUILD_MOUNT="--mount type=bind,src=${BASE_BUILD_DIR},dst=${BASE_BUILD_DIR}"
+ fi
+
+ if [ "$DANGER_CI_ON_HOST_CCACHE_FOLDER" ]; then
+ if [ ! -d "${CCACHE_DIR}" ]; then
+ echo "Error: Directory '${CCACHE_DIR}' must be created in advance."
+ exit 1
+ fi
+ CI_CCACHE_MOUNT="type=bind,src=${CCACHE_DIR},dst=${CCACHE_DIR}"
+ fi
+
+ docker network create --ipv6 --subnet 1111:1111::/112 ci-ip6net || true
+
+ if [ -n "${RESTART_CI_DOCKER_BEFORE_RUN}" ] ; then
+ echo "Restart docker before run to stop and clear all containers started with --rm"
+ podman container rm --force --all # Similar to "systemctl restart docker"
+
+ # Still prune everything in case the filtered pruning doesn't work, or if labels were not set
+ # on a previous run. Belt and suspenders approach, should be fine to remove in the future.
+ # Prune images used by --external containers (e.g. build containers) when
+ # using podman.
+ echo "Prune all dangling images"
+ podman image prune --force --external
+ fi
+ echo "Prune all dangling $CI_IMAGE_LABEL images"
+ # When detecting podman-docker, `--external` should be added.
+ docker image prune --force --filter "label=$CI_IMAGE_LABEL"
+
+ # Append $USER to /tmp/env to support multi-user systems and $CONTAINER_NAME
+ # to allow support starting multiple runs simultaneously by the same user.
+ # shellcheck disable=SC2086
+ CI_CONTAINER_ID=$(docker run --cap-add LINUX_IMMUTABLE $CI_CONTAINER_CAP --rm --interactive --detach --tty \
+ --mount "type=bind,src=$BASE_READ_ONLY_DIR,dst=$BASE_READ_ONLY_DIR,readonly" \
+ --mount "${CI_CCACHE_MOUNT}" \
+ --mount "${CI_DEPENDS_MOUNT}" \
+ --mount "${CI_DEPENDS_SOURCES_MOUNT}" \
+ --mount "${CI_PREVIOUS_RELEASES_MOUNT}" \
+ ${CI_BUILD_MOUNT} \
+ --env-file /tmp/env-$USER-$CONTAINER_NAME \
+ --name "$CONTAINER_NAME" \
+ --network ci-ip6net \
+ --platform="${CI_IMAGE_PLATFORM}" \
+ "$CONTAINER_NAME")
+ export CI_CONTAINER_ID
+ export CI_EXEC_CMD_PREFIX="docker exec ${CI_CONTAINER_ID}"
+else
+ echo "Running on host system without docker wrapper"
+ echo "Create missing folders"
+ mkdir -p "${CCACHE_DIR}"
+ mkdir -p "${PREVIOUS_RELEASES_DIR}"
+fi
+
+if [ "$CI_OS_NAME" == "macos" ]; then
+ IN_GETOPT_BIN="$(brew --prefix gnu-getopt)/bin/getopt"
+ export IN_GETOPT_BIN
+fi
+
+CI_EXEC () {
+ $CI_EXEC_CMD_PREFIX bash -c "export PATH=\"/path_with space:${BINS_SCRATCH_DIR}:${BASE_ROOT_DIR}/ci/retry:\$PATH\" && cd \"${BASE_ROOT_DIR}\" && $*"
+}
+export -f CI_EXEC
+
+# Normalize all folders to BASE_ROOT_DIR
+CI_EXEC rsync --archive --stats --human-readable "${BASE_READ_ONLY_DIR}/" "${BASE_ROOT_DIR}" || echo "Nothing to copy from ${BASE_READ_ONLY_DIR}/"
+CI_EXEC "${BASE_ROOT_DIR}/ci/test/01_base_install.sh"
+
+# Fixes permission issues when there is a container UID/GID mismatch with the owner
+# of the git source code directory.
+CI_EXEC git config --global --add safe.directory \"*\"
+
+CI_EXEC mkdir -p "${BINS_SCRATCH_DIR}"
+
+CI_EXEC "${BASE_ROOT_DIR}/ci/test/03_test_script.sh"
+
+if [ -z "$DANGER_RUN_CI_ON_HOST" ]; then
+ echo "Stop and remove CI container by ID"
+ docker container kill "${CI_CONTAINER_ID}"
+fi
diff --git a/ci/test/03_test_script.sh b/ci/test/03_test_script.sh
new file mode 100755
index 00000000..a71565ba
--- /dev/null
+++ b/ci/test/03_test_script.sh
@@ -0,0 +1,189 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2018-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+set -ex
+
+export ASAN_OPTIONS="detect_leaks=1:detect_stack_use_after_return=1:check_initialization_order=1:strict_init_order=1"
+export LSAN_OPTIONS="suppressions=${BASE_ROOT_DIR}/test/sanitizer_suppressions/lsan"
+export TSAN_OPTIONS="suppressions=${BASE_ROOT_DIR}/test/sanitizer_suppressions/tsan:halt_on_error=1:second_deadlock_stack=1"
+export UBSAN_OPTIONS="suppressions=${BASE_ROOT_DIR}/test/sanitizer_suppressions/ubsan:print_stacktrace=1:halt_on_error=1:report_error_type=1"
+
+echo "Number of available processing units: $(nproc)"
+if [ "$CI_OS_NAME" == "macos" ]; then
+ top -l 1 -s 0 | awk ' /PhysMem/ {print}'
+else
+ free -m -h
+ echo "System info: $(uname --kernel-name --kernel-release)"
+ lscpu
+fi
+echo "Free disk space:"
+df -h
+
+# What host to compile for. See also ./depends/README.md
+# Tests that need cross-compilation export the appropriate HOST.
+# Tests that run natively guess the host
+export HOST=${HOST:-$("$BASE_ROOT_DIR/depends/config.guess")}
+
+echo "=== BEGIN env ==="
+env
+echo "=== END env ==="
+
+(
+ # compact->outputs[i].file_size is uninitialized memory, so reading it is UB.
+ # The statistic bytes_written is only used for logging, which is disabled in
+ # CI, so as a temporary minimal fix to work around UB and CI failures, leave
+ # bytes_written unmodified.
+ # See https://github.com/bitcoin/bitcoin/pull/28359#issuecomment-1698694748
+ # Tee patch to stdout to make it clear CI is testing modified code.
+ tee >(patch -p1) <<'EOF'
+--- a/src/leveldb/db/db_impl.cc
++++ b/src/leveldb/db/db_impl.cc
+@@ -1028,9 +1028,6 @@ Status DBImpl::DoCompactionWork(CompactionState* compact) {
+ stats.bytes_read += compact->compaction->input(which, i)->file_size;
+ }
+ }
+- for (size_t i = 0; i < compact->outputs.size(); i++) {
+- stats.bytes_written += compact->outputs[i].file_size;
+- }
+
+ mutex_.Lock();
+ stats_[compact->compaction->level() + 1].Add(stats);
+EOF
+)
+
+if [ "$RUN_FUZZ_TESTS" = "true" ]; then
+ export DIR_FUZZ_IN=${DIR_QA_ASSETS}/fuzz_corpora/
+ if [ ! -d "$DIR_FUZZ_IN" ]; then
+ ${CI_RETRY_EXE} git clone --depth=1 https://github.com/bitcoin-core/qa-assets "${DIR_QA_ASSETS}"
+ fi
+ (
+ cd "${DIR_QA_ASSETS}"
+ echo "Using qa-assets repo from commit ..."
+ git log -1
+ )
+elif [ "$RUN_UNIT_TESTS" = "true" ] || [ "$RUN_UNIT_TESTS_SEQUENTIAL" = "true" ]; then
+ export DIR_UNIT_TEST_DATA=${DIR_QA_ASSETS}/unit_test_data/
+ if [ ! -d "$DIR_UNIT_TEST_DATA" ]; then
+ mkdir -p "$DIR_UNIT_TEST_DATA"
+ ${CI_RETRY_EXE} curl --location --fail https://github.com/bitcoin-core/qa-assets/raw/main/unit_test_data/script_assets_test.json -o "${DIR_UNIT_TEST_DATA}/script_assets_test.json"
+ fi
+fi
+
+if [ "$USE_BUSY_BOX" = "true" ]; then
+ echo "Setup to use BusyBox utils"
+ # tar excluded for now because it requires passing in the exact archive type in ./depends (fixed in later BusyBox version)
+ # ar excluded for now because it does not recognize the -q option in ./depends (unknown if fixed)
+ for util in $(busybox --list | grep -v "^ar$" | grep -v "^tar$" ); do ln -s "$(command -v busybox)" "${BINS_SCRATCH_DIR}/$util"; done
+ # Print BusyBox version
+ patch --help
+fi
+
+# Make sure default datadir does not exist and is never read by creating a dummy file
+if [ "$CI_OS_NAME" == "macos" ]; then
+ echo > "${HOME}/Library/Application Support/Bitcoin"
+else
+ echo > "${HOME}/.bitcoin"
+fi
+
+if [ -z "$NO_DEPENDS" ]; then
+ if [[ $CI_IMAGE_NAME_TAG == *centos* ]]; then
+ SHELL_OPTS="CONFIG_SHELL=/bin/ksh" # Temporarily use ksh instead of dash, until https://bugzilla.redhat.com/show_bug.cgi?id=2335416 is fixed.
+ else
+ SHELL_OPTS="CONFIG_SHELL="
+ fi
+ bash -c "$SHELL_OPTS make $MAKEJOBS -C depends HOST=$HOST $DEP_OPTS LOG=1"
+fi
+if [ "$DOWNLOAD_PREVIOUS_RELEASES" = "true" ]; then
+ test/get_previous_releases.py -b -t "$PREVIOUS_RELEASES_DIR"
+fi
+
+BITCOIN_CONFIG_ALL="-DBUILD_BENCH=ON -DBUILD_FUZZ_BINARY=ON"
+if [ -z "$NO_DEPENDS" ]; then
+ BITCOIN_CONFIG_ALL="${BITCOIN_CONFIG_ALL} -DCMAKE_TOOLCHAIN_FILE=$DEPENDS_DIR/$HOST/toolchain.cmake"
+fi
+if [ -z "$NO_WERROR" ]; then
+ BITCOIN_CONFIG_ALL="${BITCOIN_CONFIG_ALL} -DWERROR=ON"
+fi
+
+ccache --zero-stats
+PRINT_CCACHE_STATISTICS="ccache --version | head -n 1 && ccache --show-stats"
+
+# Folder where the build is done.
+BASE_BUILD_DIR=${BASE_BUILD_DIR:-$BASE_SCRATCH_DIR/build-$HOST}
+mkdir -p "${BASE_BUILD_DIR}"
+cd "${BASE_BUILD_DIR}"
+
+BITCOIN_CONFIG_ALL="$BITCOIN_CONFIG_ALL -DENABLE_EXTERNAL_SIGNER=ON -DCMAKE_INSTALL_PREFIX=$BASE_OUTDIR"
+
+if [[ "${RUN_TIDY}" == "true" ]]; then
+ BITCOIN_CONFIG_ALL="$BITCOIN_CONFIG_ALL -DCMAKE_EXPORT_COMPILE_COMMANDS=ON"
+fi
+
+bash -c "cmake -S $BASE_ROOT_DIR $BITCOIN_CONFIG_ALL $BITCOIN_CONFIG || ( (cat $(cmake -P "${BASE_ROOT_DIR}/ci/test/GetCMakeLogFiles.cmake")) && false)"
+
+bash -c "cmake --build . $MAKEJOBS --target all $GOAL" || ( echo "Build failure. Verbose build follows." && cmake --build . --target all "$GOAL" --verbose ; false )
+
+bash -c "${PRINT_CCACHE_STATISTICS}"
+du -sh "${DEPENDS_DIR}"/*/
+du -sh "${PREVIOUS_RELEASES_DIR}"
+
+if [ -n "$USE_VALGRIND" ]; then
+ "${BASE_ROOT_DIR}/ci/test/wrap-valgrind.sh"
+fi
+
+if [ "$RUN_CHECK_DEPS" = "true" ]; then
+ "${BASE_ROOT_DIR}/contrib/devtools/check-deps.sh" .
+fi
+
+if [ "$RUN_UNIT_TESTS" = "true" ]; then
+ DIR_UNIT_TEST_DATA="${DIR_UNIT_TEST_DATA}" LD_LIBRARY_PATH="${DEPENDS_DIR}/${HOST}/lib" CTEST_OUTPUT_ON_FAILURE=ON ctest --stop-on-failure "${MAKEJOBS}" --timeout $(( TEST_RUNNER_TIMEOUT_FACTOR * 60 ))
+fi
+
+if [ "$RUN_UNIT_TESTS_SEQUENTIAL" = "true" ]; then
+ DIR_UNIT_TEST_DATA="${DIR_UNIT_TEST_DATA}" LD_LIBRARY_PATH="${DEPENDS_DIR}/${HOST}/lib" "${BASE_OUTDIR}"/bin/test_bitcoin --catch_system_errors=no -l test_suite
+fi
+
+if [ "$RUN_FUNCTIONAL_TESTS" = "true" ]; then
+ # parses TEST_RUNNER_EXTRA as an array which allows for multiple arguments such as TEST_RUNNER_EXTRA='--exclude "rpc_bind.py --ipv6"'
+ eval "TEST_RUNNER_EXTRA=($TEST_RUNNER_EXTRA)"
+ LD_LIBRARY_PATH="${DEPENDS_DIR}/${HOST}/lib" test/functional/test_runner.py --ci "${MAKEJOBS}" --tmpdirprefix "${BASE_SCRATCH_DIR}"/test_runner/ --ansi --combinedlogslen=99999999 --timeout-factor="${TEST_RUNNER_TIMEOUT_FACTOR}" "${TEST_RUNNER_EXTRA[@]}" --quiet --failfast
+fi
+
+if [ "${RUN_TIDY}" = "true" ]; then
+ cmake -B /tidy-build -DLLVM_DIR=/usr/lib/llvm-"${TIDY_LLVM_V}"/cmake -DCMAKE_BUILD_TYPE=Release -S "${BASE_ROOT_DIR}"/contrib/devtools/bitcoin-tidy
+ cmake --build /tidy-build "$MAKEJOBS"
+ cmake --build /tidy-build --target bitcoin-tidy-tests "$MAKEJOBS"
+
+ set -eo pipefail
+ # Filter out:
+ # * qt qrc and moc generated files
+ jq 'map(select(.file | test("src/qt/.*_autogen/.*\\.cpp$") | not))' "${BASE_BUILD_DIR}/compile_commands.json" > tmp.json
+ mv tmp.json "${BASE_BUILD_DIR}/compile_commands.json"
+
+ cd "${BASE_BUILD_DIR}/src/"
+ if ! ( run-clang-tidy-"${TIDY_LLVM_V}" -quiet -load="/tidy-build/libbitcoin-tidy.so" "${MAKEJOBS}" | tee tmp.tidy-out.txt ); then
+ grep -C5 "error: " tmp.tidy-out.txt
+ echo "^^^ ⚠️ Failure generated from clang-tidy"
+ false
+ fi
+
+ cd "${BASE_ROOT_DIR}"
+ python3 "/include-what-you-use/iwyu_tool.py" \
+ -p "${BASE_BUILD_DIR}" "${MAKEJOBS}" \
+ -- -Xiwyu --cxx17ns -Xiwyu --mapping_file="${BASE_ROOT_DIR}/contrib/devtools/iwyu/bitcoin.core.imp" \
+ -Xiwyu --max_line_length=160 \
+ 2>&1 | tee /tmp/iwyu_ci.out
+ cd "${BASE_ROOT_DIR}/src"
+ python3 "/include-what-you-use/fix_includes.py" --nosafe_headers < /tmp/iwyu_ci.out
+ git --no-pager diff
+fi
+
+if [ "$RUN_FUZZ_TESTS" = "true" ]; then
+ # shellcheck disable=SC2086
+ LD_LIBRARY_PATH="${DEPENDS_DIR}/${HOST}/lib" test/fuzz/test_runner.py ${FUZZ_TESTS_CONFIG} "${MAKEJOBS}" -l DEBUG "${DIR_FUZZ_IN}" --empty_min_time=60
+fi
diff --git a/ci/test/GetCMakeLogFiles.cmake b/ci/test/GetCMakeLogFiles.cmake
new file mode 100644
index 00000000..80f71dcf
--- /dev/null
+++ b/ci/test/GetCMakeLogFiles.cmake
@@ -0,0 +1,11 @@
+# Copyright (c) 2024-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or https://opensource.org/license/mit/.
+
+if(CMAKE_VERSION VERSION_GREATER_EQUAL 3.26)
+ set(log_files "CMakeFiles/CMakeConfigureLog.yaml")
+else()
+ set(log_files "CMakeFiles/CMakeOutput.log CMakeFiles/CMakeError.log")
+endif()
+
+execute_process(COMMAND ${CMAKE_COMMAND} -E echo ${log_files})
diff --git a/ci/test/wrap-valgrind.sh b/ci/test/wrap-valgrind.sh
new file mode 100755
index 00000000..27754831
--- /dev/null
+++ b/ci/test/wrap-valgrind.sh
@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2018-2021 The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+for b_name in "${BASE_OUTDIR}/bin"/*; do
+ # shellcheck disable=SC2044
+ for b in $(find "${BASE_ROOT_DIR}" -executable -type f -name "$(basename "$b_name")"); do
+ echo "Wrap $b ..."
+ mv "$b" "${b}_orig"
+ echo '#!/usr/bin/env bash' > "$b"
+ echo "valgrind --gen-suppressions=all --quiet --error-exitcode=1 --suppressions=${BASE_ROOT_DIR}/contrib/valgrind.supp \"${b}_orig\" \"\$@\"" >> "$b"
+ chmod +x "$b"
+ done
+done
diff --git a/ci/test_imagefile b/ci/test_imagefile
new file mode 100644
index 00000000..f8b5eea1
--- /dev/null
+++ b/ci/test_imagefile
@@ -0,0 +1,16 @@
+# Copyright (c) The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or https://opensource.org/license/mit/.
+
+# See ci/README.md for usage.
+
+ARG CI_IMAGE_NAME_TAG
+FROM ${CI_IMAGE_NAME_TAG}
+
+ARG FILE_ENV
+ENV FILE_ENV=${FILE_ENV}
+
+COPY ./ci/retry/retry /usr/bin/retry
+COPY ./ci/test/00_setup_env.sh ./${FILE_ENV} ./ci/test/01_base_install.sh /ci_container_base/ci/test/
+
+RUN ["bash", "-c", "cd /ci_container_base/ && set -o errexit && source ./ci/test/00_setup_env.sh && ./ci/test/01_base_install.sh"]
diff --git a/ci/test_run_all.sh b/ci/test_run_all.sh
new file mode 100755
index 00000000..3afc47b2
--- /dev/null
+++ b/ci/test_run_all.sh
@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+#
+# Copyright (c) 2019-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+export LC_ALL=C.UTF-8
+
+set -o errexit; source ./ci/test/00_setup_env.sh
+set -o errexit
+"./ci/test/02_run_container.sh"
diff --git a/cmake/bitcoin-build-config.h.in b/cmake/bitcoin-build-config.h.in
new file mode 100644
index 00000000..19d815db
--- /dev/null
+++ b/cmake/bitcoin-build-config.h.in
@@ -0,0 +1,147 @@
+// 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/.
+
+#ifndef BITCOIN_CONFIG_H
+#define BITCOIN_CONFIG_H
+
+/* Version Build */
+#define CLIENT_VERSION_BUILD @CLIENT_VERSION_BUILD@
+
+/* Version is release */
+#define CLIENT_VERSION_IS_RELEASE @CLIENT_VERSION_IS_RELEASE@
+
+/* Major version */
+#define CLIENT_VERSION_MAJOR @CLIENT_VERSION_MAJOR@
+
+/* Minor version */
+#define CLIENT_VERSION_MINOR @CLIENT_VERSION_MINOR@
+
+/* Copyright holder(s) before %s replacement */
+#define COPYRIGHT_HOLDERS "@COPYRIGHT_HOLDERS@"
+
+/* Copyright holder(s) */
+#define COPYRIGHT_HOLDERS_FINAL "@COPYRIGHT_HOLDERS_FINAL@"
+
+/* Replacement for %s in copyright holders string */
+#define COPYRIGHT_HOLDERS_SUBSTITUTION "@CLIENT_NAME@"
+
+/* Copyright year */
+#define COPYRIGHT_YEAR @COPYRIGHT_YEAR@
+
+/* Define this symbol to build code that uses ARMv8 SHA-NI intrinsics */
+#cmakedefine ENABLE_ARM_SHANI 1
+
+/* Define this symbol to build code that uses AVX2 intrinsics */
+#cmakedefine ENABLE_AVX2 1
+
+/* Define if external signer support is enabled */
+#cmakedefine ENABLE_EXTERNAL_SIGNER 1
+
+/* Define this symbol to build code that uses SSE4.1 intrinsics */
+#cmakedefine ENABLE_SSE41 1
+
+/* Define to 1 to enable tracepoints for Userspace, Statically Defined Tracing
+ */
+#cmakedefine ENABLE_TRACING 1
+
+/* Define to 1 to enable wallet functions. */
+#cmakedefine ENABLE_WALLET 1
+
+/* Define this symbol to build code that uses x86 SHA-NI intrinsics */
+#cmakedefine ENABLE_X86_SHANI 1
+
+/* Define to 1 if you have the declaration of `fork', and to 0 if you don't.
+ */
+#cmakedefine01 HAVE_DECL_FORK
+
+/* Define to 1 if you have the declaration of `freeifaddrs', and to 0 if you
+ don't. */
+#cmakedefine01 HAVE_DECL_FREEIFADDRS
+
+/* Define to 1 if you have the declaration of `getifaddrs', and to 0 if you
+ don't. */
+#cmakedefine01 HAVE_DECL_GETIFADDRS
+
+/* Define to 1 if you have the declaration of `pipe2', and to 0 if you don't.
+ */
+#cmakedefine01 HAVE_DECL_PIPE2
+
+/* Define to 1 if you have the declaration of `setsid', and to 0 if you don't.
+ */
+#cmakedefine01 HAVE_DECL_SETSID
+
+/* Define to 1 if fdatasync is available. */
+#cmakedefine HAVE_FDATASYNC 1
+
+/* Define this symbol if the BSD getentropy system call is available with
+ sys/random.h */
+#cmakedefine HAVE_GETENTROPY_RAND 1
+
+/* Define this symbol if the Linux getrandom function call is available */
+#cmakedefine HAVE_GETRANDOM 1
+
+/* Define this symbol if you have malloc_info */
+#cmakedefine HAVE_MALLOC_INFO 1
+
+/* Define this symbol if you have mallopt with M_ARENA_MAX */
+#cmakedefine HAVE_MALLOPT_ARENA_MAX 1
+
+/* Define to 1 if O_CLOEXEC flag is available. */
+#cmakedefine01 HAVE_O_CLOEXEC
+
+/* Define this symbol if you have posix_fallocate */
+#cmakedefine HAVE_POSIX_FALLOCATE 1
+
+/* Define this symbol if platform supports unix domain sockets */
+#cmakedefine HAVE_SOCKADDR_UN 1
+
+/* Define this symbol to build code that uses getauxval */
+#cmakedefine HAVE_STRONG_GETAUXVAL 1
+
+/* Define this symbol if the BSD sysctl() is available */
+#cmakedefine HAVE_SYSCTL 1
+
+/* Define this symbol if the BSD sysctl(KERN_ARND) is available */
+#cmakedefine HAVE_SYSCTL_ARND 1
+
+/* Define to 1 if std::system or ::wsystem is available. */
+#cmakedefine HAVE_SYSTEM 1
+
+/* Define to 1 if you have the <sys/prctl.h> header file. */
+#cmakedefine HAVE_SYS_PRCTL_H 1
+
+/* Define to 1 if you have the <sys/resources.h> header file. */
+#cmakedefine HAVE_SYS_RESOURCES_H 1
+
+/* Define to 1 if you have the <sys/vmmeter.h> header file. */
+#cmakedefine HAVE_SYS_VMMETER_H 1
+
+/* Define to 1 if you have the <vm/vm_param.h> header file. */
+#cmakedefine HAVE_VM_VM_PARAM_H 1
+
+/* Define to the address where bug reports for this package should be sent. */
+#define CLIENT_BUGREPORT "@CLIENT_BUGREPORT@"
+
+/* Define to the full name of this package. */
+#define CLIENT_NAME "@CLIENT_NAME@"
+
+/* Define to the home page for this package. */
+#define CLIENT_URL "@PROJECT_HOMEPAGE_URL@"
+
+/* Define to the version of this package. */
+#define CLIENT_VERSION_STRING "@CLIENT_VERSION_STRING@"
+
+/* Define to 1 if strerror_r returns char *. */
+#cmakedefine STRERROR_R_CHAR_P 1
+
+/* Define if BDB support should be compiled in */
+#cmakedefine USE_BDB 1
+
+/* Define if dbus support should be compiled in */
+#cmakedefine USE_DBUS 1
+
+/* Define if QR support should be compiled in */
+#cmakedefine USE_QRCODE 1
+
+#endif //BITCOIN_CONFIG_H
diff --git a/cmake/ccache.cmake b/cmake/ccache.cmake
new file mode 100644
index 00000000..0bfd3a41
--- /dev/null
+++ b/cmake/ccache.cmake
@@ -0,0 +1,30 @@
+# 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/.
+
+if(NOT MSVC)
+ find_program(CCACHE_EXECUTABLE ccache)
+ if(CCACHE_EXECUTABLE)
+ execute_process(
+ COMMAND readlink -f ${CMAKE_CXX_COMPILER}
+ OUTPUT_VARIABLE compiler_resolved_link
+ ERROR_QUIET
+ OUTPUT_STRIP_TRAILING_WHITESPACE
+ )
+ if(CCACHE_EXECUTABLE STREQUAL compiler_resolved_link AND NOT WITH_CCACHE)
+ list(APPEND configure_warnings
+ "Disabling ccache was attempted using -DWITH_CCACHE=${WITH_CCACHE}, but ccache masquerades as the compiler."
+ )
+ set(WITH_CCACHE ON)
+ elseif(WITH_CCACHE)
+ list(APPEND CMAKE_C_COMPILER_LAUNCHER ${CCACHE_EXECUTABLE})
+ list(APPEND CMAKE_CXX_COMPILER_LAUNCHER ${CCACHE_EXECUTABLE})
+ endif()
+ else()
+ set(WITH_CCACHE OFF)
+ endif()
+else()
+ set(WITH_CCACHE OFF)
+endif()
+
+mark_as_advanced(CCACHE_EXECUTABLE)
diff --git a/cmake/crc32c.cmake b/cmake/crc32c.cmake
new file mode 100644
index 00000000..25f046bb
--- /dev/null
+++ b/cmake/crc32c.cmake
@@ -0,0 +1,115 @@
+# 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/.
+
+# This file is part of the transition from Autotools to CMake. Once CMake
+# support has been merged we should switch to using the upstream CMake
+# buildsystem.
+
+include(CheckCXXSourceCompiles)
+include(CheckSourceCompilesWithFlags)
+
+# Check for __builtin_prefetch support in the compiler.
+check_cxx_source_compiles("
+ int main() {
+ char data = 0;
+ const char* address = &data;
+ __builtin_prefetch(address, 0, 0);
+ return 0;
+ }
+ " HAVE_BUILTIN_PREFETCH
+)
+
+# Check for _mm_prefetch support in the compiler.
+check_cxx_source_compiles("
+ #if defined(_MSC_VER)
+ #include <intrin.h>
+ #else
+ #include <xmmintrin.h>
+ #endif
+
+ int main() {
+ char data = 0;
+ const char* address = &data;
+ _mm_prefetch(address, _MM_HINT_NTA);
+ return 0;
+ }
+ " HAVE_MM_PREFETCH
+)
+
+# Check for SSE4.2 support in the compiler.
+if(MSVC)
+ set(SSE42_CXXFLAGS /arch:AVX)
+else()
+ set(SSE42_CXXFLAGS -msse4.2)
+endif()
+check_cxx_source_compiles_with_flags("
+ #include <cstdint>
+ #if defined(_MSC_VER)
+ #include <intrin.h>
+ #elif defined(__GNUC__) && defined(__SSE4_2__)
+ #include <nmmintrin.h>
+ #endif
+
+ int main() {
+ uint64_t l = 0;
+ l = _mm_crc32_u8(l, 0);
+ l = _mm_crc32_u32(l, 0);
+ l = _mm_crc32_u64(l, 0);
+ return l;
+ }
+ " HAVE_SSE42
+ CXXFLAGS ${SSE42_CXXFLAGS}
+)
+
+# Check for ARMv8 w/ CRC and CRYPTO extensions support in the compiler.
+set(ARM64_CRC_CXXFLAGS -march=armv8-a+crc+crypto)
+check_cxx_source_compiles_with_flags("
+ #include <arm_acle.h>
+ #include <arm_neon.h>
+
+ int main() {
+ #ifdef __aarch64__
+ __crc32cb(0, 0); __crc32ch(0, 0); __crc32cw(0, 0); __crc32cd(0, 0);
+ vmull_p64(0, 0);
+ #else
+ #error crc32c library does not support hardware acceleration on 32-bit ARM
+ #endif
+ return 0;
+ }
+ " HAVE_ARM64_CRC32C
+ CXXFLAGS ${ARM64_CRC_CXXFLAGS}
+)
+
+add_library(crc32c STATIC EXCLUDE_FROM_ALL
+ ${PROJECT_SOURCE_DIR}/src/crc32c/src/crc32c.cc
+ ${PROJECT_SOURCE_DIR}/src/crc32c/src/crc32c_portable.cc
+)
+target_compile_definitions(crc32c PRIVATE
+ HAVE_BUILTIN_PREFETCH=$<BOOL:${HAVE_BUILTIN_PREFETCH}>
+ HAVE_MM_PREFETCH=$<BOOL:${HAVE_MM_PREFETCH}>
+ HAVE_STRONG_GETAUXVAL=$<BOOL:${HAVE_STRONG_GETAUXVAL}>
+ BYTE_ORDER_BIG_ENDIAN=$<STREQUAL:${CMAKE_CXX_BYTE_ORDER},BIG_ENDIAN>
+ HAVE_SSE42=$<BOOL:${HAVE_SSE42}>
+ HAVE_ARM64_CRC32C=$<BOOL:${HAVE_ARM64_CRC32C}>
+)
+target_include_directories(crc32c
+ PUBLIC
+ $<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/src/crc32c/include>
+)
+target_link_libraries(crc32c PRIVATE core_interface)
+set_target_properties(crc32c PROPERTIES EXPORT_COMPILE_COMMANDS OFF)
+
+if(HAVE_SSE42)
+ set(_crc32_src ${PROJECT_SOURCE_DIR}/src/crc32c/src/crc32c_sse42.cc)
+ target_sources(crc32c PRIVATE ${_crc32_src})
+ set_property(SOURCE ${_crc32_src} PROPERTY COMPILE_OPTIONS ${SSE42_CXXFLAGS})
+endif()
+
+if(HAVE_ARM64_CRC32C)
+ set(_crc32_src ${PROJECT_SOURCE_DIR}/src/crc32c/src/crc32c_arm64.cc)
+ target_sources(crc32c PRIVATE ${_crc32_src})
+ set_property(SOURCE ${_crc32_src} PROPERTY COMPILE_OPTIONS ${ARM64_CRC_CXXFLAGS})
+endif()
+
+unset(_crc32_src)
diff --git a/cmake/introspection.cmake b/cmake/introspection.cmake
new file mode 100644
index 00000000..d4ed4866
--- /dev/null
+++ b/cmake/introspection.cmake
@@ -0,0 +1,231 @@
+# 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/.
+
+include(CheckCXXSourceCompiles)
+include(CheckCXXSymbolExists)
+include(CheckIncludeFileCXX)
+
+# The following HAVE_{HEADER}_H variables go to the bitcoin-build-config.h header.
+check_include_file_cxx(sys/prctl.h HAVE_SYS_PRCTL_H)
+check_include_file_cxx(sys/resources.h HAVE_SYS_RESOURCES_H)
+check_include_file_cxx(sys/vmmeter.h HAVE_SYS_VMMETER_H)
+check_include_file_cxx(vm/vm_param.h HAVE_VM_VM_PARAM_H)
+
+check_cxx_symbol_exists(O_CLOEXEC "fcntl.h" HAVE_O_CLOEXEC)
+check_cxx_symbol_exists(fdatasync "unistd.h" HAVE_FDATASYNC)
+check_cxx_symbol_exists(fork "unistd.h" HAVE_DECL_FORK)
+check_cxx_symbol_exists(pipe2 "unistd.h" HAVE_DECL_PIPE2)
+check_cxx_symbol_exists(setsid "unistd.h" HAVE_DECL_SETSID)
+
+check_include_file_cxx(sys/types.h HAVE_SYS_TYPES_H)
+check_include_file_cxx(ifaddrs.h HAVE_IFADDRS_H)
+if(HAVE_SYS_TYPES_H AND HAVE_IFADDRS_H)
+ include(TestAppendRequiredLibraries)
+ test_append_socket_library(core_interface)
+endif()
+
+include(TestAppendRequiredLibraries)
+test_append_atomic_library(core_interface)
+
+check_cxx_symbol_exists(std::system "cstdlib" HAVE_STD_SYSTEM)
+check_cxx_symbol_exists(::_wsystem "stdlib.h" HAVE__WSYSTEM)
+if(HAVE_STD_SYSTEM OR HAVE__WSYSTEM)
+ set(HAVE_SYSTEM 1)
+endif()
+
+check_cxx_source_compiles("
+ #include <string.h>
+
+ int main()
+ {
+ char buf[100];
+ char* p{strerror_r(0, buf, sizeof buf)};
+ (void)p;
+ }
+ " STRERROR_R_CHAR_P
+)
+
+# Check for malloc_info (for memory statistics information in getmemoryinfo).
+check_cxx_symbol_exists(malloc_info "malloc.h" HAVE_MALLOC_INFO)
+
+# Check for mallopt(M_ARENA_MAX) (to set glibc arenas).
+check_cxx_source_compiles("
+ #include <malloc.h>
+
+ int main()
+ {
+ mallopt(M_ARENA_MAX, 1);
+ }
+ " HAVE_MALLOPT_ARENA_MAX
+)
+
+# Check for posix_fallocate().
+check_cxx_source_compiles("
+ // same as in src/util/fs_helpers.cpp
+ #ifdef __linux__
+ #ifdef _POSIX_C_SOURCE
+ #undef _POSIX_C_SOURCE
+ #endif
+ #define _POSIX_C_SOURCE 200112L
+ #endif // __linux__
+ #include <fcntl.h>
+
+ int main()
+ {
+ return posix_fallocate(0, 0, 0);
+ }
+ " HAVE_POSIX_FALLOCATE
+)
+
+# Check for strong getauxval() support in the system headers.
+check_cxx_source_compiles("
+ #include <sys/auxv.h>
+
+ int main()
+ {
+ getauxval(AT_HWCAP);
+ }
+ " HAVE_STRONG_GETAUXVAL
+)
+
+# Check for UNIX sockets.
+check_cxx_source_compiles("
+ #include <sys/socket.h>
+ #include <sys/un.h>
+
+ int main()
+ {
+ struct sockaddr_un addr;
+ addr.sun_family = AF_UNIX;
+ }
+ " HAVE_SOCKADDR_UN
+)
+
+# Check for different ways of gathering OS randomness:
+# - Linux getrandom()
+check_cxx_source_compiles("
+ #include <sys/random.h>
+
+ int main()
+ {
+ getrandom(nullptr, 32, 0);
+ }
+ " HAVE_GETRANDOM
+)
+
+# - BSD getentropy()
+check_cxx_source_compiles("
+ #include <sys/random.h>
+
+ int main()
+ {
+ getentropy(nullptr, 32);
+ }
+ " HAVE_GETENTROPY_RAND
+)
+
+
+# - BSD sysctl()
+check_cxx_source_compiles("
+ #include <sys/types.h>
+ #include <sys/sysctl.h>
+
+ #ifdef __linux__
+ #error Don't use sysctl on Linux, it's deprecated even when it works
+ #endif
+
+ int main()
+ {
+ sysctl(nullptr, 2, nullptr, nullptr, nullptr, 0);
+ }
+ " HAVE_SYSCTL
+)
+
+# - BSD sysctl(KERN_ARND)
+check_cxx_source_compiles("
+ #include <sys/types.h>
+ #include <sys/sysctl.h>
+
+ #ifdef __linux__
+ #error Don't use sysctl on Linux, it's deprecated even when it works
+ #endif
+
+ int main()
+ {
+ static int name[2] = {CTL_KERN, KERN_ARND};
+ sysctl(name, 2, nullptr, nullptr, nullptr, 0);
+ }
+ " HAVE_SYSCTL_ARND
+)
+
+if(NOT MSVC)
+ include(CheckSourceCompilesWithFlags)
+
+ # Check for SSE4.1 intrinsics.
+ set(SSE41_CXXFLAGS -msse4.1)
+ check_cxx_source_compiles_with_flags("
+ #include <immintrin.h>
+
+ int main()
+ {
+ __m128i a = _mm_set1_epi32(0);
+ __m128i b = _mm_set1_epi32(1);
+ __m128i r = _mm_blend_epi16(a, b, 0xFF);
+ return _mm_extract_epi32(r, 3);
+ }
+ " HAVE_SSE41
+ CXXFLAGS ${SSE41_CXXFLAGS}
+ )
+ set(ENABLE_SSE41 ${HAVE_SSE41})
+
+ # Check for AVX2 intrinsics.
+ set(AVX2_CXXFLAGS -mavx -mavx2)
+ check_cxx_source_compiles_with_flags("
+ #include <immintrin.h>
+
+ int main()
+ {
+ __m256i l = _mm256_set1_epi32(0);
+ return _mm256_extract_epi32(l, 7);
+ }
+ " HAVE_AVX2
+ CXXFLAGS ${AVX2_CXXFLAGS}
+ )
+ set(ENABLE_AVX2 ${HAVE_AVX2})
+
+ # Check for x86 SHA-NI intrinsics.
+ set(X86_SHANI_CXXFLAGS -msse4 -msha)
+ check_cxx_source_compiles_with_flags("
+ #include <immintrin.h>
+
+ int main()
+ {
+ __m128i i = _mm_set1_epi32(0);
+ __m128i j = _mm_set1_epi32(1);
+ __m128i k = _mm_set1_epi32(2);
+ return _mm_extract_epi32(_mm_sha256rnds2_epu32(i, j, k), 0);
+ }
+ " HAVE_X86_SHANI
+ CXXFLAGS ${X86_SHANI_CXXFLAGS}
+ )
+ set(ENABLE_X86_SHANI ${HAVE_X86_SHANI})
+
+ # Check for ARMv8 SHA-NI intrinsics.
+ set(ARM_SHANI_CXXFLAGS -march=armv8-a+crypto)
+ check_cxx_source_compiles_with_flags("
+ #include <arm_neon.h>
+
+ int main()
+ {
+ uint32x4_t a, b, c;
+ vsha256h2q_u32(a, b, c);
+ vsha256hq_u32(a, b, c);
+ vsha256su0q_u32(a, b);
+ vsha256su1q_u32(a, b, c);
+ }
+ " HAVE_ARM_SHANI
+ CXXFLAGS ${ARM_SHANI_CXXFLAGS}
+ )
+ set(ENABLE_ARM_SHANI ${HAVE_ARM_SHANI})
+endif()
diff --git a/cmake/leveldb.cmake b/cmake/leveldb.cmake
new file mode 100644
index 00000000..139c6a5b
--- /dev/null
+++ b/cmake/leveldb.cmake
@@ -0,0 +1,106 @@
+# 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/.
+
+# This file is part of the transition from Autotools to CMake. Once CMake
+# support has been merged we should switch to using the upstream CMake
+# buildsystem.
+
+include(CheckCXXSymbolExists)
+check_cxx_symbol_exists(F_FULLFSYNC "fcntl.h" HAVE_FULLFSYNC)
+
+add_library(leveldb STATIC EXCLUDE_FROM_ALL
+ ${PROJECT_SOURCE_DIR}/src/leveldb/db/builder.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/db/c.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/db/db_impl.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/db/db_iter.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/db/dbformat.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/db/dumpfile.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/db/filename.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/db/log_reader.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/db/log_writer.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/db/memtable.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/db/repair.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/db/table_cache.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/db/version_edit.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/db/version_set.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/db/write_batch.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/table/block.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/table/block_builder.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/table/filter_block.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/table/format.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/table/iterator.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/table/merger.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/table/table.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/table/table_builder.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/table/two_level_iterator.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/util/arena.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/util/bloom.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/util/cache.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/util/coding.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/util/comparator.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/util/crc32c.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/util/env.cc
+ $<$<NOT:$<BOOL:${WIN32}>>:${PROJECT_SOURCE_DIR}/src/leveldb/util/env_posix.cc>
+ $<$<BOOL:${WIN32}>:${PROJECT_SOURCE_DIR}/src/leveldb/util/env_windows.cc>
+ ${PROJECT_SOURCE_DIR}/src/leveldb/util/filter_policy.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/util/hash.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/util/histogram.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/util/logging.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/util/options.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/util/status.cc
+ ${PROJECT_SOURCE_DIR}/src/leveldb/helpers/memenv/memenv.cc
+)
+
+target_compile_definitions(leveldb
+ PRIVATE
+ HAVE_SNAPPY=0
+ HAVE_CRC32C=1
+ HAVE_FDATASYNC=$<BOOL:${HAVE_FDATASYNC}>
+ HAVE_FULLFSYNC=$<BOOL:${HAVE_FULLFSYNC}>
+ HAVE_O_CLOEXEC=$<BOOL:${HAVE_O_CLOEXEC}>
+ FALLTHROUGH_INTENDED=[[fallthrough]]
+ $<$<NOT:$<BOOL:${WIN32}>>:LEVELDB_PLATFORM_POSIX>
+ $<$<BOOL:${WIN32}>:LEVELDB_PLATFORM_WINDOWS>
+ $<$<BOOL:${WIN32}>:_UNICODE;UNICODE>
+)
+if(MINGW)
+ target_compile_definitions(leveldb
+ PRIVATE
+ __USE_MINGW_ANSI_STDIO=1
+ )
+endif()
+
+target_include_directories(leveldb
+ PRIVATE
+ $<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/src/leveldb>
+ PUBLIC
+ $<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/src/leveldb/include>
+)
+
+add_library(nowarn_leveldb_interface INTERFACE)
+if(MSVC)
+ target_compile_options(nowarn_leveldb_interface INTERFACE
+ /wd4722
+ )
+ target_compile_definitions(nowarn_leveldb_interface INTERFACE
+ _CRT_NONSTDC_NO_WARNINGS
+ )
+else()
+ try_append_cxx_flags("-Wconditional-uninitialized" TARGET nowarn_leveldb_interface SKIP_LINK
+ IF_CHECK_PASSED "-Wno-conditional-uninitialized"
+ )
+ try_append_cxx_flags("-Wsuggest-override" TARGET nowarn_leveldb_interface SKIP_LINK
+ IF_CHECK_PASSED "-Wno-suggest-override"
+ )
+endif()
+
+target_link_libraries(leveldb PRIVATE
+ core_interface
+ nowarn_leveldb_interface
+ crc32c
+)
+
+set_target_properties(leveldb PROPERTIES
+ EXPORT_COMPILE_COMMANDS OFF
+)
diff --git a/cmake/minisketch.cmake b/cmake/minisketch.cmake
new file mode 100644
index 00000000..5f57d25e
--- /dev/null
+++ b/cmake/minisketch.cmake
@@ -0,0 +1,89 @@
+# 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/.
+
+include(CheckSourceCompilesWithFlags)
+
+# Check for clmul instructions support.
+if(MSVC)
+ set(CLMUL_CXXFLAGS "")
+else()
+ set(CLMUL_CXXFLAGS -mpclmul)
+endif()
+check_cxx_source_compiles_with_flags("
+ #include <immintrin.h>
+ #include <cstdint>
+
+ int main()
+ {
+ __m128i a = _mm_cvtsi64_si128((uint64_t)7);
+ __m128i b = _mm_clmulepi64_si128(a, a, 37);
+ __m128i c = _mm_srli_epi64(b, 41);
+ __m128i d = _mm_xor_si128(b, c);
+ uint64_t e = _mm_cvtsi128_si64(d);
+ return e == 0;
+ }
+ " HAVE_CLMUL
+ CXXFLAGS ${CLMUL_CXXFLAGS}
+)
+
+add_library(minisketch_common INTERFACE)
+if(MSVC)
+ target_compile_options(minisketch_common INTERFACE
+ /wd4060
+ /wd4065
+ /wd4146
+ /wd4244
+ /wd4267
+ )
+endif()
+
+add_library(minisketch STATIC EXCLUDE_FROM_ALL
+ ${PROJECT_SOURCE_DIR}/src/minisketch/src/minisketch.cpp
+ ${PROJECT_SOURCE_DIR}/src/minisketch/src/fields/generic_1byte.cpp
+ ${PROJECT_SOURCE_DIR}/src/minisketch/src/fields/generic_2bytes.cpp
+ ${PROJECT_SOURCE_DIR}/src/minisketch/src/fields/generic_3bytes.cpp
+ ${PROJECT_SOURCE_DIR}/src/minisketch/src/fields/generic_4bytes.cpp
+ ${PROJECT_SOURCE_DIR}/src/minisketch/src/fields/generic_5bytes.cpp
+ ${PROJECT_SOURCE_DIR}/src/minisketch/src/fields/generic_6bytes.cpp
+ ${PROJECT_SOURCE_DIR}/src/minisketch/src/fields/generic_7bytes.cpp
+ ${PROJECT_SOURCE_DIR}/src/minisketch/src/fields/generic_8bytes.cpp
+)
+
+target_compile_definitions(minisketch
+ PRIVATE
+ DISABLE_DEFAULT_FIELDS
+ ENABLE_FIELD_32
+)
+
+target_include_directories(minisketch
+ PUBLIC
+ $<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/src/minisketch/include>
+)
+
+target_link_libraries(minisketch
+ PRIVATE
+ core_interface
+ minisketch_common
+)
+
+set_target_properties(minisketch PROPERTIES
+ EXPORT_COMPILE_COMMANDS OFF
+)
+
+if(HAVE_CLMUL)
+ set(_minisketch_clmul_src
+ ${PROJECT_SOURCE_DIR}/src/minisketch/src/fields/clmul_1byte.cpp
+ ${PROJECT_SOURCE_DIR}/src/minisketch/src/fields/clmul_2bytes.cpp
+ ${PROJECT_SOURCE_DIR}/src/minisketch/src/fields/clmul_3bytes.cpp
+ ${PROJECT_SOURCE_DIR}/src/minisketch/src/fields/clmul_4bytes.cpp
+ ${PROJECT_SOURCE_DIR}/src/minisketch/src/fields/clmul_5bytes.cpp
+ ${PROJECT_SOURCE_DIR}/src/minisketch/src/fields/clmul_6bytes.cpp
+ ${PROJECT_SOURCE_DIR}/src/minisketch/src/fields/clmul_7bytes.cpp
+ ${PROJECT_SOURCE_DIR}/src/minisketch/src/fields/clmul_8bytes.cpp
+ )
+ target_sources(minisketch PRIVATE ${_minisketch_clmul_src})
+ set_property(SOURCE ${_minisketch_clmul_src} PROPERTY COMPILE_OPTIONS ${CLMUL_CXXFLAGS})
+ target_compile_definitions(minisketch PRIVATE HAVE_CLMUL)
+ unset(_minisketch_clmul_src)
+endif()
diff --git a/cmake/module/AddBoostIfNeeded.cmake b/cmake/module/AddBoostIfNeeded.cmake
new file mode 100644
index 00000000..ecd0d6f2
--- /dev/null
+++ b/cmake/module/AddBoostIfNeeded.cmake
@@ -0,0 +1,78 @@
+# 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/.
+
+function(add_boost_if_needed)
+ #[=[
+ TODO: Not all targets, which will be added in the future, require
+ Boost. Therefore, a proper check will be appropriate here.
+
+ Implementation notes:
+ Although only Boost headers are used to build Bitcoin Core,
+ we still leverage a standard CMake's approach to handle
+ dependencies, i.e., the Boost::headers "library".
+ A command target_link_libraries(target PRIVATE Boost::headers)
+ will propagate Boost::headers usage requirements to the target.
+ For Boost::headers such usage requirements is an include
+ directory and other added INTERFACE properties.
+ ]=]
+
+ # We cannot rely on find_package(Boost ...) to work properly without
+ # Boost_NO_BOOST_CMAKE set until we require a more recent Boost because
+ # upstream did not ship proper CMake files until 1.82.0.
+ # Until then, we rely on CMake's FindBoost module.
+ # See: https://cmake.org/cmake/help/latest/policy/CMP0167.html
+ if(POLICY CMP0167)
+ cmake_policy(SET CMP0167 OLD)
+ endif()
+ set(Boost_NO_BOOST_CMAKE ON)
+ find_package(Boost 1.73.0 REQUIRED)
+ mark_as_advanced(Boost_INCLUDE_DIR)
+ set_target_properties(Boost::headers PROPERTIES IMPORTED_GLOBAL TRUE)
+ target_compile_definitions(Boost::headers INTERFACE
+ # We don't use multi_index serialization.
+ BOOST_MULTI_INDEX_DISABLE_SERIALIZATION
+ )
+ if(DEFINED VCPKG_TARGET_TRIPLET)
+ # Workaround for https://github.com/microsoft/vcpkg/issues/36955.
+ target_compile_definitions(Boost::headers INTERFACE
+ BOOST_NO_USER_CONFIG
+ )
+ endif()
+
+ # Prevent use of std::unary_function, which was removed in C++17,
+ # and will generate warnings with newer compilers for Boost
+ # older than 1.80.
+ # See: https://github.com/boostorg/config/pull/430.
+ set(CMAKE_REQUIRED_DEFINITIONS -DBOOST_NO_CXX98_FUNCTION_BASE)
+ set(CMAKE_REQUIRED_INCLUDES ${Boost_INCLUDE_DIR})
+ include(CMakePushCheckState)
+ cmake_push_check_state()
+ include(TryAppendCXXFlags)
+ set(CMAKE_REQUIRED_FLAGS ${working_compiler_werror_flag})
+ set(CMAKE_TRY_COMPILE_TARGET_TYPE STATIC_LIBRARY)
+ check_cxx_source_compiles("
+ #include <boost/config.hpp>
+ " NO_DIAGNOSTICS_BOOST_NO_CXX98_FUNCTION_BASE
+ )
+ cmake_pop_check_state()
+ if(NO_DIAGNOSTICS_BOOST_NO_CXX98_FUNCTION_BASE)
+ target_compile_definitions(Boost::headers INTERFACE
+ BOOST_NO_CXX98_FUNCTION_BASE
+ )
+ else()
+ set(CMAKE_REQUIRED_DEFINITIONS)
+ endif()
+
+ # Some package managers, such as vcpkg, vendor Boost.Test separately
+ # from the rest of the headers, so we have to check for it individually.
+ if(BUILD_TESTS AND DEFINED VCPKG_TARGET_TRIPLET)
+ list(APPEND CMAKE_REQUIRED_DEFINITIONS -DBOOST_TEST_NO_MAIN)
+ include(CheckIncludeFileCXX)
+ check_include_file_cxx(boost/test/included/unit_test.hpp HAVE_BOOST_INCLUDED_UNIT_TEST_H)
+ if(NOT HAVE_BOOST_INCLUDED_UNIT_TEST_H)
+ message(FATAL_ERROR "Building test_bitcoin executable requested but boost/test/included/unit_test.hpp header not available.")
+ endif()
+ endif()
+
+endfunction()
diff --git a/cmake/module/AddWindowsResources.cmake b/cmake/module/AddWindowsResources.cmake
new file mode 100644
index 00000000..a9b4f51f
--- /dev/null
+++ b/cmake/module/AddWindowsResources.cmake
@@ -0,0 +1,14 @@
+# Copyright (c) 2024-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or https://opensource.org/license/mit/.
+
+include_guard(GLOBAL)
+
+macro(add_windows_resources target rc_file)
+ if(WIN32)
+ target_sources(${target} PRIVATE ${rc_file})
+ set_property(SOURCE ${rc_file}
+ APPEND PROPERTY COMPILE_DEFINITIONS WINDRES_PREPROC
+ )
+ endif()
+endmacro()
diff --git a/cmake/module/CheckLinkerSupportsPIE.cmake b/cmake/module/CheckLinkerSupportsPIE.cmake
new file mode 100644
index 00000000..f3897e56
--- /dev/null
+++ b/cmake/module/CheckLinkerSupportsPIE.cmake
@@ -0,0 +1,27 @@
+# Copyright (c) 2024-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or https://opensource.org/license/mit/.
+
+include_guard(GLOBAL)
+
+function(check_linker_supports_pie warnings)
+ # Workaround for a bug in the check_pie_supported() function.
+ # See:
+ # - https://gitlab.kitware.com/cmake/cmake/-/issues/26463
+ # - https://gitlab.kitware.com/cmake/cmake/-/merge_requests/10034
+ if(CMAKE_VERSION VERSION_LESS 3.32)
+ # CMAKE_CXX_COMPILE_OPTIONS_PIE is a list, whereas CMAKE_REQUIRED_FLAGS
+ # must be a string. Therefore, a proper conversion is required.
+ list(JOIN CMAKE_CXX_COMPILE_OPTIONS_PIE " " CMAKE_REQUIRED_FLAGS)
+ endif()
+
+ include(CheckPIESupported)
+ check_pie_supported(OUTPUT_VARIABLE output LANGUAGES CXX)
+ if(CMAKE_CXX_LINK_PIE_SUPPORTED)
+ set(CMAKE_POSITION_INDEPENDENT_CODE ON PARENT_SCOPE)
+ elseif(NOT WIN32)
+ # The warning is superfluous for Windows.
+ message(WARNING "PIE is not supported at link time. See the configure log for details.")
+ set(${warnings} ${${warnings}} "Position independent code disabled." PARENT_SCOPE)
+ endif()
+endfunction()
diff --git a/cmake/module/CheckSourceCompilesWithFlags.cmake b/cmake/module/CheckSourceCompilesWithFlags.cmake
new file mode 100644
index 00000000..02bd7265
--- /dev/null
+++ b/cmake/module/CheckSourceCompilesWithFlags.cmake
@@ -0,0 +1,34 @@
+# 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/.
+
+include_guard(GLOBAL)
+
+#[=[
+Check once if C++ source code can be compiled.
+
+Options:
+
+ CXXFLAGS - A list of additional flags to pass to the compiler.
+
+ LDFLAGS - A list of additional flags to pass to the linker.
+
+ LINK_LIBRARIES - A list of libraries to add to the link command.
+
+For historical reasons, among the CMake `CMAKE_REQUIRED_*` variables that influence
+`check_cxx_source_compiles()`, only `CMAKE_REQUIRED_FLAGS` is a string rather than
+a list. Additionally, `target_compile_options()` also expects a list of options.
+
+The `check_cxx_source_compiles_with_flags()` function handles this case and accepts
+`CXXFLAGS` as a list, simplifying the code at the caller site.
+
+#]=]
+function(check_cxx_source_compiles_with_flags source result_var)
+ cmake_parse_arguments(PARSE_ARGV 2 _ "" "" "CXXFLAGS;LDFLAGS;LINK_LIBRARIES")
+ list(JOIN __CXXFLAGS " " CMAKE_REQUIRED_FLAGS)
+ set(CMAKE_REQUIRED_LINK_OPTIONS ${__LDFLAGS})
+ set(CMAKE_REQUIRED_LIBRARIES ${__LINK_LIBRARIES})
+ include(CheckCXXSourceCompiles)
+ check_cxx_source_compiles("${source}" ${result_var})
+ set(${result_var} ${${result_var}} PARENT_SCOPE)
+endfunction()
diff --git a/cmake/module/FindBerkeleyDB.cmake b/cmake/module/FindBerkeleyDB.cmake
new file mode 100644
index 00000000..03a3cce1
--- /dev/null
+++ b/cmake/module/FindBerkeleyDB.cmake
@@ -0,0 +1,133 @@
+# 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/.
+
+#[=======================================================================[
+FindBerkeleyDB
+--------------
+
+Finds the Berkeley DB headers and library.
+
+Imported Targets
+^^^^^^^^^^^^^^^^
+
+This module provides imported target ``BerkeleyDB::BerkeleyDB``, if
+Berkeley DB has been found.
+
+Result Variables
+^^^^^^^^^^^^^^^^
+
+This module defines the following variables:
+
+``BerkeleyDB_FOUND``
+ "True" if Berkeley DB found.
+
+``BerkeleyDB_VERSION``
+ The MAJOR.MINOR version of Berkeley DB found.
+
+#]=======================================================================]
+
+set(_BerkeleyDB_homebrew_prefix)
+if(CMAKE_HOST_APPLE)
+ find_program(HOMEBREW_EXECUTABLE brew)
+ if(HOMEBREW_EXECUTABLE)
+ # The Homebrew package manager installs the berkeley-db* packages as
+ # "keg-only", which means they are not symlinked into the default prefix.
+ # To find such a package, the find_path() and find_library() commands
+ # need additional path hints that are computed by Homebrew itself.
+ execute_process(
+ COMMAND ${HOMEBREW_EXECUTABLE} --prefix berkeley-db@4
+ OUTPUT_VARIABLE _BerkeleyDB_homebrew_prefix
+ ERROR_QUIET
+ OUTPUT_STRIP_TRAILING_WHITESPACE
+ )
+ endif()
+endif()
+
+find_path(BerkeleyDB_INCLUDE_DIR
+ NAMES db_cxx.h
+ HINTS ${_BerkeleyDB_homebrew_prefix}/include
+ PATH_SUFFIXES 4.8 48 db4.8 4 db4 5.3 db5.3 5 db5
+)
+mark_as_advanced(BerkeleyDB_INCLUDE_DIR)
+unset(_BerkeleyDB_homebrew_prefix)
+
+if(NOT BerkeleyDB_LIBRARY)
+ if(VCPKG_TARGET_TRIPLET)
+ # The vcpkg package manager installs the berkeleydb package with the same name
+ # of release and debug libraries. Therefore, the default search paths set by
+ # vcpkg's toolchain file cannot be used to search libraries as the debug one
+ # will always be found.
+ set(CMAKE_FIND_USE_CMAKE_PATH FALSE)
+ endif()
+
+ get_filename_component(_BerkeleyDB_lib_hint "${BerkeleyDB_INCLUDE_DIR}" DIRECTORY)
+
+ find_library(BerkeleyDB_LIBRARY_RELEASE
+ NAMES db_cxx-4.8 db4_cxx db48 db_cxx-5.3 db_cxx-5 db_cxx libdb48
+ NAMES_PER_DIR
+ HINTS ${_BerkeleyDB_lib_hint}
+ PATH_SUFFIXES lib
+ )
+ mark_as_advanced(BerkeleyDB_LIBRARY_RELEASE)
+
+ find_library(BerkeleyDB_LIBRARY_DEBUG
+ NAMES db_cxx-4.8 db4_cxx db48 db_cxx-5.3 db_cxx-5 db_cxx libdb48
+ NAMES_PER_DIR
+ HINTS ${_BerkeleyDB_lib_hint}
+ PATH_SUFFIXES debug/lib
+ )
+ mark_as_advanced(BerkeleyDB_LIBRARY_DEBUG)
+
+ unset(_BerkeleyDB_lib_hint)
+ unset(CMAKE_FIND_USE_CMAKE_PATH)
+
+ include(SelectLibraryConfigurations)
+ select_library_configurations(BerkeleyDB)
+ # The select_library_configurations() command sets BerkeleyDB_FOUND, but we
+ # want the one from the find_package_handle_standard_args() command below.
+ unset(BerkeleyDB_FOUND)
+endif()
+
+if(BerkeleyDB_INCLUDE_DIR)
+ file(STRINGS "${BerkeleyDB_INCLUDE_DIR}/db.h" _BerkeleyDB_version_strings REGEX "^#define[\t ]+DB_VERSION_(MAJOR|MINOR|PATCH)[ \t]+[0-9]+.*")
+ string(REGEX REPLACE ".*#define[\t ]+DB_VERSION_MAJOR[ \t]+([0-9]+).*" "\\1" _BerkeleyDB_version_major "${_BerkeleyDB_version_strings}")
+ string(REGEX REPLACE ".*#define[\t ]+DB_VERSION_MINOR[ \t]+([0-9]+).*" "\\1" _BerkeleyDB_version_minor "${_BerkeleyDB_version_strings}")
+ string(REGEX REPLACE ".*#define[\t ]+DB_VERSION_PATCH[ \t]+([0-9]+).*" "\\1" _BerkeleyDB_version_patch "${_BerkeleyDB_version_strings}")
+ unset(_BerkeleyDB_version_strings)
+ # The MAJOR.MINOR.PATCH version will be logged in the following find_package_handle_standard_args() command.
+ set(_BerkeleyDB_full_version ${_BerkeleyDB_version_major}.${_BerkeleyDB_version_minor}.${_BerkeleyDB_version_patch})
+ set(BerkeleyDB_VERSION ${_BerkeleyDB_version_major}.${_BerkeleyDB_version_minor})
+ unset(_BerkeleyDB_version_major)
+ unset(_BerkeleyDB_version_minor)
+ unset(_BerkeleyDB_version_patch)
+endif()
+
+include(FindPackageHandleStandardArgs)
+find_package_handle_standard_args(BerkeleyDB
+ REQUIRED_VARS BerkeleyDB_LIBRARY BerkeleyDB_INCLUDE_DIR
+ VERSION_VAR _BerkeleyDB_full_version
+)
+unset(_BerkeleyDB_full_version)
+
+if(BerkeleyDB_FOUND AND NOT TARGET BerkeleyDB::BerkeleyDB)
+ add_library(BerkeleyDB::BerkeleyDB UNKNOWN IMPORTED)
+ set_target_properties(BerkeleyDB::BerkeleyDB PROPERTIES
+ INTERFACE_INCLUDE_DIRECTORIES "${BerkeleyDB_INCLUDE_DIR}"
+ )
+ if(BerkeleyDB_LIBRARY_RELEASE)
+ set_property(TARGET BerkeleyDB::BerkeleyDB APPEND PROPERTY
+ IMPORTED_CONFIGURATIONS RELEASE
+ )
+ set_target_properties(BerkeleyDB::BerkeleyDB PROPERTIES
+ IMPORTED_LOCATION_RELEASE "${BerkeleyDB_LIBRARY_RELEASE}"
+ )
+ endif()
+ if(BerkeleyDB_LIBRARY_DEBUG)
+ set_property(TARGET BerkeleyDB::BerkeleyDB APPEND PROPERTY
+ IMPORTED_CONFIGURATIONS DEBUG)
+ set_target_properties(BerkeleyDB::BerkeleyDB PROPERTIES
+ IMPORTED_LOCATION_DEBUG "${BerkeleyDB_LIBRARY_DEBUG}"
+ )
+ endif()
+endif()
diff --git a/cmake/module/FindLibevent.cmake b/cmake/module/FindLibevent.cmake
new file mode 100644
index 00000000..c006b43d
--- /dev/null
+++ b/cmake/module/FindLibevent.cmake
@@ -0,0 +1,86 @@
+# Copyright (c) 2024-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or https://opensource.org/license/mit/.
+
+#[=======================================================================[
+FindLibevent
+------------
+
+Finds the Libevent headers and libraries.
+
+This is a wrapper around find_package()/pkg_check_modules() commands that:
+ - facilitates searching in various build environments
+ - prints a standard log message
+
+#]=======================================================================]
+
+# Check whether evhttp_connection_get_peer expects const char**.
+# See https://github.com/libevent/libevent/commit/a18301a2bb160ff7c3ffaf5b7653c39ffe27b385
+function(check_evhttp_connection_get_peer target)
+ include(CMakePushCheckState)
+ cmake_push_check_state(RESET)
+ set(CMAKE_REQUIRED_LIBRARIES ${target})
+ include(CheckCXXSourceCompiles)
+ check_cxx_source_compiles("
+ #include <cstdint>
+ #include <event2/http.h>
+
+ int main()
+ {
+ evhttp_connection* conn = (evhttp_connection*)1;
+ const char* host;
+ uint16_t port;
+ evhttp_connection_get_peer(conn, &host, &port);
+ }
+ " HAVE_EVHTTP_CONNECTION_GET_PEER_CONST_CHAR
+ )
+ cmake_pop_check_state()
+ target_compile_definitions(${target} INTERFACE
+ $<$<BOOL:${HAVE_EVHTTP_CONNECTION_GET_PEER_CONST_CHAR}>:HAVE_EVHTTP_CONNECTION_GET_PEER_CONST_CHAR>
+ )
+endfunction()
+
+set(_libevent_components core extra)
+if(NOT WIN32)
+ list(APPEND _libevent_components pthreads)
+endif()
+
+find_package(Libevent ${Libevent_FIND_VERSION} QUIET
+ NO_MODULE
+)
+
+include(FindPackageHandleStandardArgs)
+if(Libevent_FOUND)
+ find_package(Libevent ${Libevent_FIND_VERSION} QUIET
+ REQUIRED COMPONENTS ${_libevent_components}
+ NO_MODULE
+ )
+ find_package_handle_standard_args(Libevent
+ REQUIRED_VARS Libevent_DIR
+ VERSION_VAR Libevent_VERSION
+ )
+ check_evhttp_connection_get_peer(libevent::extra)
+else()
+ find_package(PkgConfig REQUIRED)
+ foreach(component IN LISTS _libevent_components)
+ pkg_check_modules(libevent_${component}
+ REQUIRED QUIET
+ IMPORTED_TARGET GLOBAL
+ libevent_${component}>=${Libevent_FIND_VERSION}
+ )
+ if(TARGET PkgConfig::libevent_${component} AND NOT TARGET libevent::${component})
+ add_library(libevent::${component} ALIAS PkgConfig::libevent_${component})
+ endif()
+ endforeach()
+ find_package_handle_standard_args(Libevent
+ REQUIRED_VARS libevent_core_LIBRARY_DIRS
+ VERSION_VAR libevent_core_VERSION
+ )
+ check_evhttp_connection_get_peer(PkgConfig::libevent_extra)
+endif()
+
+unset(_libevent_components)
+
+mark_as_advanced(Libevent_DIR)
+mark_as_advanced(_event_h)
+mark_as_advanced(_event_lib)
diff --git a/cmake/module/FindQRencode.cmake b/cmake/module/FindQRencode.cmake
new file mode 100644
index 00000000..39e3b8b6
--- /dev/null
+++ b/cmake/module/FindQRencode.cmake
@@ -0,0 +1,71 @@
+# Copyright (c) 2024-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or https://opensource.org/license/mit/.
+
+#[=======================================================================[
+FindQRencode
+------------
+
+Finds the QRencode header and library.
+
+This is a wrapper around find_package()/pkg_check_modules() commands that:
+ - facilitates searching in various build environments
+ - prints a standard log message
+
+#]=======================================================================]
+
+find_package(PkgConfig QUIET)
+if(PKG_CONFIG_FOUND)
+ pkg_check_modules(PC_QRencode QUIET libqrencode)
+endif()
+
+find_path(QRencode_INCLUDE_DIR
+ NAMES qrencode.h
+ PATHS ${PC_QRencode_INCLUDE_DIRS}
+)
+
+find_library(QRencode_LIBRARY_RELEASE
+ NAMES qrencode
+ PATHS ${PC_QRencode_LIBRARY_DIRS}
+)
+find_library(QRencode_LIBRARY_DEBUG
+ NAMES qrencoded qrencode
+ PATHS ${PC_QRencode_LIBRARY_DIRS}
+)
+include(SelectLibraryConfigurations)
+select_library_configurations(QRencode)
+
+include(FindPackageHandleStandardArgs)
+find_package_handle_standard_args(QRencode
+ REQUIRED_VARS QRencode_LIBRARY QRencode_INCLUDE_DIR
+ VERSION_VAR PC_QRencode_VERSION
+)
+
+if(QRencode_FOUND)
+ if(NOT TARGET QRencode::QRencode)
+ add_library(QRencode::QRencode UNKNOWN IMPORTED)
+ endif()
+ if(QRencode_LIBRARY_RELEASE)
+ set_property(TARGET QRencode::QRencode APPEND PROPERTY
+ IMPORTED_CONFIGURATIONS RELEASE
+ )
+ set_target_properties(QRencode::QRencode PROPERTIES
+ IMPORTED_LOCATION_RELEASE "${QRencode_LIBRARY_RELEASE}"
+ )
+ endif()
+ if(QRencode_LIBRARY_DEBUG)
+ set_property(TARGET QRencode::QRencode APPEND PROPERTY
+ IMPORTED_CONFIGURATIONS DEBUG
+ )
+ set_target_properties(QRencode::QRencode PROPERTIES
+ IMPORTED_LOCATION_DEBUG "${QRencode_LIBRARY_DEBUG}"
+ )
+ endif()
+ set_target_properties(QRencode::QRencode PROPERTIES
+ INTERFACE_INCLUDE_DIRECTORIES "${QRencode_INCLUDE_DIR}"
+ )
+endif()
+
+mark_as_advanced(
+ QRencode_INCLUDE_DIR
+)
diff --git a/cmake/module/FindQt.cmake b/cmake/module/FindQt.cmake
new file mode 100644
index 00000000..2e43294a
--- /dev/null
+++ b/cmake/module/FindQt.cmake
@@ -0,0 +1,66 @@
+# Copyright (c) 2024-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or https://opensource.org/license/mit/.
+
+#[=======================================================================[
+FindQt
+------
+
+Finds the Qt headers and libraries.
+
+This is a wrapper around find_package() command that:
+ - facilitates searching in various build environments
+ - prints a standard log message
+
+#]=======================================================================]
+
+set(_qt_homebrew_prefix)
+if(CMAKE_HOST_APPLE)
+ find_program(HOMEBREW_EXECUTABLE brew)
+ if(HOMEBREW_EXECUTABLE)
+ execute_process(
+ COMMAND ${HOMEBREW_EXECUTABLE} --prefix qt@${Qt_FIND_VERSION_MAJOR}
+ OUTPUT_VARIABLE _qt_homebrew_prefix
+ ERROR_QUIET
+ OUTPUT_STRIP_TRAILING_WHITESPACE
+ )
+ endif()
+endif()
+
+# Save CMAKE_FIND_ROOT_PATH_MODE_LIBRARY state.
+unset(_qt_find_root_path_mode_library_saved)
+if(DEFINED CMAKE_FIND_ROOT_PATH_MODE_LIBRARY)
+ set(_qt_find_root_path_mode_library_saved ${CMAKE_FIND_ROOT_PATH_MODE_LIBRARY})
+endif()
+
+# The Qt config files internally use find_library() calls for all
+# dependencies to ensure their availability. In turn, the find_library()
+# inspects the well-known locations on the file system; therefore, it must
+# be able to find platform-specific system libraries, for example:
+# /usr/x86_64-w64-mingw32/lib/libm.a or /usr/arm-linux-gnueabihf/lib/libm.a.
+set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY BOTH)
+
+find_package(Qt${Qt_FIND_VERSION_MAJOR} ${Qt_FIND_VERSION}
+ COMPONENTS ${Qt_FIND_COMPONENTS}
+ HINTS ${_qt_homebrew_prefix}
+ PATH_SUFFIXES Qt${Qt_FIND_VERSION_MAJOR} # Required on OpenBSD systems.
+)
+unset(_qt_homebrew_prefix)
+
+# Restore CMAKE_FIND_ROOT_PATH_MODE_LIBRARY state.
+if(DEFINED _qt_find_root_path_mode_library_saved)
+ set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ${_qt_find_root_path_mode_library_saved})
+ unset(_qt_find_root_path_mode_library_saved)
+else()
+ unset(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY)
+endif()
+
+include(FindPackageHandleStandardArgs)
+find_package_handle_standard_args(Qt
+ REQUIRED_VARS Qt${Qt_FIND_VERSION_MAJOR}_DIR
+ VERSION_VAR Qt${Qt_FIND_VERSION_MAJOR}_VERSION
+)
+
+foreach(component IN LISTS Qt_FIND_COMPONENTS ITEMS "")
+ mark_as_advanced(Qt${Qt_FIND_VERSION_MAJOR}${component}_DIR)
+endforeach()
diff --git a/cmake/module/FindUSDT.cmake b/cmake/module/FindUSDT.cmake
new file mode 100644
index 00000000..0be7c28f
--- /dev/null
+++ b/cmake/module/FindUSDT.cmake
@@ -0,0 +1,67 @@
+# Copyright (c) 2024-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or https://opensource.org/license/mit/.
+
+#[=======================================================================[
+FindUSDT
+--------
+
+Finds the Userspace, Statically Defined Tracing header(s).
+
+Imported Targets
+^^^^^^^^^^^^^^^^
+
+This module provides imported target ``USDT::headers``, if
+USDT has been found.
+
+Result Variables
+^^^^^^^^^^^^^^^^
+
+This module defines the following variables:
+
+``USDT_FOUND``
+ "True" if USDT found.
+
+#]=======================================================================]
+
+find_path(USDT_INCLUDE_DIR
+ NAMES sys/sdt.h
+)
+mark_as_advanced(USDT_INCLUDE_DIR)
+
+if(USDT_INCLUDE_DIR)
+ include(CMakePushCheckState)
+ cmake_push_check_state(RESET)
+
+ include(CheckCXXSourceCompiles)
+ set(CMAKE_REQUIRED_INCLUDES ${USDT_INCLUDE_DIR})
+ check_cxx_source_compiles("
+ // Setting SDT_USE_VARIADIC lets systemtap (sys/sdt.h) know that we want to use
+ // the optional variadic macros to define tracepoints.
+ #define SDT_USE_VARIADIC 1
+ #include <sys/sdt.h>
+
+ int main()
+ {
+ STAP_PROBEV(context, event);
+ int a, b, c, d, e, f, g;
+ STAP_PROBEV(context, event, a, b, c, d, e, f, g);
+ }
+ " HAVE_USDT_H
+ )
+
+ cmake_pop_check_state()
+endif()
+
+include(FindPackageHandleStandardArgs)
+find_package_handle_standard_args(USDT
+ REQUIRED_VARS USDT_INCLUDE_DIR HAVE_USDT_H
+)
+
+if(USDT_FOUND AND NOT TARGET USDT::headers)
+ add_library(USDT::headers INTERFACE IMPORTED)
+ set_target_properties(USDT::headers PROPERTIES
+ INTERFACE_INCLUDE_DIRECTORIES "${USDT_INCLUDE_DIR}"
+ )
+ set(ENABLE_TRACING TRUE)
+endif()
diff --git a/cmake/module/FindZeroMQ.cmake b/cmake/module/FindZeroMQ.cmake
new file mode 100644
index 00000000..eecd9b24
--- /dev/null
+++ b/cmake/module/FindZeroMQ.cmake
@@ -0,0 +1,41 @@
+# Copyright (c) 2024-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or https://opensource.org/license/mit/.
+
+#[=======================================================================[
+FindZeroMQ
+----------
+
+Finds the ZeroMQ headers and library.
+
+This is a wrapper around find_package()/pkg_check_modules() commands that:
+ - facilitates searching in various build environments
+ - prints a standard log message
+
+#]=======================================================================]
+
+include(FindPackageHandleStandardArgs)
+find_package(ZeroMQ ${ZeroMQ_FIND_VERSION} NO_MODULE QUIET)
+if(ZeroMQ_FOUND)
+ find_package_handle_standard_args(ZeroMQ
+ REQUIRED_VARS ZeroMQ_DIR
+ VERSION_VAR ZeroMQ_VERSION
+ )
+ if(TARGET libzmq)
+ add_library(zeromq ALIAS libzmq)
+ elseif(TARGET libzmq-static)
+ add_library(zeromq ALIAS libzmq-static)
+ endif()
+ mark_as_advanced(ZeroMQ_DIR)
+else()
+ find_package(PkgConfig REQUIRED)
+ pkg_check_modules(libzmq QUIET
+ IMPORTED_TARGET
+ libzmq>=${ZeroMQ_FIND_VERSION}
+ )
+ find_package_handle_standard_args(ZeroMQ
+ REQUIRED_VARS libzmq_LIBRARY_DIRS
+ VERSION_VAR libzmq_VERSION
+ )
+ add_library(zeromq ALIAS PkgConfig::libzmq)
+endif()
diff --git a/cmake/module/FlagsSummary.cmake b/cmake/module/FlagsSummary.cmake
new file mode 100644
index 00000000..91d1df90
--- /dev/null
+++ b/cmake/module/FlagsSummary.cmake
@@ -0,0 +1,74 @@
+# Copyright (c) 2024-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or https://opensource.org/license/mit/.
+
+include_guard(GLOBAL)
+
+function(indent_message header content indent_num)
+ if(indent_num GREATER 0)
+ string(REPEAT " " ${indent_num} indentation)
+ string(REPEAT "." ${indent_num} tail)
+ string(REGEX REPLACE "${tail}$" "" header "${header}")
+ endif()
+ message("${indentation}${header} ${content}")
+endfunction()
+
+# Print tools' flags on best-effort. Include the abstracted
+# CMake flags that we touch ourselves.
+function(print_flags_per_config config indent_num)
+ string(TOUPPER "${config}" config_uppercase)
+
+ include(GetTargetInterface)
+ get_target_interface(definitions "${config}" core_interface COMPILE_DEFINITIONS)
+ indent_message("Preprocessor defined macros ..........." "${definitions}" ${indent_num})
+
+ string(STRIP "${CMAKE_CXX_COMPILER_ARG1} ${CMAKE_CXX_FLAGS}" combined_cxx_flags)
+ string(STRIP "${combined_cxx_flags} ${CMAKE_CXX_FLAGS_${config_uppercase}}" combined_cxx_flags)
+ string(STRIP "${combined_cxx_flags} ${CMAKE_CXX${CMAKE_CXX_STANDARD}_STANDARD_COMPILE_OPTION}" combined_cxx_flags)
+ if(CMAKE_POSITION_INDEPENDENT_CODE)
+ string(JOIN " " combined_cxx_flags ${combined_cxx_flags} ${CMAKE_CXX_COMPILE_OPTIONS_PIC})
+ endif()
+ get_target_interface(core_cxx_flags "${config}" core_interface COMPILE_OPTIONS)
+ string(STRIP "${combined_cxx_flags} ${core_cxx_flags}" combined_cxx_flags)
+ string(STRIP "${combined_cxx_flags} ${APPEND_CPPFLAGS}" combined_cxx_flags)
+ string(STRIP "${combined_cxx_flags} ${APPEND_CXXFLAGS}" combined_cxx_flags)
+ indent_message("C++ compiler flags ...................." "${combined_cxx_flags}" ${indent_num})
+
+ string(STRIP "${CMAKE_CXX_FLAGS} ${CMAKE_CXX_FLAGS_${config_uppercase}}" combined_linker_flags)
+ string(STRIP "${combined_linker_flags} ${CMAKE_EXE_LINKER_FLAGS}" combined_linker_flags)
+ get_target_interface(common_link_options "${config}" core_interface LINK_OPTIONS)
+ string(STRIP "${combined_linker_flags} ${common_link_options}" combined_linker_flags)
+ if(CMAKE_CXX_LINK_PIE_SUPPORTED)
+ string(JOIN " " combined_linker_flags ${combined_linker_flags} ${CMAKE_CXX_LINK_OPTIONS_PIE})
+ endif()
+ string(STRIP "${combined_linker_flags} ${APPEND_LDFLAGS}" combined_linker_flags)
+ indent_message("Linker flags .........................." "${combined_linker_flags}" ${indent_num})
+endfunction()
+
+function(flags_summary)
+ get_property(is_multi_config GLOBAL PROPERTY GENERATOR_IS_MULTI_CONFIG)
+ if(is_multi_config)
+ list(JOIN CMAKE_CONFIGURATION_TYPES ", " configs)
+ message("Available build configurations ........ ${configs}")
+ if(CMAKE_GENERATOR MATCHES "Visual Studio")
+ set(default_config "Debug")
+ else()
+ list(GET CMAKE_CONFIGURATION_TYPES 0 default_config)
+ endif()
+ message("Default build configuration ........... ${default_config}")
+ foreach(config IN LISTS CMAKE_CONFIGURATION_TYPES)
+ message("")
+ message("'${config}' build configuration:")
+ print_flags_per_config("${config}" 2)
+ endforeach()
+ else()
+ message("CMAKE_BUILD_TYPE ...................... ${CMAKE_BUILD_TYPE}")
+ print_flags_per_config("${CMAKE_BUILD_TYPE}" 0)
+ endif()
+ message("")
+ message([=[
+NOTE: The summary above may not exactly match the final applied build flags
+ if any additional CMAKE_* or environment variables have been modified.
+ To see the exact flags applied, build with the --verbose option.
+]=])
+endfunction()
diff --git a/cmake/module/GenerateSetupNsi.cmake b/cmake/module/GenerateSetupNsi.cmake
new file mode 100644
index 00000000..97a53b07
--- /dev/null
+++ b/cmake/module/GenerateSetupNsi.cmake
@@ -0,0 +1,18 @@
+# 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/.
+
+function(generate_setup_nsi)
+ set(abs_top_srcdir ${PROJECT_SOURCE_DIR})
+ set(abs_top_builddir ${PROJECT_BINARY_DIR})
+ set(CLIENT_URL ${PROJECT_HOMEPAGE_URL})
+ set(CLIENT_TARNAME "bitcoin")
+ set(BITCOIN_GUI_NAME "bitcoin-qt")
+ set(BITCOIN_DAEMON_NAME "bitcoind")
+ set(BITCOIN_CLI_NAME "bitcoin-cli")
+ set(BITCOIN_TX_NAME "bitcoin-tx")
+ set(BITCOIN_WALLET_TOOL_NAME "bitcoin-wallet")
+ set(BITCOIN_TEST_NAME "test_bitcoin")
+ set(EXEEXT ${CMAKE_EXECUTABLE_SUFFIX})
+ configure_file(${PROJECT_SOURCE_DIR}/share/setup.nsi.in ${PROJECT_BINARY_DIR}/bitcoin-win64-setup.nsi USE_SOURCE_PERMISSIONS @ONLY)
+endfunction()
diff --git a/cmake/module/GetTargetInterface.cmake b/cmake/module/GetTargetInterface.cmake
new file mode 100644
index 00000000..1e455d45
--- /dev/null
+++ b/cmake/module/GetTargetInterface.cmake
@@ -0,0 +1,53 @@
+# 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/.
+
+include_guard(GLOBAL)
+
+# Evaluates config-specific generator expressions in a list.
+# Recognizable patterns are:
+# - $<$<CONFIG:[config]>:[value]>
+# - $<$<NOT:$<CONFIG:[config]>>:[value]>
+function(evaluate_generator_expressions list config)
+ set(input ${${list}})
+ set(result)
+ foreach(token IN LISTS input)
+ if(token MATCHES "\\$<\\$<CONFIG:([^>]+)>:([^>]+)>")
+ if(CMAKE_MATCH_1 STREQUAL config)
+ list(APPEND result ${CMAKE_MATCH_2})
+ endif()
+ elseif(token MATCHES "\\$<\\$<NOT:\\$<CONFIG:([^>]+)>>:([^>]+)>")
+ if(NOT CMAKE_MATCH_1 STREQUAL config)
+ list(APPEND result ${CMAKE_MATCH_2})
+ endif()
+ else()
+ list(APPEND result ${token})
+ endif()
+ endforeach()
+ set(${list} ${result} PARENT_SCOPE)
+endfunction()
+
+
+# Gets target's interface properties recursively.
+function(get_target_interface var config target property)
+ get_target_property(result ${target} INTERFACE_${property})
+ if(result)
+ evaluate_generator_expressions(result "${config}")
+ list(JOIN result " " result)
+ else()
+ set(result)
+ endif()
+
+ get_target_property(dependencies ${target} INTERFACE_LINK_LIBRARIES)
+ if(dependencies)
+ evaluate_generator_expressions(dependencies "${config}")
+ foreach(dependency IN LISTS dependencies)
+ if(TARGET ${dependency})
+ get_target_interface(dep_result "${config}" ${dependency} ${property})
+ string(STRIP "${result} ${dep_result}" result)
+ endif()
+ endforeach()
+ endif()
+
+ set(${var} "${result}" PARENT_SCOPE)
+endfunction()
diff --git a/cmake/module/InstallBinaryComponent.cmake b/cmake/module/InstallBinaryComponent.cmake
new file mode 100644
index 00000000..c7b2ed9a
--- /dev/null
+++ b/cmake/module/InstallBinaryComponent.cmake
@@ -0,0 +1,26 @@
+# Copyright (c) 2025-present The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or https://opensource.org/license/mit/.
+
+include_guard(GLOBAL)
+include(GNUInstallDirs)
+
+function(install_binary_component component)
+ cmake_parse_arguments(PARSE_ARGV 1
+ IC # prefix
+ "HAS_MANPAGE" # options
+ "" # one_value_keywords
+ "" # multi_value_keywords
+ )
+ set(target_name ${component})
+ install(TARGETS ${target_name}
+ RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
+ COMPONENT ${component}
+ )
+ if(INSTALL_MAN AND IC_HAS_MANPAGE)
+ install(FILES ${PROJECT_SOURCE_DIR}/doc/man/${target_name}.1
+ DESTINATION ${CMAKE_INSTALL_MANDIR}/man1
+ COMPONENT ${component}
+ )
+ endif()
+endfunction()
diff --git a/cmake/module/Maintenance.cmake b/cmake/module/Maintenance.cmake
new file mode 100644
index 00000000..4103c9b6
--- /dev/null
+++ b/cmake/module/Maintenance.cmake
@@ -0,0 +1,143 @@
+# 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/.
+
+include_guard(GLOBAL)
+
+function(setup_split_debug_script)
+ if(CMAKE_HOST_SYSTEM_NAME STREQUAL "Linux")
+ set(OBJCOPY ${CMAKE_OBJCOPY})
+ set(STRIP ${CMAKE_STRIP})
+ configure_file(
+ contrib/devtools/split-debug.sh.in split-debug.sh
+ FILE_PERMISSIONS OWNER_READ OWNER_EXECUTE
+ GROUP_READ GROUP_EXECUTE
+ WORLD_READ
+ @ONLY
+ )
+ endif()
+endfunction()
+
+function(add_maintenance_targets)
+ if(NOT PYTHON_COMMAND)
+ return()
+ endif()
+
+ foreach(target IN ITEMS bitcoind bitcoin-qt bitcoin-cli bitcoin-tx bitcoin-util bitcoin-wallet test_bitcoin bench_bitcoin)
+ if(TARGET ${target})
+ list(APPEND executables $<TARGET_FILE:${target}>)
+ endif()
+ endforeach()
+
+ add_custom_target(check-symbols
+ COMMAND ${CMAKE_COMMAND} -E echo "Running symbol and dynamic library checks..."
+ COMMAND ${PYTHON_COMMAND} ${PROJECT_SOURCE_DIR}/contrib/devtools/symbol-check.py ${executables}
+ VERBATIM
+ )
+
+ add_custom_target(check-security
+ COMMAND ${CMAKE_COMMAND} -E echo "Checking binary security..."
+ COMMAND ${PYTHON_COMMAND} ${PROJECT_SOURCE_DIR}/contrib/devtools/security-check.py ${executables}
+ VERBATIM
+ )
+endfunction()
+
+function(add_windows_deploy_target)
+ if(MINGW AND TARGET bitcoin-qt AND TARGET bitcoind AND TARGET bitcoin-cli AND TARGET bitcoin-tx AND TARGET bitcoin-wallet AND TARGET bitcoin-util AND TARGET test_bitcoin)
+ find_program(MAKENSIS_EXECUTABLE makensis)
+ if(NOT MAKENSIS_EXECUTABLE)
+ add_custom_target(deploy
+ COMMAND ${CMAKE_COMMAND} -E echo "Error: NSIS not found"
+ )
+ return()
+ endif()
+
+ # TODO: Consider replacing this code with the CPack NSIS Generator.
+ # See https://cmake.org/cmake/help/latest/cpack_gen/nsis.html
+ include(GenerateSetupNsi)
+ generate_setup_nsi()
+ add_custom_command(
+ OUTPUT ${PROJECT_BINARY_DIR}/bitcoin-win64-setup.exe
+ COMMAND ${CMAKE_COMMAND} -E make_directory ${PROJECT_BINARY_DIR}/release
+ COMMAND ${CMAKE_STRIP} $<TARGET_FILE:bitcoin-qt> -o ${PROJECT_BINARY_DIR}/release/$<TARGET_FILE_NAME:bitcoin-qt>
+ COMMAND ${CMAKE_STRIP} $<TARGET_FILE:bitcoind> -o ${PROJECT_BINARY_DIR}/release/$<TARGET_FILE_NAME:bitcoind>
+ COMMAND ${CMAKE_STRIP} $<TARGET_FILE:bitcoin-cli> -o ${PROJECT_BINARY_DIR}/release/$<TARGET_FILE_NAME:bitcoin-cli>
+ COMMAND ${CMAKE_STRIP} $<TARGET_FILE:bitcoin-tx> -o ${PROJECT_BINARY_DIR}/release/$<TARGET_FILE_NAME:bitcoin-tx>
+ COMMAND ${CMAKE_STRIP} $<TARGET_FILE:bitcoin-wallet> -o ${PROJECT_BINARY_DIR}/release/$<TARGET_FILE_NAME:bitcoin-wallet>
+ COMMAND ${CMAKE_STRIP} $<TARGET_FILE:bitcoin-util> -o ${PROJECT_BINARY_DIR}/release/$<TARGET_FILE_NAME:bitcoin-util>
+ COMMAND ${CMAKE_STRIP} $<TARGET_FILE:test_bitcoin> -o ${PROJECT_BINARY_DIR}/release/$<TARGET_FILE_NAME:test_bitcoin>
+ COMMAND ${MAKENSIS_EXECUTABLE} -V2 ${PROJECT_BINARY_DIR}/bitcoin-win64-setup.nsi
+ VERBATIM
+ )
+ add_custom_target(deploy DEPENDS ${PROJECT_BINARY_DIR}/bitcoin-win64-setup.exe)
+ endif()
+endfunction()
+
+function(add_macos_deploy_target)
+ if(CMAKE_SYSTEM_NAME STREQUAL "Darwin" AND TARGET bitcoin-qt)
+ set(macos_app "Bitcoin-Qt.app")
+ # Populate Contents subdirectory.
+ configure_file(${PROJECT_SOURCE_DIR}/share/qt/Info.plist.in ${macos_app}/Contents/Info.plist NO_SOURCE_PERMISSIONS)
+ file(CONFIGURE OUTPUT ${macos_app}/Contents/PkgInfo CONTENT "APPL????")
+ # Populate Contents/Resources subdirectory.
+ file(CONFIGURE OUTPUT ${macos_app}/Contents/Resources/empty.lproj CONTENT "")
+ configure_file(${PROJECT_SOURCE_DIR}/src/qt/res/icons/bitcoin.icns ${macos_app}/Contents/Resources/bitcoin.icns NO_SOURCE_PERMISSIONS COPYONLY)
+ file(CONFIGURE OUTPUT ${macos_app}/Contents/Resources/Base.lproj/InfoPlist.strings
+ CONTENT "{ CFBundleDisplayName = \"@CLIENT_NAME@\"; CFBundleName = \"@CLIENT_NAME@\"; }"
+ )
+
+ add_custom_command(
+ OUTPUT ${PROJECT_BINARY_DIR}/${macos_app}/Contents/MacOS/Bitcoin-Qt
+ COMMAND ${CMAKE_COMMAND} --install ${PROJECT_BINARY_DIR} --config $<CONFIG> --component bitcoin-qt --prefix ${macos_app}/Contents/MacOS --strip
+ COMMAND ${CMAKE_COMMAND} -E rename ${macos_app}/Contents/MacOS/bin/$<TARGET_FILE_NAME:bitcoin-qt> ${macos_app}/Contents/MacOS/Bitcoin-Qt
+ COMMAND ${CMAKE_COMMAND} -E rm -rf ${macos_app}/Contents/MacOS/bin
+ COMMAND ${CMAKE_COMMAND} -E rm -rf ${macos_app}/Contents/MacOS/share
+ VERBATIM
+ )
+
+ string(REPLACE " " "-" osx_volname ${CLIENT_NAME})
+ if(CMAKE_HOST_APPLE)
+ add_custom_command(
+ OUTPUT ${PROJECT_BINARY_DIR}/${osx_volname}.zip
+ COMMAND ${PYTHON_COMMAND} ${PROJECT_SOURCE_DIR}/contrib/macdeploy/macdeployqtplus ${macos_app} ${osx_volname} -translations-dir=${QT_TRANSLATIONS_DIR} -zip
+ DEPENDS ${PROJECT_BINARY_DIR}/${macos_app}/Contents/MacOS/Bitcoin-Qt
+ VERBATIM
+ )
+ add_custom_target(deploydir
+ DEPENDS ${PROJECT_BINARY_DIR}/${osx_volname}.zip
+ )
+ add_custom_target(deploy
+ DEPENDS ${PROJECT_BINARY_DIR}/${osx_volname}.zip
+ )
+ else()
+ add_custom_command(
+ OUTPUT ${PROJECT_BINARY_DIR}/dist/${macos_app}/Contents/MacOS/Bitcoin-Qt
+ COMMAND OBJDUMP=${CMAKE_OBJDUMP} ${PYTHON_COMMAND} ${PROJECT_SOURCE_DIR}/contrib/macdeploy/macdeployqtplus ${macos_app} ${osx_volname} -translations-dir=${QT_TRANSLATIONS_DIR}
+ DEPENDS ${PROJECT_BINARY_DIR}/${macos_app}/Contents/MacOS/Bitcoin-Qt
+ VERBATIM
+ )
+ add_custom_target(deploydir
+ DEPENDS ${PROJECT_BINARY_DIR}/dist/${macos_app}/Contents/MacOS/Bitcoin-Qt
+ )
+
+ find_program(ZIP_EXECUTABLE zip)
+ if(NOT ZIP_EXECUTABLE)
+ add_custom_target(deploy
+ COMMAND ${CMAKE_COMMAND} -E echo "Error: ZIP not found"
+ )
+ else()
+ add_custom_command(
+ OUTPUT ${PROJECT_BINARY_DIR}/dist/${osx_volname}.zip
+ WORKING_DIRECTORY dist
+ COMMAND ${PROJECT_SOURCE_DIR}/cmake/script/macos_zip.sh ${ZIP_EXECUTABLE} ${osx_volname}.zip
+ VERBATIM
+ )
+ add_custom_target(deploy
+ DEPENDS ${PROJECT_BINARY_DIR}/dist/${osx_volname}.zip
+ )
+ endif()
+ endif()
+ add_dependencies(deploydir bitcoin-qt)
+ add_dependencies(deploy deploydir)
+ endif()
+endfunction()
diff --git a/cmake/module/ProcessConfigurations.cmake b/cmake/module/ProcessConfigurations.cmake
new file mode 100644
index 00000000..9a510a00
--- /dev/null
+++ b/cmake/module/ProcessConfigurations.cmake
@@ -0,0 +1,167 @@
+# 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/.
+
+include_guard(GLOBAL)
+
+macro(normalize_string string)
+ string(REGEX REPLACE " +" " " ${string} "${${string}}")
+ string(STRIP "${${string}}" ${string})
+endmacro()
+
+function(are_flags_overridden flags_var result_var)
+ normalize_string(${flags_var})
+ normalize_string(${flags_var}_INIT)
+ if(${flags_var} STREQUAL ${flags_var}_INIT)
+ set(${result_var} FALSE PARENT_SCOPE)
+ else()
+ set(${result_var} TRUE PARENT_SCOPE)
+ endif()
+endfunction()
+
+
+# Removes duplicated flags. The relative order of flags is preserved.
+# If duplicates are encountered, only the last instance is preserved.
+function(deduplicate_flags flags)
+ separate_arguments(${flags})
+ list(REVERSE ${flags})
+ list(REMOVE_DUPLICATES ${flags})
+ list(REVERSE ${flags})
+ list(JOIN ${flags} " " result)
+ set(${flags} "${result}" PARENT_SCOPE)
+endfunction()
+
+
+function(get_all_configs output)
+ get_property(is_multi_config GLOBAL PROPERTY GENERATOR_IS_MULTI_CONFIG)
+ if(is_multi_config)
+ set(all_configs ${CMAKE_CONFIGURATION_TYPES})
+ else()
+ get_property(all_configs CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS)
+ if(NOT all_configs)
+ # See https://cmake.org/cmake/help/latest/manual/cmake-buildsystem.7.html#default-and-custom-configurations
+ set(all_configs Debug Release RelWithDebInfo MinSizeRel)
+ endif()
+ endif()
+ set(${output} "${all_configs}" PARENT_SCOPE)
+endfunction()
+
+
+#[=[
+Set the default build configuration.
+
+See: https://cmake.org/cmake/help/latest/manual/cmake-buildsystem.7.html#build-configurations.
+
+On single-configuration generators, this function sets the CMAKE_BUILD_TYPE variable to
+the default build configuration, which can be overridden by the user at configure time if needed.
+
+On multi-configuration generators, this function rearranges the CMAKE_CONFIGURATION_TYPES list,
+ensuring that the default build configuration appears first while maintaining the order of the
+remaining configurations. The user can choose a build configuration at build time.
+]=]
+function(set_default_config config)
+ get_all_configs(all_configs)
+ if(NOT ${config} IN_LIST all_configs)
+ message(FATAL_ERROR "The default config is \"${config}\", but must be one of ${all_configs}.")
+ endif()
+
+ list(REMOVE_ITEM all_configs ${config})
+ list(PREPEND all_configs ${config})
+
+ get_property(is_multi_config GLOBAL PROPERTY GENERATOR_IS_MULTI_CONFIG)
+ if(is_multi_config)
+ get_property(help_string CACHE CMAKE_CONFIGURATION_TYPES PROPERTY HELPSTRING)
+ set(CMAKE_CONFIGURATION_TYPES "${all_configs}" CACHE STRING "${help_string}" FORCE)
+ # Also see https://gitlab.kitware.com/cmake/cmake/-/issues/19512.
+ set(CMAKE_TRY_COMPILE_CONFIGURATION "${config}" PARENT_SCOPE)
+ else()
+ set_property(CACHE CMAKE_BUILD_TYPE PROPERTY
+ STRINGS "${all_configs}"
+ )
+ if(NOT CMAKE_BUILD_TYPE)
+ message(STATUS "Setting build type to \"${config}\" as none was specified")
+ get_property(help_string CACHE CMAKE_BUILD_TYPE PROPERTY HELPSTRING)
+ set(CMAKE_BUILD_TYPE "${config}" CACHE STRING "${help_string}" FORCE)
+ endif()
+ set(CMAKE_TRY_COMPILE_CONFIGURATION "${CMAKE_BUILD_TYPE}" PARENT_SCOPE)
+ endif()
+endfunction()
+
+function(remove_cxx_flag_from_all_configs flag)
+ get_all_configs(all_configs)
+ foreach(config IN LISTS all_configs)
+ string(TOUPPER "${config}" config_uppercase)
+ set(flags "${CMAKE_CXX_FLAGS_${config_uppercase}}")
+ separate_arguments(flags)
+ list(FILTER flags EXCLUDE REGEX "${flag}")
+ list(JOIN flags " " new_flags)
+ set(CMAKE_CXX_FLAGS_${config_uppercase} "${new_flags}" PARENT_SCOPE)
+ set(CMAKE_CXX_FLAGS_${config_uppercase} "${new_flags}"
+ CACHE STRING
+ "Flags used by the CXX compiler during ${config_uppercase} builds."
+ FORCE
+ )
+ endforeach()
+endfunction()
+
+function(replace_cxx_flag_in_config config old_flag new_flag)
+ string(TOUPPER "${config}" config_uppercase)
+ string(REGEX REPLACE "(^| )${old_flag}( |$)" "\\1${new_flag}\\2" new_flags "${CMAKE_CXX_FLAGS_${config_uppercase}}")
+ set(CMAKE_CXX_FLAGS_${config_uppercase} "${new_flags}" PARENT_SCOPE)
+ set(CMAKE_CXX_FLAGS_${config_uppercase} "${new_flags}"
+ CACHE STRING
+ "Flags used by the CXX compiler during ${config_uppercase} builds."
+ FORCE
+ )
+endfunction()
+
+set_default_config(RelWithDebInfo)
+
+include(TryAppendCXXFlags)
+
+# We leave assertions on.
+if(MSVC)
+ remove_cxx_flag_from_all_configs(/DNDEBUG)
+else()
+ remove_cxx_flag_from_all_configs(-DNDEBUG)
+
+ # Adjust flags used by the CXX compiler during RELEASE builds.
+ # Prefer -O2 optimization level. (-O3 is CMake's default for Release for many compilers.)
+ replace_cxx_flag_in_config(Release -O3 -O2)
+
+ are_flags_overridden(CMAKE_CXX_FLAGS_DEBUG cxx_flags_debug_overridden)
+ if(NOT cxx_flags_debug_overridden)
+ # Redefine flags used by the CXX compiler during DEBUG builds.
+ try_append_cxx_flags("-g3" RESULT_VAR compiler_supports_g3)
+ if(compiler_supports_g3)
+ replace_cxx_flag_in_config(Debug -g -g3)
+ endif()
+ unset(compiler_supports_g3)
+
+ try_append_cxx_flags("-ftrapv" RESULT_VAR compiler_supports_ftrapv)
+ if(compiler_supports_ftrapv)
+ string(PREPEND CMAKE_CXX_FLAGS_DEBUG "-ftrapv ")
+ endif()
+ unset(compiler_supports_ftrapv)
+
+ string(PREPEND CMAKE_CXX_FLAGS_DEBUG "-O0 ")
+
+ set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG}"
+ CACHE STRING
+ "Flags used by the CXX compiler during DEBUG builds."
+ FORCE
+ )
+ endif()
+ unset(cxx_flags_debug_overridden)
+endif()
+
+set(CMAKE_CXX_FLAGS_COVERAGE "-g -Og --coverage")
+set(CMAKE_OBJCXX_FLAGS_COVERAGE "-g -Og --coverage")
+set(CMAKE_EXE_LINKER_FLAGS_COVERAGE "--coverage")
+set(CMAKE_SHARED_LINKER_FLAGS_COVERAGE "--coverage")
+get_property(is_multi_config GLOBAL PROPERTY GENERATOR_IS_MULTI_CONFIG)
+if(is_multi_config)
+ if(NOT "Coverage" IN_LIST CMAKE_CONFIGURATION_TYPES)
+ list(APPEND CMAKE_CONFIGURATION_TYPES Coverage)
+ endif()
+endif()
diff --git a/cmake/module/TargetDataSources.cmake b/cmake/module/TargetDataSources.cmake
new file mode 100644
index 00000000..a549f9a2
--- /dev/null
+++ b/cmake/module/TargetDataSources.cmake
@@ -0,0 +1,55 @@
+# 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/.
+
+macro(set_add_custom_command_options)
+ set(DEPENDS_EXPLICIT_OPT "")
+ if(CMAKE_VERSION VERSION_GREATER_EQUAL 3.27)
+ set(DEPENDS_EXPLICIT_OPT DEPENDS_EXPLICIT_ONLY)
+ endif()
+ set(CODEGEN_OPT "")
+ if(POLICY CMP0171)
+ cmake_policy(GET CMP0171 _cmp0171_status)
+ if(_cmp0171_status STREQUAL "NEW")
+ set(CODEGEN_OPT CODEGEN)
+ endif()
+ unset(_cmp0171_status)
+ endif()
+endmacro()
+
+# Specifies JSON data files to be processed into corresponding
+# header files for inclusion when building a target.
+function(target_json_data_sources target)
+ set_add_custom_command_options()
+ foreach(json_file IN LISTS ARGN)
+ set(header ${CMAKE_CURRENT_BINARY_DIR}/${json_file}.h)
+ add_custom_command(
+ OUTPUT ${header}
+ COMMAND ${CMAKE_COMMAND} -DJSON_SOURCE_PATH=${CMAKE_CURRENT_SOURCE_DIR}/${json_file} -DHEADER_PATH=${header} -P ${PROJECT_SOURCE_DIR}/cmake/script/GenerateHeaderFromJson.cmake
+ DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/${json_file} ${PROJECT_SOURCE_DIR}/cmake/script/GenerateHeaderFromJson.cmake
+ VERBATIM
+ ${CODEGEN_OPT}
+ ${DEPENDS_EXPLICIT_OPT}
+ )
+ target_sources(${target} PRIVATE ${header})
+ endforeach()
+endfunction()
+
+# Specifies raw binary data files to be processed into corresponding
+# header files for inclusion when building a target.
+function(target_raw_data_sources target)
+ cmake_parse_arguments(PARSE_ARGV 1 _ "" "NAMESPACE" "")
+ set_add_custom_command_options()
+ foreach(raw_file IN LISTS __UNPARSED_ARGUMENTS)
+ set(header ${CMAKE_CURRENT_BINARY_DIR}/${raw_file}.h)
+ add_custom_command(
+ OUTPUT ${header}
+ COMMAND ${CMAKE_COMMAND} -DRAW_SOURCE_PATH=${CMAKE_CURRENT_SOURCE_DIR}/${raw_file} -DHEADER_PATH=${header} -DRAW_NAMESPACE=${__NAMESPACE} -P ${PROJECT_SOURCE_DIR}/cmake/script/GenerateHeaderFromRaw.cmake
+ DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/${raw_file} ${PROJECT_SOURCE_DIR}/cmake/script/GenerateHeaderFromRaw.cmake
+ VERBATIM
+ ${CODEGEN_OPT}
+ ${DEPENDS_EXPLICIT_OPT}
+ )
+ target_sources(${target} PRIVATE ${header})
+ endforeach()
+endfunction()
diff --git a/cmake/module/TestAppendRequiredLibraries.cmake b/cmake/module/TestAppendRequiredLibraries.cmake
new file mode 100644
index 00000000..e15c2b99
--- /dev/null
+++ b/cmake/module/TestAppendRequiredLibraries.cmake
@@ -0,0 +1,96 @@
+# 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/.
+
+include_guard(GLOBAL)
+
+# Illumos/SmartOS requires linking with -lsocket if
+# using getifaddrs & freeifaddrs.
+# See:
+# - https://github.com/bitcoin/bitcoin/pull/21486
+# - https://smartos.org/man/3socket/getifaddrs
+function(test_append_socket_library target)
+ if (NOT TARGET ${target})
+ message(FATAL_ERROR "${CMAKE_CURRENT_FUNCTION}() called with non-existent target \"${target}\".")
+ endif()
+
+ set(check_socket_source "
+ #include <sys/types.h>
+ #include <ifaddrs.h>
+
+ int main() {
+ struct ifaddrs* ifaddr;
+ getifaddrs(&ifaddr);
+ freeifaddrs(ifaddr);
+ }
+ ")
+
+ include(CheckCXXSourceCompiles)
+ check_cxx_source_compiles("${check_socket_source}" IFADDR_LINKS_WITHOUT_LIBSOCKET)
+ if(NOT IFADDR_LINKS_WITHOUT_LIBSOCKET)
+ include(CheckSourceCompilesWithFlags)
+ check_cxx_source_compiles_with_flags("${check_socket_source}" IFADDR_NEEDS_LINK_TO_LIBSOCKET
+ LINK_LIBRARIES socket
+ )
+ if(IFADDR_NEEDS_LINK_TO_LIBSOCKET)
+ target_link_libraries(${target} INTERFACE socket)
+ else()
+ message(FATAL_ERROR "Cannot figure out how to use getifaddrs/freeifaddrs.")
+ endif()
+ endif()
+ set(HAVE_DECL_GETIFADDRS TRUE PARENT_SCOPE)
+ set(HAVE_DECL_FREEIFADDRS TRUE PARENT_SCOPE)
+endfunction()
+
+# Clang, when building for 32-bit,
+# and linking against libstdc++, requires linking with
+# -latomic if using the C++ atomic library.
+# Can be tested with: clang++ -std=c++20 test.cpp -m32
+#
+# Sourced from http://bugs.debian.org/797228
+function(test_append_atomic_library target)
+ if (NOT TARGET ${target})
+ message(FATAL_ERROR "${CMAKE_CURRENT_FUNCTION}() called with non-existent target \"${target}\".")
+ endif()
+
+ set(check_atomic_source "
+ #include <atomic>
+ #include <cstdint>
+ #include <chrono>
+
+ using namespace std::chrono_literals;
+
+ int main() {
+ std::atomic<bool> lock{true};
+ lock.exchange(false);
+
+ std::atomic<std::chrono::seconds> t{0s};
+ t.store(2s);
+ auto t1 = t.load();
+ t.compare_exchange_strong(t1, 3s);
+
+ std::atomic<double> d{};
+ d.store(3.14);
+ auto d1 = d.load();
+
+ std::atomic<int64_t> a{};
+ int64_t v = 5;
+ int64_t r = a.fetch_add(v);
+ return static_cast<int>(r);
+ }
+ ")
+
+ include(CheckCXXSourceCompiles)
+ check_cxx_source_compiles("${check_atomic_source}" STD_ATOMIC_LINKS_WITHOUT_LIBATOMIC)
+ if(NOT STD_ATOMIC_LINKS_WITHOUT_LIBATOMIC)
+ include(CheckSourceCompilesWithFlags)
+ check_cxx_source_compiles_with_flags("${check_atomic_source}" STD_ATOMIC_NEEDS_LINK_TO_LIBATOMIC
+ LINK_LIBRARIES atomic
+ )
+ if(STD_ATOMIC_NEEDS_LINK_TO_LIBATOMIC)
+ target_link_libraries(${target} INTERFACE atomic)
+ else()
+ message(FATAL_ERROR "Cannot figure out how to use std::atomic.")
+ endif()
+ endif()
+endfunction()
diff --git a/cmake/module/TryAppendCXXFlags.cmake b/cmake/module/TryAppendCXXFlags.cmake
new file mode 100644
index 00000000..dc0a9b7f
--- /dev/null
+++ b/cmake/module/TryAppendCXXFlags.cmake
@@ -0,0 +1,126 @@
+# 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/.
+
+include_guard(GLOBAL)
+include(CheckCXXSourceCompiles)
+
+#[=[
+Add language-wide flags, which will be passed to all invocations of the compiler.
+This includes invocations that drive compiling and those that drive linking.
+
+Usage examples:
+
+ try_append_cxx_flags("-Wformat -Wformat-security" VAR warn_cxx_flags)
+
+
+ try_append_cxx_flags("-Wsuggest-override" VAR warn_cxx_flags
+ SOURCE "struct A { virtual void f(); }; struct B : A { void f() final; };"
+ )
+
+
+ try_append_cxx_flags("-fsanitize=${SANITIZERS}" TARGET core_interface
+ RESULT_VAR cxx_supports_sanitizers
+ )
+ if(NOT cxx_supports_sanitizers)
+ message(FATAL_ERROR "Compiler did not accept requested flags.")
+ endif()
+
+
+ try_append_cxx_flags("-Wunused-parameter" TARGET core_interface
+ IF_CHECK_PASSED "-Wno-unused-parameter"
+ )
+
+
+In configuration output, this function prints a string by the following pattern:
+
+ -- Performing Test CXX_SUPPORTS_[flags]
+ -- Performing Test CXX_SUPPORTS_[flags] - Success
+
+]=]
+function(try_append_cxx_flags flags)
+ cmake_parse_arguments(PARSE_ARGV 1
+ TACXXF # prefix
+ "SKIP_LINK" # options
+ "TARGET;VAR;SOURCE;RESULT_VAR" # one_value_keywords
+ "IF_CHECK_PASSED" # multi_value_keywords
+ )
+
+ set(flags_as_string "${flags}")
+ separate_arguments(flags)
+
+ string(MAKE_C_IDENTIFIER "${flags_as_string}" id_string)
+ string(TOUPPER "${id_string}" id_string)
+
+ set(source "int main() { return 0; }")
+ if(DEFINED TACXXF_SOURCE AND NOT TACXXF_SOURCE STREQUAL source)
+ set(source "${TACXXF_SOURCE}")
+ string(SHA256 source_hash "${source}")
+ string(SUBSTRING ${source_hash} 0 4 source_hash_head)
+ string(APPEND id_string _${source_hash_head})
+ endif()
+
+ # This avoids running a linker.
+ set(CMAKE_TRY_COMPILE_TARGET_TYPE STATIC_LIBRARY)
+ set(CMAKE_REQUIRED_FLAGS "${flags_as_string} ${working_compiler_werror_flag}")
+ Risk score
Our methodology →Why this scored 37/100
Human-validated context
Community notes
Notes can correct, qualify, or add evidence to the AI analysis. Every note shown here has been validated by a human moderator.
No validated notes yet.
The AI analysis stands alone for now. Submit a note if you can add evidence or important context.