noahandClaude Opus 4.8 baf19ed6c8 Formalize zynq-7010 tier-2 .afw: producer profile + brick gate (zimage format, ceilings, preserve)
Adds a buildable zynq-7010 profile and its .afw brick-prevention gate, so the
proven Zynq image is a first-class .afw like cv1835/am335x.
- afw_boards.py: full zynq-7010 profile (armv7, preserve; kernel(zimage)+dtb(fdt)
  into mtd0, rootfs(cpio-gzip) into mtd1); new strict 'zimage' SAFE_IMAGE_FORMAT.
- afw_manifest.py + check-afw.py: validate_zynq / the zynq-7010 gate - exactly the
  kernel/dtb/rootfs image set, correct formats, size ceilings (kernel <= 0x500000
  fits the slot, dtb <= 0x20000, rootfs <= 0x2000000 fits mtd1), and NO
  bootloader/spl/BOOT.bin member (stock BOOT.bin + FPGA bitstream preserved). The
  per-unit kernel-slot offset is placed by the install method (differs S17/S19),
  so the gate enforces formats+ceilings+policy, not a fixed offset map.
- check-afw: strict zimage magic (0x016f2818 at 0x24).
- tests: good bundle, non-zImage kernel, oversize kernel, bootloader-member refusals.
Built + double-gated the real bundle: alkane-os-0.1.0-zynq-7010-armv7.afw
(kernel 4.1 MiB, dtb 11 KB, rootfs 2.5 MiB). Full afw suite green.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01B1W6qHxYpv7yf7Ah57g4rQ
2026-11-06 19:43:47 -06:00

Alkane OS

CI tests coverage bench bench coverage lines of code dependencies code quality license

Rust mining and tuning core for Alkane control boards. The SDK builds board images and provides the hardware backend. The miner has no on-board web frontend.

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.

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.

S
Description
Portable mining and tuning OS built through alkane-sdk
Readme MIT
9.9 MiB
Languages
Rust 73.6%
Python 24.6%
Shell 1.8%