FAQ and Limits
SUBFROSTPOOL is not open yet. This page describes how it works at launch.
Limits at a glance
| Limit | |
|---|---|
| Pool API keys per account | 10 active |
/rpc rate | 120 calls/min per key by default, with a burst of the same size. Each call in a batch counts. |
/rpc batch size | 10 calls |
/rpc concurrent longpolls | 4 per key |
/rpc longpoll duration | Up to 20 minutes |
/rpc body | 8 MiB for submitblock, 64 KiB otherwise |
| Private-flow batch | 50 calls, private-flow methods only |
| Private transaction window | Default tip+25 blocks, max tip+144 |
| Bundle size | 25 transactions |
| Sign-in sessions | 7 days, or 24 hours idle |
| Verification and reset emails | 3 per address per hour. Links last 24 hours (verify) and 1 hour (reset). |
Do I have to change my pool software?
No. Change the RPC URL and credentials. See Connecting pool software.
Is Stratum available?
Not yet. Stratum for individual miners opens after the payout contract's audit and a testnet4 run. Until then, run your own stratum server (ckpool, public-pool, SRI) against the RPC. How it works describes how stratum payouts will work.
Can SUBFROSTPOOL make my blocks worse?
It never removes upstream transactions. Everything it adds is checked against the upstream node first and pays real BTC fees. If anything on the SUBFROST side fails, you get the plain upstream template.
What happens to the coinbase?
Nothing, unless you opt in. Plain getblocktemplate software builds its own coinbase, as it always has. The optional dxBTC outputs are described in The dxBTC coinbase outputs.
Pool key or SUBFROST API key?
- Pool key (
sfp_…, from pool.subfrost.io): only forpool.subfrost.io/rpc. - SUBFROST API key (from api.subfrost.io): for the private flow API at
mainnet.subfrost.io/v4/<key>.
I lost my key
Keys are stored only as a hash, so they can't be shown again. Revoke the old key and create a new one under Account → API keys.
I lost my authenticator
Sign in with one of your recovery codes. Each recovery code works once.
Can I pay for inclusion in DIESEL today?
Not on mainnet yet. Requests that carry a payment return -32501. Transactions that pay their own BTC fee can already be sent privately.
Why did my bundle land in a different order, or only partly?
Bundle ordering and all-or-nothing hold only in blocks built from SUBFROSTPOOL templates. A pool that never received the bundle, but saw its transactions some other way, treats them as ordinary transactions.
Who can see my private transaction?
Searchers see only the fields you list in hints, and nothing by default. Raw hex is never streamed. Status queries need your key or a BIP-322 signature, and public stats are aggregate only.