x402z-client 0.0.19 → 0.1.2

package/README.md

@@ -26,6 +26,7 @@ const account = privateKeyToAccount("0x...");
 const relayer = await createRelayer(SepoliaConfig);
 
 const client = createX402zClient({
+  preferredMethods: ["erc7984-mind-v1.CONFIDENTIAL_USDC.sepolia"] as const,
   signer: {
     address: account.address,
     signTypedData: account.signTypedData,
@@ -33,28 +34,74 @@ const client = createX402zClient({
   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
 `confidential.batcherAddress` provided by the server’s payment requirements.
 
+## Choosing Payment Methods (Client)
+
+The client picks the **first** preferred method that matches the server’s `accepts` list
+by `scheme + network + asset`.
+
+You can specify preferred methods in two ways:
+
+1) **Name string** (scheme + token + network alias):
+```ts
+preferredMethods: ["exact.USDC.base", "erc7984-mind-v1.CONFIDENTIAL_USDC.sepolia"] as const
+```
+
+2) **Config entry** (from `SCHEME_CONFIG`):
+```ts
+import { SCHEME_CONFIG } from "x402z-scheme-config";
+
+preferredMethods: [
+  SCHEME_CONFIG.exact.USDC.base,
+  SCHEME_CONFIG["erc7984-mind-v1"].CONFIDENTIAL_USDC.sepolia,
+]
+```
+
+If `preferredMethods` is omitted, the client defaults to `SCHEME_CONFIG_NAMES`
+(all known methods, in order).
+
 ## API
 
 - `createX402zClient(config)`
-  - `signer` (required): EIP-712 signer for x402 payloads
-  - `relayer` (required): Zama relayer instance used to build encrypted inputs
+  - `preferredMethods` (optional): ordered list of preferred methods.
+    - Name form: `"exact.USDC.base"` (matches scheme/token/network alias from `x402z-scheme-config`).
+    - Config form: `SCHEME_CONFIG.exact.USDC.base`.
+  - `signer` (required): signer used for both exact and confidential schemes
+  - `relayer` (required when using `erc7984-mind-v1`): Zama relayer instance used to build encrypted inputs
   - `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 scripts (`client-pay.ts`, `client-wrap.ts`, `client-unwrap.ts`).
 
+## Exact scheme (ERC20) usage
+
+```ts
+import { createX402zClient } from "x402z-client";
+import { privateKeyToAccount } from "viem/accounts";
+
+const account = privateKeyToAccount("0x...");
+const client = createX402zClient({
+  preferredMethods: ["exact.USDC.sepolia"] as const,
+  signer: account,
+});
+
+const paid = await client.pay("http://localhost:8090/erc20-demo");
+console.log(paid.response.status);
+```
+
 ## Notes
 
-- Scheme name: `erc7984-mind-v1`
+- Confidential scheme name: `erc7984-mind-v1`
+- Exact scheme name: `exact`
 - The client does not expose balance helpers; use `x402z-shared` for that.
 - For browser usage, use `x402z-client-web` with `x402z-shared-web`.
 
@@ -71,7 +118,10 @@ Exports:
 Types:
 - `X402zClientSchemeOptions`: scheme config for client registration.
 - `X402zClientRegistrationOptions`: registration options for the scheme.
+- `PreferredPaymentMethod`: preferred payment method selector (object form or scheme-config name string).
 - `X402zClientOptions`: options for `createX402zClient`.
+- `X402zConfidentialClientOptions`: options for confidential payments.
+- `X402zExactClientOptions`: options for exact payments.
 - `PayOptions`: per-request payment options.
 - `AfterPaymentCreationHook`: hook after a payment is built.
 - `BeforePaymentCreationHook`: hook before a payment is built.

package/dist/index.d.mts

@@ -1,9 +1,10 @@
-import { SchemeNetworkClient, PaymentRequirements, PaymentPayload, Network } from '@x402/core/types';
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload, Network, PaymentRequired } from '@x402/core/types';
 export * from '@x402/core/types';
 import { ClientEvmSigner } from '@x402/evm';
 import { ConfidentialPaymentInput, RelayerInstance } from 'x402z-shared';
-import { x402Client } from '@x402/core/client';
+import { x402Client, SelectPaymentRequirements, PaymentPolicy } from '@x402/core/client';
 export { AfterPaymentCreationHook, BeforePaymentCreationHook, OnPaymentCreationFailureHook, PaymentCreatedContext, PaymentCreationContext, PaymentCreationFailureContext, PaymentPolicy, SchemeRegistration, SelectPaymentRequirements, x402Client, x402ClientConfig, x402HTTPClient } from '@x402/core/client';
+import { SchemeConfigName, ExactTokenConfig, ConfidentialTokenConfig } from 'x402z-scheme-config';
 
 type X402zClientSchemeOptions = {
     signer: ClientEvmSigner;
@@ -31,16 +32,38 @@ declare function registerX402zEvmClientScheme(client: x402Client, config: X402zC
 
 declare function buildPaymentInput(relayer: RelayerInstance, requirements: PaymentRequirements, amount: number): Promise<ConfidentialPaymentInput>;
 
-type X402zClientOptions = Omit<X402zClientRegistrationOptions, "buildPayment"> & {
-    relayer: RelayerInstance;
+type PreferredPaymentMethod = SchemeConfigName | ExactTokenConfig | ConfidentialTokenConfig;
+type BaseClientOptions = {
     fetch?: typeof fetch;
     debug?: boolean;
 };
+type X402zClientOptions = {
+    preferredMethods?: readonly PreferredPaymentMethod[];
+    signer: ClientEvmSigner;
+    relayer?: RelayerInstance;
+    networks?: Network[];
+    paymentRequirementsSelector?: SelectPaymentRequirements;
+    policies?: PaymentPolicy[];
+    eip712?: X402zClientSchemeOptions["eip712"];
+    hashEncryptedAmountInput?: X402zClientSchemeOptions["hashEncryptedAmountInput"];
+    clock?: X402zClientSchemeOptions["clock"];
+    onPaymentSelected?: (info: {
+        method: PreferredPaymentMethod;
+        requirements: PaymentRequirements;
+    }) => void;
+} & BaseClientOptions;
 type PayOptions = {
     headers?: Record<string, string>;
 };
-declare function createX402zClient(config: X402zClientOptions): {
-    pay(url: string, options?: PayOptions): Promise<Response>;
+type PayResult = {
+    response: Response;
+    paymentRequired?: PaymentRequired;
+    confidentialRequirements?: PaymentRequirements;
+};
+type X402zClient = {
+    relayer?: RelayerInstance;
+    pay: (url: string, options?: PayOptions) => Promise<PayResult>;
 };
+declare function createX402zClient(config: X402zClientOptions): X402zClient;
 
-export { type PayOptions, type X402zClientOptions, type X402zClientRegistrationOptions, type X402zClientSchemeOptions, X402zEvmClientScheme, buildPaymentInput, createX402zClient, registerX402zEvmClientScheme };
+export { type PayOptions, type PayResult, type PreferredPaymentMethod, type X402zClient, type X402zClientOptions, type X402zClientRegistrationOptions, type X402zClientSchemeOptions, X402zEvmClientScheme, buildPaymentInput, createX402zClient, registerX402zEvmClientScheme };

package/dist/index.d.ts

@@ -1,9 +1,10 @@
-import { SchemeNetworkClient, PaymentRequirements, PaymentPayload, Network } from '@x402/core/types';
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload, Network, PaymentRequired } from '@x402/core/types';
 export * from '@x402/core/types';
 import { ClientEvmSigner } from '@x402/evm';
 import { ConfidentialPaymentInput, RelayerInstance } from 'x402z-shared';
-import { x402Client } from '@x402/core/client';
+import { x402Client, SelectPaymentRequirements, PaymentPolicy } from '@x402/core/client';
 export { AfterPaymentCreationHook, BeforePaymentCreationHook, OnPaymentCreationFailureHook, PaymentCreatedContext, PaymentCreationContext, PaymentCreationFailureContext, PaymentPolicy, SchemeRegistration, SelectPaymentRequirements, x402Client, x402ClientConfig, x402HTTPClient } from '@x402/core/client';
+import { SchemeConfigName, ExactTokenConfig, ConfidentialTokenConfig } from 'x402z-scheme-config';
 
 type X402zClientSchemeOptions = {
     signer: ClientEvmSigner;
@@ -31,16 +32,38 @@ declare function registerX402zEvmClientScheme(client: x402Client, config: X402zC
 
 declare function buildPaymentInput(relayer: RelayerInstance, requirements: PaymentRequirements, amount: number): Promise<ConfidentialPaymentInput>;
 
-type X402zClientOptions = Omit<X402zClientRegistrationOptions, "buildPayment"> & {
-    relayer: RelayerInstance;
+type PreferredPaymentMethod = SchemeConfigName | ExactTokenConfig | ConfidentialTokenConfig;
+type BaseClientOptions = {
     fetch?: typeof fetch;
     debug?: boolean;
 };
+type X402zClientOptions = {
+    preferredMethods?: readonly PreferredPaymentMethod[];
+    signer: ClientEvmSigner;
+    relayer?: RelayerInstance;
+    networks?: Network[];
+    paymentRequirementsSelector?: SelectPaymentRequirements;
+    policies?: PaymentPolicy[];
+    eip712?: X402zClientSchemeOptions["eip712"];
+    hashEncryptedAmountInput?: X402zClientSchemeOptions["hashEncryptedAmountInput"];
+    clock?: X402zClientSchemeOptions["clock"];
+    onPaymentSelected?: (info: {
+        method: PreferredPaymentMethod;
+        requirements: PaymentRequirements;
+    }) => void;
+} & BaseClientOptions;
 type PayOptions = {
     headers?: Record<string, string>;
 };
-declare function createX402zClient(config: X402zClientOptions): {
-    pay(url: string, options?: PayOptions): Promise<Response>;
+type PayResult = {
+    response: Response;
+    paymentRequired?: PaymentRequired;
+    confidentialRequirements?: PaymentRequirements;
+};
+type X402zClient = {
+    relayer?: RelayerInstance;
+    pay: (url: string, options?: PayOptions) => Promise<PayResult>;
 };
+declare function createX402zClient(config: X402zClientOptions): X402zClient;
 
-export { type PayOptions, type X402zClientOptions, type X402zClientRegistrationOptions, type X402zClientSchemeOptions, X402zEvmClientScheme, buildPaymentInput, createX402zClient, registerX402zEvmClientScheme };
+export { type PayOptions, type PayResult, type PreferredPaymentMethod, type X402zClient, type X402zClientOptions, type X402zClientRegistrationOptions, type X402zClientSchemeOptions, X402zEvmClientScheme, buildPaymentInput, createX402zClient, registerX402zEvmClientScheme };

package/dist/index.js

@@ -24,8 +24,8 @@ __export(index_exports, {
   buildPaymentInput: () => buildPaymentInput,
   createX402zClient: () => createX402zClient,
   registerX402zEvmClientScheme: () => registerX402zEvmClientScheme,
-  x402Client: () => import_client3.x402Client,
-  x402HTTPClient: () => import_client3.x402HTTPClient
+  x402Client: () => import_client4.x402Client,
+  x402HTTPClient: () => import_client4.x402HTTPClient
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -147,18 +147,59 @@ async function buildPaymentInput(relayer, requirements, amount) {
 // 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_shared3 = require("x402z-shared");
-function createX402zClient(config) {
-  const { fetch: fetchOverride, ...registerConfig } = config;
-  const fetchFn = fetchOverride ?? globalThis.fetch;
-  const debugEnabled = config.debug ?? process.env.X402Z_DEBUG === "1";
-  if (!fetchFn) {
-    throw new Error("fetch is not available; provide a fetch implementation");
+var import_x402z_scheme_config = require("x402z-scheme-config");
+function resolvePreferredMethod(method) {
+  if (typeof method !== "string") {
+    return method;
+  }
+  const config = (0, import_x402z_scheme_config.getSchemeConfigByName)(method);
+  if (!config) {
+    throw new Error(`Unknown preferred method: ${method}`);
   }
+  return config;
+}
+function matchesMethod(requirements, method) {
+  const resolved = resolvePreferredMethod(method);
+  const scheme = (0, import_x402z_scheme_config.isConfidentialTokenConfig)(resolved) ? "erc7984-mind-v1" : "exact";
+  if (requirements.scheme !== scheme) return false;
+  if (requirements.network !== resolved.network) return false;
+  if (requirements.asset && requirements.asset?.toLowerCase() !== resolved.asset.toLowerCase()) return false;
+  return true;
+}
+function filterPaymentRequired(paymentRequired, method) {
+  const accepts = paymentRequired.accepts.filter(
+    (requirement) => matchesMethod(requirement, method)
+  );
+  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;
@@ -185,51 +226,131 @@ 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 {
-    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(() => ({}))
-      );
+    relayer: config.relayer,
+    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 ?? process.env.X402Z_DEBUG === "1";
+  if (!fetchFn) {
+    throw new Error("fetch is not available; provide a fetch implementation");
+  }
+  const preferredMethods = config.preferredMethods?.length ? [...config.preferredMethods] : import_x402z_scheme_config.SCHEME_CONFIG_NAMES;
+  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 selectedMethod = preferredMethods.find(
+      (method) => paymentRequired.accepts.some(
+        (requirement) => matchesMethod(requirement, method)
+      )
+    );
+    if (!selectedMethod) {
+      throw new Error("No preferred payment methods are supported by payment requirements");
+    }
+    const filteredRequirements = filterPaymentRequired(paymentRequired, selectedMethod);
+    if (filteredRequirements.accepts.length === 0) {
+      throw new Error("Missing payment requirements for selected method");
+    }
+    let headersResult;
+    let confidentialRequirements;
+    const selectedRequirements = filteredRequirements.accepts[0];
+    config.onPaymentSelected?.({
+      method: selectedMethod,
+      requirements: selectedRequirements
+    });
+    if (selectedRequirements.scheme === "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
   };
 }
 
 // src/index.ts
-var import_client3 = require("@x402/core/client");
+var import_client4 = require("@x402/core/client");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   X402zEvmClientScheme,

package/dist/index.mjs

@@ -121,20 +121,61 @@ async function buildPaymentInput(relayer, requirements, amount) {
 // 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 as createEncryptedAmountInput2
 } from "x402z-shared";
-function createX402zClient(config) {
-  const { fetch: fetchOverride, ...registerConfig } = config;
-  const fetchFn = fetchOverride ?? globalThis.fetch;
-  const debugEnabled = config.debug ?? process.env.X402Z_DEBUG === "1";
-  if (!fetchFn) {
-    throw new Error("fetch is not available; provide a fetch implementation");
+import { getSchemeConfigByName, SCHEME_CONFIG_NAMES, isConfidentialTokenConfig } from "x402z-scheme-config";
+function resolvePreferredMethod(method) {
+  if (typeof method !== "string") {
+    return method;
+  }
+  const config = getSchemeConfigByName(method);
+  if (!config) {
+    throw new Error(`Unknown preferred method: ${method}`);
   }
+  return config;
+}
+function matchesMethod(requirements, method) {
+  const resolved = resolvePreferredMethod(method);
+  const scheme = isConfidentialTokenConfig(resolved) ? "erc7984-mind-v1" : "exact";
+  if (requirements.scheme !== scheme) return false;
+  if (requirements.network !== resolved.network) return false;
+  if (requirements.asset && requirements.asset?.toLowerCase() !== resolved.asset.toLowerCase()) return false;
+  return true;
+}
+function filterPaymentRequired(paymentRequired, method) {
+  const accepts = paymentRequired.accepts.filter(
+    (requirement) => matchesMethod(requirement, method)
+  );
+  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;
@@ -161,46 +202,126 @@ 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 {
-    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(() => ({}))
-      );
+    relayer: config.relayer,
+    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 ?? process.env.X402Z_DEBUG === "1";
+  if (!fetchFn) {
+    throw new Error("fetch is not available; provide a fetch implementation");
+  }
+  const preferredMethods = config.preferredMethods?.length ? [...config.preferredMethods] : SCHEME_CONFIG_NAMES;
+  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 selectedMethod = preferredMethods.find(
+      (method) => paymentRequired.accepts.some(
+        (requirement) => matchesMethod(requirement, method)
+      )
+    );
+    if (!selectedMethod) {
+      throw new Error("No preferred payment methods are supported by payment requirements");
+    }
+    const filteredRequirements = filterPaymentRequired(paymentRequired, selectedMethod);
+    if (filteredRequirements.accepts.length === 0) {
+      throw new Error("Missing payment requirements for selected method");
+    }
+    let headersResult;
+    let confidentialRequirements;
+    const selectedRequirements = filteredRequirements.accepts[0];
+    config.onPaymentSelected?.({
+      method: selectedMethod,
+      requirements: selectedRequirements
+    });
+    if (selectedRequirements.scheme === "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
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x402z-client",
-  "version": "0.0.19",
+  "version": "0.1.2",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -15,10 +15,11 @@
     }
   },
   "dependencies": {
-    "@x402/core": "^2.0.0",
-    "@x402/evm": "^2.0.0",
+    "@x402/core": "^2.2.0",
+    "@x402/evm": "^2.2.0",
     "viem": "^2.39.3",
-    "x402z-shared": "0.0.19"
+    "x402z-shared": "0.1.2",
+    "x402z-scheme-config": "0.1.2"
   },
   "devDependencies": {
     "jest": "^29.7.0",