READ THE CODE

Inside Bitcoin

The code behind the network, with room to understand it.

Stable release v32.1bitcoin/bitcoin · f0de87f04062 ↗3,020 source files · 47.5 MB stored on the server440 file guides

Release published 2026-10-28 · Snapshot fetched 2026-11-01. Latest stable release at fetch time; development branches and Git history are excluded. Only the selected code window and visible folders load here.

22,947 bytes · SHA-256 d15ce9937ba6b557… · View upstream ↗

1name: CI
2on:
3  pull_request:
4  push:
5    branches:
6      - '**'
7    tags-ignore:
8      - '**'
9  schedule:
10    # Run on the default branch every Monday morning.
11    # This also warms the Docker caches after key rotation.
12    - cron: '22 2 * * 1'
13
14concurrency:
15  group: ${{ github.event_name != 'pull_request' && github.run_id || github.ref }}
16  cancel-in-progress: true
17
18env:
19  ### compiler options
20  HOST:
21  WRAPPER_CMD:
22  # Specific warnings can be disabled with -Wno-error=foo.
23  # -pedantic-errors is not equivalent to -Werror=pedantic and thus not implied by -Werror according to the GCC manual.
24  WERROR_CFLAGS: '-Werror -pedantic-errors'
25  MAKEFLAGS: '-j4'
26  BUILD: 'check'
27  ### secp256k1 config
28  ECMULTWINDOW: 15
29  ECMULTGENKB: 86
30  ASM: 'no'
31  WIDEMUL: 'auto'
32  WITH_VALGRIND: 'yes'
33  EXTRAFLAGS:
34  ### secp256k1 modules
35  EXPERIMENTAL: 'no'
36  ECDH: 'no'
37  RECOVERY: 'no'
38  EXTRAKEYS: 'no'
39  SCHNORRSIG: 'no'
40  MUSIG: 'no'
41  ELLSWIFT: 'no'
42  SILENTPAYMENTS: 'no'
43  ### test options
44  SECP256K1_TEST_ITERS: 64
45  BENCH: 'yes'
46  SECP256K1_BENCH_ITERS: 2
47  CTIMETESTS: 'yes'
48  SYMBOL_CHECK: 'yes'
49  # Compile and run the examples.
50  EXAMPLES: 'yes'
51  # Disable Docker build summary generation.
52  # See https://github.com/docker/build-push-action/blob/master/README.md#environment-variables.
53  DOCKER_BUILD_SUMMARY: false
54
55jobs:
56  docker_cache:
57    name: "Build ${{ matrix.arch }} Docker image"
58    runs-on: ${{ matrix.runner }}
59    outputs:
60      cache_scope: ${{ steps.cache_timestamp.outputs.period }}
61
62    strategy:
63      fail-fast: false
64      matrix:
65        include:
66          - arch: x64
67            runner: ubuntu-latest
68          - arch: arm64
69            runner: ubuntu-24.04-arm
70
71    steps:
72      - name: Get cache validity period
73        id: cache_timestamp
74        run: echo "period=$((10#$(date +%V) / 4))" >> "$GITHUB_OUTPUT"
75
76      - name: Set up Docker Buildx
77        uses: docker/setup-buildx-action@v4
78        with:
79          # See: https://github.com/moby/buildkit/issues/3969.
80          driver-opts: |
81            network=host
82
83      - name: Build container
84        uses: docker/build-push-action@v7
85        with:
86          file: ./ci/linux-debian.Dockerfile
87          cache-from: type=gha,scope=${{ runner.arch }}-${{ steps.cache_timestamp.outputs.period }}
88          cache-to: type=gha,scope=${{ runner.arch }}-${{ steps.cache_timestamp.outputs.period }},mode=min
89
90  x86_64-debian:
91    name: "x86_64: Linux (Debian stable)"
92    runs-on: ubuntu-latest
93    needs: docker_cache
94
95    strategy:
96      fail-fast: false
97      matrix:
98        configuration:
99          - env_vars: { WIDEMUL: 'int64',  RECOVERY: 'yes' }
100          - env_vars: { WIDEMUL: 'int64',                   ECDH: 'yes', EXTRAKEYS: 'yes', SCHNORRSIG: 'yes', MUSIG: 'yes', ELLSWIFT: 'yes', SILENTPAYMENTS: 'yes' }
101          - env_vars: { WIDEMUL: 'int128' }
102          - env_vars: { WIDEMUL: 'int128_struct',                                                             ELLSWIFT: 'yes' }
103          - env_vars: { WIDEMUL: 'int128', RECOVERY: 'yes',              EXTRAKEYS: 'yes', SCHNORRSIG: 'yes', MUSIG: 'yes', ELLSWIFT: 'yes' }
104          - env_vars: { WIDEMUL: 'int128',                  ECDH: 'yes', EXTRAKEYS: 'yes', SCHNORRSIG: 'yes', MUSIG: 'yes', SILENTPAYMENTS: 'yes' }
105          - env_vars: { WIDEMUL: 'int128', ASM: 'x86_64',                                                     ELLSWIFT: 'yes' }
106          - env_vars: {                    RECOVERY: 'yes',              EXTRAKEYS: 'yes', SCHNORRSIG: 'yes', MUSIG: 'yes' }
107          - env_vars: { CTIMETESTS: 'no',  RECOVERY: 'yes', ECDH: 'yes', EXTRAKEYS: 'yes', SCHNORRSIG: 'yes', MUSIG: 'yes', SILENTPAYMENTS: 'yes', CPPFLAGS: '-DVERIFY' }
108          - env_vars: { BUILD: 'distcheck', WITH_VALGRIND: 'no', CTIMETESTS: 'no', BENCH: 'no' }
109          - env_vars: { CPPFLAGS: '-DDETERMINISTIC' }
110          - env_vars: { CFLAGS: '-O0', CTIMETESTS: 'no' }
111          - env_vars: { CFLAGS: '-O1',     RECOVERY: 'yes', ECDH: 'yes', EXTRAKEYS: 'yes', SCHNORRSIG: 'yes', MUSIG: 'yes', ELLSWIFT: 'yes', SILENTPAYMENTS: 'yes' }
112          - env_vars: { ECMULTGENKB: 2, ECMULTWINDOW: 2 }
113          - env_vars: { ECMULTGENKB: 86, ECMULTWINDOW: 4 }
114        cc:
115          - 'gcc'
116          - 'clang'
117          - 'gcc-snapshot'
118          - 'clang-snapshot'
119
120    env:
121      CC: ${{ matrix.cc }}
122
123    steps:
124      - &CHECKOUT
125        name: Checkout
126        uses: actions/checkout@v5
127
128      - &CI_SCRIPT_IN_DOCKER
129        name: CI script
130        env: ${{ matrix.configuration.env_vars }}
131        uses: ./.github/actions/run-in-docker-action
132        with:
133          dockerfile: ./ci/linux-debian.Dockerfile
134          scope: ${{ runner.arch }}-${{ needs.docker_cache.outputs.cache_scope }}
135          command: ./ci/ci.sh
136
137      - &PRINT_LOGS
138        name: Print logs
139        uses: ./.github/actions/print-logs
140        if: ${{ !cancelled() }}
141
142  i686_debian:
143    name: "i686: Linux (Debian stable)"
144    runs-on: ubuntu-latest
145    needs: docker_cache
146
147    strategy:
148      fail-fast: false
149      matrix:
150        configuration:
151          - env_vars: {}
152        cc:
153          - 'i686-linux-gnu-gcc'
154          - 'clang --target=i686-pc-linux-gnu -isystem /usr/i686-linux-gnu/include'
155
156    env:
157      HOST: 'i686-linux-gnu'
158      ECDH: 'yes'
159      RECOVERY: 'yes'
160      EXTRAKEYS: 'yes'
161      SCHNORRSIG: 'yes'
162      MUSIG: 'yes'
163      ELLSWIFT: 'yes'
164      SILENTPAYMENTS: 'yes'
165      CC: ${{ matrix.cc }}
166
167    steps:
168      - *CHECKOUT
169      - *CI_SCRIPT_IN_DOCKER
170      - *PRINT_LOGS
171
172  s390x_debian:
173    name: "s390x (big-endian): Linux (Debian stable, QEMU)"
174    runs-on: ubuntu-latest
175    needs: docker_cache
176
177    strategy:
178      matrix:
179        configuration:
180          - env_vars: {}
181
182    env:
183      WRAPPER_CMD: 'qemu-s390x'
184      SECP256K1_TEST_ITERS: 16
185      HOST: 's390x-linux-gnu'
186      WITH_VALGRIND: 'no'
187      ECDH: 'yes'
188      RECOVERY: 'yes'
189      EXTRAKEYS: 'yes'
190      SCHNORRSIG: 'yes'
191      MUSIG: 'yes'
192      ELLSWIFT: 'yes'
193      SILENTPAYMENTS: 'yes'
194      CTIMETESTS: 'no'
195
196    steps:
197      - *CHECKOUT
198      - *CI_SCRIPT_IN_DOCKER
199      - *PRINT_LOGS
200
201  arm32_debian:
202    name: "ARM32: Linux (Debian stable, QEMU)"
203    runs-on: ubuntu-latest
204    needs: docker_cache
205
206    strategy:
207      fail-fast: false
208      matrix:
209        configuration:
210          - env_vars: {}
211          - env_vars: { EXPERIMENTAL: 'yes', ASM: 'arm32' }
212
213    env:
214      WRAPPER_CMD: 'qemu-arm'
215      SECP256K1_TEST_ITERS: 16
216      HOST: 'arm-linux-gnueabihf'
217      WITH_VALGRIND: 'no'
218      ECDH: 'yes'
219      RECOVERY: 'yes'
220      EXTRAKEYS: 'yes'
221      SCHNORRSIG: 'yes'
222      MUSIG: 'yes'
223      ELLSWIFT: 'yes'
224      SILENTPAYMENTS: 'yes'
225      CTIMETESTS: 'no'
226
227    steps:
228      - *CHECKOUT
229      - *CI_SCRIPT_IN_DOCKER
230      - *PRINT_LOGS
231
232  arm64-debian:
233    name: "arm64: Linux (Debian stable)"
234    runs-on: ubuntu-24.04-arm
235    needs: docker_cache
236
237    env:
238      SECP256K1_TEST_ITERS: 16
239      WITH_VALGRIND: 'no'
240      ECDH: 'yes'
241      RECOVERY: 'yes'
242      EXTRAKEYS: 'yes'
243      SCHNORRSIG: 'yes'
244      MUSIG: 'yes'
245      ELLSWIFT: 'yes'
246      SILENTPAYMENTS: 'yes'
247      CTIMETESTS: 'no'
248      CC: ${{ matrix.cc }}
249
250    strategy:

src/wallet/receive.cpp

src/wallet/coinselection.cpp

src/consensus/validation.h

src/primitives/transaction.cpp

src/script/descriptor.cpp

src/bitcoin-cli.cpp

src/rpc/blockchain.cpp

src/rpc/rawtransaction.cpp

src/init.cpp

src/crypto/sha256.cpp

src/consensus/merkle.h

src/consensus/tx_check.h

src/consensus/tx_verify.h

src/policy/feerate.h

src/policy/feerate.cpp

src/primitives/transaction_identifier.h

src/chainparamsbase.h

src/chainparamsbase.cpp

src/util/moneystr.cpp

src/crypto/ripemd160.h

src/crypto/sha1.h

src/crypto/sha512.h

src/crypto/hmac_sha256.h

src/crypto/hmac_sha512.h

src/crypto/hmac_sha256.cpp

src/crypto/hmac_sha512.cpp

src/crypto/hkdf_sha256_32.h

src/crypto/hkdf_sha256_32.cpp

src/support/cleanse.h

src/support/cleanse.cpp

src/crypto/siphash.cpp

src/crypto/muhash.h

src/crypto/chacha20.h

src/crypto/poly1305.h

src/crypto/chacha20poly1305.h

src/crypto/chacha20poly1305.cpp

src/util/chaintype.cpp

src/util/obfuscation.h

src/util/byte_units.h

src/util/overflow.h

src/blockencodings.cpp

src/net_permissions.cpp

src/policy/packages.cpp

src/policy/rbf.cpp

src/policy/truc_policy.cpp

src/policy/ephemeral_policy.cpp

src/policy/settings.cpp

src/policy/policy.cpp

src/node/transaction.cpp

src/node/coin.cpp

src/rpc/client.cpp

src/rpc/external_signer.cpp

src/rpc/request.cpp

src/rpc/server_util.cpp

src/rpc/fees.cpp

src/rpc/output_script.cpp

src/rpc/rawtransaction_util.cpp

src/rpc/rawtransaction_util.h

src/rpc/register.h

src/rpc/request.h

src/rpc/server_util.h

src/rpc/protocol.h

src/rpc/server.h

src/rpc/signmessage.cpp

src/rpc/txoutproof.cpp

src/rpc/util.cpp

src/rpc/util.h

src/wallet/rpc/addresses.cpp

src/wallet/rpc/backup.cpp

src/wallet/rpc/coins.cpp

src/wallet/rpc/encrypt.cpp

src/wallet/rpc/signmessage.cpp

src/wallet/rpc/util.cpp

src/wallet/rpc/util.h

src/wallet/coincontrol.cpp

src/wallet/coincontrol.h

src/wallet/context.cpp

src/wallet/context.h

src/wallet/crypter.cpp

src/wallet/crypter.h

src/wallet/db.cpp

src/wallet/export.cpp

src/wallet/external_signer_scriptpubkeyman.cpp

src/wallet/rpc/spend.cpp

src/wallet/rpc/transactions.cpp

src/wallet/rpc/wallet.cpp

src/wallet/feebumper.cpp

src/wallet/feebumper.h

src/index/base.h

src/index/base.cpp

src/index/txindex.h

src/index/txindex.cpp

src/index/txindex_key.h

src/index/txospenderindex.h

src/index/txospenderindex.cpp

src/index/blockfilterindex.h

src/index/blockfilterindex.cpp

src/index/coinstatsindex.h

src/index/coinstatsindex.cpp

src/index/db_key.h

src/index/disktxpos.h

src/kernel/chain.cpp

src/kernel/chain.h

src/kernel/checks.cpp

src/kernel/checks.h

src/kernel/context.cpp

src/kernel/context.h

src/kernel/cs_main.cpp

src/kernel/cs_main.h

src/kernel/disconnected_transactions.cpp

src/kernel/disconnected_transactions.h

src/kernel/mempool_removal_reason.cpp

src/kernel/mempool_removal_reason.h

src/kernel/coinstats.cpp

src/kernel/coinstats.h

src/kernel/chainparams.cpp

src/kernel/chainparams.h

src/wallet/sqlite.cpp

src/wallet/sqlite.h

src/wallet/transaction.cpp

src/wallet/transaction.h

src/wallet/dump.cpp

src/wallet/dump.h

src/wallet/init.cpp

src/wallet/walletutil.cpp

src/wallet/walletutil.h

src/wallet/wallettool.cpp

src/wallet/wallettool.h

src/wallet/export.h

src/wallet/migrate.cpp

src/wallet/migrate.h

src/wallet/db.h

src/wallet/walletdb.cpp

src/wallet/interfaces.cpp

src/wallet/scriptpubkeyman.cpp

src/wallet/scriptpubkeyman.h

src/kernel/bitcoinkernel.cpp

src/kernel/bitcoinkernel.h

src/kernel/bitcoinkernel_wrapper.h

src/node/chainstate.cpp

src/node/chainstate.h

src/node/blockstorage.cpp

src/node/blockstorage.h

src/node/mempool_persist.cpp

src/node/mempool_persist.h

src/node/utxo_snapshot.cpp

src/node/utxo_snapshot.h

src/node/kernel_notifications.cpp

src/node/kernel_notifications.h

src/node/blockmanager_args.cpp

src/kernel/blockmanager_opts.h

src/util/expected.cpp

src/policy/settings.h

src/util/types.h

src/kernel/messagestartchars.h

src/kernel/warning.h

src/util/exception.h

src/common/license_info.h

src/node/coins_view_args.h

src/node/database_args.h

src/util/batchpriority.h

src/util/ui_change_type.h

src/node/coins_view_args.cpp

src/node/peerman_args.h

src/util/serfloat.h

src/node/blockmanager_args.h

src/node/database_args.cpp

src/util/overloaded.h

src/interfaces/types.h

src/node/chainstatemanager_args.h

src/node/minisketchwrapper.h

src/util/macros.h

src/util/syserror.h

src/common/run_command.h

src/util/bytevectorhash.cpp

src/node/mempool_persist_args.cpp

src/util/exec.h

src/util/rbf.h

src/crypto/hex_base.h

src/node/mempool_persist_args.h

src/interfaces/echo.h

src/util/any.h

src/util/batchpriority.cpp

src/util/threadnames.h

src/node/coin.h

src/node/mempool_args.h

src/util/asmap.h

src/util/bytevectorhash.h

src/node/context.cpp

src/util/insert.h

src/util/readwritefile.h

src/node/peerman_args.cpp

src/node/interface_ui.cpp

src/interfaces/handler.h

src/node/mining_args.h

src/util/hasher.cpp

src/common/init.h

src/kernel/mempool_limits.h

src/common/system.h

src/crypto/sha3.h

src/util/threadinterrupt.cpp

src/node/protocol_version.h

src/util/exception.cpp

src/common/messages.h

src/node/connection_types.cpp

src/util/bip32.h

src/common/license_info.cpp

src/util/stdmutex.h

src/common/run_command.cpp

src/util/check.cpp

src/util/golombrice.h

src/node/types.h

src/node/timeoffsets.h

src/util/readwritefile.cpp

src/util/fastrange.h

src/util/signalinterrupt.h

src/util/task_runner.h

src/util/syserror.cpp

src/common/interfaces.cpp

src/common/types.h

src/util/threadinterrupt.h

src/kernel/chainstatemanager_opts.h

src/node/psbt.h

src/policy/ephemeral_policy.h

src/util/trace.h

src/common/url.cpp

src/kernel/mempool_options.h

src/util/serfloat.cpp

src/kernel/notifications_interface.h

src/node/timeoffsets.cpp

src/node/warnings.cpp

src/util/hash_type.h

src/crypto/hex_base.cpp

src/node/eviction.h

src/util/tokenbucket.h

src/crypto/aes.h

src/common/pcp.h

src/util/feefrac.cpp

src/node/transaction.h

src/util/threadnames.cpp

src/common/signmessage.h

src/util/exec.cpp

src/util/signalinterrupt.cpp

src/clientversion.cpp

src/common/signmessage.cpp

src/compat/assumptions.h

src/compat/byteswap.h

src/deploymentinfo.cpp

src/deploymentinfo.h

src/deploymentstatus.cpp

src/deploymentstatus.h

src/dummywallet.cpp

src/external_signer.h

src/init/bitcoin-gui.cpp

src/init/bitcoin-node.cpp

src/init/bitcoin-qt.cpp

src/init/bitcoin-wallet.cpp

src/init/bitcoind.cpp

src/init/common.h

src/interfaces/init.h

src/interfaces/ipc.h

src/key_io.h

src/logging/categories.h

src/logging/timer.h

src/mapport.h

src/musig.h

src/net_permissions.h

src/netgroup.h

src/netmessagemaker.h

src/node/chainstatemanager_args.cpp

src/node/connection_types.h

src/node/context.h

src/node/interface_ui.h

src/node/mempool_args.cpp

src/node/mining_args.cpp

src/node/minisketchwrapper.cpp

src/node/txreconciliation.h

src/policy/fees/estimator_args.cpp

src/policy/fees/estimator_args.h

src/policy/fees/estimator_man.cpp

src/policy/fees/estimator_man.h

src/policy/packages.h

src/policy/rbf.h

src/policy/truc_policy.h

src/pow.h

src/primitives/block.cpp

src/randomenv.h

src/rest.h

src/script/keyorigin.h

src/script/parsing.cpp

src/script/parsing.h

src/script/script_error.h

src/script/sigcache.cpp

src/script/sigcache.h

src/script/solver.h

src/script/verify_flags.h

src/semaphore_grant.h

src/signet.h

src/span.h

src/support/allocators/secure.h

src/support/allocators/zeroafterfree.h

src/util/tokenpipe.cpp

src/util/translation.h

src/util/vector.h

src/versionbits.h

src/versionbits_impl.h

src/wallet/external_signer_scriptpubkeyman.h

src/wallet/fees.h

src/wallet/load.h

src/wallet/receive.h

src/wallet/rpc/wallet.h

src/wallet/types.h

src/walletinitinterface.h

src/zmq/zmqabstractnotifier.cpp

Independent explanations by MyBitcoinExplorer. Not affiliated with or endorsed by Bitcoin Core. Guides are educational and do not replace the source or its tests.

Bitcoin Core source © its contributors, distributed under the MIT license. Original notices and bundled third-party licenses are retained in the source tree.