Pay an Address from Lightning

​

How it works

​

Pay

import { PayThroughClient } from "@kaleidorg/swap-sdk/pay-through";

const pay = new PayThroughClient({ makerUrl: "https://maker.signet.kaleidoswap.com/v2" });

if (!(await pay.supportsIdempotency())) {
  throw new Error("This maker does not support safe retries of pay-through creation");
}

const request = { destination: recipientAddress, invoiceAmount: 100_000 };
const idempotencyKey = crypto.randomUUID();
// Persist request, key, and maker URL BEFORE sending.

const order = await pay.create(request, { idempotencyKey });
// Persist order (including swapAuth) privately.
if (order.expiresAt <= Math.floor(Date.now() / 1000)) throw new Error("Invoice expired");

// Show order.invoice, order.payoutAsset, and order.payoutAmount for approval.
// After the payer's wallet pays order.invoice:
const status = await pay.status(order.id);

​

What create checks

​

Idempotent creation and recovery

• Call supportsIdempotency() before the first create, against the same maker. Older makers can silently ignore the key, so a successful create does not prove support.
• To recover a lost response, call create again with the same request, key, maker URL, and credentials.
• On PAY_THROUGH_IDEMPOTENCY_IN_FLIGHT, retry the identical request and key with bounded backoff (a few attempts over one to two minutes).
• Never change the key while a timeout, 5xx, or in-flight outcome is unresolved, and never pay a second invoice to recover the first.

​

If something goes wrong

• The invoice expired unpaid: start a new payment intent with a new request and a new key.
• The payer paid but no payout appears: check pay.status(order.id). The hold settles only after the payout is broadcast; until then the payment can still be released.