@provex/extension-react 1.7.0 → 1.8.0-rc.20260607072829.a004ed4

package/dist/useZKTLS.d.ts

@@ -34,6 +34,22 @@ declare global {
         fetchProofs(): Promise<FetchProofsResponse>;
         openSidebar(route: string): Promise<void>;
         onMetadataMessage(fn: (data: MetadataMessageResponse) => void): () => void;
+        /**
+         * Trusted-execution on-ramp (PeerAuth v3+). The extension opens the
+         * buyer's bank in a new tab, intercepts the authenticated session, calls
+         * the zkp2p trusted-execution attestation service, and returns
+         * ready-to-send `fulfillIntent` calldata through the callback. Replaces
+         * the retired `authenticate` + `generateProof` Reclaim path.
+         *
+         * Optional: older extension builds predate the on-ramp API, so guard
+         * with a runtime presence check (`supportsOnramp`) before calling.
+         *
+         * @param queryString serialized on-ramp params (see {@link buildOnrampQuery})
+         * @param callback invoked once the prepared transaction is ready
+         */
+        onramp?(queryString: string, callback: (result: PeerOnrampPreparedTransaction) => void): void;
+        /** Retrieve a previously prepared on-ramp transaction by intent hash. */
+        getOnrampTransaction?(intentHash: string): Promise<PeerOnrampPreparedTransaction | null>;
     }
     interface Window {
         /** @deprecated Use window.peer instead */
@@ -66,6 +82,17 @@ interface MetadataMessageResponse {
     platform: ProviderKey;
     requestId: string;
     metadata: MetadataMessage[];
+    /**
+     * Present only when `authenticate` was called with `captureMode: 'buyerTee'`.
+     * Carries the bank session already encrypted toward the enclave — feed
+     * `encryptedSessionMaterial` (plus the matched transaction's index) to the
+     * trusted-execution verify endpoint. No `generateProof` call is involved.
+     */
+    buyerTeeCapture?: {
+        encryptedSessionMaterial: string;
+    };
+    /** Error surfaced by the extension during capture (e.g. missing platform). */
+    errorMessage?: string;
 }
 /** the response from the PeerAuth extension when fetching proofs */
 interface FetchProofsResponse {
@@ -101,6 +128,14 @@ type GenerateProofResponse = {
 type AuthenticationInputs = {
     actionType: ActionType;
     platform: PlatformKey;
+    /**
+     * Session capture mode. `'buyerTee'` makes the extension intercept the bank
+     * session and return it encrypted toward the trusted-execution enclave in
+     * `MetadataMessageResponse.buyerTeeCapture` — the replacement for the retired
+     * Reclaim `generateProof` path. Omit for the legacy Reclaim flow. The
+     * extension defaults the attestation service URL when this is set.
+     */
+    captureMode?: 'buyerTee' | 'sellerCredential';
 };
 /** the response from the PeerAuth extension when fetching a proof */
 interface Proof {
@@ -163,6 +198,63 @@ interface NotaryRequest {
 interface ProofResponse {
     notaryRequest: NotaryRequest;
 }
+/**
+ * Ready-to-send transaction the PeerAuth extension hands back once the
+ * trusted-execution attestation service has signed the payment. The `data`
+ * already embeds the enclave attestation, so the client signs and sends it
+ * verbatim — no client-side proof encoding or gate re-signing.
+ */
+type PeerOnrampPreparedTransaction = {
+    intentHash: Hex;
+    status: 'calldata_ready';
+    transaction: {
+        to: Hex;
+        data: Hex;
+        /** Wei, as a decimal string (the extension keeps it out of JSON-number range). */
+        value: string;
+        chainId: number;
+    };
+};
+/**
+ * Structured on-ramp inputs. The extension looks the intent up from
+ * `intentHash` (and the optional context fields) to resolve the chain,
+ * contracts, and payment platform — we never pass contract addresses.
+ */
+type PeerExtensionOnrampParams = {
+    intentHash: string;
+    referrer?: string;
+    referrerLogo?: string;
+    inputCurrency?: string;
+    inputAmount?: string | number;
+    paymentPlatform?: string;
+    depositId?: string | number | bigint;
+    toToken?: string;
+    amountUsdc?: string | number | bigint;
+    recipientAddress?: string;
+};
+/**
+ * Serialize on-ramp params into the query string the extension's `onramp`
+ * entry point expects. Mirrors the mapping `@zkp2p/sdk`'s
+ * `peerExtensionSdk.onramp` performs: every defined field becomes one query
+ * parameter, `undefined`/`null` fields are dropped, and `bigint` values are
+ * stringified.
+ */
+declare const buildOnrampQuery: (params: PeerExtensionOnrampParams) => string;
+/**
+ * Wrap a buyerTee capture (from {@link MetadataMessageResponse.buyerTeeCapture})
+ * as a `NotaryRequest` so it flows through the existing submit step, which
+ * narrows `proof` to a buyerTee proof and routes it to the enclave verify
+ * endpoint. The `index` is the matched transaction's `originalIndex` — the
+ * extension keys the captured payment on it.
+ *
+ * This replaces `generateProof` entirely for migrated providers: the session
+ * was already captured + encrypted during `authenticate({ captureMode: 'buyerTee' })`.
+ */
+declare const buildBuyerTeeNotaryRequest: ({ encryptedSessionMaterial, index, actionType, }: {
+    encryptedSessionMaterial: string;
+    index: number;
+    actionType: ActionType;
+}) => NotaryRequest;
 declare const extensionUrl = "https://chromewebstore.google.com/detail/ijpgccednehjpeclfcllnjjcmiohdjih";
 /** convert a byte array to a hex string */
 declare const byteArrayToHexString: (byteArray: number[]) => Hex;
@@ -278,6 +370,29 @@ declare const useZKTLS: () => {
     fetchProofs: () => Promise<FetchProofsResponse>;
     /** open the PeerAuth sidebar */
     openSidebar: (route: string) => Promise<void>;
+    /** Whether the connected extension exposes the trusted-execution on-ramp. */
+    supportsOnramp: () => boolean;
+    /**
+     * Begin the trusted-execution on-ramp and resolve with ready-to-send
+     * `fulfillIntent` calldata once the extension has intercepted the bank
+     * session and the zkp2p attestation service has signed the payment.
+     *
+     * The underlying extension API is callback-only with no error channel:
+     * the extension surfaces progress and failures in its own sidebar/tab,
+     * and only invokes the callback on success. The returned promise
+     * therefore stays pending until the prepared transaction arrives — the
+     * caller drives the user toward the PeerAuth window and may offer a
+     * cancel affordance rather than racing a timeout against a buyer who is
+     * still logging into their bank.
+     */
+    onramp: (params: PeerExtensionOnrampParams) => Promise<PeerOnrampPreparedTransaction>;
+    /**
+     * Retrieve a previously prepared on-ramp transaction by intent hash.
+     * Returns null when the extension lacks the API or has nothing prepared
+     * yet — usable as a poll alongside {@link onramp} to recover a result
+     * if the one-shot callback is missed.
+     */
+    getOnrampTransaction: (intentHash: string) => Promise<PeerOnrampPreparedTransaction | null>;
 };
 /**
  * Find the metadata message that matches the intent by amount.
@@ -295,4 +410,4 @@ declare const findMetadataMessage: ({ metadata, intent, token, centIsInt }: {
     centIsInt?: boolean;
 }) => MetadataMessage | null;
 
-export { type AuthenticationInputs, type ClaimInfo, type CompleteClaimData, type FetchProofsResponse, type GenerateProofInputs, type GenerateProofInputsAbstracted, type GenerateProofResponse, type GenerateProofSeriesMutations, type HexIntentGenerateProofInputs, type MetadataMessage, type MetadataMessageResponse, type NotarizedProof, type NotaryRequest, PROOF_ENCODING, type ProgressInfo, type Proof, type ProofResponse, type ReclaimProof, SeriesProgress, type SignedClaim, type Status, byteArrayToHexString, encodeProof, encodeProofAsBytes, encodeProofWithPaymentMethod, encodeTwoProofs, extensionUrl, findMetadataMessage, parseExtensionProof, useZKTLS };
+export { type AuthenticationInputs, type ClaimInfo, type CompleteClaimData, type FetchProofsResponse, type GenerateProofInputs, type GenerateProofInputsAbstracted, type GenerateProofResponse, type GenerateProofSeriesMutations, type HexIntentGenerateProofInputs, type MetadataMessage, type MetadataMessageResponse, type NotarizedProof, type NotaryRequest, PROOF_ENCODING, type PeerExtensionOnrampParams, type PeerOnrampPreparedTransaction, type ProgressInfo, type Proof, type ProofResponse, type ReclaimProof, SeriesProgress, type SignedClaim, type Status, buildBuyerTeeNotaryRequest, buildOnrampQuery, byteArrayToHexString, encodeProof, encodeProofAsBytes, encodeProofWithPaymentMethod, encodeTwoProofs, extensionUrl, findMetadataMessage, parseExtensionProof, useZKTLS };

package/dist/useZKTLS.js

@@ -1,3 +1,3 @@
-export { PROOF_ENCODING, SeriesProgress, byteArrayToHexString, encodeProof, encodeProofAsBytes, encodeProofWithPaymentMethod, encodeTwoProofs, extensionUrl, findMetadataMessage, parseExtensionProof, useZKTLS } from './chunk-W2QUSBIS.js';
+export { PROOF_ENCODING, SeriesProgress, buildBuyerTeeNotaryRequest, buildOnrampQuery, byteArrayToHexString, encodeProof, encodeProofAsBytes, encodeProofWithPaymentMethod, encodeTwoProofs, extensionUrl, findMetadataMessage, parseExtensionProof, useZKTLS } from './chunk-N47KQ7OC.js';
 //# sourceMappingURL=useZKTLS.js.map
 //# sourceMappingURL=useZKTLS.js.map

package/dist/useZKTLSContext.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useZKTLS.ts","../src/ZKTLSContext.tsx"],"names":["parseAbiParameter","createContext","useContext"],"mappings":";;;;;;;;;;AAuN8BA,uBAAkB,qMAAqM;ACtM9O,IAAM,YAAA,GAAeC,oBAA4C,MAAS,CAAA;AAY1E,SAAS,eAAA,GAAkB;AAChC,EAAA,MAAM,OAAA,GAAUC,iBAAW,YAAY,CAAA;AACvC,EAAA,IAAI,YAAY,MAAA,EAAW;AACzB,IAAA,MAAM,IAAI,MAAM,qDAAqD,CAAA;AAAA,EACvE;AACA,EAAA,OAAO,OAAA;AACT","file":"useZKTLSContext.cjs","sourcesContent":["/**\n * @fileoverview React hook and utilities for PeerAuth browser extension integration.\n *\n * The PeerAuth extension (formerly ZK-TLS) provides secure proof generation\n * for off-chain payment verification. This module provides:\n *\n * 1. Type definitions for extension API (window.peer)\n * 2. useZKTLS hook for React components\n * 3. Utility functions for transaction matching and proof encoding\n *\n * @remarks\n * The extension exposes `window.peer` (or deprecated `window.zktls`) for:\n * - Requesting connection (OAuth-like flow)\n * - Authenticating with payment providers\n * - Generating notarized proofs\n * - Fetching transaction metadata\n *\n * @see {@link ZKTLSContext} for the React context provider\n */\n\nimport { useEffect, useMemo, useState } from \"react\"\nimport { encodeAbiParameters, encodePacked, parseAbiParameter, parseUnits, type Hex } from \"viem\"\nimport { sleep } from \"@provex/utils/time\"\nimport type { IntentStruct } from \"@provex/utils/intent\"\nimport type { TokenInfo } from \"@provex/utils/tokens\"\nimport { extensionPlatforms, providers, subProviderConfigs, type ActionType, type PlatformKey, type ProviderKey, type SubProviderKey } from \"@provex/utils/payment\"\nimport { convertTokenInputToCurrency } from \"@provex/utils/conversionRates\"\n\ndeclare global {\n  interface ZKTLS {\n    requestConnection(): Promise<boolean>\n    checkConnectionStatus(): Promise<Status>\n    getVersion(): Promise<string>\n    authenticate(inputs: AuthenticationInputs): Promise<void>\n    generateProof(inputs: GenerateProofInputs): Promise<GenerateProofResponse>\n    fetchProofById(proofId: string): Promise<ProofResponse>\n    fetchProofs(): Promise<FetchProofsResponse>\n    openSidebar(route: string): Promise<void>\n    onMetadataMessage(fn: (data: MetadataMessageResponse) => void): () => void\n  }\n  interface Window {\n    /** @deprecated Use window.peer instead */\n    zktls: ZKTLS | undefined\n    /** PeerAuth extension API (replaces window.zktls) */\n    peer: ZKTLS | undefined\n  }\n}\n\n/** the status of the PeerAuth extension */\nexport type Status = 'connected' | 'disconnected' | 'pending'\n\n/** the individual metadata message sent by the PeerAuth extension */\nexport interface MetadataMessage {\n  amount: number\n  /** Currency code (e.g., 'USD', 'EUR') */\n  currency?: string\n  /**\n   * Date of the transaction.\n   * Can be a string in YYYYMMDD format, a number (YYYYMMDD or timestamp), or Date object.\n   * The actual type depends on the extension implementation.\n   */\n  date: string | number | Date\n  hidden: boolean\n  originalIndex: number\n  paymentId: number\n  recipient: string\n}\n\n/** the response from the PeerAuth extension when a metadata message is received */\nexport interface MetadataMessageResponse {\n  expiresAt: number\n  platform: ProviderKey\n  requestId: string\n  metadata: MetadataMessage[]\n}\n\n/** the response from the PeerAuth extension when fetching proofs */\nexport interface FetchProofsResponse {\n  notaryRequests: NotaryRequest[]\n}\n\n/** the inputs for the generateProof function */\nexport type GenerateProofInputsAbstracted = {\n  platform: PlatformKey\n  provider: ProviderKey\n  intentHash: Hex\n  originalIndex: number\n}\n\n/** the inputs for the generateProof function */\nexport type GenerateProofInputs = {\n  platform: ProviderKey\n  originalIndex: number\n  proofIndex?: number\n  intentHash: string\n}\n\n/**\n * inputs for the generate proof function that requires the intent hash\n * as hex to ensure it can be converted to a bigint string accurately\n */\nexport type HexIntentGenerateProofInputs = Exclude<GenerateProofInputs, 'intentHash'> & { intentHash: Hex }\n\n/** the response from the PeerAuth extension when generating a proof */\nexport type GenerateProofResponse = {\n  proofId: string\n  platform: ProviderKey\n}\n\n/** the inputs for the authenticate function */\nexport type AuthenticationInputs = {\n  actionType: ActionType\n  platform: PlatformKey\n}\n\n/** the response from the PeerAuth extension when fetching a proof */\nexport interface Proof {\n  claimInfo: ClaimInfo\n  signedClaim: SignedClaim\n  isAppclipProof: boolean\n  status: string\n}\n\n/** the response from the PeerAuth extension when fetching a proof */\nexport interface NotarizedProof {\n  claim: {\n    context: string\n    epoch: number\n    identifier: Hex\n    owner: Hex\n    parameters: string\n    provider: string\n    timestampS: number\n  },\n  signatures: {\n    attestorAddress: Hex\n    claimSignature: Record<number, number>\n    resultSignature: Record<number, number>\n  },\n}\n\n/** the claim info for a proof */\nexport interface ClaimInfo {\n  provider: string\n  parameters: string\n  context: string\n}\n\n/** the complete claim data for a proof */\nexport interface CompleteClaimData {\n  identifier: Hex\n  owner: Hex\n  timestampS: number\n  epoch: number\n}\n\n/** the signed claim for a proof */\nexport interface SignedClaim {\n  claim: CompleteClaimData\n  signatures: Hex[]\n}\n\n/** the reclaim proof for a proof */\nexport type ReclaimProof = {\n  claimInfo: ClaimInfo\n  signedClaim: SignedClaim\n  isAppclipProof: boolean\n}\n\n/** the notary request for a proof */\nexport interface NotaryRequest {\n  metadata: (string | number)[]\n  actionType: ActionType\n  id: string\n  status: string\n  timestamp: number\n  proof: NotarizedProof\n}\n\n/** the response from the PeerAuth extension when fetching a proof */\nexport interface ProofResponse {\n  notaryRequest: NotaryRequest\n}\n\nexport const extensionUrl = 'https://chromewebstore.google.com/detail/ijpgccednehjpeclfcllnjjcmiohdjih'\n\n/** convert a byte array to a hex string */\nexport const byteArrayToHexString = (byteArray: number[]): Hex => {\n  return `0x${byteArray\n    .map(byte => byte.toString(16).padStart(2, '0'))\n    .join('')}`\n}\n\n/** parse a proof object from the PeerAuth extension */\nexport const parseExtensionProof = (proofObject: NotarizedProof) => {\n  return {\n    claimInfo: {\n      provider: proofObject.claim.provider,\n      parameters: proofObject.claim.parameters,\n      context: proofObject.claim.context\n    },\n    signedClaim: {\n      claim: {\n        identifier: proofObject.claim.identifier as Hex,\n        owner: proofObject.claim.owner as Hex,\n        timestampS: proofObject.claim.timestampS,\n        epoch: proofObject.claim.epoch\n      },\n      signatures: [byteArrayToHexString(Object.values(proofObject.signatures.claimSignature))]\n    },\n    isAppclipProof: false\n  } as ReclaimProof\n}\n\n/** the abi encoding for a proof */\nexport const PROOF_ENCODING = parseAbiParameter(\"((string provider, string parameters, string context) claimInfo, ((bytes32 identifier, address owner, uint32 timestampS, uint32 epoch) claim, bytes[] signatures) signedClaim, bool isAppclipProof)\")\n\n/** encode a single proof as a bytes array */\nexport function encodeProofAsBytes(proof: ReclaimProof): Hex {\n  return encodeAbiParameters([PROOF_ENCODING], [proof])\n}\n\n/** encode two proofs to be passed to the underlying sub-provider */\nexport const encodeTwoProofs = (proof1: ReclaimProof, proof2: ReclaimProof) => {\n  return encodeAbiParameters([PROOF_ENCODING, PROOF_ENCODING], [proof1, proof2])\n}\n\n/** a high level function to encode a proof for a given provider and sub-provider */\nexport const encodeProof = ({ extensionProofs, subProvider, provider }: {\n  extensionProofs: NotarizedProof[],\n  subProvider: PlatformKey | null,\n  provider: ProviderKey\n}) => {\n  const reclaimProofs = extensionProofs.map((p) => parseExtensionProof(p))\n  if (provider === 'zelle') {\n    // move this to check the blockchain for the payment method\n    const paymentMethod = subProviderConfigs![provider]![subProvider as SubProviderKey]!.paymentMethod\n    const twoEncoded = reclaimProofs.length === 2\n      ? encodeTwoProofs(reclaimProofs[0]!, reclaimProofs[1]!)\n      : encodeProofAsBytes(reclaimProofs[0]!)\n    // select between various possible sub-providers\n    const withPaymentMethod = encodeProofWithPaymentMethod({\n      paymentMethod,\n      proof: twoEncoded,\n    })\n    return withPaymentMethod\n  }\n  const [reclaimProof] = reclaimProofs\n  return encodeProofAsBytes(reclaimProof!)\n}\n\n/**\n * wrap a proof with a payment method and proof\n * this allows us to use a single verifier as an entry point for multiple underlying sub-providers\n */\nexport const encodeProofWithPaymentMethod = ({\n  proof,\n  paymentMethod\n}: {\n  proof: Hex,\n  paymentMethod: number\n}): Hex => {\n  return encodePacked(['uint8', 'bytes'], [paymentMethod, proof])\n}\n\n/** the progress of a proof series */\nexport enum SeriesProgress {\n  Generating,\n  Polling,\n  Complete,\n}\n\nexport type ProgressInfo = {\n  progress: SeriesProgress\n  total: number\n  step: number | null\n  id: string | null\n}\n\n/** the mutations for the generate proof series function */\nexport type GenerateProofSeriesMutations = {\n  progress?: ({ progress, step, id }: ProgressInfo) => void\n  setOwnerName?: (name: string) => void\n}\n\n/** React hook to interact with the PeerAuth extension */\nexport const useZKTLS = () => {\n  const [isInitialized, setIsInitialized] = useState(false)\n  useEffect(() => {\n    const setup = () => {\n      setIsInitialized(true)\n    }\n    const eventName = 'peer#initialized'\n    if (typeof window.peer !== 'undefined') {\n      // api is available\n      setup()\n    } else {\n      window.addEventListener(eventName, setup)\n      return () => {\n        window.removeEventListener(eventName, setup)\n      }\n    }\n  }, [])\n  return useMemo(() => {\n    /** fetch a proof by its id */\n    const fetchProofById = async (proofId: string): Promise<NotaryRequest | null> => {\n      const proof = await window.peer!.fetchProofById(proofId)\n      if (proof && proof.notaryRequest) return proof.notaryRequest\n      const proofs = await window.peer!.fetchProofs()\n      const proofFromList = proofs.notaryRequests.find((p) => p.id === proofId)\n      if (proofFromList) return proofFromList\n      return null\n    }\n    /** wait for a proof to be generated */\n    const waitForProof = async (proofId: string, onCurrent?: (notaryRequest: NotaryRequest | null) => void) => {\n      let notaryRequest: NotaryRequest | null = null\n      do {\n        notaryRequest = await fetchProofById(proofId)\n        onCurrent?.(notaryRequest)\n        await sleep(1_000)\n      } while (!notaryRequest || !notaryRequest.status || notaryRequest.status === 'pending')\n      if (notaryRequest.status === 'failed' || notaryRequest.status === 'expired' || notaryRequest.status === 'cancelled' || notaryRequest.status === 'error') {\n        console.error('[waitForProof] proof terminal state:', JSON.stringify(notaryRequest, null, 2))\n        const req = notaryRequest as unknown as Record<string, unknown>\n        const detail = req.errorMessage ?? req.error ?? req.message ?? notaryRequest.status\n        throw new Error(`Proof generation failed: ${detail}`)\n      }\n      return notaryRequest\n    }\n    /** generate a proof */\n    const generateProof = async (inputs: HexIntentGenerateProofInputs): Promise<GenerateProofResponse> => {\n      return await window.peer!.generateProof({\n        proofIndex: 0,\n        ...inputs,\n        intentHash: BigInt(inputs.intentHash).toString(),\n      })\n    }\n    return {\n      /** check if the PeerAuth extension is initialized */\n      isInitialized,\n      /** request a connection to the PeerAuth extension */\n      requestConnection: async () => {\n        if (!window.peer) return false\n        return window.peer!.requestConnection()\n      },\n      /**\n       * check the connection status of the PeerAuth extension\n       * @returns the connection status\n       */\n      checkConnectionStatus: async () => {\n        return await window.peer!.checkConnectionStatus()\n      },\n      /** get the version of the PeerAuth extension */\n      getVersion: async () => {\n        return await window.peer?.getVersion()\n      },\n      /** authenticate with the PeerAuth extension */\n      authenticate: async (inputs: AuthenticationInputs) => {\n        // Create promise first to avoid race condition where message arrives before resolver is assigned\n        let resolve: (value: MetadataMessageResponse) => void\n        const promise = new Promise<MetadataMessageResponse>((resolver) => {\n          resolve = resolver\n        })\n\n        // Now set up the listener - resolve is guaranteed to be the real resolver\n        const unsub = window.peer!.onMetadataMessage((data) => {\n          if (`transfer_${data.platform}` === inputs.actionType) {\n            resolve(data)\n          }\n        })\n\n        await window.peer!.authenticate(inputs)\n\n        return await promise.then((data) => {\n          unsub()\n          return data\n        })\n      },\n      /** generate a proof */\n      generateProof,\n      /** wait for a proof to be generated */\n      waitForProof,\n      /** generate a proof series */\n      generateProofSeries: async (\n        inputs: GenerateProofInputsAbstracted,\n        { progress: progressCallback }: GenerateProofSeriesMutations = {},\n      ): Promise<NotaryRequest[]> => {\n        const { platform, provider, intentHash, originalIndex } = inputs\n        const args = {\n          platform: provider,\n          originalIndex,\n          intentHash,\n        } as const\n        // Chase requires 2 proofs (account verification + transaction)\n        // Platform is the bank name (e.g., 'chase') from extensionPlatform config\n        const isChase = platform === extensionPlatforms.CHASE\n        const isZelle = provider === providers.ZELLE\n        const expectedTotal = isZelle && isChase ? 2 : 1\n        progressCallback?.({ progress: SeriesProgress.Generating, step: 0, id: null, total: expectedTotal })\n        const genProofA = await generateProof({ ...args, proofIndex: 0 })\n        progressCallback?.({ progress: SeriesProgress.Polling, step: 0, id: genProofA.proofId, total: expectedTotal })\n        const proofA = await waitForProof(genProofA.proofId)\n        if (!isChase || !isZelle) {\n          progressCallback?.({ progress: SeriesProgress.Complete, step: null, id: null, total: expectedTotal })\n          return [proofA]\n        }\n        progressCallback?.({ progress: SeriesProgress.Generating, step: 1, id: null, total: expectedTotal })\n        const genProofB = await generateProof({ ...args, proofIndex: 1 })\n        progressCallback?.({ progress: SeriesProgress.Polling, step: 1, id: genProofB.proofId, total: expectedTotal })\n        const proofB = await waitForProof(genProofB.proofId)\n        progressCallback?.({ progress: SeriesProgress.Complete, step: null, id: null, total: expectedTotal })\n        return [proofA, proofB]\n      },\n      /** subscribe to metadata messages */\n      onMetadataMessage: (fn: (data: any) => void) => {\n        return window.peer!.onMetadataMessage(fn)\n      },\n      /** fetch a proof by its id */\n      fetchProofById,\n      /** fetch generated proofs */\n      fetchGeneratedProofs: async (genProofResponses: GenerateProofResponse[]) => {\n        return await Promise.all(genProofResponses.map((r) => fetchProofById(r.proofId)))\n      },\n      /** fetch all proofs */\n      fetchProofs: async () => {\n        return await window.peer!.fetchProofs()\n      },\n      /** open the PeerAuth sidebar */\n      openSidebar: async (route: string) => {\n        return await window.peer!.openSidebar(route)\n      },\n    }\n  }, [isInitialized])\n}\n\n/**\n * Find the metadata message that matches the intent by amount.\n * Returns the first (most recent) transaction in the metadata array that matches the expected amount.\n *\n * Simplified matching: just find transactions with the correct amount.\n * The user can manually select if multiple matches exist.\n */\nexport const findMetadataMessage = ({ metadata, intent, token, centIsInt = false }: {\n  metadata: MetadataMessage[],\n  intent: IntentStruct,\n  token: TokenInfo,\n  /** @deprecated No longer used - kept for API compatibility */\n  recipient?: string,\n  centIsInt?: boolean,\n}): MetadataMessage | null => {\n  const currencyAmount = convertTokenInputToCurrency({\n    token,\n    amountOutInt: intent.amount,\n    rate: intent.conversionRate,\n  })\n  /**\n   * Normalize an amount from the extension into a bigint in token base units.\n   *\n   * The extension sends amounts in different formats per provider:\n   * - Venmo: `\"- $1.00\"` (formatted dollar string)\n   * - Others: `100` (integer cents) or `1.00` (decimal dollars)\n   *\n   * We detect the format by checking for currency symbols or decimal points\n   * in the raw value. If present, the value is already in dollars and we\n   * skip the centIsInt division.\n   */\n  const normalizeAmount = (amount: number | string): bigint => {\n    const raw = String(amount)\n    const isFormattedDollars = /[^0-9\\-]/.test(raw) && raw.includes('.')\n    const cleaned = raw.replace(/[^0-9.]/g, '')\n    let value = parseUnits(cleaned, token.decimals)\n    if (centIsInt && !isFormattedDollars) {\n      value = value / 100n\n    }\n    return value\n  }\n\n  // Skip auto-match when manual selection is forced (dev/testing)\n  if (typeof window !== 'undefined' && (window as unknown as Record<string, unknown>).__FORCE_MANUAL_TX_SELECT__) {\n    return null\n  }\n\n  // Find the first transaction that matches the amount (first in array = most recent)\n  // Note: We ignore the hidden flag - matching is purely by amount\n  const match = metadata.find((m) => {\n    const converted = normalizeAmount(m.amount)\n    return converted === currencyAmount || converted === (currencyAmount * -1n)\n  })\n\n  if (!match) {\n    // Detect 100x scale mismatch — the most common failure mode when centIsInt\n    // is wrong for a provider. Fires loudly so it's obvious in dev/staging logs.\n    const hundredxMatch = metadata.find((m) => {\n      const converted = normalizeAmount(m.amount)\n      const abs = converted < 0n ? -converted : converted\n      return abs === currencyAmount * 100n || abs * 100n === currencyAmount\n    })\n    if (hundredxMatch) {\n      console.warn(\n        `[findMetadataMessage] tx[0] amount=${String(hundredxMatch.amount)} is 100x off from expected ${currencyAmount.toString()} — centIsInt is likely wrong for this provider (currently ${centIsInt})`\n      )\n    }\n    return null\n  }\n\n  return match\n}\n","/**\n * @fileoverview React context for PeerAuth extension state.\n *\n * Provides global access to the useZKTLS hook state throughout the\n * component tree, avoiding prop drilling for extension status.\n *\n * @see {@link useZKTLS} for the underlying hook\n */\n\nimport { createContext, useContext, type ReactNode } from 'react'\nimport { useZKTLS } from './useZKTLS'\n\n/**\n * Context type derived from useZKTLS hook return value.\n */\ntype ZKTLSContextType = ReturnType<typeof useZKTLS>\n\nexport const ZKTLSContext = createContext<ZKTLSContextType | undefined>(undefined)\n\ninterface ZKTLSProviderProps {\n  children: ReactNode\n}\n\n/**\n * Hook to consume the ZKTLS context.\n * Must be used within a ZKTLSProvider.\n *\n * @throws Error if used outside of ZKTLSProvider\n */\nexport function useZKTLSContext() {\n  const context = useContext(ZKTLSContext)\n  if (context === undefined) {\n    throw new Error('useZKTLSContext must be used within a ZKTLSProvider')\n  }\n  return context\n}\n\nexport function ZKTLSProvider({ children }: ZKTLSProviderProps) {\n  const zktlsHook = useZKTLS()\n\n  return (\n    <ZKTLSContext.Provider value={zktlsHook}>\n      {children}\n    </ZKTLSContext.Provider>\n  )\n}\n"]}
+{"version":3,"sources":["../src/useZKTLS.ts","../src/ZKTLSContext.tsx"],"names":["parseAbiParameter","createContext","useContext"],"mappings":";;;;;;;;;;AAkV8BA,uBAAkB,qMAAqM;ACjU9O,IAAM,YAAA,GAAeC,oBAA4C,MAAS,CAAA;AAY1E,SAAS,eAAA,GAAkB;AAChC,EAAA,MAAM,OAAA,GAAUC,iBAAW,YAAY,CAAA;AACvC,EAAA,IAAI,YAAY,MAAA,EAAW;AACzB,IAAA,MAAM,IAAI,MAAM,qDAAqD,CAAA;AAAA,EACvE;AACA,EAAA,OAAO,OAAA;AACT","file":"useZKTLSContext.cjs","sourcesContent":["/**\n * @fileoverview React hook and utilities for PeerAuth browser extension integration.\n *\n * The PeerAuth extension (formerly ZK-TLS) provides secure proof generation\n * for off-chain payment verification. This module provides:\n *\n * 1. Type definitions for extension API (window.peer)\n * 2. useZKTLS hook for React components\n * 3. Utility functions for transaction matching and proof encoding\n *\n * @remarks\n * The extension exposes `window.peer` (or deprecated `window.zktls`) for:\n * - Requesting connection (OAuth-like flow)\n * - Authenticating with payment providers\n * - Generating notarized proofs\n * - Fetching transaction metadata\n *\n * @see {@link ZKTLSContext} for the React context provider\n */\n\nimport { useEffect, useMemo, useState } from \"react\"\nimport { encodeAbiParameters, encodePacked, parseAbiParameter, parseUnits, type Hex } from \"viem\"\nimport { sleep } from \"@provex/utils/time\"\nimport type { IntentStruct } from \"@provex/utils/intent\"\nimport type { TokenInfo } from \"@provex/utils/tokens\"\nimport { extensionPlatforms, providers, subProviderConfigs, type ActionType, type PlatformKey, type ProviderKey, type SubProviderKey } from \"@provex/utils/payment\"\nimport { convertTokenInputToCurrency } from \"@provex/utils/conversionRates\"\n\ndeclare global {\n  interface ZKTLS {\n    requestConnection(): Promise<boolean>\n    checkConnectionStatus(): Promise<Status>\n    getVersion(): Promise<string>\n    authenticate(inputs: AuthenticationInputs): Promise<void>\n    generateProof(inputs: GenerateProofInputs): Promise<GenerateProofResponse>\n    fetchProofById(proofId: string): Promise<ProofResponse>\n    fetchProofs(): Promise<FetchProofsResponse>\n    openSidebar(route: string): Promise<void>\n    onMetadataMessage(fn: (data: MetadataMessageResponse) => void): () => void\n    /**\n     * Trusted-execution on-ramp (PeerAuth v3+). The extension opens the\n     * buyer's bank in a new tab, intercepts the authenticated session, calls\n     * the zkp2p trusted-execution attestation service, and returns\n     * ready-to-send `fulfillIntent` calldata through the callback. Replaces\n     * the retired `authenticate` + `generateProof` Reclaim path.\n     *\n     * Optional: older extension builds predate the on-ramp API, so guard\n     * with a runtime presence check (`supportsOnramp`) before calling.\n     *\n     * @param queryString serialized on-ramp params (see {@link buildOnrampQuery})\n     * @param callback invoked once the prepared transaction is ready\n     */\n    onramp?(\n      queryString: string,\n      callback: (result: PeerOnrampPreparedTransaction) => void,\n    ): void\n    /** Retrieve a previously prepared on-ramp transaction by intent hash. */\n    getOnrampTransaction?(intentHash: string): Promise<PeerOnrampPreparedTransaction | null>\n  }\n  interface Window {\n    /** @deprecated Use window.peer instead */\n    zktls: ZKTLS | undefined\n    /** PeerAuth extension API (replaces window.zktls) */\n    peer: ZKTLS | undefined\n  }\n}\n\n/** the status of the PeerAuth extension */\nexport type Status = 'connected' | 'disconnected' | 'pending'\n\n/** the individual metadata message sent by the PeerAuth extension */\nexport interface MetadataMessage {\n  amount: number\n  /** Currency code (e.g., 'USD', 'EUR') */\n  currency?: string\n  /**\n   * Date of the transaction.\n   * Can be a string in YYYYMMDD format, a number (YYYYMMDD or timestamp), or Date object.\n   * The actual type depends on the extension implementation.\n   */\n  date: string | number | Date\n  hidden: boolean\n  originalIndex: number\n  paymentId: number\n  recipient: string\n}\n\n/** the response from the PeerAuth extension when a metadata message is received */\nexport interface MetadataMessageResponse {\n  expiresAt: number\n  platform: ProviderKey\n  requestId: string\n  metadata: MetadataMessage[]\n  /**\n   * Present only when `authenticate` was called with `captureMode: 'buyerTee'`.\n   * Carries the bank session already encrypted toward the enclave — feed\n   * `encryptedSessionMaterial` (plus the matched transaction's index) to the\n   * trusted-execution verify endpoint. No `generateProof` call is involved.\n   */\n  buyerTeeCapture?: {\n    encryptedSessionMaterial: string\n  }\n  /** Error surfaced by the extension during capture (e.g. missing platform). */\n  errorMessage?: string\n}\n\n/** the response from the PeerAuth extension when fetching proofs */\nexport interface FetchProofsResponse {\n  notaryRequests: NotaryRequest[]\n}\n\n/** the inputs for the generateProof function */\nexport type GenerateProofInputsAbstracted = {\n  platform: PlatformKey\n  provider: ProviderKey\n  intentHash: Hex\n  originalIndex: number\n}\n\n/** the inputs for the generateProof function */\nexport type GenerateProofInputs = {\n  platform: ProviderKey\n  originalIndex: number\n  proofIndex?: number\n  intentHash: string\n}\n\n/**\n * inputs for the generate proof function that requires the intent hash\n * as hex to ensure it can be converted to a bigint string accurately\n */\nexport type HexIntentGenerateProofInputs = Exclude<GenerateProofInputs, 'intentHash'> & { intentHash: Hex }\n\n/** the response from the PeerAuth extension when generating a proof */\nexport type GenerateProofResponse = {\n  proofId: string\n  platform: ProviderKey\n}\n\n/** the inputs for the authenticate function */\nexport type AuthenticationInputs = {\n  actionType: ActionType\n  platform: PlatformKey\n  /**\n   * Session capture mode. `'buyerTee'` makes the extension intercept the bank\n   * session and return it encrypted toward the trusted-execution enclave in\n   * `MetadataMessageResponse.buyerTeeCapture` — the replacement for the retired\n   * Reclaim `generateProof` path. Omit for the legacy Reclaim flow. The\n   * extension defaults the attestation service URL when this is set.\n   */\n  captureMode?: 'buyerTee' | 'sellerCredential'\n}\n\n/** the response from the PeerAuth extension when fetching a proof */\nexport interface Proof {\n  claimInfo: ClaimInfo\n  signedClaim: SignedClaim\n  isAppclipProof: boolean\n  status: string\n}\n\n/** the response from the PeerAuth extension when fetching a proof */\nexport interface NotarizedProof {\n  claim: {\n    context: string\n    epoch: number\n    identifier: Hex\n    owner: Hex\n    parameters: string\n    provider: string\n    timestampS: number\n  },\n  signatures: {\n    attestorAddress: Hex\n    claimSignature: Record<number, number>\n    resultSignature: Record<number, number>\n  },\n}\n\n/** the claim info for a proof */\nexport interface ClaimInfo {\n  provider: string\n  parameters: string\n  context: string\n}\n\n/** the complete claim data for a proof */\nexport interface CompleteClaimData {\n  identifier: Hex\n  owner: Hex\n  timestampS: number\n  epoch: number\n}\n\n/** the signed claim for a proof */\nexport interface SignedClaim {\n  claim: CompleteClaimData\n  signatures: Hex[]\n}\n\n/** the reclaim proof for a proof */\nexport type ReclaimProof = {\n  claimInfo: ClaimInfo\n  signedClaim: SignedClaim\n  isAppclipProof: boolean\n}\n\n/** the notary request for a proof */\nexport interface NotaryRequest {\n  metadata: (string | number)[]\n  actionType: ActionType\n  id: string\n  status: string\n  timestamp: number\n  proof: NotarizedProof\n}\n\n/** the response from the PeerAuth extension when fetching a proof */\nexport interface ProofResponse {\n  notaryRequest: NotaryRequest\n}\n\n/**\n * Ready-to-send transaction the PeerAuth extension hands back once the\n * trusted-execution attestation service has signed the payment. The `data`\n * already embeds the enclave attestation, so the client signs and sends it\n * verbatim — no client-side proof encoding or gate re-signing.\n */\nexport type PeerOnrampPreparedTransaction = {\n  intentHash: Hex\n  status: 'calldata_ready'\n  transaction: {\n    to: Hex\n    data: Hex\n    /** Wei, as a decimal string (the extension keeps it out of JSON-number range). */\n    value: string\n    chainId: number\n  }\n}\n\n/**\n * Structured on-ramp inputs. The extension looks the intent up from\n * `intentHash` (and the optional context fields) to resolve the chain,\n * contracts, and payment platform — we never pass contract addresses.\n */\nexport type PeerExtensionOnrampParams = {\n  intentHash: string\n  referrer?: string\n  referrerLogo?: string\n  inputCurrency?: string\n  inputAmount?: string | number\n  paymentPlatform?: string\n  depositId?: string | number | bigint\n  toToken?: string\n  amountUsdc?: string | number | bigint\n  recipientAddress?: string\n}\n\n/**\n * Serialize on-ramp params into the query string the extension's `onramp`\n * entry point expects. Mirrors the mapping `@zkp2p/sdk`'s\n * `peerExtensionSdk.onramp` performs: every defined field becomes one query\n * parameter, `undefined`/`null` fields are dropped, and `bigint` values are\n * stringified.\n */\nexport const buildOnrampQuery = (params: PeerExtensionOnrampParams): string => {\n  const search = new URLSearchParams()\n  Object.entries(params).forEach(([key, value]) => {\n    if (value === undefined || value === null) return\n    search.set(key, String(value))\n  })\n  return search.toString()\n}\n\n/**\n * Wrap a buyerTee capture (from {@link MetadataMessageResponse.buyerTeeCapture})\n * as a `NotaryRequest` so it flows through the existing submit step, which\n * narrows `proof` to a buyerTee proof and routes it to the enclave verify\n * endpoint. The `index` is the matched transaction's `originalIndex` — the\n * extension keys the captured payment on it.\n *\n * This replaces `generateProof` entirely for migrated providers: the session\n * was already captured + encrypted during `authenticate({ captureMode: 'buyerTee' })`.\n */\nexport const buildBuyerTeeNotaryRequest = ({\n  encryptedSessionMaterial,\n  index,\n  actionType,\n}: {\n  encryptedSessionMaterial: string\n  index: number\n  actionType: ActionType\n}): NotaryRequest => ({\n  metadata: [],\n  actionType,\n  id: `buyer-tee-${index}`,\n  status: 'success',\n  timestamp: 0,\n  // The runtime shape is a buyerTee proof, not a Reclaim NotarizedProof; the\n  // submit step narrows it via `asBuyerTeeProof` before use.\n  proof: {\n    proofType: 'buyerTee',\n    encryptedSessionMaterial,\n    params: { index },\n  } as unknown as NotarizedProof,\n})\n\nexport const extensionUrl = 'https://chromewebstore.google.com/detail/ijpgccednehjpeclfcllnjjcmiohdjih'\n\n/** convert a byte array to a hex string */\nexport const byteArrayToHexString = (byteArray: number[]): Hex => {\n  return `0x${byteArray\n    .map(byte => byte.toString(16).padStart(2, '0'))\n    .join('')}`\n}\n\n/** parse a proof object from the PeerAuth extension */\nexport const parseExtensionProof = (proofObject: NotarizedProof) => {\n  return {\n    claimInfo: {\n      provider: proofObject.claim.provider,\n      parameters: proofObject.claim.parameters,\n      context: proofObject.claim.context\n    },\n    signedClaim: {\n      claim: {\n        identifier: proofObject.claim.identifier as Hex,\n        owner: proofObject.claim.owner as Hex,\n        timestampS: proofObject.claim.timestampS,\n        epoch: proofObject.claim.epoch\n      },\n      signatures: [byteArrayToHexString(Object.values(proofObject.signatures.claimSignature))]\n    },\n    isAppclipProof: false\n  } as ReclaimProof\n}\n\n/** the abi encoding for a proof */\nexport const PROOF_ENCODING = parseAbiParameter(\"((string provider, string parameters, string context) claimInfo, ((bytes32 identifier, address owner, uint32 timestampS, uint32 epoch) claim, bytes[] signatures) signedClaim, bool isAppclipProof)\")\n\n/** encode a single proof as a bytes array */\nexport function encodeProofAsBytes(proof: ReclaimProof): Hex {\n  return encodeAbiParameters([PROOF_ENCODING], [proof])\n}\n\n/** encode two proofs to be passed to the underlying sub-provider */\nexport const encodeTwoProofs = (proof1: ReclaimProof, proof2: ReclaimProof) => {\n  return encodeAbiParameters([PROOF_ENCODING, PROOF_ENCODING], [proof1, proof2])\n}\n\n/** a high level function to encode a proof for a given provider and sub-provider */\nexport const encodeProof = ({ extensionProofs, subProvider, provider }: {\n  extensionProofs: NotarizedProof[],\n  subProvider: PlatformKey | null,\n  provider: ProviderKey\n}) => {\n  const reclaimProofs = extensionProofs.map((p) => parseExtensionProof(p))\n  if (provider === 'zelle') {\n    // move this to check the blockchain for the payment method\n    const paymentMethod = subProviderConfigs![provider]![subProvider as SubProviderKey]!.paymentMethod\n    const twoEncoded = reclaimProofs.length === 2\n      ? encodeTwoProofs(reclaimProofs[0]!, reclaimProofs[1]!)\n      : encodeProofAsBytes(reclaimProofs[0]!)\n    // select between various possible sub-providers\n    const withPaymentMethod = encodeProofWithPaymentMethod({\n      paymentMethod,\n      proof: twoEncoded,\n    })\n    return withPaymentMethod\n  }\n  const [reclaimProof] = reclaimProofs\n  return encodeProofAsBytes(reclaimProof!)\n}\n\n/**\n * wrap a proof with a payment method and proof\n * this allows us to use a single verifier as an entry point for multiple underlying sub-providers\n */\nexport const encodeProofWithPaymentMethod = ({\n  proof,\n  paymentMethod\n}: {\n  proof: Hex,\n  paymentMethod: number\n}): Hex => {\n  return encodePacked(['uint8', 'bytes'], [paymentMethod, proof])\n}\n\n/** the progress of a proof series */\nexport enum SeriesProgress {\n  Generating,\n  Polling,\n  Complete,\n}\n\nexport type ProgressInfo = {\n  progress: SeriesProgress\n  total: number\n  step: number | null\n  id: string | null\n}\n\n/** the mutations for the generate proof series function */\nexport type GenerateProofSeriesMutations = {\n  progress?: ({ progress, step, id }: ProgressInfo) => void\n  setOwnerName?: (name: string) => void\n}\n\n/** React hook to interact with the PeerAuth extension */\nexport const useZKTLS = () => {\n  const [isInitialized, setIsInitialized] = useState(false)\n  useEffect(() => {\n    const setup = () => {\n      setIsInitialized(true)\n    }\n    const eventName = 'peer#initialized'\n    if (typeof window.peer !== 'undefined') {\n      // api is available\n      setup()\n    } else {\n      window.addEventListener(eventName, setup)\n      return () => {\n        window.removeEventListener(eventName, setup)\n      }\n    }\n  }, [])\n  return useMemo(() => {\n    /** fetch a proof by its id */\n    const fetchProofById = async (proofId: string): Promise<NotaryRequest | null> => {\n      const proof = await window.peer!.fetchProofById(proofId)\n      if (proof && proof.notaryRequest) return proof.notaryRequest\n      const proofs = await window.peer!.fetchProofs()\n      const proofFromList = proofs.notaryRequests.find((p) => p.id === proofId)\n      if (proofFromList) return proofFromList\n      return null\n    }\n    /** wait for a proof to be generated */\n    const waitForProof = async (proofId: string, onCurrent?: (notaryRequest: NotaryRequest | null) => void) => {\n      let notaryRequest: NotaryRequest | null = null\n      do {\n        notaryRequest = await fetchProofById(proofId)\n        onCurrent?.(notaryRequest)\n        await sleep(1_000)\n      } while (!notaryRequest || !notaryRequest.status || notaryRequest.status === 'pending')\n      if (notaryRequest.status === 'failed' || notaryRequest.status === 'expired' || notaryRequest.status === 'cancelled' || notaryRequest.status === 'error') {\n        console.error('[waitForProof] proof terminal state:', JSON.stringify(notaryRequest, null, 2))\n        const req = notaryRequest as unknown as Record<string, unknown>\n        const detail = req.errorMessage ?? req.error ?? req.message ?? notaryRequest.status\n        throw new Error(`Proof generation failed: ${detail}`)\n      }\n      return notaryRequest\n    }\n    /** generate a proof */\n    const generateProof = async (inputs: HexIntentGenerateProofInputs): Promise<GenerateProofResponse> => {\n      return await window.peer!.generateProof({\n        proofIndex: 0,\n        ...inputs,\n        intentHash: BigInt(inputs.intentHash).toString(),\n      })\n    }\n    return {\n      /** check if the PeerAuth extension is initialized */\n      isInitialized,\n      /** request a connection to the PeerAuth extension */\n      requestConnection: async () => {\n        if (!window.peer) return false\n        return window.peer!.requestConnection()\n      },\n      /**\n       * check the connection status of the PeerAuth extension\n       * @returns the connection status\n       */\n      checkConnectionStatus: async () => {\n        return await window.peer!.checkConnectionStatus()\n      },\n      /** get the version of the PeerAuth extension */\n      getVersion: async () => {\n        return await window.peer?.getVersion()\n      },\n      /** authenticate with the PeerAuth extension */\n      authenticate: async (inputs: AuthenticationInputs) => {\n        // Create promise first to avoid race condition where message arrives before resolver is assigned\n        let resolve: (value: MetadataMessageResponse) => void\n        const promise = new Promise<MetadataMessageResponse>((resolver) => {\n          resolve = resolver\n        })\n\n        // Now set up the listener - resolve is guaranteed to be the real resolver\n        const unsub = window.peer!.onMetadataMessage((data) => {\n          if (`transfer_${data.platform}` === inputs.actionType) {\n            resolve(data)\n          }\n        })\n\n        await window.peer!.authenticate(inputs)\n\n        return await promise.then((data) => {\n          unsub()\n          return data\n        })\n      },\n      /** generate a proof */\n      generateProof,\n      /** wait for a proof to be generated */\n      waitForProof,\n      /** generate a proof series */\n      generateProofSeries: async (\n        inputs: GenerateProofInputsAbstracted,\n        { progress: progressCallback }: GenerateProofSeriesMutations = {},\n      ): Promise<NotaryRequest[]> => {\n        const { platform, provider, intentHash, originalIndex } = inputs\n        const args = {\n          platform: provider,\n          originalIndex,\n          intentHash,\n        } as const\n        // Chase requires 2 proofs (account verification + transaction)\n        // Platform is the bank name (e.g., 'chase') from extensionPlatform config\n        const isChase = platform === extensionPlatforms.CHASE\n        const isZelle = provider === providers.ZELLE\n        const expectedTotal = isZelle && isChase ? 2 : 1\n        progressCallback?.({ progress: SeriesProgress.Generating, step: 0, id: null, total: expectedTotal })\n        const genProofA = await generateProof({ ...args, proofIndex: 0 })\n        progressCallback?.({ progress: SeriesProgress.Polling, step: 0, id: genProofA.proofId, total: expectedTotal })\n        const proofA = await waitForProof(genProofA.proofId)\n        if (!isChase || !isZelle) {\n          progressCallback?.({ progress: SeriesProgress.Complete, step: null, id: null, total: expectedTotal })\n          return [proofA]\n        }\n        progressCallback?.({ progress: SeriesProgress.Generating, step: 1, id: null, total: expectedTotal })\n        const genProofB = await generateProof({ ...args, proofIndex: 1 })\n        progressCallback?.({ progress: SeriesProgress.Polling, step: 1, id: genProofB.proofId, total: expectedTotal })\n        const proofB = await waitForProof(genProofB.proofId)\n        progressCallback?.({ progress: SeriesProgress.Complete, step: null, id: null, total: expectedTotal })\n        return [proofA, proofB]\n      },\n      /** subscribe to metadata messages */\n      onMetadataMessage: (fn: (data: any) => void) => {\n        return window.peer!.onMetadataMessage(fn)\n      },\n      /** fetch a proof by its id */\n      fetchProofById,\n      /** fetch generated proofs */\n      fetchGeneratedProofs: async (genProofResponses: GenerateProofResponse[]) => {\n        return await Promise.all(genProofResponses.map((r) => fetchProofById(r.proofId)))\n      },\n      /** fetch all proofs */\n      fetchProofs: async () => {\n        return await window.peer!.fetchProofs()\n      },\n      /** open the PeerAuth sidebar */\n      openSidebar: async (route: string) => {\n        return await window.peer!.openSidebar(route)\n      },\n      /** Whether the connected extension exposes the trusted-execution on-ramp. */\n      supportsOnramp: (): boolean => typeof window.peer?.onramp === 'function',\n      /**\n       * Begin the trusted-execution on-ramp and resolve with ready-to-send\n       * `fulfillIntent` calldata once the extension has intercepted the bank\n       * session and the zkp2p attestation service has signed the payment.\n       *\n       * The underlying extension API is callback-only with no error channel:\n       * the extension surfaces progress and failures in its own sidebar/tab,\n       * and only invokes the callback on success. The returned promise\n       * therefore stays pending until the prepared transaction arrives — the\n       * caller drives the user toward the PeerAuth window and may offer a\n       * cancel affordance rather than racing a timeout against a buyer who is\n       * still logging into their bank.\n       */\n      onramp: async (\n        params: PeerExtensionOnrampParams,\n      ): Promise<PeerOnrampPreparedTransaction> => {\n        if (typeof window.peer?.onramp !== 'function') {\n          throw new Error(\n            'This PeerAuth extension version does not support the trusted-execution on-ramp. Please update the extension.',\n          )\n        }\n        const queryString = buildOnrampQuery(params)\n        return new Promise<PeerOnrampPreparedTransaction>((resolve) => {\n          window.peer!.onramp!(queryString, resolve)\n        })\n      },\n      /**\n       * Retrieve a previously prepared on-ramp transaction by intent hash.\n       * Returns null when the extension lacks the API or has nothing prepared\n       * yet — usable as a poll alongside {@link onramp} to recover a result\n       * if the one-shot callback is missed.\n       */\n      getOnrampTransaction: async (\n        intentHash: string,\n      ): Promise<PeerOnrampPreparedTransaction | null> => {\n        if (typeof window.peer?.getOnrampTransaction !== 'function') return null\n        return window.peer.getOnrampTransaction(intentHash)\n      },\n    }\n  }, [isInitialized])\n}\n\n/**\n * Find the metadata message that matches the intent by amount.\n * Returns the first (most recent) transaction in the metadata array that matches the expected amount.\n *\n * Simplified matching: just find transactions with the correct amount.\n * The user can manually select if multiple matches exist.\n */\nexport const findMetadataMessage = ({ metadata, intent, token, centIsInt = false }: {\n  metadata: MetadataMessage[],\n  intent: IntentStruct,\n  token: TokenInfo,\n  /** @deprecated No longer used - kept for API compatibility */\n  recipient?: string,\n  centIsInt?: boolean,\n}): MetadataMessage | null => {\n  const currencyAmount = convertTokenInputToCurrency({\n    token,\n    amountOutInt: intent.amount,\n    rate: intent.conversionRate,\n  })\n  /**\n   * Normalize an amount from the extension into a bigint in token base units.\n   *\n   * The extension sends amounts in different formats per provider:\n   * - Venmo: `\"- $1.00\"` (formatted dollar string)\n   * - Others: `100` (integer cents) or `1.00` (decimal dollars)\n   *\n   * We detect the format by checking for currency symbols or decimal points\n   * in the raw value. If present, the value is already in dollars and we\n   * skip the centIsInt division.\n   */\n  const normalizeAmount = (amount: number | string): bigint => {\n    const raw = String(amount)\n    const isFormattedDollars = /[^0-9\\-]/.test(raw) && raw.includes('.')\n    const cleaned = raw.replace(/[^0-9.]/g, '')\n    let value = parseUnits(cleaned, token.decimals)\n    if (centIsInt && !isFormattedDollars) {\n      value = value / 100n\n    }\n    return value\n  }\n\n  // Skip auto-match when manual selection is forced (dev/testing)\n  if (typeof window !== 'undefined' && (window as unknown as Record<string, unknown>).__FORCE_MANUAL_TX_SELECT__) {\n    return null\n  }\n\n  // Find the first transaction that matches the amount (first in array = most recent)\n  // Note: We ignore the hidden flag - matching is purely by amount\n  const match = metadata.find((m) => {\n    const converted = normalizeAmount(m.amount)\n    return converted === currencyAmount || converted === (currencyAmount * -1n)\n  })\n\n  if (!match) {\n    // Detect 100x scale mismatch — the most common failure mode when centIsInt\n    // is wrong for a provider. Fires loudly so it's obvious in dev/staging logs.\n    const hundredxMatch = metadata.find((m) => {\n      const converted = normalizeAmount(m.amount)\n      const abs = converted < 0n ? -converted : converted\n      return abs === currencyAmount * 100n || abs * 100n === currencyAmount\n    })\n    if (hundredxMatch) {\n      console.warn(\n        `[findMetadataMessage] tx[0] amount=${String(hundredxMatch.amount)} is 100x off from expected ${currencyAmount.toString()} — centIsInt is likely wrong for this provider (currently ${centIsInt})`\n      )\n    }\n    return null\n  }\n\n  return match\n}\n","/**\n * @fileoverview React context for PeerAuth extension state.\n *\n * Provides global access to the useZKTLS hook state throughout the\n * component tree, avoiding prop drilling for extension status.\n *\n * @see {@link useZKTLS} for the underlying hook\n */\n\nimport { createContext, useContext, type ReactNode } from 'react'\nimport { useZKTLS } from './useZKTLS'\n\n/**\n * Context type derived from useZKTLS hook return value.\n */\ntype ZKTLSContextType = ReturnType<typeof useZKTLS>\n\nexport const ZKTLSContext = createContext<ZKTLSContextType | undefined>(undefined)\n\ninterface ZKTLSProviderProps {\n  children: ReactNode\n}\n\n/**\n * Hook to consume the ZKTLS context.\n * Must be used within a ZKTLSProvider.\n *\n * @throws Error if used outside of ZKTLSProvider\n */\nexport function useZKTLSContext() {\n  const context = useContext(ZKTLSContext)\n  if (context === undefined) {\n    throw new Error('useZKTLSContext must be used within a ZKTLSProvider')\n  }\n  return context\n}\n\nexport function ZKTLSProvider({ children }: ZKTLSProviderProps) {\n  const zktlsHook = useZKTLS()\n\n  return (\n    <ZKTLSContext.Provider value={zktlsHook}>\n      {children}\n    </ZKTLSContext.Provider>\n  )\n}\n"]}

package/dist/useZKTLSContext.js

@@ -1,4 +1,4 @@
-export { useZKTLSContext } from './chunk-VDCCIS6C.js';
-import './chunk-W2QUSBIS.js';
+export { useZKTLSContext } from './chunk-OC5KRTNW.js';
+import './chunk-N47KQ7OC.js';
 //# sourceMappingURL=useZKTLSContext.js.map
 //# sourceMappingURL=useZKTLSContext.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@provex/extension-react",
-  "version": "1.7.0",
+  "version": "1.8.0-rc.20260607072829.a004ed4",
   "description": "React hooks and context for the PeerAuth browser extension (zkTLS proof generation)",
   "type": "module",
   "repository": {
@@ -48,7 +48,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@provex/utils": "1.7.0"
+    "@provex/utils": "1.8.0-rc.20260607072829.a004ed4"
   },
   "peerDependencies": {
     "react": "^18.0.0",

package/dist/chunk-W2QUSBIS.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/useZKTLS.ts"],"names":["SeriesProgress"],"mappings":"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","file":"chunk-W2QUSBIS.js","sourcesContent":["/**\n * @fileoverview React hook and utilities for PeerAuth browser extension integration.\n *\n * The PeerAuth extension (formerly ZK-TLS) provides secure proof generation\n * for off-chain payment verification. This module provides:\n *\n * 1. Type definitions for extension API (window.peer)\n * 2. useZKTLS hook for React components\n * 3. Utility functions for transaction matching and proof encoding\n *\n * @remarks\n * The extension exposes `window.peer` (or deprecated `window.zktls`) for:\n * - Requesting connection (OAuth-like flow)\n * - Authenticating with payment providers\n * - Generating notarized proofs\n * - Fetching transaction metadata\n *\n * @see {@link ZKTLSContext} for the React context provider\n */\n\nimport { useEffect, useMemo, useState } from \"react\"\nimport { encodeAbiParameters, encodePacked, parseAbiParameter, parseUnits, type Hex } from \"viem\"\nimport { sleep } from \"@provex/utils/time\"\nimport type { IntentStruct } from \"@provex/utils/intent\"\nimport type { TokenInfo } from \"@provex/utils/tokens\"\nimport { extensionPlatforms, providers, subProviderConfigs, type ActionType, type PlatformKey, type ProviderKey, type SubProviderKey } from \"@provex/utils/payment\"\nimport { convertTokenInputToCurrency } from \"@provex/utils/conversionRates\"\n\ndeclare global {\n  interface ZKTLS {\n    requestConnection(): Promise<boolean>\n    checkConnectionStatus(): Promise<Status>\n    getVersion(): Promise<string>\n    authenticate(inputs: AuthenticationInputs): Promise<void>\n    generateProof(inputs: GenerateProofInputs): Promise<GenerateProofResponse>\n    fetchProofById(proofId: string): Promise<ProofResponse>\n    fetchProofs(): Promise<FetchProofsResponse>\n    openSidebar(route: string): Promise<void>\n    onMetadataMessage(fn: (data: MetadataMessageResponse) => void): () => void\n  }\n  interface Window {\n    /** @deprecated Use window.peer instead */\n    zktls: ZKTLS | undefined\n    /** PeerAuth extension API (replaces window.zktls) */\n    peer: ZKTLS | undefined\n  }\n}\n\n/** the status of the PeerAuth extension */\nexport type Status = 'connected' | 'disconnected' | 'pending'\n\n/** the individual metadata message sent by the PeerAuth extension */\nexport interface MetadataMessage {\n  amount: number\n  /** Currency code (e.g., 'USD', 'EUR') */\n  currency?: string\n  /**\n   * Date of the transaction.\n   * Can be a string in YYYYMMDD format, a number (YYYYMMDD or timestamp), or Date object.\n   * The actual type depends on the extension implementation.\n   */\n  date: string | number | Date\n  hidden: boolean\n  originalIndex: number\n  paymentId: number\n  recipient: string\n}\n\n/** the response from the PeerAuth extension when a metadata message is received */\nexport interface MetadataMessageResponse {\n  expiresAt: number\n  platform: ProviderKey\n  requestId: string\n  metadata: MetadataMessage[]\n}\n\n/** the response from the PeerAuth extension when fetching proofs */\nexport interface FetchProofsResponse {\n  notaryRequests: NotaryRequest[]\n}\n\n/** the inputs for the generateProof function */\nexport type GenerateProofInputsAbstracted = {\n  platform: PlatformKey\n  provider: ProviderKey\n  intentHash: Hex\n  originalIndex: number\n}\n\n/** the inputs for the generateProof function */\nexport type GenerateProofInputs = {\n  platform: ProviderKey\n  originalIndex: number\n  proofIndex?: number\n  intentHash: string\n}\n\n/**\n * inputs for the generate proof function that requires the intent hash\n * as hex to ensure it can be converted to a bigint string accurately\n */\nexport type HexIntentGenerateProofInputs = Exclude<GenerateProofInputs, 'intentHash'> & { intentHash: Hex }\n\n/** the response from the PeerAuth extension when generating a proof */\nexport type GenerateProofResponse = {\n  proofId: string\n  platform: ProviderKey\n}\n\n/** the inputs for the authenticate function */\nexport type AuthenticationInputs = {\n  actionType: ActionType\n  platform: PlatformKey\n}\n\n/** the response from the PeerAuth extension when fetching a proof */\nexport interface Proof {\n  claimInfo: ClaimInfo\n  signedClaim: SignedClaim\n  isAppclipProof: boolean\n  status: string\n}\n\n/** the response from the PeerAuth extension when fetching a proof */\nexport interface NotarizedProof {\n  claim: {\n    context: string\n    epoch: number\n    identifier: Hex\n    owner: Hex\n    parameters: string\n    provider: string\n    timestampS: number\n  },\n  signatures: {\n    attestorAddress: Hex\n    claimSignature: Record<number, number>\n    resultSignature: Record<number, number>\n  },\n}\n\n/** the claim info for a proof */\nexport interface ClaimInfo {\n  provider: string\n  parameters: string\n  context: string\n}\n\n/** the complete claim data for a proof */\nexport interface CompleteClaimData {\n  identifier: Hex\n  owner: Hex\n  timestampS: number\n  epoch: number\n}\n\n/** the signed claim for a proof */\nexport interface SignedClaim {\n  claim: CompleteClaimData\n  signatures: Hex[]\n}\n\n/** the reclaim proof for a proof */\nexport type ReclaimProof = {\n  claimInfo: ClaimInfo\n  signedClaim: SignedClaim\n  isAppclipProof: boolean\n}\n\n/** the notary request for a proof */\nexport interface NotaryRequest {\n  metadata: (string | number)[]\n  actionType: ActionType\n  id: string\n  status: string\n  timestamp: number\n  proof: NotarizedProof\n}\n\n/** the response from the PeerAuth extension when fetching a proof */\nexport interface ProofResponse {\n  notaryRequest: NotaryRequest\n}\n\nexport const extensionUrl = 'https://chromewebstore.google.com/detail/ijpgccednehjpeclfcllnjjcmiohdjih'\n\n/** convert a byte array to a hex string */\nexport const byteArrayToHexString = (byteArray: number[]): Hex => {\n  return `0x${byteArray\n    .map(byte => byte.toString(16).padStart(2, '0'))\n    .join('')}`\n}\n\n/** parse a proof object from the PeerAuth extension */\nexport const parseExtensionProof = (proofObject: NotarizedProof) => {\n  return {\n    claimInfo: {\n      provider: proofObject.claim.provider,\n      parameters: proofObject.claim.parameters,\n      context: proofObject.claim.context\n    },\n    signedClaim: {\n      claim: {\n        identifier: proofObject.claim.identifier as Hex,\n        owner: proofObject.claim.owner as Hex,\n        timestampS: proofObject.claim.timestampS,\n        epoch: proofObject.claim.epoch\n      },\n      signatures: [byteArrayToHexString(Object.values(proofObject.signatures.claimSignature))]\n    },\n    isAppclipProof: false\n  } as ReclaimProof\n}\n\n/** the abi encoding for a proof */\nexport const PROOF_ENCODING = parseAbiParameter(\"((string provider, string parameters, string context) claimInfo, ((bytes32 identifier, address owner, uint32 timestampS, uint32 epoch) claim, bytes[] signatures) signedClaim, bool isAppclipProof)\")\n\n/** encode a single proof as a bytes array */\nexport function encodeProofAsBytes(proof: ReclaimProof): Hex {\n  return encodeAbiParameters([PROOF_ENCODING], [proof])\n}\n\n/** encode two proofs to be passed to the underlying sub-provider */\nexport const encodeTwoProofs = (proof1: ReclaimProof, proof2: ReclaimProof) => {\n  return encodeAbiParameters([PROOF_ENCODING, PROOF_ENCODING], [proof1, proof2])\n}\n\n/** a high level function to encode a proof for a given provider and sub-provider */\nexport const encodeProof = ({ extensionProofs, subProvider, provider }: {\n  extensionProofs: NotarizedProof[],\n  subProvider: PlatformKey | null,\n  provider: ProviderKey\n}) => {\n  const reclaimProofs = extensionProofs.map((p) => parseExtensionProof(p))\n  if (provider === 'zelle') {\n    // move this to check the blockchain for the payment method\n    const paymentMethod = subProviderConfigs![provider]![subProvider as SubProviderKey]!.paymentMethod\n    const twoEncoded = reclaimProofs.length === 2\n      ? encodeTwoProofs(reclaimProofs[0]!, reclaimProofs[1]!)\n      : encodeProofAsBytes(reclaimProofs[0]!)\n    // select between various possible sub-providers\n    const withPaymentMethod = encodeProofWithPaymentMethod({\n      paymentMethod,\n      proof: twoEncoded,\n    })\n    return withPaymentMethod\n  }\n  const [reclaimProof] = reclaimProofs\n  return encodeProofAsBytes(reclaimProof!)\n}\n\n/**\n * wrap a proof with a payment method and proof\n * this allows us to use a single verifier as an entry point for multiple underlying sub-providers\n */\nexport const encodeProofWithPaymentMethod = ({\n  proof,\n  paymentMethod\n}: {\n  proof: Hex,\n  paymentMethod: number\n}): Hex => {\n  return encodePacked(['uint8', 'bytes'], [paymentMethod, proof])\n}\n\n/** the progress of a proof series */\nexport enum SeriesProgress {\n  Generating,\n  Polling,\n  Complete,\n}\n\nexport type ProgressInfo = {\n  progress: SeriesProgress\n  total: number\n  step: number | null\n  id: string | null\n}\n\n/** the mutations for the generate proof series function */\nexport type GenerateProofSeriesMutations = {\n  progress?: ({ progress, step, id }: ProgressInfo) => void\n  setOwnerName?: (name: string) => void\n}\n\n/** React hook to interact with the PeerAuth extension */\nexport const useZKTLS = () => {\n  const [isInitialized, setIsInitialized] = useState(false)\n  useEffect(() => {\n    const setup = () => {\n      setIsInitialized(true)\n    }\n    const eventName = 'peer#initialized'\n    if (typeof window.peer !== 'undefined') {\n      // api is available\n      setup()\n    } else {\n      window.addEventListener(eventName, setup)\n      return () => {\n        window.removeEventListener(eventName, setup)\n      }\n    }\n  }, [])\n  return useMemo(() => {\n    /** fetch a proof by its id */\n    const fetchProofById = async (proofId: string): Promise<NotaryRequest | null> => {\n      const proof = await window.peer!.fetchProofById(proofId)\n      if (proof && proof.notaryRequest) return proof.notaryRequest\n      const proofs = await window.peer!.fetchProofs()\n      const proofFromList = proofs.notaryRequests.find((p) => p.id === proofId)\n      if (proofFromList) return proofFromList\n      return null\n    }\n    /** wait for a proof to be generated */\n    const waitForProof = async (proofId: string, onCurrent?: (notaryRequest: NotaryRequest | null) => void) => {\n      let notaryRequest: NotaryRequest | null = null\n      do {\n        notaryRequest = await fetchProofById(proofId)\n        onCurrent?.(notaryRequest)\n        await sleep(1_000)\n      } while (!notaryRequest || !notaryRequest.status || notaryRequest.status === 'pending')\n      if (notaryRequest.status === 'failed' || notaryRequest.status === 'expired' || notaryRequest.status === 'cancelled' || notaryRequest.status === 'error') {\n        console.error('[waitForProof] proof terminal state:', JSON.stringify(notaryRequest, null, 2))\n        const req = notaryRequest as unknown as Record<string, unknown>\n        const detail = req.errorMessage ?? req.error ?? req.message ?? notaryRequest.status\n        throw new Error(`Proof generation failed: ${detail}`)\n      }\n      return notaryRequest\n    }\n    /** generate a proof */\n    const generateProof = async (inputs: HexIntentGenerateProofInputs): Promise<GenerateProofResponse> => {\n      return await window.peer!.generateProof({\n        proofIndex: 0,\n        ...inputs,\n        intentHash: BigInt(inputs.intentHash).toString(),\n      })\n    }\n    return {\n      /** check if the PeerAuth extension is initialized */\n      isInitialized,\n      /** request a connection to the PeerAuth extension */\n      requestConnection: async () => {\n        if (!window.peer) return false\n        return window.peer!.requestConnection()\n      },\n      /**\n       * check the connection status of the PeerAuth extension\n       * @returns the connection status\n       */\n      checkConnectionStatus: async () => {\n        return await window.peer!.checkConnectionStatus()\n      },\n      /** get the version of the PeerAuth extension */\n      getVersion: async () => {\n        return await window.peer?.getVersion()\n      },\n      /** authenticate with the PeerAuth extension */\n      authenticate: async (inputs: AuthenticationInputs) => {\n        // Create promise first to avoid race condition where message arrives before resolver is assigned\n        let resolve: (value: MetadataMessageResponse) => void\n        const promise = new Promise<MetadataMessageResponse>((resolver) => {\n          resolve = resolver\n        })\n\n        // Now set up the listener - resolve is guaranteed to be the real resolver\n        const unsub = window.peer!.onMetadataMessage((data) => {\n          if (`transfer_${data.platform}` === inputs.actionType) {\n            resolve(data)\n          }\n        })\n\n        await window.peer!.authenticate(inputs)\n\n        return await promise.then((data) => {\n          unsub()\n          return data\n        })\n      },\n      /** generate a proof */\n      generateProof,\n      /** wait for a proof to be generated */\n      waitForProof,\n      /** generate a proof series */\n      generateProofSeries: async (\n        inputs: GenerateProofInputsAbstracted,\n        { progress: progressCallback }: GenerateProofSeriesMutations = {},\n      ): Promise<NotaryRequest[]> => {\n        const { platform, provider, intentHash, originalIndex } = inputs\n        const args = {\n          platform: provider,\n          originalIndex,\n          intentHash,\n        } as const\n        // Chase requires 2 proofs (account verification + transaction)\n        // Platform is the bank name (e.g., 'chase') from extensionPlatform config\n        const isChase = platform === extensionPlatforms.CHASE\n        const isZelle = provider === providers.ZELLE\n        const expectedTotal = isZelle && isChase ? 2 : 1\n        progressCallback?.({ progress: SeriesProgress.Generating, step: 0, id: null, total: expectedTotal })\n        const genProofA = await generateProof({ ...args, proofIndex: 0 })\n        progressCallback?.({ progress: SeriesProgress.Polling, step: 0, id: genProofA.proofId, total: expectedTotal })\n        const proofA = await waitForProof(genProofA.proofId)\n        if (!isChase || !isZelle) {\n          progressCallback?.({ progress: SeriesProgress.Complete, step: null, id: null, total: expectedTotal })\n          return [proofA]\n        }\n        progressCallback?.({ progress: SeriesProgress.Generating, step: 1, id: null, total: expectedTotal })\n        const genProofB = await generateProof({ ...args, proofIndex: 1 })\n        progressCallback?.({ progress: SeriesProgress.Polling, step: 1, id: genProofB.proofId, total: expectedTotal })\n        const proofB = await waitForProof(genProofB.proofId)\n        progressCallback?.({ progress: SeriesProgress.Complete, step: null, id: null, total: expectedTotal })\n        return [proofA, proofB]\n      },\n      /** subscribe to metadata messages */\n      onMetadataMessage: (fn: (data: any) => void) => {\n        return window.peer!.onMetadataMessage(fn)\n      },\n      /** fetch a proof by its id */\n      fetchProofById,\n      /** fetch generated proofs */\n      fetchGeneratedProofs: async (genProofResponses: GenerateProofResponse[]) => {\n        return await Promise.all(genProofResponses.map((r) => fetchProofById(r.proofId)))\n      },\n      /** fetch all proofs */\n      fetchProofs: async () => {\n        return await window.peer!.fetchProofs()\n      },\n      /** open the PeerAuth sidebar */\n      openSidebar: async (route: string) => {\n        return await window.peer!.openSidebar(route)\n      },\n    }\n  }, [isInitialized])\n}\n\n/**\n * Find the metadata message that matches the intent by amount.\n * Returns the first (most recent) transaction in the metadata array that matches the expected amount.\n *\n * Simplified matching: just find transactions with the correct amount.\n * The user can manually select if multiple matches exist.\n */\nexport const findMetadataMessage = ({ metadata, intent, token, centIsInt = false }: {\n  metadata: MetadataMessage[],\n  intent: IntentStruct,\n  token: TokenInfo,\n  /** @deprecated No longer used - kept for API compatibility */\n  recipient?: string,\n  centIsInt?: boolean,\n}): MetadataMessage | null => {\n  const currencyAmount = convertTokenInputToCurrency({\n    token,\n    amountOutInt: intent.amount,\n    rate: intent.conversionRate,\n  })\n  /**\n   * Normalize an amount from the extension into a bigint in token base units.\n   *\n   * The extension sends amounts in different formats per provider:\n   * - Venmo: `\"- $1.00\"` (formatted dollar string)\n   * - Others: `100` (integer cents) or `1.00` (decimal dollars)\n   *\n   * We detect the format by checking for currency symbols or decimal points\n   * in the raw value. If present, the value is already in dollars and we\n   * skip the centIsInt division.\n   */\n  const normalizeAmount = (amount: number | string): bigint => {\n    const raw = String(amount)\n    const isFormattedDollars = /[^0-9\\-]/.test(raw) && raw.includes('.')\n    const cleaned = raw.replace(/[^0-9.]/g, '')\n    let value = parseUnits(cleaned, token.decimals)\n    if (centIsInt && !isFormattedDollars) {\n      value = value / 100n\n    }\n    return value\n  }\n\n  // Skip auto-match when manual selection is forced (dev/testing)\n  if (typeof window !== 'undefined' && (window as unknown as Record<string, unknown>).__FORCE_MANUAL_TX_SELECT__) {\n    return null\n  }\n\n  // Find the first transaction that matches the amount (first in array = most recent)\n  // Note: We ignore the hidden flag - matching is purely by amount\n  const match = metadata.find((m) => {\n    const converted = normalizeAmount(m.amount)\n    return converted === currencyAmount || converted === (currencyAmount * -1n)\n  })\n\n  if (!match) {\n    // Detect 100x scale mismatch — the most common failure mode when centIsInt\n    // is wrong for a provider. Fires loudly so it's obvious in dev/staging logs.\n    const hundredxMatch = metadata.find((m) => {\n      const converted = normalizeAmount(m.amount)\n      const abs = converted < 0n ? -converted : converted\n      return abs === currencyAmount * 100n || abs * 100n === currencyAmount\n    })\n    if (hundredxMatch) {\n      console.warn(\n        `[findMetadataMessage] tx[0] amount=${String(hundredxMatch.amount)} is 100x off from expected ${currencyAmount.toString()} — centIsInt is likely wrong for this provider (currently ${centIsInt})`\n      )\n    }\n    return null\n  }\n\n  return match\n}\n"]}