Inbound Transaction Error

This event is used to communicate errors encountered when trying to "mint" new tokens from the outside world into the Ledger module's attention.

Event Signature

An Inbound Transaction Error event has the following form:

{
  "id": "{eventId}",
  "pubkey": "{ledgerPubkey}",
  "created_at": timestamp,
  "kind": 1112,
  "tags": [
    ["p", "{minterPubkey}"],
    ["p", "{minterPubkey}"],
    ["e", "{inboundTransactionEventId}"],
    ["t", "inbound-transaction-error"],
    ...,
  ],
  "content": "{inboundTransactionErrorContent}",
  "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 inbound-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 InboundTransactionErrorContent = {
    messages: [string],
};

Emitters

This event is emitted by:

• The Ledger module, when an inbound 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 process paid Lightning invoices.