KX
← All projectsKrux

Krux

Open-source signing firmware for Kendryte K210 devices.

BitcoinHardware walletsNormal
Repository coverage

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

61security candidates45second-pass queue223AI analyses
2commits · 30 days
4commits · 60 days
101commits · 180 days
169commits · 365 days
Backfill bands
Aug 5 → Feb 6116 seen6 candidatesComplete
Feb 6 → Jun 639 seen3 candidatesComplete
Jun 6 → Jul 622 seen1 candidatesComplete
Jul 6 → Aug 538 seen5 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.

65/100 average clarity
64Strong · 80–100
76Adequate · 60–79
96Thin · 40–59
16Opaque · 0–39
6security 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.
Odudex291429272
odudex923090159
Tads361036063
qlrd20216083
Jean Do1928067
kdmukai424066
tadeubas414038
Naman0151707059
kkdao12012083
bitcoisas505066
joaozinhom402067
Naman Gupta202079
Analysis record

Published AI watches

Last scanned 47 minutes ago

Informational 15 AI analysisMessage 62 · Adequate
KX KruxKrux BitcoinHardware wallets

chore: updates MaixPy glyphs (adds: 49, removes: 4)

This commit only updates a Git submodule pointer for the MaixPy firmware dependency. The actual code changes are stored in the linked submodule repository, not in this commit. There is no visible security-relevant change here.

f963e035by Jean Do+1−11 file
No security note in commit
Informational 4 AI analysisMessage 57 · Thin
KX KruxKrux BitcoinHardware wallets

fix: use latest MaixPy w/ pr_57

This commit only updates a submodule pointer for MaixPy, a firmware dependency. The actual code changes are not visible in this diff because they live in the separate MaixPy repository. Without seeing what changed in MaixPy, we cannot dete…

31754785by Jean Do+1−11 file
No security note in commit
Informational 15 AI analysisMessage 72 · Adequate
KX KruxKrux BitcoinHardware wallets

test: cover Back and failure paths for SD card and QR loading

This commit only adds and updates automated tests. It does not change any production code, so it cannot introduce a security vulnerability or directly fix one in the shipped firmware. The tests verify that pressing 'Back' or cancelling a c…

7a2fcd9eby notTanveer+297−89 files
No security note in commit
Informational 21 AI analysisMessage 62 · Adequate
KX KruxKrux BitcoinHardware wallets

fix: do not report "Failed to load" when the user backs out

This commit is a user-experience fix: it stops the Krux bitcoin hardware-wallet firmware from showing a scary 'Failed to load' error when the user simply presses Back or leaves the camera/SD-card picker. The change also moves SD-card error…

No memory-safety, cryptographic, or authorization changesError-message UX change onlyNo new attack surface introduced
1e9ea474by notTanveer+54−509 files
No security note in commit
Informational 15 AI analysisMessage 57 · Thin
KX KruxKrux BitcoinHardware wallets

fix(i18n): add scan and manual labels

This commit simply adds two missing translated labels, 'manual' and 'scan', to the project's user-interface language files. It is a routine internationalization (i18n) fix with no security relevance.

00e82270by Naman015+46−023 files
No security note in commit
Low 26 AI analysisMessage 100 · Strong
KX KruxKrux BitcoinHardware wallets

docs: TC-code - warn about privacy when filling flash with entropy from camera

This commit does not fix a software bug. It adds documentation warnings and an on-screen reminder telling users to read the docs before using the TC Code tamper-detection feature. The underlying behavior being warned about is that Krux can…

Privacy warning added for unscrambled camera frames stored in flashOn-device prompt added to read documentation before TC Code setupNo cryptographic or storage-behavior change in the diff
1cb1cc0cby odudex+33−225 files
Vendor flagged security relevance
Informational 15 AI analysisMessage 57 · Thin
KX KruxKrux BitcoinHardware wallets

docs: update mnemonic loading flow

This commit only updates user documentation and simulator test scripts to match a reorganized menu for loading a wallet recovery phrase. No actual wallet or security code was changed, so it does not create or fix a security vulnerability.

e264e2f5by Naman015+139−9522 files
No security note in commit
Moderate 66 AI analysisMessage 45 · Thin
KX KruxKrux BitcoinHardware wallets

Merge branch 'release-26.08.0'

This is a routine release merge for Krux firmware (version 26.08.0). It includes several genuine security fixes: a heap buffer overflow in camera-based entropy generation for a discontinued device, stricter fee calculation when signing Bit…

Heap buffer overflow fix in camera entropy module (discontinued Maix Bit only)PSBT fee calculation stricter checks and unverified-input-amount warningStored mnemonic file corruption now preserved instead of overwritten
be5eda28by odudex+4335−3028123 files
Vendor flagged security relevance
Informational 15 AI analysisMessage 40 · Thin
KX KruxKrux BitcoinHardware wallets

docs: update CHANGELOG

This commit only updates three date lines in the CHANGELOG.md file, changing '2025' to '2026' for three release entries. It does not modify any source code, build scripts, or documentation with security implications. The change is purely c…

ec058d86by odudex+3−31 file
No security note in commit
Moderate 66 AI analysisMessage 85 · Strong
KX KruxKrux BitcoinHardware wallets

fix: bind BBQr parts to the first part of the stream

This commit fixes Krux's QR code scanner so that when it reads a series of animated BBQr codes, every later frame must match the encoding and file type announced by the first frame, must agree on the total number of frames, and cannot over…

Input validation added for multi-part BBQr streamsMemory exhaustion mitigation via accumulated payload capAnti-splicing: parts must agree with first part's encoding and file type
0b3e01b7by odudex+86−13 files
No security note in commit
Informational 15 AI analysisMessage 40 · Thin
KX KruxKrux BitcoinHardware wallets

docs: update CHANGELOG

This commit only updates the project's CHANGELOG.md file. It adds text describing several bug fixes and improvements that were apparently made in prior code changes, but no actual code is changed in this commit. By itself, this documentati…

4c05cefbby odudex+9−11 file
No security note in commit
Informational 0 AI analysisMessage 40 · Thin
KX KruxKrux BitcoinHardware wallets

chore(Maixpy): bump cUR

This commit appears to be a routine version bump of a component called 'cUR' inside the MaixPy firmware build. No actual code changes are visible in the provided diff, and the commit message gives no indication of a security fix or vulnera…

74d6ed40by odudex+1−11 file
No security note in commit
Informational 15 AI analysisMessage 57 · Thin
KX KruxKrux BitcoinHardware wallets

chore: bump version to 26.08.0

This commit is a routine version bump from 26.04.0 to 26.08.0. It only updates version strings in documentation, build files, and source metadata. No code behavior changes. The changelog text mentions a previously fixed heap buffer overflo…

Changelog references a prior heap buffer overflow in Shannon entropy module (camera frame copy into fixed 320x240 RGB565 buffer)No actual code or security fix present in this commit
dea991dfby odudex+5−55 files
Vendor flagged security relevance
Informational 2 AI analysisMessage 57 · Thin
KX KruxKrux BitcoinHardware wallets

chore: bump MaixPy with updated glyphs

This commit appears to update a submodule or dependency called MaixPy to a newer version that includes updated visual glyphs (small icons/symbols). The title and message describe it as a routine maintenance chore, not a security fix. No ac…

a9329228by odudex+1−11 file
No security note in commit
Informational 15 AI analysisMessage 85 · Strong
KX KruxKrux BitcoinHardware wallets

fix: register embed_fire in the bdftokff device list

This commit fixes a build-time font-generation script so that a newly supported device ('embed_fire') is recognized. Before the fix, the script printed an error but still produced the same font files. There is no security issue.

f15308e4by odudex+1−01 file
No security note in commit
Moderate 63 AI analysisMessage 57 · Thin
KX KruxKrux BitcoinHardware wallets

docs: add PSBT input amount fixes to CHANGELOG

This commit only updates the project's CHANGELOG.md to document earlier fixes related to PSBT (Partially Signed Bitcoin Transaction) fee and amount handling. It does not contain any code changes itself. The changelog entries describe secur…

Changelog documents prior PSBT fee/amount validation fixesMentions insufficient coordinator data as a security concernNo actual code or test changes in this commit
48920c31by odudex+4−01 file
Vendor flagged security relevance
High 78 AI analysisMessage 95 · Strong
KX KruxKrux BitcoinHardware wallets

fix: verify PSBT input amounts before showing the fee

This commit fixes a security flaw in Krux, a Bitcoin signing device. Before the fix, an attacker could trick the device into showing a low transaction fee on screen while actually signing a much higher fee. The fix makes the device verify …

Fixes fee-display/sighash amount mismatchAdds prevout txid hash verification for non_witness_utxoMandates non_witness_utxo for legacy inputs
fc808059by odudex+353−122 files
Vendor flagged security relevance
Moderate 66 AI analysisMessage 85 · Strong
KX KruxKrux BitcoinHardware wallets

fix: reject a PSBT whose outputs exceed its inputs

This commit fixes a bug in Krux, a Bitcoin signing device, where a malformed transaction whose outputs spend more than its inputs could be loaded and shown to the user. Normally such a transaction is impossible on the Bitcoin network, but …

Input validation gap in PSBT parsingUI rendering bug masking invalid transaction economicsPotential social-engineering / user-confusion attack
d6813d88by odudex+52−02 files
Vendor flagged security relevance
Informational 15 AI analysisMessage 50 · Thin
KX KruxKrux BitcoinHardware wallets

i18n: translate the unverified input amounts warning

This commit only adds translations for two existing warning messages in the Krux Bitcoin hardware wallet software. It does not change any code logic, security behavior, or fix any vulnerability. The messages warn users that displayed fees …

bdaed1a1by odudex+46−023 files
No security note in commit
Moderate 62 AI analysisMessage 90 · Strong
KX KruxKrux BitcoinHardware wallets

feat: warn when PSBT input amounts cannot be verified

This commit adds a warning screen to Krux, a hardware signing device, when it is asked to sign a multi-input Bitcoin transaction where the amounts of some inputs cannot be independently verified. The risk is that a malicious transaction co…

New user-facing warning for unverified multi-input SegWit amountsDetection logic tied to BIP143 signature semantics and inp.is_verifiedDoes not enforce previous-transaction inclusion; user can still proceed
518b3314by odudex+159−24 files
Vendor flagged security relevance
Repository ledger

Explore captured commits

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

Lower-priorityfix: add src to poe task PYTHONPATHby odudex · 566a0b93 · Jul 2, 2026 · 1 fileMessage 80 · StrongInformational 15Details
Commit message · odudex

fix: add src to poe task PYTHONPATH

Ensure poe-launched commands can import the local krux package under uv, where the project itself is not installed as a package.

80/100 · StrongMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Provides detailed explanatory context
AI analysis · Informational 15/100

This commit adjusts how a Python build tool (poe) finds the project's own source code when running commands. It adds the local 'src' directory to the PYTHONPATH environment variable for poe tasks. There is no indication this is a security fix; it is a development workflow fix to make local imports work correctly under the 'uv' packaging tool.

Lower-priorityfix: return None when decrypting an unknown or non-dict mnemonic idby kkdao · a2882082 · Jul 2, 2026 · 2 filesMessage 95 · StrongLow 29Details
Commit message · kkdao

fix: return None when decrypting an unknown or non-dict mnemonic id

MnemonicStorage.decrypt() resolved the id inside a try/except but then
called stored_value.get("b64_kef") outside it, so an unknown id (where
storage.get returns None) raised AttributeError instead of returning None.
A malformed seeds.json that parses to a non-dict (e.g. a JSON list) hit the
same path. Resolve the source dict and return None when the id is missing
or the stored entry isn't a dict -- no bare except, behaviour now tested.

The sole caller wraps the call in try/except, so this changes no on-device
behaviour; it gives decrypt() a clean return contract.

95/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Provides detailed explanatory context✓ Mentions testing or verification
AI analysis · Low 29/100

This commit fixes a small bug in how Krux loads saved encrypted seed data. Previously, if the saved file was valid JSON but shaped like a list instead of a dictionary, or if the requested seed ID was missing, the code could crash with an AttributeError instead of cleanly returning None. The fix makes the code treat those cases as 'nothing found' and adds tests to confirm it. The commit message says the on-device behavior is unchanged because the only caller already catches exceptions.

Lower-priorityrefactor: narrow mnemonic storage file-load errorsby kkdao · aebbfc92 · Jul 2, 2026 · 2 filesMessage 85 · StrongLow 34Details
Commit message · kkdao

refactor: narrow mnemonic storage file-load errors

The four read/load fallbacks in MnemonicStorage caught everything with a
bare `except:`, hiding unexpected errors (and on the K210 even
KeyboardInterrupt/MemoryError). Narrow them to the file/JSON errors they
actually expect -- (OSError, ValueError) -- matching the OSError
convention already used in sd_card.py. Behaviour for a missing/unreadable
file or malformed JSON is unchanged (storage starts empty / first store
still writes); a genuinely unexpected error now propagates instead of
hiding.

The decrypt and write catches stay broad on purpose (wrong-key /
failed-save contracts) and are now commented as such.

85/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Provides detailed explanatory context
AI analysis · Low 34/100

This commit is a defensive code cleanup, not an active vulnerability fix. It narrows four broad 'catch-everything' error handlers in the wallet's encrypted mnemonic storage module so they only ignore expected file/JSON problems. Unexpected errors (including serious ones like memory exhaustion or user cancellation) now surface instead of being silently swallowed. The change improves future bug detection and reliability but does not by itself create or close a known exploit.

AI review queuedrefactor: drop non-dict JSON coercion in encryption storageby kkdao · 2d195ad3 · Jul 2, 2026 · 2 filesMessage 85 · StrongLow 35Details
Commit message · kkdao

refactor: drop non-dict JSON coercion in encryption storage

Loading seeds.json no longer coerces valid-but-non-dict JSON to an
empty dict, so a wrong-shape file is preserved instead of being
silently overwritten on the next store. decrypt() keeps the
isinstance(source, dict) guard that prevents a crash on such files.

85/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Provides detailed explanatory context
Why it was queued
second-pass: broader security terminology
AI analysis · Low 35/100

This commit changes how Krux loads its encrypted seed storage file. Previously, if the file contained valid JSON but in the wrong shape (for example, a list instead of a dictionary), the app would silently treat it as empty and overwrite it on the next save. Now the app keeps the file's original contents and relies on a separate safety check to avoid crashing. The change is described as a code cleanup, but it also removes a behavior that could hide or destroy user data if a storage file were tampered with or corrupted.

AI review queuedfix: preserve corrupt seeds.json instead of overwriting on storeby odudex · e44d4324 · Jul 2, 2026 · 4 filesMessage 85 · StrongModerate 54Details
Commit message · odudex

fix: preserve corrupt seeds.json instead of overwriting on store

store_encrypted_kef raises StorageCorruptedError and leaves the file
untouched when an existing seeds.json is malformed or a non-dict, rather
than silently overwriting recoverable data. list_mnemonics returns [] for
non-dict storage so corrupt files no longer crash the menu; the UI reports
the corruption (English-only) and skips the store.

85/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Provides detailed explanatory context
Why it was queued
second-pass: broader security terminology
AI analysis · Moderate 54/100

This commit fixes a bug in Krux, a Bitcoin hardware-wallet tool, where saving a new encrypted seed could silently overwrite a damaged seeds.json file. The patch makes the app detect corrupt or misshapen seed storage and stop the save, preserving the existing file so the user can recover it. It also prevents the seed list menu from crashing when the stored file is malformed. There is no evidence this was a malicious backdoor; it appears to be a defensive bug fix.

Lower-priorityfix: improve default theme contrast (#879)by Naman Gupta · 782735a6 · Jun 23, 2026 · 5 filesMessage 65 · AdequateInformational 15Details
Commit message · Naman Gupta

fix: improve default theme contrast (#879)

65/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Links an issue, advisory, or supporting reference! No meaningful explanatory body
AI analysis · Informational 15/100

This commit adjusts color values in the Krux device's user interface themes to improve text and icon contrast. It is purely a visual accessibility/usability fix and does not change any security-sensitive logic, cryptography, input handling, or network behavior.

Lower-priorityrefactor: cache Settings() namespace tree as a singletonby odudex · 0f28c9a7 · Jun 23, 2026 · 2 filesMessage 85 · StrongInformational 13Details
Commit message · odudex

refactor: cache Settings() namespace tree as a singleton

Avoids rebuilding ~16 namespace objects on every Settings() call;
values are still read live from the store singleton.

Reset the cache in mock_retro_compatibility so the patched
DefaultWallet is picked up.

85/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Provides detailed explanatory context
AI analysis · Informational 13/100

This commit is a performance refactor, not a security fix. It caches a single copy of the app's settings object tree so it doesn't rebuild ~16 objects every time code asks for Settings(). The actual setting values are still read fresh from storage, so behavior should not change. A test helper is updated to clear that cache so a mocked wallet class gets picked up during tests.

Lower-priorityrefactor: dedupe flipped-orientation check in touch.py via is_flipped_orientationby kkdao · a0924c7c · Jun 17, 2026 · 2 filesMessage 62 · AdequateInformational 15Details
Commit message · kkdao

refactor: dedupe flipped-orientation check in touch.py via is_flipped_orientation

62/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope! No meaningful explanatory body
AI analysis · Informational 15/100

This commit is a simple code cleanup: it replaces two copies of the same display-orientation check with a single shared helper method. There is no security-relevant change in behavior; the logic before and after is functionally identical.

Security candidatedocs: update `poetry` to `uv commandsby qlrd · 55c72c34 · Jun 17, 2026 · 4 filesMessage 57 · ThinInformational 15Details
Commit message · qlrd

docs: update `poetry` to `uv commands

57/100 · ThinMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope! No meaningful explanatory body
Why it was queued
boot or update pathdocumentation-only discount
AI analysis · Informational 15/100

This commit only updates developer documentation, replacing instructions that mentioned the Poetry Python tool with instructions for the uv Python tool. No code, dependencies, or security behavior changed.

Lower-prioritychore: update `poetry` to `uv` commands.by qlrd · 5752a688 · Jun 17, 2026 · 3 filesMessage 57 · ThinInformational 15Details
Commit message · qlrd

chore: update `poetry` to `uv` commands.

57/100 · ThinMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope! No meaningful explanatory body
AI analysis · Informational 15/100

This commit is a routine developer tooling change. It replaces the 'poetry' command with the 'uv' command in documentation and a screenshot-generation script, and adds a single trailing comma in one Python file. There is no change to the actual Krux wallet application that users run, and no security-relevant behavior is modified.

Lower-priorityfeat: replace `poetry` to `uv` as venv managerby qlrd · a8eca7c8 · Jun 17, 2026 · 3 filesMessage 90 · StrongInformational 15Details
Commit message · qlrd

feat: replace `poetry` to `uv` as venv manager

This commit replaces the current virtualenv manager to `uv`. It's a
battle tested one and well accepted by community. It do not changes the
current behaviour of `poe` tasks, instead, we noted a faster run with
this manager.

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
AI analysis · Informational 15/100

This commit swaps the project's Python virtual-environment and dependency-lock tooling from Poetry to uv. It deletes the old Poetry lockfile (poetry.lock), updates pyproject.toml to use uv-compatible metadata, and adds a new uv lockfile (uv.lock). There is no change to application source code, runtime behavior, or installed dependencies, and nothing in the commit indicates a security fix or vulnerability.

Lower-priorityci: mirror the `uv run poe pre-commit` in CI jobsby qlrd · f981da0c · Jun 17, 2026 · 2 filesMessage 72 · AdequateInformational 15Details
Commit message · qlrd

ci: mirror the `uv run poe pre-commit` in CI jobs

This commit just update the CI to be coherent with the `pre-commit`
commit on `pyproject.toml`.

72/100 · AdequateMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Provides an explanatory body
Why it was queued
documentation-only discount
AI analysis · Informational 15/100

This commit only changes how the project's automated build and test pipelines install Python tools. It swaps the Poetry package manager for the `uv` tool in GitHub Actions workflow files. There is no change to the actual Krux application code, wallet logic, or anything users interact with.

Lower-priorityrefactor: read Settings() once in display.py orientation/init pathsby kkdao · 5eb27afe · Jun 15, 2026 · 1 fileMessage 85 · StrongInformational 15Details
Commit message · kkdao

refactor: read Settings() once in display.py orientation/init paths

to_landscape/to_portrait built a fresh Settings() namespace tree twice per
call and initialize_lcd built it three times. Read it once into a local and
reuse. Behavior unchanged.

85/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Provides detailed explanatory context
AI analysis · Informational 15/100

This is a straightforward internal code cleanup: it reads device settings once and reuses the result instead of reading them multiple times. The commit message and diff show no change in behavior, no bug fix, and no security relevance.

Lower-priorityrefactor: dedupe flipped-orientation check via is_flipped_orientationby kkdao · 3decdfd0 · Jun 15, 2026 · 2 filesMessage 85 · StrongInformational 15Details
Commit message · kkdao

refactor: dedupe flipped-orientation check via is_flipped_orientation

The orientation check was implemented in three places. Settings.is_flipped_
orientation() now uses self.hardware (it's a Settings method) instead of
rebuilding Settings() twice, and display.to_landscape/to_portrait call that
helper instead of re-implementing the hasattr/getattr inline. Consolidates the
logic to one place and removes redundant Settings() builds (also benefits
camera.py callers). Behavior unchanged.

85/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Provides detailed explanatory context
AI analysis · Informational 15/100

This commit is a straightforward internal cleanup: it moves a repeated screen-rotation check into a single shared helper and makes that helper use its existing object instead of creating new temporary settings objects. There is no user-facing behavior change and no security relevance.

Lower-priorityfix: narrow bare except blocks to stop hiding real errors (#877)by kkdao · c2048960 · Jun 12, 2026 · 6 filesMessage 100 · StrongLow 37Details
Commit message · kkdao

fix: narrow bare except blocks to stop hiding real errors (#877)

* fix: narrow bare except to StopIteration in display_qr_codes
* test: lock in StopIteration narrowing in display_qr_codes
* fix: narrow bare except to Exception in Key.extract_fingerprint
* test: lock in Exception narrowing in extract_fingerprint
* fix: narrow bare excepts in qr.py (IndexError / Exception)
* test: lock in detect_format Exception narrowing
* test: cover narrowed except branches in qr.py
* fix: narrow has_sd_card bare except to Exception

100/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Provides detailed explanatory context✓ Mentions testing or verification✓ Links an issue, advisory, or supporting reference
AI analysis · Low 37/100

This commit tightens several 'catch-all' error handlers in the Krux firmware so they only catch the specific problems they intend to handle. Previously, these handlers would also swallow serious system-level signals such as KeyboardInterrupt and unexpected programming errors, which could hide bugs or prevent a user from cancelling an operation. The change is defensive hardening rather than a fix for a known active attack, but it removes a class of reliability and safety bugs.

Lower-priorityfix: make settings reads non-mutating and harden malformed settings handling (#874)by kkdao · 7368ca45 · Jun 9, 2026 · 2 filesMessage 93 · StrongLow 48Details
Commit message · kkdao

fix: make settings reads non-mutating and harden malformed settings handling (#874)

* refactor: make Store.get() a non-mutating read-only walk
* fix: harden Store.__init__ against malformed persisted settings
* fix: validate persist.location is a known path in Store.__init__
* fix: harden Store.set/delete against non-dict namespace levels

93/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Provides detailed explanatory context✓ Links an issue, advisory, or supporting reference
Why it was queued
defensive validation
AI analysis · Low 48/100

This commit fixes bugs in how Krux reads and writes its saved settings. Previously, simply reading a setting could silently change the stored data, and a corrupted settings file (for example, one where a category was accidentally a word instead of a group) could crash the app or be misinterpreted. The patch makes reads truly read-only, repairs bad structure when writing, and only accepts known storage locations. It is a defensive hardening change rather than a fix for an active attack, but it removes several ways a tampered or damaged settings file could destabilize the device.

Lower-prioritydocs: add Spanish Krux video tutorialby odudex · b049b8e8 · Jun 9, 2026 · 1 fileMessage 57 · ThinInformational 15Details
Commit message · odudex

docs: add Spanish Krux video tutorial

57/100 · ThinMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope! No meaningful explanatory body
Why it was queued
documentation-only discount
AI analysis · Informational 15/100

This commit simply adds a Spanish-language video tutorial link to the documentation page. It is a non-code change with no security relevance.

Lower-prioritydocs: serve templates page at folder URL via index.mdby odudex · cd9ccf02 · Jun 8, 2026 · 5 filesMessage 85 · StrongInformational 15Details
Commit message · odudex

docs: serve templates page at folder URL via index.md

Rename templates.en.md to index.en.md so the page is served at the
folder URL, fixing the confusing leading '..' in image paths. Wrap it
in its own nav section so navigation.indexes labels it 'Templates'
instead of absorbing it into 'Interface'.

85/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Provides detailed explanatory context
AI analysis · Informational 15/100

This commit is a documentation reorganization. It renames a templates page so it appears at a cleaner web address and updates internal links accordingly. There is no change to the Krux software, device firmware, or any security-sensitive code.

AI review queueddocs: drop all third-party assets, add CSPby odudex · 6a7a357f · Jun 8, 2026 · 7 filesMessage 85 · StrongLow 42Details
Commit message · odudex

docs: drop all third-party assets, add CSP

Make the docs site fully self-contained so no remote code or assets load
in visitors' browsers:

- System font stack (theme.font: false) instead of Google Fonts
- Video tutorials as a title + link list, dropping YouTube thumbnails
- Shortcode emoji replaced with inline Material icons
- Remove the gitmind.com mind-map iframes (navigation page)
- Add a Content-Security-Policy meta tag (overrides/main.html) that
blocks external scripts/styles/fonts/frames, preventing a polyfill.io
style CDN injection at the browser level

85/100 · StrongMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Provides detailed explanatory context✓ Names security-relevant behavior explicitly
Why it was queued
second-pass: broader security terminology
AI analysis · Low 42/100

This commit hardens the Krux documentation website by removing all embedded third-party content (YouTube thumbnails, Google Fonts, gitmind.com iframes) and adding a browser-level Content-Security-Policy. The goal is to prevent attackers who compromise a third-party service (like a CDN) from injecting malicious code into visitors' browsers when they read the docs. It is a preventive security improvement, not a fix for an active vulnerability in Krux's hardware wallet firmware itself.

Security candidatedocs: self-host math, remove MathJax/require.js CDNby odudex · 492820a1 · Jun 8, 2026 · 28 filesMessage 90 · StrongLow 37Details
Commit message · odudex

docs: self-host math, remove MathJax/require.js CDN

Pre-render the entropy page display equations to committed SVGs and
write inline math as plain HTML, removing the cdnjs MathJax and
require.js loads (same supply chain class as the polyfill.io incident).
render_docs_math.py regenerates the SVGs from the markdown. Also ignore
mkdocs (public/) and pytest-cov (htmlcov/) build output.

90/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Provides detailed explanatory context✓ Names security-relevant behavior explicitly
Why it was queued
entropy or randomnessseed or entropy path
AI analysis · Low 37/100

This change removes third-party web scripts (MathJax and require.js loaded from a content delivery network) from the project's documentation and replaces them with self-hosted, pre-rendered math images. That eliminates a supply-chain risk similar to the polyfill.io incident, where a compromised or malicious CDN could inject harmful code into documentation pages viewed by users or developers.

Lower-prioritychore(mkdocs.yml): Remove polyfill.io from extra_javascriptby SatsCzar · de3c8300 · Jun 6, 2026 · 1 fileMessage 62 · AdequateModerate 50Details
Commit message · SatsCzar

chore(mkdocs.yml): Remove polyfill.io from extra_javascript

62/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope! No meaningful explanatory body
AI analysis · Moderate 50/100

This commit removes a reference to polyfill.io from the project's documentation website configuration. Polyfill.io is a third-party JavaScript service that was used to make documentation pages work in older browsers. It became a security concern in 2024 when the polyfill.io domain was reported to have served malicious code to websites in some cases. Removing it reduces the risk that visitors to the Krux documentation site could be served malicious JavaScript by that external service. The change is defensive and does not by itself prove an attack occurred against Krux users.

Lower-prioritychore(mkdocs.yml): Remove polyfill.io from extra_javascriptby SatsCzar · d2bff6b5 · Jun 6, 2026 · 1 fileMessage 62 · AdequateLow 46Details
Commit message · SatsCzar

chore(mkdocs.yml): Remove polyfill.io from extra_javascript

62/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope! No meaningful explanatory body
AI analysis · Low 46/100

This commit removes a reference to polyfill.io from the project's documentation website configuration. Polyfill.io was a widely used service that provides JavaScript code to help older browsers support modern web features. In 2024, the polyfill.io domain was acquired by a new operator and was reported to have served malicious code to some users through a supply-chain attack. Removing it reduces the risk that visitors to the documentation site could load untrusted or malicious JavaScript. However, this change only affects the documentation website, not the Krux device firmware or wallet software itself.

Lower-prioritychore: add min / recommended / latest tested python version to ciby qlrd · 249c8dbf · Jun 5, 2026 · 3 filesMessage 87 · StrongInformational 15Details
Commit message · qlrd

chore: add min / recommended / latest tested python version to ci

This commit add a restricted range of python versions on
`pyproject.toml` and testing those three versions on CI

87/100 · StrongMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Provides an explanatory body✓ Mentions testing or verification
AI analysis · Informational 15/100

This commit is purely a maintenance change to the project's build and test setup. It expands the officially supported Python versions from only 3.12.3 to a range from 3.11.5 up to (but not including) 3.13, and updates the continuous integration (CI) tests to run against two specific versions: 3.11.5 and 3.12.13. There are no changes to application code, user-facing behavior, or security-sensitive logic.

Lower-priorityfix: hide QR title in line/region modes to avoid index overlapby odudex · 04300401 · Jun 5, 2026 · 1 fileMessage 74 · AdequateInformational 16Details
Commit message · odudex

fix: hide QR title in line/region modes to avoid index overlap

74/100 · AdequateMessage clarity
✓ Specific, descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope✓ Explains rationale or failure mode! No meaningful explanatory body
AI analysis · Informational 16/100

This commit fixes a display bug in Krux, a Bitcoin hardware wallet tool. When showing QR codes in certain zoomed modes (line/region), a title text could overlap with on-screen index numbers, making the screen confusing. The fix simply hides the title in those modes. There is no direct evidence this is a security vulnerability.

Security candidatechore: update Embit and Maixpy to latestby odudex · b9b269c7 · May 30, 2026 · 2 filesMessage 57 · ThinInformational 0Details
Commit message · odudex

chore: update Embit and Maixpy to latest

57/100 · ThinMessage clarity
✓ Descriptive subject✓ Names a concrete action or component✓ Uses a recognizable type or scope! No meaningful explanatory body
Why it was queued
boot or update path
AI analysis · Informational 0/100

This commit updates two bundled dependencies (Embit and MaixPy) to their latest versions. No source code diff is available, and the commit message describes it as a routine maintenance chore with no security claims.