@happyvertical/payments 0.80.0 → 0.80.1

package/dist/adapters/btc.js

@@ -1,843 +1,518 @@
+import { r as PaymentProviderError, t as PaymentConfigurationError } from "../chunks/errors-feZrwnTy.js";
+import { _ as normalizeUrlString, b as rememberPaymentOption, c as normalizeAmount, d as normalizeFutureDate, f as normalizeMaxStoredPaymentOptions, g as normalizePositivePaymentAmount, h as normalizePositiveMinorUnitAmount, i as decimalToMinorUnitAmount, m as normalizeNonEmptyString, n as currencyMinorUnitDecimals, o as getFetch, p as normalizeMinorUnitAmount, s as minorUnitsToDecimal, t as applyExpiryToPendingStatus, u as normalizeDate, v as pollPaymentStatus, y as readJsonResponse } from "../chunks/shared-DVl6UzD9.js";
 import { createHmac, timingSafeEqual } from "node:crypto";
-import { P as PaymentConfigurationError, b as PaymentProviderError } from "../chunks/errors-BgFC46qQ.js";
-import { g as getFetch, a as normalizeMaxStoredPaymentOptions, n as normalizeNonEmptyString, c as normalizeFutureDate, o as normalizePositivePaymentAmount, m as minorUnitsToDecimal, k as currencyMinorUnitDecimals, q as normalizeAmount, f as decimalToMinorUnitAmount, r as rememberPaymentOption, p as pollPaymentStatus, i as normalizeMinorUnitAmount, h as normalizeDate, e as normalizePositiveMinorUnitAmount, j as readJsonResponse, s as applyExpiryToPendingStatus, b as normalizeUrlString } from "../chunks/shared-DGHSqDQT.js";
-const BTC_BACKEND_ID = "btc";
-const DEFAULT_MAX_STORED_WEBHOOK_DELIVERY_IDS = 5e4;
-class BtcAdapter {
-  constructor(options) {
-    this.options = options;
-    if (typeof options.baseUrl !== "string" || !options.baseUrl.trim()) {
-      throw new PaymentConfigurationError("BtcAdapter requires baseUrl.");
-    }
-    if (typeof options.apiKey !== "string" || !options.apiKey.trim()) {
-      throw new PaymentConfigurationError("BtcAdapter requires apiKey.");
-    }
-    if (typeof options.storeId !== "string" || !options.storeId.trim()) {
-      throw new PaymentConfigurationError("BtcAdapter requires storeId.");
-    }
-    if (options.webhookSecret !== void 0) {
-      if (typeof options.webhookSecret !== "string") {
-        throw new PaymentConfigurationError(
-          "BtcAdapter webhookSecret must be a string when configured."
-        );
-      }
-      if (!options.webhookSecret.trim()) {
-        throw new PaymentConfigurationError(
-          "BtcAdapter webhookSecret must not be empty when configured."
-        );
-      }
-    }
-    this.fetch = getFetch(options.fetch);
-    this.maxStoredPaymentOptions = normalizeMaxStoredPaymentOptions(
-      options.maxStoredPaymentOptions,
-      "BtcAdapter maxStoredPaymentOptions"
-    );
-    this.maxStoredWebhookDeliveryIds = normalizeMaxStoredPaymentOptions(
-      options.maxStoredWebhookDeliveryIds ?? DEFAULT_MAX_STORED_WEBHOOK_DELIVERY_IDS,
-      "BtcAdapter maxStoredWebhookDeliveryIds"
-    );
-    this.baseUrl = normalizeBtcpayBaseUrl(options.baseUrl);
-    this.apiKey = options.apiKey.trim();
-    this.storeId = options.storeId.trim();
-    this.currency = normalizeCurrencyCode(options.currency ?? "USD");
-    this.paymentMethod = normalizePaymentMethod(
-      options.paymentMethod ?? "BTC-CHAIN"
-    );
-    this.webhookSecret = options.webhookSecret?.trim();
-    const managedProviderName = normalizeOptionalProviderString(
-      options.managedProviderName
-    );
-    this.capabilities = {
-      id: BTC_BACKEND_ID,
-      displayName: "Bitcoin via BTCPay Server",
-      settlementCurrency: "BTC",
-      supportedSettlementCurrencies: ["BTC"],
-      chain: "bitcoin",
-      settlementShape: "address",
-      x402Capable: false,
-      confirmationLatency: {
-        expectedSeconds: 600,
-        maxExpectedSeconds: 1800,
-        minConfirmations: 1,
-        description: "Tiered Bitcoin confirmation policy: 1 confirmation below $100, 2 below $1,000, 3 at $1,000 and above."
-      },
-      supportsRefunds: true,
-      supportsPayouts: true,
-      supportsWebhooks: true,
-      metadata: {
-        provider: "btcpay-server",
-        managedProviderName
-      }
-    };
-  }
-  capabilities;
-  fetch;
-  baseUrl;
-  apiKey;
-  storeId;
-  currency;
-  paymentMethod;
-  webhookSecret;
-  maxStoredPaymentOptions;
-  maxStoredWebhookDeliveryIds;
-  optionsByQuote = /* @__PURE__ */ new Map();
-  seenWebhookDeliveryIds = /* @__PURE__ */ new Set();
-  async createPaymentOption(input) {
-    const quoteId = normalizeNonEmptyString(input.quoteId, "BTC quoteId");
-    const expiresAt = normalizeFutureDate(
-      input.expiresAt,
-      "BTCPay invoice expiry"
-    );
-    const currency = normalizeCurrencyCode(input.currency);
-    const amount = normalizePositivePaymentAmount(
-      input.amount,
-      currency,
-      "BTCPay invoice amount"
-    );
-    const invoiceAmount = minorUnitsToDecimal(
-      amount,
-      currencyMinorUnitDecimals(currency)
-    );
-    const invoice = await this.request(
-      `/api/v1/stores/${encodeURIComponent(this.storeId)}/invoices`,
-      {
-        method: "POST",
-        body: JSON.stringify({
-          amount: invoiceAmount,
-          currency,
-          metadata: {
-            ...input.metadata,
-            quoteId,
-            buyerEmail: input.buyerEmail,
-            description: input.description
-          },
-          checkout: {
-            expirationMinutes: Math.max(
-              1,
-              Math.ceil((expiresAt.getTime() - Date.now()) / 6e4)
-            )
-          },
-          additionalSearchTerms: [quoteId]
-        })
-      }
-    );
-    const invoiceId = normalizeOptionalProviderString(
-      readProviderString(invoice, "id")
-    );
-    const methods = extractPaymentMethods(invoice) ?? (invoiceId ? await this.getPaymentMethods(invoiceId) : []);
-    const method = selectBtcPaymentMethod(methods, this.paymentMethod);
-    const settlementAmountDecimal = method?.decimalAmount === void 0 ? void 0 : normalizeAmount(method.decimalAmount);
-    const settlementAmount = settlementAmountDecimal === void 0 ? void 0 : decimalToMinorUnitAmount(
-      settlementAmountDecimal,
-      currencyMinorUnitDecimals("BTC"),
-      "BTC settlement"
-    );
-    const payTo = method?.destination?.trim();
-    if (!invoiceId) {
-      throw new PaymentProviderError(
-        "BTCPay invoice response did not include an invoice id."
-      );
-    }
-    if (!method || !payTo || settlementAmount === void 0 || settlementAmount === 0) {
-      throw new PaymentProviderError(
-        `BTCPay invoice response did not include a ${this.paymentMethod} payment address and amount.`
-      );
-    }
-    const requiredConfirmations = this.getRequiredConfirmations({
-      quoteId,
-      amount,
-      currency
-    });
-    const option = {
-      backendId: this.capabilities.id,
-      quoteId,
-      payTo,
-      settlementShape: "address",
-      settlementCurrency: "BTC",
-      settlementAmount,
-      amount,
-      currency,
-      expiresAt,
-      providerPaymentId: invoiceId,
-      paymentUri: normalizeOptionalProviderString(method?.paymentLink),
-      metadata: {
-        invoiceId,
-        checkoutLink: normalizeOptionalProviderString(
-          readString(invoice, "checkoutLink")
-        ),
-        requiredConfirmations,
-        rate: method?.rate,
-        networkFee: method?.networkFee
-      },
-      requiredConfirmations
-    };
-    rememberPaymentOption(
-      this.optionsByQuote,
-      quoteId,
-      option,
-      this.maxStoredPaymentOptions
-    );
-    return option;
-  }
-  watchPayment(input) {
-    return pollPaymentStatus(
-      {
-        ...input,
-        pollIntervalMs: input.pollIntervalMs ?? this.options.pollIntervalMs ?? 3e4
-      },
-      () => this.getStatus(input.quoteId, input.payTo, input.statusContext)
-    );
-  }
-  async getStatus(quoteId, payTo, context = {}) {
-    const normalizedQuoteId = normalizeNonEmptyString(quoteId, "BTC quoteId");
-    const normalizedPayTo = normalizeNonEmptyString(payTo, "BTC payTo");
-    const contextProviderPaymentId = context.providerPaymentId === void 0 ? void 0 : normalizeNonEmptyString(
-      context.providerPaymentId,
-      "BTC providerPaymentId"
-    );
-    const option = this.optionsByQuote.get(normalizedQuoteId);
-    const contextAmount = context.amount === void 0 ? void 0 : normalizeMinorUnitAmount(context.amount, "BTC status");
-    const contextCurrency = context.currency === void 0 ? void 0 : normalizeCurrencyCode(context.currency);
-    const contextSettlementAmount = context.settlementAmount === void 0 ? void 0 : normalizeMinorUnitAmount(
-      context.settlementAmount,
-      "BTC settlement status"
-    );
-    const invoice = option?.providerPaymentId !== void 0 || contextProviderPaymentId !== void 0 ? await this.getInvoice(
-      option?.providerPaymentId ?? contextProviderPaymentId ?? ""
-    ) : await this.findInvoice(normalizedQuoteId);
-    const invoiceId = normalizeOptionalProviderString(readProviderString(invoice, "id")) ?? option?.providerPaymentId;
-    const status = mapBtcpayStatus(
-      readString(invoice, "status"),
-      readString(invoice, "additionalStatus")
-    );
-    const expiresAt = option?.expiresAt ?? (context.expiresAt === void 0 ? void 0 : normalizeDate(context.expiresAt));
-    const statusWithExpiry = applyExpiryToPendingStatus(status, expiresAt);
-    let confirmations = findNestedNonNegativeInteger(invoice, [
-      "confirmations",
-      "confirmationCount"
-    ]);
-    const contextRequiredConfirmations = context.requiredConfirmations === void 0 ? void 0 : normalizeConfirmationCount(
-      context.requiredConfirmations,
-      "BTC requiredConfirmations"
-    );
-    const requiredConfirmations = option?.requiredConfirmations ?? contextRequiredConfirmations ?? this.getRequiredConfirmations({
-      quoteId: normalizedQuoteId,
-      amount: option?.amount ?? contextAmount ?? decimalToMinorUnitAmount(
-        readDecimalString(invoice, "amount") ?? "0",
-        currencyMinorUnitDecimals(
-          option?.currency ?? contextCurrency ?? this.currency
-        ),
-        "BTCPay invoice"
-      ),
-      currency: option?.currency ?? contextCurrency ?? this.currency
-    });
-    if (statusWithExpiry === "confirmed" && confirmations === void 0 && invoiceId) {
-      try {
-        confirmations = maxConfirmationCount(
-          await this.getPaymentMethods(invoiceId, { requireUsable: false })
-        );
-      } catch (error) {
-        if (!(error instanceof PaymentProviderError)) {
-          throw error;
-        }
-      }
-    }
-    const effectiveStatus = enforceBtcConfirmations(
-      statusWithExpiry,
-      confirmations,
-      requiredConfirmations
-    );
-    const invoiceSettlementAmount = findNestedDecimalString(invoice, [
-      "btcDue",
-      "amountDue"
-    ]);
-    const receivedSettlementAmount = readDecimalString(invoice, "amountPaid") ?? findNestedDecimalString(invoice, ["paid"]);
-    return {
-      backendId: this.capabilities.id,
-      quoteId: normalizedQuoteId,
-      payTo: normalizedPayTo,
-      status: effectiveStatus,
-      settlementCurrency: "BTC",
-      settlementAmount: option?.settlementAmount ?? contextSettlementAmount ?? (invoiceSettlementAmount === void 0 ? void 0 : decimalToMinorUnitAmount(
-        invoiceSettlementAmount,
-        currencyMinorUnitDecimals("BTC"),
-        "BTC settlement"
-      )),
-      receivedAmount: receivedSettlementAmount === void 0 ? void 0 : decimalToMinorUnitAmount(
-        receivedSettlementAmount,
-        currencyMinorUnitDecimals("BTC"),
-        "BTC received"
-      ),
-      amount: option?.amount ?? contextAmount,
-      currency: option?.currency ?? contextCurrency,
-      requiredConfirmations,
-      confirmations,
-      providerPaymentId: invoiceId,
-      transactionId: normalizeOptionalProviderString(
-        findNestedProviderString(invoice, ["transactionId", "txid"])
-      ),
-      updatedAt: /* @__PURE__ */ new Date(),
-      raw: invoice
-    };
-  }
-  async sendPayout(input) {
-    if (input.currency !== void 0) {
-      const currency = normalizeNonEmptyString(
-        input.currency,
-        "BTC payout currency"
-      );
-      if (currency.toUpperCase() !== "BTC") {
-        throw new PaymentConfigurationError(
-          `BtcAdapter can only send BTC payouts, received ${input.currency}.`
-        );
-      }
-    }
-    const destination = normalizeNonEmptyString(
-      input.destination,
-      "BTC payout destination"
-    );
-    const quoteId = input.quoteId === void 0 ? void 0 : normalizeNonEmptyString(input.quoteId, "BTC payout quoteId");
-    const idempotencyKey = input.idempotencyKey === void 0 ? quoteId : normalizeNonEmptyString(
-      input.idempotencyKey,
-      "BTC payout idempotencyKey"
-    );
-    const amount = normalizePositiveMinorUnitAmount(
-      input.amount,
-      "BTC payout amount"
-    );
-    const payoutAmount = minorUnitsToDecimal(
-      amount,
-      currencyMinorUnitDecimals("BTC")
-    );
-    const result = await this.request(
-      `/api/v1/stores/${encodeURIComponent(
-        this.storeId
-      )}/payment-methods/onchain/${encodeURIComponent(
-        this.paymentMethod
-      )}/wallet/transactions`,
-      {
-        method: "POST",
-        body: JSON.stringify({
-          destinations: [
-            {
-              destination,
-              amount: payoutAmount
-            }
-          ],
-          subtractFromAmount: false,
-          metadata: {
-            ...input.metadata,
-            ...quoteId === void 0 ? {} : { quoteId },
-            ...idempotencyKey === void 0 ? {} : { idempotencyKey },
-            ...input.memo === void 0 ? {} : { memo: input.memo }
-          }
-        })
-      }
-    );
-    return {
-      backendId: this.capabilities.id,
-      status: "pending_signature",
-      payoutId: normalizeOptionalProviderString(
-        readProviderString(result, "id")
-      ),
-      psbt: normalizeOptionalProviderString(readProviderString(result, "psbt")) ?? normalizeOptionalProviderString(
-        readProviderString(result, "psbtBase64")
-      ) ?? normalizeOptionalProviderString(
-        readProviderString(result, "unsignedPsbt")
-      ),
-      transactionId: normalizeOptionalProviderString(
-        readProviderString(result, "transactionId")
-      ),
-      destination,
-      amount,
-      currency: "BTC",
-      raw: result
-    };
-  }
-  async refundPayment(input) {
-    if (input.currency !== void 0 && normalizeCurrencyCode(input.currency) !== "BTC") {
-      throw new PaymentConfigurationError(
-        `BTC refunds require BTC currency when specified, received ${input.currency}.`
-      );
-    }
-    if (!input.destination) {
-      throw new PaymentConfigurationError(
-        "BTC refunds require a destination address."
-      );
-    }
-    if (input.amount === void 0) {
-      throw new PaymentConfigurationError("BTC refunds require an amount.");
-    }
-    const payout = await this.sendPayout({
-      destination: input.destination,
-      amount: input.amount,
-      currency: "BTC",
-      idempotencyKey: input.idempotencyKey,
-      memo: input.reason,
-      metadata: input.metadata
-    });
-    return {
-      backendId: this.capabilities.id,
-      status: "requires_action",
-      refundId: payout.payoutId,
-      transactionId: payout.transactionId,
-      amount: payout.amount,
-      currency: payout.currency,
-      raw: payout.raw
-    };
-  }
-  parseWebhookEvent(payload, signature) {
-    if (!this.webhookSecret) {
-      throw new PaymentConfigurationError(
-        "BtcAdapter parseWebhookEvent requires webhookSecret."
-      );
-    }
-    if (!signature) {
-      throw new PaymentProviderError("Missing BTCPay webhook signature.");
-    }
-    verifyBtcpayWebhookSignature(payload, signature, this.webhookSecret);
-    const event = parseBtcpayWebhookPayload(payload);
-    const type = normalizeOptionalWebhookString(
-      readProviderString(event, "type")
-    );
-    const deliveryId = normalizeOptionalWebhookString(
-      readProviderString(event, "deliveryId")
-    );
-    if (!deliveryId) {
-      throw new PaymentProviderError("BTCPay webhook deliveryId is required.");
-    }
-    const duplicate = this.seenWebhookDeliveryIds.has(deliveryId);
-    if (!duplicate) {
-      this.seenWebhookDeliveryIds.add(deliveryId);
-      while (this.seenWebhookDeliveryIds.size > this.maxStoredWebhookDeliveryIds) {
-        const oldest = this.seenWebhookDeliveryIds.values().next().value;
-        if (oldest === void 0) {
-          break;
-        }
-        this.seenWebhookDeliveryIds.delete(oldest);
-      }
-    }
-    const invoiceId = readProviderString(event, "invoiceId") ?? findNestedProviderString(event, ["invoiceId", "id"]);
-    return {
-      deliveryId,
-      invoiceId: normalizeOptionalWebhookString(invoiceId),
-      quoteId: normalizeOptionalWebhookString(
-        findNestedProviderString(event, ["quoteId"])
-      ),
-      duplicate,
-      type,
-      status: mapBtcpayStatus(
-        readString(event, "status"),
-        readString(event, "additionalStatus"),
-        type
-      ),
-      raw: event
-    };
-  }
-  getRequiredConfirmations(input) {
-    return normalizeConfirmationCount(
-      (this.options.confirmationPolicy ?? defaultBtcConfirmationPolicy)(input),
-      "BTC confirmationPolicy result"
-    );
-  }
-  async getInvoice(invoiceId) {
-    return this.request(
-      `/api/v1/stores/${encodeURIComponent(
-        this.storeId
-      )}/invoices/${encodeURIComponent(invoiceId)}`
-    );
-  }
-  async findInvoice(quoteId) {
-    const invoices = await this.request(
-      `/api/v1/stores/${encodeURIComponent(
-        this.storeId
-      )}/invoices?textSearch=${encodeURIComponent(quoteId)}`
-    );
-    const list = Array.isArray(invoices) ? invoices : Array.isArray(invoices.items) ? invoices.items : [];
-    const matches = list.filter(
-      (invoice) => invoiceMatchesQuote(invoice, quoteId)
-    );
-    if (matches.length > 1) {
-      throw new PaymentProviderError(
-        `BTCPay invoice lookup for quote ${quoteId} returned multiple matches.`
-      );
-    }
-    const [match] = matches;
-    if (!match || typeof match !== "object") {
-      throw new PaymentProviderError(
-        `BTCPay invoice for quote ${quoteId} was not found.`
-      );
-    }
-    return match;
-  }
-  async getPaymentMethods(invoiceId, options = {}) {
-    const response = await this.request(
-      `/api/v1/stores/${encodeURIComponent(
-        this.storeId
-      )}/invoices/${encodeURIComponent(invoiceId)}/payment-methods`
-    );
-    return extractPaymentMethods(response, options.requireUsable) ?? [];
-  }
-  async request(path, init = {}) {
-    const headers = new Headers(init.headers);
-    headers.set("Authorization", `token ${this.apiKey}`);
-    headers.set("Content-Type", "application/json");
-    headers.set("Accept", "application/json");
-    const response = await this.fetch(`${this.baseUrl}${path}`, {
-      ...init,
-      headers
-    });
-    return readJsonResponse(response, `BTCPay ${path}`);
-  }
-}
+//#region src/adapters/btc.ts
+var BTC_BACKEND_ID = "btc";
+var DEFAULT_MAX_STORED_WEBHOOK_DELIVERY_IDS = 5e4;
+var BtcAdapter = class {
+	options;
+	capabilities;
+	fetch;
+	baseUrl;
+	apiKey;
+	storeId;
+	currency;
+	paymentMethod;
+	webhookSecret;
+	maxStoredPaymentOptions;
+	maxStoredWebhookDeliveryIds;
+	optionsByQuote = /* @__PURE__ */ new Map();
+	seenWebhookDeliveryIds = /* @__PURE__ */ new Set();
+	constructor(options) {
+		this.options = options;
+		if (typeof options.baseUrl !== "string" || !options.baseUrl.trim()) throw new PaymentConfigurationError("BtcAdapter requires baseUrl.");
+		if (typeof options.apiKey !== "string" || !options.apiKey.trim()) throw new PaymentConfigurationError("BtcAdapter requires apiKey.");
+		if (typeof options.storeId !== "string" || !options.storeId.trim()) throw new PaymentConfigurationError("BtcAdapter requires storeId.");
+		if (options.webhookSecret !== void 0) {
+			if (typeof options.webhookSecret !== "string") throw new PaymentConfigurationError("BtcAdapter webhookSecret must be a string when configured.");
+			if (!options.webhookSecret.trim()) throw new PaymentConfigurationError("BtcAdapter webhookSecret must not be empty when configured.");
+		}
+		this.fetch = getFetch(options.fetch);
+		this.maxStoredPaymentOptions = normalizeMaxStoredPaymentOptions(options.maxStoredPaymentOptions, "BtcAdapter maxStoredPaymentOptions");
+		this.maxStoredWebhookDeliveryIds = normalizeMaxStoredPaymentOptions(options.maxStoredWebhookDeliveryIds ?? DEFAULT_MAX_STORED_WEBHOOK_DELIVERY_IDS, "BtcAdapter maxStoredWebhookDeliveryIds");
+		this.baseUrl = normalizeBtcpayBaseUrl(options.baseUrl);
+		this.apiKey = options.apiKey.trim();
+		this.storeId = options.storeId.trim();
+		this.currency = normalizeCurrencyCode(options.currency ?? "USD");
+		this.paymentMethod = normalizePaymentMethod(options.paymentMethod ?? "BTC-CHAIN");
+		this.webhookSecret = options.webhookSecret?.trim();
+		const managedProviderName = normalizeOptionalProviderString(options.managedProviderName);
+		this.capabilities = {
+			id: "btc",
+			displayName: "Bitcoin via BTCPay Server",
+			settlementCurrency: "BTC",
+			supportedSettlementCurrencies: ["BTC"],
+			chain: "bitcoin",
+			settlementShape: "address",
+			x402Capable: false,
+			confirmationLatency: {
+				expectedSeconds: 600,
+				maxExpectedSeconds: 1800,
+				minConfirmations: 1,
+				description: "Tiered Bitcoin confirmation policy: 1 confirmation below $100, 2 below $1,000, 3 at $1,000 and above."
+			},
+			supportsRefunds: true,
+			supportsPayouts: true,
+			supportsWebhooks: true,
+			metadata: {
+				provider: "btcpay-server",
+				managedProviderName
+			}
+		};
+	}
+	async createPaymentOption(input) {
+		const quoteId = normalizeNonEmptyString(input.quoteId, "BTC quoteId");
+		const expiresAt = normalizeFutureDate(input.expiresAt, "BTCPay invoice expiry");
+		const currency = normalizeCurrencyCode(input.currency);
+		const amount = normalizePositivePaymentAmount(input.amount, currency, "BTCPay invoice amount");
+		const invoiceAmount = minorUnitsToDecimal(amount, currencyMinorUnitDecimals(currency));
+		const invoice = await this.request(`/api/v1/stores/${encodeURIComponent(this.storeId)}/invoices`, {
+			method: "POST",
+			body: JSON.stringify({
+				amount: invoiceAmount,
+				currency,
+				metadata: {
+					...input.metadata,
+					quoteId,
+					buyerEmail: input.buyerEmail,
+					description: input.description
+				},
+				checkout: { expirationMinutes: Math.max(1, Math.ceil((expiresAt.getTime() - Date.now()) / 6e4)) },
+				additionalSearchTerms: [quoteId]
+			})
+		});
+		const invoiceId = normalizeOptionalProviderString(readProviderString(invoice, "id"));
+		const method = selectBtcPaymentMethod(extractPaymentMethods(invoice) ?? (invoiceId ? await this.getPaymentMethods(invoiceId) : []), this.paymentMethod);
+		const settlementAmountDecimal = method?.decimalAmount === void 0 ? void 0 : normalizeAmount(method.decimalAmount);
+		const settlementAmount = settlementAmountDecimal === void 0 ? void 0 : decimalToMinorUnitAmount(settlementAmountDecimal, currencyMinorUnitDecimals("BTC"), "BTC settlement");
+		const payTo = method?.destination?.trim();
+		if (!invoiceId) throw new PaymentProviderError("BTCPay invoice response did not include an invoice id.");
+		if (!method || !payTo || settlementAmount === void 0 || settlementAmount === 0) throw new PaymentProviderError(`BTCPay invoice response did not include a ${this.paymentMethod} payment address and amount.`);
+		const requiredConfirmations = this.getRequiredConfirmations({
+			quoteId,
+			amount,
+			currency
+		});
+		const option = {
+			backendId: this.capabilities.id,
+			quoteId,
+			payTo,
+			settlementShape: "address",
+			settlementCurrency: "BTC",
+			settlementAmount,
+			amount,
+			currency,
+			expiresAt,
+			providerPaymentId: invoiceId,
+			paymentUri: normalizeOptionalProviderString(method?.paymentLink),
+			metadata: {
+				invoiceId,
+				checkoutLink: normalizeOptionalProviderString(readString(invoice, "checkoutLink")),
+				requiredConfirmations,
+				rate: method?.rate,
+				networkFee: method?.networkFee
+			},
+			requiredConfirmations
+		};
+		rememberPaymentOption(this.optionsByQuote, quoteId, option, this.maxStoredPaymentOptions);
+		return option;
+	}
+	watchPayment(input) {
+		return pollPaymentStatus({
+			...input,
+			pollIntervalMs: input.pollIntervalMs ?? this.options.pollIntervalMs ?? 3e4
+		}, () => this.getStatus(input.quoteId, input.payTo, input.statusContext));
+	}
+	async getStatus(quoteId, payTo, context = {}) {
+		const normalizedQuoteId = normalizeNonEmptyString(quoteId, "BTC quoteId");
+		const normalizedPayTo = normalizeNonEmptyString(payTo, "BTC payTo");
+		const contextProviderPaymentId = context.providerPaymentId === void 0 ? void 0 : normalizeNonEmptyString(context.providerPaymentId, "BTC providerPaymentId");
+		const option = this.optionsByQuote.get(normalizedQuoteId);
+		const contextAmount = context.amount === void 0 ? void 0 : normalizeMinorUnitAmount(context.amount, "BTC status");
+		const contextCurrency = context.currency === void 0 ? void 0 : normalizeCurrencyCode(context.currency);
+		const contextSettlementAmount = context.settlementAmount === void 0 ? void 0 : normalizeMinorUnitAmount(context.settlementAmount, "BTC settlement status");
+		const invoice = option?.providerPaymentId !== void 0 || contextProviderPaymentId !== void 0 ? await this.getInvoice(option?.providerPaymentId ?? contextProviderPaymentId ?? "") : await this.findInvoice(normalizedQuoteId);
+		const invoiceId = normalizeOptionalProviderString(readProviderString(invoice, "id")) ?? option?.providerPaymentId;
+		const statusWithExpiry = applyExpiryToPendingStatus(mapBtcpayStatus(readString(invoice, "status"), readString(invoice, "additionalStatus")), option?.expiresAt ?? (context.expiresAt === void 0 ? void 0 : normalizeDate(context.expiresAt)));
+		let confirmations = findNestedNonNegativeInteger(invoice, ["confirmations", "confirmationCount"]);
+		const contextRequiredConfirmations = context.requiredConfirmations === void 0 ? void 0 : normalizeConfirmationCount(context.requiredConfirmations, "BTC requiredConfirmations");
+		const requiredConfirmations = option?.requiredConfirmations ?? contextRequiredConfirmations ?? this.getRequiredConfirmations({
+			quoteId: normalizedQuoteId,
+			amount: option?.amount ?? contextAmount ?? decimalToMinorUnitAmount(readDecimalString(invoice, "amount") ?? "0", currencyMinorUnitDecimals(option?.currency ?? contextCurrency ?? this.currency), "BTCPay invoice"),
+			currency: option?.currency ?? contextCurrency ?? this.currency
+		});
+		if (statusWithExpiry === "confirmed" && confirmations === void 0 && invoiceId) try {
+			confirmations = maxConfirmationCount(await this.getPaymentMethods(invoiceId, { requireUsable: false }));
+		} catch (error) {
+			if (!(error instanceof PaymentProviderError)) throw error;
+		}
+		const effectiveStatus = enforceBtcConfirmations(statusWithExpiry, confirmations, requiredConfirmations);
+		const invoiceSettlementAmount = findNestedDecimalString(invoice, ["btcDue", "amountDue"]);
+		const receivedSettlementAmount = readDecimalString(invoice, "amountPaid") ?? findNestedDecimalString(invoice, ["paid"]);
+		return {
+			backendId: this.capabilities.id,
+			quoteId: normalizedQuoteId,
+			payTo: normalizedPayTo,
+			status: effectiveStatus,
+			settlementCurrency: "BTC",
+			settlementAmount: option?.settlementAmount ?? contextSettlementAmount ?? (invoiceSettlementAmount === void 0 ? void 0 : decimalToMinorUnitAmount(invoiceSettlementAmount, currencyMinorUnitDecimals("BTC"), "BTC settlement")),
+			receivedAmount: receivedSettlementAmount === void 0 ? void 0 : decimalToMinorUnitAmount(receivedSettlementAmount, currencyMinorUnitDecimals("BTC"), "BTC received"),
+			amount: option?.amount ?? contextAmount,
+			currency: option?.currency ?? contextCurrency,
+			requiredConfirmations,
+			confirmations,
+			providerPaymentId: invoiceId,
+			transactionId: normalizeOptionalProviderString(findNestedProviderString(invoice, ["transactionId", "txid"])),
+			updatedAt: /* @__PURE__ */ new Date(),
+			raw: invoice
+		};
+	}
+	async sendPayout(input) {
+		if (input.currency !== void 0) {
+			if (normalizeNonEmptyString(input.currency, "BTC payout currency").toUpperCase() !== "BTC") throw new PaymentConfigurationError(`BtcAdapter can only send BTC payouts, received ${input.currency}.`);
+		}
+		const destination = normalizeNonEmptyString(input.destination, "BTC payout destination");
+		const quoteId = input.quoteId === void 0 ? void 0 : normalizeNonEmptyString(input.quoteId, "BTC payout quoteId");
+		const idempotencyKey = input.idempotencyKey === void 0 ? quoteId : normalizeNonEmptyString(input.idempotencyKey, "BTC payout idempotencyKey");
+		const amount = normalizePositiveMinorUnitAmount(input.amount, "BTC payout amount");
+		const payoutAmount = minorUnitsToDecimal(amount, currencyMinorUnitDecimals("BTC"));
+		const result = await this.request(`/api/v1/stores/${encodeURIComponent(this.storeId)}/payment-methods/onchain/${encodeURIComponent(this.paymentMethod)}/wallet/transactions`, {
+			method: "POST",
+			body: JSON.stringify({
+				destinations: [{
+					destination,
+					amount: payoutAmount
+				}],
+				subtractFromAmount: false,
+				metadata: {
+					...input.metadata,
+					...quoteId === void 0 ? {} : { quoteId },
+					...idempotencyKey === void 0 ? {} : { idempotencyKey },
+					...input.memo === void 0 ? {} : { memo: input.memo }
+				}
+			})
+		});
+		return {
+			backendId: this.capabilities.id,
+			status: "pending_signature",
+			payoutId: normalizeOptionalProviderString(readProviderString(result, "id")),
+			psbt: normalizeOptionalProviderString(readProviderString(result, "psbt")) ?? normalizeOptionalProviderString(readProviderString(result, "psbtBase64")) ?? normalizeOptionalProviderString(readProviderString(result, "unsignedPsbt")),
+			transactionId: normalizeOptionalProviderString(readProviderString(result, "transactionId")),
+			destination,
+			amount,
+			currency: "BTC",
+			raw: result
+		};
+	}
+	async refundPayment(input) {
+		if (input.currency !== void 0 && normalizeCurrencyCode(input.currency) !== "BTC") throw new PaymentConfigurationError(`BTC refunds require BTC currency when specified, received ${input.currency}.`);
+		if (!input.destination) throw new PaymentConfigurationError("BTC refunds require a destination address.");
+		if (input.amount === void 0) throw new PaymentConfigurationError("BTC refunds require an amount.");
+		const payout = await this.sendPayout({
+			destination: input.destination,
+			amount: input.amount,
+			currency: "BTC",
+			idempotencyKey: input.idempotencyKey,
+			memo: input.reason,
+			metadata: input.metadata
+		});
+		return {
+			backendId: this.capabilities.id,
+			status: "requires_action",
+			refundId: payout.payoutId,
+			transactionId: payout.transactionId,
+			amount: payout.amount,
+			currency: payout.currency,
+			raw: payout.raw
+		};
+	}
+	parseWebhookEvent(payload, signature) {
+		if (!this.webhookSecret) throw new PaymentConfigurationError("BtcAdapter parseWebhookEvent requires webhookSecret.");
+		if (!signature) throw new PaymentProviderError("Missing BTCPay webhook signature.");
+		verifyBtcpayWebhookSignature(payload, signature, this.webhookSecret);
+		const event = parseBtcpayWebhookPayload(payload);
+		const type = normalizeOptionalWebhookString(readProviderString(event, "type"));
+		const deliveryId = normalizeOptionalWebhookString(readProviderString(event, "deliveryId"));
+		if (!deliveryId) throw new PaymentProviderError("BTCPay webhook deliveryId is required.");
+		const duplicate = this.seenWebhookDeliveryIds.has(deliveryId);
+		if (!duplicate) {
+			this.seenWebhookDeliveryIds.add(deliveryId);
+			while (this.seenWebhookDeliveryIds.size > this.maxStoredWebhookDeliveryIds) {
+				const oldest = this.seenWebhookDeliveryIds.values().next().value;
+				if (oldest === void 0) break;
+				this.seenWebhookDeliveryIds.delete(oldest);
+			}
+		}
+		return {
+			deliveryId,
+			invoiceId: normalizeOptionalWebhookString(readProviderString(event, "invoiceId") ?? findNestedProviderString(event, ["invoiceId", "id"])),
+			quoteId: normalizeOptionalWebhookString(findNestedProviderString(event, ["quoteId"])),
+			duplicate,
+			type,
+			status: mapBtcpayStatus(readString(event, "status"), readString(event, "additionalStatus"), type),
+			raw: event
+		};
+	}
+	getRequiredConfirmations(input) {
+		return normalizeConfirmationCount((this.options.confirmationPolicy ?? defaultBtcConfirmationPolicy)(input), "BTC confirmationPolicy result");
+	}
+	async getInvoice(invoiceId) {
+		return this.request(`/api/v1/stores/${encodeURIComponent(this.storeId)}/invoices/${encodeURIComponent(invoiceId)}`);
+	}
+	async findInvoice(quoteId) {
+		const invoices = await this.request(`/api/v1/stores/${encodeURIComponent(this.storeId)}/invoices?textSearch=${encodeURIComponent(quoteId)}`);
+		const matches = (Array.isArray(invoices) ? invoices : Array.isArray(invoices.items) ? invoices.items : []).filter((invoice) => invoiceMatchesQuote(invoice, quoteId));
+		if (matches.length > 1) throw new PaymentProviderError(`BTCPay invoice lookup for quote ${quoteId} returned multiple matches.`);
+		const [match] = matches;
+		if (!match || typeof match !== "object") throw new PaymentProviderError(`BTCPay invoice for quote ${quoteId} was not found.`);
+		return match;
+	}
+	async getPaymentMethods(invoiceId, options = {}) {
+		return extractPaymentMethods(await this.request(`/api/v1/stores/${encodeURIComponent(this.storeId)}/invoices/${encodeURIComponent(invoiceId)}/payment-methods`), options.requireUsable) ?? [];
+	}
+	async request(path, init = {}) {
+		const headers = new Headers(init.headers);
+		headers.set("Authorization", `token ${this.apiKey}`);
+		headers.set("Content-Type", "application/json");
+		headers.set("Accept", "application/json");
+		return readJsonResponse(await this.fetch(`${this.baseUrl}${path}`, {
+			...init,
+			headers
+		}), `BTCPay ${path}`);
+	}
+};
 function invoiceMatchesQuote(invoice, quoteId) {
-  if (!invoice || typeof invoice !== "object") {
-    return false;
-  }
-  const record = invoice;
-  const metadata = record.metadata && typeof record.metadata === "object" ? record.metadata : void 0;
-  if (readProviderString(metadata, "quoteId")?.trim() === quoteId) {
-    return true;
-  }
-  return false;
+	if (!invoice || typeof invoice !== "object") return false;
+	const record = invoice;
+	if (readProviderString(record.metadata && typeof record.metadata === "object" ? record.metadata : void 0, "quoteId")?.trim() === quoteId) return true;
+	return false;
 }
 function defaultBtcConfirmationPolicy(input) {
-  const decimals = currencyMinorUnitDecimals(input.currency);
-  const highValueThreshold = decimalToMinorUnitAmount(
-    "1000",
-    decimals,
-    "BTC confirmation threshold"
-  );
-  const mediumValueThreshold = decimalToMinorUnitAmount(
-    "100",
-    decimals,
-    "BTC confirmation threshold"
-  );
-  if (input.amount >= highValueThreshold) {
-    return 3;
-  }
-  if (input.amount >= mediumValueThreshold) {
-    return 2;
-  }
-  return 1;
+	const decimals = currencyMinorUnitDecimals(input.currency);
+	const highValueThreshold = decimalToMinorUnitAmount("1000", decimals, "BTC confirmation threshold");
+	const mediumValueThreshold = decimalToMinorUnitAmount("100", decimals, "BTC confirmation threshold");
+	if (input.amount >= highValueThreshold) return 3;
+	if (input.amount >= mediumValueThreshold) return 2;
+	return 1;
 }
 function verifyBtcpayWebhookSignature(payload, signature, secret) {
-  if (typeof payload !== "string") {
-    throw new PaymentProviderError("BTCPay webhook payload must be a string.");
-  }
-  const normalizedSignature = normalizeNonEmptyString(
-    signature,
-    "BTCPay webhook signature"
-  );
-  const normalizedSecret = normalizeNonEmptyString(
-    secret,
-    "BTCPay webhook secret"
-  );
-  const expected = createHmac("sha256", normalizedSecret).update(payload).digest("hex");
-  const actual = normalizedSignature.replace(/^sha256=/, "");
-  if (!/^[a-f0-9]{64}$/i.test(actual)) {
-    throw new PaymentProviderError("Invalid BTCPay webhook signature.");
-  }
-  const expectedBuffer = Buffer.from(expected, "hex");
-  const actualBuffer = Buffer.from(actual, "hex");
-  if (expectedBuffer.length !== actualBuffer.length || !timingSafeEqual(expectedBuffer, actualBuffer)) {
-    throw new PaymentProviderError("Invalid BTCPay webhook signature.");
-  }
+	if (typeof payload !== "string") throw new PaymentProviderError("BTCPay webhook payload must be a string.");
+	const normalizedSignature = normalizeNonEmptyString(signature, "BTCPay webhook signature");
+	const expected = createHmac("sha256", normalizeNonEmptyString(secret, "BTCPay webhook secret")).update(payload).digest("hex");
+	const actual = normalizedSignature.replace(/^sha256=/, "");
+	if (!/^[a-f0-9]{64}$/i.test(actual)) throw new PaymentProviderError("Invalid BTCPay webhook signature.");
+	const expectedBuffer = Buffer.from(expected, "hex");
+	const actualBuffer = Buffer.from(actual, "hex");
+	if (expectedBuffer.length !== actualBuffer.length || !timingSafeEqual(expectedBuffer, actualBuffer)) throw new PaymentProviderError("Invalid BTCPay webhook signature.");
 }
 function parseBtcpayWebhookPayload(payload) {
-  try {
-    const event = JSON.parse(payload);
-    if (!event || typeof event !== "object" || Array.isArray(event)) {
-      throw new PaymentProviderError("Invalid BTCPay webhook JSON payload.");
-    }
-    return event;
-  } catch (error) {
-    if (error instanceof PaymentProviderError) {
-      throw error;
-    }
-    throw new PaymentProviderError("Invalid BTCPay webhook JSON payload.", {
-      cause: error
-    });
-  }
+	try {
+		const event = JSON.parse(payload);
+		if (!event || typeof event !== "object" || Array.isArray(event)) throw new PaymentProviderError("Invalid BTCPay webhook JSON payload.");
+		return event;
+	} catch (error) {
+		if (error instanceof PaymentProviderError) throw error;
+		throw new PaymentProviderError("Invalid BTCPay webhook JSON payload.", { cause: error });
+	}
 }
 function normalizeOptionalWebhookString(value) {
-  const normalized = value?.trim();
-  return normalized ? normalized : void 0;
+	const normalized = value?.trim();
+	return normalized ? normalized : void 0;
 }
 function normalizeOptionalProviderString(value) {
-  const normalized = value?.trim();
-  return normalized ? normalized : void 0;
+	const normalized = value?.trim();
+	return normalized ? normalized : void 0;
 }
 function mapBtcpayStatus(status, additionalStatus, type) {
-  const statusToken = normalizeBtcpayToken(status);
-  const additionalStatusToken = normalizeBtcpayToken(additionalStatus);
-  const typeToken = normalizeBtcpayToken(type);
-  const tokens = [statusToken, additionalStatusToken, typeToken];
-  if (tokens.some(
-    (token) => ["incomplete", "invoiceincomplete", "new", "unpaid"].includes(token)
-  )) {
-    return "pending";
-  }
-  if (tokens.some(
-    (token) => [
-      "settled",
-      "complete",
-      "confirmed",
-      "invoicesettled",
-      "invoicepaymentsettled"
-    ].includes(token)
-  )) {
-    return "confirmed";
-  }
-  if (tokens.some((token) => ["expired", "invoiceexpired"].includes(token))) {
-    return "expired";
-  }
-  if (tokens.some(
-    (token) => ["invalid", "failed", "invoiceinvalid"].includes(token)
-  )) {
-    return "failed";
-  }
-  if (tokens.some(
-    (token) => [
-      "processing",
-      "paid",
-      "paidlate",
-      "paidpartial",
-      "invoiceprocessing",
-      "invoicereceivedpayment",
-      "invoicepaymentsettling"
-    ].includes(token)
-  )) {
-    return "processing";
-  }
-  return "pending";
+	const tokens = [
+		normalizeBtcpayToken(status),
+		normalizeBtcpayToken(additionalStatus),
+		normalizeBtcpayToken(type)
+	];
+	if (tokens.some((token) => [
+		"incomplete",
+		"invoiceincomplete",
+		"new",
+		"unpaid"
+	].includes(token))) return "pending";
+	if (tokens.some((token) => [
+		"settled",
+		"complete",
+		"confirmed",
+		"invoicesettled",
+		"invoicepaymentsettled"
+	].includes(token))) return "confirmed";
+	if (tokens.some((token) => ["expired", "invoiceexpired"].includes(token))) return "expired";
+	if (tokens.some((token) => [
+		"invalid",
+		"failed",
+		"invoiceinvalid"
+	].includes(token))) return "failed";
+	if (tokens.some((token) => [
+		"processing",
+		"paid",
+		"paidlate",
+		"paidpartial",
+		"invoiceprocessing",
+		"invoicereceivedpayment",
+		"invoicepaymentsettling"
+	].includes(token))) return "processing";
+	return "pending";
 }
 function normalizeBtcpayToken(value) {
-  return value?.trim().toLowerCase().replace(/[^a-z0-9]/g, "") ?? "";
+	return value?.trim().toLowerCase().replace(/[^a-z0-9]/g, "") ?? "";
 }
 function enforceBtcConfirmations(status, confirmations, requiredConfirmations) {
-  if (status !== "confirmed") {
-    return status;
-  }
-  if (requiredConfirmations <= 0) {
-    return status;
-  }
-  if (confirmations === void 0) {
-    return "processing";
-  }
-  return confirmations >= requiredConfirmations ? "confirmed" : "processing";
+	if (status !== "confirmed") return status;
+	if (requiredConfirmations <= 0) return status;
+	if (confirmations === void 0) return "processing";
+	return confirmations >= requiredConfirmations ? "confirmed" : "processing";
 }
 function normalizeConfirmationCount(value, label) {
-  if (!Number.isInteger(value) || value < 0) {
-    throw new PaymentConfigurationError(
-      `${label} must be a non-negative integer, received ${String(value)}.`
-    );
-  }
-  return value;
+	if (!Number.isInteger(value) || value < 0) throw new PaymentConfigurationError(`${label} must be a non-negative integer, received ${String(value)}.`);
+	return value;
 }
 function normalizeCurrencyCode(value) {
-  if (typeof value !== "string") {
-    throw new PaymentConfigurationError(
-      `BtcAdapter currency must be a three-letter currency code, received ${String(value)}.`
-    );
-  }
-  const normalized = value.trim().toUpperCase();
-  if (!/^[A-Z]{3}$/.test(normalized)) {
-    throw new PaymentConfigurationError(
-      `BtcAdapter currency must be a three-letter currency code, received ${String(value)}.`
-    );
-  }
-  return normalized;
+	if (typeof value !== "string") throw new PaymentConfigurationError(`BtcAdapter currency must be a three-letter currency code, received ${String(value)}.`);
+	const normalized = value.trim().toUpperCase();
+	if (!/^[A-Z]{3}$/.test(normalized)) throw new PaymentConfigurationError(`BtcAdapter currency must be a three-letter currency code, received ${String(value)}.`);
+	return normalized;
 }
 function normalizePaymentMethod(value) {
-  if (typeof value !== "string") {
-    throw new PaymentConfigurationError(
-      "BtcAdapter paymentMethod must be a string."
-    );
-  }
-  const normalized = value.trim();
-  if (!normalized) {
-    throw new PaymentConfigurationError(
-      "BtcAdapter paymentMethod must not be empty when configured."
-    );
-  }
-  return normalized;
+	if (typeof value !== "string") throw new PaymentConfigurationError("BtcAdapter paymentMethod must be a string.");
+	const normalized = value.trim();
+	if (!normalized) throw new PaymentConfigurationError("BtcAdapter paymentMethod must not be empty when configured.");
+	return normalized;
 }
 function normalizeBtcpayBaseUrl(value) {
-  const normalized = normalizeUrlString(value, "BtcAdapter baseUrl").trim().replace(/\/$/, "");
-  const parsed = new URL(normalized);
-  if (parsed.search || parsed.hash || !["", "/"].includes(parsed.pathname)) {
-    throw new PaymentConfigurationError(
-      "BtcAdapter baseUrl must be an origin URL without path, query, or fragment."
-    );
-  }
-  return parsed.origin;
+	const normalized = normalizeUrlString(value, "BtcAdapter baseUrl").trim().replace(/\/$/, "");
+	const parsed = new URL(normalized);
+	if (parsed.search || parsed.hash || !["", "/"].includes(parsed.pathname)) throw new PaymentConfigurationError("BtcAdapter baseUrl must be an origin URL without path, query, or fragment.");
+	return parsed.origin;
 }
 function extractPaymentMethods(value, requireUsable = true) {
-  if (!value) {
-    return void 0;
-  }
-  if (Array.isArray(value)) {
-    const methods2 = value.filter(
-      (item) => Boolean(item) && typeof item === "object" && !Array.isArray(item)
-    ).map(readPaymentMethod);
-    return requireUsable ? methods2.filter(isUsablePaymentMethod) : methods2;
-  }
-  if (typeof value !== "object") {
-    return void 0;
-  }
-  const record = value;
-  for (const key of ["paymentMethods", "paymentMethodDetails", "methods"]) {
-    const nested = extractPaymentMethods(record[key], requireUsable);
-    if (nested?.length) {
-      return nested;
-    }
-  }
-  const methods = Object.entries(record).filter(([key, item]) => key.toUpperCase().includes("BTC") && item).map(([key, item]) => {
-    const method = readPaymentMethod(item);
-    return {
-      ...method,
-      paymentMethod: method.paymentMethod ?? key
-    };
-  });
-  return requireUsable ? methods.filter(isUsablePaymentMethod) : methods;
+	if (!value) return;
+	if (Array.isArray(value)) {
+		const methods = value.filter((item) => Boolean(item) && typeof item === "object" && !Array.isArray(item)).map(readPaymentMethod);
+		return requireUsable ? methods.filter(isUsablePaymentMethod) : methods;
+	}
+	if (typeof value !== "object") return;
+	const record = value;
+	for (const key of [
+		"paymentMethods",
+		"paymentMethodDetails",
+		"methods"
+	]) {
+		const nested = extractPaymentMethods(record[key], requireUsable);
+		if (nested?.length) return nested;
+	}
+	const methods = Object.entries(record).filter(([key, item]) => key.toUpperCase().includes("BTC") && item).map(([key, item]) => {
+		const method = readPaymentMethod(item);
+		return {
+			...method,
+			paymentMethod: method.paymentMethod ?? key
+		};
+	});
+	return requireUsable ? methods.filter(isUsablePaymentMethod) : methods;
 }
 function selectBtcPaymentMethod(methods, paymentMethod) {
-  const target = paymentMethod.toUpperCase();
-  const aliases = target === "BTC" || target === "BTC-CHAIN" ? ["BTC-CHAIN", "BTC", "BITCOIN"] : [target];
-  return methods.find((method) => paymentMethodMatchesAlias(method, aliases));
+	const target = paymentMethod.toUpperCase();
+	const aliases = target === "BTC" || target === "BTC-CHAIN" ? [
+		"BTC-CHAIN",
+		"BTC",
+		"BITCOIN"
+	] : [target];
+	return methods.find((method) => paymentMethodMatchesAlias(method, aliases));
 }
 function paymentMethodMatchesAlias(method, aliases) {
-  const methodIdentifiers = [method.paymentMethod, method.paymentMethodId].map((value) => value?.trim().toUpperCase()).filter((value) => Boolean(value));
-  if (methodIdentifiers.length > 0) {
-    return methodIdentifiers.some((value) => aliases.includes(value));
-  }
-  const cryptoCode = method.cryptoCode?.trim().toUpperCase();
-  return cryptoCode !== void 0 && aliases.includes(cryptoCode);
+	const methodIdentifiers = [method.paymentMethod, method.paymentMethodId].map((value) => value?.trim().toUpperCase()).filter((value) => Boolean(value));
+	if (methodIdentifiers.length > 0) return methodIdentifiers.some((value) => aliases.includes(value));
+	const cryptoCode = method.cryptoCode?.trim().toUpperCase();
+	return cryptoCode !== void 0 && aliases.includes(cryptoCode);
 }
 function readPaymentMethod(value) {
-  return {
-    decimalAmount: readDecimalString(value, "amount") ?? readDecimalString(value, "due"),
-    destination: readProviderString(value, "destination") ?? readProviderString(value, "address") ?? readProviderString(value, "paymentAddress"),
-    paymentLink: readProviderString(value, "paymentLink") ?? readProviderString(value, "paymentUrl"),
-    paymentMethod: readProviderString(value, "paymentMethod") ?? readProviderString(value, "paymentMethodId"),
-    paymentMethodId: readProviderString(value, "paymentMethodId"),
-    cryptoCode: readProviderString(value, "cryptoCode"),
-    rate: readDecimalString(value, "rate"),
-    networkFee: readDecimalString(value, "networkFee"),
-    confirmations: findNestedNonNegativeInteger(value, [
-      "confirmations",
-      "confirmationCount"
-    ])
-  };
+	return {
+		decimalAmount: readDecimalString(value, "amount") ?? readDecimalString(value, "due"),
+		destination: readProviderString(value, "destination") ?? readProviderString(value, "address") ?? readProviderString(value, "paymentAddress"),
+		paymentLink: readProviderString(value, "paymentLink") ?? readProviderString(value, "paymentUrl"),
+		paymentMethod: readProviderString(value, "paymentMethod") ?? readProviderString(value, "paymentMethodId"),
+		paymentMethodId: readProviderString(value, "paymentMethodId"),
+		cryptoCode: readProviderString(value, "cryptoCode"),
+		rate: readDecimalString(value, "rate"),
+		networkFee: readDecimalString(value, "networkFee"),
+		confirmations: findNestedNonNegativeInteger(value, ["confirmations", "confirmationCount"])
+	};
 }
 function isUsablePaymentMethod(method) {
-  return Boolean(method.destination && method.decimalAmount);
+	return Boolean(method.destination && method.decimalAmount);
 }
 function maxConfirmationCount(methods) {
-  const confirmations = methods.map((method) => method.confirmations).filter((value) => value !== void 0);
-  return confirmations.length === 0 ? void 0 : Math.max(...confirmations);
+	const confirmations = methods.map((method) => method.confirmations).filter((value) => value !== void 0);
+	return confirmations.length === 0 ? void 0 : Math.max(...confirmations);
 }
 function readString(value, key) {
-  if (!value || typeof value !== "object") {
-    return void 0;
-  }
-  const item = value[key];
-  if (typeof item === "string") {
-    return item;
-  }
-  if (typeof item === "number") {
-    return String(item);
-  }
-  return void 0;
+	if (!value || typeof value !== "object") return;
+	const item = value[key];
+	if (typeof item === "string") return item;
+	if (typeof item === "number") return String(item);
 }
 function readProviderString(value, key) {
-  if (!value || typeof value !== "object") {
-    return void 0;
-  }
-  const item = value[key];
-  return typeof item === "string" ? item : void 0;
+	if (!value || typeof value !== "object") return;
+	const item = value[key];
+	return typeof item === "string" ? item : void 0;
 }
 function findNestedString(value, keys, depth = 0) {
-  if (!value || typeof value !== "object" || depth > 16) {
-    return void 0;
-  }
-  const record = value;
-  for (const key of keys) {
-    const direct = readString(record, key);
-    if (direct) {
-      return direct;
-    }
-  }
-  for (const child of Object.values(record)) {
-    const match = findNestedString(child, keys, depth + 1);
-    if (match) {
-      return match;
-    }
-  }
-  return void 0;
+	if (!value || typeof value !== "object" || depth > 16) return;
+	const record = value;
+	for (const key of keys) {
+		const direct = readString(record, key);
+		if (direct) return direct;
+	}
+	for (const child of Object.values(record)) {
+		const match = findNestedString(child, keys, depth + 1);
+		if (match) return match;
+	}
 }
 function findNestedProviderString(value, keys, depth = 0) {
-  if (!value || typeof value !== "object" || depth > 16) {
-    return void 0;
-  }
-  const record = value;
-  for (const key of keys) {
-    const direct = readProviderString(record, key);
-    if (direct) {
-      return direct;
-    }
-  }
-  for (const child of Object.values(record)) {
-    const match = findNestedProviderString(child, keys, depth + 1);
-    if (match) {
-      return match;
-    }
-  }
-  return void 0;
+	if (!value || typeof value !== "object" || depth > 16) return;
+	const record = value;
+	for (const key of keys) {
+		const direct = readProviderString(record, key);
+		if (direct) return direct;
+	}
+	for (const child of Object.values(record)) {
+		const match = findNestedProviderString(child, keys, depth + 1);
+		if (match) return match;
+	}
 }
 function findNestedNonNegativeInteger(value, keys) {
-  const raw = findNestedString(value, keys);
-  if (raw === void 0 || !/^\d+$/.test(raw)) {
-    return void 0;
-  }
-  const parsed = Number(raw);
-  return Number.isSafeInteger(parsed) ? parsed : void 0;
+	const raw = findNestedString(value, keys);
+	if (raw === void 0 || !/^\d+$/.test(raw)) return;
+	const parsed = Number(raw);
+	return Number.isSafeInteger(parsed) ? parsed : void 0;
 }
 function findNestedDecimalString(value, keys, depth = 0) {
-  if (!value || typeof value !== "object" || depth > 16) {
-    return void 0;
-  }
-  const record = value;
-  for (const key of keys) {
-    const direct = readDecimalString(record, key);
-    if (direct) {
-      return direct;
-    }
-  }
-  for (const child of Object.values(record)) {
-    const match = findNestedDecimalString(child, keys, depth + 1);
-    if (match) {
-      return match;
-    }
-  }
-  return void 0;
+	if (!value || typeof value !== "object" || depth > 16) return;
+	const record = value;
+	for (const key of keys) {
+		const direct = readDecimalString(record, key);
+		if (direct) return direct;
+	}
+	for (const child of Object.values(record)) {
+		const match = findNestedDecimalString(child, keys, depth + 1);
+		if (match) return match;
+	}
 }
 function readDecimalString(value, key) {
-  const item = value[key];
-  if (typeof item !== "string") {
-    return void 0;
-  }
-  try {
-    return normalizeAmount(item);
-  } catch {
-    return void 0;
-  }
+	const item = value[key];
+	if (typeof item !== "string") return;
+	try {
+		return normalizeAmount(item);
+	} catch {
+		return;
+	}
 }
-export {
-  BTC_BACKEND_ID,
-  BtcAdapter,
-  defaultBtcConfirmationPolicy,
-  verifyBtcpayWebhookSignature
-};
-//# sourceMappingURL=btc.js.map
+//#endregion
+export { BTC_BACKEND_ID, BtcAdapter, defaultBtcConfirmationPolicy, verifyBtcpayWebhookSignature };
+
+//# sourceMappingURL=btc.js.map