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 server340 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.

17,737 bytes · SHA-256 ef12cdf4c406b3c3… · View upstream ↗

1cmake_minimum_required(VERSION 3.22)
2
3#=============================
4# Project / Package metadata
5#=============================
6project(libsecp256k1
7  # The package (a.k.a. release) version is based on semantic versioning 2.0.0 of
8  # the API. All changes in experimental modules are treated as
9  # backwards-compatible and therefore at most increase the minor version.
10  VERSION 0.8.1
11  DESCRIPTION "Optimized C library for ECDSA signatures and secret/public key operations on curve secp256k1."
12  HOMEPAGE_URL "https://github.com/bitcoin-core/secp256k1"
13  LANGUAGES C
14)
15enable_testing()
16include(CTestUseLaunchers) # Allow users to set CTEST_USE_LAUNCHERS in custom `ctest -S` scripts.
17list(APPEND CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/cmake)
18
19# The library version is based on libtool versioning of the ABI. The set of
20# rules for updating the version can be found here:
21# https://www.gnu.org/software/libtool/manual/html_node/Updating-version-info.html
22# All changes in experimental modules are treated as if they don't affect the
23# interface and therefore only increase the revision.
24set(${PROJECT_NAME}_LIB_VERSION_CURRENT 7)
25set(${PROJECT_NAME}_LIB_VERSION_REVISION 1)
26set(${PROJECT_NAME}_LIB_VERSION_AGE 0)
27
28#=============================
29# Language setup
30#=============================
31set(CMAKE_C_STANDARD 90)
32set(CMAKE_C_EXTENSIONS OFF)
33
34#=============================
35# Configurable options
36#=============================
37if(libsecp256k1_IS_TOP_LEVEL)
38  option(BUILD_SHARED_LIBS "Build shared libraries." ON)
39endif()
40
41option(SECP256K1_INSTALL "Enable installation." ${PROJECT_IS_TOP_LEVEL})
42
43option(SECP256K1_ENABLE_API_VISIBILITY_ATTRIBUTES "Enable visibility attributes in the API." ON)
44
45## Modules
46
47# We declare all options before processing them, to make sure we can express
48# dependencies while processing.
49option(SECP256K1_ENABLE_MODULE_ECDH "Enable ECDH module." ON)
50option(SECP256K1_ENABLE_MODULE_RECOVERY "Enable ECDSA pubkey recovery module." OFF)
51option(SECP256K1_ENABLE_MODULE_EXTRAKEYS "Enable extrakeys module." ON)
52option(SECP256K1_ENABLE_MODULE_SCHNORRSIG "Enable schnorrsig module." ON)
53option(SECP256K1_ENABLE_MODULE_MUSIG "Enable musig module." ON)
54option(SECP256K1_ENABLE_MODULE_ELLSWIFT "Enable ElligatorSwift module." ON)
55option(SECP256K1_ENABLE_MODULE_SILENTPAYMENTS "Enable Silent Payments module." ON)
56
57option(SECP256K1_USE_EXTERNAL_DEFAULT_CALLBACKS "Enable external default callback functions." OFF)
58if(SECP256K1_USE_EXTERNAL_DEFAULT_CALLBACKS)
59  add_compile_definitions(USE_EXTERNAL_DEFAULT_CALLBACKS=1)
60endif()
61
62set(SECP256K1_ECMULT_WINDOW_SIZE 15 CACHE STRING "Window size for ecmult precomputation for verification, specified as integer in range [2..24]. The default value is a reasonable setting for desktop machines (currently 15). [default=15]")
63set_property(CACHE SECP256K1_ECMULT_WINDOW_SIZE PROPERTY STRINGS 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24)
64include(CheckStringOptionValue)
65check_string_option_value(SECP256K1_ECMULT_WINDOW_SIZE)
66add_compile_definitions(ECMULT_WINDOW_SIZE=${SECP256K1_ECMULT_WINDOW_SIZE})
67
68set(SECP256K1_ECMULT_GEN_KB 86 CACHE STRING "The size of the precomputed table for signing in multiples of 1024 bytes (on typical platforms). Larger values result in possibly better signing or key generation performance at the cost of a larger table. Valid choices are 2, 22, 86. The default value is a reasonable setting for desktop machines (currently 86). [default=86]")
69set_property(CACHE SECP256K1_ECMULT_GEN_KB PROPERTY STRINGS 2 22 86)
70check_string_option_value(SECP256K1_ECMULT_GEN_KB)
71if(SECP256K1_ECMULT_GEN_KB EQUAL 2)
72  add_compile_definitions(COMB_BLOCKS=2)
73  add_compile_definitions(COMB_TEETH=5)
74elseif(SECP256K1_ECMULT_GEN_KB EQUAL 22)
75  add_compile_definitions(COMB_BLOCKS=11)
76  add_compile_definitions(COMB_TEETH=6)
77elseif(SECP256K1_ECMULT_GEN_KB EQUAL 86)
78  add_compile_definitions(COMB_BLOCKS=43)
79  add_compile_definitions(COMB_TEETH=6)
80endif()
81
82set(SECP256K1_TEST_OVERRIDE_WIDE_MULTIPLY "OFF" CACHE STRING "Test-only override of the (autodetected by the C code) \"widemul\" setting. Legal values are: \"OFF\", \"int128_struct\", \"int128\" or \"int64\". [default=OFF]")
83set_property(CACHE SECP256K1_TEST_OVERRIDE_WIDE_MULTIPLY PROPERTY STRINGS "OFF" "int128_struct" "int128" "int64")
84check_string_option_value(SECP256K1_TEST_OVERRIDE_WIDE_MULTIPLY)
85if(SECP256K1_TEST_OVERRIDE_WIDE_MULTIPLY)
86  string(TOUPPER "${SECP256K1_TEST_OVERRIDE_WIDE_MULTIPLY}" widemul_upper_value)
87  add_compile_definitions(USE_FORCE_WIDEMUL_${widemul_upper_value}=1)
88endif()
89mark_as_advanced(FORCE SECP256K1_TEST_OVERRIDE_WIDE_MULTIPLY)
90
91set(SECP256K1_ASM "AUTO" CACHE STRING "Assembly to use: \"AUTO\", \"OFF\", \"x86_64\" or \"arm32\" (experimental). [default=AUTO]")
92set_property(CACHE SECP256K1_ASM PROPERTY STRINGS "AUTO" "OFF" "x86_64" "arm32")
93check_string_option_value(SECP256K1_ASM)
94if(SECP256K1_ASM STREQUAL "arm32")
95  enable_language(ASM)
96  include(CheckArm32Assembly)
97  check_arm32_assembly()
98  if(HAVE_ARM32_ASM)
99    add_compile_definitions(USE_EXTERNAL_ASM=1)
100  else()
101    message(FATAL_ERROR "ARM32 assembly requested but not available.")
102  endif()
103elseif(SECP256K1_ASM)
104  include(CheckX86_64Assembly)
105  check_x86_64_assembly()
106  if(HAVE_X86_64_ASM)
107    set(SECP256K1_ASM "x86_64")
108    add_compile_definitions(USE_ASM_X86_64=1)
109  elseif(SECP256K1_ASM STREQUAL "AUTO")
110    set(SECP256K1_ASM "OFF")
111  else()
112    message(FATAL_ERROR "x86_64 assembly requested but not available.")
113  endif()
114endif()
115
116option(SECP256K1_EXPERIMENTAL "Allow experimental configuration options." OFF)
117if(NOT SECP256K1_EXPERIMENTAL)
118  if(SECP256K1_ASM STREQUAL "arm32")
119    message(FATAL_ERROR "ARM32 assembly is experimental. Use -DSECP256K1_EXPERIMENTAL=ON to allow.")
120  endif()
121endif()
122
123set(SECP256K1_VALGRIND "AUTO" CACHE STRING "Build with extra checks for running inside Valgrind. [default=AUTO]")
124set_property(CACHE SECP256K1_VALGRIND PROPERTY STRINGS "AUTO" "OFF" "ON")
125check_string_option_value(SECP256K1_VALGRIND)
126if(SECP256K1_VALGRIND)
127  find_package(Valgrind MODULE)
128  if(Valgrind_FOUND)
129    set(SECP256K1_VALGRIND ON)
130    include_directories(${Valgrind_INCLUDE_DIR})
131    add_compile_definitions(VALGRIND)
132  elseif(SECP256K1_VALGRIND STREQUAL "AUTO")
133    set(SECP256K1_VALGRIND OFF)
134  else()
135    message(FATAL_ERROR "Valgrind support requested but valgrind/memcheck.h header not available.")
136  endif()
137endif()
138
139option(SECP256K1_BUILD_BENCHMARK "Build benchmarks." ON)
140option(SECP256K1_BUILD_TESTS "Build tests." ON)
141option(SECP256K1_BUILD_EXHAUSTIVE_TESTS "Build exhaustive tests." ON)
142option(SECP256K1_BUILD_CTIME_TESTS "Build constant-time tests." ${SECP256K1_VALGRIND})
143option(SECP256K1_BUILD_EXAMPLES "Build examples." OFF)
144
145# Redefine configuration flags.
146# We leave assertions on, because they are only used in the examples, and we want them always on there.
147if(MSVC)
148  string(REGEX REPLACE "/DNDEBUG[ \t\r\n]*" "" CMAKE_C_FLAGS_RELWITHDEBINFO "${CMAKE_C_FLAGS_RELWITHDEBINFO}")
149  string(REGEX REPLACE "/DNDEBUG[ \t\r\n]*" "" CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE}")
150  string(REGEX REPLACE "/DNDEBUG[ \t\r\n]*" "" CMAKE_C_FLAGS_MINSIZEREL "${CMAKE_C_FLAGS_MINSIZEREL}")
151  # Match GCC/Clang's size-optimization macro for the inline guard
152  add_compile_definitions($<$<CONFIG:MinSizeRel>:__OPTIMIZE_SIZE__=1>)
153else()
154  string(REGEX REPLACE "-DNDEBUG[ \t\r\n]*" "" CMAKE_C_FLAGS_RELWITHDEBINFO "${CMAKE_C_FLAGS_RELWITHDEBINFO}")
155  string(REGEX REPLACE "-DNDEBUG[ \t\r\n]*" "" CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE}")
156  string(REGEX REPLACE "-DNDEBUG[ \t\r\n]*" "" CMAKE_C_FLAGS_MINSIZEREL "${CMAKE_C_FLAGS_MINSIZEREL}")
157  # Prefer -O2 optimization level. (-O3 is CMake's default for Release for many compilers.)
158  string(REGEX REPLACE "-O3( |$)" "-O2\\1" CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE}")
159endif()
160
161# Define custom "Coverage" build type.
162set(CMAKE_C_FLAGS_COVERAGE "${CMAKE_C_FLAGS_RELWITHDEBINFO} -O0 -DCOVERAGE=1 --coverage" CACHE STRING
163  "Flags used by the C compiler during \"Coverage\" builds."
164  FORCE
165)
166set(CMAKE_EXE_LINKER_FLAGS_COVERAGE "${CMAKE_EXE_LINKER_FLAGS_RELWITHDEBINFO} --coverage" CACHE STRING
167  "Flags used for linking binaries during \"Coverage\" builds."
168  FORCE
169)
170set(CMAKE_SHARED_LINKER_FLAGS_COVERAGE "${CMAKE_SHARED_LINKER_FLAGS_RELWITHDEBINFO} --coverage" CACHE STRING
171  "Flags used by the shared libraries linker during \"Coverage\" builds."
172  FORCE
173)
174mark_as_advanced(
175  CMAKE_C_FLAGS_COVERAGE
176  CMAKE_EXE_LINKER_FLAGS_COVERAGE
177  CMAKE_SHARED_LINKER_FLAGS_COVERAGE
178)
179
180if(PROJECT_IS_TOP_LEVEL)
181  get_property(is_multi_config GLOBAL PROPERTY GENERATOR_IS_MULTI_CONFIG)
182  set(default_build_type "RelWithDebInfo")
183  if(is_multi_config)
184    set(CMAKE_CONFIGURATION_TYPES "${default_build_type}" "Release" "Debug" "MinSizeRel" "Coverage" CACHE STRING
185      "Supported configuration types."
186      FORCE
187    )
188  else()
189    set_property(CACHE CMAKE_BUILD_TYPE PROPERTY
190      STRINGS "${default_build_type}" "Release" "Debug" "MinSizeRel" "Coverage"
191    )
192    if(NOT CMAKE_BUILD_TYPE)
193      message(STATUS "Setting build type to \"${default_build_type}\" as none was specified")
194      set(CMAKE_BUILD_TYPE "${default_build_type}" CACHE STRING
195        "Choose the type of build."
196        FORCE
197      )
198    endif()
199  endif()
200endif()
201
202include(TryAppendCFlags)
203if(MSVC)
204  # For both cl and clang-cl compilers.
205  try_append_c_flags(/W3) # Production quality warning level.
206  # Eliminate deprecation warnings for the older, less secure functions.
207  add_compile_definitions(_CRT_SECURE_NO_WARNINGS)
208else()
209  try_append_c_flags(-Wall) # GCC >= 2.95 and probably many other compilers.
210endif()  
211if(CMAKE_C_COMPILER_ID STREQUAL "MSVC")
212  # Keep the following commands ordered lexicographically.
213  try_append_c_flags(/wd4146) # Disable warning C4146 "unary minus operator applied to unsigned type, result still unsigned".
214  try_append_c_flags(/wd4244) # Disable warning C4244 "'conversion' conversion from 'type1' to 'type2', possible loss of data".
215  try_append_c_flags(/wd4267) # Disable warning C4267 "'var' : conversion from 'size_t' to 'type', possible loss of data".
216else()
217  # Keep the following commands ordered lexicographically.
218  try_append_c_flags(-pedantic)
219  try_append_c_flags(-Wcast-align) # GCC >= 2.95.
220  try_append_c_flags(-Wcast-align=strict) # GCC >= 8.0.
221  try_append_c_flags(-Wconditional-uninitialized) # Clang >= 3.0 only.
222  try_append_c_flags(-Wextra) # GCC >= 3.4, this is the newer name of -W, which we don't use because older GCCs will warn about unused functions.
223  try_append_c_flags(-Wleading-whitespace=spaces) # GCC >= 15.0
224  try_append_c_flags(-Wnested-externs)
225  try_append_c_flags(-Wno-long-long) # GCC >= 3.0, -Wlong-long is implied by -pedantic.
226  try_append_c_flags(-Wno-overlength-strings) # GCC >= 4.2, -Woverlength-strings is implied by -pedantic.
227  try_append_c_flags(-Wno-unused-function) # GCC >= 3.0, -Wunused-function is implied by -Wall.
228  try_append_c_flags(-Wreserved-identifier) # Clang >= 13.0 only.
229  try_append_c_flags(-Wshadow)
230  try_append_c_flags(-Wstrict-prototypes)
231  try_append_c_flags(-Wtrailing-whitespace=any) # GCC >= 15.0
232  try_append_c_flags(-Wundef)
233endif()
234
235set(print_msan_notice)
236if(SECP256K1_BUILD_CTIME_TESTS)
237  include(CheckMemorySanitizer)
238  check_memory_sanitizer(msan_enabled)
239  if(msan_enabled)
240    try_append_c_flags(-fno-sanitize-memory-param-retval)
241    set(print_msan_notice YES)
242  endif()
243  unset(msan_enabled)
244endif()
245
246set(SECP256K1_APPEND_CFLAGS "" CACHE STRING "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.")
247if(SECP256K1_APPEND_CFLAGS)
248  # Appending to this low-level rule variable is the only way to
249  # guarantee that the flags appear at the end of the command line.
250  string(APPEND CMAKE_C_COMPILE_OBJECT " ${SECP256K1_APPEND_CFLAGS}")

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

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.