Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Migration from old spellings

The JSON-capable commands replaced older spellings without aliases. An old spelling fails like an unknown command: invalid_arguments, exit 2, command: null.

BeforeNow
--mostropubkey KEY (root)--mostro-pubkey KEY
listorders --kind buy|sell ...order list --side buy|sell [--currency CUR] [--status STATUS]
ordersinfo -o ID -o ID2 / --orderidsorder info --order ID --order ID2
neworder -k KIND -c CUR -f AMOUNT -m METHOD [-a SATS] [-p PREMIUM] [-i INVOICE] [-e DAYS]order new --side KIND --currency CUR --fiat-amount AMOUNT --payment-method METHOD [--sats SATS] [--premium PREMIUM] [--invoice INVOICE] [--expiration-days DAYS] --yes
neworder ... -f 100-200 (range)order new ... --fiat-amount 100 --fiat-amount-max 200
takesell -o ID [-i INVOICE] [-a AMOUNT]order take-sell --order ID [--invoice INVOICE] [--amount AMOUNT] --yes
takebuy -o ID [-a AMOUNT]order take-buy --order ID [--amount AMOUNT] --yes
addinvoice -o ID -i INVOICEorder add-invoice --order ID --invoice INVOICE --yes
addbondinvoice -o ID -i INVOICEbond add-invoice --order ID --invoice INVOICE --yes
fiatsent -o IDorder fiat-sent --order ID --yes
release -o IDorder release --order ID --yes
cancel -o IDorder cancel --order ID --yes
getdm ...message list [--since MINUTES] [--order ID]
dispute -o ID / --orderiddispute open --order ID --yes
rate -o ID -r RATINGorder rate --order ID --rating RATING --yes
—order sync [--since MINUTES] (new)
—order mine (new)
—identity init, identity show (new)
—schema (new)

Behaviour changes that matter to wrappers:

  • JSON commands other than identity init never create an identity. A command that needs one returns identity_missing when none exists; schema and order list need none. Create one explicitly with identity init (a legacy command run first still creates it too).
  • order info waits for the reply to its request (not the first message), and an empty answer is a success with not_returned.
  • Writes require --yes in JSON mode; no stdin prompt is ever shown.
  • message list is read-only and shows only messages authored by the node.
  • --kind became --side; short option letters of the old commands are gone.
  • New options with no old spelling: order new --expires-in SECONDS, --invoice - (the invoice read from standard input) and the global --reply-timeout SECONDS; see Invoking the CLI.

The short root options (-m, -r, -p, -s, -t, -v) still exist.