Repository navigation
Releases
rbitcoin v0.9.2
rbitcoin v0.9.2
Linux musl x86_64 and aarch64 are the operator binaries (statically
linked). Windows is CRT-static PE (no IoRing). Darwin aarch64 is ad-hoc
codesigned, not notarized (xattr -d com.apple.quarantine).
Image (linux/amd64, linux/arm64): docker pull ghcr.io/rbitcoin-org/rbitcoin:0.9.2.
Highlights
- A datadir that already connected the bad re-spend needs a re-sync.
IBD could connect a block that spent an output a lower block in the
same write had already spent. After a disconnect, that output read as
unspent. 0.9.2 does not connect that block. A store that already did
keeps the wrong spent slot. Schema stays 27, so a 0.9.1 directory
opens in place. - IBD no longer stops on a spend of a later block's transaction. A
valid block in front of that spend used to halt with "engine fault
repeated" until restart. The bad block is marked invalid and IBD
continues. submitblockno longer caches a valid block as invalid when a
sibling connects mid-check. The check reads one tip. A competing
block that lands during the check no longer leaves the submission
bad-txns-inputs-missingorspentuntil restart.- A restarted
--prune-seqsigwitnode can reorg back. It used to
drop the block a peer sent and stay on the lighter branch until the
next restart. - Silent-payment subscribe addresses decode. The address includes
the BIP-352 version:sp1qon mainnet andtsp1qon test networks,
including regtest. - A signet datadir is recorded on first start.
{datadir}/network
stores the network and its message start. A later start with another
challenge refuses before the store opens. A 0.9.1 datadir has no
marker. Start it once with its original--signet-challenge, or that
first start is the one it keeps. - RPC auth schemes match in any case. A crash can no longer leave
an emptyrpc.tokenthat blocks the next start. - An I2P SAM reply with a non-ASCII character no longer panics the
node at startup. getindexinfolists the basic block filter index when
--block-filter-indexis on.submitpackagereportsother-wtxidwhen the txid is already in
the mempool under another witness.- A lost outbound onion or I2P peer is replaced. Stale-tip rotation
no longer treats every overlay peer as one network group.
Thanks to @niteshbalusu11, @erskingardner, @w3irdrobot, @SovereignTechnology for changes in this release.
Full notes: CHANGELOG.md ## [0.9.2].
rbitcoin v0.9.1
rbitcoin v0.9.1
Linux musl x86_64 and aarch64 are the operator binaries (statically
linked). Windows is CRT-static PE (no IoRing). Darwin aarch64 is ad-hoc
codesigned, not notarized (xattr -d com.apple.quarantine).
Image (linux/amd64, linux/arm64): docker pull ghcr.io/rbitcoin-org/rbitcoin:0.9.1.
Highlights
- Opening a data directory with 0.9.1 is one-way. Any open rewrites
store/metato schema 27, whether or not--prune-seqsigwitis set.
The table bytes stay as they were. A 0.9.0 binary will not open that
directory. --prune-seqsigwitnow drops witness history. The flag keeps
scriptSig and witness for the last 288 blocks and deletes the rest of
seqsigwit.body. A directory that 0.9.0 already marked pruned is
rewritten into that window, and then the old body is freed. Later
blocks do not grow that file.- Silent-payment tweaks can run on that prune. Turn
--sp-tweakson
before taproot, or later once the index covers every height the cut
will drop. Sealed rows still serve. A scan that cannot read a height
returns that error. - Wallet services stay off Tor and I2P unless you ask. Electrum and
Esplora are no longer published from--tor-controlor
--i2p-accept-incomingalone. Set--electrum-onion,
--esplora-onion,--electrum-i2p, or--esplora-i2p. Saved keys
are kept. A switch without its overlay, or without a TCP listener on
127.0.0.1or0.0.0.0, refuses to start. - Names behind a proxy are no longer looked up on the host.
--connectandaddnodehostnames go to the SOCKS proxy.
--only-net oniondoes not query clearnet seeds. I2P tunnels use the
router default of three hops. - A bad Tor onion key stops startup. An
ADD_ONIONreply and a
savedonion/*.privkey must be a v3 service id and anED25519-V3
key of 64 bytes. Remove the named file to generate a new key. estimatesmartfee 1answers as target 2 until the mempool is busy.
Electrumblockchain.estimatefee 1does the same. Once flow is full,
target 1 is the 1-block quote. Electrum target 0,estimaterawfee 1,
and Esplora key1stay on the 1-block quote.- A memory limit bounds the worker pools. On Linux, the scripthash
build and the transaction-head rebuild use the smaller of host memory
and the cgroup limit (MemoryMax=,docker --memory). - NixOS can set the operator flags. Peering, mempool, RPC, indexes,
and Tor control areservices.rbitcoinoptions. Wallet onion and I2P
forwards pass the new switches only when that listener is enabled. cargo install --lockedmatches this release. The 0.9.0 tag left
the lock at 0.8.99. This tag's lock names 0.9.1.
Thanks to @erskingardner, @botcount for changes in this release.
Full notes: CHANGELOG.md ## [0.9.1].
rbitcoin v0.9.0
rbitcoin v0.9.0
Linux musl x86_64 and aarch64 are the operator binaries (statically
linked). Windows is CRT-static PE (no IoRing). Darwin aarch64 is ad-hoc
codesigned, not notarized (xattr -d com.apple.quarantine).
Image (linux/amd64, linux/arm64): docker pull ghcr.io/rbitcoin-org/rbitcoin:0.9.0.
Highlights
- The consensus rules have been reviewed since 0.8. This code was
used to add a rule and tighten others in Hornet's written rules. It
was compared with Rob Hamilton's btc-lean description of Bitcoin's
rules, and that comparison helped specify those rules more completely.
Matt Corallo attempted to prove that the compiled code matches
Bitcoin. The rules held up. A split from Bitcoin Core on mainnet is
very unlikely. Signed release files and a support window remain the
plan for 1.0. - 0.9 is easier to install, and a 0.8 data directory still opens.
This release adds a Linux ARM build and a container image:
docker pull ghcr.io/rbitcoin-org/rbitcoin:0.9.0. The tag has no
leadingv. A 0.8 directory opens unchanged. A 0.7 directory is
upgraded on open. A directory from 0.6 or earlier is refused: delete
it and sync again. Do not open an upgraded directory with an older
release. - Mainnet skips historical script checks through a later block. The
default is block 966143, the same block Bitcoin Core 32.1 uses. 0.8
stopped at block 840,000. The node still checks that inputs exist,
have not been spent twice, and that the fees are correct. Set
--milestone 0before the first sync to check every historical
script. Changing that setting later does not recheck blocks already
stored. Signet still checks every script.--network testnet4is
new, and it also checks every script. - Wallets that use Bitcoin Core's interface can publish again. The
fee cap onsendrawtransactionis interpreted the same way Bitcoin
Core interprets it. LND was sending0.1and having the transaction
rejected. Broadcasting a transaction that is already confirmed, and
still has an unspent output, returns-27instead of "missing
inputs." A missing or already-spent input returns-25. A request
for an unknown transaction returns-5. - Electrum and Esplora answer a page of address lookups together. A
batch of history requests no longer runs one address at a time.
Clients can also request history as of a specific block without
negotiating a special protocol version. - The node is harder to identify from network traffic. An encrypted
connection begins with a random amount of extra data, as Bitcoin Core
does, rather than a fixed length. A private broadcast uses new peers,
omits this node's name from the first message, and does not connect
directly over the clearnet. - A crash during sync is less likely to leave a damaged tip.
Startup repairs a tip that was only partly written. A data directory
for another network is refused. If the address index has no progress
mark, it is rebuilt from blocks already stored. SIGHUP, SIGUSR1, and
SIGUSR2 shut the node down cleanly, as Ctrl+C and SIGTERM do. - macOS sync is faster. Reads of the data directory no longer pass
through a single lock. The previous path was about 20% slower on a
signet sync. It remains available withRBITCOIN_IO=pool. - Fee estimates remain useful when the mempool is busy. A near-term
target no longer falls back to the minimum relay fee when every
higher rate is already full. The estimate is at least the mempool's
minimum fee. Block templates order transactions as Bitcoin Core does:
a transaction together with the unconfirmed parents it depends on,
ranked by their combined fee rate. - An arbitrary peer cannot force a compact-block rebuild. Only a
peer this node selected for compact blocks can send one the node did
not request. From any other peer, that message is treated as a header
announcement. Once this node has the block, it can send the compact
form to those peers immediately. - Trusted-peer mode follows one peer and still checks the rules.
--trust-peerconnects only to that address. It is not a faster way
to sync. Listening, seed nodes, and every other peer stay off. Some
failures from that peer are accepted and written to the log, including
a script failure. Proof of work, the required difficulty, and a block
body that does not match its header are still rejected. Transactions
and blocks you submit yourself are still checked in full. Do not point
a wallet at this node unless you accept that peer.
Thanks to @w3irdrobot, @Naomi-Gift, @bkeroack, @smolcars, @surgecredit, @bobberb, @vincenzopalazzo, @phlip9, @coreyphillips, @portlandhodl, @thesimplekid, @irnb, @xstoicunicornx for changes in this release.
Full notes: CHANGELOG.md ## [0.9.0].
rbitcoin v0.8.0
rbitcoin v0.8.0
Linux musl x86_64 is the operator binary (statically linked).
Windows is CRT-static PE (no IoRing). Darwin aarch64 is ad-hoc
codesigned, not notarized (xattr -d com.apple.quarantine).
Highlights
- Schema 26 opens a 0.7 datadir in place. Schema 24 and 25 rewrite
header.bodyfrom 96 B to 88 B andmetato 26. A store older than schema
22, including occupied 0.6.x, refuses with one wipe-and-IBD line. - Mainnet script skip is path-anchored. The default milestone still names
height 840000 and block
0000000000000000000320283a032748cef8227873ff4872689bf23f1cda83a5. Scripts
skip only on that header path once chain work meets Core
nMinimumChainWork. Signet’s default milestone is 0 (every script). An
explicit--milestone HEIGHTstays height-only. - Initial sync keeps moving on ordinary connections. One peer serves
headers. The others download blocks, at most 64 blocks or 16 MiB in
flight, sized from recent bodies. A peer holding the tip block is
replaced only after 5 seconds, and only when a free peer would finish
it in half the time. A full serve queue waits out the rest of a
getdatainstead of dropping it. - Consensus checks match Bitcoin Core where they used to disagree.
BIP30 is off only when the header at BIP34 height is that network’s
BIP34 block, and it is always on from height 1,983,702. A confirm batch
cannot spend an output created by a later block in that batch. The
genesis coinbase is not a spendable coin. An empty signature in legacy
CHECKMULTISIGdeletesOP_0from scriptCode. A bad copy of a valid
block is requested again and is not cached as invalid. - Peers and RPC fail closed under load. Counts above 50,000 in
inv,
getdata, andnotfoundfail decode. Compact-block and block
transaction counts are rejected before allocation. The RPC body cap is
2 MiB, and a full work queue is HTTP 503 before the handler. A session
pauses once its outbound queue passes 4 MiB. An unpaged scripthash join
above--max-sh-creates(default 10000) is refused. - Wallets, Lightning nodes, and explorers have a setup guide.
docs/wallets.mdanddocs/lightning.md. Electrum and Esplora serve
Electrum, Sparrow, Liana, Specter, Cake Wallet, BlueWallet, BitBox App,
Envoy, and BDK (including Alby Hub). Wasabi’s full-node path uses
getblockfilterand--rpc-cookie-file(HTTP Basic on TCP).
getnetworkinfo.versionstays 190000 (Core 0.19’s client integer); the
semver stays insubversion. CLN (bcliandsauron), ldk-node
(Esplora, Electrum, or REST), and LND withbitcoind.rpcpollinguse
this node as the chain source. Esplora/internal/*on the unix socket
is the mempool.space electrs drop-in./fee-estimateskeeps the
estimator’s precision./fees/recommendedand/wsare 404. - Feerate uses sigop-adjusted size. Admission, RBF, eviction, estimates,
and-blockmintxfeeusemax(weight, sigop_cost × bytes_per_sigop)
(default 20,--bytes-per-sigop,0disables). A transaction whose sigop
cost reaches the template budget is rejected. Template selection applies
the mintxfee floor per chunk and keeps the block sigop cap. - Fee quotes follow a log grid and a fullness blend. About 100 steps per
decade from min relay (0.1 sat/vB) through 1000 sat/vB, plus one open
bucket above that. The published rate is(1−α)·history + α·live flow.
α is decayed admitted weight over about 1.44M WU (150s half-life). History
is filled fromtxstat(at most 1 GiB; each block’s vsize-weighted p10
of individual rates).estimatesmartfeereturns{feerate, blocks}, or
{errors, blocks}with nofeeratewhen it has no estimate, and
feerateis at leastmempoolminfee. - Block filters and silent-payment tweaks build during IBD, and after
it when they are behind. With the index on from the start, each
confirmed block is built on the script pool and appended on the confirm
write. A restart gap of at most 2,016 blocks is sealed before confirm.
A larger gap, including an index enabled on an already synced datadir,
is built afterward byrbtc-idx-wb(index: build) and does not hold
the node in initial download.NODE_COMPACT_FILTERSis advertised once
filters reach the tip. With--datadir-cold,blockfilterand
sp_tweaksmust sit on the cold store. - Spend annotations recover after a crash past the tip seal. A missing
spent slot stays unspent until open replays above thespend_durable
marker.rbtc-spend-synccheckpoints about every ten minutes, and once
more on shutdown.
Thanks to @otaliptus for the security review, and to @dergoegge, @Rob1Ham, and @1440000bytes for earlier findings.
Thanks to @benthecarman, @average-gary, @bobberb, @Hero-Gamer, @bkeroack, @xstoicunicornx, and @RandyMcMillan for changes in this release.
Full notes: CHANGELOG.md ## [0.8.0].
rbitcoin v0.7.0
rbitcoin v0.7.0
Linux musl x86_64 is the operator binary (statically linked).
Windows is CRT-static PE (no IoRing). Darwin aarch64 is ad-hoc
codesigned, not notarized (xattr -d com.apple.quarantine).
Highlights
- Wipe 0.6.x stores: schema 24 refuses occupied schema-20 Class A
(wipe datadir and redo IBD). Do not open a populated 0.6.x datadir in
place. Empty 0.6 indexes rewritemeta. - Faster IBD: loc rides the InFlight pin (load never loc-by-fk); body-queue
header_fkskips header ensure; tip+1 hole racing by drain time; sequential
header.bodysize/weight; BIP30 same-txid across a load wave. - Smaller store: schema 22
create.loc+inwit.loc(no three Class A
*.idx); compact txout amounts; sealed fuse8 + SH occupancy mmap (heap
fuse8=/mphf_occ=only). - Mempool persist: packed schema 2 — 5 s dirty tail, one-record DEAD
pwrite, no fulltx.bodyrewrite on block strip. Leftover schema 1
converts on open. - Frigate silent payments: Electrum
blockchain.silentpayments.subscribe
(session scan key) plus--sp-tweaks/silentpayments.unsubscribe. - Wallet protocols: Electrum 1.6 (
broadcast_package,mempool.get_info,
outpoint.*) and 1.7 leftovers; cheap Esplora/blocksfrom stored
size/weight (schema 24). - Operator CLI / RPC: kebab-only (
--sh-index,--sp-tweaks,
--rpc-listen); TCP auth is Bearer{datadir}/rpc.token(no--rpcuser/
.cookie). - Testing: catalog journeys absorb leftover twins; Core functional
runis
production-only; live P2P IBD in default CI; production LCOV floor 92%. - CRAP: required
coveragerunscargo crap --fail-above 30with a chewed
allowlist (P2P / IBD / RPC / store extracts). - Windows: positional IO on IOCP handles no longer heap-corrupts on
seal-roll / query smoke.
Full notes: CHANGELOG.md ## [0.7.0].
rbitcoin v0.6.1
rbitcoin v0.6.1
Linux musl x86_64 is the operator binary (statically linked).
Windows is CRT-static PE (no IoRing). Darwin aarch64 is ad-hoc
codesigned, not notarized (xattr -d com.apple.quarantine).
Highlights
- Compact reconstruct: a unique short-id fill is not a block until the
txs merkle to the compact header. Merkle-mutated compact is not cached
BLOCK_FAILED(mainnet 966500/966501). Upgrade, then reorg. - SH megakey rewind:
DisconnectTipwalks linked SH pages when
extent_nexceeds the 64 MiB span-pread cap (Corrupt used to block
equal-work sibling rewind). - io_uring drain:
drain_allwaits for CQEs; 120 s of zero completions
aborts (RBITCOIN_URING_DRAIN_HARD_SECS). Restart withRBITCOIN_IO=pread
if the ring cannot complete. - Resume seed: cyclic
prev_fkedges no longer hang
resume seed walk start. - Same-block coinbase spends are immature; IBD
lookup_taken_hirewinds
on post-lookup confirm reject so densify can re-getdata.
Full notes: CHANGELOG.md ## [0.6.1].
rbitcoin v0.6.0
rbitcoin v0.6.0
Linux musl x86_64 is the operator binary (statically linked).
Windows is CRT-static PE (no IoRing). Darwin aarch64 is ad-hoc
codesigned, not notarized (xattr -d com.apple.quarantine).
Highlights
- Schema 20: sealed
tx.headis packed BDZ2; sealed SH is BDZ3. Occupied
schema 18/19tx.headorscripthash*is refused (wipe those index dirs,
keep Class A). Empty 18/19 indexes rewritemetato 20. - RPC decode on the node:
decoderawtransaction,decodescript, and
validateaddress. Verbosegetrawtransaction/getblockv2 vin include
scriptSig;scriptPubKeyincludes Core-styletype.
getnetworkinfo.versionis600. - P2P / IBD: Core asmap outbound diversity (
--asmap/
{datadir}/ip_asn.dat;getpeerinfo.mapped_as); learned book 4096 with
last-resort eviction; handshake-then-die is a failed connect; IBD follows
most-work (not max advertised height); unanswered getdata retried after
10s; compact HB announce before tip-accept; IBD getdata serve reconstructs
from Class A spans. - Tip-follow does not stall the reactor: mempool accept is
spawn_blocking; session never parks on mempoolinner; FeeFilter overlay
is atomic; tip connect runs on a dedicatedtip-acceptOS thread. --shindexafter IBD: unsorted-shard materialize is the default (nCPU
collect, in-place unique-sort, sealed heads kept on SIGINT). Pack workers
auto-tune to free RAM.- Core functional / fuzz: 71 unmodified v31.1 scripts
run(14 at 0.5.0).
Nightly differential fuzz vs Core v31.1 is continuous (Q-30: block / spend /
fork / compact / script / BIP324).
Full notes: CHANGELOG.md ## [0.6.0].
rbitcoin v0.5.2
rbitcoin v0.5.2
Linux musl x86_64 is the operator binary (statically linked).
Windows is CRT-static PE (no IoRing). Darwin aarch64 is ad-hoc
codesigned, not notarized (xattr -d com.apple.quarantine).
Schema is still 0.x (refuse/wipe on incompatible open). Default
mainnet --milestone 840000 skips historical scripts.
rbitcoin v0.5.1
rbitcoin v0.5.1
Linux musl x86_64 is the operator binary (statically linked).
Windows is CRT-static PE (no IoRing). Darwin aarch64 is ad-hoc
codesigned, not notarized (xattr -d com.apple.quarantine).
Schema is still 0.x (refuse/wipe on incompatible open). Default
mainnet --milestone 840000 skips historical scripts.
rbitcoin v0.5.0
rbitcoin v0.5.0
Linux musl x86_64 is the operator binary (statically linked).
Windows is CRT-static PE (no IoRing). Darwin aarch64 is ad-hoc
codesigned, not notarized (xattr -d com.apple.quarantine).
Schema is still 0.x (refuse/wipe on incompatible open). Default
mainnet --milestone 840000 skips historical scripts.