Bonds

Some Mostro nodes require bonds: a small Lightning payment that a maker and/or taker locks to discourage abandoning a trade. A bond that is not forfeited is returned; a slashed bond is (partly) paid to the counterparty.

The JSON commands handle bonded nodes according to the contract, but the CLI’s own notes say the bonded-node cases were verified against a scripted node and only partly on a real one. Test against your node before relying on them.

Maker bond

mostro-cli --output json order new ... --yes

data.next_step: "pay_bond_invoice", data.payment_request holds the bond invoice and the order is parked (status pending or waiting-maker-bond). Pay it; the node then publishes the order. A message list record with next_step: pay_bond_invoice carries the same invoice.

Taker bond

order take-sell / order take-buy may answer next_step: "pay_bond_invoice" with the invoice in data.payment_request. Pay it; the node continues the take (for take-buy, the hold invoice then arrives as a message with next_step: pay_hold_invoice).

Cancelling while a bond is due

Until the bond is paid, order cancel --order <id> --yes withdraws, with data.result: "canceled" and local status canceled:

• a taker at waiting-taker-bond backs out: the node releases the taker’s bond and puts the order back to pending for other takers;
• a maker at waiting-maker-bond closes the order, which was never published.

If the maker’s bond got locked meanwhile, the node refuses with node_refused and reason: not_allowed_by_status (read from the daemon’s source; the scripted node does not exercise it).

Bond messages

message list reports the bond events as informational records (next_step: null) whose payload.kind is order:

Receiving a slashed bond

When your counterparty’s bond is slashed, the node asks you for a payout invoice:

{"action": "add-bond-invoice", "next_step": "add_bond_invoice",
 "payload": {"kind": "bond_payout_request", "order": {...}, "slashed_at": "...", "slashed_at_unix": "..."}}

payload.order.sats_amount is your share and payload.slashed_at the time of the slash. Create an invoice for exactly your share and send it:

mostro-cli --output json bond add-invoice --order <id> --invoice <bolt11> --yes

data.result: "invoice_accepted"; data.counterparty_share_sats reports the amount when the node gave it. See bond add-invoice.