# Fake Rig Fixtures

> Use when editing `server/fake-antminer/` or `server/fake-proto-rig/`. These are test doubles consumed by `tests/plugin-contract/`, the E2E suites, and the local `just dev` stack — behavior changes here ripple silently into all three surfaces.

- Skill: `block/fake-rig-fixtures` (Agent Skill)
- Install (CLI): `npx skillmds@latest add block/fake-rig-fixtures`
- Raw SKILL.md: https://api.skillmd.com/api/skills/block/fake-rig-fixtures/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: block (https://skillmd.com/u/block)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/block/fake-rig-fixtures

---


# fake-rig-fixtures

`server/fake-antminer/` simulates the cgminer API (port 4028) and Antminer
Web API (port 80). `server/fake-proto-rig/` simulates the Proto miner REST
API. They are linked into multiple test surfaces:

- Plugin contract tests (`tests/plugin-contract/miners/`)
- E2E tests (`client/e2eTests/`)
- Local `just dev` (when virtual or fake plugins are configured)

A change that "fixes" one surface can break the others without the agent
noticing.

## What to do

1. After editing handler responses, models, or default config, identify
   which surfaces consume the fixture and run the relevant suite:
   - Plugin contract: `just test-contract`
   - ProtoFleet E2E: `just test-e2e-fleet`
   - ProtoOS E2E: `just test-e2e-protoos`
2. If the change is a new field or new endpoint, check that consumers
   under `plugin/antminer/` (or `plugin/proto/`) actually parse it. A
   silently-ignored field is the most common bug here.
3. The Antminer Web API uses digest auth with `root`/`root` defaults —
   don't change auth semantics without flagging it explicitly.

## What to avoid

- Don't add request-handler logic that depends on real-time clocks or
  external services. The fixtures must be deterministic for contract
  testing.