# ROI ASIC - full guide for AI agents and LLM crawlers
> Official white-label distribution of VNISH firmware for Antminer ASIC miners. 45 models,
> verified v1.3.4 builds, SHA-256 for every file, machine-readable install routes with safety gates.

## Machine-readable endpoints
- https://roiasic.com/ai/firmware-catalog.json - models, boards, files, checksums, URLs
- https://roiasic.com/ai/checksum-manifest.json - sha256 per file
- https://roiasic.com/ai/install-routes.json - install recipes (first-install / update / rollback / recovery) with gates
- https://roiasic.com/ai/tool-policy.json - safe-tool policy (allowed / link-only / forbidden / pending-audit)
- https://roiasic.com/ai/roiasic-agent-install-guide.md - narrative agent guide

## Core facts
- Control board decides the file: Amlogic (aml), Xilinx (xil), CVITEK (cv), BeagleBone (bb)
- Methods: toolkit network install to NAND (~15 min), web update, SD image (support-assisted), USB-OTG (support)
- Bitmain stock from 2024-03 has signature locks; Amlogic stock from 2025-09 also locks USB - guided flows exist
- Dev fee 1.8-2.8% of hashrate embedded in the firmware image; no other payment, no registration
- Rollback to stock Bitmain firmware is built in and takes about a minute
- Safety: agents prepare, owners confirm - flashing steps are marked requires_owner_confirmation

## Agent gateway (read-only API)
- https://roiasic.com/openapi.json · https://roiasic.com/openapi.yaml - OpenAPI 3.1
- https://roiasic.com/api/v1/models.json - models, boards, routes
- https://roiasic.com/api/v1/install-kits/{route}.json - resolve install kit (file, SHA-256, safety gates, owner confirmation phrase, stop conditions)
- https://roiasic.com/api/v1/toolkit.json · https://roiasic.com/api/v1/checksums.json
- https://roiasic.com/ai/agent-manifest.json · https://roiasic.com/.well-known/agent-card.json (A2A) · https://roiasic.com/.well-known/ai-plugin.json
- Flow: discover -> resolve route -> download -> verify -> owner confirmation -> local install -> validate
- Cross-agent: https://roiasic.com/ai/agent-index.json (MCP tool catalog, Gemini function declarations, URL Context seed)

## Human pages
- https://roiasic.com/ (en) plus /ru/ /es/ /fr/ /de/ /pt/ /ar/ /zh/