Skip to main content

submit

Submits a solved share for a job issued over the daemon's legacy remote-mining protocol, which has been superseded by Stratum support.

Request​

{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "submit",
  "params": {
    "id": "7",
    "nonce": 3405691582,
    "job_id": "SOME_JOB_ID",
    "result": "a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90"
  }
}

Request parameters​

  • id - string; the session identifier returned by login. The daemon looks up the block template stored for this session, applies the submitted nonce to it and tries to add the resulting block to the chain. If no template is stored under this identifier, the call reports "Wrong session id".
  • nonce - unsigned integer; the nonce found by the miner, written into the block before validation.
  • job_id - string; identifier of the job this share belongs to, as returned in the job's job_id.
  • result - string; hex-encoded hash produced by the miner for this nonce.

Response​

{
  "id": 0,
  "jsonrpc": "2.0",
  "result": {
    "status": "OK"
  }
}

Response information​

  • status - "OK" when the block was accepted by the core; "Wrong session id" when no block template is stored for the given id; "Block not accepted" when the resulting block failed validation; "BUSY" if the daemon is still synchronizing with the network (see Daemon RPC API).