@t402/btc 2.7.0

package/dist/esm/chunk-2DEKJ7ER.mjs

@@ -0,0 +1,123 @@
+import {
+  SATS_PER_BTC,
+  SCHEME_EXACT,
+  __publicField
+} from "./chunk-YWZC2RR7.mjs";
+
+// 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;
+}
+
+export {
+  LightningScheme,
+  registerLightningScheme
+};
+//# sourceMappingURL=chunk-2DEKJ7ER.mjs.map

package/dist/esm/chunk-2DEKJ7ER.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lightning/server/scheme.ts","../../src/lightning/server/register.ts"],"sourcesContent":["/**\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":";;;;;;;AA4CO,IAAM,kBAAN,MAAqD;AAAA,EAK1D,YAAY,QAA+B;AAJ3C,wBAAS,UAAS;AAClB,wBAAQ,gBAA8B,CAAC;AACvC,wBAAQ;AAGN,SAAK,SAAS;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,oBAAoB,QAAsC;AACxD,SAAK,aAAa,KAAK,MAAM;AAC7B,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,WAAW,OAAc,SAAwC;AAErE,QAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,YAAY,OAAO;AACpE,UAAI,CAAC,MAAM,OAAO;AAChB,cAAM,IAAI,MAAM,sDAAsD,OAAO,EAAE;AAAA,MACjF;AACA,aAAO;AAAA,QACL,QAAQ,MAAM;AAAA,QACd,OAAO,MAAM;AAAA,QACb,OAAO,MAAM,SAAS,CAAC;AAAA,MACzB;AAAA,IACF;AAGA,UAAM,SAAS,KAAK,oBAAoB,KAAK;AAG7C,eAAW,UAAU,KAAK,cAAc;AACtC,YAAM,SAAS,MAAM,OAAO,QAAQ,OAAO;AAC3C,UAAI,WAAW,MAAM;AACnB,eAAO;AAAA,MACT;AAAA,IACF;AAGA,WAAO,KAAK,uBAAuB,MAAM;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,2BACJ,qBACA,eAMA,eAC8B;AAC9B,SAAK;AAEL,UAAM,QAAQ,EAAE,GAAG,oBAAoB,MAAM;AAG7C,UAAM,UAAU,MAAM,KAAK,OAAO;AAAA,MAChC,oBAAoB;AAAA,MACpB,mBAAmB,cAAc,OAAO;AAAA,MACxC,oBAAoB;AAAA,IACtB;AAEA,UAAM,gBAAgB,QAAQ;AAC9B,UAAM,cAAc,QAAQ;AAE5B,WAAO;AAAA,MACL,GAAG;AAAA,MACH,OAAO,oBAAoB,SAAS;AAAA,MACpC;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,oBAAoB,OAAgC;AAC1D,QAAI,OAAO,UAAU,UAAU;AAC7B,UAAI,CAAC,OAAO,SAAS,KAAK,GAAG;AAC3B,cAAM,IAAI,MAAM,wBAAwB,KAAK,EAAE;AAAA,MACjD;AACA,aAAO;AAAA,IACT;AAEA,UAAM,aAAa,MAAM,QAAQ,OAAO,EAAE,EAAE,KAAK;AACjD,UAAM,SAAS,WAAW,UAAU;AAEpC,QAAI,MAAM,MAAM,GAAG;AACjB,YAAM,IAAI,MAAM,yBAAyB,KAAK,EAAE;AAAA,IAClD;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKQ,uBAAuB,QAA6B;AAC1D,UAAM,OAAO,KAAK,MAAM,SAAS,YAAY;AAE7C,WAAO;AAAA,MACL,QAAQ,KAAK,SAAS;AAAA,MACtB,OAAO;AAAA,MACP,OAAO;AAAA,QACL,QAAQ;AAAA,QACR,UAAU;AAAA,MACZ;AAAA,IACF;AAAA,EACF;AACF;;;AChJO,SAAS,wBACd,QACA,QACoB;AACpB,QAAM,SAAS,IAAI,gBAAgB,OAAO,YAAY;AAEtD,MAAI,OAAO,YAAY,OAAO,SAAS,SAAS,GAAG;AACjD,WAAO,SAAS,QAAQ,CAAC,YAAY;AACnC,aAAO,SAAS,SAAS,MAAM;AAAA,IACjC,CAAC;AAAA,EACH,OAAO;AACL,WAAO,SAAS,eAAe,MAAM;AAAA,EACvC;AAEA,SAAO;AACT;","names":[]}

package/dist/esm/chunk-3IOPLDQH.mjs

@@ -0,0 +1,74 @@
+import {
+  validateBolt11Invoice
+} from "./chunk-MX3PAUPJ.mjs";
+import {
+  SCHEME_EXACT,
+  __publicField
+} from "./chunk-YWZC2RR7.mjs";
+
+// src/lightning/client/scheme.ts
+var LightningScheme = class {
+  /**
+   * Creates a new LightningScheme instance.
+   *
+   * @param signer - The Lightning signer for client operations
+   */
+  constructor(signer) {
+    this.signer = signer;
+    __publicField(this, "scheme", SCHEME_EXACT);
+  }
+  /**
+   * Creates a payment payload for the Lightning scheme.
+   *
+   * 1. Extracts the BOLT11 invoice from requirements.extra.bolt11Invoice
+   * 2. Pays the invoice using the Lightning signer
+   * 3. Returns the preimage and payment hash as proof of payment
+   *
+   * @param t402Version - The t402 protocol version
+   * @param paymentRequirements - The payment requirements
+   * @returns Promise resolving to a payment payload
+   */
+  async createPaymentPayload(t402Version, paymentRequirements) {
+    const bolt11Invoice = paymentRequirements.extra?.bolt11Invoice;
+    if (!bolt11Invoice) {
+      throw new Error("BOLT11 invoice is required in requirements.extra.bolt11Invoice");
+    }
+    if (!validateBolt11Invoice(bolt11Invoice)) {
+      throw new Error(`Invalid BOLT11 invoice format: ${bolt11Invoice.slice(0, 20)}...`);
+    }
+    const { preimage, paymentHash } = await this.signer.payInvoice(bolt11Invoice);
+    const payload = {
+      paymentHash,
+      preimage,
+      bolt11Invoice
+    };
+    return {
+      t402Version,
+      payload
+    };
+  }
+};
+
+// src/lightning/client/register.ts
+function registerLightningScheme(client, config) {
+  const scheme = new LightningScheme(config.signer);
+  if (config.networks && config.networks.length > 0) {
+    config.networks.forEach((network) => {
+      client.register(network, scheme);
+    });
+  } else {
+    client.register("lightning:*", scheme);
+  }
+  if (config.policies) {
+    config.policies.forEach((policy) => {
+      client.registerPolicy(policy);
+    });
+  }
+  return client;
+}
+
+export {
+  LightningScheme,
+  registerLightningScheme
+};
+//# sourceMappingURL=chunk-3IOPLDQH.mjs.map

package/dist/esm/chunk-3IOPLDQH.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lightning/client/scheme.ts","../../src/lightning/client/register.ts"],"sourcesContent":["/**\n * Lightning Network Client Scheme Implementation\n *\n * Creates payment payloads for Lightning Network payments.\n * Pays BOLT11 invoices and returns preimage as proof of payment.\n */\n\nimport type { PaymentPayload, PaymentRequirements, SchemeNetworkClient } from '@t402/core/types'\nimport type { ClientLightningSigner } from '../../signer.js'\nimport type { LightningPayload } from '../../types.js'\nimport { SCHEME_EXACT } from '../../constants.js'\nimport { validateBolt11Invoice } from '../../utils.js'\n\n/**\n * Lightning Network client implementation for the Exact payment scheme.\n *\n * Pays BOLT11 invoices using a Lightning node and returns the\n * payment preimage as proof of payment.\n *\n * Note: The scheme is 'exact' because Lightning payments are always\n * for the exact invoice amount.\n */\nexport class LightningScheme implements SchemeNetworkClient {\n  readonly scheme = SCHEME_EXACT\n\n  /**\n   * Creates a new LightningScheme instance.\n   *\n   * @param signer - The Lightning signer for client operations\n   */\n  constructor(private readonly signer: ClientLightningSigner) {}\n\n  /**\n   * Creates a payment payload for the Lightning scheme.\n   *\n   * 1. Extracts the BOLT11 invoice from requirements.extra.bolt11Invoice\n   * 2. Pays the invoice using the Lightning signer\n   * 3. Returns the preimage and payment hash as proof of payment\n   *\n   * @param t402Version - The t402 protocol version\n   * @param paymentRequirements - The payment requirements\n   * @returns Promise resolving to a payment payload\n   */\n  async createPaymentPayload(\n    t402Version: number,\n    paymentRequirements: PaymentRequirements,\n  ): Promise<Pick<PaymentPayload, 't402Version' | 'payload'>> {\n    // Extract BOLT11 invoice from requirements\n    const bolt11Invoice = paymentRequirements.extra?.bolt11Invoice as string | undefined\n\n    if (!bolt11Invoice) {\n      throw new Error('BOLT11 invoice is required in requirements.extra.bolt11Invoice')\n    }\n\n    // Validate invoice format\n    if (!validateBolt11Invoice(bolt11Invoice)) {\n      throw new Error(`Invalid BOLT11 invoice format: ${bolt11Invoice.slice(0, 20)}...`)\n    }\n\n    // Pay the invoice\n    const { preimage, paymentHash } = await this.signer.payInvoice(bolt11Invoice)\n\n    // Create payload with proof of payment\n    const payload: LightningPayload = {\n      paymentHash,\n      preimage,\n      bolt11Invoice,\n    }\n\n    return {\n      t402Version,\n      payload,\n    }\n  }\n}\n","import { t402Client, PaymentPolicy } from '@t402/core/client'\nimport { Network } from '@t402/core/types'\nimport { ClientLightningSigner } from '../../signer.js'\nimport { LightningScheme } from './scheme.js'\n\n/**\n * Configuration options for registering Lightning schemes to an t402Client\n */\nexport interface LightningClientConfig {\n  /**\n   * The Lightning signer to use for paying invoices\n   */\n  signer: ClientLightningSigner\n\n  /**\n   * Optional policies to apply to the client\n   */\n  policies?: PaymentPolicy[]\n\n  /**\n   * Optional specific networks to register\n   * If not provided, registers wildcard support (lightning:*)\n   */\n  networks?: Network[]\n}\n\n/**\n * Registers Lightning payment schemes to an t402Client instance.\n *\n * @param client - The t402Client instance to register schemes to\n * @param config - Configuration for Lightning client registration\n * @returns The client instance for chaining\n *\n * @example\n * ```typescript\n * import { registerLightningScheme } from \"@t402/btc/lightning/client\";\n * import { t402Client } from \"@t402/core/client\";\n *\n * const client = new t402Client();\n * registerLightningScheme(client, {\n *   signer: myLnSigner,\n * });\n * ```\n */\nexport function registerLightningScheme(\n  client: t402Client,\n  config: LightningClientConfig,\n): t402Client {\n  const scheme = new LightningScheme(config.signer)\n\n  if (config.networks && config.networks.length > 0) {\n    config.networks.forEach((network) => {\n      client.register(network, scheme)\n    })\n  } else {\n    client.register('lightning:*', scheme)\n  }\n\n  if (config.policies) {\n    config.policies.forEach((policy) => {\n      client.registerPolicy(policy)\n    })\n  }\n\n  return client\n}\n"],"mappings":";;;;;;;;;AAsBO,IAAM,kBAAN,MAAqD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ1D,YAA6B,QAA+B;AAA/B;AAP7B,wBAAS,UAAS;AAAA,EAO2C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAa7D,MAAM,qBACJ,aACA,qBAC0D;AAE1D,UAAM,gBAAgB,oBAAoB,OAAO;AAEjD,QAAI,CAAC,eAAe;AAClB,YAAM,IAAI,MAAM,gEAAgE;AAAA,IAClF;AAGA,QAAI,CAAC,sBAAsB,aAAa,GAAG;AACzC,YAAM,IAAI,MAAM,kCAAkC,cAAc,MAAM,GAAG,EAAE,CAAC,KAAK;AAAA,IACnF;AAGA,UAAM,EAAE,UAAU,YAAY,IAAI,MAAM,KAAK,OAAO,WAAW,aAAa;AAG5E,UAAM,UAA4B;AAAA,MAChC;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAEA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;;;AC9BO,SAAS,wBACd,QACA,QACY;AACZ,QAAM,SAAS,IAAI,gBAAgB,OAAO,MAAM;AAEhD,MAAI,OAAO,YAAY,OAAO,SAAS,SAAS,GAAG;AACjD,WAAO,SAAS,QAAQ,CAAC,YAAY;AACnC,aAAO,SAAS,SAAS,MAAM;AAAA,IACjC,CAAC;AAAA,EACH,OAAO;AACL,WAAO,SAAS,eAAe,MAAM;AAAA,EACvC;AAEA,MAAI,OAAO,UAAU;AACnB,WAAO,SAAS,QAAQ,CAAC,WAAW;AAClC,aAAO,eAAe,MAAM;AAAA,IAC9B,CAAC;AAAA,EACH;AAEA,SAAO;AACT;","names":[]}

package/dist/esm/chunk-7IU3Z36R.mjs

@@ -0,0 +1,103 @@
+import {
+  validateBitcoinAddress
+} from "./chunk-MX3PAUPJ.mjs";
+import {
+  DUST_LIMIT,
+  SCHEME_EXACT,
+  __publicField
+} from "./chunk-YWZC2RR7.mjs";
+
+// src/exact/client/scheme.ts
+var ExactBtcScheme = class {
+  /**
+   * Creates a new ExactBtcScheme instance.
+   *
+   * @param signer - The Bitcoin signer for client operations
+   */
+  constructor(signer) {
+    this.signer = signer;
+    __publicField(this, "scheme", SCHEME_EXACT);
+  }
+  /**
+   * Creates a payment payload for the Exact scheme.
+   *
+   * The payload contains a signed PSBT with a single output
+   * paying the required amount to the payTo address.
+   *
+   * @param t402Version - The t402 protocol version
+   * @param paymentRequirements - The payment requirements
+   * @returns Promise resolving to a payment payload
+   */
+  async createPaymentPayload(t402Version, paymentRequirements) {
+    if (!paymentRequirements.payTo) {
+      throw new Error("PayTo address is required");
+    }
+    if (!paymentRequirements.amount) {
+      throw new Error("Amount is required");
+    }
+    if (!validateBitcoinAddress(paymentRequirements.payTo)) {
+      throw new Error(`Invalid Bitcoin address: ${paymentRequirements.payTo}`);
+    }
+    const amountSats = BigInt(paymentRequirements.amount);
+    if (amountSats < BigInt(DUST_LIMIT)) {
+      throw new Error(`Amount ${amountSats} satoshis is below dust limit (${DUST_LIMIT})`);
+    }
+    const unsignedPsbt = this.buildUnsignedPsbt(paymentRequirements);
+    const signedPsbt = await this.signer.signPsbt(unsignedPsbt);
+    const payload = {
+      signedPsbt
+    };
+    return {
+      t402Version,
+      payload
+    };
+  }
+  /**
+   * Build an unsigned PSBT for the payment.
+   *
+   * Creates a minimal PSBT representation with the required output.
+   * The actual UTXO selection and fee calculation should be handled
+   * by the signer implementation (which typically has wallet context).
+   *
+   * @param requirements - Payment requirements
+   * @returns Base64-encoded unsigned PSBT
+   */
+  buildUnsignedPsbt(requirements) {
+    const psbtData = {
+      outputs: [
+        {
+          address: requirements.payTo,
+          value: requirements.amount
+        }
+      ],
+      network: requirements.network,
+      fromAddress: this.signer.getAddress(),
+      fromPubKey: this.signer.getPublicKey()
+    };
+    return Buffer.from(JSON.stringify(psbtData)).toString("base64");
+  }
+};
+
+// src/exact/client/register.ts
+function registerExactBtcScheme(client, config) {
+  const scheme = new ExactBtcScheme(config.signer);
+  if (config.networks && config.networks.length > 0) {
+    config.networks.forEach((network) => {
+      client.register(network, scheme);
+    });
+  } else {
+    client.register("bip122:*", scheme);
+  }
+  if (config.policies) {
+    config.policies.forEach((policy) => {
+      client.registerPolicy(policy);
+    });
+  }
+  return client;
+}
+
+export {
+  ExactBtcScheme,
+  registerExactBtcScheme
+};
+//# sourceMappingURL=chunk-7IU3Z36R.mjs.map

package/dist/esm/chunk-7IU3Z36R.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/exact/client/scheme.ts","../../src/exact/client/register.ts"],"sourcesContent":["/**\n * Bitcoin On-chain Client Scheme Implementation\n *\n * Creates payment payloads for Bitcoin on-chain transfers using the exact scheme.\n * Builds PSBTs (Partially Signed Bitcoin Transactions) and signs them with the client's wallet.\n */\n\nimport type { PaymentPayload, PaymentRequirements, SchemeNetworkClient } from '@t402/core/types'\nimport type { ClientBtcSigner } from '../../signer.js'\nimport type { BtcOnchainPayload } from '../../types.js'\nimport { SCHEME_EXACT, DUST_LIMIT } from '../../constants.js'\nimport { validateBitcoinAddress } from '../../utils.js'\n\n/**\n * Bitcoin client implementation for the Exact payment scheme.\n *\n * Creates signed PSBTs for on-chain Bitcoin payments that can be\n * finalized and broadcast by a facilitator.\n */\nexport class ExactBtcScheme implements SchemeNetworkClient {\n  readonly scheme = SCHEME_EXACT\n\n  /**\n   * Creates a new ExactBtcScheme instance.\n   *\n   * @param signer - The Bitcoin signer for client operations\n   */\n  constructor(private readonly signer: ClientBtcSigner) {}\n\n  /**\n   * Creates a payment payload for the Exact scheme.\n   *\n   * The payload contains a signed PSBT with a single output\n   * paying the required amount to the payTo address.\n   *\n   * @param t402Version - The t402 protocol version\n   * @param paymentRequirements - The payment requirements\n   * @returns Promise resolving to a payment payload\n   */\n  async createPaymentPayload(\n    t402Version: number,\n    paymentRequirements: PaymentRequirements,\n  ): Promise<Pick<PaymentPayload, 't402Version' | 'payload'>> {\n    // Validate required fields\n    if (!paymentRequirements.payTo) {\n      throw new Error('PayTo address is required')\n    }\n    if (!paymentRequirements.amount) {\n      throw new Error('Amount is required')\n    }\n\n    // Validate address format\n    if (!validateBitcoinAddress(paymentRequirements.payTo)) {\n      throw new Error(`Invalid Bitcoin address: ${paymentRequirements.payTo}`)\n    }\n\n    // Validate amount is above dust limit\n    const amountSats = BigInt(paymentRequirements.amount)\n    if (amountSats < BigInt(DUST_LIMIT)) {\n      throw new Error(`Amount ${amountSats} satoshis is below dust limit (${DUST_LIMIT})`)\n    }\n\n    // Build an unsigned PSBT\n    // The PSBT contains: output to payTo address for the required amount\n    // Input selection and fee calculation are handled by the signer\n    const unsignedPsbt = this.buildUnsignedPsbt(paymentRequirements)\n\n    // Sign the PSBT\n    const signedPsbt = await this.signer.signPsbt(unsignedPsbt)\n\n    // Create payload\n    const payload: BtcOnchainPayload = {\n      signedPsbt,\n    }\n\n    return {\n      t402Version,\n      payload,\n    }\n  }\n\n  /**\n   * Build an unsigned PSBT for the payment.\n   *\n   * Creates a minimal PSBT representation with the required output.\n   * The actual UTXO selection and fee calculation should be handled\n   * by the signer implementation (which typically has wallet context).\n   *\n   * @param requirements - Payment requirements\n   * @returns Base64-encoded unsigned PSBT\n   */\n  private buildUnsignedPsbt(requirements: PaymentRequirements): string {\n    // Encode payment details as a JSON payload in the PSBT\n    // The signer is responsible for building the full PSBT\n    // with proper UTXO selection and fee estimation\n    const psbtData = {\n      outputs: [\n        {\n          address: requirements.payTo,\n          value: requirements.amount,\n        },\n      ],\n      network: requirements.network,\n      fromAddress: this.signer.getAddress(),\n      fromPubKey: this.signer.getPublicKey(),\n    }\n\n    // Encode as base64 for transport\n    return Buffer.from(JSON.stringify(psbtData)).toString('base64')\n  }\n}\n","import { t402Client, PaymentPolicy } from '@t402/core/client'\nimport { Network } from '@t402/core/types'\nimport { ClientBtcSigner } from '../../signer.js'\nimport { ExactBtcScheme } from './scheme.js'\n\n/**\n * Configuration options for registering BTC schemes to an t402Client\n */\nexport interface BtcClientConfig {\n  /**\n   * The Bitcoin signer to use for creating payment payloads\n   */\n  signer: ClientBtcSigner\n\n  /**\n   * Optional policies to apply to the client\n   */\n  policies?: PaymentPolicy[]\n\n  /**\n   * Optional specific networks to register\n   * If not provided, registers wildcard support (bip122:*)\n   */\n  networks?: Network[]\n}\n\n/**\n * Registers Bitcoin exact payment schemes to an t402Client instance.\n *\n * @param client - The t402Client instance to register schemes to\n * @param config - Configuration for BTC client registration\n * @returns The client instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactBtcScheme } from \"@t402/btc/exact/client\";\n * import { t402Client } from \"@t402/core/client\";\n *\n * const client = new t402Client();\n * registerExactBtcScheme(client, {\n *   signer: myBtcSigner,\n * });\n * ```\n */\nexport function registerExactBtcScheme(client: t402Client, config: BtcClientConfig): t402Client {\n  const scheme = new ExactBtcScheme(config.signer)\n\n  if (config.networks && config.networks.length > 0) {\n    config.networks.forEach((network) => {\n      client.register(network, scheme)\n    })\n  } else {\n    client.register('bip122:*', scheme)\n  }\n\n  if (config.policies) {\n    config.policies.forEach((policy) => {\n      client.registerPolicy(policy)\n    })\n  }\n\n  return client\n}\n"],"mappings":";;;;;;;;;;AAmBO,IAAM,iBAAN,MAAoD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQzD,YAA6B,QAAyB;AAAzB;AAP7B,wBAAS,UAAS;AAAA,EAOqC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYvD,MAAM,qBACJ,aACA,qBAC0D;AAE1D,QAAI,CAAC,oBAAoB,OAAO;AAC9B,YAAM,IAAI,MAAM,2BAA2B;AAAA,IAC7C;AACA,QAAI,CAAC,oBAAoB,QAAQ;AAC/B,YAAM,IAAI,MAAM,oBAAoB;AAAA,IACtC;AAGA,QAAI,CAAC,uBAAuB,oBAAoB,KAAK,GAAG;AACtD,YAAM,IAAI,MAAM,4BAA4B,oBAAoB,KAAK,EAAE;AAAA,IACzE;AAGA,UAAM,aAAa,OAAO,oBAAoB,MAAM;AACpD,QAAI,aAAa,OAAO,UAAU,GAAG;AACnC,YAAM,IAAI,MAAM,UAAU,UAAU,kCAAkC,UAAU,GAAG;AAAA,IACrF;AAKA,UAAM,eAAe,KAAK,kBAAkB,mBAAmB;AAG/D,UAAM,aAAa,MAAM,KAAK,OAAO,SAAS,YAAY;AAG1D,UAAM,UAA6B;AAAA,MACjC;AAAA,IACF;AAEA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYQ,kBAAkB,cAA2C;AAInE,UAAM,WAAW;AAAA,MACf,SAAS;AAAA,QACP;AAAA,UACE,SAAS,aAAa;AAAA,UACtB,OAAO,aAAa;AAAA,QACtB;AAAA,MACF;AAAA,MACA,SAAS,aAAa;AAAA,MACtB,aAAa,KAAK,OAAO,WAAW;AAAA,MACpC,YAAY,KAAK,OAAO,aAAa;AAAA,IACvC;AAGA,WAAO,OAAO,KAAK,KAAK,UAAU,QAAQ,CAAC,EAAE,SAAS,QAAQ;AAAA,EAChE;AACF;;;AClEO,SAAS,uBAAuB,QAAoB,QAAqC;AAC9F,QAAM,SAAS,IAAI,eAAe,OAAO,MAAM;AAE/C,MAAI,OAAO,YAAY,OAAO,SAAS,SAAS,GAAG;AACjD,WAAO,SAAS,QAAQ,CAAC,YAAY;AACnC,aAAO,SAAS,SAAS,MAAM;AAAA,IACjC,CAAC;AAAA,EACH,OAAO;AACL,WAAO,SAAS,YAAY,MAAM;AAAA,EACpC;AAEA,MAAI,OAAO,UAAU;AACnB,WAAO,SAAS,QAAQ,CAAC,WAAW;AAClC,aAAO,eAAe,MAAM;AAAA,IAC9B,CAAC;AAAA,EACH;AAEA,SAAO;AACT;","names":[]}

package/dist/esm/chunk-HNFWDITA.mjs

@@ -0,0 +1,170 @@
+import {
+  isValidHex
+} from "./chunk-MX3PAUPJ.mjs";
+import {
+  LIGHTNING_NETWORKS,
+  SCHEME_EXACT,
+  __publicField
+} from "./chunk-YWZC2RR7.mjs";
+
+// 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;
+}
+
+export {
+  LightningScheme,
+  registerLightningScheme
+};
+//# sourceMappingURL=chunk-HNFWDITA.mjs.map

package/dist/esm/chunk-HNFWDITA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lightning/facilitator/scheme.ts","../../src/lightning/facilitator/register.ts"],"sourcesContent":["/**\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/esm/chunk-MX3PAUPJ.mjs

@@ -0,0 +1,65 @@
+import {
+  MAINNET_ADDRESS_PREFIXES,
+  SATS_PER_BTC,
+  TESTNET_ADDRESS_PREFIXES
+} from "./chunk-YWZC2RR7.mjs";
+
+// src/utils.ts
+function satoshisToBtc(sats) {
+  const satsBigInt = BigInt(sats);
+  const whole = satsBigInt / BigInt(SATS_PER_BTC);
+  const frac = satsBigInt % BigInt(SATS_PER_BTC);
+  if (frac === 0n) {
+    return whole.toString();
+  }
+  const fracStr = frac.toString().padStart(8, "0");
+  return `${whole}.${fracStr}`.replace(/\.?0+$/, "");
+}
+function btcToSatoshis(btc) {
+  const btcStr = typeof btc === "number" ? btc.toString() : btc;
+  const [wholePart, fracPart = ""] = btcStr.split(".");
+  const paddedFrac = fracPart.padEnd(8, "0").slice(0, 8);
+  const combined = wholePart + paddedFrac;
+  const result = BigInt(combined.replace(/^0+/, "") || "0");
+  return result;
+}
+function validateBitcoinAddress(address) {
+  if (!address || address.length < 14 || address.length > 90) {
+    return false;
+  }
+  const allPrefixes = [...MAINNET_ADDRESS_PREFIXES, ...TESTNET_ADDRESS_PREFIXES];
+  return allPrefixes.some((prefix) => address.startsWith(prefix));
+}
+function isMainnetAddress(address) {
+  return MAINNET_ADDRESS_PREFIXES.some((prefix) => address.startsWith(prefix));
+}
+function isTestnetAddress(address) {
+  return TESTNET_ADDRESS_PREFIXES.some((prefix) => address.startsWith(prefix));
+}
+function validateBolt11Invoice(invoice) {
+  if (!invoice || invoice.length < 20) {
+    return false;
+  }
+  const lower = invoice.toLowerCase();
+  return lower.startsWith("lnbc") || lower.startsWith("lntb") || lower.startsWith("lnbcrt");
+}
+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;
+}
+
+export {
+  satoshisToBtc,
+  btcToSatoshis,
+  validateBitcoinAddress,
+  isMainnetAddress,
+  isTestnetAddress,
+  validateBolt11Invoice,
+  isValidHex
+};
+//# sourceMappingURL=chunk-MX3PAUPJ.mjs.map

package/dist/esm/chunk-MX3PAUPJ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils.ts"],"sourcesContent":["/**\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"],"mappings":";;;;;;;AAeO,SAAS,cAAc,MAAwC;AACpE,QAAM,aAAa,OAAO,IAAI;AAC9B,QAAM,QAAQ,aAAa,OAAO,YAAY;AAC9C,QAAM,OAAO,aAAa,OAAO,YAAY;AAE7C,MAAI,SAAS,IAAI;AACf,WAAO,MAAM,SAAS;AAAA,EACxB;AAEA,QAAM,UAAU,KAAK,SAAS,EAAE,SAAS,GAAG,GAAG;AAC/C,SAAO,GAAG,KAAK,IAAI,OAAO,GAAG,QAAQ,UAAU,EAAE;AACnD;AAQO,SAAS,cAAc,KAA8B;AAC1D,QAAM,SAAS,OAAO,QAAQ,WAAW,IAAI,SAAS,IAAI;AAC1D,QAAM,CAAC,WAAW,WAAW,EAAE,IAAI,OAAO,MAAM,GAAG;AACnD,QAAM,aAAa,SAAS,OAAO,GAAG,GAAG,EAAE,MAAM,GAAG,CAAC;AACrD,QAAM,WAAW,YAAY;AAC7B,QAAM,SAAS,OAAO,SAAS,QAAQ,OAAO,EAAE,KAAK,GAAG;AACxD,SAAO;AACT;AAYO,SAAS,uBAAuB,SAA0B;AAC/D,MAAI,CAAC,WAAW,QAAQ,SAAS,MAAM,QAAQ,SAAS,IAAI;AAC1D,WAAO;AAAA,EACT;AAEA,QAAM,cAAc,CAAC,GAAG,0BAA0B,GAAG,wBAAwB;AAC7E,SAAO,YAAY,KAAK,CAAC,WAAW,QAAQ,WAAW,MAAM,CAAC;AAChE;AAQO,SAAS,iBAAiB,SAA0B;AACzD,SAAO,yBAAyB,KAAK,CAAC,WAAW,QAAQ,WAAW,MAAM,CAAC;AAC7E;AAQO,SAAS,iBAAiB,SAA0B;AACzD,SAAO,yBAAyB,KAAK,CAAC,WAAW,QAAQ,WAAW,MAAM,CAAC;AAC7E;AAaO,SAAS,sBAAsB,SAA0B;AAC9D,MAAI,CAAC,WAAW,QAAQ,SAAS,IAAI;AACnC,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,QAAQ,YAAY;AAClC,SAAO,MAAM,WAAW,MAAM,KAAK,MAAM,WAAW,MAAM,KAAK,MAAM,WAAW,QAAQ;AAC1F;AASO,SAAS,WAAW,KAAa,gBAAkC;AACxE,MAAI,CAAC,iBAAiB,KAAK,GAAG,GAAG;AAC/B,WAAO;AAAA,EACT;AACA,MAAI,mBAAmB,UAAa,IAAI,WAAW,iBAAiB,GAAG;AACrE,WAAO;AAAA,EACT;AACA,SAAO;AACT;","names":[]}