Thunder Bridge

import {
  ThunderBridge,
  GatewayCheatError,
  UnverifiedRecipientError,
} from "thunder-bridge";

// Trustless by default. The SDK refuses anything it can't verify.
const tb = new ThunderBridge("https://thunder-bridge.agora.gripe");

try {
  const { id, bolt11, forwardingMode } = await tb.createDonation({
    destination: "you@your-wallet.com",
    amountSat: 21,
  });
} catch (e) {
  if (e instanceof UnverifiedRecipientError) {
    // recipient not verified, retry with allow: {...}
  } else if (e instanceof GatewayCheatError) {
    // gateway provably cheated
  }
}

import { ThunderBridge } from "thunder-bridge";

const tb = new ThunderBridge("https://thunder-bridge.agora.gripe");

const finalStatus = await tb.waitForFulfillment(donationId, {
  onStatusChange(status) {
    console.log("status:", status);
    // "invoice_created" -> "payment_received"
    //   -> "paying_out" -> "success"
  },
  timeoutMs: 600_000,
});

// On success the preimage is verified proof of payment.
if (finalStatus === "success") {
  const { preimage } = await tb.getDonation(donationId);
}

// app/api/webhook/route.ts (Next.js App Router)
import { parseWebhookRequest } from "thunder-bridge";

export async function POST(req: Request) {
  const payload = await parseWebhookRequest(
    req,
    process.env.WEBHOOK_SECRET!,
  );

  // returns null on a bad signature
  if (!payload) {
    return new Response("Bad signature", { status: 401 });
  }

  console.log(payload.event); // "donation.success"
  console.log(payload.donation.amount_received_sat);

  return new Response("OK");
}

import { invoiceToSvg } from "thunder-bridge";

// Works for a BOLT11 invoice or an LN address.
const svg = invoiceToSvg("you@your-wallet.com", {
  size: 220,
  color: "#1a1a2e",
});

document.body.innerHTML = svg;

import { detectDestinationType } from "thunder-bridge";

detectDestinationType("you@your-wallet.com");
// "lnAddress"

import { ThunderBridge } from "thunder-bridge";

const tb = new ThunderBridge("https://thunder-bridge.agora.gripe");

const fees = await tb.estimateFees(1000);

console.log(fees);

import { ThunderBridge } from "thunder-bridge";

const tb = new ThunderBridge("https://thunder-bridge.agora.gripe");

const trigger = await tb.createTrigger({
  priceSat: 21,
});

console.log(trigger.ln_address);
// "ln-XXXXX@thunder-bridge.agora.gripe"
console.log(trigger.hash);
// share this hash with streamTrigger

import { ThunderBridge } from "thunder-bridge";

const tb = new ThunderBridge("https://thunder-bridge.agora.gripe");

const stop = tb.streamTrigger(triggerHash, {
  onDonation(d) {
    console.log("+" + d.amount_sat + " sat");
  },
  onConnect: () => console.log("WS open"),
  onDisconnect: () => console.log("reconnecting"),
});

// later: stop the stream
// stop();