sendtoaddress

Back to wallet

Changed params/results since v30.2 Wallet

Summary

Send an amount to a given address.

Description

Send an amount to a given address. Requires wallet passphrase to be set with walletpassphrase call if wallet is encrypted.

Change Buckets

  • Changed params/results since v30.2

Arguments

  • address (STR, required): The qbit address to send to.
  • amount (AMOUNT, required): The amount in QBT to send. eg 0.1
  • comment (STR): A comment used to store what the transaction is for. This is not part of the transaction, just kept in your wallet.
  • comment_to (STR): A comment to store the name of the person or organization to which you're sending the transaction. This is not part of the transaction, just kept in your wallet.
  • subtractfeefromamount (BOOL): The fee will be deducted from the amount being sent. The recipient will receive less QBT than you enter in the amount field.
  • replaceable (BOOL): Signal that this transaction can be replaced by a transaction (BIP 125)
  • conf_target (NUM): Confirmation target in blocks

  • estimate_mode (STR): The fee estimate mode, must be one of (case insensitive): unset, economical, conservative unset means no mode set (economical mode is used if the transaction is replaceable; otherwise, conservative mode is used). economical estimates use a shorter time horizon, making them more responsive to short-term drops in the prevailing fee market. This mode potentially returns a lower fee rate estimate. conservative estimates use a longer time horizon, making them less responsive to short-term drops in the prevailing fee market. This mode potentially returns a higher fee rate estimate.

  • avoid_reuse (BOOL): (only available if avoid_reuse wallet flag is set) Avoid spending from dirty addresses; addresses are considered dirty if they have previously been used in a transaction. If true, this also activates avoidpartialspends, grouping outputs by their addresses.

  • fee_rate (AMOUNT): Specify a fee rate in sat/vB.
  • verbose (BOOL): If true, return extra information about the transaction.

Results

  • txid (STR_HEX): The transaction id.
  • value (OBJ): No description.
  • txid (STR_HEX): The transaction id.
  • fee_reason (STR): The transaction fee reason.
  • pqc_key_states (ARR, optional): PQC usage state for local wallet keys that participated in this response.
    • value (OBJ): No description.
    • pubkey (STR_HEX): The hex-encoded PQC public key.
    • pqc_signature_count (NUM): The number of signatures used by this PQC key.
    • pqc_signature_limit (NUM): The hard signature limit for this PQC key.
    • pqc_signatures_remaining (NUM): The remaining signature budget for this PQC key.
    • pqc_limit_state (STR): The PQC usage state. One of normal, warning, critical, or exhausted.
  • pqc_overall_limit_state (STR, optional): The maximum PQC usage severity across pqc_key_states.
  • pqc_signature_count (NUM, optional): The number of signatures used by the single local PQC key associated with this response.
  • pqc_signature_limit (NUM, optional): The hard signature limit for the single local PQC key associated with this response.
  • pqc_signatures_remaining (NUM, optional): The remaining signature budget for the single local PQC key associated with this response.
  • pqc_limit_state (STR, optional): The PQC usage state for the single local PQC key associated with this response.
  • warnings (ARR, optional): Human-readable warning lines emitted when PQC threshold transitions or reminder buckets fire.
    • warning (STR): No description.

Examples

Send 0.1 QBT

qbit-cli sendtoaddress "qb1zqqqsyqcyq5rqwzqfpg9scrgwpugpzysnzs23v9ccrydpk8qarc0sjq57mw" 0.1

Send 0.1 QBT with a confirmation target of 6 blocks in economical fee estimate mode using positional arguments

qbit-cli sendtoaddress "qb1zqqqsyqcyq5rqwzqfpg9scrgwpugpzysnzs23v9ccrydpk8qarc0sjq57mw" 0.1 "donation" "sean's outpost" false true 6 economical

Send 0.1 QBT with a fee rate of 1.1 sat/vB, subtract fee from amount, BIP125-replaceable, using positional arguments

qbit-cli sendtoaddress "qb1zqqqsyqcyq5rqwzqfpg9scrgwpugpzysnzs23v9ccrydpk8qarc0sjq57mw" 0.1 "drinks" "room77" true true null "unset" null 1.1

Send 0.2 QBT with a confirmation target of 6 blocks in economical fee estimate mode using named arguments

qbit-cli -named sendtoaddress address="qb1zqqqsyqcyq5rqwzqfpg9scrgwpugpzysnzs23v9ccrydpk8qarc0sjq57mw" amount=0.2 conf_target=6 estimate_mode="economical"

Send 0.5 QBT with a fee rate of 25 sat/vB using named arguments

qbit-cli -named sendtoaddress address="qb1zqqqsyqcyq5rqwzqfpg9scrgwpugpzysnzs23v9ccrydpk8qarc0sjq57mw" amount=0.5 fee_rate=25

qbit-cli -named sendtoaddress address="qb1zqqqsyqcyq5rqwzqfpg9scrgwpugpzysnzs23v9ccrydpk8qarc0sjq57mw" amount=0.5 fee_rate=25 subtractfeefromamount=false replaceable=true avoid_reuse=true comment="2 pizzas" comment_to="jeremy" verbose=true