@provex/react 1.9.2 → 1.10.0-rc.20260820232714.83636f8

package/dist/{ProvexProvider-B51CXrDO.d.cts → ProvexProvider-DY7zWiTb.d.cts}

@@ -51,8 +51,11 @@ interface UseDepositsOptions {
     refetchIntervalMs?: number;
 }
 /**
- * Get the best (lowest) conversion rate for a deposit across the main provider
- * and all sub-providers.
+ * Get the conversion rate a deposit offers for a payment method and currency.
+ *
+ * Quotes the rail's own rate and does not fall back to a sub-provider's. A rate
+ * that only exists under `zelle-chase` belongs to a payment method the buyer
+ * cannot be attested for, so quoting it prices an order that cannot complete.
  *
  * Returns 0n when the deposit has no rate for the given payment method / currency.
  */

package/dist/{ProvexProvider-B51CXrDO.d.ts → ProvexProvider-DY7zWiTb.d.ts}

@@ -51,8 +51,11 @@ interface UseDepositsOptions {
     refetchIntervalMs?: number;
 }
 /**
- * Get the best (lowest) conversion rate for a deposit across the main provider
- * and all sub-providers.
+ * Get the conversion rate a deposit offers for a payment method and currency.
+ *
+ * Quotes the rail's own rate and does not fall back to a sub-provider's. A rate
+ * that only exists under `zelle-chase` belongs to a payment method the buyer
+ * cannot be attested for, so quoting it prices an order that cannot complete.
  *
  * Returns 0n when the deposit has no rate for the given payment method / currency.
  */

package/dist/{chunk-ORPPRRER.js → chunk-NYG43ZIX.js}

@@ -4,12 +4,13 @@ import { createPublicClient, http, encodeAbiParameters, parseAbiParameters, zero
 import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
 import { SUPPORTED_CURRENCIES, tickerToContractId } from '@provex/utils/currencies';
 import { parseUnits, formatUnits } from '@provex/utils/units';
-import { providerConfigs, providerKeyToContractId, computePayeeDetailsHash, tiers, verifiablePaymentMethods, getPlatformRisk, verifierGetsKey, resolveApiProviderKey, getPaymentMethodName } from '@provex/utils/payment';
+import { providerKeyToContractId, providerConfigs, computePayeeDetailsHash, resolveRailProviderKey, tiers, verifiablePaymentMethods, getPlatformRisk, verifierGetsKey, resolveApiProviderKey, getPaymentMethodName } from '@provex/utils/payment';
 import { convertCurrencyToTokenOutput } from '@provex/utils/conversionRates';
-import { getLatestContract, reclaimSigners, getEscrowVersion } from '@provex/utils/contracts';
+import { getLatestContract, getLatestConfiguredVersion, getEscrowVersion, getConfiguredOrchestratorForEscrow, reclaimSigners, getPaymentAttestationVerifier } from '@provex/utils/contracts';
 import { encodeV3PaymentProof } from '@provex/utils';
+import { toEscrowCurrencies } from '@provex/utils/deposit';
 import { normalizeFeePrecision } from '@provex/utils/fees';
-import { V3EscrowAbi, OrchestratorAbi, PaymentVerifierRegistryAbi, UnifiedPaymentVerifierAbi, NullifierRegistryAbi, V4OrchestratorAbi } from '@provex/abis';
+import { OrchestratorAbi, escrowAbiByVersion, V3EscrowAbi, PaymentVerifierRegistryAbi, UnifiedPaymentVerifierAbi, NullifierRegistryAbi, V4OrchestratorAbi } from '@provex/abis';
 import { publicClient, getDefaultToken } from '@provex/utils/tokens';
 import { chainIdToChain } from '@provex/utils/chain';
 import { base } from 'viem/chains';
@@ -110,22 +111,9 @@ function getRate({
   currency
 }) {
   if (!deposit) return 0n;
-  const paymentConfig = providerConfigs(deposit.chainId)[paymentMethod];
-  const candidateKeys = [
-    paymentMethod,
-    ...Array.from(paymentConfig?.subProviders ?? []).map((sp) => sp.key)
-  ];
-  let minRate = null;
-  for (const key of candidateKeys) {
-    const contractId = providerKeyToContractId(key).toLowerCase();
-    const value = deposit.conversionRates.get(contractId)?.get(currency.contractId.toLowerCase());
-    if (value) {
-      if (minRate === null || value < minRate) {
-        minRate = value;
-      }
-    }
-  }
-  return minRate ?? 0n;
+  const contractId = providerKeyToContractId(paymentMethod).toLowerCase();
+  const value = deposit.conversionRates.get(contractId)?.get(currency.contractId.toLowerCase());
+  return value ?? 0n;
 }
 function toDepositInfo(deposit) {
   return {
@@ -158,11 +146,7 @@ function useDeposits(options) {
     const paymentConfig = providerConfigs(token.chainId)[paymentMethod];
     return /* @__PURE__ */ new Set([
       providerKeyToContractId(paymentMethod).toLowerCase(),
-      ...paymentConfig.v2Verifiers.map((v) => v.toLowerCase()),
-      ...Array.from(paymentConfig.subProviders).flatMap((subProvider) => [
-        providerKeyToContractId(subProvider.key).toLowerCase(),
-        ...subProvider.v2Verifiers(token.chainId).map((v) => v.toLowerCase())
-      ])
+      ...paymentConfig.v2Verifiers.map((v) => v.toLowerCase())
     ]);
   }, [token.chainId, paymentMethod]);
   const depositsQuery = useQuery({
@@ -396,82 +380,85 @@ var ProveXClient = class {
     this.onSlowSync = config.onSlowSync;
     this.apiUrl = config.apiUrl ?? defaults?.apiUrl ?? "https://app.provex.com";
     this.createDepositRaw = this.buildWritableMethod({
-      abi: V3EscrowAbi,
+      abi: () => this.getEscrowAbi(),
       contractResolver: () => this.getEscrowAddress(),
       functionName: "createDeposit",
-      argsMapper: (params) => [params]
+      argsMapper: (params) => [{
+        ...params,
+        currencies: params.currencies.map((perMethod) => toEscrowCurrencies(perMethod, this.getEscrowGeneration()))
+      }]
     });
     this.addFunds = this.buildWritableMethod({
-      abi: V3EscrowAbi,
+      abi: () => this.getEscrowAbi(),
       contractResolver: () => this.getEscrowAddress(),
       functionName: "addFunds",
       argsMapper: (params) => [params.depositId, params.amount]
     });
     this.removeFunds = this.buildWritableMethod({
-      abi: V3EscrowAbi,
+      abi: () => this.getEscrowAbi(),
       contractResolver: () => this.getEscrowAddress(),
       functionName: "removeFunds",
       argsMapper: (params) => [params.depositId, params.amount]
     });
     this.withdrawDeposit = this.buildWritableMethod({
-      abi: V3EscrowAbi,
+      abi: () => this.getEscrowAbi(),
       contractResolver: () => this.getEscrowAddress(),
       functionName: "withdrawDeposit",
       argsMapper: (params) => [params.depositId]
     });
     this.pruneExpiredIntents = this.buildWritableMethod({
-      abi: V3EscrowAbi,
+      abi: () => this.getEscrowAbi(),
       contractResolver: () => this.getEscrowAddress(),
       functionName: "pruneExpiredIntents",
       argsMapper: (params) => [params.depositId]
     });
     this.setAcceptingIntents = this.buildWritableMethod({
-      abi: V3EscrowAbi,
+      abi: () => this.getEscrowAbi(),
       contractResolver: () => this.getEscrowAddress(),
       functionName: "setAcceptingIntents",
       argsMapper: (params) => [params.depositId, params.accepting]
     });
     this.setRetainOnEmpty = this.buildWritableMethod({
-      abi: V3EscrowAbi,
+      abi: () => this.getEscrowAbi(),
       contractResolver: () => this.getEscrowAddress(),
       functionName: "setRetainOnEmpty",
       argsMapper: (params) => [params.depositId, params.retain]
     });
     this.setIntentRange = this.buildWritableMethod({
-      abi: V3EscrowAbi,
+      abi: () => this.getEscrowAbi(),
       contractResolver: () => this.getEscrowAddress(),
       functionName: "setIntentRange",
       argsMapper: (params) => [params.depositId, { min: params.min, max: params.max }]
     });
     this.setPaymentMethodActive = this.buildWritableMethod({
-      abi: V3EscrowAbi,
+      abi: () => this.getEscrowAbi(),
       contractResolver: () => this.getEscrowAddress(),
       functionName: "setPaymentMethodActive",
       argsMapper: (params) => [params.depositId, params.paymentMethod, params.active]
     });
     this.setCurrencyMinRate = this.buildWritableMethod({
-      abi: V3EscrowAbi,
+      abi: () => this.getEscrowAbi(),
       contractResolver: () => this.getEscrowAddress(),
       functionName: "setCurrencyMinRate",
       argsMapper: (params) => [params.depositId, params.paymentMethod, params.currency, params.rate]
     });
     this.addCurrencies = this.buildWritableMethod({
-      abi: V3EscrowAbi,
+      abi: () => this.getEscrowAbi(),
       contractResolver: () => this.getEscrowAddress(),
       functionName: "addCurrencies",
-      argsMapper: (params) => [params.depositId, params.paymentMethod, params.currencies]
+      argsMapper: (params) => [params.depositId, params.paymentMethod, toEscrowCurrencies(params.currencies, this.getEscrowGeneration())]
     });
     this.deactivateCurrency = this.buildWritableMethod({
-      abi: V3EscrowAbi,
+      abi: () => this.getEscrowAbi(),
       contractResolver: () => this.getEscrowAddress(),
       functionName: "deactivateCurrency",
       argsMapper: (params) => [params.depositId, params.paymentMethod, params.currencyCode]
     });
     this.addPaymentMethods = this.buildWritableMethod({
-      abi: V3EscrowAbi,
+      abi: () => this.getEscrowAbi(),
       contractResolver: () => this.getEscrowAddress(),
       functionName: "addPaymentMethods",
-      argsMapper: (params) => [params.depositId, params.paymentMethods, params.paymentMethodData, params.currencies]
+      argsMapper: (params) => [params.depositId, params.paymentMethods, params.paymentMethodData, params.currencies.map((perMethod) => toEscrowCurrencies(perMethod, this.getEscrowGeneration()))]
     });
     this.cancelIntent = this.buildWritableMethod({
       abi: OrchestratorAbi,
@@ -506,17 +493,66 @@ var ProveXClient = class {
     });
   }
   // ─── Address Resolution ──────────────────────────────────────────────────
-  /** Get the V3 escrow address for this client's chain. */
+  /**
+   * The escrow this client acts on.
+   *
+   * Callers that touch a specific deposit MUST construct the client with
+   * `escrowAddress: deposit.escrow` — the fallback below is only correct for a
+   * client that has no deposit in hand, and silently sends every write to the
+   * wrong escrow otherwise.
+   *
+   * That fallback follows the chain's current generation rather than a pinned
+   * v3. The only writes that reach it are ones with no existing deposit to
+   * name — `createDeposit` above all — and those belong on the generation the
+   * protocol is actually running, not the one it has moved off.
+   */
   getEscrowAddress() {
     if (this.escrowOverride) return this.escrowOverride;
-    const addr = getLatestContract(this.chainId, "escrow", "v3");
-    if (!addr) throw new ProveXError("VALIDATION_ERROR", `No V3 escrow found for chain ${this.chainId}`);
+    const addr = getLatestContract(this.chainId, "escrow", getLatestConfiguredVersion(this.chainId));
+    if (!addr) throw new ProveXError("VALIDATION_ERROR", `No escrow configured for chain ${this.chainId}`);
     return addr;
   }
-  /** Get the orchestrator address (cached after first read). */
+  /**
+   * The escrow's generation, used to pick the matching interface.
+   *
+   * An unrecognised address is not an error: callers may point the client at a
+   * fork or a local deployment through `escrowAddress`. Those fall back to v3,
+   * which is what this client assumed for every escrow before generations were
+   * resolved at all — so an override that worked before still works.
+   */
+  getEscrowGeneration() {
+    return getEscrowVersion(this.getEscrowAddress(), this.chainId) ?? "v3";
+  }
+  /**
+   * The escrow interface matching this client's escrow generation.
+   *
+   * EscrowV2 is not signature-compatible with the v3 escrow for every maker
+   * write — `createDeposit`, `addPaymentMethods` and `addCurrencies` each gain
+   * an oracle rate config in their currency tuple, which changes the selector.
+   * Binding one generation's interface to whatever address we resolved
+   * produces a call the contract cannot decode, and since these writes are not
+   * simulated the maker signs and pays gas for a certain revert.
+   */
+  getEscrowAbi() {
+    return escrowAbiByVersion[this.getEscrowGeneration()];
+  }
+  /**
+   * Get the orchestrator address (cached after first read).
+   *
+   * Generation decides where this comes from. v2 and v3 escrows expose
+   * `orchestrator()`; EscrowV2 authorizes through an `OrchestratorRegistry`
+   * and exposes no such function, so reading it reverts and the address has to
+   * come from configuration. Probing on-chain first would therefore break
+   * every v4 flow before the wallet ever opens.
+   */
   async getOrchestratorAddress() {
     if (this.cachedOrchestratorAddress) return this.cachedOrchestratorAddress;
     const escrow = this.getEscrowAddress();
+    const configured = getConfiguredOrchestratorForEscrow(escrow);
+    if (configured) {
+      this.cachedOrchestratorAddress = configured;
+      return configured;
+    }
     const result = await this.readContract({
       address: escrow,
       abi: V3EscrowAbi,
@@ -666,34 +702,16 @@ var ProveXClient = class {
   }
   /**
    * Convert human-readable deposit params to raw contract params.
-   * Handles provider expansion, hashing, gating service encoding, and defaults.
+   * Handles rail collapsing, hashing, gating service encoding, and defaults.
    */
   buildCreateDepositRawParams(params) {
-    const expanded = [];
-    const configs = providerConfigs(this.chainId);
-    for (const pm of params.paymentMethods) {
-      const hash = computePayeeDetailsHash(pm.payeeId);
-      const config = configs[pm.provider];
-      if (config?.subProviders && config.subProviders.size > 0) {
-        for (const sub of config.subProviders) {
-          expanded.push({
-            providerKey: sub.key,
-            payeeDetailsHash: hash,
-            currencies: pm.currencies,
-            intentGatingService: pm.intentGatingService,
-            data: pm.data
-          });
-        }
-      } else {
-        expanded.push({
-          providerKey: pm.provider,
-          payeeDetailsHash: hash,
-          currencies: pm.currencies,
-          intentGatingService: pm.intentGatingService,
-          data: pm.data
-        });
-      }
-    }
+    const collapsed = params.paymentMethods.map((pm) => ({
+      providerKey: resolveRailProviderKey(pm.provider),
+      payeeDetailsHash: computePayeeDetailsHash(pm.payeeId),
+      currencies: pm.currencies,
+      intentGatingService: pm.intentGatingService,
+      data: pm.data
+    }));
     const defaultGatingData = encodeAbiParameters(
       parseAbiParameters(["address[]"]),
       [[reclaimSigners.peerWitnessSigner, reclaimSigners.reclaimWitnessSigner]]
@@ -706,13 +724,13 @@ var ProveXClient = class {
         min: params.intentRange?.min ?? 1000000n,
         max: params.intentRange?.max ?? params.amount
       },
-      paymentMethods: expanded.map((p) => providerKeyToContractId(p.providerKey)),
-      paymentMethodData: expanded.map((p) => ({
+      paymentMethods: collapsed.map((p) => providerKeyToContractId(p.providerKey)),
+      paymentMethodData: collapsed.map((p) => ({
         intentGatingService: p.intentGatingService ?? defaultGatingService,
         payeeDetails: p.payeeDetailsHash,
         data: p.data ?? defaultGatingData
       })),
-      currencies: expanded.map(
+      currencies: collapsed.map(
         (p) => p.currencies.map((c) => ({
           code: tickerToContractId(c.code),
           minConversionRate: c.minRate
@@ -1023,7 +1041,7 @@ var ProveXClient = class {
       const to = await contractResolver(params);
       const args = argsMapper(params);
       const data = encodeFunctionData({
-        abi,
+        abi: typeof abi === "function" ? abi() : abi,
         functionName,
         args
       });
@@ -1514,16 +1532,34 @@ function useOrchestratorAddress({
   chainId,
   enabled = true
 }) {
-  return useContractRead({
+  const configuredOrchestrator = useMemo(
+    () => escrowAddress ? getConfiguredOrchestratorForEscrow(escrowAddress) : null,
+    [escrowAddress]
+  );
+  const query = useContractRead({
     address: escrowAddress,
     abi: V3EscrowAbi,
     functionName: "orchestrator",
     chainId,
     query: {
-      enabled: enabled && !!escrowAddress,
+      enabled: enabled && !!escrowAddress && !configuredOrchestrator,
       staleTime: Infinity
     }
   });
+  return useMemo(() => {
+    if (!configuredOrchestrator) return query;
+    return {
+      ...query,
+      data: configuredOrchestrator,
+      isLoading: false,
+      isPending: false,
+      isFetching: false,
+      isSuccess: true,
+      isError: false,
+      error: null,
+      status: "success"
+    };
+  }, [query, configuredOrchestrator]);
 }
 var FEE_CACHE_STALE_TIME = 60 * 60 * 1e3;
 function useProtocolFees({
@@ -1842,7 +1878,7 @@ function useProvexBuy({
   );
   const attestationBaseUrl = config.apiUrl;
   const verifyingContract = useMemo(
-    () => getLatestContract(chainId, "unifiedPaymentVerifier", "v3"),
+    () => getPaymentAttestationVerifier(chainId),
     [chainId]
   );
   const captureRequest = useMemo(() => {
@@ -2508,5 +2544,5 @@ function ProvexBuyRoot({
 }
 
 export { BrowsePhase, CommittedPhase, CompletePhase, ProveXClient, ProveXError, ProvexBuy, ProvexBuyProvider, ProvexProvider, ProvingPhase, checkMutation, checkTransactionIndexed, createApiClient, createProveXClient, getRate, getTierDisplayInfo, getTransactionGasInputs, getUserFriendlyErrorMessage, intentStatuses, isUserRejectionError, useContractRead, useDeposits, useNullifierRegistry, useOptionalProvex, useOptionalProvexPublicClient, useOptionalProvexWallet, useOrchestratorAddress, usePayeeDetails, useProtocolFeePercentage, useProtocolFees, useProveXClient, useProvex, useProvexBuy, useProvexBuyContext, useProvexPublicClient, useProvexWallet, useReputation, useReputationLimits, useSignalIntent };
-//# sourceMappingURL=chunk-ORPPRRER.js.map
-//# sourceMappingURL=chunk-ORPPRRER.js.map
+//# sourceMappingURL=chunk-NYG43ZIX.js.map
+//# sourceMappingURL=chunk-NYG43ZIX.js.map