BB
← All projectsBitBox

BitBox02 firmware

Firmware and bootloader for BitBox02 signing devices.

BitcoinHardware walletsNormal
Repository coverage

938 commits in the local evidence base

Every captured commit receives deterministic security triage and a separate communication-quality score. Security candidates and broader second-pass signals receive full-patch Ollama analysis.

314security candidates186second-pass queue827AI analyses
88commits · 30 days
150commits · 60 days
340commits · 180 days
723commits · 365 days
Backfill bands
Aug 5 → Feb 6335 seen28 candidatesComplete
Feb 6 → Jun 6265 seen19 candidatesComplete
Jun 6 → Jul 619 seen5 candidatesComplete
Jul 6 → Aug 526 seen3 candidatesComplete
Commit communication

Does the history explain itself?

Message quality measures whether a commit identifies its scope, purpose, rationale, testing, and supporting references. It does not change the security-severity score.

59/100 average clarity
86Strong · 80–100
381Adequate · 60–79
381Thin · 40–59
90Opaque · 0–39
27security candidates with opaque commit messaging
Read the scoring rubric →
Developer activity

Who is changing the project?

Public Git author strings; identities are not independently verified.

DeveloperCommitsCandidatesAnalyzedHigh riskMessage avg.
Marko Bencun504157459656
benma's agent15566140267
Niklas Dusenlund17151144057
Cedric Wiese24919051
NickeZ Agent1669077
cedwies12512063
Sebastian Sutter655060
Tomas Vrba12410068
Yasser Aziza333070
Jad14210060
benma312069
Niklas211054
Analysis record

Published AI watches

Last scanned 9 minutes ago

Informational 12 AI analysisMessage 50 · Thin
BB BitBoxBitBox02 firmware BitcoinHardware wallets

Merge remote-tracking branch 'agent/benma-agent/remove-aes-hmac-c-exports'

This commit removes unused C-language export functions for AES encryption/HMAC from the BitBox02 firmware's Rust code. It is a cleanup change: the functions are deleted, the crate is no longer included in firmware builds, and simulators st…

Reduction of C FFI attack surface by removing no_mangle AES/HMAC exportsDependency cleanup: bitbox-aes no longer linked into firmware or simulatorsNo patch of an identified vulnerability in cryptographic logic
0b6365c6by Marko Bencun+2−5913 files
No security note in commit
Low 43 AI analysisMessage 50 · Thin
BB BitBoxBitBox02 firmware BitcoinHardware wallets

Merge remote-tracking branch 'agent/benma-agent/btc-root-xpub-m49'

This firmware update makes two changes to how the BitBox02 hardware wallet handles Bitcoin-related requests. First, it blocks apps from exporting the wallet's master public key (the 'root xpub') at the top-level path 'm/'. Second, it allow…

Root xpub export blocked at empty keypath (m/)Changelog describes root-xpub restriction as a security-relevant changeExternal service message signing expanded to m/49 unhardened purpose
5294645cby Marko Bencun+79−195 files
Vendor flagged security relevance
Informational 17 AI analysisMessage 78 · Adequate
BB BitBoxBitBox02 firmware BitcoinHardware wallets

cipher: remove unused AES-HMAC C exports

This commit removes two unused C-language bridge functions that wrapped an AES-HMAC encryption/decryption module. The functions themselves were not called from C code; the firmware now calls the same encryption logic directly from Rust. Re…

Removal of C FFI wrappers that could panic on malformed inputsCommit message acknowledges potential panic conditions (invalid IV length, undersized output buffer)No functional change to the underlying AES-HMAC implementation
090a263fby benma's agent+2−5913 files
Vendor flagged security relevance
Low 34 AI analysisMessage 85 · Strong
BB BitBoxBitBox02 firmware BitcoinHardware wallets

u2f: bound DER signature component reads

This commit fixes a small but real bug in how U2F signature components are converted to DER format. The old code could strip too many leading zeros and then read past the end of a 32-byte signature piece, potentially producing an invalid o…

Out-of-bounds read at component boundary during DER encodingPotential malformed DER output for all-zero signature componentDefensive hardening in U2F signature handling
dd17bed7by benma's agent+21−43 files
Vendor flagged security relevance
Low 30 AI analysisMessage 78 · Adequate
BB BitBoxBitBox02 firmware BitcoinHardware wallets

btc: allow message signing under m/49

This commit expands the BitBox02 hardware wallet's Bitcoin message-signing feature to also accept key paths starting with the unhardened purpose 'm/49'. Previously only hardened m/45' and m/48' were treated as valid 'external service' keyp…

Relaxation of keypath allowlist for message signingUnhardened purpose m/49 added to external-service signing namespaceUser confirmation prompt still required ('External service key')
1f377f72by benma's agent+63−194 files
No security note in commit
High 72 AI analysisMessage 73 · Adequate
BB BitBoxBitBox02 firmware BitcoinHardware wallets

btc: reject master xpub exports

This commit closes a security gap in the BitBox02 hardware wallet's Bitcoin API. Previously, a host app could ask the device to export the 'master xpub' (the public key at the very top of the wallet, keypath m/). Combined with any leaked p…

Master xpub export preventedPrivate-key derivation risk described in commit messageUnhardened path key compromise scenario
c4524b15by benma's agent+16−02 files
Vendor flagged security relevance
Informational 15 AI analysisMessage 50 · Thin
BB BitBoxBitBox02 firmware BitcoinHardware wallets

Merge branch 'nickez-agent/configure-stage1-embedding'

This commit is a build-system refactor for the BitBox02 hardware wallet firmware. It replaces a set of separate 'bootloader upgrade' firmware images with a configurable option to embed the same bootloader update data into the normal firmwa…

70a32f5bby Niklas Dusenlund+152−33111 files
No security note in commit
High 70 AI analysisMessage 50 · Thin
BB BitBoxBitBox02 firmware BitcoinHardware wallets

Merge remote-tracking branch 'agent/benma-agent/merge-firmware-v9.29.0'

This firmware update hardens how the BitBox02 handles SwapKit-style cryptocurrency swaps and Bitcoin multisig addresses. It adds a new 'refund memo' to payment requests so the device can verify that any refund address belongs to the same w…

CHANGELOG labels prior changes as 'Bitcoin security fixes (multisig keypath and previous-transaction hash length validation)'CHANGELOG labels v9.29.0 as 'Require wallet-owned refund addresses for SwapKit'New RefundMemo protobuf message with address and optional derivation info
9b16af63by Marko Bencun+867−12411 files
Vendor flagged security relevance
Moderate 60 AI analysisMessage 50 · Thin
BB BitBoxBitBox02 firmware BitcoinHardware wallets

Merge remote-tracking branch 'agent/benma-agent/merge-bootloader-v1.2.3'

This commit hardens the BitBox02 bootloader's stored version-rollback protection data. It adds a SHA-256 checksum over the firmware and signing-key version 'floors' and a one-time migration marker, so the device can detect tampering or cor…

Adds integrity checksum (SHA-256) for anti-rollback version floors in bootloader flash dataIntroduces one-time migration marker to prevent repeated downgrade/migration windowsProduction bootloader now aborts on invalid bootdata instead of silently reinitializing it
a4ddb764by Marko Bencun+2124−3123 files
Vendor flagged security relevance
Informational 15 AI analysisMessage 50 · Thin
BB BitBoxBitBox02 firmware BitcoinHardware wallets

Merge remote-tracking branch 'agent/benma-agent/high-fee-wording-v9.27.2'

This commit only updates test data and test expectations to reflect that a wording change for high Bitcoin transaction fees was released in firmware version 9.27.2 instead of 9.28.0. It does not change any device firmware code, security lo…

00f9eb22by Marko Bencun+65−1123 files
No security note in commit
Informational 15 AI analysisMessage 68 · Adequate
BB BitBoxBitBox02 firmware BitcoinHardware wallets

btc: fix high-fee wording cutoff in vectors

This commit only updates test data and test expectations for the BitBox02 firmware. It changes which firmware versions are expected to show an old versus new high-fee warning message, because the real firmware already started showing the n…

dc5702d0by benma's agent+65−1123 files
No security note in commit
High 77 AI analysisMessage 50 · Thin
BB BitBoxBitBox02 firmware BitcoinHardware wallets

Merge remote-tracking branch 'agent/benma-agent/stage0-reject-zero-signatures'

This update hardens the BitBox02 hardware wallet's bootloader so it refuses to accept a firmware update signed with an all-zero signature. Previously, the cryptographic verification routine could treat a zero-filled signature as valid unde…

Rejects all-zero ECDSA signatures that may verify as validAdds volatile signature read to mitigate LTO-based read eliminationORs all signature bytes without early exit to ensure full-byte inspection
aec4595dby Marko Bencun+81−22 files
No security note in commit
Low 35 AI analysisMessage 50 · Thin
BB BitBoxBitBox02 firmware BitcoinHardware wallets

Merge remote-tracking branch 'agent/benma-agent/stage1-pairing-lifecycle'

This update fixes a Bluetooth pairing bug in the BitBox02 Nova hardware wallet. When the device switched from Bluetooth back to USB mode, it could keep an old pairing request active. The fix clears that stale pairing state so the device do…

Clearing of stale Bluetooth pairing state on mode switchPairing code/request flag left set across BLE->USB transition before fixBluetooth pairing lifecycle change in bootloader startup path
1047430dby Marko Bencun+7−65 files
Vendor flagged security relevance
Low 47 AI analysisMessage 50 · Thin
BB BitBoxBitBox02 firmware BitcoinHardware wallets

Merge remote-tracking branch 'agent/benma-agent/silent-payment-constant-time-ecdh'

This commit changes how the BitBox02 hardware wallet computes a secret value used in Bitcoin silent payments. Previously, the device used a function that could leak timing information about the secret key through how long the calculation t…

Constant-time cryptographic operation addedVariable-time secret-key multiplication removedSide-channel hardening for silent payments
c1590222by Marko Bencun+21−122 files
No security note in commit
Moderate 59 AI analysisMessage 68 · Adequate
BB BitBoxBitBox02 firmware BitcoinHardware wallets

btc: use constant-time ECDH for silent payments

This commit hardens the BitBox02 hardware wallet's silent-payments feature against a side-channel attack. Previously, the device multiplied a secret key with a public key using a routine whose execution time could leak information about th…

Constant-time cryptographic operation introduced to replace variable-time secret-key multiplicationVariable-time scalar multiplication retained only on public operandsSilent payments private input key material (a_sum) no longer used in variable-time path
7e741cfdby benma's agent+21−122 files
Vendor flagged security relevance
Informational 15 AI analysisMessage 50 · Thin
BB BitBoxBitBox02 firmware BitcoinHardware wallets

Merge branch 'nickez-agent/pin-protobuf-generators'

This commit is a build-system and developer-environment change. It pins the protobuf compiler and related Python tools to specific versions via a project-managed Python virtual environment, instead of relying on whatever version a develope…

Pinning build tools to exact versions reduces non-determinism in generated codeMoves protobuf compiler from system/Docker-installed binary to a version-locked Python wheelNo changes to firmware, cryptography, authentication, or device protocol logic
d072b0f9by Niklas Dusenlund+107−6411 files
No security note in commit
Informational 15 AI analysisMessage 92 · Strong
BB BitBoxBitBox02 firmware BitcoinHardware wallets

build: prefer local protoc for Rust bindings

This commit changes the build script that generates Rust code from protobuf definitions. It makes the build prefer a specific local copy of the protobuf compiler (protoc) installed in the repository's virtual environment, rather than relyi…

de8be632by NickeZ Agent+4−01 file
No security note in commit
Informational 15 AI analysisMessage 80 · Strong
BB BitBoxBitBox02 firmware BitcoinHardware wallets

build: use IPv4 for container downloads

This change forces the build system to use IPv4 instead of IPv6 when downloading tools and software packages during Docker image creation. It is a build reliability fix for GitHub Actions CI runners that lack IPv6 connectivity, not a secur…

bc434dcfby NickeZ Agent+6−41 file
No security note in commit
Informational 15 AI analysisMessage 80 · Strong
BB BitBoxBitBox02 firmware BitcoinHardware wallets

build: check regenerated protobuf bindings

This change improves a build/CI script that checks whether automatically generated protobuf binding files are up to date. It now also checks Python bindings and deletes old generated files before regenerating them, so stale files cannot hi…

No security-relevant code changeBuild/CI hardening onlyNo vulnerability fix or exploit mitigation present in diff
ff3f7474by NickeZ Agent+13−22 files
No security note in commit
Informational 15 AI analysisMessage 45 · Thin
BB BitBoxBitBox02 firmware BitcoinHardware wallets

Merge branch 'translate-passphrase-on-host'

This commit is a localization (translation) update for the BitBox02 hardware wallet. It replaces hard-coded English text strings in the passphrase unlock feature with calls to the device's internationalization system, so the same messages …

4dfa26b4by Marko Bencun+33−103 files
No security note in commit
Repository ledger

Explore captured commits

Expand any commit for its author, full message, clarity score, changed files, triage signals, analysis, and source link.

Security candidateFirmware v9.27.1 verification (yaziza)by Yasser Aziza · 6d2e6955 · Sep 23, 2026 · 2 filesMessage 70 · AdequateInformational 15Details
Commit message · Yasser Aziza

Firmware v9.27.1 verification (yaziza)

Signed-off-by: Yasser Aziza <yasser@posteo.net>

70/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides an explanatory body✓ Mentions testing or verification
Why it was queued
defensive validationboot or update path
AI analysis · Informational 15/100

This commit adds two digital signature files for BitBox02 firmware version 9.27.1. These signatures are a third-party reproducible-build verification (called an 'assertion') created by an independent contributor named yaziza. The commit does not change any firmware code, configuration, or executable behavior. It is purely a release-artifact addition.

Security candidatebuild: unify product and probe commandsby Niklas Dusenlund · ee0a1e41 · Sep 22, 2026 · 28 filesMessage 90 · StrongInformational 17Details
Commit message · Niklas Dusenlund

build: unify product and probe commands

The growing set of products, editions and boards requires more Make
targets and separate flashing/debugging scripts for each combination.
Selecting the device once lets developers use the same image commands
across BitBox02, Nova and BitBox03 and reduces duplicated workflows.

Add make config to save product, board, edition, debug setting, probe
software and SWD speed in a local, ignored config.mk. The primary build
commands are firmware, factorysetup, bootloader-stage0 and
bootloader-stage1. The stage targets build the selected development image;
explicit production/development aggregates remain available.

Primary builds and matching flash/run commands follow the saved DEBUG
setting, which can also be overridden per command. DEBUG=no selects
RelWithDebInfo for BitBox02/Nova and release for BitBox03; DEBUG=yes
selects debug builds. Without configuration, firmware keeps the existing
BitBox02 multi RelWithDebInfo default. Replace profile-specific Make
aliases with this shared setting.

Store builds in flat product directories, with CMake profiles in their
names, so switching products keeps previous artifacts and backend caches
available. Changing probe settings does not trigger recompilation.
Update CI and artifact consumers to follow the new commands and paths,
retaining debug build coverage and distinct artifact names.

Add matching flash-<image> and run-<image> commands using the saved probe
settings, with hardware derived from the board. J-Link probes support
SEGGER software or OpenOCD; the ST-Link dev-kit uses OpenOCD. Start
debug-server separately, then run-<image> loads and verifies the built
ELF, initializes its entry state and continues with GDB attached.
BitBox02 stage1 uses finalized contents when flashing or debugging, and
BitBox03 factorysetup runs from RAM without a reset after loading.

BitBox03 defaults to OpenOCD. Its testboard currently shares the dev-kit
build, both editions build the same stub, and the production board remains
disabled.

Validation: Python formatting, 48 configured build/probe routing cases,
removed aliases, retained stage aggregates and CI matrix/artifact names.
Hardware probe workflows remain unverified.

90/100 · StrongMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Provides detailed explanatory context✓ Mentions testing or verification
Why it was queued
update trustboot or update path
AI analysis · Informational 17/100

This commit is a developer-facing build-system refactor. It replaces many hard-coded Make targets with a single saved configuration (product, board, edition, debug mode, probe tool) and adds Python helper scripts to build, flash, and debug firmware across BitBox02, Nova, and the upcoming BitBox03. There is no direct change to wallet cryptography, secure-boot checks, or firmware runtime behavior. The main security-relevant concern is that the new scripts handle flashing and GDB startup commands, so any bugs there could affect how firmware is loaded onto devices during development or factory setup.

Security candidateFirmware v9.25.0 verificationby Yasser Aziza · b454a627 · Sep 22, 2026 · 2 filesMessage 70 · AdequateInformational 15Details
Commit message · Yasser Aziza

Firmware v9.25.0 verification

Signed-off-by: Yasser Aziza <yasser@posteo.net>

70/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides an explanatory body✓ Mentions testing or verification
Why it was queued
defensive validationboot or update path
AI analysis · Informational 15/100

This commit adds two digital signature files to the repository. They are third-party reproducible-build attestations (assertions) for the already-released BitBox02 firmware version 9.25.0. The commit does not change any firmware source code, build scripts, or device behavior. It is a routine release-verification step and does not introduce or fix any security vulnerability.

Security candidatehww: support host passphrase entryby benma's agent · 853a27c0 · Sep 19, 2026 · 36 filesMessage 68 · AdequateLow 41Details
Commit message · benma's agent

hww: support host passphrase entry

Allow host entry when the optional BIP39 passphrase is enabled, keeping device entry as the
default. Requesting host entry requires device approval, then the user confirms the submitted
value on the device before unlocking, including an empty passphrase. Rejection, cancellation or
invalid input restarts device entry.

Run the new unlock flow inside the paired Noise channel to protect host input, retaining legacy
unlock for older clients. Poll progress within the existing request/response model and use the
existing reconnect reset to discard abandoned workflows.

Limit host passphrases to the device keyboard's character set and length so users can still
access the same wallet through device entry. Withdraw the host-entry option before consent or
passphrase confirmation starts, and relock after interrupted unlocks. Repeated unlock calls
leave an already unlocked wallet unchanged.

Expose Python callbacks for host input and optional entry controls, with polling handled by the
library. Support both a host-entry button and requesting host entry automatically. Extend
send_message.py to demonstrate host entry, cancellation and withdrawal of the host-entry option.

68/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
Why it was queued
secret or key materialaccess controlcryptography-sensitive pathparser or protocol path
AI analysis · Low 41/100

This commit adds a new feature to the BitBox02 hardware wallet that lets users type their optional BIP39 passphrase on the connected computer (host) instead of only on the device. The passphrase is still sent inside the existing encrypted Noise channel, and the device still asks the user to approve and confirm the value before unlocking the wallet. The change is designed to make passphrase entry easier while keeping the device as the final gatekeeper. It is a feature addition, not a fix for a known vulnerability, and the commit message and code include several safeguards against misuse.

Security candidateMerge remote-tracking branch 'agent/benma-agent/hww-start-session'by Marko Bencun · 04302490 · Sep 17, 2026 · 13 filesMessage 50 · ThinLow 34Details
Commit message · Marko Bencun

Merge remote-tracking branch 'agent/benma-agent/hww-start-session'

50/100 · ThinMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
Why it was queued
boot or update pathparser or protocol pathmerge-commit duplicate discount
AI analysis · Low 34/100

This commit adds a new 'session reset' command to the BitBox02 hardware wallet's USB protocol. It lets the host computer cleanly reset the device connection if a previous operation was interrupted, instead of leaving the device stuck mid-task. The change also fixes a minor timeout-handling issue for the existing INFO command so that merely checking the firmware version no longer keeps an abandoned operation alive. The commit is framed as a robustness improvement, not a security fix, and there is no disclosed vulnerability.

AI review queuedpy: make session reset an API setup helperby benma's agent · 50a9e76a · Sep 17, 2026 · 3 filesMessage 78 · AdequateInformational 15Details
Commit message · benma's agent

py: make session reset an API setup helper

Move reset_session out of BitBoxProtocol into the private BitBoxCommonAPI._reset_session helper
alongside get_info. Keep the firmware version gate inside the helper so initialization skips
the request on firmware older than v9.28.0.

Update the session tests and document host reconnect support under Firmware / Unreleased.

78/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Mentions testing or verification
Why it was queued
parser or protocol pathsecond-pass: security-sensitive path
AI analysis · Informational 15/100

This is a routine Python code refactor. It moves an existing 'reset session' command from one internal class to another and adds a version check so older firmware simply skips it. There is no security bug being fixed here; it is purely organizational cleanup and test updates.

Security candidatehww: reset sessions on host reconnectby benma's agent · 6679936f · Sep 17, 2026 · 12 filesMessage 78 · AdequateModerate 62Details
Commit message · benma's agent

hww: reset sessions on host reconnect

When a host disconnects after receiving an intermediate response, a workflow can remain in
next_request().await while the device stays powered. The HWW lock has already been released, so
the USB timeout does not cancel it. On reconnect, the Python client's attestation request is
consumed as the old workflow's continuation and receives an error encrypted with the old Noise
session instead of an attestation response.

Add a top-level REQ_RESET that cancels the pending task, discards queued HWW responses, resets
Noise and restores the UI before acknowledging the new session. Drop task-owned UI components
before resetting the screen stack, and refuse reset while a U2F workflow owns the shared UI.
Allow REQ_INFO through the HWW busy gate without refreshing the operation timeout, so the host
can discover the firmware version before deciding whether to reset.

Bump the firmware to v9.28.0 and have the Python client issue REQ_RESET before attestation,
unlock and Noise setup only on v9.28.0 or newer. Add regression tests for abandoned
continuations, pending responses, U2F arbitration, INFO timeout behavior and client
compatibility. The powered-device reconnect flow still needs hardware validation.

78/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Mentions testing or verification
Why it was queued
update trustfuzzing or regression evidenceboot or update pathparser or protocol path
AI analysis · Moderate 62/100

This commit fixes a bug in the BitBox02 hardware wallet where unplugging the USB cable at the wrong moment could leave a half-finished operation running. If the device stayed powered and a new host reconnected, the new host's first message could be misinterpreted as a continuation of the old operation, producing a confusing encrypted error instead of a proper response. The fix adds a new 'reset session' command that the companion app sends at the start of every connection on firmware 9.28.0 and newer, which cancels any leftover task, clears queued responses, resets the encrypted Noise channel, and restores the user interface. The change also lets the host ask for the firmware version without extending an abandoned operation's timeout, so it can safely decide whether to reset.

AI review queuedMerge commit 'refs/pull/2073/head' of https://github.com/BitBoxSwiss/bitbox02-firmwareby Marko Bencun · 6b04e006 · Sep 16, 2026 · 21 filesMessage 58 · ThinInformational 17Details
Commit message · Marko Bencun

Merge commit 'refs/pull/2073/head' of https://github.com/BitBoxSwiss/bitbox02-firmware

58/100 · ThinMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Links an issue, advisory, or supporting reference! No meaningful explanatory body
Why it was queued
merge-commit duplicate discountsecond-pass: unusually broad change
AI analysis · Informational 17/100

This commit adds a new recovery-word entry screen for the upcoming BitBox03 hardware wallet. It is a large feature patch: it introduces a dedicated BIP39 wordlist keyboard, a new recovery-words review screen, and changes how the device handles going back versus cancelling during seed restoration. There is no direct evidence in the commit that this fixes a security vulnerability; it reads as a user-experience and hardware-support change. The code does improve clarity around cancel/back handling and adds confirmation prompts before aborting a restore, which is a sensible defensive design, but it is not presented by the vendor as a security fix.

AI review queuedMerge remote-tracking branch 'agent/benma-agent/show-erc20-contract'by Marko Bencun · 410df562 · Sep 15, 2026 · 3 filesMessage 50 · ThinLow 47Details
Commit message · Marko Bencun

Merge remote-tracking branch 'agent/benma-agent/show-erc20-contract'

50/100 · ThinMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
Why it was queued
signing or wallet pathmerge-commit duplicate discountsecond-pass: security-sensitive path
AI analysis · Low 47/100

This commit improves the BitBox02 hardware wallet's Ethereum token-approval screen. When a user signs an ERC20 token transfer, the device now also shows the token's smart-contract address if the token symbol is ambiguous (the same ticker, like 'UNI', is used by multiple contracts) or if the token is completely unknown. This helps prevent 'look-alike' token scams where a malicious contract uses a familiar symbol but is actually a worthless or harmful token. The change also blocks payment requests for unknown tokens. It is a defensive hardening patch, not an exploit fix for already-broken code.

Security candidateMerge remote-tracking branch 'agent/benma-agent/bootloader-descriptor-compat'by Marko Bencun · 6dccfd24 · Sep 10, 2026 · 2 filesMessage 50 · ThinLow 26Details
Commit message · Marko Bencun

Merge remote-tracking branch 'agent/benma-agent/bootloader-descriptor-compat'

50/100 · ThinMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
Why it was queued
update trustboot or update pathmerge-commit duplicate discount
AI analysis · Low 26/100

This commit relaxes a version check in the BitBox02 bootloader upgrade code. Previously, the firmware installer required that a stage0 bootloader descriptor's version exactly matched the currently expected image version. Now it accepts descriptors whose version differs, as long as the magic number and product ID still match. The change is framed as improving compatibility across bootloader descriptor layouts, not as fixing a security bug. The accompanying tests verify that both older and newer stage0 versions are accepted.

AI review queuedMerge branch 'nickez/bb02-utf8-safe'by Niklas Dusenlund · 0bbdf6f0 · Sep 9, 2026 · 25 filesMessage 45 · ThinModerate 53Details
Commit message · Niklas Dusenlund

Merge branch 'nickez/bb02-utf8-safe'

45/100 · ThinMessage clarity
✓ Descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
Why it was queued
merge-commit duplicate discountsecond-pass: unusually broad change
AI analysis · Moderate 53/100

This commit hardens the BitBox02 firmware so it stops trusting that incoming text strings are valid UTF-8 or plain ASCII. It replaces risky C string copies with length-checked, UTF-8-aware helpers, rejects non-ASCII characters at UI boundaries, and prevents malformed multi-byte characters from being cut in half when labels or device names are truncated. The changes reduce the chance that an attacker could crash the device or hide parts of a message by sending carefully crafted strings.

AI review queuedMerge branch 'benma/ub'by Marko Bencun · 8a6fd97b · Sep 9, 2026 · 2 filesMessage 28 · OpaqueLow 41Details
Commit message · Marko Bencun

Merge branch 'benma/ub'

28/100 · OpaqueMessage clarity
✓ Subject identifies a change! No meaningful explanatory body
Why it was queued
merge-commit duplicate discountsecond-pass: opaque commit message
AI analysis · Low 41/100

This commit fixes a coding guideline violation in the BitBox02 factory setup code. A 32-byte buffer that receives output from a Rust function was not initialized to zeroes before use. The accompanying documentation now explicitly requires such initialization. The actual security impact is limited because the buffer is immediately filled by a hash function if it succeeds, and failure paths in this specific factory-setup function appear to abort rather than leak the uninitialized buffer. However, uninitialized stack memory is a well-known source of bugs, so the change is defensive.

Security candidateoled: hold display in reset during startupby Niklas Dusenlund · cdb27835 · Sep 8, 2026 · 1 fileMessage 68 · AdequateLow 35Details
Commit message · Niklas Dusenlund

oled: hold display in reset during startup

Production stage0 verifies stage1 before initializing the OLED. Leaving
the reset pin high can allow previous display content to remain visible
at reduced brightness while the boost converter is disabled.

Set the reset output latch low before enabling the pin as an output.
Keep the OLED in reset until oled_init() releases it and uploads a
cleared framebuffer.

68/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context
Why it was queued
access control
AI analysis · Low 35/100

This commit fixes a display behavior issue during startup of the BitBox02 hardware wallet. Previously, when the device turned on, the screen's reset pin was left in a state that could allow leftover images or text from an earlier session to briefly appear at low brightness before the device finished booting. The change ensures the screen is kept fully blank (held in reset) until the firmware is ready to draw a clean screen. This is a defensive fix to prevent a user from seeing stale or misleading information during boot.

Security candidateMerge remote-tracking branch 'agent/benma-agent/factorysetup-trim-unused'by Marko Bencun · 554a0558 · Sep 8, 2026 · 7 filesMessage 50 · ThinInformational 18Details
Commit message · Marko Bencun

Merge remote-tracking branch 'agent/benma-agent/factorysetup-trim-unused'

50/100 · ThinMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
Why it was queued
cryptography-sensitive pathmerge-commit duplicate discount
AI analysis · Informational 18/100

This commit trims the BitBox02 factory-setup firmware image by switching stored root attestation public keys from 65-byte uncompressed to 33-byte compressed secp256k1 keys, and by using a smaller static secp256k1 verification context instead of a full signing context. It also adds a self-test and a helper that computes the key identifier from the uncompressed form so existing host tooling keeps working. The changes are framed as a size-reduction/cleanup patch; there is no direct evidence in the commit of a security vulnerability being fixed.

Security candidateMerge remote-tracking branch 'agent/benma-agent/validate-py-antiklepto-signatures'by Marko Bencun · 0d1a7997 · Sep 7, 2026 · 5 filesMessage 50 · ThinLow 37Details
Commit message · Marko Bencun

Merge remote-tracking branch 'agent/benma-agent/validate-py-antiklepto-signatures'

50/100 · ThinMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
Why it was queued
signing boundarydefensive validationcryptography-sensitive pathmerge-commit duplicate discount
AI analysis · Low 37/100

This commit adds extra safety checks in the BitBox02 Python library for ECDSA signatures used in Bitcoin and Ethereum signing. It now validates that signatures have the correct length, use valid numbers, and use the safer low-S form. It also validates the recovery ID for recoverable signatures. These are defensive hardening changes rather than a fix for a known active exploit, but they close a gap where a malicious or buggy device could return malformed or malleable signatures that the host software would previously accept.

AI review queuedMerge remote-tracking branch 'agent/benma-agent/scroll-payment-request-memo-name'by Marko Bencun · be375664 · Sep 5, 2026 · 6 filesMessage 50 · ThinInformational 19Details
Commit message · Marko Bencun

Merge remote-tracking branch 'agent/benma-agent/scroll-payment-request-memo-name'

50/100 · ThinMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
Why it was queued
signing or wallet pathmerge-commit duplicate discountsecond-pass: security-sensitive path
AI analysis · Informational 19/100

This commit tweaks how the BitBox02 hardware wallet displays a payment-request memo on screen. It changes the label from 'Memo from\n\nMerchant' to 'Memo from: Merchant' and makes the screen scrollable so long merchant names don't get cut off. It also updates test snapshots and bumps the firmware version to 9.27.2. There is no indication this fixes a security vulnerability; it appears to be a user-interface improvement.

Security candidatefactorysetup: compress constant root keysby benma's agent · e2273c1f · Sep 4, 2026 · 2 filesMessage 91 · StrongInformational 19Details
Commit message · benma's agent

factorysetup: compress constant root keys

Store the 110 root attestation public keys as const compressed SEC1
points instead of writable uncompressed points. Keep every key and its
index unchanged, and document conversion using Python's ecdsa module.

Derive root identifiers from the uncompressed encoding so the host's
identifiers and the single-signature verification added in #2081 are
preserved.

The factory-setup image shrinks from 155,088 to 152,472 bytes, saving
2,616 bytes. RAM usage drops from 203,304 to 196,152 bytes, saving
7,152 bytes by keeping the table out of writable memory.

Together with the earlier changes in this PR, the image shrinks from
195,296 to 152,472 bytes (-42,824, 21.9%), and RAM usage drops from
203,304 to 196,152 bytes (-7,152, 3.5%). These figures exclude the
peripheral and font changes split into #2092.

91/100 · StrongMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Mentions testing or verification✓ Links an issue, advisory, or supporting reference✓ Names security-relevant behavior explicitly
Why it was queued
signing boundaryupdate trustdefensive validationcryptography-sensitive path
AI analysis · Informational 19/100

This commit is a hardening and size-optimization change for the BitBox02 factory-setup firmware. It stores the 110 built-in root attestation public keys in compressed (33-byte) form instead of uncompressed (65-byte) form, and marks the table as read-only (`const`). This shrinks the firmware image by about 2.6 KB and reduces RAM use by about 7 KB. A new helper is added so the device can still compute the same public-key identifiers used by host software, and the existing signature verification behavior is preserved. There is no direct vulnerability being fixed; the main security benefit is making the key table tamper-resistant in RAM because it now lives in read-only memory.

Security candidatefactorysetup: reuse SHA-256 for HMACby benma's agent · a790a7f0 · Sep 4, 2026 · 5 filesMessage 78 · AdequateInformational 18Details
Commit message · benma's agent

factorysetup: reuse SHA-256 for HMAC

Use RustCrypto Hmac<Sha256> for the shared HMAC-SHA256 helper so factory
setup reuses the SHA-256 backend already linked for plain hashing.

This reduces the factory-setup image from 159,568 to 155,088 bytes,
saving 4,480 bytes. RAM usage remains 203,304 bytes.

Normal firmware still needs bitcoin_hashes for other callers. Multi
grows from 686,080 to 686,356 bytes (+276), and Bitcoin-only grows from
525,392 to 525,656 bytes (+264).

Add known-answer coverage for empty keys and keys longer than the
SHA-256 block size.

78/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Mentions testing or verification
Why it was queued
cryptography-sensitive path
AI analysis · Informational 18/100

This commit swaps one internal cryptography library for another when computing HMAC-SHA256 in the factory-setup code. The goal is to reduce firmware size by reusing an existing SHA-256 implementation, not to fix a security bug. New test vectors were added to confirm the new implementation still produces the correct answers.

Security candidatefactorysetup: use static secp contextby benma's agent · 2756aca4 · Sep 4, 2026 · 2 filesMessage 78 · AdequateInformational 21Details
Commit message · benma's agent

factorysetup: use static secp context

ECDSA verification can use libsecp256k1’s built-in static context.

A dynamically created context links signing support and its
precomputation table, even when Rust requests a verification-only
context.

The previous context initialization reached
secp256k1_context_preallocated_create(), which runs
secp256k1_selftest() automatically. The static context skips
initialization, so run the self-test explicitly once during factory
setup startup, as recommended by libsecp256k1.

This reduces the factory-setup image by 35,728 bytes.

78/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Mentions testing or verification
Why it was queued
signing boundarydefensive validationcryptography-sensitive path
AI analysis · Informational 21/100

This commit changes how the BitBox02 factory-setup program checks digital signatures. It switches from a dynamically created crypto context to a built-in, read-only verification context, which makes the factory-setup firmware about 35 KB smaller. The commit also adds an explicit self-test because the new static context skips the automatic self-test that the old path performed. The change is a size optimization, not a fix for an active security flaw, but it touches cryptographic verification code used during device manufacturing.

Security candidatefactorysetup: speed up certificate setupby benma's agent · d5617112 · Sep 3, 2026 · 1 fileMessage 73 · AdequateInformational 18Details
Commit message · benma's agent

factorysetup: speed up certificate setup

Select the attestation root key by its identifier before verifying the
certificate signature. This decreases the time to set the certificate to
less than 0.1 seconds. Previously it took up to roughly 2.4 seconds for a
root key near the bottom of the list.

73/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Provides detailed explanatory context✓ Names security-relevant behavior explicitly
Why it was queued
signing boundaryupdate trust
AI analysis · Informational 18/100

This commit is a performance optimization in the BitBox02 factory setup process. It changes how the device picks which trusted root public key to use when verifying an attestation certificate. Previously, the device tried verifying the signature against every known root key until one worked, which could take up to about 2.4 seconds. Now it first looks up the correct root key using a short identifier (a hash of the public key) and then verifies the signature only once, taking less than 0.1 seconds. The security properties remain the same: the signature is still checked, just faster.

Security candidateMerge branch 'nickez/bb03-binaries'by Niklas Dusenlund · 1a648595 · Sep 3, 2026 · 170 filesMessage 45 · ThinInformational 15Details
Commit message · Niklas Dusenlund

Merge branch 'nickez/bb03-binaries'

45/100 · ThinMessage clarity
✓ Descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
Why it was queued
cryptography-sensitive pathboot or update pathmerge-commit duplicate discount
AI analysis · Informational 15/100

This commit is a large feature merge that adds initial support for a new hardware variant, the BitBox03 (STM32U5-based development kit). It introduces new bootloader and firmware binaries, board support crates, vendored Rust dependencies (once_cell, portable-atomic, rtt-target), build scripts, and CI targets. There is no indication in the commit message or diff that this is a security fix or that it addresses any vulnerability. It appears to be routine product/platform enablement work.

AI review queuedMerge commit 'refs/pull/1976/head' of https://github.com/BitBoxSwiss/bitbox02-firmwareby Marko Bencun · 386d86f5 · Sep 1, 2026 · 4 filesMessage 58 · ThinInformational 15Details
Commit message · Marko Bencun

Merge commit 'refs/pull/1976/head' of https://github.com/BitBoxSwiss/bitbox02-firmware

58/100 · ThinMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Links an issue, advisory, or supporting reference! No meaningful explanatory body
Why it was queued
signing or wallet pathmerge-commit duplicate discountsecond-pass: security-sensitive path
AI analysis · Informational 15/100

This commit adds a progress bar that appears while the BitBox02 is loading large Ethereum transaction data from a connected computer. It is a user-experience improvement, not a security fix. The code only changes how progress is displayed during normal data streaming and adds tests to verify the progress bar shows the right percentages.

AI review queuedAdd testboard openocd configby Niklas Dusenlund · c5984b41 · Sep 1, 2026 · 1 fileMessage 35 · OpaqueInformational 15Details
Commit message · Niklas Dusenlund

Add testboard openocd config

35/100 · OpaqueMessage clarity
✓ Descriptive subject! No meaningful explanatory body
Why it was queued
second-pass: opaque commit message
AI analysis · Informational 15/100

This commit adds a configuration file for OpenOCD, a debugging tool used during hardware development and testing. It tells the debugger how to connect to an STM32U5 test board using a J-Link adapter. There is no change to firmware code, no user-facing feature, and no security-relevant behavior.

AI review queuedMerge branch 'py-proto'by Marko Bencun · 926a5885 · Aug 31, 2026 · 2 filesMessage 28 · OpaqueInformational 19Details
Commit message · Marko Bencun

Merge branch 'py-proto'

28/100 · OpaqueMessage clarity
✓ Subject identifies a change! No meaningful explanatory body
Why it was queued
merge-commit duplicate discountsecond-pass: opaque commit message
AI analysis · Informational 19/100

This commit only adds explanatory comments to Python type-stub files describing what happens when an optional anti-klepto host nonce commitment is left out. It does not change any firmware logic, cryptographic code, or default behavior. The comments document an already-existing fallback mode, making the behavior more transparent rather than introducing a new vulnerability.

Security candidateMerge branch 'assert-v9.27.1'by Marko Bencun · 37c1fde0 · Aug 31, 2026 · 4 filesMessage 45 · ThinInformational 15Details
Commit message · Marko Bencun

Merge branch 'assert-v9.27.1'

45/100 · ThinMessage clarity
✓ Descriptive subject✓ Names a concrete action or component! No meaningful explanatory body
Why it was queued
boot or update pathmerge-commit duplicate discount
AI analysis · Informational 15/100

This commit adds signed release assertions for the BitBox02 firmware version 9.27.1. It contains only text files and detached signatures that record the expected SHA-256 hash of the official firmware binaries. There is no code change, no bug fix, and no security patch.