Four-dimension review (correctness/security/reliability/maintainability) of today's console/bus/login/dashboard/image work found no Critical/High; the HTTP parser, login gate (un-bypassable), bus semantics and the HMAC/PBKDF2/SHA-256 math were verified correct. The Medium findings are fixed here. Security: - Token-gate /api/files and /api/file (were session-only despite the docs/Security page claiming token-gated - arbitrary root-readable file exfiltration). - Neutralize settings-redirect header-splitting: __section/__tab are constrained to safe slugs before going into the Location header (CRLF no longer injects). - One token source (auth::rand_hex): fail loud + non-constant fallback instead of the published "dev-csrf-token" / second-granular wsid when /dev/urandom is unreadable. - Constant-time UI-token compare (auth::ct_eq); write auth.json 0600, dir 0700. - Cap concurrent connections (64, 503 beyond) + 10s head-read deadline, bounding the thread-per-connection flood on the open :80. Reliability/correctness: - Settings persistence now propagates its write error (was swallowed and reported as success with a misleading comment) and writes atomically (temp+rename); deck save atomic too. Auth::login returns None if the session insert failed. - TuningLoop::set_target resets the PID accumulator on a mode change (the old target's integral is in the old units) while keeping the operating point. - Editable-deck JS: monotonic new-block ids (no collision after remove+add), default source frequency (was power_w, not in the live map), symmetric drag-drop placement, re-render after save. Drivers "stopped" shows the bare reason, not JSON-quoted. Maintainability: - New `form` module consolidates the three divergent percent_decode/field copies (web/service/dashboard). Added a test asserting published state topics match the registry contract. Report in code-review-report.md (verdict, accepted-by-design posture incl. the no-TLS / factory-creds residual risk, and a deferred list: ui.rs dead code, deck assets extraction, target_label dedup). 206 lib tests + integration pass, clippy -D warnings clean, no emojis. Image rebuilt with the fixed binary. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BdKQBPjAXpCwmigUov5eQk
Alkane OS
Rust mining and tuning core for Alkane control boards. The
SDK builds board images and
provides the hardware backend. The on-board web console is the parameterised
flare-ui: a sidebar shell with live telemetry (readings) and real controls
(mode/target, start/stop) that drive the runtime, with /api/... as the
interface of record behind every page.
Status
The host miner supports BM1362 and BM1366 through the SDK's simulator HAL and Stratum V1. Tests have replayed 33 captured BM1366 shares and one BM1362 share to a loopback pool with matching ACCEPT responses. Production board control is still under development.
The BM1370 module encodes a captured S21 Pro job and parses captured nonce frames. Work-ID mapping, chain control, and pool acceptance remain open.
The HAL client requests PSU shutdown on sensor faults and reserves work IDs until a confirmed reset or shutdown. A production backend still needs a power lease, watchdog, and validated temperature limits. SHA-256d and Litecoin Scrypt proof verification are implemented; Scrypt chip report handling and mining remain open.
Run alkane-os --list-targets for the target matrix. Set POOL_PASSWORD to
the pool password, then mine with a simulator HAL socket and Stratum V1 pool:
ALKANE_POOL_PASSWORD="$POOL_PASSWORD" alkane-os --mine-simulator HAL_SOCKET POOL_ADDRESS WORKER BM1366
Use BM1362 for that chip. Set ALKANE_API_LISTEN=127.0.0.1:4028 for
read-only summary and version commands; reach it remotely through SSH.
To bring up the full web console on a workstation with no hashboard, run
alkane-os --serve-sim: a reference HAL runs in-process, the runtime boots
against it, and the printed URL serves the live, controllable console (the
frequency moves toward the target; start/stop and mode changes take effect).
alkane-os --serve serves the same console with no backend, for a board whose
HAL backend is not written yet. ALKANE_WEB_LISTEN=ADDR overrides the bind
(default port 80, or 8080 without privilege).
Release gate
main runs tests, benchmarks, and conformance before release; next builds
release candidates. The release gate is red. It requires all 64 same-vendor
pairings (52 Bitmain, 12 WhatsMiner), unmodified stock firmware, captured
silicon nonces, difficulty-1 pool acceptance, and bench-validated models.
Stock firmware may faithfully reject a pairing; Alkane OS must mine it.
See the evidence contract.
Badges cover host code, not board conformance. See the public benchmark history.
Local checks
CARGO_TARGET_DIR=/var/tmp/alkane-os-target cargo test --locked
Use an executable target directory if the source mount is noexec.
License
MIT. Vendored dependencies keep their own licenses.