dash-docs/_includes/helpers/vars.md

{% comment %} This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %}

{% capture INCLUDE_F_LIST_TRANSACTIONS %}

• n: "{{DEPTH}}
  involvesWatchonly" t: "bool" p: "Optional
  (0 or 1)" d: "Set to true if the payment involves a watch-only address. Otherwise not returned"

• n: "{{DEPTH}}
  account" t: "string" p: "Required
  (exactly 1)" d: "Deprecated: will be removed in a later version of Bitcoin Core
  
  The account which the payment was credited to or debited from. May be an empty string ("") for the default account"

• n: "{{DEPTH}}
  address" t: "string (base58)" p: "Optional
  (0 or 1)" d: "The address paid in this payment, which may be someone else's address not belonging to this wallet. May be empty if the address is unknown, such as when paying to a non-standard pubkey script"

• n: "{{DEPTH}}
  category" t: "string" p: "Required
  (exactly 1)" d: "Set to one of the following values:
  • send if sending payment normally
  • privatesend if sending PrivateSent payment
  • receive if this wallet received payment in a regular transaction
  • generate if a matured and spendable coinbase
  • immature if a coinbase that is not spendable yet
  • orphan if a coinbase from a block that's not in the local best block chain"

• n: "{{DEPTH}}
  amount" t: "number (dash)" p: "Required
  (exactly 1)" d: "A negative dash amount if sending payment; a positive dash amount if receiving payment (including coinbases)"

• n: "{{DEPTH}}
  vout" t: "number (int)" p: "Required
  (exactly 1)" 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: "{{DEPTH}}
  fee" t: "number (dash)" p: "Optional
  (0 or 1)" d: "If sending payment, the fee paid as a negative dash value. May be 0. Not returned if receiving payment"

{% endcapture %}

{% capture INCLUDE_F_LIST_TRANSACTIONS_F_FULL %}

• n: "{{DEPTH}}
  confirmations" t: "number (int)" p: "Required
  (exactly 1)" d: "The number of confirmations the transaction has received. Will be 0 for unconfirmed and -1 for conflicted"

• n: "{{DEPTH}}
  generated" t: "bool" p: "Optional
  (0 or 1)" d: "Set to true if the transaction is a coinbase. Not returned for regular transactions"

• n: "{{DEPTH}}
  blockhash" t: "string (hex)" p: "Optional
  (0 or 1)" d: "The hash of the block on the local best block chain which includes this transaction, encoded as hex in RPC byte order. Only returned for confirmed transactions"

• n: "{{DEPTH}}
  blockindex" t: "number (int)" p: "Optional
  (0 or 1)" d: "The index of the transaction in the block that includes it. Only returned for confirmed transactions"

• n: "{{DEPTH}}
  blocktime" t: "number (int)" p: "Optional
  (0 or 1)" d: "The block header time (Unix epoch time) of the block on the local best block chain which includes this transaction. Only returned for confirmed transactions"

• n: "{{DEPTH}}
  txid" t: "string (hex)" p: "Required
  (exactly 1)" d: "The TXID of the transaction, encoded as hex in RPC byte order"

• n: "{{DEPTH}}
  walletconflicts" t: "array" p: "Required
  (exactly 1)" d: "An array containing the TXIDs of other transactions that spend the same inputs (UTXOs) as this transaction. Array may be empty"

• n: "{{DEPTH}}→
  TXID" t: "string (hex)" p: "Optional
  (0 or more)" d: "The TXID of a conflicting transaction, encoded as hex in RPC byte order"

• n: "{{DEPTH}}
  time" t: "number (int)" p: "Required
  (exactly 1)" d: "A Unix epoch time when the transaction was added to the wallet"

• n: "{{DEPTH}}
  timerecived" t: "number (int)" p: "Required
  (exactly 1)" d: "A Unix epoch time when the transaction was detected by the local node, or the time of the block on the local best block chain that included the transaction"

• n: "{{DEPTH}}
  bip125-replaceable" t: "string" p: "Required
  (exactly 1)" d: "Added in Bitcoin Core 0.12.0
  
  Indicates if a transaction is replaceable under BIP 125:
  • yes is replaceable
  • no not replaceable
  • unknown for unconfirmed transactions not in the mempool"

• n: "{{DEPTH}}
  comment" t: "string" p: "Optional
  (0 or 1)" d: "For transaction originating with this wallet, a locally-stored comment added to the transaction. Only returned if a comment was added"

• n: "{{DEPTH}}
  to" t: "string" p: "Optional
  (0 or 1)" d: "For transaction originating with this wallet, a locally-stored comment added to the transaction identifying who the transaction was sent to. Only returned if a comment-to was added"

{% endcapture %}

{% capture INCLUDE_SPEND_CONFIRMATIONS %} {% itemplate ntpd1 %}

• n: "Confirmations" t: "number (int)" p: "Optional
  (0 or 1)" d: "The minimum number of confirmations an incoming transaction must have for its outputs to be credited to this account's balance. Outgoing transactions are always counted, as are move transactions made with the move RPC. If an account doesn't have a balance high enough to pay for this transaction, the payment will be rejected. Use 0 to spend unconfirmed incoming payments. Default is 1"

{% enditemplate %}

Warning: if account1 receives an unconfirmed payment and transfers it to account2 with the move RPC, account2 will be able to spend those dash even if this parameter is set to 1 or higher.{% endcapture %}

{% capture INCLUDE_DECODE_RAW_TRANSACTION %}

• n: "{{DEPTH}} →
  txid" t: "string (hex)" p: "Required
  (exactly 1)" d: "The transaction's TXID encoded as hex in RPC byte order"

{% comment %} NOT IN DASH

• n: "{{DEPTH}} →
  hash" t: "string (hex)" p: "Required
  (exactly 1)" d: "Added in Bitcoin Core 0.13.0
  
  The transaction hash. Differs from txid for witness transactions" {% endcomment %}

• n: "{{DEPTH}} →
  size" t: "number (int)" p: "Required
  (exactly 1)" d: "Added in Bitcoin Core 0.12.0
  
  The serialized transaction size"

{% comment %} NOT IN DASH

• n: "{{DEPTH}} →
  vsize" t: "number (int)" p: "Required
  (exactly 1)" d: "Added in Bitcoin Core 0.13.0
  
  The virtual transaction size. Differs from size for witness transactions" {% endcomment %}

• n: "{{DEPTH}} →
  version" t: "number (int)" p: "Required
  (exactly 1)" d: "The transaction format version number"

• n: "{{DEPTH}} →
  locktime" t: "number (int)" p: "Required
  (exactly 1)" d: "The transaction's locktime: either a Unix epoch date or block height; see the [Locktime parsing rules][]"

• n: "{{DEPTH}} →
  vin" t: "array" p: "Required
  (exactly 1)" d: "An array of objects with each object being an input vector (vin) for this transaction. Input objects will have the same order within the array as they have in the transaction, so the first input listed will be input 0"

• n: "{{DEPTH}} → →
  Input" t: "object" p: "Required
  (1 or more)" d: "An object describing one of this transaction's inputs. May be a regular input or a coinbase"

• n: "{{DEPTH}} → → →
  txid" t: "string" p: "Optional
  (0 or 1)" d: "The TXID of the outpoint being spent, encoded as hex in RPC byte order. Not present if this is a coinbase transaction"

• n: "{{DEPTH}} → → →
  vout" t: "number (int)" p: "Optional
  (0 or 1)" d: "The output index number (vout) of the outpoint being spent. The first output in a transaction has an index of 0. Not present if this is a coinbase transaction"

• n: "{{DEPTH}} → → →
  scriptSig" t: "object" p: "Optional
  (0 or 1)" d: "An object describing the signature script of this input. Not present if this is a coinbase transaction"

• n: "{{DEPTH}} → → → →
  asm" t: "string" p: "Required
  (exactly 1)" d: "The signature script in decoded form with non-data-pushing opcodes listed"

• n: "{{DEPTH}} → → → →
  hex" t: "string (hex)" p: "Required
  (exactly 1)" d: "The signature script encoded as hex"

• n: "{{DEPTH}} → → →
  coinbase" t: "string (hex)" p: "Optional
  (0 or 1)" d: "The coinbase (similar to the hex field of a scriptSig) encoded as hex. Only present if this is a coinbase transaction"

• n: "{{DEPTH}} → → →
  value" t: "number (Dash)" p: "Optional
  (exactly 1)" d: "The number of Dash paid to this output. May be 0.
  
  Only present if spentindex enabled"

• n: "{{DEPTH}} → → →
  valueSat" t: "number (duffs)" p: "Optional
  (exactly 1)" d: "The number of duffs paid to this output. May be 0.
  
  Only present if spentindex enabled"

• n: "{{DEPTH}} → → → →
  addresses" t: "string : array" p: "Optional
  (0 or 1)" d: "The P2PKH or P2SH addresses used in this transaction, or the computed P2PKH address of any pubkeys in this transaction. This array will not be returned for nulldata or nonstandard script types.
  
  Only present if spentindex enabled"

• n: "{{DEPTH}} → → → → →
  Address" t: "string" p: "Required
  (1 or more)" d: "A P2PKH or P2SH address"

• n: "{{DEPTH}} → → →
  sequence" t: "number (int)" p: "Required
  (exactly 1)" d: "The input sequence number"

{% comment %} NOT IN DASH

• n: "{{DEPTH}} → → →
  txinwitness" t: "string : array" p: "Optional
  (0 or 1)" d: "Added in Bitcoin Core 0.13.0
  
  Hex-encoded witness data. Only for segregated witness transactions"
  {% endcomment %}

• n: "{{DEPTH}} →
  vout" t: "array" p: "Required
  (exactly 1)" d: "An array of objects each describing an output vector (vout) for this transaction. Output objects will have the same order within the array as they have in the transaction, so the first output listed will be output 0"

• n: "{{DEPTH}} → →
  Output" t: "object" p: "Required
  (1 or more)" d: "An object describing one of this transaction's outputs"

• n: "{{DEPTH}} → → →
  value" t: "number (Dash)" p: "Required
  (exactly 1)" d: "The number of Dash paid to this output. May be 0"

• n: "{{DEPTH}} → → →
  valueSat" t: "number (duffs)" p: "Required
  (exactly 1)" d: "The number of duffs paid to this output. May be 0"

• n: "{{DEPTH}} → → →
  n" t: "number (int)" p: "Required
  (exactly 1)" d: "The output index number of this output within this transaction"

• n: "{{DEPTH}} → → →
  scriptPubKey" t: "object" p: "Required
  (exactly 1)" d: "An object describing the pubkey script"

• n: "{{DEPTH}} → → → →
  asm" t: "string" p: "Required
  (exactly 1)" d: "The pubkey script in decoded form with non-data-pushing opcodes listed"

• n: "{{DEPTH}} → → → →
  hex" t: "string (hex)" p: "Required
  (exactly 1)" d: "The pubkey script encoded as hex"

• n: "{{DEPTH}} → → → →
  reqSigs" t: "number (int)" p: "Optional
  (0 or 1)" d: "The number of signatures required; this is always 1 for P2PK, P2PKH, and P2SH (including P2SH multisig because the redeem script is not available in the pubkey script). It may be greater than 1 for bare multisig. This value will not be returned for nulldata or nonstandard script types (see the type key below)"

• n: "{{DEPTH}} → → → →
  type" t: "string" p: "Optional
  (0 or 1)" d: "The type of script. This will be one of the following:
  • pubkey for a P2PK script
  • pubkeyhash for a P2PKH script
  • scripthash for a P2SH script
  • multisig for a bare multisig script
  • nulldata for nulldata scripts
  • nonstandard for unknown scripts"

• n: "{{DEPTH}} → → → →
  addresses" t: "string : array" p: "Optional
  (0 or 1)" d: "The P2PKH or P2SH addresses used in this transaction, or the computed P2PKH address of any pubkeys in this transaction. This array will not be returned for nulldata or nonstandard script types"

• n: "{{DEPTH}} → → → → →
  Address" t: "string" p: "Required
  (1 or more)" d: "A P2PKH or P2SH address"

{% endcapture %}

{% assign INCLUDE_WALLET_UNLOCKED="If the wallet has been encrypted either through the GUI or with the encryptwallet RPC, it must first be unlocked with the walletpassphrase RPC" %}

{% capture INCLUDE_CONFIRMATIONS_PARAMETER %} {% itemplate ntpd1 %}

• n: "Confirmations" t: "number (int)" p: "Optional
  (0 or 1)" d: "The minimum number of confirmations an externally-generated transaction must have before it is counted towards the balance. Transactions generated by this node are counted immediately. Typically, externally-generated transactions are payments to this wallet and transactions generated by this node are payments to other wallets. Use 0 to count unconfirmed transactions. Default is 1"

{% enditemplate %} {% endcapture %}

{% capture INCLUDE_INCLUDE_WATCH_ONLY_PARAMETER %} {% itemplate ntpd1 %}

• n: "Include Watch-Only" t: "bool" p: "Optional
  (0 or 1)" d: "If set to true, include watch-only addresses in details and calculations as if they were regular addresses belonging to the wallet. If set to false (the default), treat watch-only addresses as if they didn't belong to this wallet"

{% enditemplate %} {% endcapture %}

{% capture INCLUDE_ADD_LOCK_CONFIRMATIONS_PARAMETER %} {% itemplate ntpd1 %}

• n: "addlockconf" t: "bool" p: "Optional
  (0 or 1)" d: "If set to true, add the number of InstantSend confirmations (default=5) to the confirmation count for transactions locked via InstantSend. If set to false (the default), the standard confirmation count is not modified for InstantSend transactions."

{% enditemplate %} {% endcapture %}

{% assign WARNING=" Warning:" %} {% assign WARNING_ICON="" %}

{% assign reindexNote="Note: if you begin using txindex=1 after downloading the block chain, you must rebuild your indexes by starting Bitcoin Core with the option -reindex. This may take several hours to complete, during which time your node will not process new blocks or transactions. This reindex only needs to be done once." %}