@t402/btc 2.7.0

package/dist/esm/chunk-YJYTK2QQ.mjs

@@ -0,0 +1,127 @@
+import {
+  SATS_PER_BTC,
+  SCHEME_EXACT,
+  __publicField
+} from "./chunk-YWZC2RR7.mjs";
+
+// src/exact/server/scheme.ts
+var ExactBtcScheme = 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.
+   *
+   * Accepts:
+   * - Number: treated as USD, converted to satoshis at a default rate
+   * - String with $: treated as USD
+   * - AssetAmount: returned directly
+   *
+   * For Bitcoin, amounts are always in satoshis and the asset is "BTC".
+   *
+   * @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 this scheme/network combination.
+   *
+   * @param paymentRequirements - Base payment requirements with amount/asset already set
+   * @param supportedKind - The supported kind from facilitator
+   * @param extensionKeys - Extensions supported by the facilitator
+   * @returns Enhanced payment requirements
+   */
+  async enhancePaymentRequirements(paymentRequirements, supportedKind, extensionKeys) {
+    void supportedKind;
+    void extensionKeys;
+    return {
+      ...paymentRequirements,
+      payTo: paymentRequirements.payTo || this.config.payTo,
+      asset: paymentRequirements.asset || "BTC"
+    };
+  }
+  /**
+   * 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 satoshis.
+   * For direct satoshi amounts, the amount is used as-is.
+   */
+  defaultMoneyConversion(amount) {
+    const sats = Math.floor(amount * SATS_PER_BTC);
+    return {
+      amount: sats.toString(),
+      asset: "BTC",
+      extra: {
+        symbol: "BTC",
+        decimals: 8
+      }
+    };
+  }
+};
+
+// src/exact/server/register.ts
+function registerExactBtcScheme(server, config) {
+  const scheme = new ExactBtcScheme(config.schemeConfig);
+  if (config.networks && config.networks.length > 0) {
+    config.networks.forEach((network) => {
+      server.register(network, scheme);
+    });
+  } else {
+    server.register("bip122:*", scheme);
+  }
+  return server;
+}
+
+export {
+  ExactBtcScheme,
+  registerExactBtcScheme
+};
+//# sourceMappingURL=chunk-YJYTK2QQ.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/exact/server/scheme.ts","../../src/exact/server/register.ts"],"sourcesContent":["/**\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"],"mappings":";;;;;;;AAiCO,IAAM,iBAAN,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,SAAS,uBACd,QACA,QACoB;AACpB,QAAM,SAAS,IAAI,eAAe,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;","names":[]}

package/dist/esm/chunk-YWZC2RR7.mjs

@@ -0,0 +1,38 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// 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 DUST_LIMIT = 546;
+var MIN_RELAY_FEE = 1e3;
+var SATS_PER_BTC = 1e8;
+var SCHEME_EXACT = "exact";
+var DEFAULT_VALIDITY_DURATION = 3600;
+var MAINNET_ADDRESS_PREFIXES = ["bc1", "1", "3"];
+var TESTNET_ADDRESS_PREFIXES = ["tb1", "m", "n", "2"];
+
+export {
+  __publicField,
+  BTC_MAINNET,
+  BTC_TESTNET,
+  LIGHTNING_MAINNET,
+  LIGHTNING_TESTNET,
+  BTC_NETWORKS,
+  LIGHTNING_NETWORKS,
+  ALL_NETWORKS,
+  DUST_LIMIT,
+  MIN_RELAY_FEE,
+  SATS_PER_BTC,
+  SCHEME_EXACT,
+  DEFAULT_VALIDITY_DURATION,
+  MAINNET_ADDRESS_PREFIXES,
+  TESTNET_ADDRESS_PREFIXES
+};
+//# sourceMappingURL=chunk-YWZC2RR7.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/constants.ts"],"sourcesContent":["/**\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"],"mappings":";;;;;AAUO,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;","names":[]}

package/dist/esm/chunk-ZOL5R3HZ.mjs

@@ -0,0 +1,177 @@
+import {
+  validateBitcoinAddress
+} from "./chunk-MX3PAUPJ.mjs";
+import {
+  BTC_NETWORKS,
+  DUST_LIMIT,
+  SCHEME_EXACT,
+  __publicField
+} from "./chunk-YWZC2RR7.mjs";
+
+// src/exact/facilitator/scheme.ts
+var ExactBtcScheme = class {
+  constructor(signer) {
+    this.signer = signer;
+    __publicField(this, "scheme", SCHEME_EXACT);
+    __publicField(this, "caipFamily", "bip122:*");
+  }
+  /**
+   * Get mechanism-specific extra data for the supported kinds endpoint.
+   * Bitcoin on-chain has no extra data.
+   */
+  getExtra(_network) {
+    return void 0;
+  }
+  /**
+   * Get signer addresses used by this facilitator.
+   */
+  getSigners(_network) {
+    return [...this.signer.getAddresses()];
+  }
+  /**
+   * Verifies a payment payload.
+   *
+   * Validates:
+   * 1. Scheme and network matching
+   * 2. PSBT structure and signatures
+   * 3. Output matches (payTo, amount)
+   * 4. Amount above dust limit
+   */
+  async verify(payload, requirements) {
+    const btcPayload = payload.payload;
+    if (!btcPayload?.signedPsbt) {
+      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 = BTC_NETWORKS;
+    if (!validNetworks.includes(requirements.network)) {
+      return {
+        isValid: false,
+        invalidReason: "unsupported_network",
+        payer: void 0
+      };
+    }
+    if (payload.accepted.network !== requirements.network) {
+      return {
+        isValid: false,
+        invalidReason: "network_mismatch",
+        payer: void 0
+      };
+    }
+    if (!validateBitcoinAddress(requirements.payTo)) {
+      return {
+        isValid: false,
+        invalidReason: "invalid_pay_to_address",
+        payer: void 0
+      };
+    }
+    if (BigInt(requirements.amount) < BigInt(DUST_LIMIT)) {
+      return {
+        isValid: false,
+        invalidReason: "amount_below_dust_limit",
+        payer: void 0
+      };
+    }
+    try {
+      const result = await this.signer.verifyPsbt({
+        signedPsbt: btcPayload.signedPsbt,
+        expectedPayTo: requirements.payTo,
+        expectedAmount: requirements.amount
+      });
+      if (!result.valid) {
+        return {
+          isValid: false,
+          invalidReason: result.reason || "psbt_verification_failed",
+          payer: result.payer
+        };
+      }
+      return {
+        isValid: true,
+        invalidReason: void 0,
+        payer: result.payer
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      return {
+        isValid: false,
+        invalidReason: `verification_error: ${errorMessage}`,
+        payer: void 0
+      };
+    }
+  }
+  /**
+   * Settles a payment by finalizing and broadcasting the PSBT.
+   */
+  async settle(payload, requirements) {
+    const btcPayload = payload.payload;
+    if (!btcPayload?.signedPsbt) {
+      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: verifyResult.payer
+      };
+    }
+    try {
+      const txId = await this.signer.broadcastPsbt(btcPayload.signedPsbt);
+      const confirmation = await this.signer.waitForConfirmation(txId, 1);
+      if (!confirmation.confirmed) {
+        return {
+          success: false,
+          errorReason: "transaction_not_confirmed",
+          transaction: txId,
+          network: payload.accepted.network,
+          payer: verifyResult.payer
+        };
+      }
+      return {
+        success: true,
+        transaction: txId,
+        network: payload.accepted.network,
+        payer: verifyResult.payer
+      };
+    } catch (error) {
+      console.error("Failed to settle Bitcoin transaction:", error);
+      return {
+        success: false,
+        errorReason: "transaction_failed",
+        transaction: "",
+        network: payload.accepted.network,
+        payer: verifyResult.payer
+      };
+    }
+  }
+};
+
+// src/exact/facilitator/register.ts
+function registerExactBtcScheme(facilitator, config) {
+  facilitator.register(config.networks, new ExactBtcScheme(config.signer));
+  return facilitator;
+}
+
+export {
+  ExactBtcScheme,
+  registerExactBtcScheme
+};
+//# sourceMappingURL=chunk-ZOL5R3HZ.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/exact/facilitator/scheme.ts","../../src/exact/facilitator/register.ts"],"sourcesContent":["/**\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"],"mappings":"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","names":[]}

package/dist/esm/exact/client/index.d.mts

@@ -0,0 +1,89 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload, Network } from '@t402/core/types';
+import { C as ClientBtcSigner } from '../../signer-B_Z4WGLa.mjs';
+import { PaymentPolicy, t402Client } from '@t402/core/client';
+
+/**
+ * Bitcoin On-chain Client Scheme Implementation
+ *
+ * Creates payment payloads for Bitcoin on-chain transfers using the exact scheme.
+ * Builds PSBTs (Partially Signed Bitcoin Transactions) and signs them with the client's wallet.
+ */
+
+/**
+ * Bitcoin client implementation for the Exact payment scheme.
+ *
+ * Creates signed PSBTs for on-chain Bitcoin payments that can be
+ * finalized and broadcast by a facilitator.
+ */
+declare class ExactBtcScheme implements SchemeNetworkClient {
+    private readonly signer;
+    readonly scheme = "exact";
+    /**
+     * Creates a new ExactBtcScheme instance.
+     *
+     * @param signer - The Bitcoin signer for client operations
+     */
+    constructor(signer: ClientBtcSigner);
+    /**
+     * 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
+     */
+    createPaymentPayload(t402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, '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
+     */
+    private buildUnsignedPsbt;
+}
+
+/**
+ * Configuration options for registering BTC schemes to an t402Client
+ */
+interface BtcClientConfig {
+    /**
+     * The Bitcoin signer to use for creating payment payloads
+     */
+    signer: ClientBtcSigner;
+    /**
+     * Optional policies to apply to the client
+     */
+    policies?: PaymentPolicy[];
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (bip122:*)
+     */
+    networks?: Network[];
+}
+/**
+ * Registers Bitcoin exact payment schemes to an t402Client instance.
+ *
+ * @param client - The t402Client instance to register schemes to
+ * @param config - Configuration for BTC client registration
+ * @returns The client instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerExactBtcScheme } from "@t402/btc/exact/client";
+ * import { t402Client } from "@t402/core/client";
+ *
+ * const client = new t402Client();
+ * registerExactBtcScheme(client, {
+ *   signer: myBtcSigner,
+ * });
+ * ```
+ */
+declare function registerExactBtcScheme(client: t402Client, config: BtcClientConfig): t402Client;
+
+export { type BtcClientConfig, ExactBtcScheme, registerExactBtcScheme };

package/dist/esm/exact/client/index.mjs

@@ -0,0 +1,11 @@
+import {
+  ExactBtcScheme,
+  registerExactBtcScheme
+} from "../../chunk-7IU3Z36R.mjs";
+import "../../chunk-MX3PAUPJ.mjs";
+import "../../chunk-YWZC2RR7.mjs";
+export {
+  ExactBtcScheme,
+  registerExactBtcScheme
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/exact/client/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/exact/facilitator/index.d.mts

@@ -0,0 +1,114 @@
+import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse, Network } from '@t402/core/types';
+import { t402Facilitator } from '@t402/core/facilitator';
+
+/**
+ * Bitcoin On-chain Facilitator Scheme Implementation
+ *
+ * Verifies and settles Bitcoin on-chain payments using the exact scheme.
+ * Validates signed PSBTs and broadcasts transactions to the Bitcoin network.
+ */
+
+/**
+ * Facilitator BTC signer interface for verify and settle operations
+ */
+interface FacilitatorBtcSigner {
+    /**
+     * Get all addresses this facilitator can use
+     */
+    getAddresses(): readonly string[];
+    /**
+     * Verify a signed PSBT
+     * Checks that outputs match expected values and signatures are valid
+     *
+     * @param params - Verification parameters
+     * @returns Verification result
+     */
+    verifyPsbt(params: {
+        signedPsbt: string;
+        expectedPayTo: string;
+        expectedAmount: string;
+    }): Promise<{
+        valid: boolean;
+        reason?: string;
+        payer?: string;
+    }>;
+    /**
+     * Finalize and broadcast a signed PSBT
+     *
+     * @param signedPsbt - Base64-encoded signed PSBT
+     * @returns Transaction ID
+     */
+    broadcastPsbt(signedPsbt: string): Promise<string>;
+    /**
+     * Wait for a transaction to be confirmed
+     *
+     * @param txId - Transaction ID
+     * @param confirmations - Number of confirmations to wait for
+     * @returns Confirmation result
+     */
+    waitForConfirmation(txId: string, confirmations?: number): Promise<{
+        confirmed: boolean;
+        txId: string;
+        blockHash?: string;
+        confirmations: number;
+    }>;
+}
+/**
+ * Bitcoin facilitator implementation for the Exact payment scheme.
+ *
+ * Verifies signed PSBTs and broadcasts transactions to settle payments.
+ */
+declare class ExactBtcScheme implements SchemeNetworkFacilitator {
+    private readonly signer;
+    readonly scheme = "exact";
+    readonly caipFamily = "bip122:*";
+    constructor(signer: FacilitatorBtcSigner);
+    /**
+     * Get mechanism-specific extra data for the supported kinds endpoint.
+     * Bitcoin on-chain has no extra data.
+     */
+    getExtra(_network: string): Record<string, unknown> | undefined;
+    /**
+     * Get signer addresses used by this facilitator.
+     */
+    getSigners(_network: string): string[];
+    /**
+     * Verifies a payment payload.
+     *
+     * Validates:
+     * 1. Scheme and network matching
+     * 2. PSBT structure and signatures
+     * 3. Output matches (payTo, amount)
+     * 4. Amount above dust limit
+     */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    /**
+     * Settles a payment by finalizing and broadcasting the PSBT.
+     */
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+}
+
+/**
+ * Configuration options for registering BTC schemes to an t402Facilitator
+ */
+interface BtcFacilitatorConfig {
+    /**
+     * The Bitcoin signer for facilitator operations (verify and settle)
+     */
+    signer: FacilitatorBtcSigner;
+    /**
+     * Networks to register (single network or array of networks)
+     * Examples: "bip122:000000000019d6689c085ae165831e93"
+     */
+    networks: Network | Network[];
+}
+/**
+ * Registers Bitcoin exact payment schemes to an t402Facilitator instance.
+ *
+ * @param facilitator - The t402Facilitator instance to register schemes to
+ * @param config - Configuration for BTC facilitator registration
+ * @returns The facilitator instance for chaining
+ */
+declare function registerExactBtcScheme(facilitator: t402Facilitator, config: BtcFacilitatorConfig): t402Facilitator;
+
+export { type BtcFacilitatorConfig, ExactBtcScheme, type FacilitatorBtcSigner, registerExactBtcScheme };

package/dist/esm/exact/facilitator/index.mjs

@@ -0,0 +1,11 @@
+import {
+  ExactBtcScheme,
+  registerExactBtcScheme
+} from "../../chunk-ZOL5R3HZ.mjs";
+import "../../chunk-MX3PAUPJ.mjs";
+import "../../chunk-YWZC2RR7.mjs";
+export {
+  ExactBtcScheme,
+  registerExactBtcScheme
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/exact/facilitator/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}