ethminer四, 11/02/2021 - 21:56 的修訂版本


最後更新: 2021-02-11



ethminer api


# Use 0 to disable. Default=0

# use negative numbers to run in readonly mode. for example -3333.

--api-port <portnum>

Messages exchanged through this channel must conform the Jsonrpc v.2 specifications


echo '{"id":0,"jsonrpc":"2.0","method":"miner_ping"}' | netcat 3333


A collection of statistical data (miner_getstat1)

echo '{"id": 1,"jsonrpc": "2.0","method": "miner_getstat1"}' | netcat 3333 | jq

    "0.16.0.dev0+commit.41639944",          // The actual release of ethminer
    "48",                                   // Total running time in minutes
    "87221;54;0",                           // ETH hashrate in KH/s, submitted shares, rejected shares
    "14683;14508;14508;14508;14508;14508",  // Detailed ETH hashrate in KH/s per GPU
    "0;0;0",                                // (not used) DCR hashrate in KH/s, submitted shares, rejected shares
    "off;off;off;off;off;off",              // (not used) Detailed DCR hashrate in KH/s per GPU
    "53;90;50;90;56;90;58;90;61;90;60;90",  // Temp and fan speed pairs per GPU
    "",               // Mining pool currently active
    "0;0;0;0"                               // ETH invalid shares, ETH pool switches, DCR invalid shares, DCR pool switches


The mining process is nothing more that finding the right number(nonce) which,

applied to an algorithm (ethash) and some data,

gives a result which is below or equal to a given target.

This process in very very (very) short !

The range of nonces to be searched is a huge number:

2^64 = 18446744073709600000 ~ possible values.

Each one has the same probability to be the right one.

Every time ethminer receives a job from a pool

  you'd expect the miner to begin searching from the first but that would be boring.

So the concept of scramble nonce has been introduced to achieve these goals:

 * Start the searching from a random point within the range

 * Ensure all GPUs do not search the same data(without overlapping)

"miner_shuffle" method does is to re-initialize a new random scramble nonce to start from in next jobs.

{"id": 1, "jsonrpc": "2.0", "method": "miner_shuffle"}


useful if you detect one, or more, GPU are in error but in a recoverable state

recoverable state = no hashrate but the GPU has not fallen off the bus

原理: restart ethminer without loosing connection to the pool )


  1. Stop actual mining work
  2. Unload generated DAG files
  3. Reset devices (GPU)
  4. Regenerate DAG files
  5. Restart mining

echo '{"id": 1, "jsonrpc": "2.0", "method": "miner_restart"}' | netcat 3333