Blockchain RPC Commands
Documentation for Raptoreum Blockchain RPC calls.
getbestblockhash
Returns the hash of the best (tip) block in the longest blockchain.
Arguments
No arguments.
Result
"hex" (string) the block hash, hex-encoded
Examples
raptoreum-cli getbestblockhash
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getbestblockhash", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getbestchainlock
Returns information about the best chainlock. Throws an error if there is no known chainlock yet.
Arguments
No arguments.
Result
{ (json object)
"hash" : "hex", (string) The block hash hex encoded
"height" : n, (numeric) The block height or index
"signature" : "hex", (string) The chainlock's BLS signature.
"known_block" : true|false (boolean) True if the block is known by our node
}
Examples
raptoreum-cli getbestchainlock
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getbestchainlock", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getblock
If verbosity is 0, returns a string that is serialized, hex-encoded data for block 'hash'.
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
| 2 | verbosity |
numeric | Optional | 1 | See CLI help for details |
Examples
raptoreum-cli getblock "00000000000fd08c2fb661d2fcb0d49abb3a91e5f27082ce64feed3b4dede2e2"
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getblock", "params": ["00000000000fd08c2fb661d2fcb0d49abb3a91e5f27082ce64feed3b4dede2e2"] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getblockchaininfo
{ (json object)
Arguments
No arguments.
Result
{ (json object)
"chain" : "str", (string) current network name (main, test, regtest) and devnet or devnet-<name> for "-devnet" and "-devnet=<name>" respectively
"blocks" : n, (numeric) the height of the most-work fully-validated chain. The genesis block has height 0
"headers" : n, (numeric) the current number of headers we have validated
"bestblockhash" : "str", (string) the hash of the currently best block
"difficulty" : n, (numeric) the current difficulty
"mediantime" : n, (numeric) median time for the current best block
"verificationprogress" : n, (numeric) estimate of verification progress [0..1]
"initialblockdownload" : true|false, (boolean) (debug information) estimate of whether this node is in Initial Block Download mode
"chainwork" : "hex", (string) total amount of work in active chain, in hexadecimal
"size_on_disk" : n, (numeric) the estimated size of the block and undo files on disk
"pruned" : true|false, (boolean) if the blocks are subject to pruning
"pruneheight" : n, (numeric) lowest-height complete block stored (only present if pruning is enabled)
"automatic_pruning" : true|false, (boolean) whether automatic pruning is enabled (only present if pruning is enabled)
"prune_target_size" : n, (numeric) the target size used by pruning (only present if automatic pruning is enabled)
"softforks" : [ (json array) status of softforks in progress
{ (json object)
"xxxx" : "str", (string) name of the softfork
"version" : "str", (string) block version
"reject" : { (json object) progress toward rejecting pre-softfork blocks
"status" : true|false (boolean) true if threshold reached
}
},
...
],
"rip1_softforks" : { (json object) status of RIP1 softforks in progress
"xxxx" : { (json object) name of the softfork
"status" : "str", (string) one of "defined", "started", "locked_in", "active", "failed"
"start_height" : n, (numeric) the block height where voting starts
"round_size" : n, (numeric) number of block per round of voting
"voting_period" : n, (numeric) Number of rounds required for voting threshold check
"miners" : { (json object) miner numeric statistics about RIP1 signalling for a softfork
"mean_percentage" : n, (numeric) the mean approved percentage for this current voting period
"weighted_yes" : n, (numeric) the number of approved votes for this voting period
"weight" : n, (numeric) the number of votes for this voting period
"samples" : n, (numeric) the number of round has been passed
"threshold" : n, (numeric) current pass activation threshold
"approved" : true|false (boolean) returns false if miners has not yet approved
},
"nodes" : { (json object) node numeric statistics about RIP1 signalling for a softfork
"mean_percentage" : n, (numeric) the mean of approved percentage for this current voting period
"weighted_yes" : n, (numeric) the number of approved votes for this voting period
"weight" : n, (numeric) the number of votes for this voting period
"samples" : n, (numeric) the number of round has been passed
"threshold" : n, (numeric) current pass activation threshold
"approved" : true|false (boolean) returns false if nodes has not approved
}
},
...
},
"warnings" : "str" (string) any network and blockchain warnings
}
Examples
raptoreum-cli getblockchaininfo
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getblockchaininfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getblockcount
Returns the number of blocks in the longest blockchain.
Arguments
No arguments.
Result
n (numeric) The current block count
Examples
raptoreum-cli getblockcount
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getblockcount", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getblockhash
Returns hash of block in best-block-chain at height provided.
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
Result
"hex" (string) The block hash
Examples
raptoreum-cli getblockhash 1000
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getblockhash", "params": [1000] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getblockhashes
Returns array of hashes of blocks within the timestamp range provided.
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
Result
[ (json array)
"hex", (string) The block hash
...
]
Examples
raptoreum-cli getblockhashes 1231614698 1231024505
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getblockhashes", "params": [1231614698, 1231024505] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getblockheader
If verbose is false, returns a string that is serialized, hex-encoded data for blockheader 'hash'.
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
| 2 | verbose |
boolean | Optional | true | See CLI help for details |
Examples
raptoreum-cli getblockheader "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getblockheader", "params": ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getblockheaders
Returns an array of items with information about
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
| 2 | count |
numeric | Optional | 2000 | See CLI help for details |
| 3 | verbose |
boolean | Optional | true | See CLI help for details |
Examples
raptoreum-cli getblockheaders "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09" 2000
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getblockheaders", "params": ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09" 2000] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getblockstats
Compute per block statistics for a given window. All amounts are in duffs.
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
| 2 | stats |
json array | Optional | all values) Values to plot (see result below | See CLI help for details |
Result
{ (json object)
"avgfee" : n, (numeric) Average fee in the block
"avgfeerate" : n, (numeric) Average feerate (in satoshis per virtual byte)
"avgtxsize" : n, (numeric) Average transaction size
"blockhash" : "hex", (string) The block hash (to check for potential reorgs)
"height" : n, (numeric) The height of the block
"ins" : n, (numeric) The number of inputs (excluding coinbase)
"maxfee" : n, (numeric) Maximum fee in the block
"maxfeerate" : n, (numeric) Maximum feerate (in satoshis per virtual byte)
"maxtxsize" : n, (numeric) Maximum transaction size
"medianfee" : n, (numeric) Truncated median fee in the block
"mediantime" : n, (numeric) The block median time past
"mediantxsize" : n, (numeric) Truncated median transaction size
"minfee" : n, (numeric) Minimum fee in the block
"minfeerate" : n, (numeric) Minimum feerate (in satoshis per virtual byte)
"mintxsize" : n, (numeric) Minimum transaction size
"outs" : n, (numeric) The number of outputs
"subsidy" : n, (numeric) The block subsidy
"time" : n, (numeric) The block time
"total_out" : n, (numeric) Total amount in all outputs (excluding coinbase and thus reward [ie subsidy + totalfee])
"total_size" : n, (numeric) Total size of all non-coinbase transactions
"totalfee" : n, (numeric) The fee total
"txs" : n, (numeric) The number of transactions (excluding coinbase)
"utxo_increase" : n, (numeric) The increase/decrease in the number of unspent outputs
"utxo_size_inc" : n (numeric) The increase/decrease in size for the utxo index (not discounting op_return and similar)
}
Examples
raptoreum-cli getblockstats '"00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"' '["minfeerate","avgfeerate"]'
raptoreum-cli getblockstats 1000 '["minfeerate","avgfeerate"]'
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getblockstats", "params": ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09", ["minfeerate","avgfeerate"]] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getblockstats", "params": [1000, ["minfeerate","avgfeerate"]] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getchaintips
- count (numeric, optional, default=) only show this much of latest tips
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
| 1 | count |
numeric | Optional | [] | See CLI help for details |
| 2 | branchlen |
numeric | Optional | [] | See CLI help for details |
Result
[ (json array)
{ (json object)
"height" : n, (numeric) height of the chain tip
"hash" : "hex", (string) block hash of the tip
"difficulty" : n, (numeric) The difficulty
"chainwork" : "hex", (string) Expected number of hashes required to produce the current chain (in hex)
"branchlen" : n, (numeric) zero for main chain, otherwise length of branch connecting the tip to the main chain
"forkpoint" : "hex", (string) same as "hash" for the main chain
"status" : "str" (string) status of the chain, "active" for the main chain
Possible values for status:
1. "invalid" This branch contains at least one invalid block
2. "headers-only" Not all blocks for this branch are available, but the headers are valid
3. "valid-headers" All blocks are available for this branch, but they were never fully validated
4. "valid-fork" This branch is not part of the active chain, but is fully validated
5. "active" This is the tip of the active main chain, which is certainly valid
},
...
]
Examples
raptoreum-cli getchaintips
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getchaintips", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getchaintxstats
Compute statistics about the total number and rate of transactions in the chain.
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
| 1 | nblocks |
numeric | Optional | one month | See CLI help for details |
| 2 | blockhash |
string | Optional | chain tip | See CLI help for details |
Result
{ (json object)
"time" : xxx, (numeric) The timestamp for the final block in the window, expressed in UNIX epoch time
"txcount" : n, (numeric) The total number of transactions in the chain up to that point
"window_final_block_hash" : "hex", (string) The hash of the final block in the window
"window_final_block_height" : n, (numeric) The height of the final block in the window.
"window_block_count" : n, (numeric) Size of the window in number of blocks
"window_tx_count" : n, (numeric) The number of transactions in the window. Only returned if "window_block_count" is > 0
"window_interval" : n, (numeric) The elapsed time in the window in seconds. Only returned if "window_block_count" is > 0
"txrate" : n (numeric) The average rate of transactions per second in the window. Only returned if "window_interval" is > 0
}
Examples
raptoreum-cli getchaintxstats
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getchaintxstats", "params": [2016] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getdifficulty
Returns the proof-of-work difficulty as a multiple of the minimum difficulty.
Arguments
No arguments.
Result
n (numeric) the proof-of-work difficulty as a multiple of the minimum difficulty.
Examples
raptoreum-cli getdifficulty
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getdifficulty", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getmempoolancestors
If txid is in the mempool, returns all in-mempool ancestors.
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
| 2 | verbose |
boolean | Optional | false | See CLI help for details |
Examples
raptoreum-cli getmempoolancestors "mytxid"
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getmempoolancestors", "params": ["mytxid"] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getmempooldescendants
If txid is in the mempool, returns all in-mempool descendants.
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
| 2 | verbose |
boolean | Optional | false | See CLI help for details |
Examples
raptoreum-cli getmempooldescendants "mytxid"
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getmempooldescendants", "params": ["mytxid"] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getmempoolentry
Returns mempool data for given transaction
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
Result
{ (json object)
"size" : n, (numeric) virtual transaction size. This can be different from actual serialized size for high-sigop transactions.
"fee" : n, (numeric) transaction fee in RTM
"modifiedfee" : n, (numeric) transaction fee with fee deltas used for mining priority
"time" : xxx, (numeric) local time transaction entered pool in UNIX epoch time
"height" : n, (numeric) block height when transaction entered pool
"descendantcount" : n, (numeric) number of in-mempool descendant transactions (including this one)
"descendantsize" : n, (numeric) size of in-mempool descendants (including this one)
"descendantfees" : n, (numeric) modified fees (see above) of in-mempool descendants (including this one) (DEPRECATED)
"ancestorcount" : n, (numeric) number of in-mempool ancestor transactions (including this one)
"ancestorsize" : n, (numeric) size of in-mempool ancestors (including this one)
"ancestorfees" : n, (numeric) modified fees (see above) of in-mempool ancestors (including this one) (DEPRECATED)
"fees" : { (json object)
"base" : n, (numeric) transaction fee in RTM
"modified" : n, (numeric) transaction fee with fee deltas used for mining priority in RTM
"ancestor" : n, (numeric) transaction fees of in-mempool ancestors (including this one) in RTM
"descendant" : n (numeric) transaction fees of in-mempool descendants (including this one) in RTM
},
"depends" : [ (json array) unconfirmed transactions used as inputs for this transaction
"hex", (string) parent transaction id
...
],
"spentby" : [ (json array) unconfirmed transactions spending outputs from this transaction
"hex", (string) child transaction id
...
],
"time" : true|false, (boolean) True if this transaction was locked via InstantSend
...
}
Examples
raptoreum-cli getmempoolentry "mytxid"
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getmempoolentry", "params": ["mytxid"] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getmempoolinfo
Returns details on the active state of the TX memory pool.
Arguments
No arguments.
Result
{ (json object)
"status" : true|false, (boolean) True if mempool is fully loaded
"size" : n, (numeric) Current tx count
"bytes" : n, (numeric) Sum of all transaction sizes
"usage" : n, (numeric) Total memory usage for the mempool
"maxmempool" : n, (numeric) Maximum memory usage for the mempool
"mempoolminfee" : n, (numeric) Minimum fee rate in RTM/kB for tx to be accepted. Is the maximum of minrelaytxfee and minimum mempool fee
"minrelaytxfee" : n, (numeric) Current minimum relay fee for transactions
"instantsendlocks" : n (numeric) Number of unconfirmed InstantSend locks
}
Examples
raptoreum-cli getmempoolinfo
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getmempoolinfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getmerkleblocks
Returns an array of hex-encoded merkleblocks for
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
| 3 | count |
numeric | Optional | 2000 | See CLI help for details |
Result
[ (json array)
"hex", (string) A string that is serialized, hex-encoded data for a merkleblock
...
]
Examples
raptoreum-cli getmerkleblocks "2303028005802040100040000008008400048141010000f8400420800080025004000004130000000000000001" "00000000007e1432d2af52e8463278bf556b55cf5049262f25634557e2e91202" 2000
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getmerkleblocks", "params": ["2303028005802040100040000008008400048141010000f8400420800080025004000004130000000000000001" "00000000007e1432d2af52e8463278bf556b55cf5049262f25634557e2e91202" 2000] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getrawmempool
Returns all transaction ids in memory pool as a json array of string transaction ids.
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
| 1 | verbose |
boolean | Optional | false | See CLI help for details |
Examples
raptoreum-cli getrawmempool true
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getrawmempool", "params": [true] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getspecialtxes
If verbosity is 0, returns tx hash for each transaction.
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
| 2 | type |
numeric | Optional | -1 | See CLI help for details |
| 3 | count |
numeric | Optional | 10 | See CLI help for details |
| 4 | skip |
numeric | Optional | 0 | See CLI help for details |
| 5 | verbosity |
numeric | Optional | 0 | See CLI help for details |
Examples
raptoreum-cli getspecialtxes "00000000000fd08c2fb661d2fcb0d49abb3a91e5f27082ce64feed3b4dede2e2"
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getspecialtxes", "params": ["00000000000fd08c2fb661d2fcb0d49abb3a91e5f27082ce64feed3b4dede2e2"] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
getspentinfo
Returns the txid and index where an output is spent.
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
| 1 | request |
json object | Optional | [] | See CLI help for details |
Result
{ (json object)
"txid" : "hex", (string) The transaction id
"index" : n (numeric) The spending input index
}
Examples
raptoreum-cli getspentinfo '{"txid": "0437cd7f8525ceed2324359c2d0ba26006d92d856a9c20fa0241106ee5a597c9", "index": 0}'
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getspentinfo", "params": [{"txid": "0437cd7f8525ceed2324359c2d0ba26006d92d856a9c20fa0241106ee5a597c9", "index": 0}] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
gettxout
Returns details about an unspent transaction output.
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
| 3 | include_mempool |
boolean | Optional | true | See CLI help for details |
Result
{ (json object)
"bestblock" : "hex", (string) The hash of the block at the tip of the chain
"confirmations" : n, (numeric) The number of confirmations
"value" : n, (numeric) The transaction value in RTM
"scriptPubKey" : { (json object)
"asm" : "hex", (string)
"hex" : "hex", (string)
"reqSigs" : n, (numeric) Number of required signatures
"type" : "hex", (string) The type, eg pubkeyhash
"addresses" : [ (json array) array of Raptoreum addresses
"str", (string) Raptoreum address
...
]
},
"coinbase" : true|false (boolean) Coinbase or not
}
Examples
Get unspent transactions
raptoreum-cli listunspent
View the details
raptoreum-cli gettxout "txid" 1
As a json rpc call
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "gettxout", "params": ["txid", 1] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
gettxoutproof
Returns a hex-encoded proof that "txid" was included in a block.
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
Result
"str" (string) A string that is a serialized, hex-encoded data for the proof.
Examples
raptoreum-cli gettxoutproof '["mytxid",...]'
raptoreum-cli gettxoutproof '["mytxid",...]' "blockhash"
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "gettxoutproof", "params": [["mytxid",...], "blockhash"] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
gettxoutsetinfo
Returns statistics about the unspent transaction output set.
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
| 1 | hash_type |
string | Optional | hash_serialized_2) Which UTXO set hash should be calculated. Options: 'hash_serialized_2' (the legacy algorithm | See CLI help for details |
Result
{ (json object)
"height" : n, (numeric) The current block height (index)
"bestblock" : "hex", (string) The hash of the block at the tip of the chain
"transactions" : n, (numeric) The number of transactions with unspent outputs
"txouts" : n, (numeric) The number of unspent transaction outputs
"bogosize" : n, (numeric) A meaningless metric for UTXO set size
"hash_serialized_2" : "hex", (string, optional) The serialized hash (only present if 'hash_serialized_2' hash_type is chosen)
"disk_size" : n, (numeric) The estimated size of the chainstate on disk
"total_amount" : n (numeric) The total amount
}
Examples
raptoreum-cli gettxoutsetinfo
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "gettxoutsetinfo", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
preciousblock
Treats a block as if it were received before others with the same work.
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
Result
null (json null)
Examples
raptoreum-cli preciousblock "blockhash"
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "preciousblock", "params": ["blockhash"] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
pruneblockchain
- height (numeric, required) The block height to prune up to. May be set to a discrete height, or to a UNIX epoch time
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
Result
n (numeric) Height of the last block pruned
Examples
raptoreum-cli pruneblockchain 1000
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "pruneblockchain", "params": [1000] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
savemempool
Dumps the mempool to disk. It will fail until the previous dump is fully loaded.
Arguments
No arguments.
Result
null (json null)
Examples
raptoreum-cli savemempool
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "savemempool", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
scantxoutset
EXPERIMENTAL warning: this call may be removed or changed in future releases.
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
Result
{ (json object)
"success" : true|false, (boolean) Whether the scan was completed
"txouts" : n, (numeric) The number of unspent transaction outputs scanned
"height" : n, (numeric) The current block height (index)
"bestblock" : "hex", (string) The hash of the block at the tip of the chain
"unspents" : [ (json array)
{ (json object)
"txid" : "hex", (string) The transaction id
"vout" : n, (numeric) The vout value
"scriptPubKey" : "hex", (string) The script key
"desc" : "str", (string) A specialized descriptor for the matched scriptPubKey
"amount" : n, (numeric) The total amount in RTM of the unspent output
"height" : n (numeric) Height of the unspent transaction output
},
...
],
"total_amount" : n (numeric) The total amount of all found unspent outputs in RTM
}
verifychain
Verifies blockchain database.
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
| 1 | checklevel |
numeric | Optional | 4, range=0-4 | See CLI help for details |
| 2 | nblocks |
numeric | Optional | 50, 0=all | See CLI help for details |
Result
true|false (boolean) Verified or not
Examples
raptoreum-cli verifychain
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "verifychain", "params": [] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/
verifytxoutproof
Verifies that a proof points to a transaction in a block, returning the transaction it commits to
Arguments
| Position | Name | Type | Required | Default | Description |
|---|---|---|---|---|---|
Result
[ (json array)
"hex", (string) The txid(s) which the proof commits to, or empty array if the proof can not be validated.
...
]
Examples
raptoreum-cli verifytxoutproof "proof"
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "gettxoutproof", "params": ["proof"] }' -H 'content-type: text/plain;' http://127.0.0.1:10225/