API
Read-only, no key, CORS open. Amounts are integer zatoshis (1 ZMR = 100,000,000). Hashrates are hashes per second. Times are Unix seconds, except lastBlockFound, which is milliseconds as a string, as in cryptonote-nodejs-pool. Responses are cached for 10 seconds; please poll no more than once a minute.
GET /api/stats
Pool, network and configuration numbers, in the config / pool / network shape of cryptonote-nodejs-pool's /stats, which MiningPoolStats and similar listings read for RandomX pools. config.logins is sapling-or-transparent before payments are shielded-only, unified-or-sapling once they are, and unified once Sapling logins have stopped ahead of NU2 (Orchard only). shieldedOnly is the countdown: from activationHeight (the Testnet's network upgrade; Mainnet from genesis) a transaction that is not a coinbase has no transparent outputs, so transparent logins are refused and transparent sessions still connected are closed (transparentSessionsDropped counts them since the pool started); from cutoffHeight every transparent balance is paid out while that is still valid; secondsLeft estimates 75 s a block. orchardOnly is the same for Sapling: from height (NU2; Mainnet is Orchard only from block 1) no transaction can have Sapling spends or outputs, so the pool can no longer pay a Sapling address. Sapling logins are refused and Sapling sessions closed from loginStopHeight (saplingSessionsDropped counts them since the pool started), early enough that a block they find matures before cutoffHeight, from which every Sapling balance is paid out whatever its size, in every round up to the last one before NU2. From NU2 what is still credited to a Sapling address is held, and a transparent balance is paid only to a registered unified address. On a network that is never Orchard-only, height, loginStopHeight and cutoffHeight are null and active is false. config.algorithm is the algorithm of the current work, as zecnerod's template names it: rx/zecnero below NU2, rx/zecnero2 (RandomX v2) from NU2 on. nu2 gives NU2's height where the pool knows it, whether the pool mines rx/zecnero2 now (active), and sessionsDropped: sessions closed because their miner did not list the pool's algorithm at login (a miner that predates rx/zecnero2, at NU2), since the pool started. node is the pool's node as the pool sees it: templateAgeSecs since its last block template (-1 before the first), peers (null until it answers), and stale, true while the pool gives out no work because that work may be for an old block (no new template for 10 minutes, or no usable template or no peers for 2 minutes), with staleReason. Miners are then refused and their connections closed with the reason, so XMRig moves to the next pool in its pools list until this one is current again. blocksNotSubmitted counts blocks found on stale work since the pool started; they are never submitted. warning.networkShare is the pool's hashrate over the network's (0 while the node reports none); the pool has no cap on its share.
{
"config": { "coin": "Zecnero", "symbol": "ZMR", "network": "Testnet", "algorithm": "rx/zecnero",
"poolHost": "stratum.zecnero.org", "ports": [{ "port": 3334, "difficulty": 5000, "desc": "vardiff, TLS", "tls": true },
{ "port": 3333, "difficulty": 5000, "desc": "vardiff", "tls": false }],
"stratum": "stratum.zecnero.org:3333", "stratumTls": "stratum.zecnero.org:3334",
"fee": 0.0, "payoutScheme": "PPLNS", "pplnsWindowFactor": 2.0, "coinUnits": 100000000,
"coinDifficultyTarget": 75, "minPaymentThreshold": 50000000, "paymentsInterval": 900, "maturity": 100,
"logins": "sapling-or-transparent" },
"pool": { "hashrate": 15230, "hashrate1h": 14800, "miners": 12, "workers": 17, "connectedMiners": 12,
"connectedWorkers": 17, "roundHashes": 5210000, "totalBlocks": 3, "lastBlockFound": "1790000000000",
"totalPayments": 2, "totalMinersPaid": 9, "totalPaid": 1180000000, "confirmedPayments": 1,
"confirmedPaid": 580000000, "owed": 30500000,
"shares": { "accepted": 9120, "stale": 14, "invalid": 2, "busy": 0, "errors": 0 } },
"network": { "height": 3120, "difficulty": 1100000, "hashrate": 15000, "reward": 606250000 },
"shieldedOnly": { "activationHeight": 16529, "cutoffHeight": 16469, "active": false, "blocksLeft": 2080,
"secondsLeft": 156000, "transparentLogins": "accepted until activation",
"transparentPayouts": "paid as usual until the cutoff", "transparentSessionsDropped": 0 },
"orchardOnly": { "height": 52063, "loginStopHeight": 51903, "cutoffHeight": 52003, "active": false, "blocksLeft": 48943,
"secondsLeft": 3670725, "saplingLogins": "accepted until the stop",
"saplingPayouts": "paid as usual until the cutoff", "saplingSessionsDropped": 0 },
"nu2": { "height": 52063, "algorithm": "rx/zecnero2", "active": false, "sessionsDropped": 0 },
"warning": { "networkShare": 0.12 },
"node": { "templateAgeSecs": 41, "peers": 8, "stale": false, "staleReason": null, "blocksNotSubmitted": 0 }
}GET /api/blocks?limit=50&offset=0
Blocks the pool found, newest first. status is pending (waiting for 100 confirmations), credited (matured and split among its PPLNS window), orphaned, rejected, or stalled (pending, found over 10 minutes ago, and the node's tip has not moved past it: it may be on a fork of the node's own; it shows as pending again once the tip moves on). effort is the share work of the round over the block's difficulty; 1.0 is average luck.
{ "blocks": [ { "height": 3118, "hash": "00…", "time": 1790000000, "status": "pending", "confirmations": 3,
"reward": 606250000, "difficulty": 1100000, "effort": 0.87, "finder": "nutest1…", "worker": "rig1",
"window_shares": 412 } ] }GET /api/payments?limit=50
Payouts, newest first, from the moment they are recorded. status is prepared (recorded, not signed yet, no txid), signed, broadcast (sent: the node took it; confirmations counts up), confirmed (at config.paymentConfirmations, 10), or needs_review (held for the operator). A payout that expired unmined at a network upgrade is left out: its balances are owed again and paid in a later payout. amount is what the recipients receive; fee is the transaction fee they shared equally. In /api/stats, totalPayments and totalPaid count every sent payout; confirmedPayments and confirmedPaid only the confirmed ones.
{ "payments": [ { "id": 7, "time": 1790000000, "txid": "ab…", "status": "broadcast", "confirmations": 3,
"recipients": 5, "amount": 402500000, "fee": 30000 } ] }GET /api/miner/<address>
One address: hashrate over 10 minutes and 1 hour, workers with a share in the last hour, balance (credited, not paid yet), immature (its PPLNS share of blocks under 100 confirmations), in_flight (on its way: in payouts not confirmed yet, as it will arrive), confirming (the part of that the node has accepted), paid (confirmed), and its payments with their status and confirmations. connected lists its live connections and their current difficulty. An address of another network is answered 400 with the reason. For a transparent address, payout_address is its registered payout address (or null) and shielded_only says what happens to its balance around activation. For a Sapling address on a network that becomes Orchard-only, orchard_only says what happens to its balance around NU2 (null otherwise).
{ "miner": { "address": "nutest1…", "hashrate": 1520, "hashrate_1h": 1490, "balance": 12030000, "immature": 60620000,
"paid": 250000000, "in_flight": 0, "confirming": 0, "blocks_found": 1,
"workers": [ { "name": "rig1", "hashrate": 1520, "hashrate_1h": 1490, "shares_1h": 240, "last_share": 1790000000 } ],
"payments": [ { "time": 1790000000, "txid": "ab…", "amount": 99994000, "fee": 6000, "status": "confirmed",
"confirmations": 12 } ] },
"connected": [ { "address": "nutest1…", "worker": "rig1", "difficulty": 22500, "since": 1789990000 } ] }POST /api/register
Registers the unified address (with an Orchard receiver) that the balance of a transparent login goes to once payments are shielded-only (a block found before activation can mature after it). A Sapling address is refused from the Sapling stop ahead of NU2, and a balance held from NU2 is paid only to a unified address. Body: { "address": "nm…", "sapling": "nutest1…", "signature": "…" } (the field keeps its name). The signature must be made by the nm… address's key, so no one else can redirect a balance: Bitcoin's signmessage format (65-byte recoverable signature, base64) with the prefix "Zecnero Signed Message:\n", over the message "Zecnero pool payout address\n" + address + "\n" + sapling. zecnero-miner register-payout and zecnero-wallet sign-message make it. A later registration replaces an earlier one. Answers 400 with the reason if the signature does not verify.
{ "address": "nm…", "sapling": "nutest1…", "registered": true }GET /api/health
For monitoring: seconds since the last block template, the node's tip and peers, whether the pool's work is stale (with the reason and the blocks not submitted, as in node in /api/stats), open connections, share checks waiting, and whether payouts are halted. wallet.saplingFrozen is what the hot wallet still holds in Sapling notes from NU2, which no transaction can spend: it should be 0.