# Copyright 1999-2026 Gentoo Authors # Distributed under the terms of the GNU General Public License v2 EAPI=8 PYTHON_COMPAT=( python3_{10..13} ) inherit bash-completion-r1 check-reqs cmake db-use desktop edo multiprocessing python-any-r1 systemd toolchain-funcs xdg-utils DESCRIPTION="Enhanced implementation of the Bitcoin cryptocurrency" HOMEPAGE="https://bitcoinknots.org/" SRC_URI=" !bitcoin_protocol_rdts? ( https://github.com/bitcoinknots/bitcoin/releases/download/v29.3.knots20260507/bitcoin-29.3.knots20260507.tar.gz ) bitcoin_protocol_rdts? ( https://github.com/bitcoinknots/bitcoin/releases/download/v29.3.knots20260508/bitcoin-29.3.knots20260508.tar.gz ) https://raw.githubusercontent.com/bitcoin/bitcoin/v27.1/src/qt/res/src/bitcoin.svg -> bitcoin128.svg " S="${WORKDIR}/$PN" LICENSE="MIT" SLOT="0" if [[ "${PV}" != *_rc* ]] ; then KEYWORDS="~amd64 ~arm ~arm64 ~ppc ~ppc64 ~x86 " fi IUSE="+asm +berkdb +bitcoin_protocol_rdts rdts_implicit +cli +daemon dbus examples +external-signer gui libs +man +qrcode qt6 +sqlite system-leveldb +system-libsecp256k1 systemtap test test-full tor-subprocess upnp zeromq" RESTRICT="!test? ( test )" REQUIRED_USE=" rdts_implicit? ( bitcoin_protocol_rdts ) dbus? ( gui ) qrcode? ( gui ) qt6? ( gui ) test-full? ( test ) system-leveldb? ( || ( daemon gui ) ) " # dev-libs/univalue is now bundled, as upstream dropped support for system copy # and their version in the Bitcoin repo has deviated a fair bit from upstream. # Upstream also seems very inactive. RDEPEND=" !net-p2p/bitcoin-core !dev-util/bitcoin-tx >=dev-libs/boost-1.81.0:= >=dev-libs/libevent-2.1.12:= berkdb? ( >=sys-libs/db-4.8.30:$(db_ver_to_slot 4.8)=[cxx] ) cli? ( !net-p2p/bitcoin-cli ) daemon? ( !net-p2p/bitcoind acct-group/bitcoin acct-user/bitcoin ) gui? ( !net-p2p/bitcoin-qt qt6? ( >=dev-qt/qtbase-6.2:6[dbus?,gui,network,widgets] ) !qt6? ( >=dev-qt/qtcore-5.15.11:5 >=dev-qt/qtgui-5.15.11:5 >=dev-qt/qtnetwork-5.15.11:5 >=dev-qt/qtwidgets-5.15.11:5 dbus? ( >=dev-qt/qtdbus-5.15.11:5 ) ) ) libs? ( !net-libs/libbitcoinconsensus ) qrcode? ( >=media-gfx/qrencode-4.1.1:= ) sqlite? ( >=dev-db/sqlite-3.38.5:= ) system-leveldb? ( virtual/bitcoin-leveldb ) system-libsecp256k1? ( >=dev-libs/libsecp256k1-0.4.0:=[ellswift,extrakeys,recovery,schnorr] ) tor-subprocess? ( net-vpn/tor ) upnp? ( >=net-libs/miniupnpc-2.2.2:= ) zeromq? ( >=net-libs/zeromq-4.3.4:= ) " DEPEND=" ${RDEPEND} systemtap? ( >=dev-debug/systemtap-4.8 ) " BDEPEND=" >=dev-build/cmake-3.25 virtual/pkgconfig daemon? ( acct-group/bitcoin acct-user/bitcoin ) gui? ( dev-libs/libxslt gnome-base/librsvg media-gfx/imagemagick[png] qt6? ( >=dev-qt/qttools-6.2:6[linguist] ) !qt6? ( >=dev-qt/linguist-tools-5.15.11:5 ) ) test? ( ${PYTHON_DEPS} ) " IDEPEND=" gui? ( dev-util/desktop-file-utils ) " DOCS=( doc/bips.md doc/bitcoin-conf.md doc/descriptors.md doc/files.md doc/i2p.md doc/JSON-RPC-interface.md doc/multisig-tutorial.md doc/p2p-bad-ports.md doc/psbt.md doc/reduce-memory.md doc/reduce-traffic.md doc/release-notes.md doc/REST-interface.md doc/tor.md ) efmt() { : ${1:?} ; local l ; while read -r l ; do "${!#}" "${l}" ; done < <(fmt "${@:1:$#-1}") } pkg_pretend() { if ! use daemon && ! use gui && ! has_version "${CATEGORY}/${PN}[-daemon,-gui(-),-qt5(-)]" ; then efmt ewarn <<-EOF You are enabling neither USE="daemon" nor USE="gui". This is a valid configuration, but you will be unable to run a Bitcoin node using this installation. EOF fi if use daemon && ! use cli && ! has_version "${CATEGORY}/${PN}[daemon,-bitcoin-cli(-),-cli(-)]" ; then efmt ewarn <<-EOF You are enabling USE="daemon" but not USE="cli". This is a valid configuration, but you will be unable to interact with your bitcoind node via the command line using this installation. EOF fi if ! use berkdb && ! use sqlite && { { use daemon && ! has_version "${CATEGORY}/${PN}[daemon,-berkdb,-sqlite]" ; } || { use gui && ! has_version "${CATEGORY}/${PN}[gui,-berkdb,-sqlite]" ; } ; } then efmt ewarn <<-EOF You are enabling neither USE="berkdb" nor USE="sqlite". This is a valid configuration, but your Bitcoin node will be unable to open any wallets. EOF fi # test/functional/feature_pruning.py requires 4 GB disk space # test/functional/wallet_pruning.py requires 1.3 GB disk space use test && CHECKREQS_DISK_BUILD="6G" check-reqs_pkg_pretend } pkg_setup() { if use test ; then CHECKREQS_DISK_BUILD="6G" check-reqs_pkg_setup python-any-r1_pkg_setup fi elog if use bitcoin_protocol_rdts; then ewarn "Attention: BIP110/RDTS Network Upgrade" ewarn ewarn "This version of Bitcoin Knots applies the BIP110 (RDTS) network upgrade, which" ewarn "fixes critical vulnerabilities in long-standing network design." if [ -n "${REPLACING_VERSIONS}" ] && ! has_version "${CATEGORY}/${PN}[bitcoin_protocol_rdts]"; then ewarn "By proceeding with this install, you are explicitly adopting this upgrade." fi ewarn ewarn "Important: Because this upgrade already has broad community support, disabling" ewarn "the USE flag or reverting to an older software version does not reject it." ewarn "Running outdated software after any network upgrade only leaves your node" ewarn "vulnerable to displaying fake or fraudulent transactions. To effectively reject" ewarn "this upgrade, you need to run alternative software designed to split away from" ewarn "the upgraded network." else ewarn "Warning: Upcoming BIP110/RDTS Network Upgrade" ewarn ewarn "Because the bitcoin_protocol_rdts USE flag is disabled, this ebuild is falling" ewarn "back to the older 29.3.knots20260507 version. This version is equivalent except" ewarn "that it lacks support for the upcoming BIP110 (RDTS) network upgrade, which" ewarn "fixes critical vulnerabilities in long-standing network design." ewarn ewarn "Important: Because this upgrade already has broad community support, compiling" ewarn "without this USE flag or running older versions does not reject it. Running" ewarn "outdated software after any network upgrade only leaves your node vulnerable" ewarn "to displaying fake or fraudulent transactions. To effectively reject this" ewarn "upgrade, you need to run alternative software designed to split away from the" ewarn "upgraded network." fi ewarn ewarn "For more information, see: https://bitcoinknots.org/learn/2026-rdts" ewarn if ! use bitcoin_protocol_rdts; then ewarn "You should set USE=bitcoin_protocol_rdts to upgrade." fi } src_unpack() { default mv bitcoin-* "${PN}" } src_prepare() { # https://bugs.gentoo.org/958361 # https://github.com/google/crc32c/commit/2bbb3be42e20a0e6c0f7b39dc07dc863d9ffbc07 sed -e '/^cmake_minimum_required(VERSION 3\.1)$/s/)$/6)/' -i src/crc32c/CMakeLists.txt || die eapply_user ! use system-leveldb || rm -r src/leveldb || die ! use system-libsecp256k1 || rm -r src/secp256k1 || die cmake_src_prepare # we set BUILD_UTIL=OFF, so we can't test bitcoin-util sed -ne '/^ {/{h;:0;n;H;/^ }/!b0;g;\|"exec": *"\./bitcoin-util"|d};p' \ -i test/util/data/bitcoin-util-test.json || die sed -e 's/^\(complete -F _bitcoind\b\).*$/\1'"$(usev daemon ' bitcoind')$(usev gui ' bitcoin-qt')/" \ -i contrib/completions/bash/bitcoind.bash || die } src_configure() { local wallet ; if use berkdb || use sqlite ; then wallet=ON ; else wallet=OFF ; fi local mycmakeargs=( -DBUILD_SHARED_LIBS=ON -DENABLE_WALLET=${wallet} -DWITH_SQLITE=$(usex sqlite) -DWITH_BDB=$(usex berkdb) -DWITH_USDT=$(usex systemtap) -DBUILD_TESTS=$(usex test) -DBUILD_BENCH=$(usex test) -DBUILD_{FOR_FUZZING,FUZZ_BINARY}=OFF -DWITH_QRENCODE=$(usex qrcode) -DWITH_CCACHE=OFF -DWITH_ZMQ=$(usex zeromq) -DENABLE_EXTERNAL_SIGNER=$(usex external-signer) -DBUILD_CLI=$(usex cli) -DBUILD_TX=ON -DBUILD_WALLET_TOOL=${wallet} -DBUILD_UTIL=OFF -DBUILD_DAEMON=$(usex daemon) -DBUILD_GUI=$(usex gui) -DWITH_QT_VERSION=$(usex qt6 6 5) -DWITH_DBUS=$(usex dbus) -DWITH_SYSTEM_LIBSECP256K1=$(usex system-libsecp256k1 ON \ "OFF -DSECP256K1_ASM=$(usex asm AUTO OFF)") -DWITH_SYSTEM_LEVELDB=$(usex system-leveldb) -DBUILD_BITCOINCONSENSUS_LIB=$(usex libs) -DINSTALL_MAN=$(usex man) -DENABLE_TOR_SUBPROCESS=$(usex tor-subprocess) -DWITH_MINIUPNPC=$(usex upnp) ) if use rdts_implicit; then mycmakeargs+=( -D RDTS_CONSENT=IMPLICIT ) elif use bitcoin_protocol_rdts; then mycmakeargs+=( -D RDTS_CONSENT=RUNTIME_WARN ) fi cmake_src_configure } src_compile() { if use gui ; then xsltproc --novalid --nonet --path src/qt/res/src "${FILESDIR}/flatten.xslt" src/qt/res/src/bitcoin.svg > bitcoinknots.svg fi BITCOIN_GENBUILD_NO_GIT=1 \ cmake_src_compile if use daemon && ! tc-is-cross-compiler ; then TOPDIR="${S}" BUILDDIR="${BUILD_DIR}" bash contrib/devtools/gen-bitcoin-conf.sh || die fi sed -e 's/ To use, copy this file$//p;Tp;:0;n;/save the file\.$/!b0;d;:p;p' \ -ni share/examples/bitcoin.conf || die } src_test() { cmake_src_test if use daemon ; then cd -- "${BUILD_DIR}" || die edo "${PYTHON}" test/functional/test_runner.py \ --ansi $(usev test-full --extended) --jobs="$(get_makeopts_jobs)" --timeout-factor="${TIMEOUT_FACTOR:-15}" fi } src_install() { use external-signer && DOCS+=( doc/external-signer.md ) use berkdb || use sqlite && DOCS+=( doc/managing-wallets.md ) use libs && DOCS+=( doc/shared-libraries.md ) use systemtap && DOCS+=( doc/tracing.md ) use zeromq && DOCS+=( doc/zmq.md ) if use daemon ; then # https://bugs.gentoo.org/757102 DOCS+=( share/rpcauth/rpcauth.py ) docompress -x "/usr/share/doc/${PF}/rpcauth.py" fi einstalldocs cmake_src_install find "${ED}" -type f -name '*.la' -delete || die ! use test || rm -f -- "${ED}"/usr/bin/{bench,test}_bitcoin{,-qt} || die newbashcomp contrib/completions/bash/bitcoin-tx.bash bitcoin-tx use cli && newbashcomp contrib/completions/bash/bitcoin-cli.bash bitcoin-cli if use daemon ; then newbashcomp contrib/completions/bash/bitcoind.bash bitcoind use gui && bashcomp_alias bitcoind bitcoin-qt elif use gui ; then newbashcomp contrib/completions/bash/bitcoind.bash bitcoin-qt fi if use cli; then insinto /usr/share/zsh/site-functions doins contrib/completions/zsh/bitcoin-cli.zsh fi if use daemon ; then insinto /etc/bitcoin doins share/examples/bitcoin.conf fowners bitcoin:bitcoin /etc/bitcoin/bitcoin.conf fperms 0660 /etc/bitcoin/bitcoin.conf newconfd contrib/init/bitcoind.openrcconf bitcoind newconfd contrib/init/bitcoind.openrc bitcoind systemd_newunit contrib/init/bitcoind.service bitcoind.service keepdir /var/lib/bitcoind fperms 0750 /var/lib/bitcoind fowners bitcoin:bitcoin /var/lib/bitcoind dosym -r {/etc/bitcoin,/var/lib/bitcoind}/bitcoin.conf insinto /etc/logrotate.d newins "${FILESDIR}/bitcoind.logrotate-r1" bitcoind fi if use gui ; then insinto /usr/share/icons/hicolor/scalable/apps doins "${DISTDIR}/bitcoin128.svg" doins bitcoinknots.svg domenu "${FILESDIR}/org.bitcoin.bitcoin-qt.desktop" fi if use examples ; then docinto examples dodoc -r contrib/{linearize,qos} use zeromq && dodoc -r contrib/zmq fi } pkg_preinst() { if use daemon && [[ -d "${EROOT}/var/lib/bitcoin/.bitcoin" ]] ; then if [[ -h "${EROOT}/var/lib/bitcoin/.bitcoin" ]] ; then dosym -r /var/lib/bitcoin{d,/.bitcoin} elif [[ ! -e "${EROOT}/var/lib/bitcoind" || -h "${EROOT}/var/lib/bitcoind" ]] ; then efmt ewarn <<-EOF Your bitcoind data directory is located at ${EPREFIX}/var/lib/bitcoin/.bitcoin, a deprecated location. To perform an automated migration to ${EPREFIX}/var/lib/bitcoind, first shut down any running bitcoind instances that may be using the deprecated path, and then run: # emerge --config ${CATEGORY}/${PN} EOF insinto /var/lib/bitcoin mv -- "${ED}/var/lib/bitcoin"{d,/.bitcoin} || die dosym -r {/etc/,/var/lib/bitcoin/.}bitcoin/bitcoin.conf dosym -r /var/lib/bitcoin{/.bitcoin,d} fi fi } pkg_postinst() { # we don't use xdg.eclass because it adds unconditional IDEPENDs if use gui ; then xdg_desktop_database_update xdg_icon_cache_update fi if use daemon && [[ -z "${REPLACING_VERSIONS}" ]] ; then efmt -su elog <<-EOF To have ${PN} automatically use Tor when it's running, be sure your \ 'torrc' config file has 'ControlPort' and 'CookieAuthentication' set up \ correctly, and: - Using an init script: add the 'bitcoin' user to the 'tor' user group. - Running bitcoind directly: add that user to the 'tor' user group. EOF fi if use cli && use daemon ; then efmt -su elog <<-EOF To use bitcoin-cli with the /etc/init.d/bitcoind service: - Add your user(s) to the 'bitcoin' group. - Symlink ~/.bitcoin to /var/lib/bitcoind. EOF fi if use berkdb ; then # https://github.com/bitcoin/bitcoin/pull/28597 # https://bitcoincore.org/en/releases/26.0/#wallet efmt ewarn <<-EOF Creation of legacy (Berkeley DB) wallets is refused starting with Bitcoin Core 26.0, pending the deprecation and eventual removal of support for legacy wallets altogether in future releases. At present you can still force support for the creation of legacy wallets by adding the following line to your bitcoin.conf: deprecatedrpc=create_bdb EOF fi } pkg_postrm() { if use gui ; then xdg_desktop_database_update xdg_icon_cache_update fi } pkg_config() { if [[ -d "${EROOT}/var/lib/bitcoin/.bitcoin" && ! -h "${EROOT}/var/lib/bitcoin/.bitcoin" ]] && [[ ! -e "${EROOT}/var/lib/bitcoind" || -h "${EROOT}/var/lib/bitcoind" ]] then in_use() { : ${1:?} ; local each if command -v fuser >/dev/null ; then fuser "${@}" >/dev/null 2>&1 elif command -v lsof >/dev/null ; then for each ; do lsof -- "${each}" && return done >/dev/null 2>&1 elif mountpoint -q /proc ; then { find /proc/[0-9]*/{cwd,exe,fd} -type l -exec readlink -- {} + awk '{ print $6 }' /proc/[0-9]*/maps } 2>/dev/null | grep -Fqx -f <(printf '%s\n' "${@}" ; readlink -m -- "${@}") else return 13 fi } ebegin "Checking that ${EPREFIX}/var/lib/bitcoin/.bitcoin is not in use" in_use "${EROOT}/var/lib/bitcoin/.bitcoin"{,/.lock} case $? in 0) eend 1 efmt eerror <<-EOF ${EPREFIX}/var/lib/bitcoin/.bitcoin is currently in use. Please stop any running bitcoind instances that may be using this data directory, and then retry this migration. EOF die "${EPREFIX}/var/lib/bitcoin/.bitcoin is in use" ;; 13) eend 1 if [[ "${BITCOIND_IS_NOT_RUNNING}" != 1 ]] ; then efmt eerror <<-EOF Found no way to check whether ${EPREFIX}/var/lib/bitcoin/.bitcoin is in use. Do you have /proc mounted? To force the migration without checking, re-run this command with BITCOIND_IS_NOT_RUNNING=1. EOF die "could not check whether ${EPREFIX}/var/lib/bitcoin/.bitcoin is in use" fi ;; *) eend 0 ;; esac # find all relative symlinks that point outside the data dir local -A symlinks cd -- "${EROOT}/var/lib/bitcoin/.bitcoin" || die local each ; while read -r -d '' each ; do local target=$(readlink -- "${each}") && [[ "${target}" == ../* ]] && target=$(readlink -e -- "${each}") && [[ "${target}" != "${EROOT}/var/lib/bitcoin/.bitcoin/"* ]] && symlinks["${each}"]="${target}" done < <(find -type l -print0) einfo "Moving your ${EPREFIX}/var/lib/bitcoin/.bitcoin to ${EPREFIX}/var/lib/bitcoind." rm -f -- "${EROOT}/var/lib/bitcoind" || die mv --no-clobber --no-copy --no-target-directory -- "${EROOT}/var/lib/bitcoin"{/.bitcoin,d} || die "Failed to move your ${EPREFIX}/var/lib/bitcoin/.bitcoin to ${EPREFIX}/var/lib/bitcoind." # fix up the relative symlinks cd -- "${EROOT}/var/lib/bitcoind" || die for each in "${!symlinks[@]}" ; do ln -fnrs -- "${symlinks[${each}]}" "${each}" # keep going even if this fails done einfo 'Creating a transitional symlink for your convenience.' ln -fnrsv -- "${EROOT}/var/lib/bitcoin"{d,/.bitcoin} einfo 'You may remove this link when you no longer need it.' else einfo 'Nothing to do.' fi }