Merge branch 'master' into estimatepriority

This commit is contained in:
Jonathan Cross 2017-05-10 16:39:51 +02:00 committed by GitHub
commit 96b7cce4b4
53 changed files with 1167 additions and 152 deletions

View file

@ -9,13 +9,13 @@ http://opensource.org/licenses/MIT.
{% autocrossref %}
* [GET Block][rest get block] {{summary_restGetBlock}} {{NEW0_10_0}}, {{UPDATED0_13_0}}
* [GET Block/NoTxDetails][rest get block-notxdetails] {{summary_restGetBlock-noTxDetails}} {{NEW0_10_0}}, {{UPDATED0_13_0}}
* [GET Block][rest get block] {{summary_restGetBlock}} {{UPDATED0_13_0}}
* [GET Block/NoTxDetails][rest get block-notxdetails] {{summary_restGetBlock-noTxDetails}} {{UPDATED0_13_0}}
* [GET ChainInfo][rest get chaininfo] {{summary_restGetChainInfo}} {{NEW0_11_0}}, {{UPDATED0_12_0}}
* [GET GetUtxos][rest get getutxos] {{summary_restGetGetUtxos}} {{NEW0_11_0}}
* [GET Headers][rest get headers] {{summary_restGetHeaders}} {{NEW0_11_0}}, {{UPDATED0_13_0}}
* [GET MemPool/Contents][rest get mempool-contents] {{summary_restGetMemPool-contents}} {{NEW0_12_0}}
* [GET MemPool/Info][rest get mempool-info] {{summary_restGetMemPool-info}} {{NEW0_12_0}}
* [GET Tx][rest get tx] {{summary_restGetTx}} {{NEW0_10_0}}, {{UPDATED0_13_0}}
* [GET Tx][rest get tx] {{summary_restGetTx}} {{UPDATED0_13_0}}
{% endautocrossref %}

View file

@ -11,7 +11,7 @@ http://opensource.org/licenses/MIT.
{% autocrossref %}
The `GET tx` operation {{summary_restTx}}
The `GET tx` operation {{summary_restGetTx}}
{{reindexNote}}

View file

@ -16,11 +16,16 @@ changes made more than two years ago.
Use v0.n.n in abbreviation title to prevent autocrossrefing.
{% endcomment %}
<!-- master -->
{% assign NEW_MASTER='**<abbr title="New in Bitcoin Cores master branch (unreleased)">New in master</abbr>**' %}
{% assign UPDATED_MASTER='**<abbr title="Updated in Bitcoin Cores master branch (unreleased)">Updated in master</abbr>**' %}
<!-- Deprecated -->
{% assign DEPRECATED='**<abbr title="Deprecated; will be removed in a future version of Bitcoin Core">Deprecated</abbr>**' %}
<!-- Bitcoin Core 0.14.1 April 2017 -->
{% assign UPDATED0_14_0='**<abbr title="Updated in Bitcoin Core v0.14.1">Updated in 0.14.1</abbr>**' %}
<!-- Bitcoin Core 0.14.0 March 2017 -->
{% assign NEW0_14_0='**<abbr title="New in Bitcoin Core v0.14.0">New in 0.14.0</abbr>**' %}
{% assign UPDATED0_14_0='**<abbr title="Updated in Bitcoin Core v0.14.0">Updated in 0.14.0</abbr>**' %}
<!-- Bitcoin Core 0.13.1 September 2016 -->
{% assign UPDATED0_13_1='*<abbr title="Updated in Bitcoin Core v0.13.1">Updated in 0.13.1</abbr>*' %}
@ -38,10 +43,6 @@ Use v0.n.n in abbreviation title to prevent autocrossrefing.
<!-- Bitcoin Core 0.11.0 July 2015 -->
{% assign NEW0_11_0='*<abbr title="New in Bitcoin Core v0.11.0">New in 0.11.0</abbr>*' %}
<!-- Bitcoin Core 0.10.0 February 2015 -->
{% assign NEW0_10_0='*<abbr title="New in Bitcoin Core v0.10.0">New in 0.10.0</abbr>*' %}
{% assign UPDATED0_10_0='*<abbr title="Updated in Bitcoin Core v0.10.0">Updated in 0.10.0</abbr>*' %}
<!-- the summaries used below are defined in the files for the
particular RPC and aggregated into this helper file by the makefile
function manual-update-summaries-file. For example, to edit the
@ -61,16 +62,18 @@ Use v0.n.n in abbreviation title to prevent autocrossrefing.
* [GetBlockCount][rpc getblockcount]: {{summary_getBlockCount}}
* [GetBlockHash][rpc getblockhash]: {{summary_getBlockHash}}
* [GetBlockHeader][rpc getblockheader]: {{summary_getBlockHeader}} {{NEW0_12_0}}
* [GetChainTips][rpc getchaintips]: {{summary_getChainTips}} {{NEW0_10_0}}
* [GetChainTips][rpc getchaintips]: {{summary_getChainTips}}
* [GetDifficulty][rpc getdifficulty]: {{summary_getDifficultly}}
* [GetMemPoolAncestors][rpc getmempoolancestors]: {{summary_getMemPoolAncestors}} {{NEW0_13_0}}
* [GetMemPoolDescendants][rpc getmempooldescendants]: {{summary_getMemPoolDescendants}} {{NEW0_13_0}}
* [GetMemPoolEntry][rpc getmempoolentry]: {{summary_getMemPoolEntry}} {{NEW0_13_0}}
* [GetMemPoolInfo][rpc getmempoolinfo]: {{summary_getMemPoolInfo}} {{NEW0_10_0}}, {{UPDATED0_12_0}}
* [GetMemPoolInfo][rpc getmempoolinfo]: {{summary_getMemPoolInfo}} {{UPDATED0_12_0}}
* [GetRawMemPool][rpc getrawmempool]: {{summary_getRawMemPool}} {{UPDATED0_13_0}}
* [GetTxOut][rpc gettxout]: {{summary_getTxOut}}
* [GetTxOutProof][rpc gettxoutproof]: {{summary_getTxOutProof}} {{NEW0_11_0}}
* [GetTxOutSetInfo][rpc gettxoutsetinfo]: {{summary_getTxOutSetInfo}}
* [PreciousBlock][rpc preciousblock]: {{summary_preciousBlock}} {{NEW0_14_0}}
* [PruneBlockChain][rpc pruneblockchain]: {{summary_pruneBlockChain}} {{NEW0_14_0}}
* [VerifyChain][rpc verifychain]: {{summary_verifyChain}}
* [VerifyTxOutProof][rpc verifytxoutproof]: {{summary_verifyTxOutProof}} {{NEW0_11_0}}
@ -82,7 +85,7 @@ Use v0.n.n in abbreviation title to prevent autocrossrefing.
{% autocrossref %}
* [GetInfo][rpc getinfo]: {{summary_getInfo}} {{UPDATED0_10_0}}, {{DEPRECATED}}
* [GetInfo][rpc getinfo]: {{summary_getInfo}} {{DEPRECATED}}
* [Help][rpc help]: {{summary_help}}
* [Stop][rpc stop]: {{summary_stop}}
@ -106,9 +109,9 @@ Use v0.n.n in abbreviation title to prevent autocrossrefing.
{% autocrossref %}
* [GetBlockTemplate][rpc getblocktemplate]: {{summary_getBlockTemplate}}
* [GetMiningInfo][rpc getmininginfo]: {{summary_getMiningInfo}} {{UPDATED0_13_0}}
* [GetMiningInfo][rpc getmininginfo]: {{summary_getMiningInfo}} {{UPDATED0_14_0}}
* [GetNetworkHashPS][rpc getnetworkhashps]: {{summary_getNetworkHashPS}}
* [PrioritiseTransaction][rpc prioritisetransaction]: {{summary_prioritiseTransaction}} {{NEW0_10_0}}
* [PrioritiseTransaction][rpc prioritisetransaction]: {{summary_prioritiseTransaction}}
* [SubmitBlock][rpc submitblock]: {{summary_submitBlock}}
{% endautocrossref %}
@ -119,10 +122,10 @@ Use v0.n.n in abbreviation title to prevent autocrossrefing.
{% autocrossref %}
* [AddNode][rpc addnode]: {{summary_addNode}}
* [AddNode][rpc addnode]: {{summary_addNode}} {{UPDATED0_14_0}}
* [ClearBanned][rpc clearbanned]: {{summary_clearBanned}} {{NEW0_12_0}}
* [DisconnectNode][rpc disconnectnode]: {{summary_disconnectNode}} {{NEW0_12_0}}
* [GetAddedNodeInfo][rpc getaddednodeinfo]: {{summary_getAddedNodeInfo}}
* [DisconnectNode][rpc disconnectnode]: {{summary_disconnectNode}} {{NEW0_12_0}} {{UPDATED0_14_1}}
* [GetAddedNodeInfo][rpc getaddednodeinfo]: {{summary_getAddedNodeInfo}} {{UPDATED0_14_0}}
* [GetConnectionCount][rpc getconnectioncount]: {{summary_getConnectionCount}}
* [GetNetTotals][rpc getnettotals]: {{summary_getNetTotals}} {{UPDATED0_12_0}}
* [GetNetworkInfo][rpc getnetworkinfo]: {{summary_getNetworkInfo}} {{UPDATED0_13_0}}
@ -130,6 +133,7 @@ Use v0.n.n in abbreviation title to prevent autocrossrefing.
* [ListBanned][rpc listbanned]: {{summary_listBanned}} {{NEW0_12_0}}
* [Ping][rpc ping]: {{summary_ping-rpc}}
* [SetBan][rpc setban]: {{summary_setBan}} {{NEW0_12_0}}
* [SetNetworkActive][rpc setnetworkactive]: {{summary_setNetworkActive}} {{NEW0_14_0}}
{% endautocrossref %}
@ -139,11 +143,11 @@ Use v0.n.n in abbreviation title to prevent autocrossrefing.
{% autocrossref %}
* [CreateRawTransaction][rpc createrawtransaction]: {{summary_createRawTransaction}} {{UPDATED0_12_0}}
* [FundRawTransaction][rpc fundrawtransaction]: {{summary_fundRawTransaction}} {{NEW0_12_0}}, {{UPDATED0_13_0}}
* [CreateRawTransaction][rpc createrawtransaction]: {{summary_createRawTransaction}} {{UPDATED0_14_1}}
* [FundRawTransaction][rpc fundrawtransaction]: {{summary_fundRawTransaction}} {{NEW0_12_0}}, {{UPDATED0_14_0}}
* [DecodeRawTransaction][rpc decoderawtransaction]: {{summary_decodeRawTransaction}} {{UPDATED0_13_0}}
* [DecodeScript][rpc decodescript]: {{summary_decodeScript}}
* [GetRawTransaction][rpc getrawtransaction]: {{summary_getRawTransaction}} {{UPDATED0_13_0}}
* [GetRawTransaction][rpc getrawtransaction]: {{summary_getRawTransaction}} {{UPDATED0_14_0}}
* [SendRawTransaction][rpc sendrawtransaction]: {{summary_sendRawTransaction}}
* [SignRawTransaction][rpc signrawtransaction]: {{summary_signRawTransaction}}
@ -156,8 +160,9 @@ Use v0.n.n in abbreviation title to prevent autocrossrefing.
{% autocrossref %}
* [CreateMultiSig][rpc createmultisig]: {{summary_createMultiSig}}
* [EstimateFee][rpc estimatefee]: {{summary_estimateFee}} {{NEW0_10_0}}
* [EstimatePriority][rpc estimatepriority]: {{summary_estimatePriority}} {{NEW0_10_0}}, {{DEPRECATED}}
* [EstimateFee][rpc estimatefee]: {{summary_estimateFee}} {{UPDATED0_14_0}}
* [EstimatePriority][rpc estimatepriority]: {{summary_estimatePriority}} {{DEPRECATED}}
* [GetMemoryInfo][rpc getmemoryinfo]: {{summary_getMemoryInfo}} {{NEW_14_0}}
* [ValidateAddress][rpc validateaddress]: {{summary_validateAddress}} {{UPDATED0_13_0}}
* [VerifyMessage][rpc verifymessage]: {{summary_verifyMessage}}
@ -177,6 +182,7 @@ default.
* [AddWitnessAddress][rpc addwitnessaddress]: {{summary_addWitnessAddress}} {{NEW0_13_0}}
* [AddMultiSigAddress][rpc addmultisigaddress]: {{summary_addMultiSigAddress}}
* [BackupWallet][rpc backupwallet]: {{summary_backupWallet}}
* [BumpFee][rpc bumpfee]: {{summary_bumpFee}} {{NEW0_14_0}}
* [DumpPrivKey][rpc dumpprivkey]: {{summary_dumpPrivKey}}
* [DumpWallet][rpc dumpwallet]: {{summary_dumpWallet}}
* [EncryptWallet][rpc encryptwallet]: {{summary_encryptWallet}}
@ -191,17 +197,18 @@ default.
* [GetTransaction][rpc gettransaction]: {{summary_getTransaction}} {{UPDATED0_12_0}}
* [GetUnconfirmedBalance][rpc getunconfirmedbalance]: {{summary_getUnconfirmedBalance}}
* [GetWalletInfo][rpc getwalletinfo]: {{summary_getWalletInfo}}
* [ImportAddress][rpc importaddress]: {{summary_importAddress}} {{NEW0_10_0}}
* [ImportAddress][rpc importaddress]: {{summary_importAddress}}
* [ImportMulti][rpc importmulti]: {{summary_importMulti}} {{NEW0_14_0}}
* [ImportPrunedFunds][rpc importprunedfunds]: {{summary_importPrunedFunds}} {{NEW0_13_0}}
* [ImportPrivKey][rpc importprivkey]: {{summary_importPrivKey}}
* [ImportWallet][rpc importwallet]: {{summary_importWallet}}
* [KeyPoolRefill][rpc keypoolrefill]: {{summary_keyPoolRefill}}
* [ListAccounts][rpc listaccounts]: {{summary_listAccounts}} {{UPDATED0_10_0}}, {{DEPRECATED}}
* [ListAccounts][rpc listaccounts]: {{summary_listAccounts}} {{DEPRECATED}}
* [ListAddressGroupings][rpc listaddressgroupings]: {{summary_listAddressGroupings}}
* [ListLockUnspent][rpc listlockunspent]: {{summary_listLockUnspent}}
* [ListReceivedByAccount][rpc listreceivedbyaccount]: {{summary_listReceivedByAccount}} {{UPDATED0_10_0}}, {{DEPRECATED}}
* [ListReceivedByAddress][rpc listreceivedbyaddress]: {{summary_listReceivedByAddress}} {{UPDATED0_10_0}}
* [ListSinceBlock][rpc listsinceblock]: {{summary_listSinceBlock}} {{UPDATED0_10_0}}
* [ListReceivedByAccount][rpc listreceivedbyaccount]: {{summary_listReceivedByAccount}} {{DEPRECATED}}
* [ListReceivedByAddress][rpc listreceivedbyaddress]: {{summary_listReceivedByAddress}}
* [ListSinceBlock][rpc listsinceblock]: {{summary_listSinceBlock}}
* [ListTransactions][rpc listtransactions]: {{summary_listTransactions}} {{UPDATED0_12_1}}
* [ListUnspent][rpc listunspent]: {{summary_listUnspent}} {{UPDATED0_13_0}}
* [LockUnspent][rpc lockunspent]: {{summary_lockUnspent}}

View file

@ -29,7 +29,7 @@ The `addnode` RPC {{summary_addNode}}
- n: "Command"
t: "string"
p: "Required<br>(exactly 1)"
d: "What to do with the IP address above. Options are:<br>`add` to add a node to the addnode list. This will not connect immediately if the outgoing connection slots are full<br>`remove` to remove a node from the list. If currently connected, this will disconnect immediately<br>`onetry` to immediately attempt connection to the node even if the outgoing connection slots are full; this will only attempt the connection once"
d: "What to do with the IP address above. Options are:<br>`add` to add a node to the addnode list. Up to 8 nodes can be added additional to the default 8 nodes. Not limited by `-maxconnections`<br>`remove` to remove a node from the list. If currently connected, this will disconnect immediately<br>`onetry` to immediately attempt connection to the node even if the outgoing connection slots are full; this will only attempt the connection once"
{% enditemplate %}

View file

@ -7,14 +7,13 @@ http://opensource.org/licenses/MIT.
##### AddWitnessAddress
{% include helpers/subhead-links.md %}
{% assign summary_addWitnessAddress="adds a witness address for a script (with pubkey or redeemscript known)." %}
{% assign summary_addWitnessAddress="adds a witness address for a script (with pubkey or redeem script known)." %}
{% autocrossref %}
*Added in Bitcoin Core 0.13.0*
*Requires wallet support. Requires an unlocked wallet or an
unencrypted wallet.*
*Requires wallet support. Requires an unlocked wallet or an unencrypted wallet.*
The `addwitnessaddress` RPC {{summary_addWitnessAddress}}
@ -46,7 +45,7 @@ bitcoin-cli addwitnessaddress 1BRo7qrYHMPrzdBDzfjmzteBdYAyTMXW75
Result:
The RPC is disabled by default on mainet as long as Segregated Witness has not been activated.
The RPC is disabled by default on mainnet as long as Segregated Witness has not been activated.
`-walletprematurewitness` enables the RPC.
{% highlight text %}
@ -55,4 +54,7 @@ The RPC is disabled by default on mainet as long as Segregated Witness has not b
*See also*
* [BIP-141 - Segregated Witness](https://github.com/bitcoin/bips/blob/master/bip-0141.mediawiki)
* [BIP-142 - Address Format for Segregated Witness](https://github.com/bitcoin/bips/blob/master/bip-0142.mediawiki)
{% endautocrossref %}

View file

@ -0,0 +1,116 @@
{% comment %}
This file is licensed under the MIT License (MIT) available on
http://opensource.org/licenses/MIT.
{% endcomment %}
{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/bumpfee.md" %}
##### BumpFee
{% include helpers/subhead-links.md %}
{% assign summary_bumpFee="replaces an unconfirmed wallet transaction that signaled RBF with a new transaction that pays a higher fee." %}
{% autocrossref %}
*Added in Bitcoin Core 0.14.0*
*Requires wallet support. Wallet must be unlocked.*
The `bumpfee` RPC {{summary_bumpFee}} The increased fee is deducted from the change output. The command fails if the change output is too small to increase the fee or
if the wallet or mempool contains a transaction that spends one of the transaction's outputs. The `-walletrbf` option needs to be enabled (default is `false`).
*Parameter #1---The TXID of the transaction*
{% itemplate ntpd1 %}
- n: "TXID"
t: "string (hex)"
p: "Required<br>(exactly 1)"
d: "The id of the transaction"
{% enditemplate %}
*Parameter #2---Additional options*
{% itemplate ntpd1 %}
- n: "Options"
t: "Object"
p: "Optional<br>(0 or 1)"
d: "Additional options"
- n: "→ <br>`confTarget`"
t: "numeric (int)"
p: "Optional<br>(0 or 1)"
d: "The confirmation target in blocks. Based on this value the new fee will be calculated using the same code as the `estimatefee` RPC. If not set, the default target of ´6´ blocks will be used"
- n: "→ <br>`totalFee`"
t: "numeric (satoshis)"
p: "Optional<br>(0 or 1)"
d: "The total fee to pay in satoshis (not the feerate). The actual fee can be higher in rare cases if the change output is close to the dust limit"
- n: "→ <br>`replaceable`"
t: "bool"
p: "Optional<br>(0 or 1)"
d: "Whether the new transaction should still be BIP 125 replaceable. Even if set to `false` the transaction may still be replacable, for example if it has unconfirmed ancestors which are replaceable. The default is `true`"
{% enditemplate %}
*Result---information about the new transaction*
{% itemplate ntpd1 %}
- n: "`result`"
t: "object"
p: "Required<br>(exactly 1)"
d: "An object including information about the new transaction"
- n: "→ <br>`txid`"
t: "string (hex)"
p: "Required<br>(exactly 1)"
d: "The id of the new transaction"
- n: "→ <br>`origfee`"
t: "numeric (bitcoins)"
p: "Required<br>(exactly 1)"
d: "The fee of the replaced transaction"
- n: "→ <br>`fee`"
t: "numeric (bitcoins)"
p: "Required<br>(exactly 1)"
d: "The fee of the new transaction"
- n: "→ <br>`errors`"
t: "array"
p: "Required<br>(exactly 1)"
d: "Errors encountered during processing (may be empty)"
{% enditemplate %}
*Example from Bitcoin Core 0.14.1*
{% highlight bash %}
bitcoin-cli -testnet bumpfee d4a33e0cabaz723149e1fcab4e033a40173\
88a644c65370e3cb06ba2f0e13975\
'{
"totalFee": 4000,
"replaceable": false
}'
{% endhighlight %}
Result:
{% highlight json %}
{
"txid": "37a55ce49636977k79bcb04ee1143573b570b1743e09660e79e7ec3320968ca54",
"origfee": 0.00002450,
"fee": 0.00004000,
"errors": ""
}
{% endhighlight %}
*See also*
* [CreateRawTransaction][rpc createrawtransaction]: {{summary_createRawTransaction}}
* [FundRawTransaction][rpc fundrawtransaction]: {{summary_fundRawTransaction}}
* [SignRawTransaction][rpc signrawtransaction]: {{summary_signRawTransaction}}
* [SendRawTransaction][rpc sendrawtransaction]: {{summary_sendRawTransaction}}
* [Serialized Transaction Format][raw transaction format]
{% endautocrossref %}

View file

@ -13,28 +13,33 @@ http://opensource.org/licenses/MIT.
The `createrawtransaction` RPC {{summary_createRawTransaction}}
*Parameter #1---references to previous outputs*
*Parameter #1---Inputs*
{% itemplate ntpd1 %}
- n: "Outpoints"
- n: "Inputs"
t: "array"
p: "Required<br>(exactly 1)"
d: "An array of objects, each one being an unspent outpoint"
d: "An array of objects, each one to be used as an input to the transaction"
- n: "→ Outpoint"
- n: "→ Input"
t: "object"
p: "Required<br>(1 or more)"
d: "An object describing a particular unspent outpoint"
d: "An object describing a particular input"
- n: "→ →<br>`txid`"
t: "string (hex)"
p: "Required<br>(exactly 1)"
d: "The TXID of the outpoint encoded as hex in RPC byte order"
d: "The TXID of the outpoint to be spent encoded as hex in RPC byte order"
- n: "→ →<br>`vout`"
t: "number (int)"
p: "Required<br>(exactly 1)"
d: "The output index number (vout) of the outpoint; the first output in a transaction is index `0`"
d: "The output index number (vout) of the outpoint to be spent; the first output in a transaction is index `0`"
- n: "→ →<br>`Sequence`"
t: "number (int)"
p: "Optional<br>(0 or 1)"
d: "The sequence number to use for the input"
{% enditemplate %}

View file

@ -7,7 +7,7 @@ http://opensource.org/licenses/MIT.
##### DisconnectNode
{% include helpers/subhead-links.md %}
{% assign summary_disconnectnode="immediately disconnects from a specified node." %}
{% assign summary_disconnectNode="immediately disconnects from a specified node." %}
{% autocrossref %}
@ -18,10 +18,10 @@ The `disconnectnode` RPC {{summary_disconnectNode}}
*Parameter #1---hostname/IP address and port of node to disconnect*
{% itemplate ntpd1 %}
- n: "Node"
- n: "Address"
t: "string"
p: "Required<br>(exactly 1)"
d: "The node you want to disconnect from as a string in the form of `<IP address>:<port>`. The IP address may be a hostname resolvable through DNS, an IPv4 address, an IPv4-as-IPv6 address, or an IPv6 address"
d: "*Updated in Bitcoin Core 0.14.1*<br><br>The node you want to disconnect from as a string in the form of `<IP address>:<port>`. The IP address may be a hostname resolvable through DNS, an IPv4 address, an IPv4-as-IPv6 address, or an IPv6 address"
{% enditemplate %}
@ -35,7 +35,7 @@ The `disconnectnode` RPC {{summary_disconnectNode}}
{% enditemplate %}
*Example from Bitcoin Core 0.12.1*
*Example from Bitcoin Core 0.14.1*
Disconnects following node from your node.
@ -47,6 +47,7 @@ Result (no output from `bitcoin-cli` because result is set to `null`).
*See also*
* [AddNode][rpc addnode]: {{summary_addNode}}
* [GetAddedNodeInfo][rpc getaddednodeinfo]: {{summary_getAddedNodeInfo}}
{% endautocrossref %}

View file

@ -11,8 +11,6 @@ http://opensource.org/licenses/MIT.
{% autocrossref %}
*Added in Bitcoin Core 0.10.0.*
The `estimatefee` RPC {{summary_estimateFee}}
*Parameter #1---how many blocks the transaction may wait before being included*
@ -21,7 +19,7 @@ The `estimatefee` RPC {{summary_estimateFee}}
- n: "Blocks"
t: "number (int)"
p: "Required<br>(exactly 1)"
d: "The maximum number of blocks a transaction should have to wait before it is predicted to be included in a block"
d: "The maximum number of blocks a transaction should have to wait before it is predicted to be included in a block. Has to be between 2 and 25 blocks"
{% enditemplate %}
@ -35,7 +33,7 @@ The `estimatefee` RPC {{summary_estimateFee}}
{% enditemplate %}
*Examples from Bitcoin Core 0.10.0*
*Examples from Bitcoin Core 0.14.1*
{% highlight bash %}
bitcoin-cli estimatefee 6
@ -44,10 +42,10 @@ bitcoin-cli estimatefee 6
Result:
{% highlight json %}
0.00026809
0.00162556
{% endhighlight %}
Requesting data the node can't calculate yet:
Requesting data the node can't calculate (out of range):
{% highlight bash %}
bitcoin-cli estimatefee 100
@ -56,12 +54,11 @@ bitcoin-cli estimatefee 100
Result:
{% highlight json %}
-1.00000000
-1
{% endhighlight %}
*See also*
* [EstimatePriority][rpc estimatepriority]: {{summary_estimatePriority}}
* [SetTxFee][rpc settxfee]: {{summary_setTxFee}}
{% endautocrossref %}

View file

@ -55,11 +55,21 @@ All existing inputs must have their previous output transaction be in the wallet
p: "Optional<br>(0 or 1)"
d: "The selected outputs are locked after running the rpc call. The default is `false`"
- n: "→ <br>`reserveChangeKey`"
t: "bool"
p: "Optional<br>(0 or 1)"
d: "*Added in Bitcoin Core 0.14.0*<br><br>Reserves the change output key from the keypool. The default is `true`. Before 0.14.0, the used keypool key was never marked as change-address key and directly returned to the keypool (leading to address reuse)."
- n: "→ <br>`feeRate`"
t: "numeric (bitcoins)"
p: "Optional<br>(0 or 1)"
d: "The specific feerate you are willing to pay(BTC per KB). If not set, the wallet determines the fee"
- n: "→ <br>`subtractFeeFromOutputs`"
t: "array"
p: "Optional<br>(0 or 1)"
d: "A json array of integers. The fee will be equally deducted from the amount of each specified output. The outputs are specified by their zero-based index, before any change output is added."
{% enditemplate %}
*Result---information about the created transaction*
@ -94,13 +104,13 @@ bitcoin-cli -testnet fundrawtransaction 01000000011da9283b4ddf8d\
89eb996988b89ead56cecdc44041ab38bf787f1206cd90b51e0000000000ffff\
ffff01405dc600000000001976a9140dfc8bafc8419853b34d5e072ad37d1a51\
59f58488ac00000000
{
'{
"changeAddress": "15gJiApWFGTN2iTteQwQbqasdT6dwGWwv6",
"changePosition" : "",
"includeWatching" : false,
"lockUnspents" : true,
"feeRate" : 0.0001
}
"changePosition" : 1,
"includeWatching" : false,
"lockUnspents" : true,
"feeRate" : 0.0001
}'
{% endhighlight %}
Result:

View file

@ -19,7 +19,7 @@ The `getaddednodeinfo` RPC {{summary_getAddedNodeInfo}}
- n: "Details"
t: "bool"
p: "Required<br>(exactly 1)"
d: "Set to `true` to display detailed information about each added node; set to `false` to only display the IP address or hostname and port added"
d: "*Removed in Bitcoin Core 0.14.0*<br><br>Set to `true` to display detailed information about each added node; set to `false` to only display the IP address or hostname and port added"
{% enditemplate %}
@ -78,10 +78,10 @@ The `getaddednodeinfo` RPC {{summary_getAddedNodeInfo}}
{% enditemplate %}
*Example from Bitcoin Core 0.10.0*
*Example from Bitcoin Core 0.14.1*
{% highlight bash %}
bitcoin-cli -testnet getaddednodeinfo true
bitcoin-cli getaddednodeinfo
{% endhighlight %}
Result (real hostname and IP address replaced):
@ -89,11 +89,11 @@ Result (real hostname and IP address replaced):
{% highlight json %}
[
{
"addednode" : "bitcoind.example.com:18333",
"addednode" : "bitcoind.example.com:8333",
"connected" : true,
"addresses" : [
{
"address" : "192.0.2.113:18333",
"address" : "192.0.2.113:8333",
"connected" : "outbound"
}
]

View file

@ -23,7 +23,7 @@ The `getblock` RPC {{summary_getBlock}}
{% enditemplate %}
*Parameter #2---JSON or hex output*
*Parameter #2---whether to get JSON or hex output*
{% itemplate ntpd1 %}
- n: "Format"

View file

@ -36,7 +36,7 @@ The `getblockchaininfo` RPC {{summary_getBlockChainInfo}}
- n: "→<br>`headers`"
t: "number (int)"
p: "Required<br>(exactly 1)"
d: "*Added in Bitcoin Core 0.10.0*<br><br>The number of validated headers in the local best headers chain. For a new node with just the hardcoded genesis block, this will be zero. This number may be higher than the number of *blocks*"
d: "The number of validated headers in the local best headers chain. For a new node with just the hardcoded genesis block, this will be zero. This number may be higher than the number of *blocks*"
- n: "→<br>`bestblockhash`"
t: "string (hex)"
@ -55,7 +55,7 @@ The `getblockchaininfo` RPC {{summary_getBlockChainInfo}}
- n: "→<br>`verificationprogress`"
t: "number (real)"
p: "Required (exactly 1)"
p: "Required<br>(exactly 1)"
d: "Estimate of what percentage of the block chain transactions have been verified so far, starting at 0.0 and increasing to 1.0 for fully verified. May slightly exceed 1.0 when fully synced to account for transactions in the memory pool which have been verified before being included in a block"
- n: "→<br>`chainwork`"
@ -173,12 +173,17 @@ The `getblockchaininfo` RPC {{summary_getBlockChainInfo}}
p: "Required<br>(exactly 1)"
d: "The Unix epoch time at which the deployment is considered failed if not yet locked in"
- n: "→ → →<br>`since`"
t: "numeric<br>(int)"
p: "Required<br>(exactly 1)"
d: "*Added in Bitcoin Core 0.14.0*<br><br>The height of the first block to which the status applies"
{% enditemplate %}
*Example from Bitcoin Core 0.13.1*
*Example from Bitcoin Core 0.14.1*
{% highlight bash %}
bitcoin-cli -testnet getblockchaininfo
bitcoin-cli getblockchaininfo
{% endhighlight %}
Result:
@ -186,13 +191,13 @@ Result:
{% highlight json %}
{
"chain": "main",
"blocks": 438737,
"headers": 438740,
"bestblockhash": "0000000000000000038c4b27ae0b591135bde8703ef53f6fa9aa5ec5f07db5a1",
"difficulty": 254620187304.0614,
"mediantime": 1479054813,
"verificationprogress": 0.9999893624230526,
"chainwork": "0000000000000000000000000000000000000000002e732c9db1d0bd82476ae6",
"blocks": 464562,
"headers": 464562,
"bestblockhash": "00000000000000000085bd56990c579a36bade6ea427646612f13476edb30ceb",
"difficulty": 521974519553.6282,
"mediantime": 1493758169,
"verificationprogress": 0.999989733170878,
"chainwork": "00000000000000000000000000000000000000000052c26f32ffa22706efd28c",
"pruned": false,
"softforks": [
{
@ -221,15 +226,19 @@ Result:
"csv": {
"status": "active",
"startTime": 1462060800,
"timeout": 1493596800
"timeout": 1493596800,
"since": 419328
},
"segwit": {
"status": "defined",
"status": "started",
"bit": 1,
"startTime": 1479168000,
"timeout": 1510704000
"timeout": 1510704000,
"since": 439488
}
}
}
{% endhighlight %}
*See also*

View file

@ -11,8 +11,6 @@ http://opensource.org/licenses/MIT.
{% autocrossref %}
*Added in Bitcoin Core 0.10.0.*
The `getchaintips` RPC {{summary_getChainTips}}
*Parameters: none*

View file

@ -74,7 +74,7 @@ Core. Use the RPCs listed in the See Also subsection below instead.
- n: "→<br>`testnet`"
t: "bool"
p: "Required<br>(exactly 1)"
d: "*Added in Bitcoin Core 0.10.0*<br><br>Set to `true` if this node is on testnet; set to `false` if this node is on mainnet or a regtest"
d: "Set to `true` if this node is on testnet; set to `false` if this node is on mainnet or a regtest"
- n: "→<br>`keypoololdest`"
t: "number (int)"

View file

@ -0,0 +1,91 @@
{% comment %}
This file is licensed under the MIT License (MIT) available on
http://opensource.org/licenses/MIT.
{% endcomment %}
{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/getmemoryinfo.md" %}
##### GetMemoryInfo
{% include helpers/subhead-links.md %}
{% assign summary_getMemoryInfo="returns information about memory usage." %}
{% autocrossref %}
*Added in Bitcoin Core 0.14.0*
The `getmemoryinfo` RPC {{summary_getMemoryInfo}}
*Parameters: none*
*Result---information about memory usage*
{% itemplate ntpd1 %}
- n: "`result`"
t: "object"
p: "Required<br>(exactly 1)"
d: "An object containing information about memory usage"
- n: "→<br>`locked`"
t: "string : object"
p: "Required<br>(exactly 1)"
d: "An object containing information about locked memory manager"
- n: "→→<br>`used`"
t: "number (int)"
p: "Required<br>(exactly 1)"
d: "Number of bytes used"
- n: "→→<br>`free`"
t: "number (int)"
p: "Required<br>(exactly 1)"
d: "Number of bytes available in current arenas"
- n: "→→<br>`total`"
t: "number (int)"
p: "Required<br>(exactly 1)"
d: "Total number of bytes managed"
- n: "→→<br>`locked`"
t: "number (int)"
p: "Required<br>(exactly 1)"
d: "Amount of bytes that succeeded locking"
- n: "→→<br>`chunks_used`"
t: "number (int)"
p: "Required<br>(exactly 1)"
d: "Number allocated chunks"
- n: "→→<br>`chunks_free`"
t: "number (int)"
p: "Required<br>(exactly 1)"
d: "Number unused chunks"
{% enditemplate %}
*Example from Bitcoin Core 0.14.1*
{% highlight bash %}
bitcoin-cli getmemoryinfo
{% endhighlight %}
Result:
{% highlight json %}
{
"locked": {
"used": 0,
"free": 65536,
"total": 65536,
"locked": 65536,
"chunks_used": 0,
"chunks_free": 1
}
}
{% endhighlight %}
*See also*
* [GetMemPoolInfo][rpc getmempoolinfo]: {{summary_getMemPoolInfo}}
{% endautocrossref %}

View file

@ -11,8 +11,6 @@ http://opensource.org/licenses/MIT.
{% autocrossref %}
*Added in Bitcoin Core 0.10.0*
The `getmempoolinfo` RPC {{summary_getMemPoolInfo}}
*Parameters: none*
@ -52,7 +50,7 @@ The `getmempoolinfo` RPC {{summary_getMemPoolInfo}}
{% enditemplate %}
*Example from Bitcoin Core 0.12.0*
*Example from Bitcoin Core 0.14.1*
{% highlight bash %}
bitcoin-cli -testnet getmempoolinfo

View file

@ -66,12 +66,12 @@ The `getmininginfo` RPC {{summary_getMiningInfo}}
- n: "→<br>`testnet`"
t: "bool"
p: "Required<br>(exactly 1)"
d: "Set to `true` if this node is running on testnet. Set to `false` if this node is on mainnet or a regtest"
d: "*Removed in Bitcoin Core 0.14.0*<br><br>Set to `true` if this node is running on testnet. Set to `false` if this node is on mainnet or a regtest"
- n: "→<br>`chain`"
t: "string"
p: "Required<br>(exactly 1)"
d: "*Added in Bitcoin Core 0.10.0*<br><br>Set to `main` for mainnet, `test` for testnet, and `regtest` for regtest"
d: "Set to `main` for mainnet, `test` for testnet, and `regtest` for regtest"
- n: "→<br>`generate`"
t: "bool"
@ -85,25 +85,25 @@ The `getmininginfo` RPC {{summary_getMiningInfo}}
{% enditemplate %}
*Example from Bitcoin Core 0.13.1*
*Example from Bitcoin Core 0.14.1*
{% highlight bash %}
bitcoin-cli -testnet getmininginfo
bitcoin-cli getmininginfo
{% endhighlight %}
Result:
{% highlight json %}
{
"blocks" : 313168,
"currentblocksize" : 1819,
"currentblocktx" : 3,
"difficulty" : 1.00000000,
"errors" : "",
"networkhashps" : 5699977416637,
"pooledtx" : 8,
"testnet" : true,
"chain" : "test",
"blocks": 464545,
"currentblocksize": 0,
"currentblockweight": 0,
"currentblocktx": 0,
"difficulty": 521974519553.6282,
"errors": "",
"networkhashps": 4.126888339085874e+18,
"pooledtx": 31241,
"chain": "main"
}
{% endhighlight %}

View file

@ -31,7 +31,7 @@ The `getnetworkinfo` RPC {{summary_getNetworkInfo}}
- n: "→<br>`subversion`"
t: "string"
p: "Required<br>(exactly 1)"
d: "*Added in Bitcoin Core 0.10.0*<br><br>The user agent this node sends in its `version` message"
d: "The user agent this node sends in its `version` message"
- n: "→<br>`protocolversion`"
t: "number (int)"
@ -41,7 +41,7 @@ The `getnetworkinfo` RPC {{summary_getNetworkInfo}}
- n: "→<br>`localservices`"
t: "string (hex)"
p: "Required<br>(exactly 1)"
d: "*Added in Bitcoin Core 0.10.0*<br><br>The services supported by this node as advertised in its `version` message"
d: "The services supported by this node as advertised in its `version` message"
- n: "→<br>`localrelay`"
t: "bool"
@ -61,7 +61,7 @@ The `getnetworkinfo` RPC {{summary_getNetworkInfo}}
- n: "→<br>`networks`"
t: "array"
p: "Required<br>(exactly 1)"
d: "*Added in Bitcoin Core 0.10.0*<br><br>An array with three objects: one describing the IPv4 connection, one describing the IPv6 connection, and one describing the Tor hidden service (onion) connection"
d: "An array with three objects: one describing the IPv4 connection, one describing the IPv6 connection, and one describing the Tor hidden service (onion) connection"
- n: "→ →<br>Network"
t: "object"

View file

@ -31,7 +31,7 @@ The `getpeerinfo` RPC {{summary_getPeerInfo}}
- n: "→ →<br>`id`"
t: "number (int)"
p: "Required<br>(exactly 1)"
d: "*Added in Bitcoin Core 0.10.0*<br><br>The node's index number in the local node address database"
d: "The node's index number in the local node address database"
- n: "→ →<br>`addr`"
t: "string"
@ -121,22 +121,17 @@ The `getpeerinfo` RPC {{summary_getPeerInfo}}
- n: "→ →<br>`synced_headers`"
t: "number (int)"
p: "Required<br>(exactly 1)"
d: "*Added in Bitcoin Core 0.10.0*<br><br>The highest-height header we have in common with this node based the last P2P `headers` message it sent us. If a `headers` message has not been received, this will be set to `-1`"
d: "The highest-height header we have in common with this node based the last P2P `headers` message it sent us. If a `headers` message has not been received, this will be set to `-1`"
- n: "→ →<br>`synced_blocks`"
t: "number (int)"
p: "Required<br>(exactly 1)"
d: "*Added in Bitcoin Core 0.10.0*<br><br>The highest-height block we have in common with this node based on P2P `inv` messages this node sent us. If no block `inv` messages have been received from this node, this will be set to `-1`"
- n: "→ →<br>`syncnode`"
t: "bool"
p: "Required<br>(exactly 1)"
d: "*Removed in Bitcoin Core 0.10.0*<br><br>Whether we're using this node as our syncnode during initial block download"
d: "The highest-height block we have in common with this node based on P2P `inv` messages this node sent us. If no block `inv` messages have been received from this node, this will be set to `-1`"
- n: "→ →<br>`inflight`"
t: "array"
p: "Required<br>(exactly 1)"
d: "*Added in Bitcoin Core 0.10.0*<br><br>An array of blocks which have been requested from this peer. May be empty"
d: "An array of blocks which have been requested from this peer. May be empty"
- n: "→ → →<br>Blocks"
t: "number (int)"
@ -146,7 +141,7 @@ The `getpeerinfo` RPC {{summary_getPeerInfo}}
- n: "→ →<br>`whitelisted`"
t: "bool"
p: "Required<br>(exactly 1)"
d: "*Added in Bitcoin Core 0.10.0*<br><br>Set to `true` if the remote peer has been whitelisted; otherwise, set to `false`. Whitelisted peers will not be banned if their ban score exceeds the maximum (100 by default). By default, peers connecting from localhost are whitelisted"
d: "Set to `true` if the remote peer has been whitelisted; otherwise, set to `false`. Whitelisted peers will not be banned if their ban score exceeds the maximum (100 by default). By default, peers connecting from localhost are whitelisted"
- n: "→ →<br>`bytessent_per_msg`"
t: "string : <br>object"

View file

@ -28,10 +28,10 @@ The `getrawtransaction` RPC {{summary_getRawTransaction}}
*Parameter #2---whether to get the serialized or decoded transaction*
{% itemplate ntpd1 %}
- n: "Verbose"
t: "number (int)"
- n: "Format"
t: "bool"
p: "Optional<br>(0 or 1)"
d: "Set to `0` (the default) to return the serialized transaction as hex. Set to `1` to return a decoded transaction"
d: "*Updated in Bitcoin Core 0.14.0*<br><br>Set to `false` (the default) to return the serialized transaction as hex. Set to `true` to return a decoded transaction. Before 0.14.0, use `0` and `1`, respectively"
{% enditemplate %}
@ -45,7 +45,7 @@ The `getrawtransaction` RPC {{summary_getRawTransaction}}
{% enditemplate %}
*Result (if verbose=`0`)---the serialized transaction*
*Result (if verbose=`false`)---the serialized transaction*
{% itemplate ntpd1 %}
- n: "`result`"
@ -55,7 +55,7 @@ The `getrawtransaction` RPC {{summary_getRawTransaction}}
{% enditemplate %}
*Result (if verbose=`1`)---the decoded transaction*
*Result (if verbose=`true`)---the decoded transaction*
{% itemplate ntpd1 %}
- n: "`result`"
@ -90,7 +90,7 @@ The `getrawtransaction` RPC {{summary_getRawTransaction}}
{% enditemplate %}
*Examples from Bitcoin Core 0.13.1*
*Examples from Bitcoin Core 0.14.1*
A transaction in serialized transaction format:
@ -116,7 +116,7 @@ Get the same transaction in JSON:
{% highlight bash %}
bitcoin-cli getrawtransaction \
ef7c0cbf6ba5af68d2ea239bba709b26ff7b0b669839a63bb01c2cb8e8de481e \
1
true
{% endhighlight %}
Result:

View file

@ -59,7 +59,7 @@ The `gettransaction` RPC {{summary_getTransaction}}
- n: "→ → <br>`involvesWatchonly`"
t: "bool"
p: "Optional<br>(0 or 1)"
d: "*Added in Bitcoin Core 0.10.0*<br><br>Set to `true` if the input or output involves a watch-only address. Otherwise not returned"
d: "Set to `true` if the input or output involves a watch-only address. Otherwise not returned"
- n: "→ →<br>`account`"
t: "string"
@ -84,7 +84,7 @@ The `gettransaction` RPC {{summary_getTransaction}}
- n: "→ →<br>`vout`"
t: "number (int)"
p: "Required<br>(exactly 1)"
d: "*Added in Bitcoin Core 0.10.0*<br><br>For an output, the output index (vout) for this output in this transaction. For an input, the output index for the output being spent in its transaction. Because inputs list the output indexes from previous transactions, more than one entry in the details array may have the same output index"
d: "For an output, the output index (vout) for this output in this transaction. For an input, the output index for the output being spent in its transaction. Because inputs list the output indexes from previous transactions, more than one entry in the details array may have the same output index"
- n: "→ →<br>`fee`"
t: "number (bitcoins)"

View file

@ -11,7 +11,7 @@ http://opensource.org/licenses/MIT.
{% autocrossref %}
*Requires wallet support. Added in Bitcoin Core 0.10.0.*
*Requires wallet support.*
The `importaddress` RPC {{summary_importAddress}}

View file

@ -0,0 +1,173 @@
{% comment %}
This file is licensed under the MIT License (MIT) available on
http://opensource.org/licenses/MIT.
{% endcomment %}
{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/importmulti.md" %}
##### ImportMulti
{% include helpers/subhead-links.md %}
{% assign summary_importMulti="imports addresses or scripts (with private keys, public keys, or P2SH redeem scripts) and optionally performs the minimum necessary rescan for all imports." %}
{% autocrossref %}
*Added in Bitcoin Core 0.14.0*
*Requires wallet support. Wallet must be unlocked.*
The `importmulti` RPC {{summary_importMulti}}
*Parameter #1---the addresses/scripts to import*
{% itemplate ntpd1 %}
- n: "Imports"
t: "array"
p: "Required<br>(exactly 1)"
d: "An array of JSON objects, each one being an address or script to be imported"
- n: "→ Import"
t: "object"
p: "Required<br>(1 or more)"
d: "A JSON object describing a particular import"
- n: "→ →<br>`scriptPubKey`"
t: "string (hex)"
p: "Optional<br>(0 or 1)"
d: "The script (string) to be imported. Must have either this field or `address` below"
- n: "→ →<br>`address`"
t: "string (base58)"
p: "Optional<br>(0 or 1)"
d: "The P2PKH or P2SH address to be imported. Must have either this field or `scriptPubKey` above"
- n: "→ →<br>`timestamp`"
t: "number (int) / string"
p: "Required<br>(exactly 1)"
d: "The creation time of the key in Unix epoch time or the string “now” to substitute the current synced block chain time. The timestamp of the oldest key will determine how far back block chain rescans need to begin. Specify `now` to bypass scanning for keys which are known to never have been used. Specify `0` to scan the entire block chain. Blocks up to 2 hours before the earliest key creation time will be scanned"
- n: "→ →<br>`redeemscript`"
t: "string"
p: "Optional<br>(0 or 1)"
d: "A redeem script. Only allowed if either the `address` field is a P2SH address or the `scriptPubKey` field is a P2SH scriptPubKey"
- n: "→ →<br>`pubkeys`"
t: "array"
p: "Optional<br>(0 or 1)"
d: "Array of strings giving pubkeys that must occur in the scriptPubKey or redeemscript"
- n: "→ →<br>`keys`"
t: "array"
p: "Optional<br>(0 or 1)"
d: "Array of strings giving private keys whose corresponding public keys must occur in the scriptPubKey or redeemscript"
- n: "→ →<br>`internal`"
t: "bool"
p: "Optional<br>(0 or 1)"
d: "Stating whether matching outputs should be treated as change rather than incoming payments. The default is `false`"
- n: "→ →<br>`watchonly`"
t: "bool"
p: "Optional<br>(0 or 1)"
d: "Stating whether matching outputs should be considered watched even when they're not spendable. This is only allowed if keys are empty. The default is `false`"
- n: "→ →<br>`label`"
t: "string"
p: "Optional<br>(0 or 1)"
d: "Label to assign to the address, only allowed with `internal` set to `false`. The default is an empty string (“”)"
{% enditemplate %}
*Parameter #2---options regarding the import*
{% itemplate ntpd1 %}
- n: "Option"
t: "object"
p: "Optional<br>(0 or 1)"
d: "JSON object with options regarding the import"
- n: "→ <br>`rescan`"
t: "bool"
p: "Optional<br>(0 or 1)"
d: "Set to `true` (the default) to rescan the entire local block chain for transactions affecting any imported address or script. Set to `false` to not rescan after the import. Rescanning may take a considerable amount of time and may require re-downloading blocks if using block chain pruning"
{% enditemplate %}
*Result---execution result*
{% itemplate ntpd1 %}
- n: "`result`"
t: "array"
p: "Required<br>(exactly 1)"
d: "An array of JSON objects, with each object describing the execution result of each import"
- n: "→ Result"
t: "object"
p: "Required<br>(1 or more)"
d: "A JSON object describing the execution result of an imported address or script"
- n: "→ → <br>`success`"
t: "string"
p: "Required<br>(exactly 1)"
d: "Displays `true` if the import has been successful or `false` if it failed"
- n: "→ → <br>`error`"
t: "string : object"
p: "Optional<br>(0 or 1)"
d: "A JSON object containing details about the error. Only displayed if the import fails"
- n: "→ → → <br>`code`"
t: "number (int)"
p: "Optional<br>(0 or 1)"
d: "The error code"
- n: "→ → → <br>`message`"
t: "string"
p: "Optional<br>(0 or 1)"
d: "The error message"
{% enditemplate %}
*Example from Bitcoin Core 0.14.1*
Import the address 1NL9w5fP9kX2D9ToNZPxaiwFJCngNYEYJo (giving it a label and scanning the entire block chain) and the scriptPubKey 76a9149e857da0a5b397559c78c98c9d3f7f655d19c68688ac (giving a specific timestamp and label):
{% highlight bash %}
bitcoin-cli importmulti '
[
{
"scriptPubKey" : { "address": "1NL9w5fP9kX2D9ToNZPxaiwFJCngNYEYJo" },
"timestamp" : 0,
"label" : "Personal"
},
{
"scriptPubKey" : "76a9149e857da0a5b397559c78c98c9d3f7f655d19c68688ac",
"timestamp" : 1493912405,
"label" : "TestFailure"
}
]' '{ "rescan": true }'
{% endhighlight %}
Result (scriptPubKey import failed because `internal` was not set to `true`):
{% highlight json %}
[
{
"success": true
},
{
"success": false,
"error": {
"code": -8,
"message": "Internal must be set for hex scriptPubKey"
}
}
]
{% endhighlight %}
*See also*
* [ImportPrivKey][rpc importprivkey]: {{summary_importPrivKey}}
* [ImportAddress][rpc importaddress]: {{summary_importAddress}}
* [ImportWallet][rpc importwallet]: {{summary_importWallet}}
{% endautocrossref %}

View file

@ -52,7 +52,7 @@ Core. Use the RPCs listed in the See Also subsection below instead.
- n: "→ →<br>`involvesWatchonly`"
t: "bool"
p: "Optional<br>(0 or 1)"
d: "*Added in Bitcoin Core 0.10.0*<br><br>Set to `true` if the balance of this account includes a watch-only address which has received a spendable payment (that is, a payment with at least the specified number of confirmations and which is not an immature coinbase). Otherwise not returned"
d: "Set to `true` if the balance of this account includes a watch-only address which has received a spendable payment (that is, a payment with at least the specified number of confirmations and which is not an immature coinbase). Otherwise not returned"
- n: "→ →<br>`account`"
t: "string"

View file

@ -49,7 +49,7 @@ The `listreceivedbyaddress` RPC {{summary_listReceivedByAddress}}
- n: "→ →<br>`involvesWatchonly`"
t: "bool"
p: "Optional<br>(0 or 1)"
d: "*Added in Bitcoin Core 0.10.0*<br><br>Set to `true` if this address is a watch-only address which has received a spendable payment (that is, a payment with at least the specified number of confirmations and which is not an immature coinbase). Otherwise not returned"
d: "Set to `true` if this address is a watch-only address which has received a spendable payment (that is, a payment with at least the specified number of confirmations and which is not an immature coinbase). Otherwise not returned"
- n: "→ →<br>`address`"
t: "string (base58)"

View file

@ -90,7 +90,7 @@ The `listtransactions` RPC {{summary_listTransactions}}
- n: "→ →<br>`vout`"
t: "number (int)"
p: "Optional<br>(0 or 1)"
d: "*Added in Bitcoin Core 0.10.0*<br><br>For an output, the output index (vout) for this output in this transaction. For an input, the output index for the output being spent in its transaction. Because inputs list the output indexes from previous transactions, more than one entry in the details array may have the same output index. Not returned for *move* category payments"
d: "For an output, the output index (vout) for this output in this transaction. For an input, the output index for the output being spent in its transaction. Because inputs list the output indexes from previous transactions, more than one entry in the details array may have the same output index. Not returned for *move* category payments"
- n: "→ →<br>`fee`"
t: "number (bitcoins)"
@ -105,7 +105,7 @@ The `listtransactions` RPC {{summary_listTransactions}}
- n: "→ →<br>`trusted`"
t: "bool"
p: "Optional<br>(0 or 1)"
d: "Indicates wether we consider the outputs of this unconfirmed transaction safe to spend. Only returned for unconfirmed transactions"
d: "Indicates whether we consider the outputs of this unconfirmed transaction safe to spend. Only returned for unconfirmed transactions"
- n: "→ →<br>`generated`"
t: "bool"

View file

@ -108,7 +108,7 @@ the *spendable* field in the results described below.
- n: "→ →<br>`spendable`"
t: "bool"
p: "Required<br>(exactly 1)"
d: "*Added in Bitcoin Core 0.10.0*<br><br>Set to `true` if the private key or keys needed to spend this output are part of the wallet. Set to `false` if not (such as for watch-only addresses)"
d: "Set to `true` if the private key or keys needed to spend this output are part of the wallet. Set to `false` if not (such as for watch-only addresses)"
- n: "→ →<br>`solvable`"
t: "bool"

View file

@ -0,0 +1,47 @@
{% comment %}
This file is licensed under the MIT License (MIT) available on
http://opensource.org/licenses/MIT.
{% endcomment %}
{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/preciousblock.md" %}
##### PreciousBlock
{% include helpers/subhead-links.md %}
{% assign summary_preciousBlock="treats a block as if it were received before others with the same work." %}
{% autocrossref %}
*Added in Bitcoin Core 0.14.0*
The `preciousblock` RPC {{summary_preciousBlock}} A later `preciousblock` call can override the effect of an earlier one. The effects of `preciousblock` are not retained across restarts.
*Parameter #1---the block hash*
{% itemplate ntpd1 %}
- n: "Header Hash"
t: "string (hex)"
p: "Required<br>(exactly 1)"
d: "The hash of the block to mark as precious"
{% enditemplate %}
*Result---`null` or error on failure*
{% itemplate ntpd1 %}
- n: "`result`"
t: "null"
p: "Required<br>(exactly 1)"
d: "JSON `null`. The JSON-RPC error field will be set only if you entered an invalid block hash"
{% enditemplate %}
*Example from Bitcoin Core 0.14.1*
{% highlight bash %}
bitcoin-cli preciousblock 000000000000000001517a0bac70b8cd6f27ee\
1b50a8f12bf606ea6fb6d561cd
{% endhighlight %}
Result (no output from `bitcoin-cli` because result is set to `null`).
{% endautocrossref %}

View file

@ -11,8 +11,6 @@ http://opensource.org/licenses/MIT.
{% autocrossref %}
*Added in Bitcoin Core 0.10.0.*
The `prioritisetransaction` RPC {{summary_prioritiseTransaction}}
*Parameter #1---the TXID of the transaction to modify*

View file

@ -0,0 +1,54 @@
{% comment %}
This file is licensed under the MIT License (MIT) available on
http://opensource.org/licenses/MIT.
{% endcomment %}
{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/pruneblockchain.md" %}
##### PruneBlockChain
{% include helpers/subhead-links.md %}
{% assign summary_pruneBlockChain="prunes the blockchain up to a specified height or timestamp." %}
{% autocrossref %}
*Added in Bitcoin Core 0.14.0*
The `pruneblockchain` RPC {{summary_pruneBlockChain}} The `-prune` option needs to be enabled (disabled by default).
*Parameter #1---the block height or timestamp*
{% itemplate ntpd1 %}
- n: "Height"
t: "number (int)"
p: "Required<br>(exactly 1)"
d: "The block height to prune up to. May be set to a particular height, or a unix timestamp to prune blocks whose block time is at least 2 hours older than the provided timestamp"
{% enditemplate %}
*Result---the height of the last block pruned*
{% itemplate ntpd1 %}
- n: "`result`"
t: "number (int)"
p: "Required<br>(exactly 1)"
d: "The height of the last block pruned"
{% enditemplate %}
*Examples from Bitcoin Core 0.14.1*
{% highlight bash %}
bitcoin-cli pruneblockchain 413555
{% endhighlight %}
Result:
{% highlight text %}
413555
{% endhighlight %}
*See also*
* [ImportPrunedFunds][rpc importprunedfunds]: {{summary_importPrunedFunds}}
{% endautocrossref %}

View file

@ -0,0 +1,50 @@
{% comment %}
This file is licensed under the MIT License (MIT) available on
http://opensource.org/licenses/MIT.
{% endcomment %}
{% assign filename="_includes/devdoc/bitcoin-core/rpcs/rpcs/setnetworkactive.md" %}
##### SetNetworkActive
{% include helpers/subhead-links.md %}
{% assign summary_setNetworkActive="disables/enables all P2P network activity." %}
{% autocrossref %}
*Added in Bitcoin Core 0.14.0*
The `setnetworkactive` RPC {{summary_setNetworkActive}}
*Parameter #1---whether to disable or enable all P2P network activity*
{% itemplate ntpd1 %}
- n: "Activate"
t: "bool"
p: "Required<br>(exactly 1)"
d: "Set to `true` to enable all P2P network activity. Set to `false` to disable all P2P network activity"
{% enditemplate %}
*Result---`null` or error on failure*
{% itemplate ntpd1 %}
- n: "`result`"
t: "null"
p: "Required<br>(exactly 1)"
d: "JSON `null`. The JSON-RPC error field will be set only if you entered an invalid parameter"
{% enditemplate %}
*Example from Bitcoin Core 0.14.1*
{% highlight bash %}
bitcoin-cli setnetworkactive true
{% endhighlight %}
Result (no output from `bitcoin-cli` because result is set to `null`).
*See also*
* [GetNetworkInfo][rpc getnetworkinfo]: {{summary_getNetworkInfo}}
{% endautocrossref %}