x402z-client-web 0.0.18 → 0.1.0

package/README.md

@@ -35,12 +35,13 @@ const relayer = await createRelayer(relayerConfig);
 const signer = await createBrowserSigner(provider);
 
 const client = createX402zClient({
+  schemePreference: ["erc7984-mind-v1"],
   signer,
   relayer,
 });
 
-const response = await client.pay("https://example.com/demo");
-console.log(response.status);
+const paid = await client.pay("https://example.com/demo");
+console.log(paid.response.status);
 ```
 
 `createX402zClient` builds the confidential payment input automatically using the
@@ -50,13 +51,39 @@ console.log(response.status);
 ## API
 
 - `createX402zClient(config)`
-  - `signer` (required): EIP-712 signer for x402 payloads
-  - `relayer` (required): relayer instance (browser)
+  - `schemePreference` (required): ordered list of schemes to try (e.g. `["erc7984-mind-v1", "exact"]`)
+  - `signer` (required): signer used for both exact and confidential schemes
+  - `relayer` (required when using `erc7984-mind-v1`): relayer instance (browser)
   - `fetch` (optional): custom fetch implementation
 - `client.pay(url, options?)`: performs the 402 handshake and retries with payment headers
+  - returns `{ response, paymentRequired?, confidentialRequirements? }`
+
+## Examples
+
+See `examples/README.md` for the full-process web examples (`examples/full-process/web-vite` and `examples/full-process/web-next`).
 
 ## Notes
 
 - Web builds use `@zama-fhe/relayer-sdk/web` (no CDN script tag or bundle).
 - Requires an injected wallet that supports `eth_signTypedData_v4` (e.g. MetaMask).
-- Scheme name: `erc7984-mind-v1`
+- Confidential scheme name: `erc7984-mind-v1`
+- Exact scheme name: `exact`
+
+## API surface
+
+Exports:
+- `createX402zClient`: convenience client wrapper for browser pay flows.
+- `X402zEvmClientScheme`: client scheme implementation for erc7984-mind-v1.
+- `registerX402zEvmClientScheme`: registers the scheme with x402 client.
+
+Types:
+- `X402zClient`: client instance type.
+- `X402zClientOptions`: options for `createX402zClient`.
+- `X402zConfidentialClientOptions`: options for confidential payments.
+- `X402zExactClientOptions`: options for exact payments.
+- `PayOptions`: per-request payment options.
+- `X402zClientSchemeOptions`: scheme config for client registration.
+- `X402zClientRegistrationOptions`: registration options for the scheme.
+- `ConfidentialRequirementsExtra`: scheme requirements extension payload.
+- `RelayerInstance`: relayer instance type.
+- re-exported types from `@x402/core/types`: shared x402 types.

package/dist/index.d.mts

@@ -1,9 +1,9 @@
-import { ConfidentialPaymentInput, RelayerInstance } from 'x402z-shared-web';
-export { ConfidentialRequirementsExtra, RelayerInstance } from 'x402z-shared-web';
-import { x402Client } from '@x402/core/client';
-import { PaymentRequirements, SchemeNetworkClient, PaymentPayload, Network } from '@x402/core/types';
+import { PaymentRequirements, SchemeNetworkClient, PaymentPayload, Network, PaymentRequired } from '@x402/core/types';
 export * from '@x402/core/types';
+import { SelectPaymentRequirements, PaymentPolicy, x402Client } from '@x402/core/client';
 import { ClientEvmSigner } from '@x402/evm';
+import { ConfidentialPaymentInput, RelayerInstance } from 'x402z-shared-web';
+export { ConfidentialRequirementsExtra, RelayerInstance } from 'x402z-shared-web';
 
 type X402zClientSchemeOptions = {
     signer: ClientEvmSigner;
@@ -24,23 +24,43 @@ declare class X402zEvmClientScheme implements SchemeNetworkClient {
     createPaymentPayload(x402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, "x402Version" | "payload">>;
 }
 
-type X402zClientRegistrationOptions = X402zClientSchemeOptions & {
-    networks?: Network[];
-};
-declare function registerX402zEvmClientScheme(client: x402Client, config: X402zClientRegistrationOptions): x402Client;
-
-type X402zClientOptions = Omit<X402zClientRegistrationOptions, "buildPayment"> & {
-    relayer: RelayerInstance;
+type Scheme = "exact" | "erc7984-mind-v1";
+type BaseClientOptions = {
     fetch?: typeof fetch;
     debug?: boolean;
 };
+type X402zClientOptions = {
+    schemePreference: Scheme[];
+    signer: ClientEvmSigner;
+    relayer?: RelayerInstance;
+    networks?: Network[];
+    paymentRequirementsSelector?: SelectPaymentRequirements;
+    policies?: PaymentPolicy[];
+    eip712?: X402zClientSchemeOptions["eip712"];
+    hashEncryptedAmountInput?: X402zClientSchemeOptions["hashEncryptedAmountInput"];
+    clock?: X402zClientSchemeOptions["clock"];
+    onPaymentSelected?: (info: {
+        scheme: Scheme;
+        requirements: PaymentRequirements;
+    }) => void;
+} & BaseClientOptions;
 type PayOptions = {
     headers?: Record<string, string>;
 };
+type PayResult = {
+    response: Response;
+    paymentRequired?: PaymentRequired;
+    confidentialRequirements?: PaymentRequirements;
+};
 type X402zClient = {
-    relayer: RelayerInstance;
-    pay: (url: string, options?: PayOptions) => Promise<Response>;
+    relayer?: RelayerInstance;
+    pay: (url: string, options?: PayOptions) => Promise<PayResult>;
 };
 declare function createX402zClient(config: X402zClientOptions): X402zClient;
 
-export { type PayOptions, type X402zClient, type X402zClientOptions, type X402zClientRegistrationOptions, type X402zClientSchemeOptions, X402zEvmClientScheme, createX402zClient, registerX402zEvmClientScheme };
+type X402zClientRegistrationOptions = X402zClientSchemeOptions & {
+    networks?: Network[];
+};
+declare function registerX402zEvmClientScheme(client: x402Client, config: X402zClientRegistrationOptions): x402Client;
+
+export { type PayOptions, type PayResult, type X402zClient, type X402zClientOptions, type X402zClientRegistrationOptions, type X402zClientSchemeOptions, X402zEvmClientScheme, createX402zClient, registerX402zEvmClientScheme };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { ConfidentialPaymentInput, RelayerInstance } from 'x402z-shared-web';
-export { ConfidentialRequirementsExtra, RelayerInstance } from 'x402z-shared-web';
-import { x402Client } from '@x402/core/client';
-import { PaymentRequirements, SchemeNetworkClient, PaymentPayload, Network } from '@x402/core/types';
+import { PaymentRequirements, SchemeNetworkClient, PaymentPayload, Network, PaymentRequired } from '@x402/core/types';
 export * from '@x402/core/types';
+import { SelectPaymentRequirements, PaymentPolicy, x402Client } from '@x402/core/client';
 import { ClientEvmSigner } from '@x402/evm';
+import { ConfidentialPaymentInput, RelayerInstance } from 'x402z-shared-web';
+export { ConfidentialRequirementsExtra, RelayerInstance } from 'x402z-shared-web';
 
 type X402zClientSchemeOptions = {
     signer: ClientEvmSigner;
@@ -24,23 +24,43 @@ declare class X402zEvmClientScheme implements SchemeNetworkClient {
     createPaymentPayload(x402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, "x402Version" | "payload">>;
 }
 
-type X402zClientRegistrationOptions = X402zClientSchemeOptions & {
-    networks?: Network[];
-};
-declare function registerX402zEvmClientScheme(client: x402Client, config: X402zClientRegistrationOptions): x402Client;
-
-type X402zClientOptions = Omit<X402zClientRegistrationOptions, "buildPayment"> & {
-    relayer: RelayerInstance;
+type Scheme = "exact" | "erc7984-mind-v1";
+type BaseClientOptions = {
     fetch?: typeof fetch;
     debug?: boolean;
 };
+type X402zClientOptions = {
+    schemePreference: Scheme[];
+    signer: ClientEvmSigner;
+    relayer?: RelayerInstance;
+    networks?: Network[];
+    paymentRequirementsSelector?: SelectPaymentRequirements;
+    policies?: PaymentPolicy[];
+    eip712?: X402zClientSchemeOptions["eip712"];
+    hashEncryptedAmountInput?: X402zClientSchemeOptions["hashEncryptedAmountInput"];
+    clock?: X402zClientSchemeOptions["clock"];
+    onPaymentSelected?: (info: {
+        scheme: Scheme;
+        requirements: PaymentRequirements;
+    }) => void;
+} & BaseClientOptions;
 type PayOptions = {
     headers?: Record<string, string>;
 };
+type PayResult = {
+    response: Response;
+    paymentRequired?: PaymentRequired;
+    confidentialRequirements?: PaymentRequirements;
+};
 type X402zClient = {
-    relayer: RelayerInstance;
-    pay: (url: string, options?: PayOptions) => Promise<Response>;
+    relayer?: RelayerInstance;
+    pay: (url: string, options?: PayOptions) => Promise<PayResult>;
 };
 declare function createX402zClient(config: X402zClientOptions): X402zClient;
 
-export { type PayOptions, type X402zClient, type X402zClientOptions, type X402zClientRegistrationOptions, type X402zClientSchemeOptions, X402zEvmClientScheme, createX402zClient, registerX402zEvmClientScheme };
+type X402zClientRegistrationOptions = X402zClientSchemeOptions & {
+    networks?: Network[];
+};
+declare function registerX402zEvmClientScheme(client: x402Client, config: X402zClientRegistrationOptions): x402Client;
+
+export { type PayOptions, type PayResult, type X402zClient, type X402zClientOptions, type X402zClientRegistrationOptions, type X402zClientSchemeOptions, X402zEvmClientScheme, createX402zClient, registerX402zEvmClientScheme };

package/dist/index.js

@@ -29,6 +29,7 @@ module.exports = __toCommonJS(index_exports);
 // src/http/client.ts
 var import_client = require("@x402/core/client");
 var import_http = require("@x402/core/http");
+var import_client2 = require("@x402/evm/exact/client");
 var import_viem2 = require("viem");
 var import_x402z_shared_web2 = require("x402z-shared-web");
 
@@ -128,16 +129,35 @@ function registerX402zEvmClientScheme(client, config) {
 }
 
 // src/http/client.ts
-function createX402zClient(config) {
-  const { fetch: fetchOverride, ...registerConfig } = config;
-  const fetchFn = fetchOverride ?? globalThis.fetch;
-  const debugEnabled = config.debug ?? false;
-  if (!fetchFn) {
-    throw new Error("fetch is not available; provide a fetch implementation");
-  }
+function filterPaymentRequired(paymentRequired, scheme) {
+  const accepts = paymentRequired.accepts.filter((requirement) => requirement.scheme === scheme);
+  return { ...paymentRequired, accepts };
+}
+function createExactPayer(config, debugEnabled) {
+  const client = new import_client.x402Client(config.paymentRequirementsSelector);
+  (0, import_client2.registerExactEvmScheme)(client, {
+    signer: config.signer,
+    networks: config.networks,
+    policies: config.policies,
+    paymentRequirementsSelector: config.paymentRequirementsSelector
+  });
+  const httpClient = new import_http.x402HTTPClient(client);
+  return {
+    async buildHeaders(paymentRequired) {
+      const payload = await httpClient.createPaymentPayload(paymentRequired);
+      const payHeaders = httpClient.encodePaymentSignatureHeader(payload);
+      if (debugEnabled) {
+        console.debug("[x402z-client] payment payload", payload);
+        console.debug("[x402z-client] payment headers", payHeaders);
+      }
+      return { headers: payHeaders };
+    }
+  };
+}
+function createConfidentialPayer(config, debugEnabled) {
   const buildPayment = async (requirements) => {
     if (!(0, import_viem2.isAddress)(requirements.asset)) {
-      throw new Error(`Invalid TOKEN_ADDRESS from requirements: ${requirements.asset}`);
+      throw new Error(`Invalid token address from requirements: ${requirements.asset}`);
     }
     const extra = requirements.extra;
     const batcherAddress = extra?.confidential?.batcherAddress;
@@ -164,47 +184,127 @@ function createX402zClient(config) {
   };
   const client = new import_client.x402Client();
   registerX402zEvmClientScheme(client, {
-    ...registerConfig,
-    buildPayment
+    signer: config.signer,
+    buildPayment,
+    eip712: config.eip712,
+    hashEncryptedAmountInput: config.hashEncryptedAmountInput,
+    clock: config.clock,
+    networks: config.networks
   });
   const httpClient = new import_http.x402HTTPClient(client);
+  const extractConfidentialRequirements = (paymentRequired) => {
+    const requirements = paymentRequired.accepts.find(
+      (requirement) => requirement.scheme === "erc7984-mind-v1"
+    );
+    if (!requirements) {
+      throw new Error("Missing erc7984-mind-v1 payment requirements");
+    }
+    return requirements;
+  };
   return {
     relayer: config.relayer,
-    async pay(url, options) {
-      const initial = await fetchFn(url, { headers: options?.headers });
-      if (initial.status !== 402) {
-        return initial;
-      }
-      const paymentRequired = httpClient.getPaymentRequiredResponse(
-        (name) => initial.headers.get(name),
-        await initial.json().catch(() => ({}))
-      );
+    extractConfidentialRequirements,
+    async buildHeaders(paymentRequired) {
       const payload = await httpClient.createPaymentPayload(paymentRequired);
       const payHeaders = httpClient.encodePaymentSignatureHeader(payload);
       if (debugEnabled) {
         console.debug("[x402z-client] payment payload", payload);
         console.debug("[x402z-client] payment headers", payHeaders);
       }
-      const mergedHeaders = { ...options?.headers ?? {}, ...payHeaders };
-      const paidResponse = await fetchFn(url, { headers: mergedHeaders });
-      if (debugEnabled) {
-        try {
-          const body = await paidResponse.clone().text();
-          console.debug("[x402z-client] response", {
-            status: paidResponse.status,
-            headers: Object.fromEntries(paidResponse.headers.entries()),
-            body
-          });
-        } catch (error) {
-          console.debug("[x402z-client] response", {
-            status: paidResponse.status,
-            headers: Object.fromEntries(paidResponse.headers.entries()),
-            body: "<unavailable>"
-          });
-        }
+      return { headers: payHeaders };
+    }
+  };
+}
+function createX402zClient(config) {
+  const fetchFn = config.fetch ?? globalThis.fetch;
+  const debugEnabled = config.debug ?? false;
+  if (!fetchFn) {
+    throw new Error("fetch is not available; provide a fetch implementation");
+  }
+  const schemePreference = config.schemePreference?.length ? config.schemePreference : ["exact"];
+  const exactPayer = createExactPayer(
+    {
+      signer: config.signer,
+      networks: config.networks,
+      paymentRequirementsSelector: config.paymentRequirementsSelector,
+      policies: config.policies
+    },
+    debugEnabled
+  );
+  const confidentialPayer = config.relayer ? createConfidentialPayer(
+    {
+      signer: config.signer,
+      relayer: config.relayer,
+      eip712: config.eip712,
+      hashEncryptedAmountInput: config.hashEncryptedAmountInput,
+      clock: config.clock,
+      networks: config.networks
+    },
+    debugEnabled
+  ) : void 0;
+  const parserClient = new import_client.x402Client();
+  const parserHttp = new import_http.x402HTTPClient(parserClient);
+  const pay = async (url, options) => {
+    const initial = await fetchFn(url, { headers: options?.headers });
+    if (initial.status !== 402) {
+      return { response: initial };
+    }
+    const paymentRequired = parserHttp.getPaymentRequiredResponse(
+      (name) => initial.headers.get(name),
+      await initial.json().catch(() => ({}))
+    );
+    const supportedSchemes = new Set(
+      paymentRequired.accepts.map((accept) => accept.scheme)
+    );
+    const selectedScheme = schemePreference.find(
+      (scheme) => supportedSchemes.has(scheme)
+    );
+    if (!selectedScheme) {
+      throw new Error("No preferred schemes are supported by payment requirements");
+    }
+    const filteredRequirements = filterPaymentRequired(paymentRequired, selectedScheme);
+    if (filteredRequirements.accepts.length === 0) {
+      throw new Error(`Missing ${selectedScheme} payment requirements`);
+    }
+    let headersResult;
+    let confidentialRequirements;
+    const selectedRequirements = filteredRequirements.accepts[0];
+    config.onPaymentSelected?.({
+      scheme: selectedScheme,
+      requirements: selectedRequirements
+    });
+    if (selectedScheme === "exact") {
+      headersResult = await exactPayer.buildHeaders(filteredRequirements);
+    } else {
+      if (!confidentialPayer) {
+        throw new Error("Confidential scheme is selected but relayer is missing");
       }
-      return paidResponse;
+      confidentialRequirements = confidentialPayer.extractConfidentialRequirements(filteredRequirements);
+      headersResult = await confidentialPayer.buildHeaders(filteredRequirements);
     }
+    const mergedHeaders = { ...options?.headers ?? {}, ...headersResult.headers };
+    const paidResponse = await fetchFn(url, { headers: mergedHeaders });
+    if (debugEnabled) {
+      try {
+        const body = await paidResponse.clone().text();
+        console.debug("[x402z-client] response", {
+          status: paidResponse.status,
+          headers: Object.fromEntries(paidResponse.headers.entries()),
+          body
+        });
+      } catch (error) {
+        console.debug("[x402z-client] response", {
+          status: paidResponse.status,
+          headers: Object.fromEntries(paidResponse.headers.entries()),
+          body: "<unavailable>"
+        });
+      }
+    }
+    return { response: paidResponse, paymentRequired, confidentialRequirements };
+  };
+  return {
+    relayer: confidentialPayer?.relayer,
+    pay
   };
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.mjs

@@ -1,6 +1,7 @@
 // src/http/client.ts
 import { x402Client } from "@x402/core/client";
 import { x402HTTPClient } from "@x402/core/http";
+import { registerExactEvmScheme } from "@x402/evm/exact/client";
 import { isAddress } from "viem";
 import {
   createEncryptedAmountInput
@@ -107,16 +108,35 @@ function registerX402zEvmClientScheme(client, config) {
 }
 
 // src/http/client.ts
-function createX402zClient(config) {
-  const { fetch: fetchOverride, ...registerConfig } = config;
-  const fetchFn = fetchOverride ?? globalThis.fetch;
-  const debugEnabled = config.debug ?? false;
-  if (!fetchFn) {
-    throw new Error("fetch is not available; provide a fetch implementation");
-  }
+function filterPaymentRequired(paymentRequired, scheme) {
+  const accepts = paymentRequired.accepts.filter((requirement) => requirement.scheme === scheme);
+  return { ...paymentRequired, accepts };
+}
+function createExactPayer(config, debugEnabled) {
+  const client = new x402Client(config.paymentRequirementsSelector);
+  registerExactEvmScheme(client, {
+    signer: config.signer,
+    networks: config.networks,
+    policies: config.policies,
+    paymentRequirementsSelector: config.paymentRequirementsSelector
+  });
+  const httpClient = new x402HTTPClient(client);
+  return {
+    async buildHeaders(paymentRequired) {
+      const payload = await httpClient.createPaymentPayload(paymentRequired);
+      const payHeaders = httpClient.encodePaymentSignatureHeader(payload);
+      if (debugEnabled) {
+        console.debug("[x402z-client] payment payload", payload);
+        console.debug("[x402z-client] payment headers", payHeaders);
+      }
+      return { headers: payHeaders };
+    }
+  };
+}
+function createConfidentialPayer(config, debugEnabled) {
   const buildPayment = async (requirements) => {
     if (!isAddress(requirements.asset)) {
-      throw new Error(`Invalid TOKEN_ADDRESS from requirements: ${requirements.asset}`);
+      throw new Error(`Invalid token address from requirements: ${requirements.asset}`);
     }
     const extra = requirements.extra;
     const batcherAddress = extra?.confidential?.batcherAddress;
@@ -143,47 +163,127 @@ function createX402zClient(config) {
   };
   const client = new x402Client();
   registerX402zEvmClientScheme(client, {
-    ...registerConfig,
-    buildPayment
+    signer: config.signer,
+    buildPayment,
+    eip712: config.eip712,
+    hashEncryptedAmountInput: config.hashEncryptedAmountInput,
+    clock: config.clock,
+    networks: config.networks
   });
   const httpClient = new x402HTTPClient(client);
+  const extractConfidentialRequirements = (paymentRequired) => {
+    const requirements = paymentRequired.accepts.find(
+      (requirement) => requirement.scheme === "erc7984-mind-v1"
+    );
+    if (!requirements) {
+      throw new Error("Missing erc7984-mind-v1 payment requirements");
+    }
+    return requirements;
+  };
   return {
     relayer: config.relayer,
-    async pay(url, options) {
-      const initial = await fetchFn(url, { headers: options?.headers });
-      if (initial.status !== 402) {
-        return initial;
-      }
-      const paymentRequired = httpClient.getPaymentRequiredResponse(
-        (name) => initial.headers.get(name),
-        await initial.json().catch(() => ({}))
-      );
+    extractConfidentialRequirements,
+    async buildHeaders(paymentRequired) {
       const payload = await httpClient.createPaymentPayload(paymentRequired);
       const payHeaders = httpClient.encodePaymentSignatureHeader(payload);
       if (debugEnabled) {
         console.debug("[x402z-client] payment payload", payload);
         console.debug("[x402z-client] payment headers", payHeaders);
       }
-      const mergedHeaders = { ...options?.headers ?? {}, ...payHeaders };
-      const paidResponse = await fetchFn(url, { headers: mergedHeaders });
-      if (debugEnabled) {
-        try {
-          const body = await paidResponse.clone().text();
-          console.debug("[x402z-client] response", {
-            status: paidResponse.status,
-            headers: Object.fromEntries(paidResponse.headers.entries()),
-            body
-          });
-        } catch (error) {
-          console.debug("[x402z-client] response", {
-            status: paidResponse.status,
-            headers: Object.fromEntries(paidResponse.headers.entries()),
-            body: "<unavailable>"
-          });
-        }
+      return { headers: payHeaders };
+    }
+  };
+}
+function createX402zClient(config) {
+  const fetchFn = config.fetch ?? globalThis.fetch;
+  const debugEnabled = config.debug ?? false;
+  if (!fetchFn) {
+    throw new Error("fetch is not available; provide a fetch implementation");
+  }
+  const schemePreference = config.schemePreference?.length ? config.schemePreference : ["exact"];
+  const exactPayer = createExactPayer(
+    {
+      signer: config.signer,
+      networks: config.networks,
+      paymentRequirementsSelector: config.paymentRequirementsSelector,
+      policies: config.policies
+    },
+    debugEnabled
+  );
+  const confidentialPayer = config.relayer ? createConfidentialPayer(
+    {
+      signer: config.signer,
+      relayer: config.relayer,
+      eip712: config.eip712,
+      hashEncryptedAmountInput: config.hashEncryptedAmountInput,
+      clock: config.clock,
+      networks: config.networks
+    },
+    debugEnabled
+  ) : void 0;
+  const parserClient = new x402Client();
+  const parserHttp = new x402HTTPClient(parserClient);
+  const pay = async (url, options) => {
+    const initial = await fetchFn(url, { headers: options?.headers });
+    if (initial.status !== 402) {
+      return { response: initial };
+    }
+    const paymentRequired = parserHttp.getPaymentRequiredResponse(
+      (name) => initial.headers.get(name),
+      await initial.json().catch(() => ({}))
+    );
+    const supportedSchemes = new Set(
+      paymentRequired.accepts.map((accept) => accept.scheme)
+    );
+    const selectedScheme = schemePreference.find(
+      (scheme) => supportedSchemes.has(scheme)
+    );
+    if (!selectedScheme) {
+      throw new Error("No preferred schemes are supported by payment requirements");
+    }
+    const filteredRequirements = filterPaymentRequired(paymentRequired, selectedScheme);
+    if (filteredRequirements.accepts.length === 0) {
+      throw new Error(`Missing ${selectedScheme} payment requirements`);
+    }
+    let headersResult;
+    let confidentialRequirements;
+    const selectedRequirements = filteredRequirements.accepts[0];
+    config.onPaymentSelected?.({
+      scheme: selectedScheme,
+      requirements: selectedRequirements
+    });
+    if (selectedScheme === "exact") {
+      headersResult = await exactPayer.buildHeaders(filteredRequirements);
+    } else {
+      if (!confidentialPayer) {
+        throw new Error("Confidential scheme is selected but relayer is missing");
       }
-      return paidResponse;
+      confidentialRequirements = confidentialPayer.extractConfidentialRequirements(filteredRequirements);
+      headersResult = await confidentialPayer.buildHeaders(filteredRequirements);
     }
+    const mergedHeaders = { ...options?.headers ?? {}, ...headersResult.headers };
+    const paidResponse = await fetchFn(url, { headers: mergedHeaders });
+    if (debugEnabled) {
+      try {
+        const body = await paidResponse.clone().text();
+        console.debug("[x402z-client] response", {
+          status: paidResponse.status,
+          headers: Object.fromEntries(paidResponse.headers.entries()),
+          body
+        });
+      } catch (error) {
+        console.debug("[x402z-client] response", {
+          status: paidResponse.status,
+          headers: Object.fromEntries(paidResponse.headers.entries()),
+          body: "<unavailable>"
+        });
+      }
+    }
+    return { response: paidResponse, paymentRequired, confidentialRequirements };
+  };
+  return {
+    relayer: confidentialPayer?.relayer,
+    pay
   };
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x402z-client-web",
-  "version": "0.0.18",
+  "version": "0.1.0",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -18,7 +18,7 @@
     "@x402/core": "^2.0.0",
     "@x402/evm": "^2.0.0",
     "viem": "^2.39.3",
-    "x402z-shared-web": "0.0.18"
+    "x402z-shared-web": "0.1.0"
   },
   "devDependencies": {
     "jest": "^29.7.0",