@t402/btc 2.7.0

package/dist/cjs/lightning/facilitator/index.js

@@ -0,0 +1,211 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/lightning/facilitator/index.ts
+var facilitator_exports = {};
+__export(facilitator_exports, {
+  LightningScheme: () => LightningScheme,
+  registerLightningScheme: () => registerLightningScheme
+});
+module.exports = __toCommonJS(facilitator_exports);
+
+// src/constants.ts
+var BTC_MAINNET = "bip122:000000000019d6689c085ae165831e93";
+var BTC_TESTNET = "bip122:000000000933ea01ad0ee984209779ba";
+var LIGHTNING_MAINNET = "lightning:mainnet";
+var LIGHTNING_TESTNET = "lightning:testnet";
+var BTC_NETWORKS = [BTC_MAINNET, BTC_TESTNET];
+var LIGHTNING_NETWORKS = [LIGHTNING_MAINNET, LIGHTNING_TESTNET];
+var ALL_NETWORKS = [...BTC_NETWORKS, ...LIGHTNING_NETWORKS];
+var SCHEME_EXACT = "exact";
+
+// src/utils.ts
+function isValidHex(hex, expectedLength) {
+  if (!/^[0-9a-fA-F]+$/.test(hex)) {
+    return false;
+  }
+  if (expectedLength !== void 0 && hex.length !== expectedLength * 2) {
+    return false;
+  }
+  return true;
+}
+
+// src/lightning/facilitator/scheme.ts
+async function sha256Hex(preimageHex) {
+  const bytes = new Uint8Array(preimageHex.match(/.{1,2}/g).map((byte) => parseInt(byte, 16)));
+  const hashBuffer = await globalThis.crypto.subtle.digest("SHA-256", bytes);
+  const hashArray = new Uint8Array(hashBuffer);
+  return Array.from(hashArray).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+var LightningScheme = class {
+  constructor(signer) {
+    this.signer = signer;
+    __publicField(this, "scheme", SCHEME_EXACT);
+    __publicField(this, "caipFamily", "lightning:*");
+  }
+  /**
+   * Get mechanism-specific extra data for the supported kinds endpoint.
+   * Lightning has no extra data.
+   */
+  getExtra(_network) {
+    return void 0;
+  }
+  /**
+   * Get signer addresses (node public keys) for this facilitator.
+   */
+  getSigners(_network) {
+    return [...this.signer.getAddresses()];
+  }
+  /**
+   * Verifies a Lightning payment payload.
+   *
+   * Validates:
+   * 1. Payload structure (paymentHash, preimage, bolt11Invoice)
+   * 2. Preimage verification: SHA-256(preimage) === paymentHash
+   * 3. Payment lookup on the Lightning node
+   */
+  async verify(payload, requirements) {
+    const lnPayload = payload.payload;
+    if (!lnPayload?.paymentHash || !lnPayload?.preimage || !lnPayload?.bolt11Invoice) {
+      return {
+        isValid: false,
+        invalidReason: "invalid_payload_structure",
+        payer: void 0
+      };
+    }
+    if (payload.accepted.scheme !== SCHEME_EXACT || requirements.scheme !== SCHEME_EXACT) {
+      return {
+        isValid: false,
+        invalidReason: "unsupported_scheme",
+        payer: void 0
+      };
+    }
+    const validNetworks = LIGHTNING_NETWORKS;
+    if (!validNetworks.includes(requirements.network)) {
+      return {
+        isValid: false,
+        invalidReason: "unsupported_network",
+        payer: void 0
+      };
+    }
+    if (!isValidHex(lnPayload.preimage, 32)) {
+      return {
+        isValid: false,
+        invalidReason: "invalid_preimage_format",
+        payer: void 0
+      };
+    }
+    if (!isValidHex(lnPayload.paymentHash, 32)) {
+      return {
+        isValid: false,
+        invalidReason: "invalid_payment_hash_format",
+        payer: void 0
+      };
+    }
+    try {
+      const computedHash = await sha256Hex(lnPayload.preimage);
+      if (computedHash !== lnPayload.paymentHash.toLowerCase()) {
+        return {
+          isValid: false,
+          invalidReason: "preimage_hash_mismatch",
+          payer: void 0
+        };
+      }
+    } catch {
+      return {
+        isValid: false,
+        invalidReason: "preimage_verification_failed",
+        payer: void 0
+      };
+    }
+    try {
+      const payment = await this.signer.lookupPayment(lnPayload.paymentHash);
+      if (!payment.settled) {
+        return {
+          isValid: false,
+          invalidReason: "payment_not_settled",
+          payer: void 0
+        };
+      }
+      if (payment.amountSats && BigInt(payment.amountSats) < BigInt(requirements.amount)) {
+        return {
+          isValid: false,
+          invalidReason: "insufficient_amount",
+          payer: void 0
+        };
+      }
+    } catch (error) {
+      console.warn("Could not verify payment with Lightning node:", error);
+    }
+    return {
+      isValid: true,
+      invalidReason: void 0,
+      payer: void 0
+    };
+  }
+  /**
+   * Settles a Lightning payment.
+   *
+   * Lightning payments are atomic (settle-on-pay), so this is effectively
+   * a confirmation that the payment was already completed. The actual
+   * settlement happened when the client paid the invoice.
+   */
+  async settle(payload, requirements) {
+    const lnPayload = payload.payload;
+    if (!lnPayload?.paymentHash || !lnPayload?.preimage) {
+      return {
+        success: false,
+        network: payload.accepted.network,
+        transaction: "",
+        errorReason: "invalid_payload_structure",
+        payer: void 0
+      };
+    }
+    const verifyResult = await this.verify(payload, requirements);
+    if (!verifyResult.isValid) {
+      return {
+        success: false,
+        network: payload.accepted.network,
+        transaction: "",
+        errorReason: verifyResult.invalidReason ?? "verification_failed",
+        payer: void 0
+      };
+    }
+    return {
+      success: true,
+      transaction: lnPayload.paymentHash,
+      network: payload.accepted.network,
+      payer: void 0
+    };
+  }
+};
+
+// src/lightning/facilitator/register.ts
+function registerLightningScheme(facilitator, config) {
+  facilitator.register(config.networks, new LightningScheme(config.signer));
+  return facilitator;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LightningScheme,
+  registerLightningScheme
+});
+//# sourceMappingURL=index.js.map

package/dist/cjs/lightning/facilitator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lightning/facilitator/index.ts","../../../../src/constants.ts","../../../../src/utils.ts","../../../../src/lightning/facilitator/scheme.ts","../../../../src/lightning/facilitator/register.ts"],"sourcesContent":["export { LightningScheme } from './scheme.js'\nexport type { FacilitatorLightningSigner } from './scheme.js'\nexport { registerLightningScheme } from './register.js'\nexport type { LightningFacilitatorConfig } from './register.js'\n","/**\n * Bitcoin & Lightning Network Constants\n *\n * CAIP-2 network identifiers, dust limits, and fee constants.\n */\n\n/**\n * CAIP-2 Network Identifiers for Bitcoin\n * Uses BIP-122 chain genesis block hashes\n */\nexport const BTC_MAINNET = 'bip122:000000000019d6689c085ae165831e93'\nexport const BTC_TESTNET = 'bip122:000000000933ea01ad0ee984209779ba'\n\n/**\n * CAIP-2 Network Identifiers for Lightning Network\n */\nexport const LIGHTNING_MAINNET = 'lightning:mainnet'\nexport const LIGHTNING_TESTNET = 'lightning:testnet'\n\n/**\n * All supported BTC on-chain networks\n */\nexport const BTC_NETWORKS = [BTC_MAINNET, BTC_TESTNET] as const\n\n/**\n * All supported Lightning networks\n */\nexport const LIGHTNING_NETWORKS = [LIGHTNING_MAINNET, LIGHTNING_TESTNET] as const\n\n/**\n * All supported networks (on-chain + Lightning)\n */\nexport const ALL_NETWORKS = [...BTC_NETWORKS, ...LIGHTNING_NETWORKS] as const\n\nexport type BtcNetwork = (typeof BTC_NETWORKS)[number]\nexport type LightningNetwork = (typeof LIGHTNING_NETWORKS)[number]\n\n/**\n * Dust limit in satoshis - minimum viable output value\n * Outputs below this threshold are rejected by Bitcoin nodes\n */\nexport const DUST_LIMIT = 546\n\n/**\n * Minimum relay fee in satoshis\n * Transactions with fees below this are not relayed by default\n */\nexport const MIN_RELAY_FEE = 1000\n\n/**\n * Satoshis per BTC\n */\nexport const SATS_PER_BTC = 100_000_000\n\n/**\n * Scheme identifiers\n */\nexport const SCHEME_EXACT = 'exact'\n\n/**\n * Default timeout for payment validity (in seconds)\n */\nexport const DEFAULT_VALIDITY_DURATION = 3600 // 1 hour\n\n/**\n * Bitcoin address prefixes for basic validation\n */\nexport const MAINNET_ADDRESS_PREFIXES = ['bc1', '1', '3']\nexport const TESTNET_ADDRESS_PREFIXES = ['tb1', 'm', 'n', '2']\n","/**\n * Bitcoin & Lightning Utility Functions\n *\n * Helper functions for address validation, unit conversion,\n * and invoice validation.\n */\n\nimport { SATS_PER_BTC, MAINNET_ADDRESS_PREFIXES, TESTNET_ADDRESS_PREFIXES } from './constants.js'\n\n/**\n * Convert satoshis to BTC\n *\n * @param sats - Amount in satoshis\n * @returns Amount in BTC as string (to avoid floating point issues)\n */\nexport function satoshisToBtc(sats: bigint | number | string): string {\n  const satsBigInt = BigInt(sats)\n  const whole = satsBigInt / BigInt(SATS_PER_BTC)\n  const frac = satsBigInt % BigInt(SATS_PER_BTC)\n\n  if (frac === 0n) {\n    return whole.toString()\n  }\n\n  const fracStr = frac.toString().padStart(8, '0')\n  return `${whole}.${fracStr}`.replace(/\\.?0+$/, '')\n}\n\n/**\n * Convert BTC to satoshis\n *\n * @param btc - Amount in BTC (string or number)\n * @returns Amount in satoshis as bigint\n */\nexport function btcToSatoshis(btc: string | number): bigint {\n  const btcStr = typeof btc === 'number' ? btc.toString() : btc\n  const [wholePart, fracPart = ''] = btcStr.split('.')\n  const paddedFrac = fracPart.padEnd(8, '0').slice(0, 8)\n  const combined = wholePart + paddedFrac\n  const result = BigInt(combined.replace(/^0+/, '') || '0')\n  return result\n}\n\n/**\n * Validate a Bitcoin address (basic format validation)\n *\n * Checks address prefix against known formats:\n * - Mainnet: bc1 (bech32), 1 (P2PKH), 3 (P2SH)\n * - Testnet: tb1 (bech32), m/n (P2PKH), 2 (P2SH)\n *\n * @param address - Bitcoin address to validate\n * @returns true if the address has a valid format\n */\nexport function validateBitcoinAddress(address: string): boolean {\n  if (!address || address.length < 14 || address.length > 90) {\n    return false\n  }\n\n  const allPrefixes = [...MAINNET_ADDRESS_PREFIXES, ...TESTNET_ADDRESS_PREFIXES]\n  return allPrefixes.some((prefix) => address.startsWith(prefix))\n}\n\n/**\n * Check if a Bitcoin address is for mainnet\n *\n * @param address - Bitcoin address\n * @returns true if mainnet address\n */\nexport function isMainnetAddress(address: string): boolean {\n  return MAINNET_ADDRESS_PREFIXES.some((prefix) => address.startsWith(prefix))\n}\n\n/**\n * Check if a Bitcoin address is for testnet\n *\n * @param address - Bitcoin address\n * @returns true if testnet address\n */\nexport function isTestnetAddress(address: string): boolean {\n  return TESTNET_ADDRESS_PREFIXES.some((prefix) => address.startsWith(prefix))\n}\n\n/**\n * Validate a BOLT11 Lightning invoice (basic format validation)\n *\n * BOLT11 invoices follow the format:\n * - lnbc... for mainnet\n * - lntb... for testnet\n * - lnbcrt... for regtest\n *\n * @param invoice - BOLT11 invoice string\n * @returns true if the invoice has a valid format\n */\nexport function validateBolt11Invoice(invoice: string): boolean {\n  if (!invoice || invoice.length < 20) {\n    return false\n  }\n\n  const lower = invoice.toLowerCase()\n  return lower.startsWith('lnbc') || lower.startsWith('lntb') || lower.startsWith('lnbcrt')\n}\n\n/**\n * Validate a hex-encoded string\n *\n * @param hex - String to validate\n * @param expectedLength - Expected byte length (hex length / 2)\n * @returns true if valid hex of expected length\n */\nexport function isValidHex(hex: string, expectedLength?: number): boolean {\n  if (!/^[0-9a-fA-F]+$/.test(hex)) {\n    return false\n  }\n  if (expectedLength !== undefined && hex.length !== expectedLength * 2) {\n    return false\n  }\n  return true\n}\n","/**\n * Lightning Network Facilitator Scheme Implementation\n *\n * Verifies Lightning Network payments using preimage verification.\n * Lightning payments are atomic (settle-on-pay), so settlement is a no-op.\n */\n\nimport type {\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkFacilitator,\n  SettleResponse,\n  VerifyResponse,\n} from '@t402/core/types'\nimport type { LightningPayload } from '../../types.js'\nimport { SCHEME_EXACT, LIGHTNING_NETWORKS } from '../../constants.js'\nimport { isValidHex } from '../../utils.js'\n\n/**\n * Facilitator Lightning signer interface\n */\nexport interface FacilitatorLightningSigner {\n  /**\n   * Get all node public keys this facilitator manages\n   */\n  getAddresses(): readonly string[]\n\n  /**\n   * Look up a payment by its payment hash\n   *\n   * @param paymentHash - Hex-encoded payment hash\n   * @returns Payment status\n   */\n  lookupPayment(paymentHash: string): Promise<{\n    settled: boolean\n    amountSats?: string\n    preimage?: string\n  }>\n}\n\n/**\n * Compute SHA-256 hash of a hex-encoded preimage\n *\n * @param preimageHex - Hex-encoded preimage\n * @returns Hex-encoded SHA-256 hash\n */\nasync function sha256Hex(preimageHex: string): Promise<string> {\n  const bytes = new Uint8Array(preimageHex.match(/.{1,2}/g)!.map((byte) => parseInt(byte, 16)))\n  const hashBuffer = await globalThis.crypto.subtle.digest('SHA-256', bytes)\n  const hashArray = new Uint8Array(hashBuffer)\n  return Array.from(hashArray)\n    .map((b) => b.toString(16).padStart(2, '0'))\n    .join('')\n}\n\n/**\n * Lightning Network facilitator implementation for the Exact payment scheme.\n *\n * Verification is done by checking that SHA-256(preimage) === paymentHash.\n * Lightning payments are atomic, so settle is a confirmation-only operation.\n */\nexport class LightningScheme implements SchemeNetworkFacilitator {\n  readonly scheme = SCHEME_EXACT\n  readonly caipFamily = 'lightning:*'\n\n  constructor(private readonly signer: FacilitatorLightningSigner) {}\n\n  /**\n   * Get mechanism-specific extra data for the supported kinds endpoint.\n   * Lightning has no extra data.\n   */\n  getExtra(_network: string): Record<string, unknown> | undefined {\n    return undefined\n  }\n\n  /**\n   * Get signer addresses (node public keys) for this facilitator.\n   */\n  getSigners(_network: string): string[] {\n    return [...this.signer.getAddresses()]\n  }\n\n  /**\n   * Verifies a Lightning payment payload.\n   *\n   * Validates:\n   * 1. Payload structure (paymentHash, preimage, bolt11Invoice)\n   * 2. Preimage verification: SHA-256(preimage) === paymentHash\n   * 3. Payment lookup on the Lightning node\n   */\n  async verify(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n  ): Promise<VerifyResponse> {\n    const lnPayload = payload.payload as LightningPayload | undefined\n\n    // Validate payload structure\n    if (!lnPayload?.paymentHash || !lnPayload?.preimage || !lnPayload?.bolt11Invoice) {\n      return {\n        isValid: false,\n        invalidReason: 'invalid_payload_structure',\n        payer: undefined,\n      }\n    }\n\n    // Verify scheme matches\n    if (payload.accepted.scheme !== SCHEME_EXACT || requirements.scheme !== SCHEME_EXACT) {\n      return {\n        isValid: false,\n        invalidReason: 'unsupported_scheme',\n        payer: undefined,\n      }\n    }\n\n    // Verify network is a valid Lightning network\n    const validNetworks: readonly string[] = LIGHTNING_NETWORKS\n    if (!validNetworks.includes(requirements.network)) {\n      return {\n        isValid: false,\n        invalidReason: 'unsupported_network',\n        payer: undefined,\n      }\n    }\n\n    // Validate preimage format (32 bytes hex)\n    if (!isValidHex(lnPayload.preimage, 32)) {\n      return {\n        isValid: false,\n        invalidReason: 'invalid_preimage_format',\n        payer: undefined,\n      }\n    }\n\n    // Validate payment hash format (32 bytes hex)\n    if (!isValidHex(lnPayload.paymentHash, 32)) {\n      return {\n        isValid: false,\n        invalidReason: 'invalid_payment_hash_format',\n        payer: undefined,\n      }\n    }\n\n    // Core verification: SHA-256(preimage) must equal paymentHash\n    try {\n      const computedHash = await sha256Hex(lnPayload.preimage)\n\n      if (computedHash !== lnPayload.paymentHash.toLowerCase()) {\n        return {\n          isValid: false,\n          invalidReason: 'preimage_hash_mismatch',\n          payer: undefined,\n        }\n      }\n    } catch {\n      return {\n        isValid: false,\n        invalidReason: 'preimage_verification_failed',\n        payer: undefined,\n      }\n    }\n\n    // Optionally verify with the Lightning node\n    try {\n      const payment = await this.signer.lookupPayment(lnPayload.paymentHash)\n\n      if (!payment.settled) {\n        return {\n          isValid: false,\n          invalidReason: 'payment_not_settled',\n          payer: undefined,\n        }\n      }\n\n      // Verify amount matches if available\n      if (payment.amountSats && BigInt(payment.amountSats) < BigInt(requirements.amount)) {\n        return {\n          isValid: false,\n          invalidReason: 'insufficient_amount',\n          payer: undefined,\n        }\n      }\n    } catch (error) {\n      // If we can't verify with the node, the preimage verification is sufficient\n      console.warn('Could not verify payment with Lightning node:', error)\n    }\n\n    return {\n      isValid: true,\n      invalidReason: undefined,\n      payer: undefined,\n    }\n  }\n\n  /**\n   * Settles a Lightning payment.\n   *\n   * Lightning payments are atomic (settle-on-pay), so this is effectively\n   * a confirmation that the payment was already completed. The actual\n   * settlement happened when the client paid the invoice.\n   */\n  async settle(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n  ): Promise<SettleResponse> {\n    const lnPayload = payload.payload as LightningPayload | undefined\n\n    if (!lnPayload?.paymentHash || !lnPayload?.preimage) {\n      return {\n        success: false,\n        network: payload.accepted.network,\n        transaction: '',\n        errorReason: 'invalid_payload_structure',\n        payer: undefined,\n      }\n    }\n\n    // Verify the payment\n    const verifyResult = await this.verify(payload, requirements)\n    if (!verifyResult.isValid) {\n      return {\n        success: false,\n        network: payload.accepted.network,\n        transaction: '',\n        errorReason: verifyResult.invalidReason ?? 'verification_failed',\n        payer: undefined,\n      }\n    }\n\n    // Lightning is settle-on-pay: the payment hash serves as the transaction ID\n    return {\n      success: true,\n      transaction: lnPayload.paymentHash,\n      network: payload.accepted.network,\n      payer: undefined,\n    }\n  }\n}\n","import { t402Facilitator } from '@t402/core/facilitator'\nimport { Network } from '@t402/core/types'\nimport { FacilitatorLightningSigner, LightningScheme } from './scheme.js'\n\n/**\n * Configuration options for registering Lightning schemes to an t402Facilitator\n */\nexport interface LightningFacilitatorConfig {\n  /**\n   * The Lightning signer for facilitator operations\n   */\n  signer: FacilitatorLightningSigner\n\n  /**\n   * Networks to register (single network or array of networks)\n   * Examples: \"lightning:mainnet\", [\"lightning:mainnet\", \"lightning:testnet\"]\n   */\n  networks: Network | Network[]\n}\n\n/**\n * Registers Lightning payment schemes to an t402Facilitator instance.\n *\n * @param facilitator - The t402Facilitator instance to register schemes to\n * @param config - Configuration for Lightning facilitator registration\n * @returns The facilitator instance for chaining\n */\nexport function registerLightningScheme(\n  facilitator: t402Facilitator,\n  config: LightningFacilitatorConfig,\n): t402Facilitator {\n  facilitator.register(config.networks, new LightningScheme(config.signer))\n  return facilitator\n}\n"],"mappings":"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","names":[]}

package/dist/cjs/lightning/server/index.d.ts

@@ -0,0 +1,96 @@
+import { SchemeNetworkServer, MoneyParser, Price, Network, AssetAmount, PaymentRequirements } from '@t402/core/types';
+import { t402ResourceServer } from '@t402/core/server';
+
+/**
+ * Lightning Network Server Scheme Implementation
+ *
+ * Handles price parsing and payment requirement enhancement for
+ * Lightning Network payments.
+ */
+
+/**
+ * Lightning invoice generator function
+ * Used to create BOLT11 invoices for payment requirements
+ */
+type InvoiceGenerator = (amountSats: string, description: string, expiry: number) => Promise<{
+    bolt11Invoice: string;
+    paymentHash: string;
+}>;
+/**
+ * Configuration options for Lightning server scheme
+ */
+interface LightningSchemeConfig {
+    /**
+     * Function to generate BOLT11 invoices
+     */
+    generateInvoice: InvoiceGenerator;
+}
+/**
+ * Lightning Network server implementation for the Exact payment scheme.
+ * Generates BOLT11 invoices and enhances payment requirements.
+ */
+declare class LightningScheme implements SchemeNetworkServer {
+    readonly scheme = "exact";
+    private moneyParsers;
+    private config;
+    constructor(config: LightningSchemeConfig);
+    /**
+     * Register a custom money parser in the parser chain.
+     *
+     * @param parser - Custom function to convert amount to AssetAmount (or null to skip)
+     * @returns The server instance for chaining
+     */
+    registerMoneyParser(parser: MoneyParser): LightningScheme;
+    /**
+     * Parses a price into an asset amount in satoshis.
+     *
+     * @param price - The price to parse
+     * @param network - The network to use
+     * @returns Promise that resolves to the parsed asset amount
+     */
+    parsePrice(price: Price, network: Network): Promise<AssetAmount>;
+    /**
+     * Build payment requirements for Lightning Network.
+     *
+     * Generates a BOLT11 invoice and adds it to the extra field.
+     */
+    enhancePaymentRequirements(paymentRequirements: PaymentRequirements, supportedKind: {
+        t402Version: number;
+        scheme: string;
+        network: Network;
+        extra?: Record<string, unknown>;
+    }, extensionKeys: string[]): Promise<PaymentRequirements>;
+    /**
+     * Parse Money (string | number) to a decimal number.
+     */
+    private parseMoneyToDecimal;
+    /**
+     * Default money conversion: treat amount as BTC, convert to satoshis.
+     */
+    private defaultMoneyConversion;
+}
+
+/**
+ * Configuration options for registering Lightning schemes to an t402ResourceServer
+ */
+interface LightningResourceServerConfig {
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (lightning:*)
+     */
+    networks?: Network[];
+    /**
+     * Scheme configuration (invoice generator, etc.)
+     */
+    schemeConfig: LightningSchemeConfig;
+}
+/**
+ * Registers Lightning payment schemes to an t402ResourceServer instance.
+ *
+ * @param server - The t402ResourceServer instance to register schemes to
+ * @param config - Configuration for Lightning resource server registration
+ * @returns The server instance for chaining
+ */
+declare function registerLightningScheme(server: t402ResourceServer, config: LightningResourceServerConfig): t402ResourceServer;
+
+export { type InvoiceGenerator, type LightningResourceServerConfig, LightningScheme, type LightningSchemeConfig, registerLightningScheme };

package/dist/cjs/lightning/server/index.js

@@ -0,0 +1,157 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/lightning/server/index.ts
+var server_exports = {};
+__export(server_exports, {
+  LightningScheme: () => LightningScheme,
+  registerLightningScheme: () => registerLightningScheme
+});
+module.exports = __toCommonJS(server_exports);
+
+// src/constants.ts
+var BTC_MAINNET = "bip122:000000000019d6689c085ae165831e93";
+var BTC_TESTNET = "bip122:000000000933ea01ad0ee984209779ba";
+var LIGHTNING_MAINNET = "lightning:mainnet";
+var LIGHTNING_TESTNET = "lightning:testnet";
+var BTC_NETWORKS = [BTC_MAINNET, BTC_TESTNET];
+var LIGHTNING_NETWORKS = [LIGHTNING_MAINNET, LIGHTNING_TESTNET];
+var ALL_NETWORKS = [...BTC_NETWORKS, ...LIGHTNING_NETWORKS];
+var SATS_PER_BTC = 1e8;
+var SCHEME_EXACT = "exact";
+
+// src/lightning/server/scheme.ts
+var LightningScheme = class {
+  constructor(config) {
+    __publicField(this, "scheme", SCHEME_EXACT);
+    __publicField(this, "moneyParsers", []);
+    __publicField(this, "config");
+    this.config = config;
+  }
+  /**
+   * Register a custom money parser in the parser chain.
+   *
+   * @param parser - Custom function to convert amount to AssetAmount (or null to skip)
+   * @returns The server instance for chaining
+   */
+  registerMoneyParser(parser) {
+    this.moneyParsers.push(parser);
+    return this;
+  }
+  /**
+   * Parses a price into an asset amount in satoshis.
+   *
+   * @param price - The price to parse
+   * @param network - The network to use
+   * @returns Promise that resolves to the parsed asset amount
+   */
+  async parsePrice(price, network) {
+    if (typeof price === "object" && price !== null && "amount" in price) {
+      if (!price.asset) {
+        throw new Error(`Asset must be specified for AssetAmount on network ${network}`);
+      }
+      return {
+        amount: price.amount,
+        asset: price.asset,
+        extra: price.extra || {}
+      };
+    }
+    const amount = this.parseMoneyToDecimal(price);
+    for (const parser of this.moneyParsers) {
+      const result = await parser(amount, network);
+      if (result !== null) {
+        return result;
+      }
+    }
+    return this.defaultMoneyConversion(amount);
+  }
+  /**
+   * Build payment requirements for Lightning Network.
+   *
+   * Generates a BOLT11 invoice and adds it to the extra field.
+   */
+  async enhancePaymentRequirements(paymentRequirements, supportedKind, extensionKeys) {
+    void extensionKeys;
+    const extra = { ...paymentRequirements.extra };
+    const invoice = await this.config.generateInvoice(
+      paymentRequirements.amount,
+      `t402 payment on ${supportedKind.network}`,
+      paymentRequirements.maxTimeoutSeconds
+    );
+    extra.bolt11Invoice = invoice.bolt11Invoice;
+    extra.paymentHash = invoice.paymentHash;
+    return {
+      ...paymentRequirements,
+      asset: paymentRequirements.asset || "BTC",
+      extra
+    };
+  }
+  /**
+   * Parse Money (string | number) to a decimal number.
+   */
+  parseMoneyToDecimal(money) {
+    if (typeof money === "number") {
+      if (!Number.isFinite(money)) {
+        throw new Error(`Invalid money value: ${money}`);
+      }
+      return money;
+    }
+    const cleanMoney = money.replace(/^\$/, "").trim();
+    const amount = parseFloat(cleanMoney);
+    if (isNaN(amount)) {
+      throw new Error(`Invalid money format: ${money}`);
+    }
+    return amount;
+  }
+  /**
+   * Default money conversion: treat amount as BTC, convert to satoshis.
+   */
+  defaultMoneyConversion(amount) {
+    const sats = Math.floor(amount * SATS_PER_BTC);
+    return {
+      amount: sats.toString(),
+      asset: "BTC",
+      extra: {
+        symbol: "BTC",
+        decimals: 8
+      }
+    };
+  }
+};
+
+// src/lightning/server/register.ts
+function registerLightningScheme(server, config) {
+  const scheme = new LightningScheme(config.schemeConfig);
+  if (config.networks && config.networks.length > 0) {
+    config.networks.forEach((network) => {
+      server.register(network, scheme);
+    });
+  } else {
+    server.register("lightning:*", scheme);
+  }
+  return server;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LightningScheme,
+  registerLightningScheme
+});
+//# sourceMappingURL=index.js.map

package/dist/cjs/lightning/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lightning/server/index.ts","../../../../src/constants.ts","../../../../src/lightning/server/scheme.ts","../../../../src/lightning/server/register.ts"],"sourcesContent":["export { LightningScheme } from './scheme.js'\nexport type { LightningSchemeConfig, InvoiceGenerator } from './scheme.js'\nexport { registerLightningScheme } from './register.js'\nexport type { LightningResourceServerConfig } from './register.js'\n","/**\n * Bitcoin & Lightning Network Constants\n *\n * CAIP-2 network identifiers, dust limits, and fee constants.\n */\n\n/**\n * CAIP-2 Network Identifiers for Bitcoin\n * Uses BIP-122 chain genesis block hashes\n */\nexport const BTC_MAINNET = 'bip122:000000000019d6689c085ae165831e93'\nexport const BTC_TESTNET = 'bip122:000000000933ea01ad0ee984209779ba'\n\n/**\n * CAIP-2 Network Identifiers for Lightning Network\n */\nexport const LIGHTNING_MAINNET = 'lightning:mainnet'\nexport const LIGHTNING_TESTNET = 'lightning:testnet'\n\n/**\n * All supported BTC on-chain networks\n */\nexport const BTC_NETWORKS = [BTC_MAINNET, BTC_TESTNET] as const\n\n/**\n * All supported Lightning networks\n */\nexport const LIGHTNING_NETWORKS = [LIGHTNING_MAINNET, LIGHTNING_TESTNET] as const\n\n/**\n * All supported networks (on-chain + Lightning)\n */\nexport const ALL_NETWORKS = [...BTC_NETWORKS, ...LIGHTNING_NETWORKS] as const\n\nexport type BtcNetwork = (typeof BTC_NETWORKS)[number]\nexport type LightningNetwork = (typeof LIGHTNING_NETWORKS)[number]\n\n/**\n * Dust limit in satoshis - minimum viable output value\n * Outputs below this threshold are rejected by Bitcoin nodes\n */\nexport const DUST_LIMIT = 546\n\n/**\n * Minimum relay fee in satoshis\n * Transactions with fees below this are not relayed by default\n */\nexport const MIN_RELAY_FEE = 1000\n\n/**\n * Satoshis per BTC\n */\nexport const SATS_PER_BTC = 100_000_000\n\n/**\n * Scheme identifiers\n */\nexport const SCHEME_EXACT = 'exact'\n\n/**\n * Default timeout for payment validity (in seconds)\n */\nexport const DEFAULT_VALIDITY_DURATION = 3600 // 1 hour\n\n/**\n * Bitcoin address prefixes for basic validation\n */\nexport const MAINNET_ADDRESS_PREFIXES = ['bc1', '1', '3']\nexport const TESTNET_ADDRESS_PREFIXES = ['tb1', 'm', 'n', '2']\n","/**\n * Lightning Network Server Scheme Implementation\n *\n * Handles price parsing and payment requirement enhancement for\n * Lightning Network payments.\n */\n\nimport type {\n  AssetAmount,\n  Network,\n  PaymentRequirements,\n  Price,\n  SchemeNetworkServer,\n  MoneyParser,\n} from '@t402/core/types'\nimport { SCHEME_EXACT, SATS_PER_BTC } from '../../constants.js'\n\n/**\n * Lightning invoice generator function\n * Used to create BOLT11 invoices for payment requirements\n */\nexport type InvoiceGenerator = (\n  amountSats: string,\n  description: string,\n  expiry: number,\n) => Promise<{\n  bolt11Invoice: string\n  paymentHash: string\n}>\n\n/**\n * Configuration options for Lightning server scheme\n */\nexport interface LightningSchemeConfig {\n  /**\n   * Function to generate BOLT11 invoices\n   */\n  generateInvoice: InvoiceGenerator\n}\n\n/**\n * Lightning Network server implementation for the Exact payment scheme.\n * Generates BOLT11 invoices and enhances payment requirements.\n */\nexport class LightningScheme implements SchemeNetworkServer {\n  readonly scheme = SCHEME_EXACT\n  private moneyParsers: MoneyParser[] = []\n  private config: LightningSchemeConfig\n\n  constructor(config: LightningSchemeConfig) {\n    this.config = config\n  }\n\n  /**\n   * Register a custom money parser in the parser chain.\n   *\n   * @param parser - Custom function to convert amount to AssetAmount (or null to skip)\n   * @returns The server instance for chaining\n   */\n  registerMoneyParser(parser: MoneyParser): LightningScheme {\n    this.moneyParsers.push(parser)\n    return this\n  }\n\n  /**\n   * Parses a price into an asset amount in satoshis.\n   *\n   * @param price - The price to parse\n   * @param network - The network to use\n   * @returns Promise that resolves to the parsed asset amount\n   */\n  async parsePrice(price: Price, network: Network): Promise<AssetAmount> {\n    // If already an AssetAmount, return it directly\n    if (typeof price === 'object' && price !== null && 'amount' in price) {\n      if (!price.asset) {\n        throw new Error(`Asset must be specified for AssetAmount on network ${network}`)\n      }\n      return {\n        amount: price.amount,\n        asset: price.asset,\n        extra: price.extra || {},\n      }\n    }\n\n    // Parse Money to decimal number\n    const amount = this.parseMoneyToDecimal(price)\n\n    // Try each custom money parser in order\n    for (const parser of this.moneyParsers) {\n      const result = await parser(amount, network)\n      if (result !== null) {\n        return result\n      }\n    }\n\n    // Default: convert to satoshis\n    return this.defaultMoneyConversion(amount)\n  }\n\n  /**\n   * Build payment requirements for Lightning Network.\n   *\n   * Generates a BOLT11 invoice and adds it to the extra field.\n   */\n  async enhancePaymentRequirements(\n    paymentRequirements: PaymentRequirements,\n    supportedKind: {\n      t402Version: number\n      scheme: string\n      network: Network\n      extra?: Record<string, unknown>\n    },\n    extensionKeys: string[],\n  ): Promise<PaymentRequirements> {\n    void extensionKeys\n\n    const extra = { ...paymentRequirements.extra }\n\n    // Generate a BOLT11 invoice for the payment\n    const invoice = await this.config.generateInvoice(\n      paymentRequirements.amount,\n      `t402 payment on ${supportedKind.network}`,\n      paymentRequirements.maxTimeoutSeconds,\n    )\n\n    extra.bolt11Invoice = invoice.bolt11Invoice\n    extra.paymentHash = invoice.paymentHash\n\n    return {\n      ...paymentRequirements,\n      asset: paymentRequirements.asset || 'BTC',\n      extra,\n    }\n  }\n\n  /**\n   * Parse Money (string | number) to a decimal number.\n   */\n  private parseMoneyToDecimal(money: string | number): number {\n    if (typeof money === 'number') {\n      if (!Number.isFinite(money)) {\n        throw new Error(`Invalid money value: ${money}`)\n      }\n      return money\n    }\n\n    const cleanMoney = money.replace(/^\\$/, '').trim()\n    const amount = parseFloat(cleanMoney)\n\n    if (isNaN(amount)) {\n      throw new Error(`Invalid money format: ${money}`)\n    }\n\n    return amount\n  }\n\n  /**\n   * Default money conversion: treat amount as BTC, convert to satoshis.\n   */\n  private defaultMoneyConversion(amount: number): AssetAmount {\n    const sats = Math.floor(amount * SATS_PER_BTC)\n\n    return {\n      amount: sats.toString(),\n      asset: 'BTC',\n      extra: {\n        symbol: 'BTC',\n        decimals: 8,\n      },\n    }\n  }\n}\n","import { t402ResourceServer } from '@t402/core/server'\nimport { Network } from '@t402/core/types'\nimport { LightningScheme, LightningSchemeConfig } from './scheme.js'\n\n/**\n * Configuration options for registering Lightning schemes to an t402ResourceServer\n */\nexport interface LightningResourceServerConfig {\n  /**\n   * Optional specific networks to register\n   * If not provided, registers wildcard support (lightning:*)\n   */\n  networks?: Network[]\n\n  /**\n   * Scheme configuration (invoice generator, etc.)\n   */\n  schemeConfig: LightningSchemeConfig\n}\n\n/**\n * Registers Lightning payment schemes to an t402ResourceServer instance.\n *\n * @param server - The t402ResourceServer instance to register schemes to\n * @param config - Configuration for Lightning resource server registration\n * @returns The server instance for chaining\n */\nexport function registerLightningScheme(\n  server: t402ResourceServer,\n  config: LightningResourceServerConfig,\n): t402ResourceServer {\n  const scheme = new LightningScheme(config.schemeConfig)\n\n  if (config.networks && config.networks.length > 0) {\n    config.networks.forEach((network) => {\n      server.register(network, scheme)\n    })\n  } else {\n    server.register('lightning:*', scheme)\n  }\n\n  return server\n}\n"],"mappings":"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","names":[]}

package/dist/cjs/signer-B_Z4WGLa.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Bitcoin & Lightning Signer Interfaces
+ *
+ * Defines the signer interfaces for t402 client operations.
+ * These interfaces abstract the signing implementation,
+ * allowing integration with various Bitcoin wallets and Lightning nodes.
+ */
+/**
+ * ClientBtcSigner - Used by t402 clients to sign Bitcoin transactions
+ *
+ * Implementations may include:
+ * - bitcoinjs-lib with private key
+ * - Hardware wallet (Ledger, Trezor)
+ * - Browser extension wallet
+ */
+interface ClientBtcSigner {
+    /**
+     * Sign a PSBT (Partially Signed Bitcoin Transaction)
+     *
+     * @param psbt - Base64-encoded unsigned PSBT
+     * @returns Base64-encoded signed PSBT
+     */
+    signPsbt(psbt: string): Promise<string>;
+    /**
+     * Get the signer's Bitcoin address
+     *
+     * @returns Bitcoin address string
+     */
+    getAddress(): string;
+    /**
+     * Get the signer's public key (hex-encoded)
+     *
+     * @returns Public key as hex string
+     */
+    getPublicKey(): string;
+}
+/**
+ * ClientLightningSigner - Used by t402 clients to pay Lightning invoices
+ *
+ * Implementations may include:
+ * - LND node client
+ * - CLN (Core Lightning) client
+ * - WebLN browser extension
+ */
+interface ClientLightningSigner {
+    /**
+     * Pay a BOLT11 Lightning invoice
+     *
+     * @param bolt11 - BOLT11 invoice string
+     * @returns Payment result with preimage and payment hash
+     */
+    payInvoice(bolt11: string): Promise<{
+        preimage: string;
+        paymentHash: string;
+    }>;
+    /**
+     * Get the Lightning node's public key
+     *
+     * @returns Node public key as hex string
+     */
+    getNodePubKey(): string;
+}
+
+export type { ClientBtcSigner as C, ClientLightningSigner as a };