@provex/extension-react 1.0.16 → 1.2.3

package/dist/ZKTLSContext.cjs

@@ -0,0 +1,160 @@
+'use strict';
+
+var react = require('react');
+var viem = require('viem');
+var time = require('@provex/utils/time');
+var payment = require('@provex/utils/payment');
+require('@provex/utils/conversionRates');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/ZKTLSContext.tsx
+viem.parseAbiParameter("((string provider, string parameters, string context) claimInfo, ((bytes32 identifier, address owner, uint32 timestampS, uint32 epoch) claim, bytes[] signatures) signedClaim, bool isAppclipProof)");
+var useZKTLS = () => {
+  const [isInitialized, setIsInitialized] = react.useState(false);
+  react.useEffect(() => {
+    const setup = () => {
+      setIsInitialized(true);
+    };
+    const eventName = "peer#initialized";
+    if (typeof window.peer !== "undefined") {
+      setup();
+    } else {
+      window.addEventListener(eventName, setup);
+      return () => {
+        window.removeEventListener(eventName, setup);
+      };
+    }
+  }, []);
+  return react.useMemo(() => {
+    const fetchProofById = async (proofId) => {
+      const proof = await window.peer.fetchProofById(proofId);
+      if (proof && proof.notaryRequest) return proof.notaryRequest;
+      const proofs = await window.peer.fetchProofs();
+      const proofFromList = proofs.notaryRequests.find((p) => p.id === proofId);
+      if (proofFromList) return proofFromList;
+      return null;
+    };
+    const waitForProof = async (proofId, onCurrent) => {
+      let notaryRequest = null;
+      do {
+        notaryRequest = await fetchProofById(proofId);
+        onCurrent?.(notaryRequest);
+        await time.sleep(1e3);
+      } while (!notaryRequest || !notaryRequest.status || notaryRequest.status === "pending");
+      if (notaryRequest.status === "failed" || notaryRequest.status === "expired" || notaryRequest.status === "cancelled" || notaryRequest.status === "error") {
+        throw new Error(`Proof generation failed: ${notaryRequest.status}`);
+      }
+      return notaryRequest;
+    };
+    const generateProof = async (inputs) => {
+      return await window.peer.generateProof({
+        proofIndex: 0,
+        ...inputs,
+        intentHash: BigInt(inputs.intentHash).toString()
+      });
+    };
+    return {
+      /** check if the PeerAuth extension is initialized */
+      isInitialized,
+      /** request a connection to the PeerAuth extension */
+      requestConnection: async () => {
+        if (!window.peer) return false;
+        return window.peer.requestConnection();
+      },
+      /**
+       * check the connection status of the PeerAuth extension
+       * @returns the connection status
+       */
+      checkConnectionStatus: async () => {
+        return await window.peer.checkConnectionStatus();
+      },
+      /** get the version of the PeerAuth extension */
+      getVersion: async () => {
+        return await window.peer?.getVersion();
+      },
+      /** authenticate with the PeerAuth extension */
+      authenticate: async (inputs) => {
+        let resolve;
+        const promise = new Promise((resolver) => {
+          resolve = resolver;
+        });
+        const unsub = window.peer.onMetadataMessage((data) => {
+          if (`transfer_${data.platform}` === inputs.actionType) {
+            resolve(data);
+          }
+        });
+        await window.peer.authenticate(inputs);
+        return await promise.then((data) => {
+          unsub();
+          return data;
+        });
+      },
+      /** generate a proof */
+      generateProof,
+      /** wait for a proof to be generated */
+      waitForProof,
+      /** generate a proof series */
+      generateProofSeries: async (inputs, { progress: progressCallback } = {}) => {
+        const { platform, provider, intentHash, originalIndex } = inputs;
+        const args = {
+          platform: provider,
+          originalIndex,
+          intentHash
+        };
+        const isChase = platform === payment.extensionPlatforms.CHASE;
+        const isZelle = provider === payment.providers.ZELLE;
+        const expectedTotal = isZelle && isChase ? 2 : 1;
+        progressCallback?.({ progress: 0 /* Generating */, step: 0, id: null, total: expectedTotal });
+        const genProofA = await generateProof({ ...args, proofIndex: 0 });
+        progressCallback?.({ progress: 1 /* Polling */, step: 0, id: genProofA.proofId, total: expectedTotal });
+        const proofA = await waitForProof(genProofA.proofId);
+        if (!isChase || !isZelle) {
+          progressCallback?.({ progress: 2 /* Complete */, step: null, id: null, total: expectedTotal });
+          return [proofA];
+        }
+        progressCallback?.({ progress: 0 /* Generating */, step: 1, id: null, total: expectedTotal });
+        const genProofB = await generateProof({ ...args, proofIndex: 1 });
+        progressCallback?.({ progress: 1 /* Polling */, step: 1, id: genProofB.proofId, total: expectedTotal });
+        const proofB = await waitForProof(genProofB.proofId);
+        progressCallback?.({ progress: 2 /* Complete */, step: null, id: null, total: expectedTotal });
+        return [proofA, proofB];
+      },
+      /** subscribe to metadata messages */
+      onMetadataMessage: (fn) => {
+        return window.peer.onMetadataMessage(fn);
+      },
+      /** fetch a proof by its id */
+      fetchProofById,
+      /** fetch generated proofs */
+      fetchGeneratedProofs: async (genProofResponses) => {
+        return await Promise.all(genProofResponses.map((r) => fetchProofById(r.proofId)));
+      },
+      /** fetch all proofs */
+      fetchProofs: async () => {
+        return await window.peer.fetchProofs();
+      },
+      /** open the PeerAuth sidebar */
+      openSidebar: async (route) => {
+        return await window.peer.openSidebar(route);
+      }
+    };
+  }, [isInitialized]);
+};
+var ZKTLSContext = react.createContext(void 0);
+function useZKTLSContext() {
+  const context = react.useContext(ZKTLSContext);
+  if (context === void 0) {
+    throw new Error("useZKTLSContext must be used within a ZKTLSProvider");
+  }
+  return context;
+}
+function ZKTLSProvider({ children }) {
+  const zktlsHook = useZKTLS();
+  return /* @__PURE__ */ jsxRuntime.jsx(ZKTLSContext.Provider, { value: zktlsHook, children });
+}
+
+exports.ZKTLSContext = ZKTLSContext;
+exports.ZKTLSProvider = ZKTLSProvider;
+exports.useZKTLSContext = useZKTLSContext;
+//# sourceMappingURL=ZKTLSContext.cjs.map
+//# sourceMappingURL=ZKTLSContext.cjs.map

package/dist/ZKTLSContext.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useZKTLS.ts","../src/ZKTLSContext.tsx"],"names":["parseAbiParameter","useState","useEffect","useMemo","sleep","extensionPlatforms","providers","createContext","useContext"],"mappings":"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","file":"ZKTLSContext.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        throw new Error(`Proof generation failed: ${notaryRequest.status}`)\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    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/ZKTLSContext.d.cts

@@ -0,0 +1,51 @@
+import { Status, AuthenticationInputs, MetadataMessageResponse, HexIntentGenerateProofInputs, GenerateProofResponse, NotaryRequest, GenerateProofInputsAbstracted, GenerateProofSeriesMutations, FetchProofsResponse } from './useZKTLS.cjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode } from 'react';
+import 'viem';
+import '@provex/utils/intent';
+import '@provex/utils/tokens';
+import '@provex/utils/payment';
+
+declare const ZKTLSContext: react.Context<{
+    isInitialized: boolean;
+    requestConnection: () => Promise<boolean>;
+    checkConnectionStatus: () => Promise<Status>;
+    getVersion: () => Promise<string | undefined>;
+    authenticate: (inputs: AuthenticationInputs) => Promise<MetadataMessageResponse>;
+    generateProof: (inputs: HexIntentGenerateProofInputs) => Promise<GenerateProofResponse>;
+    waitForProof: (proofId: string, onCurrent?: (notaryRequest: NotaryRequest | null) => void) => Promise<NotaryRequest>;
+    generateProofSeries: (inputs: GenerateProofInputsAbstracted, { progress: progressCallback }?: GenerateProofSeriesMutations) => Promise<NotaryRequest[]>;
+    onMetadataMessage: (fn: (data: any) => void) => () => void;
+    fetchProofById: (proofId: string) => Promise<NotaryRequest | null>;
+    fetchGeneratedProofs: (genProofResponses: GenerateProofResponse[]) => Promise<(NotaryRequest | null)[]>;
+    fetchProofs: () => Promise<FetchProofsResponse>;
+    openSidebar: (route: string) => Promise<void>;
+} | undefined>;
+interface ZKTLSProviderProps {
+    children: ReactNode;
+}
+/**
+ * Hook to consume the ZKTLS context.
+ * Must be used within a ZKTLSProvider.
+ *
+ * @throws Error if used outside of ZKTLSProvider
+ */
+declare function useZKTLSContext(): {
+    isInitialized: boolean;
+    requestConnection: () => Promise<boolean>;
+    checkConnectionStatus: () => Promise<Status>;
+    getVersion: () => Promise<string | undefined>;
+    authenticate: (inputs: AuthenticationInputs) => Promise<MetadataMessageResponse>;
+    generateProof: (inputs: HexIntentGenerateProofInputs) => Promise<GenerateProofResponse>;
+    waitForProof: (proofId: string, onCurrent?: (notaryRequest: NotaryRequest | null) => void) => Promise<NotaryRequest>;
+    generateProofSeries: (inputs: GenerateProofInputsAbstracted, { progress: progressCallback }?: GenerateProofSeriesMutations) => Promise<NotaryRequest[]>;
+    onMetadataMessage: (fn: (data: any) => void) => () => void;
+    fetchProofById: (proofId: string) => Promise<NotaryRequest | null>;
+    fetchGeneratedProofs: (genProofResponses: GenerateProofResponse[]) => Promise<(NotaryRequest | null)[]>;
+    fetchProofs: () => Promise<FetchProofsResponse>;
+    openSidebar: (route: string) => Promise<void>;
+};
+declare function ZKTLSProvider({ children }: ZKTLSProviderProps): react_jsx_runtime.JSX.Element;
+
+export { ZKTLSContext, ZKTLSProvider, useZKTLSContext };

package/dist/ZKTLSContext.d.ts

@@ -0,0 +1,51 @@
+import { Status, AuthenticationInputs, MetadataMessageResponse, HexIntentGenerateProofInputs, GenerateProofResponse, NotaryRequest, GenerateProofInputsAbstracted, GenerateProofSeriesMutations, FetchProofsResponse } from './useZKTLS.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode } from 'react';
+import 'viem';
+import '@provex/utils/intent';
+import '@provex/utils/tokens';
+import '@provex/utils/payment';
+
+declare const ZKTLSContext: react.Context<{
+    isInitialized: boolean;
+    requestConnection: () => Promise<boolean>;
+    checkConnectionStatus: () => Promise<Status>;
+    getVersion: () => Promise<string | undefined>;
+    authenticate: (inputs: AuthenticationInputs) => Promise<MetadataMessageResponse>;
+    generateProof: (inputs: HexIntentGenerateProofInputs) => Promise<GenerateProofResponse>;
+    waitForProof: (proofId: string, onCurrent?: (notaryRequest: NotaryRequest | null) => void) => Promise<NotaryRequest>;
+    generateProofSeries: (inputs: GenerateProofInputsAbstracted, { progress: progressCallback }?: GenerateProofSeriesMutations) => Promise<NotaryRequest[]>;
+    onMetadataMessage: (fn: (data: any) => void) => () => void;
+    fetchProofById: (proofId: string) => Promise<NotaryRequest | null>;
+    fetchGeneratedProofs: (genProofResponses: GenerateProofResponse[]) => Promise<(NotaryRequest | null)[]>;
+    fetchProofs: () => Promise<FetchProofsResponse>;
+    openSidebar: (route: string) => Promise<void>;
+} | undefined>;
+interface ZKTLSProviderProps {
+    children: ReactNode;
+}
+/**
+ * Hook to consume the ZKTLS context.
+ * Must be used within a ZKTLSProvider.
+ *
+ * @throws Error if used outside of ZKTLSProvider
+ */
+declare function useZKTLSContext(): {
+    isInitialized: boolean;
+    requestConnection: () => Promise<boolean>;
+    checkConnectionStatus: () => Promise<Status>;
+    getVersion: () => Promise<string | undefined>;
+    authenticate: (inputs: AuthenticationInputs) => Promise<MetadataMessageResponse>;
+    generateProof: (inputs: HexIntentGenerateProofInputs) => Promise<GenerateProofResponse>;
+    waitForProof: (proofId: string, onCurrent?: (notaryRequest: NotaryRequest | null) => void) => Promise<NotaryRequest>;
+    generateProofSeries: (inputs: GenerateProofInputsAbstracted, { progress: progressCallback }?: GenerateProofSeriesMutations) => Promise<NotaryRequest[]>;
+    onMetadataMessage: (fn: (data: any) => void) => () => void;
+    fetchProofById: (proofId: string) => Promise<NotaryRequest | null>;
+    fetchGeneratedProofs: (genProofResponses: GenerateProofResponse[]) => Promise<(NotaryRequest | null)[]>;
+    fetchProofs: () => Promise<FetchProofsResponse>;
+    openSidebar: (route: string) => Promise<void>;
+};
+declare function ZKTLSProvider({ children }: ZKTLSProviderProps): react_jsx_runtime.JSX.Element;
+
+export { ZKTLSContext, ZKTLSProvider, useZKTLSContext };

package/dist/ZKTLSContext.js

@@ -0,0 +1,4 @@
+export { ZKTLSContext, ZKTLSProvider, useZKTLSContext } from './chunk-MXHT5VC5.js';
+import './chunk-DVOEKDW7.js';
+//# sourceMappingURL=ZKTLSContext.js.map
+//# sourceMappingURL=ZKTLSContext.js.map

package/dist/ZKTLSContext.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"ZKTLSContext.js"}

package/dist/chunk-DVOEKDW7.js

@@ -0,0 +1,226 @@
+import { useState, useEffect, useMemo } from 'react';
+import { parseAbiParameter, encodeAbiParameters, encodePacked, parseUnits } from 'viem';
+import { sleep } from '@provex/utils/time';
+import { subProviderConfigs, extensionPlatforms, providers } from '@provex/utils/payment';
+import { convertTokenInputToCurrency } from '@provex/utils/conversionRates';
+
+// src/useZKTLS.ts
+var extensionUrl = "https://chromewebstore.google.com/detail/ijpgccednehjpeclfcllnjjcmiohdjih";
+var byteArrayToHexString = (byteArray) => {
+  return `0x${byteArray.map((byte) => byte.toString(16).padStart(2, "0")).join("")}`;
+};
+var parseExtensionProof = (proofObject) => {
+  return {
+    claimInfo: {
+      provider: proofObject.claim.provider,
+      parameters: proofObject.claim.parameters,
+      context: proofObject.claim.context
+    },
+    signedClaim: {
+      claim: {
+        identifier: proofObject.claim.identifier,
+        owner: proofObject.claim.owner,
+        timestampS: proofObject.claim.timestampS,
+        epoch: proofObject.claim.epoch
+      },
+      signatures: [byteArrayToHexString(Object.values(proofObject.signatures.claimSignature))]
+    },
+    isAppclipProof: false
+  };
+};
+var PROOF_ENCODING = parseAbiParameter("((string provider, string parameters, string context) claimInfo, ((bytes32 identifier, address owner, uint32 timestampS, uint32 epoch) claim, bytes[] signatures) signedClaim, bool isAppclipProof)");
+function encodeProofAsBytes(proof) {
+  return encodeAbiParameters([PROOF_ENCODING], [proof]);
+}
+var encodeTwoProofs = (proof1, proof2) => {
+  return encodeAbiParameters([PROOF_ENCODING, PROOF_ENCODING], [proof1, proof2]);
+};
+var encodeProof = ({ extensionProofs, subProvider, provider }) => {
+  const reclaimProofs = extensionProofs.map((p) => parseExtensionProof(p));
+  if (provider === "zelle") {
+    const paymentMethod = subProviderConfigs[provider][subProvider].paymentMethod;
+    const twoEncoded = reclaimProofs.length === 2 ? encodeTwoProofs(reclaimProofs[0], reclaimProofs[1]) : encodeProofAsBytes(reclaimProofs[0]);
+    const withPaymentMethod = encodeProofWithPaymentMethod({
+      paymentMethod,
+      proof: twoEncoded
+    });
+    return withPaymentMethod;
+  }
+  const [reclaimProof] = reclaimProofs;
+  return encodeProofAsBytes(reclaimProof);
+};
+var encodeProofWithPaymentMethod = ({
+  proof,
+  paymentMethod
+}) => {
+  return encodePacked(["uint8", "bytes"], [paymentMethod, proof]);
+};
+var SeriesProgress = /* @__PURE__ */ ((SeriesProgress2) => {
+  SeriesProgress2[SeriesProgress2["Generating"] = 0] = "Generating";
+  SeriesProgress2[SeriesProgress2["Polling"] = 1] = "Polling";
+  SeriesProgress2[SeriesProgress2["Complete"] = 2] = "Complete";
+  return SeriesProgress2;
+})(SeriesProgress || {});
+var useZKTLS = () => {
+  const [isInitialized, setIsInitialized] = useState(false);
+  useEffect(() => {
+    const setup = () => {
+      setIsInitialized(true);
+    };
+    const eventName = "peer#initialized";
+    if (typeof window.peer !== "undefined") {
+      setup();
+    } else {
+      window.addEventListener(eventName, setup);
+      return () => {
+        window.removeEventListener(eventName, setup);
+      };
+    }
+  }, []);
+  return useMemo(() => {
+    const fetchProofById = async (proofId) => {
+      const proof = await window.peer.fetchProofById(proofId);
+      if (proof && proof.notaryRequest) return proof.notaryRequest;
+      const proofs = await window.peer.fetchProofs();
+      const proofFromList = proofs.notaryRequests.find((p) => p.id === proofId);
+      if (proofFromList) return proofFromList;
+      return null;
+    };
+    const waitForProof = async (proofId, onCurrent) => {
+      let notaryRequest = null;
+      do {
+        notaryRequest = await fetchProofById(proofId);
+        onCurrent?.(notaryRequest);
+        await sleep(1e3);
+      } while (!notaryRequest || !notaryRequest.status || notaryRequest.status === "pending");
+      if (notaryRequest.status === "failed" || notaryRequest.status === "expired" || notaryRequest.status === "cancelled" || notaryRequest.status === "error") {
+        throw new Error(`Proof generation failed: ${notaryRequest.status}`);
+      }
+      return notaryRequest;
+    };
+    const generateProof = async (inputs) => {
+      return await window.peer.generateProof({
+        proofIndex: 0,
+        ...inputs,
+        intentHash: BigInt(inputs.intentHash).toString()
+      });
+    };
+    return {
+      /** check if the PeerAuth extension is initialized */
+      isInitialized,
+      /** request a connection to the PeerAuth extension */
+      requestConnection: async () => {
+        if (!window.peer) return false;
+        return window.peer.requestConnection();
+      },
+      /**
+       * check the connection status of the PeerAuth extension
+       * @returns the connection status
+       */
+      checkConnectionStatus: async () => {
+        return await window.peer.checkConnectionStatus();
+      },
+      /** get the version of the PeerAuth extension */
+      getVersion: async () => {
+        return await window.peer?.getVersion();
+      },
+      /** authenticate with the PeerAuth extension */
+      authenticate: async (inputs) => {
+        let resolve;
+        const promise = new Promise((resolver) => {
+          resolve = resolver;
+        });
+        const unsub = window.peer.onMetadataMessage((data) => {
+          if (`transfer_${data.platform}` === inputs.actionType) {
+            resolve(data);
+          }
+        });
+        await window.peer.authenticate(inputs);
+        return await promise.then((data) => {
+          unsub();
+          return data;
+        });
+      },
+      /** generate a proof */
+      generateProof,
+      /** wait for a proof to be generated */
+      waitForProof,
+      /** generate a proof series */
+      generateProofSeries: async (inputs, { progress: progressCallback } = {}) => {
+        const { platform, provider, intentHash, originalIndex } = inputs;
+        const args = {
+          platform: provider,
+          originalIndex,
+          intentHash
+        };
+        const isChase = platform === extensionPlatforms.CHASE;
+        const isZelle = provider === providers.ZELLE;
+        const expectedTotal = isZelle && isChase ? 2 : 1;
+        progressCallback?.({ progress: 0 /* Generating */, step: 0, id: null, total: expectedTotal });
+        const genProofA = await generateProof({ ...args, proofIndex: 0 });
+        progressCallback?.({ progress: 1 /* Polling */, step: 0, id: genProofA.proofId, total: expectedTotal });
+        const proofA = await waitForProof(genProofA.proofId);
+        if (!isChase || !isZelle) {
+          progressCallback?.({ progress: 2 /* Complete */, step: null, id: null, total: expectedTotal });
+          return [proofA];
+        }
+        progressCallback?.({ progress: 0 /* Generating */, step: 1, id: null, total: expectedTotal });
+        const genProofB = await generateProof({ ...args, proofIndex: 1 });
+        progressCallback?.({ progress: 1 /* Polling */, step: 1, id: genProofB.proofId, total: expectedTotal });
+        const proofB = await waitForProof(genProofB.proofId);
+        progressCallback?.({ progress: 2 /* Complete */, step: null, id: null, total: expectedTotal });
+        return [proofA, proofB];
+      },
+      /** subscribe to metadata messages */
+      onMetadataMessage: (fn) => {
+        return window.peer.onMetadataMessage(fn);
+      },
+      /** fetch a proof by its id */
+      fetchProofById,
+      /** fetch generated proofs */
+      fetchGeneratedProofs: async (genProofResponses) => {
+        return await Promise.all(genProofResponses.map((r) => fetchProofById(r.proofId)));
+      },
+      /** fetch all proofs */
+      fetchProofs: async () => {
+        return await window.peer.fetchProofs();
+      },
+      /** open the PeerAuth sidebar */
+      openSidebar: async (route) => {
+        return await window.peer.openSidebar(route);
+      }
+    };
+  }, [isInitialized]);
+};
+var findMetadataMessage = ({ metadata, intent, token, centIsInt = false }) => {
+  const currencyAmount = convertTokenInputToCurrency({
+    token,
+    amountOutInt: intent.amount,
+    rate: intent.conversionRate
+  });
+  const normalizeAmount = (amount) => {
+    const raw = String(amount);
+    const isFormattedDollars = /[^0-9\-]/.test(raw) && raw.includes(".");
+    const cleaned = raw.replace(/[^0-9.]/g, "");
+    let value = parseUnits(cleaned, token.decimals);
+    if (centIsInt && !isFormattedDollars) {
+      value = value / 100n;
+    }
+    return value;
+  };
+  if (typeof window !== "undefined" && window.__FORCE_MANUAL_TX_SELECT__) {
+    return null;
+  }
+  const match = metadata.find((m) => {
+    const converted = normalizeAmount(m.amount);
+    return converted === currencyAmount || converted === currencyAmount * -1n;
+  });
+  if (!match) {
+    return null;
+  }
+  return match;
+};
+
+export { PROOF_ENCODING, SeriesProgress, byteArrayToHexString, encodeProof, encodeProofAsBytes, encodeProofWithPaymentMethod, encodeTwoProofs, extensionUrl, findMetadataMessage, parseExtensionProof, useZKTLS };
+//# sourceMappingURL=chunk-DVOEKDW7.js.map
+//# sourceMappingURL=chunk-DVOEKDW7.js.map

package/dist/chunk-DVOEKDW7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useZKTLS.ts"],"names":["SeriesProgress"],"mappings":"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","file":"chunk-DVOEKDW7.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        throw new Error(`Proof generation failed: ${notaryRequest.status}`)\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    return null\n  }\n\n  return match\n}\n"]}

package/dist/chunk-MXHT5VC5.js

@@ -0,0 +1,20 @@
+import { useZKTLS } from './chunk-DVOEKDW7.js';
+import { createContext, useContext } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+var ZKTLSContext = createContext(void 0);
+function useZKTLSContext() {
+  const context = useContext(ZKTLSContext);
+  if (context === void 0) {
+    throw new Error("useZKTLSContext must be used within a ZKTLSProvider");
+  }
+  return context;
+}
+function ZKTLSProvider({ children }) {
+  const zktlsHook = useZKTLS();
+  return /* @__PURE__ */ jsx(ZKTLSContext.Provider, { value: zktlsHook, children });
+}
+
+export { ZKTLSContext, ZKTLSProvider, useZKTLSContext };
+//# sourceMappingURL=chunk-MXHT5VC5.js.map
+//# sourceMappingURL=chunk-MXHT5VC5.js.map

package/dist/chunk-MXHT5VC5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ZKTLSContext.tsx"],"names":[],"mappings":";;;;AAiBO,IAAM,YAAA,GAAe,cAA4C,MAAS;AAY1E,SAAS,eAAA,GAAkB;AAChC,EAAA,MAAM,OAAA,GAAU,WAAW,YAAY,CAAA;AACvC,EAAA,IAAI,YAAY,MAAA,EAAW;AACzB,IAAA,MAAM,IAAI,MAAM,qDAAqD,CAAA;AAAA,EACvE;AACA,EAAA,OAAO,OAAA;AACT;AAEO,SAAS,aAAA,CAAc,EAAE,QAAA,EAAS,EAAuB;AAC9D,EAAA,MAAM,YAAY,QAAA,EAAS;AAE3B,EAAA,2BACG,YAAA,CAAa,QAAA,EAAb,EAAsB,KAAA,EAAO,WAC3B,QAAA,EACH,CAAA;AAEJ","file":"chunk-MXHT5VC5.js","sourcesContent":["/**\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"]}