x402z-client-web

Browser helpers for the erc7984-mind-v1 x402 scheme.

Install

pnpm add x402z-client-web x402z-shared-web

Folder map

• src/http/: HTTP client helpers
• src/scheme/: scheme implementation + registration
• src/index.ts: public exports

Usage (Browser)

import { createX402zClient } from "x402z-client-web";
import {
  createRelayer,
  getSepoliaConfig,
} from "x402z-shared-web";
import type { FhevmInstanceConfig } from "x402z-shared-web";

const relayerConfig: FhevmInstanceConfig = {
  ...(getSepoliaConfig() as object),
  network: window.ethereum,
  relayerUrl: "https://relayer.testnet.zama.org",
};
const relayer = await createRelayer(relayerConfig);

const client = createX402zClient({
  signer: {
    address: "0x...",
    signTypedData: async args =>
      window.ethereum.request({ method: "eth_signTypedData_v4", params: [args] }),
  },
  relayer,
});

const response = await client.pay("https://example.com/demo");
console.log(response.status);

createX402zClient builds the confidential payment input automatically using the confidential.batcherAddress provided by the server’s payment requirements. createRelayer calls initSDK() automatically on first use.

API

• createX402zClient(config)
  • signer (required): EIP-712 signer for x402 payloads
  • relayer (required): relayer instance (browser)
  • fetch (optional): custom fetch implementation
• client.pay(url, options?): performs the 402 handshake and retries with payment headers

Notes

• Scheme name: erc7984-mind-v1