Evo RPCs

BLS

Added in Dash Core 0.13.0

The bls RPC provides a set of commands to execute BLS-related actions.

BLS FromSecret

The bls fromsecret RPC parses a BLS secret key and returns the secret/public key pair.

Parameter #1---secret key

Name	Type	Presence	Description
secret	string (hex)	Required (exactly 1)	The BLS secret key

Result---the secret/public key pair

Name	Type	Presence	Description
result	object	Required (exactly 1)	BLS key pair
→ secret	string (hex)	Required (exactly 1)	A BLS secret key
→ public	string (hex)	Required (exactly 1)	A BLS public key

Example from Dash Core 0.14.0

Bash

dash-cli -testnet bls fromsecret 52f35cd3d977a505485f2474e7e71ef3f60f859603d72ad6b0fa7f7bd163e144

Result:

JSON

{
  "secret": "52f35cd3d977a505485f2474e7e71ef3f60f859603d72ad6b0fa7f7bd163e144",
  "public": "885d01d746c3e4d2093b0975de2d8c1f3e5a2c3e8fdaaed929f86fc9fbb278a095248163c101a2456650b415776b7990"
}

BLS Generate

The bls generate RPC creates a new BLS secret/public key pair.

Parameters: none

Result---a secret/public key pair

Name	Type	Presence	Description
result	object	Required (exactly 1)	BLS key pair
→ secret	string (hex)	Required (exactly 1)	A BLS secret key
→ public	string (hex)	Required (exactly 1)	A BLS public key

Example from Dash Core 0.13.0

Bash

dash-cli -testnet bls generate

Result:

JSON

{
  "secret": "52f35cd3d977a505485f2474e7e71ef3f60f859603d72ad6b0fa7f7bd163e144",
  "public": "885d01d746c3e4d2093b0975de2d8c1f3e5a2c3e8fdaaed929f86fc9fbb278a095248163c101a2456650b415776b7990"
}

See also: none

ProTx

Added in Dash Core 0.13.0

The protx RPC provides a set of commands to execute ProTx related actions.

ProTx Diff

The protx diff RPC calculates a diff and a proof between two masternode list.

Parameter #1---start block height

Name	Type	Presence	Description
baseBlock	number (int)	Required (Exactly 1)

Parameter #2---end block height

Name	Type	Presence	Description
block	bool	Required (Exactly 1)

Result---JSON provider registration transaction details

Name	Type	Presence	Description
result	array	Required (exactly 1)	An array of objects each containing a provider transaction, or JSON null if an error occurred
→ baseBlockHash	string (hex)	Required (exactly 1)	The hash of the base block as hex in RPC byte order
→ blockHash	string (hex)	Required (exactly 1)	The hash of the ending block as hex in RPC byte order
→ cbTxMerkleTree	string (hex)	Required (exactly 1)	The coinbase transaction merkle tree
→ cbTx	string (hex)	Required (exactly 1)	The coinbase transaction
→ deletedMNs	array	Required (exactly 1)	An array of deleted masternode hashes
→ mnlist	array	Required (exactly 1)	An array of masternode details
→ → proRegTxHash	string (hex)	Required (exactly 1)	The hash of the initial provider registration transaction as hex in RPC byte order
→ → confirmedHash	string (hex)	Required (exactly 1)	The hash of the block where the ProRegTx was mined
→ → service	string	Required (exactly 1)	The IP address/Port of the masternode
→ → pubKeyOperator	string (hex)	Required (exactly 1)	The operator public key
→ → votingAddress	string (hex)	Required (exactly 1)	The voting address
→ → isValid	bool	Required (exactly 1)	Set to true if masternode is valid
→ deletedQuorums	array	Required (exactly 1)	An array of deleted quorums
→ → llmqType	number	Required (exactly 1)	The quorum type
→ → quorumHash	string (hex)	Required (exactly 1)	The hash of the quorum
→ newQuorums	array	Required (exactly 1)	An array of new quorums
→ → version	number	Required (exactly 1)	The quorum version
→ → llmqType	number	Required (exactly 1)	The quorum type
→ → quorumHash	string (hex)	Required (exactly 1)	The hash of the quorum
→ → signersCount	number	Required (exactly 1)	The number of signers for the quorum
→ → signers	string (hex)	Required (exactly 1)	Added in Dash Core 0.16.0 Bitset representing the aggregated signers of this final commitment
→ → validMembersCount	number	Required (exactly 1)	The number of valid members in the quorum
→ → validMembers	string (hex)	Required (exactly 1)	Added in Dash Core 0.16.0 Bitset of valid members in this commitment
→ → quorumPublicKey	string (hex)	Required (exactly 1)	The public key of the quorum
→ → quorumVvecHash	string (hex)	Required (exactly 1)	Added in Dash Core 0.16.0 The SHA256 hash of the quorum verification vector
→ → quorumSig	string (hex)	Required (exactly 1)	Added in Dash Core 0.16.0 Recovered threshold signature
→ → membersSig	string (hex)	Required (exactly 1)	Added in Dash Core 0.16.0 Aggregated BLS signatures from all included commitments
→ merkleRootMNList	string (hex)	Required (exactly 1)	Merkle root of the masternode list
→ merkleRootQuorums	string (hex)	Required (exactly 1)	Added in Coinbase Transaction version 2 (Dash Core 0.14.0) Merkle root of the masternode list

Example from Dash Core 0.16.0

Bash

dash-cli -testnet protx diff 75000 76000

Result (truncated):

JSON

{
  "baseBlockHash": "0000000003deb00bba101ee581cdc4e1cbd1243ec5cd190472ae93eff07c8881",
  "blockHash": "0000000000c0279636003ed0042c9a454b4c39e9a6c49bb92d420e0bf4e0f49b",
  "cbTxMerkleTree": "01000000015ef8245e2a381174f5e2cc701d5d067d9f16945179380a3ce54415114426eb510101",
  "cbTx": "03000500010000000000000000000000000000000000000000000000000000000000000000ffffffff4c03e02801043619ab5c08fabe6d6d736170747365743a7265737574736574d6e48c2ebd4e147373617074736574730100000000000000380000ae250000000d2f6e6f64655374726174756d2f000000000340230e43000000001976a914cb594917ad4e5849688ec63f29a0f7f3badb5da688ac4cfe1c3e000000001976a91470da282ad16926e127064b7d3d787d7f3793014788acf424f104000000001976a914312d9ccd4e73f2e66006e45701bce17125ba681e88ac00000000260100e0280100d26df127ba2765c8f098ab71199c82c59509418efe26cdf02f7c92ce738e2247",
  "deletedMNs": [
  ],
  "mnList": [
    {
      "proRegTxHash": "fef106ff6420f9c6638c9676988a8fc655750caafb506c98cb5ff3d4fea99a41",
      "confirmedHash": "0000000005d5635228f113b50fb5ad66995a7476ed20374e6e159f1f9e62347b",
      "service": "45.48.177.222:19999",
      "pubKeyOperator": "842476e8d82327adfb9b617a7ac3f62868946c0c4b6b0e365747cfb8825b8b79ba0eb1fa62e8583ae7102f59bf70c7c7",
      "votingAddress": "yf7QHemCfbmKEncwZxroTj8JtShXsC28V6",
      "isValid": true
    },
    {
      "proRegTxHash": "7d56a2cf814b344f54ac4b6485a7a5b2b5a439ea796defff67f2a5872c9df5c3",
      "confirmedHash": "00000c66555eea6272e5c7bcdb2648e1a63fd5b23a6d1d4c3f9dc5df43c6a5a8",
      "service": "178.151.192.107:19999",
      "pubKeyOperator": "8631b1ba19ed23fdab61db7a81c9aa1356eaf37d0a29a14cc493e2f863080bf909b4d3e23d536be1d18e4c842566ed67",
      "votingAddress": "yP2LXCZTVVjBFQiN2bhghQvNwdUQG8NMX8",
      "isValid": true
    },
    {
      "proRegTxHash": "be32ec53dbbfb64e5ba29e25e3716f6f4024291914ce4c858cd69f0b4e371dda",
      "confirmedHash": "0000000015717296254a7c6139a50c34ad481dc8fdf7b0ea4c8320dc3fff2759",
      "service": "173.61.30.231:19025",
      "pubKeyOperator": "86ce02e551a46f1ca9a734104b4e387984d733ba99930eb677aae126fa142f201049842422ab2f105e3c9805f1bd54e8",
      "votingAddress": "ySBU7oXuuTSJqtmUArMRFsKefJPtEDkESG",
      "isValid": false
    }
  ],
  "deletedQuorums": [
    {
      "llmqType": 1,
      "quorumHash": "00000000052b95b036c87f82d19878f69bf940e6acf9f03cd818bd07a5686d0e"
    },
    {
      "llmqType": 1,
      "quorumHash": "0000000000e8b557ea26921f4bb143e961dd35209cf8c1c7b73397322c1a5018"
    },
    {
      "llmqType": 1,
      "quorumHash": "000000000b259f422fe3b647b8f1553b846d95dc8c79699d60e48a81dcf14747"
    },
    {
      "llmqType": 1,
      "quorumHash": "00000000143365adb3c3de6a35ae247120df8ca53a61afd82cd6fd4126ca8a4d"
    }
  ],
  "newQuorums": [
    {
      "version": 1,
      "llmqType": 1,
      "quorumHash": "0000000001427858db64213ed3ef32ffb2546ca7f2a096adbefc197437b90612",
      "signersCount": 50,
      "signers": "ffffffffffff03",
      "validMembersCount": 50,
      "validMembers": "ffffffffffff03",
      "quorumPublicKey": "922e3683358f09a2619efb9e8329f90d5a8a608a18e26db212613ef7f95818eb6f68372fb313edbf96fdd2cdee20a66d",
      "quorumVvecHash": "2da4253e43adb732b06d88324384025a4cd0c2803bc6400462f9eb89ea314da8",
      "quorumSig": "949882d7912d7d3fef46dd856bcd6c70a080b2e5484a3c900bea04b902abd12c5f75e78d13cbdc5d352187db0e15c1b40715b9d89e998bb99437ad7ae97a1b23f922d55b6fc5cca290c05b44eda564782a3440c7ef3756fc3e9895d1ac34d3d0",
      "membersSig": "9736d9cbc7ff7189f6ef543fabc9bfc2785f60ffd4493ea4c272343da51fa61ec9867cd46b681c82a1c22a9830f8b86b0a02e34e9e71212010231024fd61cb95143591be2cace53760dba03a325e178e5fcae6a748073fadf3ab34268c8ed2bc"
    },
    {
      "version": 1,
      "llmqType": 1,
      "quorumHash": "000000000148a6fced08763f3f31dd68a3d88d2d4f2d48eef44eb9311de66129",
      "signersCount": 50,
      "signers": "ffffffffffff03",
      "validMembersCount": 50,
      "validMembers": "ffffffffffff03",
      "quorumPublicKey": "814973fcf54892fa4edbf9e732341ff1227e2a89bf59cb22b52082e940f7c3ac8a7c25163cb375b3cfe3654e86eaa65d",
      "quorumVvecHash": "a91c4721c576850971313b9eb5ee7a886fd4dd4564e98ac0094e7a46e4351240",
      "quorumSig": "16abcfa4137c1900899970533cd52b0c264000b48ca6bd1d29cc9baab1ef883b378d5cdb8c1dd8bb7765e154bcc8ee360cfcdc008584e2d7c29f5be8361fecf3a4cafcdea29f1cb2e75c5d67057d0557e0d6cfa65cf85ae6ed65971b8f29a913",
      "membersSig": "18151a0b15e9ec892ae7ebc97b9e014bbe8a7f8344d24fe9f2925dae094e01500c6d5eb13b1ac6a8487be63e181a2b73053658f6b6374a01d183be1d4258ddaf0b18a4268a8a1e7d0c7ecfa414ad075d915beff5750d8ecef48b446b9c0d1da6"
    },
    {
      "version": 1,
      "llmqType": 1,
      "quorumHash": "0000000009931a8a6dcdf21a869739356e7715eb155c1a18a58c8bf13382ac33",
      "signersCount": 50,
      "signers": "ffffffffffff03",
      "validMembersCount": 50,
      "validMembers": "ffffffffffff03",
      "quorumPublicKey": "0694b46d8581423f2f68196dcc2d06be0b6b365a4100b54e351ab42f5828d09fd03941f8a1255363753a53d32b43f63b",
      "quorumVvecHash": "e0f2853af9fffc937af96264316982728fbbe483a36bff161c606f764ad9d8b9",
      "quorumSig": "16898292e519f01681c1a57606c54b7366275fa01a4912f8623eae73517ae1d3fd1607b7e8edcee43ce23141deba29fb00398d60f319adca9d460b972653715a4c5025a92141f065d92a0494cf211aa7485d6e4819514012efb107e8e2b9ba2e",
      "membersSig": "884a01e0ed65b745076198183883535d7bf636c7ebf9e13deb662ec4f4b202041fa826c978c9973380d614d11fd4071e0cf97abb3a7dd3a24f2eda0d8d7b179ab1a5837a78c53673567565aa3aaa72122d0e0bb8b6f2df092ca3da626c2b2800"
    },
    {
      "version": 1,
      "llmqType": 1,
      "quorumHash": "0000000006097e9d08a4ca9bedbe4a97bb9bf3fe8d09372d18d2398f185cff5d",
      "signersCount": 50,
      "signers": "ffffffffffff03",
      "validMembersCount": 50,
      "validMembers": "ffffffffffff03",
      "quorumPublicKey": "10d0488558afd929508cd2d11bda7564333a904aa23c8b4a1ed57d86b217e3181497469e7220e9421e14f645a00940fc",
      "quorumVvecHash": "fbe6b3ae8d002bd648788b3173753c9cec3d4634b7df55f19b34d632b438aa70",
      "quorumSig": "17d3c06ae24312c9cda1b0f5db10b16e1d1a356f6bb050827d066c5026ecd3cd26fbd2479d781c88a2755aa78f9e16a50882bf18c75e1ab96ff1514b1f283d4fb3b10b4dcd13f8f267ec449250e7d195bc27351a74c8c456a6fcf7d847535f05",
      "membersSig": "0afd25e67d72d59c2dfbc671ae4e8163bfa2e75cda50b0c86800be5e1dd393abf8a717b147392688855f505d237154f8195b2bb30605d0ca18407e4552b7573cb08a6cb53eaf2a71894fb937af1f7783dbf5e6cb80b0cb903ea4f76266c039e7"
    }
  ],
  "merkleRootMNList": "47228e73ce927c2ff0cd26fe8e410995c5829c1971ab98f0c86527ba27f16dd2"
}

See also: none

ProTx Info

The protx info RPC returns detailed information about a deterministic masternode.

Name	Type	Presence	Description
result	object	Required (exactly 1)	An JSON object containing a provider transaction, or JSON null if an error occurred
Provider Transaction	object/null	Required (exactly 1)	An object containing a provider transaction
→ proTxHash	string (hex)	Required (exactly 1)	The hash of the provider transaction as hex in RPC byte order
→ collateralHash	string (hex)	Required (exactly 1)	The hash of the collateral transaction as hex in RPC byte order
→ collateralIndex	number (int)	Required (exactly 1)	The collateral index
→ → collateralAddress	string (hex)	Required (exactly 1)	The collateral address
→ operatorReward	number (int)	Required (exactly 1)	The operator reward %
→ state	object/null	Required (exactly 1)	An object containing a provider transaction state
→ → service	string	Required (exactly 1)	The masternode's IP:Port
→ → registeredHeight	number (int)	Required (exactly 1)	The height where the masternode was registered
→ → lastPaidHeight	number (int)	Required (exactly 1)	The height where the masternode was last paid
→ → PoSePenalty	number (int)	Required (exactly 1)	The masternode's proof of service penalty
→ → PoSeRevivedHeight	number (int)	Required (exactly 1)	The height where the masternode recovered from a proof of service ban
→ → PoSeBanHeight	number (int)	Required (exactly 1)	The height where the masternode was banned for proof of service violations
→ → revocationReason	number (int)	Required (exactly 1)	The reason for a ProUpRegTx revocation
→ → ownerAddress	string (hex)	Required (exactly 1)	The owner address
→ → votingAddress	string (hex)	Required (exactly 1)	The voting address
→ → payoutAddress	string (hex)	Required (exactly 1)	The owner's payout address
→ → pubKeyOperator	string (hex)	Required (exactly 1)	The operator public key
→ → operatorPayoutAddress	string (hex)	Required (exactly 1)	The operator's payout address
→ confirmations	number (int)	Required (exactly 1)	The number of confirmations this ProTx has
→ wallet	object/null	Required (exactly 1)	An object containing a wallet details related to this ProTx
→ → hasOwnerKey	bool	Required (exactly 1)	The owner key is present in this wallet
→ → hasOperatorKey	bool	Required (exactly 1)	The operator key is present in this wallet
→ → hasVotingKey	bool	Required (exactly 1)	The voting key is present in this wallet
→ → ownsCollateral	bool	Required (exactly 1)	The collateral is owned by this wallet
→ → ownsPayeeScript	bool	Required (exactly 1)	The payee script is owned by this wallet
→ → ownsOperatorRewardScript	bool	Required (exactly 1)	The operator reward script is owned by this wallet
→ metaInfo	object/null	Required (exactly 1)	Added in Dash Core 0.16.0 An object containing a metainfo related to this ProTx
→ → lastDSQ	string	Required (exactly 1)	The owner key is present in this wallet
→ → mixingTxCount	string	Required (exactly 1)	The operator key is present in this wallet
→ → lastOutboundAttempt	integer	Required (exactly 1)	Unix epoch time of the last outbound attempted
→ → lastOutboundAttemptElapsed	integer	Required (exactly 1)	Elapsed time since last outbound attempt
→ → lastOutboundSuccess	integer	Required (exactly 1)	Unix epoch time of the last successful outbound connection
→ → lastOutboundSuccessElapsed	integer	Required (exactly 1)	Elapsed time since last successful outbound attempt

Example from Dash Core 0.16.0

Bash

dash-cli -testnet protx info\
 c48a44a9493eae641bea36992bc8c27eaaa33adb1884960f55cd259608d26d2f

Result:

JSON

{
  "proTxHash": "c48a44a9493eae641bea36992bc8c27eaaa33adb1884960f55cd259608d26d2f",
  "collateralHash": "e3270ff48c4b802d56ee58d3d53777f7f9c289964e4df0842518075fc81345b1",
  "collateralIndex": 3,
  "collateralAddress": "yYpzTXjVx7A5uohsmW8sRy7TJp4tihVuZg",
  "operatorReward": 0,
  "state": {
    "service": "173.61.30.231:19013",
    "registeredHeight": 7090,
    "lastPaidHeight": 134608,
    "PoSePenalty": 334,
    "PoSeRevivedHeight": 96516,
    "PoSeBanHeight": 134819,
    "revocationReason": 0,
    "ownerAddress": "yTMDce5yEpiPqmgPrPmTj7yAmQPJERUSVy",
    "votingAddress": "yTMDce5yEpiPqmgPrPmTj7yAmQPJERUSVy",
    "payoutAddress": "yU3UdrmS6KpWwBDLQTkp1KjXePwWsMbYdj",
    "pubKeyOperator": "8700add55a28ef22ec042a2f28e25fb4ef04b3024a7c56ad7eed4aebc736f312d18f355370dfb6a5fec9258f464b227e"
  },
  "confirmations": 292831,
  "wallet": {
    "hasOwnerKey": false,
    "hasOperatorKey": false,
    "hasVotingKey": false,
    "ownsCollateral": false,
    "ownsPayeeScript": false,
    "ownsOperatorRewardScript": false
  },
  "metaInfo": {
    "lastDSQ": 0,
    "mixingTxCount": 0,
    "lastOutboundAttempt": 0,
    "lastOutboundAttemptElapsed": 1588171300,
    "lastOutboundSuccess": 0,
    "lastOutboundSuccessElapsed": 1588171300
  }
}

ProTx List

The protx list RPC returns a list of provider transactions.

Lists all ProTxs in your wallet or on-chain, depending on the given type. If
type is not specified, it defaults to registered. All types have the optional
argument detailed which if set to true will result in a detailed list being
returned. If set to false, only the hashes of the ProTx will be returned.

Parameter #1---type

Name	Type	Presence	Description
type	string	Optional (0 or 1)	The type of ProTxs to list: registered - all ProTxs registered at height valid - all active/valid ProTxs at height wallet - all ProTxs found in the current wallet Height defaults to current chain-tip if one is not provided

Parameter #2---detailed

Name	Type	Presence	Description
detailed	bool	Optional (0 or 1)	If set to false (default), only ProTx hashes are returned. If set to true, a detailed list of ProTx details is returned.

Parameter #3---height

Name	Type	Presence	Description
height	bool	Optional (0 or 1)	List ProTxs from this height (default: current chain tip).

Result (if detailed was false)---provider registration transaction hash

Name	Type	Presence	Description
result	string (hex): array	Required (exactly 1)	Array of provider transaction (ProTx) hashes

Result (if detailed was true)---JSON provider registration transaction details

Name	Type	Presence	Description
result	array	Required (exactly 1)	An array of objects each containing a provider transaction, or JSON null if an error occurred
Provider Transaction	object/null	Required (exactly 1)	An object containing a provider transaction
→ proTxHash	string (hex)	Required (exactly 1)	The hash of the provider transaction as hex in RPC byte order
→ collateralHash	string (hex)	Required (exactly 1)	The hash of the collateral transaction as hex in RPC byte order
→ collateralIndex	number (int)	Required (exactly 1)	The collateral index
→ → collateralAddress	string (hex)	Required (exactly 1)	The collateral address
→ operatorReward	number (int)	Required (exactly 1)	The operator reward %
→ state	object/null	Required (exactly 1)	An object containing a provider transaction state
→ → service	string	Required (exactly 1)	The masternode's IP:Port
→ → registeredHeight	number (int)	Required (exactly 1)	The height where the masternode was registered
→ → lastPaidHeight	number (int)	Required (exactly 1)	The height where the masternode was last paid
→ → PoSePenalty	number (int)	Required (exactly 1)	The masternode's proof of service penalty
→ → PoSeRevivedHeight	number (int)	Required (exactly 1)	The height where the masternode recovered from a proof of service ban
→ → PoSeBanHeight	number (int)	Required (exactly 1)	The height where the masternode was banned for proof of service violations
→ → revocationReason	number (int)	Required (exactly 1)	The reason for a ProUpRegTx revocation
→ → ownerAddress	string (hex)	Required (exactly 1)	The owner address
→ → votingAddress	string (hex)	Required (exactly 1)	The voting address
→ → payoutAddress	string (hex)	Required (exactly 1)	The owner's payout address
→ → pubKeyOperator	string (hex)	Required (exactly 1)	The operator public key
→ → operatorPayoutAddress	string (hex)	Required (exactly 1)	The operator's payout address
→ confirmations	number (int)	Required (exactly 1)	The number of confirmations this ProTx has
→ wallet	object/null	Required (exactly 1)	An object containing a wallet details related to this ProTx
→ → hasOwnerKey	bool	Required (exactly 1)	The owner key is present in this wallet
→ → hasOperatorKey	bool	Required (exactly 1)	The operator key is present in this wallet
→ → hasVotingKey	bool	Required (exactly 1)	The voting key is present in this wallet
→ → ownsCollateral	bool	Required (exactly 1)	The collateral is owned by this wallet
→ → ownsPayeeScript	bool	Required (exactly 1)	The payee script is owned by this wallet
→ → ownsOperatorRewardScript	bool	Required (exactly 1)	The operator reward script is owned by this wallet
→ metaInfo	object/null	Required (exactly 1)	Added in Dash Core 0.16.0 An object containing a metainfo related to this ProTx
→ → lastDSQ	string	Required (exactly 1)	The owner key is present in this wallet
→ → mixingTxCount	string	Required (exactly 1)	The operator key is present in this wallet
→ → lastOutboundAttempt	integer	Required (exactly 1)	Unix epoch time of the last outbound attempted
→ → lastOutboundAttemptElapsed	integer	Required (exactly 1)	Elapsed time since last outbound attempt
→ → lastOutboundSuccess	integer	Required (exactly 1)	Unix epoch time of the last successful outbound connection
→ → lastOutboundSuccessElapsed	integer	Required (exactly 1)	Elapsed time since last successful outbound attempt

Example from Dash Core 0.16.0

Bash

dash-cli -testnet protx list

Result:

JSON

[
  "2b4a07a9b04dc42a0c19b85edb60954a27acaadfe3ee21d0171385778f34e1c2",
  "61e6d780178d353940c4cb9b3073ac0c50792bbcf0b15c1750d2028b71e34929",
  "ca193751f3cbed2aa4f1b33b0acc48c7ed8b9a3679858d69cf23157a4f545176",
  "ba1b3330e16a0876b7a186e7ceb689f03ec646e611e91d7139de021bbf13afdd"
]

List of ProTxs which are active/valid at the given chain height.

Bash

dash-cli -testnet protx list valid false 7090

Result:

JSON

[
  "c48a44a9493eae641bea36992bc8c27eaaa33adb1884960f55cd259608d26d2f"
]

Detailed list of ProTxs which are active/valid at the given chain height.

Bash

dash-cli -testnet protx list valid true 7090

Result:

JSON

[
  {
    "proTxHash": "c48a44a9493eae641bea36992bc8c27eaaa33adb1884960f55cd259608d26d2f",
    "collateralHash": "e3270ff48c4b802d56ee58d3d53777f7f9c289964e4df0842518075fc81345b1",
    "collateralIndex": 3,
    "collateralAddress": "yYpzTXjVx7A5uohsmW8sRy7TJp4tihVuZg",
    "operatorReward": 0,
    "state": {
      "service": "173.61.30.231:19013",
      "registeredHeight": 7090,
      "lastPaidHeight": 0,
      "PoSePenalty": 0,
      "PoSeRevivedHeight": -1,
      "PoSeBanHeight": -1,
      "revocationReason": 0,
      "ownerAddress": "yTMDce5yEpiPqmgPrPmTj7yAmQPJERUSVy",
      "votingAddress": "yTMDce5yEpiPqmgPrPmTj7yAmQPJERUSVy",
      "payoutAddress": "yU3UdrmS6KpWwBDLQTkp1KjXePwWsMbYdj",
      "pubKeyOperator": "8700add55a28ef22ec042a2f28e25fb4ef04b3024a7c56ad7eed4aebc736f312d18f355370dfb6a5fec9258f464b227e"
    },
    "confirmations": 292830,
    "wallet": {
      "hasOwnerKey": false,
      "hasOperatorKey": false,
      "hasVotingKey": false,
      "ownsCollateral": false,
      "ownsPayeeScript": false,
      "ownsOperatorRewardScript": false
    },
    "metaInfo": {
      "lastDSQ": 0,
      "mixingTxCount": 0,
      "lastOutboundAttempt": 0,
      "lastOutboundAttemptElapsed": 1588171141,
      "lastOutboundSuccess": 0,
      "lastOutboundSuccessElapsed": 1588171141
    }
  }
]

ProTx Register

The protx register RPC creates a ProRegTx referencing an existing collateral and and sends it to the network.

Parameter #1---collateral address

Name	Type	Presence	Description
collateralHash	string (hex)	Required (exactly 1)	The collateral transaction hash

Parameter #2---collateral index

Name	Type	Presence	Description
collateralIndex	string (hex)	Required (exactly 1)	The collateral transaction output index

Parameter #3---IP Address and port

Name	Type	Presence	Description
ipAndPort	string	Required (exactly 1)	IP and port in the form IP:PORT. Must be unique on the network. Can be set to 0, which will require a ProUpServTx afterwards.

Parameter #4---owner address

Name	Type	Presence	Description
ownerAddress	string (hex)	Required (exactly 1)	The Dash address to use for payee updates and proposal voting. The corresponding private key does not have to be known by this wallet. The address must be unused and must differ from the collateralAddress.

Parameter #5---operator public key

Name	Type	Presence	Description
operatorPubKey	string (hex)	Required (exactly 1)	The operator public key. The private key does not have to be known. It has to match the private key which is later used when operating the masternode.

Parameter #6---voting address

Name	Type	Presence	Description
votingAddress	string (hex)	Required (exactly 1)	The voting address. The private key does not have to be known by your wallet. It has to match the private key which is later used when voting on proposals. If set to an empty string, ownerAddress will be used.

Parameter #7---operator reward

Name	Type	Presence	Description
operatorReward	number	Required (exactly 1)	The fraction in % to share with the operator. The value must be between 0.00 and 100.00. Note: If non-zero, ipAndPort must be zero as well.

Parameter #8---payout address

Name	Type	Presence	Description
payoutAddress	string	Required (exactly 1)	The Dash address to use for masternode reward payments.

Parameter #9---fee source address

Name	Type	Presence	Description
feeSourceAddress	string	Optional (0 or 1)	If specified, the wallet will only use coins from this address to fund the ProTx. If not specified, payoutAddress will be used. The private key belonging to this address must be known in your wallet.

Parameter #10---whether to submit to the network or not

Name	Type	Presence	Description
submit	bool	Optional (0 or 1)	If true (default), the resulting transaction is sent to the network.

Result if submit is not set or set to true---provider registration transaction hash

Name	Type	Presence	Description
result	string (hex)	Required (exactly 1)	Provider registration transaction (ProRegTx) hash

Example from Dash Core 0.13.0

Bash

dash-cli -testnet protx register\
 8b2eab3413abb6e04d17d1defe2b71039ba6b6f72ea1e5dab29bb10e7b745948 1\
 2.3.4.5:2345 yNLuVTXJbjbxgrQX5LSMi7hV19We8hT2d6\
 88d719278eef605d9c19037366910b59bc28d437de4a8db4d76fda6d6985dbdf10404fb9bb5cd0e8c22f4a914a6c5566\
 yNLuVTXJbjbxgrQX5LSMi7hV19We8hT2d6 5 yjJJLkYDUN6X8gWjXbCoKEXoiLeKxxMMRt

Result:

Text

61e6d780178d353940c4cb9b3073ac0c50792bbcf0b15c1750d2028b71e34929

Result if submit set to false---serialized and signed provider registration transaction

Name	Type	Presence	Description
result	string (hex)	Required (exactly 1)	Serialized and signed provider registration transaction (ProRegTx)

Example from Dash Core 0.17.0

Bash

dash-cli -testnet protx register\ 
b16e6f6ac71d16a8be46a78491bbdba20910287f59471a46514b88d7203bac6b 1 2.3.4.5:2345\ 
yNLuVTXJbjbxgrQX5LSMi7hV19We8hT2d6\ 
8ae227ffcbd4cbdc7ae2fe3e63264701ef6af1de71e6cade51867ecb7ed58b63862568522bab933987d0d043fa5590e1\ 
yNLuVTXJbjbxgrQX5LSMi7hV19We8hT2d6 5 yjJJLkYDUN6X8gWjXbCoKEXoiLeKxxMMRt\ 
yUYTxqjpCfAAK4vgxXtBPywRBtZqsxN7Vy false

Result:

Text

0300010001fe1caa50e5b8181be868fbd9fbd93affeb6c4a91a3c73373a6b25d548c7e6d41010000\
006b48304502210081d206a8332d5b8715ca831155ef5c7e339d33cde2b0b27310b95aafc8c560f9\
02204029d00d2b5515565321ec1fd6748fa0544b7356d9a389e4d1ce6ab4bb64d364012103c67d86\
944315838aea7ec80d390b5d09b91b62483370d4979da5ccf7a7df77a9feffffff01a6f0433e0000\
00001976a9145a375814e9caf5b8575a8221be246457e5c5c28d88ac00000000fd12010100000000\
006bac3b20d7884b51461a47597f281009a2dbbb9184a746bea8161dc76a6f6eb101000000000000\
00000000000000ffff0203040509291636e84d02310b0b458f3eb51d8ea8b2e684b7ce8ae227ffcb\
d4cbdc7ae2fe3e63264701ef6af1de71e6cade51867ecb7ed58b63862568522bab933987d0d043fa\
5590e11636e84d02310b0b458f3eb51d8ea8b2e684b7cef4011976a914fc136008111fcc7a05be6c\
ec66f97568727a9e5188acb3ccf680086ae11217236efcccd67b0b72e83c79a043d6c6d064378fdd\
5f21204120fac89c76d3f116d95a675e112ddbdbb7a78f957506299fe592662acd44b46f262d1c4d\
47d9401e0a569a5488728e09542d0545ab56f8249a4b21e03445fa411e

ProTx Register Fund

The protx register_fund RPC creates and funds a ProRegTx with the 1,000 DASH necessary for a masternode and then sends it to the network.

Parameter #1---collateral address

Name	Type	Presence	Description
collateralAddress	string (hex)	Required (exactly 1)	The Dash address to send the collateral to

Parameter #2---IP Address and port

Name	Type	Presence	Description
ipAndPort	string	Required (exactly 1)	IP and port in the form IP:PORT. Must be unique on the network. Can be set to 0, which will require a ProUpServTx afterwards.

Parameter #3---owner address

Name	Type	Presence	Description
ownerAddress	string (hex)	Required (exactly 1)	The Dash address to use for payee updates and proposal voting. The corresponding private key does not have to be known by this wallet. The address must be unused and must differ from the collateralAddress.

Parameter #4---operator public key

Name	Type	Presence	Description
operatorPubKey	string (hex)	Required (exactly 1)	The operator public key. The private key does not have to be known. It has to match the private key which is later used when operating the masternode.

Parameter #5---voting address

Name	Type	Presence	Description
votingAddress	string (hex)	Required (exactly 1)	The voting address. The private key does not have to be known by your wallet. It has to match the private key which is later used when voting on proposals. If set to an empty string, ownerAddress will be used.

Parameter #6---operator reward

Name	Type	Presence	Description
operatorReward	number	Required (exactly 1)	The fraction in % to share with the operator. The value must be between 0.00 and 100.00.

Parameter #7---payout address

Name	Type	Presence	Description
payoutAddress	string	Required (exactly 1)	The Dash address to use for masternode reward payments.

Parameter #8---fund address

Name	Type	Presence	Description
fundAddress	string	Optional (0 or 1)	If specified, the wallet will only use coins from this address to fund the ProTx. If not specified, payoutAddress will be used. The private key belonging to this address must be known in your wallet.

Parameter #9---whether to submit to the network or not

Name	Type	Presence	Description
submit	bool	Optional (0 or 1)	If true (default), the resulting transaction is sent to the network.

Result if submit is not set or set to true---provider registration transaction hash

Name	Type	Presence	Description
result	string (hex)	Required (exactly 1)	Provider registration transaction (ProRegTx) hash

Example from Dash Core 0.13.0

Bash

dash-cli -testnet protx register_fund yakx4mMRptKhgfjedNzX5FGQq7kSSBF2e7\
 3.4.5.6:3456 yX2cDS4kcJ4LK4uq9Hd4TG7kURV3sGLZrw\
 0e02146e9c34cfbcb3f3037574a1abb35525e2ca0c3c6901dbf82ac591e30218d1711223b7ca956edf39f3d984d06d51\
 yX2cDS4kcJ4LK4uq9Hd4TG7kURV3sGLZrw 5 yakx4mMRptKhgfjedNzX5FGQq7kSSBF2e7

Result:

Text

ba1b3330e16a0876b7a186e7ceb689f03ec646e611e91d7139de021bbf13afdd

Result if submit set to false---serialized and signed provider registration transaction

Name	Type	Presence	Description
result	string (hex)	Required (exactly 1)	Serialized and signed provider registration transaction (ProRegTx)

Example from Dash Core 0.17.0

Bash

dash-cli -testnet protx register_fund yNLuVTXJbjbxgrQX5LSMi7hV19We8hT2d6\ 
3.4.5.6:3456 yURczr3qY31xkQZfFu8eZvKz19eAEPQxsd\ 
0e02146e9c34cfbcb3f3037574a1abb35525e2ca0c3c6901dbf82ac591e30218d1711223b7ca956edf39f3d984d06d51\
yURczr3qY31xkQZfFu8eZvKz19eAEPQxsd 5 yUYTxqjpCfAAK4vgxXtBPywRBtZqsxN7Vy\ 
yRMFHxcJ2aS2vfo5whhE2Gg73dfQVm8LAF 0

Result:

Text

030001000156701575e76bca5720fa364ea6efc4b713279710dd1b8906797d18bd7048b71a010000\
006b4830450221009178a387b3d82e3606e6484373508ef1ed4c1d7d98f8a0ca0851687c59edacaa\
02204d245d20689b5be1100536faaadbb1781e3a67a55e9ecc613adb2a34f419c3cd012103109325\
a92f9e6d31d2ebd0595d471275ae8d635db2a0c42358f387e1af69c14dfeffffff0200e876481700\
00001976a9141636e84d02310b0b458f3eb51d8ea8b2e684b7ce88ac8c7a918b300000001976a914\
372fd07f715c33ce88873a8e758d890e017cf02588ac00000000d101000000000000000000000000\
000000000000000000000000000000000000000000000000000000000000000000000000000000ff\
ff030405060d8058ebf95961c207ebd525793ccb43f60ce34a5cd50e02146e9c34cfbcb3f3037574\
a1abb35525e2ca0c3c6901dbf82ac591e30218d1711223b7ca956edf39f3d984d06d5158ebf95961\
c207ebd525793ccb43f60ce34a5cd5f4011976a9145a375814e9caf5b8575a8221be246457e5c5c2\
8d88ac45084a0f63d6f06767c941ffd5af4ed17ea0e28afa481e46b2bdbadbd8446c8c00\

ProTx Register Prepare

The protx register_prepare RPC creates an unsigned ProTx and a message that must be signed externally with the private key that corresponds to collateralAddress to prove collateral ownership. The prepared transaction will also contain inputs and outputs to cover fees. The ProTx must be passed to protx register_submit.

Parameter #1---collateral address

Name	Type	Presence	Description
collateralHash	string (hex)	Required (exactly 1)	The collateral transaction hash

Parameter #2---collateral index

Name	Type	Presence	Description
collateralIndex	string (hex)	Required (exactly 1)	The collateral transaction output index

Parameter #3---IP Address and port

Name	Type	Presence	Description
ipAndPort	string	Required (exactly 1)	IP and port in the form 'IP:PORT'. Must be unique on the network. Can be set to '0', which will require a ProUpServTx afterwards.

Parameter #4---owner address

Name	Type	Presence	Description
ownerAddress	string (hex)	Required (exactly 1)	The Dash address to use for payee updates and proposal voting. The corresponding private key does not have to be known by this wallet. The address must be unused and must differ from the collateralAddress.

Parameter #5---operator public key

Name	Type	Presence	Description
operatorPubKey	string (hex)	Required (exactly 1)	The operator public key. The private key does not have to be known. It has to match the private key which is later used when operating the masternode.

Parameter #6---voting address

Name	Type	Presence	Description
votingAddress	string (hex)	Required (exactly 1)	The voting address. The private key does not have to be known by your wallet. It has to match the private key which is later used when voting on proposals. If set to an empty string, ownerAddress will be used.

Parameter #7---operator reward

Name	Type	Presence	Description
operatorReward	number	Required (exactly 1)	The fraction in % to share with the operator. The value must be between '0.00' and '100.00'.

Parameter #8---payout address

Name	Type	Presence	Description
payoutAddress	string (hex)	Required (exactly 1)	The Dash address to use for masternode reward payments.

Parameter #9---fee source address

Name	Type	Presence	Description
feeSourceAddress	string	Optional (0 or 1)	If specified, the wallet will only use coins from this address to fund the ProTx. If not specified, payoutAddress will be used. The private key belonging to this address must be known in your wallet.

Result---unsigned transaction and message to sign

Name	Type	Presence	Description
result	object	Required (exactly 1)	JSON object containing an unsigned provider transaction and the message to be signed externally, or JSON null if an error occurred
→ tx	string (hex)	Required (exactly 1)	The serialized unsigned ProRegTx in hex format
→ collateralAddress	string (hex)	Required (exactly 1)	The collateral address
→ signMessage	string (base64)	Required (exactly 1)	The string message that needs to be signed with the collateral key.

Example from Dash Core 0.13.0

Bash

dash-cli -testnet protx register_prepare\
 df41e398bb245e973340d434d386f431dbd69735a575721b0b6833856e7d31ec 1 \
 9.8.7.6:9876 yemjhGQ99V5ayJMjoyGGPtxteahii6G1Jz\
 06849865d01e4f73a6d5a025117e48f50b897e14235800501c8bfb8a6365cc8dbf5ddb67a3635d0f1dcc7d46a7ee280c\
 yemjhGQ99V5ayJMjoyGGPtxteahii6G1Jz 1.2 yjJJLkYDUN6X8gWjXbCoKEXoiLeKxxMMRt

Result:

JSON

{
  "tx": "0300010001912b88876fee2f8e43e23b5e81276c163cf23d867bad4148170cb106ef9023700000000000feffffff0125623ba40b0000001976a914736e155c1039a269d4019c66219d2a18f0fee27588ac00000000d1010000000000ec317d6e8533680b1b7275a53597d6db31f486d334d44033975e24bb98e341df0100000000000000000000000000ffff090807062694ca6b243168b30461d1f19e2bb89a965a5bac067e06849865d01e4f73a6d5a025117e48f50b897e14235800501c8bfb8a6365cc8dbf5ddb67a3635d0f1dcc7d46a7ee280cca6b243168b30461d1f19e2bb89a965a5bac067e78001976a914fc136008111fcc7a05be6cec66f97568727a9e5188ace5f6b70ac55411727e25178bd417b9b03f837ad7155d90ad286f3a427203fb9f00",
  "collateralAddress": "yWuKWhDzGQqZL8rw6kGxGrfe6P8bUC2S4f",
  "signMessage": "yjJJLkYDUN6X8gWjXbCoKEXoiLeKxxMMRt|120|yemjhGQ99V5ayJMjoyGGPtxteahii6G1Jz|yemjhGQ99V5ayJMjoyGGPtxteahii6G1Jz|69a49e18c1253b90d39322f7e2f7af74524401bc33a27645e697e74a214e3e1e"
}

ProTx Register Submit

The protx register_submit RPC combines the unsigned ProTx and a signature of the signMessage, signs all inputs which were added to cover fees and submits the resulting transaction to the network. Note: See protx register_prepare for more info about creating a ProTx and a message to sign.

Parameter #1---collateral address

Name	Type	Presence	Description
tx	string (hex)	Required (exactly 1)	The serialized unsigned transaction previously returned by protx register_prepare

Parameter #2---collateral index

Name	Type	Presence	Description
sig	string (base64)	Required (exactly 1)	The signature signed with the collateral key. Must be in base64 format.

Result---provider registration transaction hash

Name	Type	Presence	Description
result	string (hex)	Required (exactly 1)	Provider registration transaction (ProRegTx) hash

Example from Dash Core 0.13.0

Bash

dash-cli -testnet protx register_submit\
 03000100012d988526d5d1efd32320023c92eff09c2963dcb021b0de9761\
 17e5e37dc7a7870000000000feffffff015f603ba40b0000001976a9140c\
 37e07eb5c608961769e6506c23c11e9f9fe00988ac00000000d101000000\
 00002d988526d5d1efd32320023c92eff09c2963dcb021b0de976117e5e3\
 7dc7a7870100000000000000000000000000ffff05060708162e243dd366\
 bf4a329968d77eac9fb63481a600938d125e1b7cba03ca2a097e402185e6\
 160232ea53e6d62898a3be8617b06ff347d967543228bd9b605547c3d478\
 b0a838ca243dd366bf4a329968d77eac9fb63481a600938dc4091976a914\
 e9bf4e6f26fecf1dfc1e04dde43472df378628b888ac6a048e7f645e8adc\
 305ccfd8652066046a0702596af13b8ac97803ade256da2900\
 \
 H90IvqVtFjZkwLJb08yMEgGixs0/FpcdvwImBcir4cYLJhD3pdX+lKD2GsPl6KNxghVXNk5/HpOdBoWAHo9u++Y=

Result:

Text

273ce3ebe24183ee4117b10e054cdbb108a3bde5d2f286129e29480d46a3f573

ProTx Revoke

The protx revoke RPC creates and sends a ProUpRevTx to the network.

Parameter #1---initial provider registration transaction hash

Name	Type	Presence	Description
proTxHash	string (hex)	Required (exactly 1)	The hash of the provider transaction as hex in RPC byte order

Parameter #2---operator private key

Name	Type	Presence	Description
operatorPubKey	string (hex)	Required (exactly 1)	The operator private key belonging to the registered operator public key.

Parameter #3---reason

Name	Type	Presence	Description
reason	number	Required (exactly 1)	The reason for revocation.

Parameter #4---fee source address

Name	Type	Presence	Description
feeSourceAddress	string	Optional (0 or 1)	If specified, the wallet will only use coins from this address to fund the ProTx. If not specified, payoutAddress will be used. The private key belonging to this address must be known in your wallet.

Result---provider update revoke transaction hash

Name	Type	Presence	Description
result	string (hex)	Required (exactly 1)	Provider update revoke transaction (ProUpRevTx) hash

Example from Dash Core 0.13.0

Bash

dash-cli -testnet protx revoke\
 "ba1b3330e16a0876b7a186e7ceb689f03ec646e611e91d7139de021bbf13afdd"\
 "4da7e1ea30fb9e55c73ad23df0b9d3d34342acb24facf4b19420e1a26ae272d1"

Result:

Bash

2aad36dd2ab254bee06b0b5dad51e7603691b72058d5806fd94e1d2d19a7c209

ProTx Update Registrar

The protx update_registrar RPC creates and sends a ProUpRegTx to the network.

Parameter #1---initial provider registration transaction hash

Name	Type	Presence	Description
proTxHash	string (hex)	Required (exactly 1)	The hash of the provider transaction as hex in RPC byte order

Parameter #2---operator public key

Name	Type	Presence	Description
operatorPubKey	string (hex)	Required (exactly 1)	The operator public key. The private key does not have to be known. It has to match the private key which is later used when operating the masternode. If set to an empty string, the currently active operator BLS public key is reused.

Parameter #3---voting address

Name	Type	Presence	Description
votingAddress	string (hex)	Required (exactly 1)	The voting address. The private key does not have to be known by your wallet. It has to match the private key which is later used when voting on proposals. If set to an empty string, the currently active voting key address is reused.

Parameter #4---operator payout address

Name	Type	Presence	Description
payoutAddress	string (hex)	Optional (0 or 1)	The Dash address to use for masternode reward payments. If set to an empty string, the currently active payout address is reused.

Parameter #5---fee source address

Name	Type	Presence	Description
feeSourceAddress	string	Optional (0 or 1)	If specified, the wallet will only use coins from this address to fund the ProTx. If not specified, payoutAddress will be used. The private key belonging to this address must be known in your wallet.

Result---provider update registrar transaction hash

Name	Type	Presence	Description
result	string (hex)	Required (exactly 1)	Provider update registrar transaction (ProUpRegTx) hash

Example from Dash Core 0.13.0

Bash

dash-cli -testnet protx update_registrar\
 "ba1b3330e16a0876b7a186e7ceb689f03ec646e611e91d7139de021bbf13afdd"\
 "0e02146e9c34cfbcb3f3037574a1abb35525e2ca0c3c6901dbf82ac591e30218d1711223b7ca956edf39f3d984d06d51"\
 "yX2cDS4kcJ4LK4uq9Hd4TG7kURV3sGLZrw" "yakx4mMRptKhgfjedNzX5FGQq7kSSBF2e7"

Result:

Bash

702390ef06b10c174841ad7b863df23c166c27815e3be2438e2fee6f87882b91

ProTx Update Service

The protx update_service RPC creates and sends a ProUpServTx to the network.

Parameter #1---initial provider registration transaction hash

Name	Type	Presence	Description
proTxHash	string (hex)	Required (exactly 1)	The hash of the provider transaction as hex in RPC byte order

Parameter #2---IP Address and port

Name	Type	Presence	Description
ipAndPort	string	Required (exactly 1)	IP and port in the form 'IP:PORT'. Must be unique on the network.

Parameter #3---operator key

Name	Type	Presence	Description
operatorKey	string (hex)	Required (exactly 1)	The operator BLS private key associated with the registered operator public key.

Parameter #4---operator payout address

Name	Type	Presence	Description
operatorPayoutAddress	string (hex)	Optional (0 or 1)	The Dash address used for operator reward payments. Only allowed when the ProRegTx had a non-zero operatorReward value. If set to an empty string, the currently active payout address is reused.

Parameter #5---fee source address

Name	Type	Presence	Description
feeSourceAddress	string	Optional (0 or 1)	If specified, the wallet will only use coins from this address to fund the ProTx. If not specified, operatorPayoutAddress will be used. The private key belonging to this address must be known in your wallet.

Result---provider update service transaction hash

Name	Type	Presence	Description
result	string (hex)	Required (exactly 1)	Provider update service transaction (ProUpServTx) hash

Example from Dash Core 0.13.0

Bash

dash-cli -testnet protx update_service\
 ba1b3330e16a0876b7a186e7ceb689f03ec646e611e91d7139de021bbf13afdd\
 "4.3.2.1:4321"\
 4da7e1ea30fb9e55c73ad23df0b9d3d34342acb24facf4b19420e1a26ae272d1

Result:

Bash

5b6cfa1bdd3c8b7e0b9550b9c4e809381f81a410bc7f241d3879dd736fd51270

Quorum

Added in Dash Core 0.14.0

The quorum RPC provides a set of commands for quorums (LLMQs).

Quorum List

The quorum list RPC displays a list of on-chain quorums.

Parameter #1---quorum count

Name	Type	Presence	Description
count	number	Optional (0 or 1)	Number of quorums to list. Will list active quorums if count is not specified.

Result---a list of quorums

Name	Type	Presence	Description
result	object	Required (exactly 1)	Quorum list
→ Quorum	array	Required (1 or more)	Array of quorum details
→ → Quorum Hash	string (hex)	Optional (0 or more)	A quorum hash

Example from Dash Core 0.14.0

Bash

dash-cli -testnet quorum list

Result:

JSON

{
  "llmq_50_60": [
    "00000000023cc6dde69bed898c83fe2328ef38b1ea9da14a599efa14caef0b7d",
    "000000002b968fb3b2fc2ff18d6e89611e366b4d38a6d0437e99bd7c37f2fd83",
    "000000000301054c038b07b5b51493d5efc3f078e3aede6eb603c47943d1cc78",
    "000000000e901278c00c896754a06f8d45d0268c6aff6e72ffb3007d07c10e73",
    "000000001bc592f2a8676203835bc6ad442abeadb9c22b8d6a2999db07354b01",
    "000000000896c37ef8a32318ee871589394f1578473b8825275b610690e47db0",
    "00000000133b192b2319a0716ad18e5788981fff51856f61205af5d6a634ba41",
    "0000000004946f3f9f82a298985f73080d62627d51f6f4ba77f3cd8c6788b3d0",
    "0000000005cb014d3df9bac0ba379f1d5b8b75f0e6d7c408d43ac1db330ec641",
    "0000000006c1653c7ee747f140dd7daa1da23a541e67a0fc0dc88db3482ec4d5"
  ],
  "llmq_400_60": [
    "0000000007697fd69a799bfa26576a177e817bc0e45b9fcfbf48b362b05aeff2"
  ],
  "llmq_400_85": [
  ]
}

Quorum Info

The quorum info RPC returns information about a specific quorum.

Parameter #1---LLMQ Type

Name	Type	Presence	Description
llmqType	number	Required (exactly 1)	Type of quorums to list: 1 - LLMQ_50_60 2 - LLMQ_400_60 3 - LLMQ_400_85 4 - LLMQ_100_67

Parameter #2---quorum hash

Name	Type	Presence	Description
quorumHash	string (hex)	Required (exactly 1)	The block hash of the quorum

Parameter #3---secret key share

Name	Type	Presence	Description
includeSkShare	bool	Optional (0 or 1)	Include the secret key share (default: false)

Result---information about a quorum

Name	Type	Presence	Description
result	object	Required (exactly 1)	Quorum list
→ height	number	Required (exactly 1)	Block height of the quorum
→ type	string	Required (exactly 1)	Type of LLMQ
→ quorumHash	string (hex)	Required (exactly 1)	The hash of the quorum
→ minedBlock	string (hex)	Required (exactly 1)	The hash of the block that established the quorum
→ members	array	Required (exactly 1)	An array containing quorum member details
→ → Member	object	Required (1 or more)	An object describing a particular member
→ → → proTxHash	string (hex)	Required (exactly 1)	The masternode's Provider Registration transaction hash
→ → → pubKeyOperator	string (hex)	Required (exactly 1)	Added in Dash Core 0.15.0 The masternode's Operator public key
→ → → valid	bool	Required (exactly 1)	Indicates if the member is valid
→ → → pubKeyShare	string	Optional (0 or 1)	Member public key share
→ quorumPublicKey	string	Required (exactly 1)	Quorum public key
→ secretKeyShare	string	Optional (exactly 1)	Quorum secret key share

Example from Dash Core 0.15.0

Bash

dash-cli -testnet quorum info 1 \
  000004bfc56646880bfeb80a0b89ad955e557ead7b0f09bcc61e56c8473eaea9 true

Result (truncated):

JSON

{
  "height": 264072,
  "type": "llmq_50_60",
  "quorumHash": "000004bfc56646880bfeb80a0b89ad955e557ead7b0f09bcc61e56c8473eaea9",
  "minedBlock": "000006113a77b35a0ed606b08ecb8e37f1ac7e2d773c365bd07064a72ae9a61d",
  "members": [
    {
      "proTxHash": "6c91363d97b286e921afb5cf7672c88a2f1614d36d32058c34bef8b44e026007",
      "pubKeyOperator": "81749ba8363e5c03e9d6318b0491e38305cf59d9d57cea2295a86ecfa696622571f266c28bacc78666e8b9b0fb2b3121",
      "valid": true
    },
    {
      "proTxHash": "274ae6ab38ea0f3b8fe726b3e52d998443ba0d77e85d88c20d179d4fecd0b96e",
      "pubKeyOperator": "0db6da5d8ee9fb8925f0818df7553062bf35ec9d62114144bc395980c29fcd06b738beca63faf265d7480106fc6cceea",
      "valid": true
    },
    {"Truncated data":"..."},
    {
      "proTxHash": "3ecdbedf3d9a13822f437a1f0c5ea44f290ab90f7c3bb42c1b5fd785b5f9596a",
      "pubKeyOperator": "0634f8b926631cb2b14c81720c6130b3f6f5429da1c9dc9c33918b2474b7ffff239caa9b59c7b1a782565052232d052a",
      "valid": true
    }
  ],
  "quorumPublicKey": "0644ff153b9b92c6a59e2adf4ef0b9836f7f6af05fe432ffdcb69bc9e300a2a70af4a8d9fc61323f6b81074d740033d2",
  "secretKeyShare": "3da0d8f532309660f7f44aa0ed42c1569773b39c70f5771ce5604be77e50759e"
}

Quorum DKGStatus

The quorum list RPC displays the status of the current DKG process.

Parameter #1---detail level

Name	Type	Presence	Description
detail_level	number	Optional (0 or 1)	Detail level of output (default: 0): 0 - Only show counts (default) 1 - Show member indexes 2 - Show member's ProTxHashes Note: Works only when Spork 17 is enabled and only displays details related to the node running the command.

Result (if detail level was 0 or omitted)---JSON DKG details

Name	Type	Presence	Description
result	array	Required (exactly 1)	An array of objects each containing a provider transaction, or JSON null if an error occurred
→ proTxHash	string (hex)	Required (exactly 1)	The hash of the initial provider registration transaction as hex in RPC byte order
→ time	string (hex)	Required (exactly 1)	The Unix epoch time
→ timeStr	string (hex)	Required (exactly 1)	The UTC time as a string
→ session	object	Required (exactly 1)	Object containing DKG Session information
→ → LLMQ Type	object	Required (exactly 1)	Object
→ → → llmqType	number	Required (exactly 1)	Type of quorum: 1 - LLMQ_50_60 2 - LLMQ_400_60 3 - LLMQ_400_85 4 - LLMQ_100_67
→ → → quorumHash	string (hex)	Required (exactly 1)	The block hash of the quorum
→ → → quorumHeight	number	Required (exactly 1)	The block height of the quorum
→ → → phase	number	Required (exactly 1)	The active DKG phase 1 - Initialized 2 - Contributing 3 - Complaining 4 - Justifying 5 - Committing 6 - Finalizing
→ → → sentContributions	bool	Required (exactly 1)	True when contributions have been sent
→ → → sentComplaint	bool	Required (exactly 1)	True when complaints have been sent
→ → → sentJustification	bool	Required (exactly 1)	True when justifications have been sent
→ → → sentPrematureCommitment	bool	Required (exactly 1)	True when premature commitments have been sent
→ → → aborted	bool	Required (exactly 1)	True if the DKG session has been aborted
→ → → badMembers	number	Required (exactly 1)	Number of bad members
→ → → weComplain	number	Required (exactly 1)	Number of complaints sent
→ → → receivedContributions	number	Required (exactly 1)	Number of contributions received
→ → → receivedComplaints	number	Required (exactly 1)	Number of complaints received
→ → → receivedJustifications	number	Required (exactly 1)	Number of justifications received
→ → → receivedPrematureCommitments	number	Required (exactly 1)	Number of premature commitments received
→ minableCommitments	object	Required (exactly 1)	Object containing minable commitments
→ quorumConnections	object	Required (exactly 1)	Added in Dash Core 0.16.0 Object containing quorum connection information
→ → Connection	object	Required (exactly 1)	Added in Dash Core 0.16.0 An object describing a quorum connection
→ → → proTxHash	string (hex)	Required (exactly 1)	Added in Dash Core 0.16.0 The hash of the quorum member's provider registration transaction as hex in RPC byte order
→ → → connected	boolean	Required (exactly 1)	Added in Dash Core 0.16.0 Whether or not the connection is active
→ → → address	string	Optional (exactly 1)	Added in Dash Core 0.16.0 Address
→ → → outbound	boolean	Required (exactly 1)	Added in Dash Core 0.16.0 Whether or not this is an outbound connection

Result (if detail level was 1)---JSON DKG details including member index

Note: detail level 1 includes all level 0 fields and expands the following fields.

Name	Type	Presence	Description
→ → → badMembers	array	Required (exactly 1)	Array containing the member index for each bad member
→ → → weComplain	array	Required (exactly 1)	Array containing the member index for each complaint sent
→ → → receivedContributions	array	Required (exactly 1)	Array containing the member index for each contribution received
→ → → receivedComplaints	array	Required (exactly 1)	Array containing the member index for each complaint received
→ → → receivedJustifications	array	Required (exactly 1)	Array containing the member index for each justification received
→ → → receivedPrematureCommitments	array	Required (exactly 1)	Array containing the member index for each commitment received

Result (if detail level was 2)---JSON DKG details including member index and ProTx hash

Note: detail level 2 includes all level 0 fields, adds the allMembers field, and expands several fields.

Name	Type	Presence	Description
→ → → badMembers	array	Required (exactly 1)	An array of objects with each object containing the member index and ProTx hash for a bad member
→ → → → Member	object	Required (0 or more)	An object describing quorum member details
→ → → → → memberIndex	number	Required (exactly 1)	The quorum member's index
→ → → → → proTxHash	string (hex)	Required (exactly 1)	The hash of the quorum member's provider registration transaction as hex in RPC byte order
→ → → weComplain	object	Required (exactly 1)	An array of objects with each object containing the member index and ProTx hash for a member being complained about
→ → → → Member	object	Required (0 or more)	An object describing quorum member details
→ → → → → memberIndex	number	Required (exactly 1)	The quorum member's index
→ → → → → proTxHash	string (hex)	Required (exactly 1)	The hash of the quorum member's provider registration transaction as hex in RPC byte order
→ → → receivedContributions	object	Required (exactly 1)	An array of objects with each object containing the member index and ProTx hash for a member a contribution was received from
→ → → → Member	object	Required (0 or more)	An object describing quorum member details
→ → → → → memberIndex	number	Required (exactly 1)	The quorum member's index
→ → → → → proTxHash	string (hex)	Required (exactly 1)	The hash of the quorum member's provider registration transaction as hex in RPC byte order
→ → → receivedComplaints	object	Required (exactly 1)	An array of objects with each object containing the member index and ProTx hash for a member a complaint was received from
→ → → → Member	object	Required (0 or more)	An object describing quorum member details
→ → → → → memberIndex	number	Required (exactly 1)	The quorum member's index
→ → → → → proTxHash	string (hex)	Required (exactly 1)	The hash of the quorum member's provider registration transaction as hex in RPC byte order
→ → → receivedJustifications	object	Required (exactly 1)	An array of objects with each object containing the member index and ProTx hash for a member a justification was received from
→ → → → Member	object	Required (0 or more)	An object describing quorum member details
→ → → → → memberIndex	number	Required (exactly 1)	The quorum member's index
→ → → → → proTxHash	string (hex)	Required (exactly 1)	The hash of the quorum member's provider registration transaction as hex in RPC byte order
→ → → receivedPrematureCommitments	object	Required (exactly 1)	An array of objects with each object containing the member index and ProTx hash for a member a premature commitment was received from
→ → → → Member	object	Required (0 or more)	An object describing quorum member details
→ → → → → memberIndex	number	Required (exactly 1)	The quorum member's index
→ → → → → proTxHash	string (hex)	Required (exactly 1)	The hash of the quorum member's provider registration transaction as hex in RPC byte order
→ → → allMembers	array	Required (exactly 1)	Array containing the provider registration transaction hash for all quorum members

Example from Dash Core 0.14.0

Bash

dash-cli -testnet quorum dkgstatus

Result (truncated):

JSON

{
  "proTxHash": "04d06d16b3eca2f104ef9749d0c1c17d183eb1b4fe3a16808fd70464f03bcd63",
  "time": 1555172494,
  "timeStr": "2019-04-13 16:21:34",
  "session": {
    "llmq_50_60": {
      "llmqType": 1,
      "quorumHash": "000000000122768294b19a5f6750094f6e9caa135c0826372d0538d4ceb910bc",
      "quorumHeight": 79368,
      "phase": 6,
      "sentContributions": true,
      "sentComplaint": true,
      "sentJustification": false,
      "sentPrematureCommitment": true,
      "aborted": false,
      "badMembers": 2,
      "weComplain": 0,
      "receivedContributions": 48,
      "receivedComplaints": 44,
      "receivedJustifications": 0,
      "receivedPrematureCommitments": 44
    }
  },
  "minableCommitments": {
    "llmq_50_60": {
      "version": 1,
      "llmqType": 1,
      "quorumHash": "000000000122768294b19a5f6750094f6e9caa135c0826372d0538d4ceb910bc",
      "signersCount": 0,
      "validMembersCount": 0,
      "quorumPublicKey": "000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
    }
  },
  "quorumConnections": {
    "llmq_50_60": [
    ],
    "llmq_400_60": [
      {
        "proTxHash": "38a22aeedd3bfaa6f2fd8c6859e257b679261ec17c247eb4950af93ab702be28",
        "connected": false,
        "outbound": false
      },
      {
        "proTxHash": "f443dd87ec7981e8630ae957f295d9d226d4bd3895f59dbd80b30137a92b3735",
        "connected": true,
        "address": "95.183.53.17:10008",
        "outbound": true
      },
      {
        "proTxHash": "ab0848b6a026d953c334c7a5bd1ebf98909d8dc26994fc42f61aed984acb0c3d",
        "connected": false,
        "outbound": false
      }
    ],
    "llmq_400_85": [
      {
        "proTxHash": "ed06587e8898754ff9abacdcf19c0870d7a065f4895b936878c8274bed4f9d5e",
        "connected": true,
        "address": "3.249.195.183:31145",
        "outbound": true
      },
      {
        "proTxHash": "bc36e6c0d0c69173ea0c8a9a821548468e7713ab9bf748c117d5404b4450f86b",
        "connected": false,
        "outbound": true
      },
      {
        "proTxHash": "0ed3ba3ceac8505f109557157b2e0984812d87b7d83dbd14aab956f21a752a78",
        "connected": false,
        "outbound": false
      },
    ]
  }
}

Example from Dash Core 0.14.0 (detail_level: 1)

Bash

dash-cli -testnet quorum dkgstatus 1

Result (truncated):

JSON

{
  "proTxHash": "04d06d16b3eca2f104ef9749d0c1c17d183eb1b4fe3a16808fd70464f03bcd63",
  "time": 1555172494,
  "timeStr": "2019-04-13 16:21:34",
  "session": {
    "llmq_50_60": {
      "llmqType": 1,
      "quorumHash": "000000000122768294b19a5f6750094f6e9caa135c0826372d0538d4ceb910bc",
      "quorumHeight": 79368,
      "phase": 6,
      "sentContributions": true,
      "sentComplaint": true,
      "sentJustification": false,
      "sentPrematureCommitment": true,
      "aborted": false,
      "badMembers": [
        35,
        42
      ],
      "weComplain": [
      ],
      "receivedContributions": [
        0,
        1,
        2,
        48,
        49
      ],
      "receivedComplaints": [
        0,
        1,
        2,
        48,
        49
      ],
      "receivedJustifications": [
      ],
      "receivedPrematureCommitments": [
        0,
        1,
        2,
        48,
        49
      ]
    }
  },
  "minableCommitments": {
    "llmq_50_60": {
      "version": 1,
      "llmqType": 1,
      "quorumHash": "000000000122768294b19a5f6750094f6e9caa135c0826372d0538d4ceb910bc",
      "signersCount": 0,
      "validMembersCount": 0,
      "quorumPublicKey": "000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
    }
  }
}

Example from Dash Core 0.14.0 (detail_level: 2)

Bash

dash-cli -testnet quorum dkgstatus 2

Result (truncated):

JSON

{
  "proTxHash": "04d06d16b3eca2f104ef9749d0c1c17d183eb1b4fe3a16808fd70464f03bcd63",
  "time": 1555172494,
  "timeStr": "2019-04-13 16:21:34",
  "session": {
    "llmq_50_60": {
      "llmqType": 1,
      "quorumHash": "000000000122768294b19a5f6750094f6e9caa135c0826372d0538d4ceb910bc",
      "quorumHeight": 79368,
      "phase": 6,
      "sentContributions": true,
      "sentComplaint": true,
      "sentJustification": false,
      "sentPrematureCommitment": true,
      "aborted": false,
      "badMembers": [
        {
          "memberIndex": 35,
          "proTxHash": "c24aea30305d539887223fd923df775644b1d86db0aac8c654026e823b549cd7"
        },
        {
          "memberIndex": 42,
          "proTxHash": "f0567069d4f2a2e536e46173a097b318daf03edef989f6875ca06f5c4d49abc9"
        }
      ],
      "weComplain": [
      ],
      "receivedContributions": [
        {
          "memberIndex": 0,
          "proTxHash": "a6670caf2842a4ae5cb4bb78b3c10343456922b500693f6da043af541d58d9cb"
        },
        {
          "memberIndex": 1,
          "proTxHash": "77c0615fb5eb946f7f731a44eb36dc37ee77bf959e7205937d88186cacfbdc7e"
        },
        {
          "memberIndex": 2,
          "proTxHash": "8070c631ce9ac8850d2e95d4ed7be70171ead22ccd7f4bc9c3aee0a227f323c9"
        },
        {
          "memberIndex": 48,
          "proTxHash": "9de76b8291d00026ab0af86306023c7b90f8e9229dc04916fe1335bf5e11f15d"
        },
        {
          "memberIndex": 49,
          "proTxHash": "e441bbb2f056d471ae9fad83b4dd0fa691a0574eb4a373a0e59d6108614ee07e"
        }
      ],
      "receivedComplaints": [
        {
          "memberIndex": 0,
          "proTxHash": "a6670caf2842a4ae5cb4bb78b3c10343456922b500693f6da043af541d58d9cb"
        },
        {
          "memberIndex": 1,
          "proTxHash": "77c0615fb5eb946f7f731a44eb36dc37ee77bf959e7205937d88186cacfbdc7e"
        },
        {
          "memberIndex": 2,
          "proTxHash": "8070c631ce9ac8850d2e95d4ed7be70171ead22ccd7f4bc9c3aee0a227f323c9"
        },
        {
          "memberIndex": 48,
          "proTxHash": "9de76b8291d00026ab0af86306023c7b90f8e9229dc04916fe1335bf5e11f15d"
        },
        {
          "memberIndex": 49,
          "proTxHash": "e441bbb2f056d471ae9fad83b4dd0fa691a0574eb4a373a0e59d6108614ee07e"
        }
      ],
      "receivedJustifications": [
      ],
      "receivedPrematureCommitments": [
        {
          "memberIndex": 0,
          "proTxHash": "a6670caf2842a4ae5cb4bb78b3c10343456922b500693f6da043af541d58d9cb"
        },
        {
          "memberIndex": 1,
          "proTxHash": "77c0615fb5eb946f7f731a44eb36dc37ee77bf959e7205937d88186cacfbdc7e"
        },
        {
          "memberIndex": 2,
          "proTxHash": "8070c631ce9ac8850d2e95d4ed7be70171ead22ccd7f4bc9c3aee0a227f323c9"
        },
        {
          "memberIndex": 48,
          "proTxHash": "9de76b8291d00026ab0af86306023c7b90f8e9229dc04916fe1335bf5e11f15d"
        },
        {
          "memberIndex": 49,
          "proTxHash": "e441bbb2f056d471ae9fad83b4dd0fa691a0574eb4a373a0e59d6108614ee07e"
        }
      ],
      "allMembers": [
        "a6670caf2842a4ae5cb4bb78b3c10343456922b500693f6da043af541d58d9cb",
        "77c0615fb5eb946f7f731a44eb36dc37ee77bf959e7205937d88186cacfbdc7e",
        "8070c631ce9ac8850d2e95d4ed7be70171ead22ccd7f4bc9c3aee0a227f323c9",
        "596be0851532a66037744afa694e4de6485f326f4638e704db93cc726866cda3",
        "51c11d287dfa85aef3eebb5420834c8e443e01d15c0b0a8e397d67e2e51aa239",
        "9f4f9f83ecbcd5739d7f1479ee14b508f2414d044a717acba0960566c4e6091d",
        "21c0923badd20f953360c586edfcbb1a830be83206e30b3f65765f7794f2a640",
        "cc36055f36345b85a2b8176e79feff0ff822c490691c7f8e8d3348b4b1a1d8ac",
        "4636ed7acbacbc76aba60aa7a1011688fe9ad5fd701d0bf8fc42a502ea3e6543",
        "32e5ad5cf9a06eb13e0f65cb7ecde1a93ef24995d07355fac2ff05ebd5b9ddbf",
        "0022afbe93054ca11ce9b67892661af4558597bacff0ab82bff05a2b4a89ca2d",
        "2523dc6e034911b9004862e87b4d23a32ed6198aec177915df7893f51cd645bd",
        "abe5d16432915b201cf6f11299a1abd62e5f69a2c4e8717694d1e42d96dbd580",
        "f443dd87ec7981e8630ae957f295d9d226d4bd3895f59dbd80b30137a92b3735",
        "6a5be5c068a0be432b7db0772b25094a59ce1f433dd2df0d410511ac641c3768",
        "84435c41688c8021a25a644e6b94c9f5159aff5658ee2e12f5cea5c714c21aa3",
        "2db238aa40837319ca13e27aae4333d1248475546be6cfad985a3785c0ac9bd6",
        "cefb7c69f75d9fbba21f648c6205bebf9b16325956404c70af03144c1135c7d7",
        "cc7041c869c7c1c0bae7c137f0cda708ad492bc89c4b8f7a40a353d90335febf",
        "24e642275f5d5f17f67db502d905153cfd83ffbd3d49c90196ec01200917fb31",
        "bc5c77926b0ccfcb742123a1edf2c27147888f694701df399982a862309921c8",
        "04d06d16b3eca2f104ef9749d0c1c17d183eb1b4fe3a16808fd70464f03bcd63",
        "11eabc1e72394af02bbe86815975d054816fe69006fdc64c6d7a06b585e5c311",
        "71cf5017c4c5f69db5c17a8cfb4c28ffc14ad1715dba2a83f0c30e534291f828",
        "d567ac9cc7437848210365a0225271ec26a6a6c7d852544a6e9cbd40756075b3",
        "16ef804605595f67a0e078f7ffbdd93ac55bcd22d9094cb8b61ef527c48f4c44",
        "f51b426420ac4c518ad07c2bb03e434389337b4e2977d39233114d5e8ef21f69",
        "2460848868c210d23c68460050f83f47a7ad00db2c47ad6f223a9b1eb04c8d54",
        "49d94e4c584929320cfe159faf4f6e398f1b2d1fdaa413c01345ce23870d2ca9",
        "e8b039ce3f1016b7caf781d1b0efbc11191860ec3b131fc49591402a260ba638",
        "5ab82a5348b5d4c126b0c172665d364352be37c96ce442e710d4a844a6f80bf9",
        "05b83104eea971582c803ded305109ecb734b582da93b8e301c6f00d6be6c496",
        "c98c6303af03f7f3b2673ceece962134088e5dcc3c69a0977069c6201b26dc9b",
        "f933d592d677f3409274646ddea2ffaaca77dfd4ceab7c54037a04e05fc7ee8b",
        "5d40e68f65e7263d91e114b644ff7f8c9c376db63550d5ef9bc4228870c4f053",
        "c24aea30305d539887223fd923df775644b1d86db0aac8c654026e823b549cd7",
        "a36edfac56f7f1b0f58aa793115fbd53d792315857033fb32a862507a3f060ff",
        "c9d43a69bd9effdaed579edc901c5d848711481047c9cc76bad8232d8f329dcd",
        "d82152084615c73d79f3eb8b0ec6a61e6d0f94c4cdcf26f773f0e42b72176f6f",
        "869f7f2054a6ed4241967afb74c3b1a07701d2772b368eb0bbfd2e3365adf6f3",
        "5f1a70a350d21f673d93fae45a50c0362947366e46c96bade51b7933f0cada3e",
        "024608d03beb6a6065f14a29a837c68ae449ac1e17056819366ca0b72b6dd81f",
        "f0567069d4f2a2e536e46173a097b318daf03edef989f6875ca06f5c4d49abc9",
        "254bcd3b28d696ce9d468cd521e6be3f7eb01da32d8bf9fdf34868baaf09d9e7",
        "0ae626ed4ee06c1f042b2eaa9669302a2e60a0df8137843b39de53f2c3e265aa",
        "cfa6f7b58c78f827c15e8f1b6a5a2a3a92140101719006d8226a363e2c0c8e5c",
        "03811a53a20289799f56227f576915492d2cede48522cd1b3f67c6c89cdacf83",
        "f989866b2fadb674a1ca63746ff8bb97232d6843c95f9e805b8bc2a5ae8e768d",
        "9de76b8291d00026ab0af86306023c7b90f8e9229dc04916fe1335bf5e11f15d",
        "e441bbb2f056d471ae9fad83b4dd0fa691a0574eb4a373a0e59d6108614ee07e"
      ]
    }
  },
  "minableCommitments": {
    "llmq_50_60": {
      "version": 1,
      "llmqType": 1,
      "quorumHash": "000000000122768294b19a5f6750094f6e9caa135c0826372d0538d4ceb910bc",
      "signersCount": 0,
      "validMembersCount": 0,
      "quorumPublicKey": "000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
    }
  }
}

Quorum Sign

The quorum sign RPC requests threshold-signing for a message.

Parameter #1---LLMQ Type

Name	Type	Presence	Description
llmqType	number	Required (exactly 1)	Type of quorum: 1 - LLMQ_50_60 2 - LLMQ_400_60 3 - LLMQ_400_85 4 - LLMQ_100_67

Parameter #2---id

Name	Type	Presence	Description
id	string (hex)	Required (exactly 1)	Signing request ID. Signing request ids for ChainLocks and InstantSend are calculated as described in: * The ChainLocks DIP * The LLMQ InstantSend DIP.

📘

For general signing requests, any 32 byte hex string can be provided as the request id. Note that if a quorum hash is not specified in parameter 4, a quorum will be selected automatically based in part on this value.

Parameter #3---message hash

Name	Type	Presence	Description
msgHash	string (hex)	Required (exactly 1)	Hash of the message to be signed

Parameter #4---quorum hash

Name	Type	Presence	Description
quorumHash	string (hex)	Optional (0 or 1)	The quorum identifier

Parameter #5---submit

Name	Type	Presence	Description
submit	bool	Optional (0 or 1)	Added in Dash Core 0.17.0 Submits the signature share to the network if this is true (default). Returns an object containing the signature share if this is false.

Result---(if submit = true) status

Name	Type	Presence	Description
result	bool	Required (exactly 1)	True or false depending on success

Result---(if submit = false) signature share JSON object

Name	Type	Presence	Description
result	object	Required (exactly 1)	JSON object containing signature share details
→ llmqType	number	Required (exactly 1)	Type of quorum: 1 - LLMQ_50_60 2 - LLMQ_400_60 3 - LLMQ_400_85 4 - LLMQ_100_67
→ quorumHash	string (hex)	Required (exactly 1)	The quorum identifier
→ quorumMember	number	Required (exactly 1)	Which quorum member created this signature share
→ id	string (hex)	Required (exactly 1)	Signing request ID
→ msgHash	string (hex)	Required (exactly 1)	Hash of the message that was signed
→ signHash	string (hex)	Required (exactly 1)	Hash of llmqType, quorumHash, id, and msgHash
→ signature	string (hex)	Required (exactly 1)	Signature share

Example from Dash Core 0.17.0

Submit signature share to network (default):

Bash

dash-cli -testnet quorum sign 1 \
  "abcd1234abcd1234abcd1234abcd1234abcd1234abcd1234abcd1234abcd1234" \
  "51c11d287dfa85aef3eebb5420834c8e443e01d15c0b0a8e397d67e2e51aa239"

Result:

JSON

false

Return signature share object:

Bash

dash-cli -testnet quorum sign 100 \
  "0000000000000000000000000000000000000000000000000000000000000001" \
  "0000000000000000000000000000000000000000000000000000000000000002" \
  "53d959f609a654cf4e5e3c083fd6c47b7ec6cb73af4ac7329149688337b8ef9a" false

Result:

JSON

{
  "llmqType": 100,
  "quorumHash": "53d959f609a654cf4e5e3c083fd6c47b7ec6cb73af4ac7329149688337b8ef9a",
  "quorumMember": 2,
  "id": "0000000000000000000000000000000000000000000000000000000000000001",
  "msgHash": "0000000000000000000000000000000000000000000000000000000000000002",
  "signHash": "39458221939396a45a2e348caada646eabd52849990827d40e33eb1399097b3c",
  "signature": "9716545a0c28ff70900a71fabbadf3c13e4ae562032122902405365f1ebf3da813c8a97d765eb8b167ff339c1638550c13822217cf06b609ba6a78f0035684ca7b4afdb7146ce74a30cfb6770f852aade8c27ffec67c79f85be31964573fb51c"
}

Quorum GetRecSig

The quorum getrecsig RPC gets the recovered signature for a previous threshold-signing message request.

Parameter #1---LLMQ Type

Name	Type	Presence	Description
llmqType	number	Required (exactly 1)	Type of quorum: 1 - LLMQ_50_60 2 - LLMQ_400_60 3 - LLMQ_400_85 4 - LLMQ_100_67

Parameter #2---id

Name	Type	Presence	Description
id	string (hex)	Required (exactly 1)	Signing request ID

Parameter #3---message hash

Name	Type	Presence	Description
msgHash	string (hex)	Required (exactly 1)	Hash of the message to be signed

Result---recovered signature

Name	Type	Presence	Description
result	bool	Required (exactly 1)	Recovered signature details
→ llmqType	number	Required (exactly 1)	Type of quorum: 1 - LLMQ_50_60 2 - LLMQ_400_60 3 - LLMQ_400_85 4 - LLMQ_100_67
→ quorumHash	string (hex)	Required (exactly 1)	The block hash of the quorum
→ id	string (hex)	Required (exactly 1)	The signing session ID
→ msgHash	string (hex)	Required (exactly 1)	The message hash
→ sig	string (hex)	Required (exactly 1)	The recovered signature
→ hash	string (hex)	Required (exactly 1)	The hash of the recovered signature

Example from Dash Core 0.14.0

Bash

dash-cli -testnet quorum getrecsig 1 \
  "e980ebf295b42f24b03321ffb255818753b2b211e8c46b61c0b6fde91242d12f" \
  "907087d4720850e639b7b5cc41d7a6d020e5a50debb3bc3974f0cb3d7d378ea4"

Result:

JSON

{
  "llmqType": 1,
  "quorumHash": "00000000008344da08e4d262773ea545472fbf625f78b3ebfe5fc067c33b1d22",
  "id": "e980ebf295b42f24b03321ffb255818753b2b211e8c46b61c0b6fde91242d12f",
  "msgHash": "907087d4720850e639b7b5cc41d7a6d020e5a50debb3bc3974f0cb3d7d378ea4",
  "sig": "1365171c408d686af2ca8f5fae91cdf9cf0b5eec60b0b161b9288a1c68e2cd68f225495a787415c924c5953a6282d131178aa6baf4c2673d19549fc627740cf71d295f8a38b9970525a7f248d54a548e16da285b5c1f3ec0740ad40edbcc8615",
  "hash": "d9b7f7904746fbb3eeaeec36fadc79b351f6a854cd22ee9e607592aee972fcb2"
}

Quorum HasRecSig

The quorum hasrecsig RPC checks for a recovered signature for a previous threshold-signing message request.

🚧

Regtest Network Only

Note: Used for RegTest testing only.

Parameter #1---LLMQ Type

Name	Type	Presence	Description
llmqType	number	Required (exactly 1)	Type of quorum: 1 - LLMQ_50_60 2 - LLMQ_400_60 3 - LLMQ_400_85 4 - LLMQ_100_67

Parameter #2---id

Name	Type	Presence	Description
id	string (hex)	Required (exactly 1)	Signing request ID

Parameter #3---message hash

Name	Type	Presence	Description
msgHash	string (hex)	Required (exactly 1)	Hash of the message to be signed

Result---status

Name	Type	Presence	Description
result	bool	Required (exactly 1)	True or false depending on success

Example from Dash Core 0.14.0

Bash

dash-cli -testnet quorum hasrecsig 1 \
  "e980ebf295b42f24b03321ffb255818753b2b211e8c46b61c0b6fde91242d12f" \
  "907087d4720850e639b7b5cc41d7a6d020e5a50debb3bc3974f0cb3d7d378ea4"

Result:

Text

true

Quorum IsConflicting

The quorum isconflicting RPC checks if there is a conflict for a threshold-signing message request.

🚧

Regtest Network Only

Note: Used for RegTest testing only.

Parameter #1---LLMQ Type

Name	Type	Presence	Description
llmqType	number	Required (exactly 1)	Type of quorum: 1 - LLMQ_50_60 2 - LLMQ_400_60 3 - LLMQ_400_85 4 - LLMQ_100_67

Parameter #2---id

Name	Type	Presence	Description
id	string (hex)	Required (exactly 1)	Signing request ID

Parameter #3---message hash

Name	Type	Presence	Description
msgHash	string (hex)	Required (exactly 1)	Hash of the message to be signed

Result---status

Name	Type	Presence	Description
result	bool	Required (exactly 1)	True or false depending on success

Example from Dash Core 0.14.0

Bash

dash-cli -testnet quorum isconflicting 1 \
  "e980ebf295b42f24b03321ffb255818753b2b211e8c46b61c0b6fde91242d12f" \
  "907087d4720850e639b7b5cc41d7a6d020e5a50debb3bc3974f0cb3d7d378ea4"

Result:

Text

false

Quorum MemberOf

The quorum RPC checks which quorums the given masternode is a member of.

Parameter #1---proTxHash

Name	Type	Presence	Description
proTxHash	string	Required (exactly 1)	ProTxHash of the masternode.

Parameter #2---scanQuorumsCount

Name	Type	Presence	Description
scanQuorumsCount	number	Optional	Number of quorums to scan for. If not specified, the active quorum count for each specific quorum type is used.

Result---list of quorums the masternode is a member of

Name	Type	Presence	Description
result	Array of objects	Required (exactly 1)	Array containing info for quorum's the masternode belongs to
→ Quorum	object	Required (0 or more)	An object describing quorum details
→ → height	number	Required (exactly 1)	Block height of the quorum
→ → type	string	Required (exactly 1)	Type of quorum
→ → quorumHash	string (hex)	Required (exactly 1)	The hash of the quorum
→ → minedBlock	string (hex)	Required (exactly 1)	The hash of the block that established the quorum
→ → quorumPublicKey	string (hex)	Required (exactly 1)	Quorum public key
→ → isValidMember	bool	Required (exactly 1)	Indicates if the member is valid
→ → memberIndex	number	Required (exactly 1)	Index of the member within the quorum

Example from Dash Core 0.15.0

Bash

dash-cli -testnet quorum memberof 1 \
  39c07d2c9c6d0ead56f52726b63c15e295cb5c3ecf7fe1fefcfb23b2e3cfed1f 1

Result:

JSON

[
  {
    "height": 72000,
    "type": "llmq_400_60",
    "quorumHash": "0000000007697fd69a799bfa26576a177e817bc0e45b9fcfbf48b362b05aeff2",
    "minedBlock": "00000000014d910dca80944b52aa3f522d5604254043b8354d641912aace4343",
    "quorumPublicKey": "03a3fbbe99d80a9be8fc59fd4fe43dfbeba9119b688e97493664716cdf15ae47fad70fea7cb93f20fba10d689f9e3c02",
    "isValidMember": true,
    "memberIndex": 80
  }
]

See also: none

Quorum SelectQuorum

The quorum selectquorum RPC returns information about the quorum that would/should sign a request.

Parameter #1---LLMQ Type

Name	Type	Presence	Description
llmqType	number	Required (exactly 1)	Type of quorums to list: 1 - LLMQ_50_60 2 - LLMQ_400_60 3 - LLMQ_400_85 4 - LLMQ_100_67

Parameter #2---request id

Name	Type	Presence	Description
id	string (hex)	Required (exactly 1)	The request ID

Result---quorum hash and list of quorum members

Name	Type	Presence	Description
result	Array of objects	Required (exactly 1)	Array containing info for quorum's the masternode belongs to
→ quorumHash	string (hex)	Required (exactly 1)	The hash of the quorum
→→ recoveryMembers	array	Required (exactly 1)	Array containing ProRegTx hashes
→→→ ProRegTx Hash	string (hex)	Required (exactly 1)	The hash of the provider transaction as hex in RPC byte order

Example from Dash Core 0.16.0

Bash

dash-cli -testnet quorum selectquorum 1 \
  b95205c3bba72e9edfbe7380ec91fe5a97e16a189e28f39b03c6822757ad1a34

Result:

JSON

{
  "quorumHash": "00000ba8932486c66ed0742fd6b0f4e65afc75ab1e7886c6ef84580dfb7da34f",
  "recoveryMembers": [
    "0130c115522681b87082db1f45c38423d1a018a8e1559c2491103931e891c220",
    "dcd5dd71c4bd50c76d428f72b4a5731bd819720fbc656fff717548e2fe8cbd09",
    "a25c2f4549da0135411122ee9c2d37e8375577dc97431a282a5c374b4c71463a",
    "a1aaa653e5183d6a4525abfd0a76fc7d6a68393a1c4259117028dfce4fd215e1",
    "4c9eb7849590cca2aa18bf9aeeb1e4196c833740de2b111a7690eb62319b0735",
    "f38b8c5cb6c9e712aeeb150b9591cbdc70e99f9f26c1516955dd506b20dd9876",
    "afe12673c32de351e9f5a29178cd55656f03e64357be872536eb50b059032fe0",
    "651d56765c77b8c16b829a4a68f6d39cab40c913d0d365d7b7fd254ccc6cb2f1",
    "f88d0e5349d0bf7e4426a7461d7931d09f54c13edb6d83306c2521d19eb0b14b",
    "bdba1f169ab1e73c4dc96f4133b337c36907976e26a4612ffa5ae18869eba96c",
    "94044c070f9ce6bdd05c2b655ad2383c8402a74c10e0a9a3099d759b33cb7630",
    "515f77efd5983a765dc5740b0e0d3fae6e867917ca384467b24e31dda68c7369",
    "d1ebecfb816f5b4b5f34c91c0aab9c1b643c8567473e6ee35e02e01c9f2304c0",
    "2755d546b114aaec98589cf5b946e408a8996e4837234d2eee97e1da8c71e9ce",
    "b04b5240a8fc5ae62865dfa2e2558894f4b53d82fe88771e5345407b560d59bc",
    "53750150229202353bfbc3a2c866b993dd33a4c749d8f18ddcb1f5caf7e901ef",
    "7a5d1e05d4772feede8b9e71e17e013f99e77c622f13897b8a96339d6d06e1fc",
    "24f6fae5b5afd001d1046425f38e6ef523140afafc83013468bd31feb343f307",
    "18f2e176adf88043c41b406d0c97a2dd529d5daaca8b8ac49f72e6da30334926",
    "73191708ab5b21cc7ede9b12bc1e79de97ad5c4b9717a4fbf5de0ed1f3a5836a",
    "b57da176c0b6deae786afd318a8e00e351bed0f47ceac28f5b6d3d502f1c68d7",
    "161b2dcf8243162d11065eefd0948cb79d96dfa8ae869e34763a2bbd7d1d5d55",
    "fac81f18b3a968f5f881324d8eb38983f3f892c4999c2f46809c4de620b784d2",
    "42267d2c50a68350c880a488ec25ba0eac4e7cd436eb97c686fe0a6d035d25d3",
    "0be00b051c77fd4b6dac46a63b939f73726dc61dd80616e4573a9465f1aafa93"
  ]
}

See also: none

Quorum Verify

👍

Added in Dash Core 0.17.0

The quorum verify RPC tests if a quorum signature is valid for a request id and a message hash.

Parameter #1---LLMQ Type

Name	Type	Presence	Description
llmqType	number	Required (exactly 1)	Type of quorum: 1 - LLMQ_50_60 2 - LLMQ_400_60 3 - LLMQ_400_85 4 - LLMQ_100_67

Parameter #2---id

Name	Type	Presence	Description
id	string (hex)	Required (exactly 1)	Signing request ID

Parameter #3---message hash

Name	Type	Presence	Description
msgHash	string (hex)	Required (exactly 1)	Hash of the message to be signed

Parameter #4---signature

Name	Type	Presence	Description
signature	string (hex)	Required (exactly 1)	Quorum signature to verify

Parameter #5---quorum hash

Name	Type	Presence	Description
quorumHash	string (hex)	Optional (0 or 1)	The quorum identifier. Set to "" if you want to specify signHeight instead.

Parameter #6---sign height

Name	Type	Presence	Description
signHeight	number	Optional (0 or 1)	The height at which the message was signed. Only works when quorumHash is "".

Result---status

Name	Type	Presence	Description
result	bool	Required (exactly 1)	True or false depending on verification success

Example from Dash Core 0.17.0

Verify the provided signature was valid:

Bash

dash-cli -testnet quorum verify 1 \
  "2ceeaa7ff20de327ef65b14de692199d15b67b9458d0ded7d68735cce98dd039" \
  "8b5174d0e95b5642ebec23c3fe8f0bbf8f6993502f4210322871bba0e818ff3b" \
  "99cf2a0deb08286a2d1ffdd2564b35522fd748c8802e561abed330dea20df5cb5a5dffeddbe627ea32cb36de13d5b4a516fdfaebae9886b2f7969a5d112416cf8d1983ebcbf1463a64f7522505627e08b9c76c036616fbb1649271a2773a1653" \
  "000000583a348d1a0a5f753ef98e6a69f9bcd9b27919f10eb1a1c3edb6c79182"

Result:

JSON

true

VerifyChainLock

👍

Added in Dash Core 0.17.0

The verifychainlock RPC tests if a quorum signature is valid for a ChainLock.

Parameter #1---block hash

Name	Type	Presence	Description
blockhash	string (hex)	Required (exactly 1)	The block hash of the ChainLock

Parameter #2---signature

Name	Type	Presence	Description
signature	string (hex)	Required (exactly 1)	The ChainLock signature to verify

Parameter #3---block height

Name	Type	Presence	Description
blockHeight	number	Optional (0 or 1)	The height of the ChainLock. There will be an internal lookup of blockHash if this is not provided.

Result---status

Name	Type	Presence	Description
result	bool	Required (exactly 1)	True or false depending on verification success

Example from Dash Core 0.17.0

Verify the provided signature was valid:

Bash

dash-cli -testnet verifychainlock \
  "00000036d5c520be6e9a32d3829efc983a7b5e88052bf138f80a2b3988689a24" \
  "97ec34efd1615b84af62495e54024880752f57790cf450ae974b80002440963592d96826e24f109e6c149411b70bb9a0035443752368590adae60365cf4251464e0423c1263e9c56a33eae9be9e9c79a117151b2173bcee93497008cace8d793"

Result:

JSON

true

VerifyISLock

👍

Added in Dash Core 0.17.0

The verifyislock RPC tests if a quorum signature is valid for an InstantSend Lock.

Parameter #1---id

Name	Type	Presence	Description
id	string (hex)	Required (exactly 1)	Signing request ID

Parameter #2---transaction id

Name	Type	Presence	Description
txid	string (hex)	Required (exactly 1)	The transaction id (TXID)

Parameter #3---signature

Name	Type	Presence	Description
signature	string (hex)	Required (exactly 1)	The InstantSend Lock signature to verify

Parameter #4---maximum height

Name	Type	Presence	Description
maxHeight	number	Optional (0 or 1)	The maximum height to search quorums from

Result---status

Name	Type	Presence	Description
result	bool	Required (exactly 1)	True or false depending on verification success

Example from Dash Core 0.17.0

Verify the provided signature was valid:

Bash

dash-cli -testnet verifyislock \
  "d0b1a9c70fdfff6bf7f6cbe3d1fe33a4ca44ceb17059b6381a4ac25d9c9b6495" \
  "8b5174d0e95b5642ebec23c3fe8f0bbf8f6993502f4210322871bba0e818ff3b"

Result:

JSON

false