Outbound Transaction Error

This event is used to communicate errors encountered when trying to "burn" existing tokens in the Ledger module.

Event Signature

An Outbound Transaction Error event has the following form:

{
  "id": "{eventId}",
  "pubkey": "{ledgerPubkey}",
  "created_at": timestamp,
  "kind": 1112,
  "tags": [
    ["p", "{minterPubkey}"],
    ["p", "{minterPubkey}"],
    ["e", "{outboundTransactionEventId}"],
    ["t", "outbound-transaction-error"],
    ...,
  ],
  "content": "{outboundTransactionErrorContent}",
  "sig": "{signature}"
}

Note:

• the .pubkey is the Ledger module's pubkey,
• the .kind field is 1112 (ie. a regular event),
• both "p" tags point to the URLx module's pubkey (ie. the minter),
• the "t" tag sub-kind is outbound-transaction-error.

The content itself is the JSON serialization of an object of the following form:

{
    "messages": [
      "{errorMessage}"
    ]
}

An example TypeScript type definition for this event's content is:

type OutboundTransactionErrorContent = {
    messages: [string],
};

Emitters

This event is emitted by:

• The Ledger module, when an outbound transaction event fails for whatever reason.

Targets

This event is targeted towards:

• The URLx module.

Listeners

This event is listened for by:

• The URLx module.
• Any other agent listening for this event will learn about failures to pay Lightning invoices.