@t402/btc 2.7.0

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/index.ts","../../src/constants.ts","../../src/utils.ts","../../src/exact/client/scheme.ts","../../src/exact/client/register.ts","../../src/lightning/client/scheme.ts","../../src/lightning/client/register.ts","../../src/exact/server/scheme.ts","../../src/exact/server/register.ts","../../src/exact/facilitator/scheme.ts","../../src/exact/facilitator/register.ts","../../src/lightning/server/scheme.ts","../../src/lightning/server/register.ts","../../src/lightning/facilitator/scheme.ts","../../src/lightning/facilitator/register.ts"],"sourcesContent":["/**\n * @module @t402/btc - t402 Payment Protocol Bitcoin & Lightning Network Implementation\n *\n * This module provides the Bitcoin-specific implementation of the t402 payment protocol.\n * Supports on-chain BTC payments (via PSBT) and Lightning Network payments (via BOLT11).\n *\n * Schemes:\n * - exact (on-chain): PSBT-based Bitcoin payments\n * - exact (lightning): BOLT11 invoice-based Lightning payments\n */\n\n// Export BTC exact scheme (client)\nexport { ExactBtcScheme } from './exact/index.js'\n\n// Export Lightning scheme (client)\nexport { LightningScheme } from './lightning/index.js'\n\n// Export register functions for easy integration\nexport { registerExactBtcScheme as registerExactBtcClientScheme } from './exact/client/index.js'\nexport type { BtcClientConfig } from './exact/client/index.js'\nexport { registerExactBtcScheme as registerExactBtcServerScheme } from './exact/server/index.js'\nexport type { BtcResourceServerConfig } from './exact/server/index.js'\nexport { registerExactBtcScheme as registerExactBtcFacilitatorScheme } from './exact/facilitator/index.js'\nexport type { BtcFacilitatorConfig } from './exact/facilitator/index.js'\n\nexport { registerLightningScheme as registerLightningClientScheme } from './lightning/client/index.js'\nexport type { LightningClientConfig } from './lightning/client/index.js'\nexport { registerLightningScheme as registerLightningServerScheme } from './lightning/server/index.js'\nexport type { LightningResourceServerConfig } from './lightning/server/index.js'\nexport { registerLightningScheme as registerLightningFacilitatorScheme } from './lightning/facilitator/index.js'\nexport type { LightningFacilitatorConfig } from './lightning/facilitator/index.js'\n\n// Export signer interfaces\nexport type { ClientBtcSigner, ClientLightningSigner } from './signer.js'\n\n// Export facilitator signer interfaces\nexport type { FacilitatorBtcSigner } from './exact/facilitator/scheme.js'\nexport type { FacilitatorLightningSigner } from './lightning/facilitator/scheme.js'\n\n// Export payload types\nexport type { BtcOnchainPayload, LightningPayload } from './types.js'\n\n// Export constants\nexport {\n  BTC_MAINNET,\n  BTC_TESTNET,\n  LIGHTNING_MAINNET,\n  LIGHTNING_TESTNET,\n  BTC_NETWORKS,\n  LIGHTNING_NETWORKS,\n  ALL_NETWORKS,\n  DUST_LIMIT,\n  MIN_RELAY_FEE,\n  SATS_PER_BTC,\n  SCHEME_EXACT,\n  DEFAULT_VALIDITY_DURATION,\n  MAINNET_ADDRESS_PREFIXES,\n  TESTNET_ADDRESS_PREFIXES,\n} from './constants.js'\n\nexport type { BtcNetwork, LightningNetwork } from './constants.js'\n\n// Export utility functions\nexport {\n  satoshisToBtc,\n  btcToSatoshis,\n  validateBitcoinAddress,\n  isMainnetAddress,\n  isTestnetAddress,\n  validateBolt11Invoice,\n  isValidHex,\n} from './utils.js'\n\n// Export server scheme types\nexport type { ExactBtcSchemeConfig } from './exact/server/scheme.js'\nexport type { LightningSchemeConfig, InvoiceGenerator } from './lightning/server/scheme.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 * 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","/**\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","/**\n * Bitcoin On-chain Server Scheme Implementation\n *\n * Handles price parsing and payment requirement enhancement for\n * Bitcoin on-chain payments using the exact scheme.\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 * Configuration options for ExactBtcScheme server\n */\nexport interface ExactBtcSchemeConfig {\n  /**\n   * The Bitcoin address to receive payments\n   */\n  payTo: string\n}\n\n/**\n * Bitcoin server implementation for the Exact payment scheme.\n * Handles price parsing and converts user-friendly amounts to satoshis.\n *\n * For Bitcoin, the asset is always \"BTC\" and amounts are in satoshis.\n */\nexport class ExactBtcScheme implements SchemeNetworkServer {\n  readonly scheme = SCHEME_EXACT\n  private moneyParsers: MoneyParser[] = []\n  private config: ExactBtcSchemeConfig\n\n  constructor(config: ExactBtcSchemeConfig) {\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): ExactBtcScheme {\n    this.moneyParsers.push(parser)\n    return this\n  }\n\n  /**\n   * Parses a price into an asset amount in satoshis.\n   *\n   * Accepts:\n   * - Number: treated as USD, converted to satoshis at a default rate\n   * - String with $: treated as USD\n   * - AssetAmount: returned directly\n   *\n   * For Bitcoin, amounts are always in satoshis and the asset is \"BTC\".\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: treat amount as satoshis directly\n    return this.defaultMoneyConversion(amount)\n  }\n\n  /**\n   * Build payment requirements for this scheme/network combination.\n   *\n   * @param paymentRequirements - Base payment requirements with amount/asset already set\n   * @param supportedKind - The supported kind from facilitator\n   * @param extensionKeys - Extensions supported by the facilitator\n   * @returns Enhanced payment requirements\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 supportedKind\n    void extensionKeys\n\n    return {\n      ...paymentRequirements,\n      payTo: paymentRequirements.payTo || this.config.payTo,\n      asset: paymentRequirements.asset || 'BTC',\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 satoshis.\n   * For direct satoshi amounts, the amount is used as-is.\n   */\n  private defaultMoneyConversion(amount: number): AssetAmount {\n    // Amount is treated as satoshis directly\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 { ExactBtcScheme, ExactBtcSchemeConfig } from './scheme.js'\n\n/**\n * Configuration options for registering BTC schemes to an t402ResourceServer\n */\nexport interface BtcResourceServerConfig {\n  /**\n   * Optional specific networks to register\n   * If not provided, registers wildcard support (bip122:*)\n   */\n  networks?: Network[]\n\n  /**\n   * Scheme configuration (payTo address, etc.)\n   */\n  schemeConfig: ExactBtcSchemeConfig\n}\n\n/**\n * Registers Bitcoin exact payment schemes to an t402ResourceServer instance.\n *\n * @param server - The t402ResourceServer instance to register schemes to\n * @param config - Configuration for BTC resource server registration\n * @returns The server instance for chaining\n */\nexport function registerExactBtcScheme(\n  server: t402ResourceServer,\n  config: BtcResourceServerConfig,\n): t402ResourceServer {\n  const scheme = new ExactBtcScheme(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('bip122:*', scheme)\n  }\n\n  return server\n}\n","/**\n * Bitcoin On-chain Facilitator Scheme Implementation\n *\n * Verifies and settles Bitcoin on-chain payments using the exact scheme.\n * Validates signed PSBTs and broadcasts transactions to the Bitcoin network.\n */\n\nimport type {\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkFacilitator,\n  SettleResponse,\n  VerifyResponse,\n} from '@t402/core/types'\nimport type { BtcOnchainPayload } from '../../types.js'\nimport { SCHEME_EXACT, DUST_LIMIT, BTC_NETWORKS } from '../../constants.js'\nimport { validateBitcoinAddress } from '../../utils.js'\n\n/**\n * Facilitator BTC signer interface for verify and settle operations\n */\nexport interface FacilitatorBtcSigner {\n  /**\n   * Get all addresses this facilitator can use\n   */\n  getAddresses(): readonly string[]\n\n  /**\n   * Verify a signed PSBT\n   * Checks that outputs match expected values and signatures are valid\n   *\n   * @param params - Verification parameters\n   * @returns Verification result\n   */\n  verifyPsbt(params: {\n    signedPsbt: string\n    expectedPayTo: string\n    expectedAmount: string\n  }): Promise<{\n    valid: boolean\n    reason?: string\n    payer?: string\n  }>\n\n  /**\n   * Finalize and broadcast a signed PSBT\n   *\n   * @param signedPsbt - Base64-encoded signed PSBT\n   * @returns Transaction ID\n   */\n  broadcastPsbt(signedPsbt: string): Promise<string>\n\n  /**\n   * Wait for a transaction to be confirmed\n   *\n   * @param txId - Transaction ID\n   * @param confirmations - Number of confirmations to wait for\n   * @returns Confirmation result\n   */\n  waitForConfirmation(\n    txId: string,\n    confirmations?: number,\n  ): Promise<{\n    confirmed: boolean\n    txId: string\n    blockHash?: string\n    confirmations: number\n  }>\n}\n\n/**\n * Bitcoin facilitator implementation for the Exact payment scheme.\n *\n * Verifies signed PSBTs and broadcasts transactions to settle payments.\n */\nexport class ExactBtcScheme implements SchemeNetworkFacilitator {\n  readonly scheme = SCHEME_EXACT\n  readonly caipFamily = 'bip122:*'\n\n  constructor(private readonly signer: FacilitatorBtcSigner) {}\n\n  /**\n   * Get mechanism-specific extra data for the supported kinds endpoint.\n   * Bitcoin on-chain has no extra data.\n   */\n  getExtra(_network: string): Record<string, unknown> | undefined {\n    return undefined\n  }\n\n  /**\n   * Get signer addresses used by this facilitator.\n   */\n  getSigners(_network: string): string[] {\n    return [...this.signer.getAddresses()]\n  }\n\n  /**\n   * Verifies a payment payload.\n   *\n   * Validates:\n   * 1. Scheme and network matching\n   * 2. PSBT structure and signatures\n   * 3. Output matches (payTo, amount)\n   * 4. Amount above dust limit\n   */\n  async verify(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n  ): Promise<VerifyResponse> {\n    const btcPayload = payload.payload as BtcOnchainPayload | undefined\n\n    // Validate payload structure\n    if (!btcPayload?.signedPsbt) {\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 BTC network\n    const validNetworks: readonly string[] = BTC_NETWORKS\n    if (!validNetworks.includes(requirements.network)) {\n      return {\n        isValid: false,\n        invalidReason: 'unsupported_network',\n        payer: undefined,\n      }\n    }\n\n    // Verify network matches\n    if (payload.accepted.network !== requirements.network) {\n      return {\n        isValid: false,\n        invalidReason: 'network_mismatch',\n        payer: undefined,\n      }\n    }\n\n    // Validate payTo address\n    if (!validateBitcoinAddress(requirements.payTo)) {\n      return {\n        isValid: false,\n        invalidReason: 'invalid_pay_to_address',\n        payer: undefined,\n      }\n    }\n\n    // Validate amount above dust limit\n    if (BigInt(requirements.amount) < BigInt(DUST_LIMIT)) {\n      return {\n        isValid: false,\n        invalidReason: 'amount_below_dust_limit',\n        payer: undefined,\n      }\n    }\n\n    // Verify the PSBT\n    try {\n      const result = await this.signer.verifyPsbt({\n        signedPsbt: btcPayload.signedPsbt,\n        expectedPayTo: requirements.payTo,\n        expectedAmount: requirements.amount,\n      })\n\n      if (!result.valid) {\n        return {\n          isValid: false,\n          invalidReason: result.reason || 'psbt_verification_failed',\n          payer: result.payer,\n        }\n      }\n\n      return {\n        isValid: true,\n        invalidReason: undefined,\n        payer: result.payer,\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : String(error)\n      return {\n        isValid: false,\n        invalidReason: `verification_error: ${errorMessage}`,\n        payer: undefined,\n      }\n    }\n  }\n\n  /**\n   * Settles a payment by finalizing and broadcasting the PSBT.\n   */\n  async settle(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n  ): Promise<SettleResponse> {\n    const btcPayload = payload.payload as BtcOnchainPayload | undefined\n\n    if (!btcPayload?.signedPsbt) {\n      return {\n        success: false,\n        network: payload.accepted.network,\n        transaction: '',\n        errorReason: 'invalid_payload_structure',\n        payer: undefined,\n      }\n    }\n\n    // Re-verify before settling\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: verifyResult.payer,\n      }\n    }\n\n    try {\n      // Broadcast the signed transaction\n      const txId = await this.signer.broadcastPsbt(btcPayload.signedPsbt)\n\n      // Wait for at least 1 confirmation\n      const confirmation = await this.signer.waitForConfirmation(txId, 1)\n\n      if (!confirmation.confirmed) {\n        return {\n          success: false,\n          errorReason: 'transaction_not_confirmed',\n          transaction: txId,\n          network: payload.accepted.network,\n          payer: verifyResult.payer,\n        }\n      }\n\n      return {\n        success: true,\n        transaction: txId,\n        network: payload.accepted.network,\n        payer: verifyResult.payer,\n      }\n    } catch (error) {\n      console.error('Failed to settle Bitcoin transaction:', error)\n      return {\n        success: false,\n        errorReason: 'transaction_failed',\n        transaction: '',\n        network: payload.accepted.network,\n        payer: verifyResult.payer,\n      }\n    }\n  }\n}\n","import { t402Facilitator } from '@t402/core/facilitator'\nimport { Network } from '@t402/core/types'\nimport { FacilitatorBtcSigner, ExactBtcScheme } from './scheme.js'\n\n/**\n * Configuration options for registering BTC schemes to an t402Facilitator\n */\nexport interface BtcFacilitatorConfig {\n  /**\n   * The Bitcoin signer for facilitator operations (verify and settle)\n   */\n  signer: FacilitatorBtcSigner\n\n  /**\n   * Networks to register (single network or array of networks)\n   * Examples: \"bip122:000000000019d6689c085ae165831e93\"\n   */\n  networks: Network | Network[]\n}\n\n/**\n * Registers Bitcoin exact payment schemes to an t402Facilitator instance.\n *\n * @param facilitator - The t402Facilitator instance to register schemes to\n * @param config - Configuration for BTC facilitator registration\n * @returns The facilitator instance for chaining\n */\nexport function registerExactBtcScheme(\n  facilitator: t402Facilitator,\n  config: BtcFacilitatorConfig,\n): t402Facilitator {\n  facilitator.register(config.networks, new ExactBtcScheme(config.signer))\n  return facilitator\n}\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","/**\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":";;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,2CAAAA;AAAA,EAAA,oCAAAA;AAAA,EAAA;AAAA,4CAAAC;AAAA,EAAA,qCAAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;;;ACUO,IAAM,cAAc;AACpB,IAAM,cAAc;AAKpB,IAAM,oBAAoB;AAC1B,IAAM,oBAAoB;AAK1B,IAAM,eAAe,CAAC,aAAa,WAAW;AAK9C,IAAM,qBAAqB,CAAC,mBAAmB,iBAAiB;AAKhE,IAAM,eAAe,CAAC,GAAG,cAAc,GAAG,kBAAkB;AAS5D,IAAM,aAAa;AAMnB,IAAM,gBAAgB;AAKtB,IAAM,eAAe;AAKrB,IAAM,eAAe;AAKrB,IAAM,4BAA4B;AAKlC,IAAM,2BAA2B,CAAC,OAAO,KAAK,GAAG;AACjD,IAAM,2BAA2B,CAAC,OAAO,KAAK,KAAK,GAAG;;;ACrDtD,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;;;AClGO,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;;;ACxCO,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;;;AChCO,IAAMC,kBAAN,MAAoD;AAAA,EAKzD,YAAY,QAA8B;AAJ1C,wBAAS,UAAS;AAClB,wBAAQ,gBAA8B,CAAC;AACvC,wBAAQ;AAGN,SAAK,SAAS;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,oBAAoB,QAAqC;AACvD,SAAK,aAAa,KAAK,MAAM;AAC7B,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,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;AAAA;AAAA;AAAA,EAUA,MAAM,2BACJ,qBACA,eAMA,eAC8B;AAC9B,SAAK;AACL,SAAK;AAEL,WAAO;AAAA,MACL,GAAG;AAAA,MACH,OAAO,oBAAoB,SAAS,KAAK,OAAO;AAAA,MAChD,OAAO,oBAAoB,SAAS;AAAA,IACtC;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;AAAA,EAMQ,uBAAuB,QAA6B;AAE1D,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;;;ACtIO,SAASC,wBACd,QACA,QACoB;AACpB,QAAM,SAAS,IAAIC,gBAAe,OAAO,YAAY;AAErD,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,SAAO;AACT;;;ACiCO,IAAMC,kBAAN,MAAyD;AAAA,EAI9D,YAA6B,QAA8B;AAA9B;AAH7B,wBAAS,UAAS;AAClB,wBAAS,cAAa;AAAA,EAEsC;AAAA;AAAA;AAAA;AAAA;AAAA,EAM5D,SAAS,UAAuD;AAC9D,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,UAA4B;AACrC,WAAO,CAAC,GAAG,KAAK,OAAO,aAAa,CAAC;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,OACJ,SACA,cACyB;AACzB,UAAM,aAAa,QAAQ;AAG3B,QAAI,CAAC,YAAY,YAAY;AAC3B,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,QAAI,QAAQ,SAAS,WAAW,gBAAgB,aAAa,WAAW,cAAc;AACpF,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,UAAM,gBAAmC;AACzC,QAAI,CAAC,cAAc,SAAS,aAAa,OAAO,GAAG;AACjD,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,QAAI,QAAQ,SAAS,YAAY,aAAa,SAAS;AACrD,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,QAAI,CAAC,uBAAuB,aAAa,KAAK,GAAG;AAC/C,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,QAAI,OAAO,aAAa,MAAM,IAAI,OAAO,UAAU,GAAG;AACpD,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,QAAI;AACF,YAAM,SAAS,MAAM,KAAK,OAAO,WAAW;AAAA,QAC1C,YAAY,WAAW;AAAA,QACvB,eAAe,aAAa;AAAA,QAC5B,gBAAgB,aAAa;AAAA,MAC/B,CAAC;AAED,UAAI,CAAC,OAAO,OAAO;AACjB,eAAO;AAAA,UACL,SAAS;AAAA,UACT,eAAe,OAAO,UAAU;AAAA,UAChC,OAAO,OAAO;AAAA,QAChB;AAAA,MACF;AAEA,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO,OAAO;AAAA,MAChB;AAAA,IACF,SAAS,OAAO;AACd,YAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC1E,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe,uBAAuB,YAAY;AAAA,QAClD,OAAO;AAAA,MACT;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OACJ,SACA,cACyB;AACzB,UAAM,aAAa,QAAQ;AAE3B,QAAI,CAAC,YAAY,YAAY;AAC3B,aAAO;AAAA,QACL,SAAS;AAAA,QACT,SAAS,QAAQ,SAAS;AAAA,QAC1B,aAAa;AAAA,QACb,aAAa;AAAA,QACb,OAAO;AAAA,MACT;AAAA,IACF;AAGA,UAAM,eAAe,MAAM,KAAK,OAAO,SAAS,YAAY;AAC5D,QAAI,CAAC,aAAa,SAAS;AACzB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,SAAS,QAAQ,SAAS;AAAA,QAC1B,aAAa;AAAA,QACb,aAAa,aAAa,iBAAiB;AAAA,QAC3C,OAAO,aAAa;AAAA,MACtB;AAAA,IACF;AAEA,QAAI;AAEF,YAAM,OAAO,MAAM,KAAK,OAAO,cAAc,WAAW,UAAU;AAGlE,YAAM,eAAe,MAAM,KAAK,OAAO,oBAAoB,MAAM,CAAC;AAElE,UAAI,CAAC,aAAa,WAAW;AAC3B,eAAO;AAAA,UACL,SAAS;AAAA,UACT,aAAa;AAAA,UACb,aAAa;AAAA,UACb,SAAS,QAAQ,SAAS;AAAA,UAC1B,OAAO,aAAa;AAAA,QACtB;AAAA,MACF;AAEA,aAAO;AAAA,QACL,SAAS;AAAA,QACT,aAAa;AAAA,QACb,SAAS,QAAQ,SAAS;AAAA,QAC1B,OAAO,aAAa;AAAA,MACtB;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,MAAM,yCAAyC,KAAK;AAC5D,aAAO;AAAA,QACL,SAAS;AAAA,QACT,aAAa;AAAA,QACb,aAAa;AAAA,QACb,SAAS,QAAQ,SAAS;AAAA,QAC1B,OAAO,aAAa;AAAA,MACtB;AAAA,IACF;AAAA,EACF;AACF;;;AC3OO,SAASC,wBACd,aACA,QACiB;AACjB,cAAY,SAAS,OAAO,UAAU,IAAIC,gBAAe,OAAO,MAAM,CAAC;AACvE,SAAO;AACT;;;ACWO,IAAMC,mBAAN,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,SAASC,yBACd,QACA,QACoB;AACpB,QAAM,SAAS,IAAIC,iBAAgB,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;;;ACIA,eAAe,UAAU,aAAsC;AAC7D,QAAM,QAAQ,IAAI,WAAW,YAAY,MAAM,SAAS,EAAG,IAAI,CAAC,SAAS,SAAS,MAAM,EAAE,CAAC,CAAC;AAC5F,QAAM,aAAa,MAAM,WAAW,OAAO,OAAO,OAAO,WAAW,KAAK;AACzE,QAAM,YAAY,IAAI,WAAW,UAAU;AAC3C,SAAO,MAAM,KAAK,SAAS,EACxB,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EAC1C,KAAK,EAAE;AACZ;AAQO,IAAMC,mBAAN,MAA0D;AAAA,EAI/D,YAA6B,QAAoC;AAApC;AAH7B,wBAAS,UAAS;AAClB,wBAAS,cAAa;AAAA,EAE4C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMlE,SAAS,UAAuD;AAC9D,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,UAA4B;AACrC,WAAO,CAAC,GAAG,KAAK,OAAO,aAAa,CAAC;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,OACJ,SACA,cACyB;AACzB,UAAM,YAAY,QAAQ;AAG1B,QAAI,CAAC,WAAW,eAAe,CAAC,WAAW,YAAY,CAAC,WAAW,eAAe;AAChF,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,QAAI,QAAQ,SAAS,WAAW,gBAAgB,aAAa,WAAW,cAAc;AACpF,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,UAAM,gBAAmC;AACzC,QAAI,CAAC,cAAc,SAAS,aAAa,OAAO,GAAG;AACjD,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,QAAI,CAAC,WAAW,UAAU,UAAU,EAAE,GAAG;AACvC,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,QAAI,CAAC,WAAW,UAAU,aAAa,EAAE,GAAG;AAC1C,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,QAAI;AACF,YAAM,eAAe,MAAM,UAAU,UAAU,QAAQ;AAEvD,UAAI,iBAAiB,UAAU,YAAY,YAAY,GAAG;AACxD,eAAO;AAAA,UACL,SAAS;AAAA,UACT,eAAe;AAAA,UACf,OAAO;AAAA,QACT;AAAA,MACF;AAAA,IACF,QAAQ;AACN,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,QAAI;AACF,YAAM,UAAU,MAAM,KAAK,OAAO,cAAc,UAAU,WAAW;AAErE,UAAI,CAAC,QAAQ,SAAS;AACpB,eAAO;AAAA,UACL,SAAS;AAAA,UACT,eAAe;AAAA,UACf,OAAO;AAAA,QACT;AAAA,MACF;AAGA,UAAI,QAAQ,cAAc,OAAO,QAAQ,UAAU,IAAI,OAAO,aAAa,MAAM,GAAG;AAClF,eAAO;AAAA,UACL,SAAS;AAAA,UACT,eAAe;AAAA,UACf,OAAO;AAAA,QACT;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AAEd,cAAQ,KAAK,iDAAiD,KAAK;AAAA,IACrE;AAEA,WAAO;AAAA,MACL,SAAS;AAAA,MACT,eAAe;AAAA,MACf,OAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,OACJ,SACA,cACyB;AACzB,UAAM,YAAY,QAAQ;AAE1B,QAAI,CAAC,WAAW,eAAe,CAAC,WAAW,UAAU;AACnD,aAAO;AAAA,QACL,SAAS;AAAA,QACT,SAAS,QAAQ,SAAS;AAAA,QAC1B,aAAa;AAAA,QACb,aAAa;AAAA,QACb,OAAO;AAAA,MACT;AAAA,IACF;AAGA,UAAM,eAAe,MAAM,KAAK,OAAO,SAAS,YAAY;AAC5D,QAAI,CAAC,aAAa,SAAS;AACzB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,SAAS,QAAQ,SAAS;AAAA,QAC1B,aAAa;AAAA,QACb,aAAa,aAAa,iBAAiB;AAAA,QAC3C,OAAO;AAAA,MACT;AAAA,IACF;AAGA,WAAO;AAAA,MACL,SAAS;AAAA,MACT,aAAa,UAAU;AAAA,MACvB,SAAS,QAAQ,SAAS;AAAA,MAC1B,OAAO;AAAA,IACT;AAAA,EACF;AACF;;;ACjNO,SAASC,yBACd,aACA,QACiB;AACjB,cAAY,SAAS,OAAO,UAAU,IAAIC,iBAAgB,OAAO,MAAM,CAAC;AACxE,SAAO;AACT;","names":["registerExactBtcScheme","registerLightningScheme","ExactBtcScheme","registerExactBtcScheme","ExactBtcScheme","ExactBtcScheme","registerExactBtcScheme","ExactBtcScheme","LightningScheme","registerLightningScheme","LightningScheme","LightningScheme","registerLightningScheme","LightningScheme"]}

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

@@ -0,0 +1,82 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload, Network } from '@t402/core/types';
+import { a as ClientLightningSigner } from '../../signer-B_Z4WGLa.js';
+import { PaymentPolicy, t402Client } from '@t402/core/client';
+
+/**
+ * Lightning Network Client Scheme Implementation
+ *
+ * Creates payment payloads for Lightning Network payments.
+ * Pays BOLT11 invoices and returns preimage as proof of payment.
+ */
+
+/**
+ * Lightning Network client implementation for the Exact payment scheme.
+ *
+ * Pays BOLT11 invoices using a Lightning node and returns the
+ * payment preimage as proof of payment.
+ *
+ * Note: The scheme is 'exact' because Lightning payments are always
+ * for the exact invoice amount.
+ */
+declare class LightningScheme implements SchemeNetworkClient {
+    private readonly signer;
+    readonly scheme = "exact";
+    /**
+     * Creates a new LightningScheme instance.
+     *
+     * @param signer - The Lightning signer for client operations
+     */
+    constructor(signer: ClientLightningSigner);
+    /**
+     * 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
+     */
+    createPaymentPayload(t402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, 't402Version' | 'payload'>>;
+}
+
+/**
+ * Configuration options for registering Lightning schemes to an t402Client
+ */
+interface LightningClientConfig {
+    /**
+     * The Lightning signer to use for paying invoices
+     */
+    signer: ClientLightningSigner;
+    /**
+     * Optional policies to apply to the client
+     */
+    policies?: PaymentPolicy[];
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (lightning:*)
+     */
+    networks?: Network[];
+}
+/**
+ * Registers Lightning payment schemes to an t402Client instance.
+ *
+ * @param client - The t402Client instance to register schemes to
+ * @param config - Configuration for Lightning client registration
+ * @returns The client instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerLightningScheme } from "@t402/btc/lightning/client";
+ * import { t402Client } from "@t402/core/client";
+ *
+ * const client = new t402Client();
+ * registerLightningScheme(client, {
+ *   signer: myLnSigner,
+ * });
+ * ```
+ */
+declare function registerLightningScheme(client: t402Client, config: LightningClientConfig): t402Client;
+
+export { type LightningClientConfig, LightningScheme, registerLightningScheme };

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

@@ -0,0 +1,114 @@
+"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/client/index.ts
+var client_exports = {};
+__export(client_exports, {
+  LightningScheme: () => LightningScheme,
+  registerLightningScheme: () => registerLightningScheme
+});
+module.exports = __toCommonJS(client_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 validateBolt11Invoice(invoice) {
+  if (!invoice || invoice.length < 20) {
+    return false;
+  }
+  const lower = invoice.toLowerCase();
+  return lower.startsWith("lnbc") || lower.startsWith("lntb") || lower.startsWith("lnbcrt");
+}
+
+// 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;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LightningScheme,
+  registerLightningScheme
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lightning/client/index.ts","../../../../src/constants.ts","../../../../src/utils.ts","../../../../src/lightning/client/scheme.ts","../../../../src/lightning/client/register.ts"],"sourcesContent":["export { LightningScheme } from './scheme.js'\nexport { registerLightningScheme } from './register.js'\nexport type { LightningClientConfig } 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 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":";;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACUO,IAAM,cAAc;AACpB,IAAM,cAAc;AAKpB,IAAM,oBAAoB;AAC1B,IAAM,oBAAoB;AAK1B,IAAM,eAAe,CAAC,aAAa,WAAW;AAK9C,IAAM,qBAAqB,CAAC,mBAAmB,iBAAiB;AAKhE,IAAM,eAAe,CAAC,GAAG,cAAc,GAAG,kBAAkB;AAyB5D,IAAM,eAAe;;;ACoCrB,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;;;AC9EO,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/cjs/lightning/facilitator/index.d.ts

@@ -0,0 +1,93 @@
+import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse, Network } from '@t402/core/types';
+import { t402Facilitator } from '@t402/core/facilitator';
+
+/**
+ * Lightning Network Facilitator Scheme Implementation
+ *
+ * Verifies Lightning Network payments using preimage verification.
+ * Lightning payments are atomic (settle-on-pay), so settlement is a no-op.
+ */
+
+/**
+ * Facilitator Lightning signer interface
+ */
+interface FacilitatorLightningSigner {
+    /**
+     * Get all node public keys this facilitator manages
+     */
+    getAddresses(): readonly string[];
+    /**
+     * Look up a payment by its payment hash
+     *
+     * @param paymentHash - Hex-encoded payment hash
+     * @returns Payment status
+     */
+    lookupPayment(paymentHash: string): Promise<{
+        settled: boolean;
+        amountSats?: string;
+        preimage?: string;
+    }>;
+}
+/**
+ * Lightning Network facilitator implementation for the Exact payment scheme.
+ *
+ * Verification is done by checking that SHA-256(preimage) === paymentHash.
+ * Lightning payments are atomic, so settle is a confirmation-only operation.
+ */
+declare class LightningScheme implements SchemeNetworkFacilitator {
+    private readonly signer;
+    readonly scheme = "exact";
+    readonly caipFamily = "lightning:*";
+    constructor(signer: FacilitatorLightningSigner);
+    /**
+     * Get mechanism-specific extra data for the supported kinds endpoint.
+     * Lightning has no extra data.
+     */
+    getExtra(_network: string): Record<string, unknown> | undefined;
+    /**
+     * Get signer addresses (node public keys) for this facilitator.
+     */
+    getSigners(_network: string): string[];
+    /**
+     * 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
+     */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    /**
+     * 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.
+     */
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+}
+
+/**
+ * Configuration options for registering Lightning schemes to an t402Facilitator
+ */
+interface LightningFacilitatorConfig {
+    /**
+     * The Lightning signer for facilitator operations
+     */
+    signer: FacilitatorLightningSigner;
+    /**
+     * Networks to register (single network or array of networks)
+     * Examples: "lightning:mainnet", ["lightning:mainnet", "lightning:testnet"]
+     */
+    networks: Network | Network[];
+}
+/**
+ * Registers Lightning payment schemes to an t402Facilitator instance.
+ *
+ * @param facilitator - The t402Facilitator instance to register schemes to
+ * @param config - Configuration for Lightning facilitator registration
+ * @returns The facilitator instance for chaining
+ */
+declare function registerLightningScheme(facilitator: t402Facilitator, config: LightningFacilitatorConfig): t402Facilitator;
+
+export { type FacilitatorLightningSigner, type LightningFacilitatorConfig, LightningScheme, registerLightningScheme };