Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions src/admin_cancel_order.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,8 @@ Accepted combinations on `admin-cancel`:

Whenever a side is slashed and the operator has configured `slash_node_share_pct < 1.0`, the non-slashed counterparty is subsequently asked to provide a Lightning invoice for their share of the bond via [Bond payout invoice](./add_bond_invoice.md).

Each slashed party is also sent a [`bond-slashed`](./bond_slashed.md) forfeiture notice for the slashed bond amount, in addition to the `admin-canceled` confirmation below.

## Mostro response

Mostro will send this message to the both parties buyer/seller and to the admin:
Expand Down
2 changes: 2 additions & 0 deletions src/admin_settle_order.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,8 @@ Accepted combinations on `admin-settle`:

Whenever a side is slashed and the operator has configured `slash_node_share_pct < 1.0`, the non-slashed counterparty is subsequently asked to provide a Lightning invoice for their share of the bond via [Bond payout invoice](./add_bond_invoice.md).

Each slashed party is also sent a [`bond-slashed`](./bond_slashed.md) forfeiture notice for the slashed bond amount, in addition to the `admin-settled` confirmation below.

## Mostro response

Mostro will send this message to the both parties buyer/seller and to the admin:
Expand Down
4 changes: 2 additions & 2 deletions src/bond_slashed.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

The `bond-slashed` action is a notification Mostro sends to a bonded party when their anti-abuse bond has been **settled due to a waiting-state timeout**. It is a forfeiture notice: the bond HTLC has already been claimed into Mostro's wallet by the time this message is sent.

> **Scope.** This action is only emitted on the **timeout slash** path (scheduler-driven, gated by `bond_slash_on_waiting_timeout = "true"` in the Mostro info event — see [Other events published by Mostro](./other_events.md#anti-abuse-bond-policy-tags)). It is **not** sent on the dispute-slash path — when a solver slashes a bond via [`admin-settle`](./admin_settle_order.md) or [`admin-cancel`](./admin_cancel_order.md), the slashed party receives the `admin-settled` / `admin-canceled` confirmation instead.
> **Scope.** This action is emitted on the **timeout slash** path (scheduler-driven, gated by `bond_slash_on_waiting_timeout = "true"` in the Mostro info event — see [Other events published by Mostro](./other_events.md#anti-abuse-bond-policy-tags)). It is **also** sent on the dispute-slash path — when a solver slashes a bond via [`admin-settle`](./admin_settle_order.md) or [`admin-cancel`](./admin_cancel_order.md), the slashed party receives a `bond-slashed` notice **in addition to** the `admin-settled` / `admin-canceled` confirmation.

## Direction and trigger

Expand Down Expand Up @@ -58,4 +58,4 @@ After `bond-slashed` is sent to the responsible party, Mostro also:

## Note on cancels vs. slashes

A cancel sent by either party **before** the timeout elapses never triggers `bond-slashed`. Bonds are always released (never slashed) on user-initiated cancels. Only the automated scheduler-driven timeout slash path emits this action, and only when `slash_on_waiting_timeout = true` is set by the operator.
A cancel sent by either party **before** the timeout elapses never triggers `bond-slashed`. Bonds are always released (never slashed) on user-initiated cancels. This action is emitted by the automated scheduler-driven timeout slash path (when `slash_on_waiting_timeout = true` is set by the operator) and by a solver's slash directive on a dispute.
2 changes: 1 addition & 1 deletion src/message_suggestions_for_actions.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ Below are suggestions for messages that clients can show to users when receiving
Your bond payout of `amount` Sats has been sent successfully. The funds should arrive in your Lightning wallet shortly.

- **bond-slashed:**
Your anti-abuse bond of `amount` Sats has been forfeited. This happened because the waiting-state timeout elapsed before you completed your required action on order `id`. The bond has been settled into the node's wallet.
You have lost your anti-abuse bond of `amount` Sats for your order `id`.

- **add-invoice:**
Please send me an invoice for `amount` satoshis equivalent to `fiat_code` `fiat_amount`. This is where I will send the funds upon trade completion. If you don’t provide the invoice within `expiration_seconds`, the trade will be canceled.
Expand Down