Generating RPCs#

GenerateBlock#

🚧 Limited Support

This RPC is not available in the official Windows/Mac binaries. The Linux binary and binaries self-compiled (with the appropriate options) support this feature.

Added in Dash Core 18.1.0

The generateblock RPC mines a block with a set of ordered transactions immediately to a specified address or descriptor (before the RPC call returns).

Parameter #1—an address or descriptor

Name

Type

Presence

Description

Address/Descriptor

string

Required
(exactly 1)

The address or descriptor that will receive the newly generated Dash.

Parameter #2—transaction(s)

Name

Type

Presence

Description

Transactions

array

Required
(exactly 1)

An array of hex strings which are either txids or raw transactions. TXIDs must reference transactions currently in the mempool. All transactions must be valid and in valid order, otherwise the block will be rejected. Array can be empty.


Raw Transaction / TXID

string

Optional
(0 or more)

A raw transaction or transaction ID.

Result—the generated block hash

Name

Type

Presence

Description

result

object

Required
(exactly 1)

A JSON object containing the block header hash of the generated block


hash

string (hex)

Required
(exactly 1)

The hash of the header of the block generated, as hex in RPC byte order

Example from Dash Core 18.1.0

dash-cli  generateblock "yacJKd6tRz2JSn8Wfp9GKgCbuowAEBivrA" '[]'

Result:

{
  "hash": "000000e219a3d47463fdfed6da30c999f02d7add2defb2f375549b357d3840af"
}

See also

GenerateToAddress#

🚧 Limited Support

Since Dash Core 0.14, this RPC is not available in the official Windows/Mac binaries. The Linux binary and binaries self-compiled (with the appropriate options) continue to support this feature. See PR #2778 for additional details.

Added in Dash Core 0.12.3 / Bitcoin Core 0.13.0

The generatetoaddress RPC mines blocks immediately to a specified address.

Parameter #1—the number of blocks to generate

Name

Type

Presence

Description

Blocks

number (int)

Required
(exactly 1)

The number of blocks to generate. The RPC call will not return until all blocks have been generated or the maximum number of iterations has been reached

Parameter #2—a transaction identifier (TXID)

Name

Type

Presence

Description

Address

string (base58)

Required
(exactly 1)

The address that will receive the newly generated Dash

Parameter #3—the maximum number of iterations to try

Name

Type

Presence

Description

Maxtries

number (int)

Optional
(0 or 1)

The maximum number of iterations that are tried to create the requested number of blocks. Default is 1000000

Result—the generated block header hashes

Name

Type

Presence

Description

result

array

Required
(exactly 1)

An array containing the block header hashes of the generated blocks (may be empty if used with generate 0)


Header Hashes

string (hex)

Required
(1 or more)

The hashes of the headers of the blocks generated, as hex in RPC byte order

Example from Dash Core 0.12.3

Using regtest mode, generate 2 blocks with maximal 500000 iterations:

dash-cli -regtest generatetoaddress 2 "yaQzdWrDVYGncLKSKG4bHQ\
ML9UdAe726QN" 500000

Result:

[
  "34726c518d1688a9c56b3399e892089d3a639b43de194517c07da2b168a3a89c",
  "1f030abe2bb323b8895542e3a85ed8386bd92c67af9d19fe9c163a4c5f5ef149"
]

See also

GenerateToDescriptor#

🚧 Limited Support

This RPC is not available in the official Windows/Mac binaries. The Linux binary and binaries self-compiled (with the appropriate options) support this feature.

Added in Dash Core 18.1.0

The generatetodescriptor RPC mines blocks immediately to a specified descriptor.

Parameter #1—the number of blocks to generate

Name

Type

Presence

Description

Blocks

number (int)

Required
(exactly 1)

The number of blocks to generate. The RPC call will not return until all blocks have been generated or the maximum number of iterations has been reached

Parameter #2—a descriptor

Name

Type

Presence

Description

Descriptor

string

Required
(exactly 1)

The descriptor that will receive the newly generated Dash

Parameter #3—the maximum number of iterations to try

Name

Type

Presence

Description

Maxtries

number (int)

Optional
(0 or 1)

The maximum number of iterations that are tried to create the requested number of blocks. Default is 1000000

Result—the generated block header hashes

Name

Type

Presence

Description

result

array

Required
(exactly 1)

An array containing the block header hashes of the generated blocks (may be empty if used with generate 0)


Header Hashes

string (hex)

Required
(1 or more)

The hashes of the headers of the blocks generated, as hex in RPC byte order

Example from Dash Core 18.1.0

Generate 1 block with maximal 500000 iterations:

dash-cli -regtest generatetodescriptor 1 "pkh([d34db33f/84h/0h/0h]0279be667ef9dcbbac55a06295Ce870b07029Bfcdb2dce28d959f2815b16f81798)" 500000

Result:

[
  "0000007c599cc625ff4196ca55d73b6584ba89ccdd9836f969bf67b26b4a6376"
]

See also

  • GenerateBlock: mines a block with a set of ordered transactions immediately to a specified address or descriptor.

  • GenerateToAddress: mines blocks immediately to a specified address.

  • GetMiningInfo: returns various mining-related information.

  • GetBlockTemplate: gets a block template or proposal for use with mining software.