x402z-client 0.0.10 → 0.1.0

package/README.md

@@ -26,6 +26,7 @@ const account = privateKeyToAccount("0x...");
 const relayer = await createRelayer(SepoliaConfig);
 
 const client = createX402zClient({
+  schemePreference: ["erc7984-mind-v1"],
   signer: {
     address: account.address,
     signTypedData: account.signTypedData,
@@ -33,8 +34,8 @@ 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
@@ -43,13 +44,65 @@ console.log(response.status);
 ## API
 
 - `createX402zClient(config)`
-  - `signer` (required): EIP-712 signer for x402 payloads
-  - `relayer` (required): Zama relayer instance used to build encrypted inputs
+  - `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`): 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({
+  schemePreference: ["exact"],
+  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`.
+
+## API surface
+
+Exports:
+- `X402zEvmClientScheme`: client scheme implementation for erc7984-mind-v1.
+- `registerX402zEvmClientScheme`: registers the scheme with x402 client.
+- `buildPaymentInput`: builds encrypted payment input for a requirement.
+- `createX402zClient`: convenience client wrapper for pay flows.
+- `x402Client`: core x402 client constructor.
+- `x402HTTPClient`: core HTTP client wrapper.
+
+Types:
+- `X402zClientSchemeOptions`: scheme config for client registration.
+- `X402zClientRegistrationOptions`: registration options for the scheme.
+- `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.
+- `OnPaymentCreationFailureHook`: hook on payment build failures.
+- `PaymentCreatedContext`: context for successful payment creation.
+- `PaymentCreationContext`: context for payment creation.
+- `PaymentCreationFailureContext`: context for payment errors.
+- `PaymentPolicy`: policy for selecting payment requirements.
+- `SchemeRegistration`: generic scheme registration type.
+- `SelectPaymentRequirements`: selection callback for requirements.
+- `x402ClientConfig`: x402 client configuration type.
+- re-exported types from `@x402/core/types`: shared x402 types.

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-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';
 
 type X402zClientSchemeOptions = {
@@ -31,16 +31,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 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>;
 };
-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 X402zClientOptions, type X402zClientRegistrationOptions, type X402zClientSchemeOptions, X402zEvmClientScheme, buildPaymentInput, createX402zClient, registerX402zEvmClientScheme };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-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';
 
 type X402zClientSchemeOptions = {
@@ -31,16 +31,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 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>;
 };
-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 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,38 @@ 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");
-  }
+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;
@@ -185,51 +205,132 @@ 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 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
   };
 }
 
 // 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,40 @@ 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");
-  }
+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;
@@ -161,46 +181,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 {
-    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 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
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x402z-client",
-  "version": "0.0.10",
+  "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": "0.0.10"
+    "x402z-shared": "0.1.0"
   },
   "devDependencies": {
     "jest": "^29.7.0",