Skip to content

Package ForgeBox offline firmware signing tools - #145

Draft
3rdIteration wants to merge 1 commit into
mainfrom
feat/forgebox-offline-signing
Draft

3rdIteration wants to merge 1 commit into
mainfrom
feat/forgebox-offline-signing

Conversation

@3rdIteration

@3rdIteration 3rdIteration commented Nov 9, 2026 •

Copy link
Copy Markdown
Owner

What changes

The build PC prepares a ForgeBox OTA with the official CLI compressor and puts a small signing request on microSD. SeedSigner derives a dedicated BIP85 secp256k1 key, returns the two OTA signatures, and the PC verifies and assembles the update against the original image and trusted public key. The optional USB bridge also supports offline proof of possession for initial registration.

The build installs the Python signer alongside the existing OS signing tools for Pi, La Frite and Luckfox. It uses the existing embit and python-ecdsa packages. The app PR adds the review and authorization screens.

Validation

  • Eight protocol tests, including the published BIP85 vector, independent OpenSSL verification, tampering and stale response rejection, and a round trip through forgebox-cli 1.2.0.
  • Simulated USB registration covers nonce-based and legacy proofs, rejection and disconnect cleanup.
  • Synthetic rootfs tests cover signer installation, opt-out behavior and reproducible mtimes.

Physical registration, nonce lifetime and flashing need device validation. The signer authorizes digests and relies on the operator to review the firmware on a trusted PC. Pure Python ECDSA does not guarantee constant-time execution or memory erasure.

Paired app change: SeedSigner #488.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant