API Reference

The live control dashboard (miner/dashboard.html).

The block explorer UI (miner/explorer.html).

A full engine snapshot. The shape:

{
  "chainId": 8888, "symbol": "LIQUA", "genesis": "0x…",
  "height": 142, "headRoot": "0x…",
  "running": true, "paused": false,
  "bits": 18, "autoDiff": true, "targetBlockMs": 2500,
  "hashCap": 0, "hps": 14820, "hashes": 1922334,
  "supply": 284.51, "emissionNow": 1.998,
  "posture": 0.2, "marker": "CALM",
  "validators": 4, "mempool": 0, "uptimeMs": 95120,
  "recent": [{ "height", "root", "ts", "nonce", "tries",
               "reward", "witnesses", "K", "blockMs", "hps" }]
}

Recent blocks (newest first). limit caps at 500.

One block by height (?h=142) or by SOMA root (?id=0x…).

Live stream. event: state fires ~every 600 ms with the gauge snapshot; event: log fires per log line ({ t, level, msg }, level ∈ info·ok·warn·mine·block·ctl·err).

Drive the miner. Body { "action": "<a>", "value": <v> }; replies { ok:true, state } with the fresh snapshot.

Pool stats + payout ledger + L1 bridge + connect info: { …engine.stats(), ledger, l1, connect }. l1 carries the bridged chain height + on-chain balances; ledger carries off-chain PPLNS balances + history.

Everything a miner needs to connect, with the pool's detected LAN IP pre-filled:

{
  "url": "stratum+tcp://192.168.1.20:3333",
  "stratumPort": 3333, "httpPort": 8030,
  "hosts": ["192.168.1.20", …], "bestHost": "192.168.1.20",
  "algo": "ethash", "epoch": 0,
  "shareDiff": 6000000, "networkDiff": 500000000,
  "payoutMode": "pplns", "reward": 2, "symbol": "LIQUA",
  "username": "YOUR_LIQUA_ADDRESS.worker",
  "examples": { "sim": "node pool/sim-miner.mjs …",
                 "lolminer": "lolMiner --algo ETHASH …",
                 "teamred": "teamredminer -a ethash …" }
}

Sealed pool blocks — list, or one by height / id. Same shape family as the miner's.

Live pool stream — emits event: state (full pool state) and event: xstate (explorer view) ~every 1 s.

Operator controls for the pool engine (difficulty, payout mode, etc.).

Real Stratum, two dialects (auto-detected). The username a miner authorizes with is its payout address. Methods handled:

• Simple / NiceHash — mining.subscribe · mining.authorize · mining.submit · mining.extranonce.subscribe (the server replies mining.set_difficulty + mining.notify).
• ethproxy — eth_submitLogin · eth_getWork · eth_submitWork · eth_submitHashrate.

Each accepted share is verified for real (@ethereumjs/ethash hashimoto-light); a share clearing the network target seals a block, splits PPLNS, and bridges to L1.

Chain + stake parameters that drive the connect UI:

{
  "chainId": 8888, "symbol": "LIQUA", "decimals": 18,
  "veLock": { "dMaxYears": 4, "boostMax": 0.5, … },
  "emission": {…}, "governance": { "quorum": 0.98 }, "reward": {…},
  "policy": { "minStake", "maxLockYears": 4, "boostMax": 0.5, "maxLockSeconds" },
  "height", "somaRoot", "genesis",
  "stake": { "token", "ve", "faucetAmount": 100000 },
  "set": { "count", "totalStaked", "totalVe", "online" }
}

The full validator set, ranked by ve-weight, with per-validator stake, lock, weight, share, online status, and blocks co-signed.

Your validator record, if registered: { found, validator }.

Staking config (token/ve/min) · your on-chain lock: { balance, locked, stake, veWeight, unlockAt, expired }.

Current head ({ height, somaRoot, … }) · chain summary · node status (also at /api/state): chainId, height, supply, validators, tally, set, miners[].

Devnet — grant test LIQUA. Body { address } → { ok, granted }.

Two-step signed staking. build with { from, action, amount, duration } (action ∈ approve · createLock · withdraw) returns { ok, tx, hash }; sign the hash and submit { tx, from, sig, v } → { ok, … }.

Join the set. Body is a signed LIQUA-VALIDATOR-REGISTER message — either { scheme:"native", address, pubkey, stake, lockSeconds, nonce, sig, rec } or { scheme:"eip191", address, stake, lockSeconds, nonce, sig } → { ok, validator }.

Co-sign the live head. Body { pubkey, head, sig, rec } (sign the head's somaRoot) → { ok, blocksCosigned }. This is the §1e proof-of-participation tick.

The node snapshot:

{
  "name", "id", "lnode", "miner",
  "chainId": 8888, "genesis": "0x…",
  "height": 6, "head": { "number", "hash" }, "stateRoot": "0x…",
  "peersDiscovered", "peersConnected", "evmPeers",
  "peers": [{ "id", "head" }],
  "controlPort", "httpPort", "port", "uptimeMs",
  "recent": [{ "height", "soma", "txs" }]
}

Live stream — event: state (~every 1.5 s) + event: log per event ({ t, level, msg }, level ∈ discover·peer·reject·drop·tx·block·produce·sync·err·sys). GET /api/log returns the buffered log.

Body { "action": "produce", "n": 1 } produces N blocks locally and gossips them; { "action": "stop" } shuts the node down. Returns { ok, produced, state }.