urbit/shrub
1
1
Fork 0
mirror of https://github.com/urbit/shrub.git synced 2024-12-21 09:51:36 +03:00
Code Issues Packages Projects Releases Wiki Activity
146d2f963e
shrub/sur/btc-node-hook.hoon

2040 lines
60 KiB
Plaintext
Raw Normal View History

w btc-node
2020-10-02 08:48:58 +03:00
=> :: Helper types
::
|%
:: +address: base58check encoded public key (20 bytes)
::
:: FIXME: %bech32 is not parsed by fim:ag
::
+$ address ?(@uc [%bech32 @t])
++ blockhash @ux
:: $estimate-mode
::
:: Used in:
:: - %fund-raw-transaction
:: - %estimate-smart-fee
:: - %bump-fee
:: - %wallet-create-fundedpsbt
:: - %send-to-address
:: - %send-many
::
+$ estimate-mode ?(%'UNSET' %'ECONOMICAL' %'CONSERVATIVE')
:: $category:
::
:: Used in:
:: - $tx-in-block
:: - %get-transaction
:: - %list-transactions
::
+$ category ?(%send %receive %generate %immature %orphan)
:: $rule:
::
:: Used in:
:: - %get-block-template
::
::
+$ rule %segwit
:: $capability:
::
:: Used in:
:: - %get-block-template
::
+$ capability
$? %longpoll
%coinbasetxn
%coinbasevalue
%proposal
%serverlist
%workid
==
:: $block-template-mode:
::
:: Used in:
:: - %get-block-template
::
+$ block-template-mode
$? mode=%template
[mode=%proposal data=@ux workid=(unit @t)]
==
:: $logging-category:
::
:: Used in:
:: - %logging
::
+$ logging-category
$? %net
%tor
%mempool
%http
%bench
%zmq
%db
%rpc
%estimatefee
%addrman
%selectcoins
%reindex
%cmpctblock
%rand
%prune
%proxy
%mempoolrej
%libevent
%coindb
%qt
%leveldb
==
:: $rpc-command:
::
:: Used in:
:: - %get-rpc-info
::
+$ rpc-command [method=@t duration=@dr]
:: $transaction:
::
:: Used in:
:: - %get-block-template
::
+$ transaction
$: data=@ux
txid=@ux
hash=@ux
depends=(list @ud)
fee=@ud
sigops=@ud
weight=@ud
==
:: $mutable:
::
:: Used in:
:: - %get-block-template
::
+$ mutable ?(%value %time %transactions %prevblock)
:: $node-address:
::
:: Used in:
:: - $node-info
::
+$ node-address [address=@t connected=?(%inbound %outbound)]
:: $node-info:
::
:: Used in:
:: - %get-added-node-info
::
+$ node-info [added-node=@t connected=? addresses=(list node-address)]
:: $upload-target:
::
:: Used in:
:: - %get-net-totals
::
+$ upload-target
$: timeframe=@dr
target=@ud
target-reached=?
serve-historical-blocks=?
bytes-left-in-cycle=@ud
time-left-in-cycle=@dr
==
:: $network-info:
::
:: Used in:
:: - %get-network-info
::
+$ network-info
$: name=?(%ipv4 %ipv6 %onion)
limited=?
reachable=?
proxy=@t
proxy-randomize-credentials=?
==
:: $local-address:
::
:: Used in:
:: - %get-network-info
::
+$ local-address [address=@t port=@ud score=@ud]
:: $node-address-info:
::
:: Used in:
:: - %get-node-addresses
::
+$ node-address-info [time=@da services=@ud address=@t port=@ud]
:: $peer-info:
::
:: Used in:
:: - %get-peer-info
::
+$ peer-info
$: id=@ud
addr=@t
addr-bind=@t
addr-local=(unit @t)
services=@t
services-names=(list @t)
relay-txes=?
last-send=@da
last-recv=@da
bytes-sent=@ud
bytes-recv=@ud
conn-time=@da
time-offset=@t
ping-time=@rd
min-ping=@rd
ping-wait=(unit @ud)
version=@ud
subver=@t
inbound=?
addnode=?
starting-height=@ud
ban-score=@ud
synced-headers=@ud
synced-blocks=@ud
inflight=(list @ud)
whitelisted=?
min-fee-filter=@rd
bytes-sent-per-msg=(map @t @ud)
bytes-recv-per-msg=(map @t @ud)
==
:: $banned:
::
:: Used in:
:: - %list-banned
::
+$ banned [address=@t banned-until=@da ban-created=@da ban-reason=@t]
:: $chain-status:
::
:: Used in:
:: - %get-chain-tips
::
+$ chain-status
$? %invalid
%headers-only
%valid-headers
%valid-fork
%active
==
:: $soft-fork-types:
::
:: Used in:
:: - %get-blockchain-info/$softforks
::
+$ soft-fork-types ?(%buried %bip9)
:: $soft-fork-status:
::
:: Used in:
:: - %get-blockchain-info/$softforks
::
+$ soft-fork-status ?(%defined %started %'locked_in' %active %failed)
:: $purpose:
::
:: Used in:
:: - %get-addresses-by-label
:: - %get-address-info
::
+$ purpose ?(%send %receive)
:: $address-type:
::
:: Used in:
:: - %add-multisig-address
::
+$ address-type ?(%legacy %p2sh-segwit %bech32)
:: $bip125-replaceable:
::
:: Used in:
:: - %get-transaction
:: - %list-transactions
:: - $tx-in-block
::
+$ bip125-replaceable ?(%yes %no %unknown)
:: $network-name:
::
:: Used in:
:: - %get-blockchain-info
::
+$ network-name ?(%main %test %regtest)
:: $sig-hash:
::
:: Used in:
:: - %wallet-process-psbt
:: - %sign-raw-transaction-with-wallet
:: - %sign-raw-transaction-with-key
:: - %decode-psbt
::
+$ sig-hash
$? %'NONE'
%'SINGLE'
%'ALL|ANYONECANPAY'
%'NONE|ANYONECANPAY'
%'SINGLE|ANYONECANPAY'
%'ALL'
==
:: $script:
::
:: Used in:
:: - %decode-psbt: $redeem-script/$witness-script
::
+$ script [asm=@t hex=@ux type=@t]
:: $script-pubkey:
::
:: Used in:
:: - $utxo
::
+$ script-pubkey
$: asm=@t
hex=@ux
type=@t
=address
==
:: $range:
::
:: Used in:
:: - %derive-addresses
:: - $scan-object
::
+$ range ?(@ud [@ud @ud])
:: $vin:
::
:: Used in:
:: - $serialized-tx
:: - $raw-transaction-rpc-out
::
+$ vin
$: txid=(unit @ux)
vout=(unit @ud)
script-sig=(unit [asm=@t hex=@ux])
tx-in-witness=(unit (list @ux))
sequence=@ud
==
:: $vout:
::
:: Used in:
:: - $serialized-tx
:: - $raw-transaction-rpc-out
::
+$ vout
$: value=@t
n=@ud
::
$= script-pubkey
$: asm=@t
hex=@ux
req-sigs=(unit @ud)
type=@t
addresses=(unit (list address))
== ==
:: $input:
::
:: Used in:
:: - %wallet-create-fundedpsbt
:: - $partially-signed-transaction
::
+$ input
$: txid=@ux
vout=@ud
sequence=@ud
==
:: $output:
::
:: Used in:
:: - %wallet-create-fundedpsbt
:: - $partially-signed-transaction
::
+$ output
$: data=[%data @ux]
addresses=(list [=address amount=@t])
==
:: $scan-object:
::
:: Used in:
:: - %scan-tx-outset
::
+$ scan-object
$? descriptor=@t
::
$= object
$: desc=@t
range=(unit range)
== ==
:: $utxo:
::
:: Used in:
:: - %decode-psbt
::
+$ utxo
(unit [amount=@t =script-pubkey])
:: $segwit-script:
::
:: Used in:
:: - %decode-script
::
+$ segwit-script
$: asm=@t
hex=(unit @ux)
type=@t
req-sigs=(unit @ud)
addresses=(list [%bech32 @t])
p2sh-segwit=(unit @uc)
==
:: $partially-signed-transaction:
::
:: Used in:
:: - %create-psbt
:: - %create-raw-transaction
::
+$ partially-signed-transaction
$: inputs=(list input)
outputs=output
locktime=(unit @ud)
replaceable=(unit ?)
==
:: $import-request:
::
:: Used in:
:: - %import-multi
::
+$ import-request
$: desc=(unit @t)
::
$= script-pubkey
$% [%script s=@t]
[%address a=address]
==
::
timestamp=?(@da %now)
redeem-script=(unit @t)
witness-script=(unit @t)
pubkeys=(unit (list @t))
keys=(unit (list @t))
range=(unit ?(@ud [@ud @ud]))
internal=(unit ?)
watchonly=(unit ?)
label=(unit @t)
keypool=(unit ?)
==
:: $serialized-tx:
::
:: Used in:
:: - %decode-psbt
:: - %decode-raw-transaction
::
+$ serialized-tx
$: txid=@ux
hash=@ux
size=@ud
vsize=@ud
weight=@ud
version=@ud
locktime=@ud
vin=(list vin)
vout=(list vout)
==
:: $prev-tx:
::
:: Used in:
:: - %sign-raw-transaction-with-wallet
:: - %sign-raw-transaction-with-key
::
+$ prev-tx
$: txid=@ux
vout=@ud
script-pubkey=@ux
redeem-script=(unit @ux)
witness-script=(unit @ux)
amount=@t
==
:: $raw-transaction-rpc-out:
::
:: Used in:
:: - %get-block
:: - %get-raw-transaction
::
+$ raw-transaction-rpc-out
$: in-active-chain=(unit ?)
hex=@ux
txid=@ux
hash=@ux
size=@ud
vsize=@ud
weight=@ud
version=@t
locktime=@ud
vin=(list vin)
vout=(list vout)
blockhash=(unit @ux)
confirmations=(unit @ud)
blocktime=(unit @ud)
time=(unit @ud)
==
:: $tx-in-block:
::
:: Used in:
:: - %lists-in-ceblock
:: - %list-transactions
::
+$ tx-in-block
$: address=(unit address)
=category
amount=@t
label=(unit @t)
vout=@ud
fee=(unit @t)
confirmations=@ud
blockhash=(unit @ux)
blockindex=(unit @ud)
blocktime=(unit @ud)
txid=@ux
time=@ud
time-received=(unit @ud)
wallet-conflicts=(unit (list @ux))
=bip125-replaceable
abandoned=(unit ?)
comment=(unit @t)
to=(unit @t)
==
:: $errors:
::
:: Used in:
:: - %sign-raw-transaction-with-key
:: - %sign-raw-transaction-with-wallet
::
+$ errors
%- list
$: txid=@
vout=@
script-sig=@
sequence=@
error=@t
==
:: $mem-pool:
::
:: Used in:
:: - $mem-pool-response
:: - %get-mempool-entry
::
+$ mem-pool
$: size=(unit @ud)
vsize=@ud
weight=@ud
fee=@t
modified-fee=@t
time=@ud
height=@ud
descendant-count=@ud
descendant-size=@ud
descendant-fees=@t
ancestor-count=@ud
ancestor-size=@ud
ancestor-fees=@t
w-txid=@ux
::
$= fees
$: base=@t
modified=@t
ancestor=@t
descendant=@t
==
::
depends=(list @ux)
spent-by=(list @ux)
bip125-replaceable=?
==
:: $mem-pool-response:
::
:: Used in:
:: - %get-raw-mempool
:: - %get-mempool-entry
:: - %get-mempool-ancestors
:: - %get-mempool-descendants
:: - %get-raw-mempool
::
+$ mem-pool-response
%- list
$@ :: (for verbose = false)
::
@ux
::
:: (for verbose = true)
::
[id=@ux =mem-pool]
::
:: $descriptor
::
:: Used in:
:: - %utxo-update-psbt
::
+$ descriptor
$? @t
::
$: desc=@t
range=(unit range)
== ==
--
|%
::
+$ btc-node-hook-action request:btc-rpc
+$ btc-node-hook-command command:btc-rpc
btc-node-hook returns responses correctly
2020-10-03 10:57:16 +03:00
:: Expand the response type to include connectivity
::
btc-provider lib
2020-10-20 13:44:31 +03:00
+$ btc-node-hook-response response:btc-rpc
w btc-node
2020-10-02 08:48:58 +03:00
::
++ btc-rpc
|%
+$ request
$%
:: Blockchain
::
:: %get-best-block-hash: Returns the hash of the
:: best (tip) block in the longest blockchain.
::
[%get-best-block-hash ~]
:: %get-block: Returns an Object/string with information about block
::
[%get-block blockhash=@ux verbosity=(unit ?(%0 %1 %2))]
:: %get-blockchain-info: Returns info regarding blockchain processing.
::
[%get-blockchain-info ~]
:: %get-block-count: Returns number of blocks in the longest blockchain
::
[%get-block-count ~]
:: %get-block-filter: Retrieve a BIP 157 content filter for a block.
::
[%get-block-filter block-hash=@ux filter-type=(unit @t)]
:: %get-block-hash: Returns hash of block in best-block-chain at height
::
[%get-block-hash height=@ud]
:: %get-block-header: If verbose is false, returns a string that is
:: serialized, hex-encoded data for blockheader 'hash'. If verbose is
:: true, returns an Object
::
[%get-block-header blockhash=@ux verbose=(unit ?)]
:: %get-block-stats: Compute per block statistics for a given window.
::
$: %get-block-stats
$= hash-or-height
$% [%hex @ux]
[%num @ud]
==
::
stats=(unit (list @t))
==
:: %get-chain-tips: Return information about tips in the block tree.
::
[%get-chain-tips ~]
:: %get-chain-tx-stats: Compute statistics about total number rate
:: of transactions in the chain.
::
[%get-chain-tx-stats n-blocks=(unit @ud) blockhash=(unit @ux)]
:: %get-difficulty: Returns the proof-of-work difficulty as a multiple
:: of the minimum difficulty.
::
[%get-difficulty ~]
:: %get-mempool-ancestors: If txid is in the mempool, returns
:: all in-mempool ancestors.
::
[%get-mempool-ancestors txid=@ux verbose=(unit ?)]
:: %get-mempool-descendants: If txid is in the mempool, returns
:: all in-mempool descendants.
::
[%get-mempool-descendants txid=@ux verbose=(unit ?)]
:: %get-mempool-entry: Returns mempool data for given transaction
::
[%get-mempool-entry txid=@ux]
:: %get-mempool-info: Returns details on the active state of the
:: TX memory pool.
::
[%get-mempool-info ~]
:: %get-raw-mempool: Returns all transaction ids in memory pool as a
:: json array of string transaction ids.
::
[%get-raw-mempool verbose=(unit ?)]
:: %get-tx-out: Returns details about an unspent transaction output.
::
[%get-tx-out txid=@ux n=@ud include-mempool=(unit ?)]
:: %get-tx-out-proof: Returns a hex-encoded proof that "txid" was
:: included in a block.
::
[%get-tx-out-proof tx-ids=(list @ux) blockhash=(unit @ux)]
:: %get-tx-outset-info: Returns statistics about the unspent
:: transaction output set.
::
[%get-tx-outset-info ~]
:: %precious-block: Treats a block as if it were received before
:: others with the same work.
::
[%precious-block blockhash=@ux]
:: %prune-blockchain:
::
[%prune-blockchain height=@ud]
:: %save-mempool: Dumps the mempool to disk.
:: It will fail until the previous dump is fully loaded.
::
[%save-mempool ~]
:: %scan-tx-outset: Scans the unspent transaction output set for
:: entries that match certain output descriptors.
::
$: %scan-tx-outset
action=?(%start %abort %status)
scan-objects=(list scan-object)
==
:: %verify-chain: Verifies blockchain database.
::
[%verify-chain check-level=(unit @ud) n-blocks=(unit @ud)]
:: %verify-tx-out-proof: Verifies that a proof points to a transaction
:: in a block, returning the transaction it commits to
:: and throwing an RPC error if the block is not in our best chain
::
[%verify-tx-out-proof proof=@t]
:: Control
::
:: %getmemoryinfo: Returns an object containing information about memory
:: usage.
::
[%get-memory-info ~]
:: %getrpcinfo: Returns details of the RPC server.
::
[%get-rpc-info ~]
:: %help: List all commands, or get help for a specified command.
::
[%help command=(unit @t)]
:: %logging: Gets and sets the logging configuration.
::
$: %logging
include=?(%all %none (list logging-category))
exclude=?(%all %none (list logging-category))
==
:: %stop: Stop Bitcoin server.
::
[%stop ~]
:: %uptime: Returns the total uptime of the server.
::
[%uptime ~]
:: Generating
::
[%generate blocks=@ud max-tries=(unit @ud)]
:: %generatetoaddress: Mine blocks immediately to a specified address
:: (before the RPC call returns)
::
[%generate-to-address n-blocks=@ud =address max-tries=(unit @ud)]
:: Mining
::
:: %getblocktemplate: It returns data needed to construct a block
:: to work on.
::
$: %get-block-template
rules=(list rule)
capabilities=(list capability)
mode=(unit block-template-mode)
==
:: %getmininginfo: Returns a json object containing mining-related
:: information.
::
[%get-mining-info ~]
:: %getnetworkhashps: Returns the estimated network hashes per second
:: based on the last n blocks.
::
[%get-network-hash-ps n-blocks=(unit @ud) height=(unit @ud)]
:: %prioritisetransaction: Accepts the transaction into mined blocks
:: at a higher (or lower) priority
::
[%prioritise-transaction txid=@ux fee-delta=@ud]
:: %submitblock: Attempts to submit new block to network.
::
[%submit-block hex-data=@ux]
:: %submitheader: Decode the given hexdata as a header and submit it
:: as a candidate chain tip if valid. Throws when the header is
:: invalid.
::
[%submit-header hex-data=@ux]
:: Mining
::
:: %addnode: Attempts to add or remove a node from the addnode list.
:: Or try a connection to a node once.
::
[%add-node node=@if port=@ud command=?(%add %remove %onetry)]
:: %clearbanned: Clear all banned IPs.
::
[%clear-banned ~]
:: %disconnectnode: Immediately disconnects from the specified peer node.
::
[%disconnect-node node=?(node-id=@t [address=@if port=@ud])]
:: %getaddednodeinfo: Returns information about the given added node,
:: or all added nodes (note that onetry addnodes are not listed here)
::
[%get-added-node-info node=(unit @if)]
:: %getconnectioncount: Returns the number of connections to other
:: nodes.
::
[%get-connection-count ~]
:: %getnettotals: Returns information about network traffic,
:: including bytes in, bytes out, and current time.
::
[%get-net-totals ~]
:: %getnetworkinfo: Returns an object containing various state info
:: regarding P2P networking.
::
[%get-network-info ~]
:: %getnodeaddresses: Return known addresses which can potentially be
:: used to find new nodes in the network
[%get-node-addresses count=(unit @ud)]
:: %getpeerinfo: Returns data about each connected network node as a
:: json array of objects.
::
[%get-peer-info ~]
:: %listbanned: List all banned IPs/Subnets.
::
[%list-banned ~]
:: %ping: Requests that a ping be sent to all other nodes, to measure
:: ping time. Results provided in getpeerinfo, pingtime and pingwait
:: fields are decimal seconds. Ping command is handled in queue with all
:: other commands, so it measures processing backlog, not just network
:: ping.
::
[%ping ~]
:: %setban: Attempts to add or remove an IP/Subnet from the banned list.
::
$: %set-ban
subnet=@t
command=?(%add %remove)
ban-time=(unit ?([%dr @dr] [%da @da]))
==
:: %setnetworkactive: Disable/enable all p2p network activity.
::
[%set-network-active state=?]
:: Raw Transactions
::
:: %analyze-psbt: Analyzes and provides information about
:: the current status of a PSBT and its inputs
::
[%analyze-psbt psbt=@t]
:: %combine-psbt: Combine multiple partially signed Bitcoin
:: transactions into one transaction.
::
[%combine-psbt txs=(list @t)]
:: %combine-raw-transaction: Combine multiple partially signed t
:: ransactions into one transaction.
::
[%combine-raw-transaction txs=(list @ux)]
:: %convert-to-psbt: Converts a network serialized transaction to a
:: PSBT.
::
$: %convert-to-psbt
hex-string=@ux
permit-sig-data=(unit ?)
is-witness=(unit ?)
==
:: %create-psbt: Creates a transaction in the Partially Signed
:: Transaction format.
::
[%create-psbt partially-signed-transaction]
:: %create-raw-transaction: Create a transaction spending the given
:: inputs and creating new outputs.
::
[%create-raw-transaction partially-signed-transaction]
:: %decode-psbt: Return a JSON object representing the serialized,
:: base64-encoded partially signed Bitcoin transaction.
::
[%decode-psbt psbt=@t]
:: %decode-raw-transaction: Return a JSON object representing the
:: serialized, hex-encoded transaction.
::
[%decode-raw-transaction hex-string=@ux is-witness=?]
:: %decode-script: Decode a hex-encoded script.
::
[%decode-script hex-string=@ux]
:: %finalize-psbt: Finalize the inputs of a PSBT.
::
[%finalize-psbt psbt=@t extract=(unit ?)]
:: %fund-raw-transaction: Add inputs to a transaction until it has
:: enough in value to meet its out value.
::
$: %fund-raw-transaction
hex-string=@ux
::
$= options
%- unit
$: change-address=(unit address)
change-position=(unit @ud)
change-type=(unit address-type)
include-watching=(unit ?)
lock-unspents=(unit ?)
fee-rate=(unit @t)
subtract-fee-from-outputs=(unit (list @ud))
replaceable=(unit ?)
conf-target=(unit @ud)
mode=(unit estimate-mode)
==
::
is-witness=?
==
:: %get-raw-transaction: Return the raw transaction data.
::
[%get-raw-transaction txid=@ux verbose=(unit ?) blockhash=(unit @ux)]
:: %join-psbts: Joins multiple distinct PSBTs with different inputs
:: and outputs into one PSBT with inputs and outputs from all of
:: the PSBTs
::
[%join-psbts txs=(list @t)]
:: %send-raw-transaction: Submits raw transaction
:: (serialized, hex-encoded) to local node and network.
::
[%send-raw-transaction hex-string=@ux max-fee-rate=(unit @t)]
:: %sign-raw-transaction-with-key: Sign inputs for raw transaction
:: (serialized, hex-encoded).
::
$: %sign-raw-transaction-with-key
hex-string=@ux
priv-keys=(list @t)
prev-txs=(unit (list prev-tx))
sig-hash-type=(unit sig-hash)
==
:: %test-mempool-accept: Returns result of mempool acceptance tests
:: indicating if raw transaction (serialized, hex-encoded) would be
:: accepted by mempool.
::
[%test-mempool-accept raw-txs=(list @ux) max-fee-rate=(unit @t)]
:: %utxo-update-psbt: Updates a PSBT with witness UTXOs retrieved from
:: the UTXO set or the mempool.
::
$: %utxo-update-psbt
psbt=@t
descriptors=(unit (list descriptor))
==
:: Util
::
:: %create-multi-sig: Creates a multi-signature address with n
:: signature of m keys required. It returns a json object with the
:: address and redeemScript.
::
$: %create-multi-sig
n-required=@ud
keys=(list @ux)
address-type=(unit address-type)
==
:: %derive-addresses: Derives one or more addresses corresponding to
:: an output descriptor.
::
[%derive-addresses descriptor=@t range=(unit range)]
:: %estimate-smart-fee: Estimates the approximate fee per kilobyte
:: needed for a transaction to begin confirmation within conf_target
:: blocks if possible and return the number of blocks for which the
:: estimate is valid.
::
[%estimate-smart-fee conf-target=@ud mode=(unit estimate-mode)]
:: %get-descriptor-info: Analyses a descriptor.
::
[%get-descriptor-info descriptor=@t]
:: %sign-message-with-privkey: Sign a message with the private key of
:: an address
::
[%sign-message-with-privkey privkey=@t message=@t]
:: %validate-address: Return information about the given
:: bitcoin address.
::
[%validate-address =address]
:: %verify-message: Verify a signed message
::
[%verify-message =address signature=@t message=@t]
:: Wallet
::
:: %abandon-transaction: Mark in-wallet transaction as abandoned.
::
[%abandon-transaction txid=@ux]
:: %abort-rescan: Stops current wallet rescan triggered by an
:: RPC call, e.g. by an importprivkey call.
::
[%abort-rescan ~]
:: %add-multisig-address: Add a nrequired-to-sign multisignature
:: address to the wallet.
::
$: %add-multisig-address
n-required=@ud
keys=(list address)
label=(unit @t)
=address-type
==
:: %backupwallet: Safely copies current wallet file to destination.
::
[%backup-wallet destination=@t]
:: %bump-fee: Bumps the fee of an opt-in-RBF transaction T, replacing
:: it with a new transaction B.
::
$: %bump-fee
txid=@ux
::
$= options
%- unit
$: conf-target=(unit @ud)
total-fee=(unit @t)
fee-rate=(unit @t)
replaceable=(unit ?)
mode=(unit estimate-mode)
== ==
:: %create-wallet: Creates and loads a new wallet.
::
:: - %name: The name for the new wallet.
:: - %disable-private-keys: Disable the possibility of private keys
:: (only watchonlys are possible in this mode).
:: - %blank: Create a blank wallet.
:: A blank wallet has no keys or HD seed.
:: One can be set using sethdseed.
::
$: %create-wallet
name=@t
disable-private-keys=(unit ?)
blank=(unit ?)
passphrase=(unit @t)
avoid-reuse=(unit ?)
==
:: %dump-privkey: Reveals the private key corresponding to 'address'.
::
[%dump-privkey =address]
:: %dump-wallet: Dumps all wallet keys in a human-readable format to
:: a server-side file.
::
[%dump-wallet filename=@t]
:: %encrypt-wallet: Encrypts the wallet with 'passphrase'.
::
[%encrypt-wallet passphrase=@t]
:: %get-addresses-by-label: Returns the list of addresses assigned the
:: specified label.
::
[%get-addresses-by-label label=@t]
:: %get-address-info: Return information about the given bitcoin
:: address.
::
[%get-address-info =address]
:: %get-balance: Returns the total available balance.
::
$: %get-balance
%- unit
$: dummy=(unit %'*')
minconf=(unit @ud)
include-watch-only=(unit ?)
avoid-reuse=(unit ?)
== ==
:: %get-balances: Returns an object with all balances in BTC.
::
[%get-balances ~]
:: %get-new-address: Returns a new Bitcoin address for receiving
:: payments.
::
[%get-new-address label=(unit @t) address-type=(unit address-type)]
:: %get-raw-change-address: Returns a new Bitcoin address,
:: for receiving change.
::
[%get-raw-change-address address-type=(unit address-type)]
:: %get-received-by-address: Returns the total amount received by the
:: given address in transactions with at least minconf confirmations.
::
[%get-received-by-address =address minconf=@ud]
:: %get-received-by-label: Returns the total amount received by
:: addresses with <label> in transactions with at least [minconf]
:: confirmations.
::
[%get-received-by-label label=@t minconf=(unit @ud)]
:: %get-transaction: Get detailed information about in-wallet
:: transaction <txid>
::
$: %get-transaction
txid=@ux
include-watch-only=(unit ?)
verbose=(unit ?)
==
:: %get-unconfirmed-balance: Returns the server's total unconfirmed
:: balance
::
[%get-unconfirmed-balance ~]
:: %get-wallet-info: Returns an object containing various wallet
:: state info.
::
[%get-wallet-info wallet=@t]
:: %import-address: Adds an address or script (in hex) that can be
:: watched as if it were in your wallet but cannot be used to spend.
::
$: %import-address
$= address
$% [%addr @uc]
[%bech32 @t]
[%script @ux]
==
::
label=(unit @t)
rescan=(unit ?)
p2sh=(unit ?)
==
:: %import-multi: Import addresses/scripts (with private or public
:: keys, redeem script (P2SH)), optionally rescanning the blockchain
:: from the earliest creation time of the imported scripts.
::
$: %import-multi
requests=(list import-request)
options=(unit rescan=?)
==
:: %import-privkey: Adds a private key (as returned by dumpprivkey)
:: to your wallet.
::
[%import-privkey privkey=@t label=(unit @t) rescan=(unit ?)]
:: %import-pruned-funds: Imports funds without rescan.
::
[%import-pruned-funds raw-transaction=@ux tx-out-proof=@t]
:: %import-pubkey: Adds a public key (in hex) that can be watched as
:: if it were in your wallet but cannot be used to spend.
::
[%import-pubkey pubkey=@ux label=(unit @t) rescan=(unit ?)]
:: %import-wallet: Imports keys from a wallet dump file
::
[%import-wallet filename=@t]
:: %key-pool-refill: Fills the keypool.
::
[%key-pool-refill new-size=(unit @ud)]
:: %list-address-groupings: Lists groups of addresses which have had
:: their common ownership (made public by common use as inputs or as
:: the resulting change in past transactions)
::
[%list-address-groupings ~]
:: %list-labels: Returns the list of all labels, or labels that are
:: assigned to addresses with a specific purpose.
::
[%list-labels purpose=(unit purpose)]
:: %list-lock-unspent: Returns list of temporarily unspendable
:: outputs.
::
[%list-lock-unspent ~]
:: %list-received-by-address: List balances by receiving address.
::
$: %list-received-by-address
%- unit
$: minconf=(unit @ud)
include-empty=(unit ?)
include-watch-only=(unit ?)
address-filter=(unit =address)
== ==
:: %list-received-by-label: List received transactions by label.
::
$: %list-received-by-label
%- unit
$: minconf=(unit @ud)
include-empty=(unit ?)
include-watch-only=(unit ?)
== ==
:: %lists-in-ceblock: Get all transactions in blocks since block
:: [blockhash], or all transactions if omitted.
::
$: %lists-in-ceblock
%- unit
$: blockhash=(unit blockhash)
target-confirmations=(unit @ud)
include-watch-only=(unit ?)
include-removed=(unit ?)
== ==
:: %list-transactions: If a label name is provided, this will return
:: only incoming transactions paying to addresses with the specified
:: label.
::
$: %list-transactions
%- unit
$: label=(unit @t)
count=(unit @ud)
skip=(unit @ud)
include-watch-only=(unit ?)
== ==
:: %list-unspent: Returns array of unspent transaction outputs
:: (with between minconf and maxconf (inclusive) confirmations.
::
$: %list-unspent
%- unit
$: minconf=(unit @ud)
maxconf=(unit @ud)
addresses=(unit (list address))
include-unsafe=(unit ?)
::
$= query-options
%- unit
$: minimum-amount=(unit @ud)
maximum-amount=(unit @ud)
maximum-count=(unit @ud)
minimum-sum-amount=(unit @ud)
== == ==
:: %list-wallet-dir Returns a list of wallets in the wallet directory.
::
[%list-wallet-dir ~]
:: %list-wallets Returns a list of currently loaded wallets.
:: (For full information on the wallet, use "getwalletinfo"
::
[%list-wallets ~]
:: %load-wallet Loads a wallet from a wallet file or directory.
::
[%load-wallet filename=@t]
:: %lock-unspent: Updates list of temporarily unspendable outputs.
::
$: %lock-unspent
unlock=?
transactions=(unit (list [txid=@ux vout=@ud]))
==
:: %remove-pruned-funds Deletes the specified transaction from the
:: wallet.
::
[%remove-pruned-funds txid=@ux]
:: %rescan-blockchain Rescan the local blockchain for wallet related
:: transactions.
::
[%rescan-blockchain start-height=(unit @ud) stop-height=(unit @ud)]
:: %send-many: Send multiple times.
:: Amounts are double-precision floating point numbers.
::
$: %send-many
dummy=%$
amounts=(list [=address amount=@t])
minconf=(unit @ud)
comment=(unit @t)
subtract-fee-from=(unit (list address))
replaceable=(unit ?)
conf-target=(unit @ud)
mode=(unit estimate-mode)
==
:: %send-to-address: Send an amount to a given address.
::
$: %send-to-address
=address
amount=@t
comment=(unit @t)
comment-to=(unit @t)
subtract-fee-from-amount=(unit ?)
replaceable=(unit ?)
conf-target=(unit @ud)
mode=(unit estimate-mode)
avoid-reuse=(unit ?)
==
:: %set-hd-seed: Set or generate a new HD wallet seed.
:: Non-HD wallets will not be upgraded to being a HD wallet.
::
[%set-hd-seed ~]
:: %set-label: Sets the label associated with the given address.
::
[%set-label =address label=@t]
:: %set-tx-fee: Set the transaction fee per kB for this wallet.
::
[%set-tx-fee amount=@t]
:: %set-wallet-flag: Change the state of the given wallet flag for a wallet.
::
[%set-wallet-flag flag=@t value=(unit ?)]
:: %sign-message: Sign a message with the private key of an address
::
[%sign-message =address message=@t]
:: %sign-raw-transaction-with-wallet: Sign inputs for raw transaction
:: (serialized, hex-encoded).
::
$: %sign-raw-transaction-with-wallet
hex-string=@ux
prev-txs=(unit (list prev-tx))
sig-hash-type=(unit sig-hash)
==
:: %unload-wallet: Unloads the wallet referenced by the request
:: endpoint otherwise unloads the wallet specified in the argument.
::
[%unload-wallet wallet-name=(unit @t)]
:: %wallet-create-fundedpsbt: Creates and funds a transaction in the
:: Partially Signed Transaction format.
:: Inputs will be added if supplied inputs are not enough
::
$: %wallet-create-fundedpsbt
inputs=(list input)
outputs=output
locktime=(unit @ud)
::
$= options
%- unit
$: change-address=(unit address)
change-position=(unit @ud)
change-type=(unit address-type)
include-watching=(unit ?)
lock-unspents=(unit ?)
fee-rate=(unit @t)
subtract-fee-from-outputs=(unit (list @ud))
replaceable=(unit ?)
conf-target=(unit @ud)
mode=(unit estimate-mode)
==
::
bip32-derivs=(unit ?)
==
:: %wallet-lock: Removes the wallet encryption key from memory,
:: locking the wallet.
::
[%wallet-lock ~]
:: %wallet-passphrase: Stores the wallet decryption key in memory
:: for 'timeout' seconds.
::
[%wallet-passphrase passphrase=@t timeout=@ud]
:: %wallet-passphrase-changehange: s the wallet passphrase from
:: 'oldpassphrase' to 'newpassphrase'.
::
$: %wallet-passphrase-change
old-passphrase=(unit @t)
new-passphrase=(unit @t)
==
:: %wallet-process-psbt: Update a PSBT with input information from
:: our wallet and then sign inputs
::
$: %wallet-process-psbt
psbt=@t
sign=?
=sig-hash
bip32-derivs=(unit ?)
==
:: ZMQ management
::
:: %get-zmq-notifications Returns information about the active
:: ZeroMQ notifications.
::
[%get-zmq-notifications ~]
==
::
+$ response
$%
:: Blockchain
::
[%get-best-block-hash hex=@ux]
::
$: %get-block
$? :: verbosity = 0
::
@ux
::
:: verbosity > 0
::
$: hash=@ux
confirmations=@ud
size=@ud
stripped-size=@ud
weight=@ud
height=@ud
version=@t
version-hex=@ux
merkle-root=@ux
::
$= tx
%- list
$? :: verbosity = 1
::
@ux
::
:: verbosity = 2
::
raw-transaction-rpc-out
==
::
time=@ud
median-time=@ud
nonce=@ud
bits=@ux
difficulty=@t
chain-work=@ux
n-tx=@ud
previous-blockhash=@ux
next-blockhash=(unit @ux)
== == ==
::
$: %get-blockchain-info
chain=network-name
blocks=@ud
headers=@ud
best-block-hash=@ux
difficulty=@t
median-time=@ud
verification-progress=@t
initial-block-download=?
chain-work=@ux
size-on-disk=@ud
pruned=?
pruneheight=(unit @ud)
automatic-pruning=(unit ?)
prune-target-size=(unit @ud)
::
$= softforks
%+ map name=@t
$: type=soft-fork-types
::
$= bip9
%- unit
$: status=(unit soft-fork-status)
bit=(unit @ud)
start-time=?(%'-1' @ud)
timeout=@ud
since=@ud
::
$= statistics
%- unit
$: period=@ud
threshold=@ud
elapsed=@ud
count=@ud
possible=?
== ==
::
height=(unit @ud)
active=?
== ==
::
[%get-block-count count=@ud]
[%get-block-filter filter=@ux header=@ux]
[%get-block-hash hash=@ux]
::
$: %get-block-header
$? :: (for verbose = false)
::
@ux
::
:: (for verbose = true)
::
$: hash=@ux
confirmations=@ud
weight=@ud
version=@t
version-hex=@ux
merkle-root=@ux
time=@ud
median-time=@ud
nonce=@ud
bits=@ux
difficulty=@t
chain-work=@ux
n-tx=@ud
previous-blockhash=@ux
next-blockhash=(unit @ux)
== == ==
::
$: %get-block-stats
avg-fee=@t
avg-feerate=@ud
avg-tx-size=@ud
block-hash=@ux
::
$= fee-rate-percentiles
$: p-1=@t
p-2=@t
p-3=@t
p-4=@t
p-5=@t
==
::
height=@ud
ins=@ud
max-fee=@t
max-fee-rate=@t
max-tx-size=@ud
median-fee=@t
median-time=@ud
median-tx-size=@ud
min-fee=@t
min-fee-rate=@t
min-tx-size=@ud
outs=@ud
subsidy=@t
swtotal-size=@ud
swtotal-weight=@ud
swtxs=@ud
time=@ud
total-out=@t
total-size=@ud
total-weight=@t
total-fee=@t
txs=@ud
utxo-increase=@t
utxo-size-inc=@t
==
::
$: %get-chain-tips
%- list
$: height=@ud
hash=@ux
branch-len=@ud
status=chain-status
== ==
::
$: %get-chain-tx-stats
time=@ud
tx-count=@ud
window-final-block-hash=@ux
window-final-block-height=@ud
window-block-count=@ud
window-tx-count=(unit @ud)
window-interval=(unit @ud)
tx-rate=(unit @t)
==
::
[%get-difficulty n=@t]
[%get-mempool-ancestors mem-pool-response]
[%get-mempool-descendants mem-pool-response]
[%get-mempool-entry mem-pool]
::
$: %get-mempool-info
size=@ud
bytes=@ud
usage=@ud
max-mem-pool=@ud
mem-pool-min-fee=@t
min-relay-tx-fee=@t
==
::
[%get-raw-mempool mem-pool-response]
::
$: %get-tx-out
%- unit
$: best-block=@ux
confirmations=@ud
value=@t
::
$= script-pubkey
$: asm=@t
hex=@ux
req-sigs=(unit @ud)
type=@t
addresses=(unit (list address))
==
::
coinbase=?
== ==
::
[%get-tx-out-proof data=@t]
::
$: %get-tx-outset-info
height=@ud
best-block=@ux
transactions=@ud
tx-outs=@ud
bogo-size=@ud
hash-serialized-2=@ux
disk-size=@ud
total-amount=@t
==
::
[%precious-block ~]
[%prune-blockchain height=@ud]
[%save-mempool ~]
::
$: %scan-tx-outset
success=(unit ?)
searched-items=(unit @ud)
txouts=(unit @ud)
height=(unit @ud)
best-blocks=(unit @ux)
::
$= unspents
%- list
$: txid=@ux
vout=@ud
script-pubkey=@ux
desc=@t
amount=@t
height=@ud
==
::
total-amount=@t
==
::
[%verify-chain ?]
[%verify-tx-out-proof (list @ux)]
:: Control
::
$: %get-memory-info
used=@ud
free=@ud
total=@ud
locked=@ud
chunks-free=@ud
chunks-used=@ud
==
::
[%get-rpc-info active-commands=(list rpc-command)]
[%help help=wall]
[%logging logging-config=(map @t ?)]
[%stop res=@t]
[%uptime uptime=@dr]
:: Generating
::
[%generate blocks=(list blockhash)]
[%generate-to-address blockhashes=(list blockhash)]
:: Mining
::
$: %get-block-template
version=@ud
rules=(list rule)
vb-available=(map @t @ud)
vb-required=@ud
previous-blockhash=blockhash
transactions=(list transaction)
coinbase-aux=@t
coinbase-value=@ud
target=blockhash
min-time=@da
mutable=(list mutable)
nonce-range=@t
sigop-limit=@ud
size-limit=@ud
weight-limit=@ud
cur-time=@da
bits=@ux
height=@ud
default-witness-commitment=blockhash
==
::
$: %get-mining-info
blocks=@ud
current-block-weight=@ud
current-block-tx=@ud
difficulty=@rd
network-hash-ps=@rd
pooled-tx=@ud
chain=network-name
warnings=@t
==
::
[%get-network-hash-ps hash-ps=@rd]
[%prioritise-transaction res=?]
[%submit-block res=@t]
[%submit-header res=@t]
:: Network
::
[%add-node res=null]
[%clear-banned res=null]
[%disconnect-node res=null]
[%get-added-node-info node-info=(list node-info)]
[%get-connection-count connection-count=@ud]
::
$: %get-net-totals
total-bytes-recv=@ud
total-bytes-sent=@ud
time-millis=@da
=upload-target
==
::
$: %get-network-info
version=@ud
subversion=@t
protocol-version=@ud
local-services=@t
local-services-names=(list @t)
local-relay=?
time-offset=@t
connections=@ud
network-active=?
networks=(list network-info)
relay-fee=@rd
incremental-fee=@rd
local-addresses=(list local-address)
warnings=@t
==
::
[%get-node-addresses (list node-address-info)]
[%get-peer-info (list peer-info)]
[%list-banned (list banned)]
[%ping res=null]
[%set-ban res=null]
[%set-network-active res=?]
:: Raw Transactions
::
$: %analyze-psbt
$= inputs
%- list
$: has-utxo=?
is-final=?
::
$= missing
%- unit
$: pubkeys=(unit (list @ux))
signatures=(unit (list @ux))
redeem-script=(unit @ux)
witness-script=(unit @ux)
==
::
next=(unit @t)
==
::
estimated-vsize=(unit @t)
estimated-feerate=(unit @t)
fee=(unit @t)
next=@t
==
::
[%combine-psbt psbt=@t]
[%combine-raw-transaction hex=@ux]
[%convert-to-psbt psbt=@t]
[%create-psbt psbt=@t]
[%create-raw-transaction transaction=@ux]
::
$: %decode-psbt
tx=serialized-tx
::
unknown=(map @t @t)
::
$= inputs
%- list
$: non-witness-utxo=utxo
witness-utxo=utxo
partial-signatures=(unit (map pubkey=@ux signature=@ux))
sig-hash-type=(unit sig-hash)
redeem-script=(unit script)
witness-script=(unit script)
::
$= bip32-derivs
%- unit
%+ map
pubkey=@ux
::
$: master-fingerprint=@t
path=@t
==
::
final-script-sig=(unit [asm=@t hex=@ux])
final-script-witness=(unit (list @ux))
unknown=(unit (map @t @t))
==
::
$= outputs
%- list
$: redeem-script=(unit script)
witness-script=(unit script)
::
$= bip32-derivs
%- unit
%+ map
pubkey=@ux
::
$: master-fingerprint=@t
path=@t
==
::
unknown=(unit (map @t @t))
==
::
fee=(unit @t)
==
::
[%decode-raw-transaction =serialized-tx]
::
$: %decode-script
asm=@t
hex=(unit @ux)
type=@t
req-sigs=(unit @ud)
addresses=(unit (list address))
p2sh=(unit @uc)
segwit=(unit segwit-script)
==
::
[%finalize-psbt psbt=(unit @t) hex=(unit @ux) complete=?]
[%fund-raw-transaction hex=@ux fee=@t change-pos=?(@ud %'-1')]
[%get-raw-transaction data=?(@ux raw-transaction-rpc-out)]
[%join-psbts psbt=@t]
[%send-raw-transaction hex=@ux]
::
$: %sign-raw-transaction-with-key
hex=@ux
complete=?
errors=(unit errors)
==
::
$: %test-mempool-accept
%- list
$: txid=@ux
allowed=?
reject-reason=(unit @t)
== ==
::
[%utxo-update-psbt psbt=@t]
:: Util
::
[%create-multi-sig =address redeem-script=@t]
[%derive-addresses (list address)]
::
$: %estimate-smart-fee
fee-rate=(unit @t)
errors=(unit (list @t))
blocks=@ud
==
::
$: %get-descriptor-info
descriptor=@t
checksum=@t
is-range=?
is-solvable=?
has-private-keys=?
==
::
[%sign-message-with-privkey signature=@t]
::
$: %validate-address
is-valid=?
address=(unit address)
script-pubkey=(unit @ux)
is-script=(unit ?)
is-witness=(unit ?)
witness-version=(unit @t)
witness-program=(unit @ux)
==
::
[%verify-message ?]
:: Wallet
::
[%abandon-transaction ~]
[%abort-rescan ~]
::
$: %add-multisig-address
=address
redeem-script=@t
==
::
[%backup-wallet ~]
[%bump-fee txid=@ux orig-fee=@t fee=@t errors=(list @t)]
[%create-wallet name=@t warning=@t]
[%dump-privkey key=@t]
[%dump-wallet filename=@t]
[%encrypt-wallet ~]
::
$: %get-addresses-by-label
addresses=(list [address =purpose])
==
::
$: %get-address-info
=address
script-pubkey=@ux
is-mine=?
is-watchonly=?
solvable=?
desc=(unit @t)
is-script=?
is-change=?
is-witness=?
witness-version=(unit @t)
witness-program=(unit @ux)
script=(unit @t)
hex=(unit @ux)
pubkeys=(unit (list @ux))
sigs-required=(unit @ud)
pubkey=(unit @ux)
::
$= embedded
%- unit
$: script-pubkey=@ux
solvable=(unit ?)
desc=(unit @t)
is-script=?
is-change=(unit ?)
is-witness=?
witness-version=(unit @t)
witness-program=(unit @ux)
script=(unit @ux)
hex=(unit @ux)
pubkeys=(unit (list @ux))
sigs-required=(unit @ud)
pubkey=(unit @ux)
is-compressed=(unit ?)
label=(unit @t)
hd-master-finger-print=(unit @ux)
labels=(unit (list [name=@t =purpose]))
==
::
is-compressed=(unit ?)
label=(unit @t)
timestamp=(unit @ud)
hd-key-path=(unit @t)
hd-seed-id=(unit @ux)
hd-master-finger-print=(unit @ux)
labels=(list [name=@t =purpose])
==
::
[%get-balance amount=@t]
::
$: %get-balances
$= mine
$: trusted=(unit @t)
untrusted-pending=@t
immature=@t
used=(unit @t)
==
::
$= watchonly
%- unit
$: trusted=@t
untrusted-pending=@t
immature=@t
== ==
::
[%get-new-address =address]
[%get-raw-change-address =address]
[%get-received-by-address amount=@t]
[%get-received-by-label amount=@t]
::
$: %get-transaction
amount=@t
fee=(unit @t)
confirmations=@ud
blockhash=(unit @ux)
blockindex=(unit @ud)
blocktime=(unit @ud)
txid=@ux
time=@ud
time-received=@ud
=bip125-replaceable
::
$= details
%- list
$: address=(unit address)
=category
amount=@t
label=(unit @t)
vout=@ud
fee=(unit @t)
abandoned=(unit ?)
==
::
hex=@ux
decoded=(unit raw-transaction-rpc-out)
==
::
[%get-unconfirmed-balance amount=@t]
::
$: %get-wallet-info
wallet-name=@t
wallet-version=@ud
balance=@t
unconfirmed-balance=@t
immature-balance=@t
tx-count=@ud
key-pool-oldest=@ud
key-pool-size=@ud
key-pool-size-hd-internal=(unit @ud)
unlocked-until=(unit @ud)
pay-tx-fee=@t
hd-seed-id=(unit @ux)
private-keys-enabled=?
avoid-reuse=?
scanning=?(? [duration=@t progress=@t])
==
::
[%import-address ~]
::
$: %import-multi
%- list
$: success=?
warnings=(unit (list @t))
errors=(unit [code=@t message=@t])
== ==
::
[%import-privkey ~]
[%import-pruned-funds ~]
[%import-pubkey ~]
[%import-wallet ~]
[%key-pool-refill ~]
::
$: %list-address-groupings
$= groups
%- list
%- list
%- list
$: address
amount=@t
label=(unit @t)
== ==
::
[%list-labels labels=(list @t)]
[%list-lock-unspent outputs=(list [txid=@ux vout=@ud])]
::
$: %list-received-by-address
%- list
$: involves-watch-only=(unit %&)
=address
amount=@t
confirmations=@ud
label=@t
txids=(list @ux)
== ==
::
$: %list-received-by-label
%- list
$: involves-watch-only=(unit %&)
amount=@t
confirmations=@ud
label=@t
== ==
::
$: %lists-in-ceblock
transactions=(list tx-in-block)
removed=(unit (list tx-in-block))
last-block=@ux
==
::
[%list-transactions transactions=(list tx-in-block)]
::
$: %list-unspent
$= txs
%- list
$: txid=@ux
vout=@ud
=address
label=@t
script-pubkey=@ux
amount=@t
confirmations=@ud
redeem-script=@ux
witness-script=(unit @ux)
spendable=?
solvable=?
reused=(unit ?)
desc=(unit @t)
safe=?
== ==
::
[%list-wallet-dir wallets=(list @t)]
[%list-wallets wallets=(list @t)]
[%load-wallet name=@t warning=@t]
[%lock-unspent ?]
[%remove-pruned-funds ~]
[%rescan-blockchain start-height=@ud stop-height=@ud]
[%send-many txid=@ux]
[%send-to-address txid=@ux]
[%set-hd-seed ~]
[%set-label ~]
[%set-tx-fee ?]
[%set-wallet-flag flag-name=@t flag-state=? warnings=@t]
[%sign-message signature=@t]
::
$: %sign-raw-transaction-with-wallet
hex=@ux
complete=?
errors=(unit errors)
==
::
[%unload-wallet ~]
[%wallet-create-fundedpsbt psbt=@t fee=@t changepos=?(@ud %'-1')]
[%wallet-lock ~]
[%wallet-passphrase ~]
[%wallet-passphrase-change ~]
[%wallet-process-psbt psbt=@t complete=?]
::
:: ZMQ
::
$: %get-zmq-notifications
(list [type=@t =address hwm=@ud])
== ==
::
+$ command
$% :: Loads RPC node URL+credentials
::
[%credentials url=@t user=@t pass=@t]
watch commands
2020-10-02 14:05:41 +03:00
:: Adds an RPC call to the set of calls that trigger a broadcast to subscribers
::
[%watch call=term]
cleaner ping
2020-10-03 13:54:31 +03:00
:: Removes an RPC call from the set of calls that trigger a broadcast to subscribers
watch commands
2020-10-02 14:05:41 +03:00
::
[%unwatch call=term]
cleaner ping
2020-10-03 13:54:31 +03:00
:: Check connectivity of node and return to subscribers
::
[%ping ~]
w btc-node
2020-10-02 08:48:58 +03:00
:: TODO: Sync data/wallets...
::
[%sync ~]
==
--
--
Reference in New Issue Copy Permalink