Generating

The following RPC calls interact with the komodod software, and are made available through the komodo-cli software.

generate

generate numblocks

The generate method instructs the coin daemon to immediately mine the indicated number of blocks.

Arguments

NameTypeDescription
numblocks(numeric)the desired number of blocks to generate

Response

NameTypeDescription
blockhashes(array)hashes of blocks generated

๐Ÿ“Œ Examples

Command:

./komodo-cli generate 2
Show Response
[
  "0475316d63fe48bb9d58373595cb334fc2553f65496edfb2fb17b9ed06f4c480",
  "00d29a2b7dec52baa9ab8e4264363f32b4989eef7dbb0a9932fbc11274195b5a"
]

getgenerate

getgenerate

The getgenerate method returns a boolean value indicating the serverโ€™s mining status.

The default value is false.

Arguments

NameTypeDescription
(none)(none)

Response

NameTypeDescription
true/false(boolean)indicates whether the server is set to generate coins

๐Ÿ“Œ Examples

Command:

./komodo-cli getgenerate
Show Response
false

You can find your rpcuser, rpcpassword, and rpcport in the coinโ€™s .conf file.

Command:

curl --user $rpcuser:$rpcpassword --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getgenerate", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:$rpcport/
Show Response
{
  "result": false,
  "error": null,
  "id": "curltest"
}

setgenerate

setgenerate generate ( genproclimit )

The setgenerate method allows the user to set the generate property in the coin daemon to true or false, thus turning generation (mining/staking) on or off.

Generation is limited to genproclimit processors. Set genproclimit to -1 to use maximum available processors.

Arguments

NameTypeDescription
generate(boolean, required)set to true to turn on generation; set to off to turn off generation
genproclimit(numeric, optional)set the processor limit for when generation is on; use value โ€œ-1โ€ for unlimited

Response

NameTypeDescription
(none)(none)

๐Ÿ“Œ Examples

Activate mining with maximum available processors

Command:

./komodo-cli setgenerate true -1
Show Response
(none)
Activate staking

Command:

./komodo-cli setgenerate true 0
Show Response
(none)
Activate mining with 4 threads

Command:

./komodo-cli setgenerate true 4
Show Response
(none)
Check the setting

Command:

./komodo-cli getgenerate
Show Response
true
Turn off generation

Command:

./komodo-cli setgenerate false
Show Response
(none)
Turning the setting on via json RPC

Command:

curl --user $rpcuser:$rpcpassword --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "setgenerate", "params": [true, 1] }' -H 'content-type: text/plain;' http://127.0.0.1:$rpcport/
Show Response
{
  "result": null,
  "error": null,
  "id": "curltest"
}