web: public read-only GET /api/identity for fleet discovery #16

Merged
noah merged 1 commits from feature/scan-identity into main 2026-11-12 15:13:22 -07:00
Owner

alkane-toolkit's fleet scan could not see a board running Alkane OS (no cgminer socket or vendor web UI exposed to a generic scanner). This adds an open, read-only GET /api/identity beside /api/summary: os, os_version, board, sdk_revision, hostname, mac, kernel. Nothing a stock miner does not already expose; no secret. The zynq .afw packager stamps the bundle version into /etc/alkane-os-version for it.

Tests: served without a session; every field read from the board files; absent files read as null (252 tests pass, fmt/clippy clean).

Hardware: built into alkane-os-0.1.2-zynq-7010-armv7.afw, installed on the bench Antminer S17 (verify-live PASS); GET /api/identity returned {"os":"alkane-os","os_version":"0.1.2","board":"zynq-7010",...} and the toolkit scan found the board through it.

Generated with Claude Code

https://claude.ai/code/session_01B1W6qKwKxq3oUPDKWicM6i

alkane-toolkit's fleet scan could not see a board running Alkane OS (no cgminer socket or vendor web UI exposed to a generic scanner). This adds an open, read-only `GET /api/identity` beside `/api/summary`: os, os_version, board, sdk_revision, hostname, mac, kernel. Nothing a stock miner does not already expose; no secret. The zynq `.afw` packager stamps the bundle version into `/etc/alkane-os-version` for it. Tests: served without a session; every field read from the board files; absent files read as null (252 tests pass, fmt/clippy clean). Hardware: built into `alkane-os-0.1.2-zynq-7010-armv7.afw`, installed on the bench Antminer S17 (verify-live PASS); `GET /api/identity` returned `{"os":"alkane-os","os_version":"0.1.2","board":"zynq-7010",...}` and the toolkit scan found the board through it. Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01B1W6qKwKxq3oUPDKWicM6i
noah added 1 commit 2026-11-12 15:02:03 -07:00
web: public read-only GET /api/identity for fleet discovery
source-pr / source (pull_request) Successful in 3m26s
2d3417b7d3
alkane-toolkit's fleet scan (asic-rs) recognises miners by their cgminer
socket or vendor web UI; an Alkane board has neither exposed, so it never
appeared and could not be right-clicked to flash. Add an open, read-only
identity endpoint beside /api/summary: os, os_version, board, sdk_revision,
hostname, mac, kernel - nothing a stock miner does not already expose, no
secret. The .afw packager stamps the bundle version into
/etc/alkane-os-version for it. Tests: served without a session; every field
read from the board files; absent files read as null.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01B1W6qKwKxq3oUPDKWicM6i
noah merged commit 484f479b90 into main 2026-11-12 15:13:22 -07:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: blueflare/alkane-os#16