get_miner_status
Check whether an address will become a validator when this epoch ends: its registered consensus key, work this epoch, rank among eligible miners, blocks (and estimated seconds) until the validator set is picked, whether it's a validator now, and its escrowed mining rewards. The address is required. Read-only; every field is as of one block height.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | Aether account address (aether1...); required, this server holds no key |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rank | No | 1-based position among eligible miners by work; absent if not eligible | |
| epoch | Yes | ||
| banned | Yes | permanently banned for equivocation | |
| escrow | Yes | ||
| height | Yes | every field is as of this block | |
| address | Yes | ||
| onTrack | Yes | would be picked if the epoch ended now; only ever true under top_k_by_work, since a random draw isn't known in advance | |
| eligible | Yes | can be picked when this epoch ends: has work this epoch, a registered consensus key, and no ban | |
| topKSize | Yes | ||
| workShare | No | this address's share of all eligible work this epoch, 0 to 1; under beacon_weighted_sample it drives the odds of being drawn | |
| selectionRule | Yes | top_k_by_work: the topKSize eligible miners with the most work are picked; beacon_weighted_sample: topKSize are drawn at random, weighted by work | |
| workThisEpoch | Yes | ||
| eligibleMiners | Yes | ||
| activeValidator | Yes | in the validator set right now | |
| notEligibleBecause | No | any of no_work_this_epoch, no_consensus_key, banned | |
| registeredConsensusKey | Yes | a consensus public key is registered for this address; without one, mining never makes it a validator |