x402z-client

Client-side helpers for the erc7984-mind-v1 x402 scheme.

Install

pnpm add x402z-client x402z-shared

Folder map

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

Usage

import { createX402zClient } from "x402z-client";
import { createRelayer, SepoliaConfig } from "x402z-shared";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount("0x...");
const relayer = await createRelayer(SepoliaConfig);

const client = createX402zClient({
  signer: {
    address: account.address,
    signTypedData: account.signTypedData,
  },
  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.

API

• createX402zClient(config)
  • signer (required): EIP-712 signer for x402 payloads
  • relayer (required): 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

Notes

• Scheme name: erc7984-mind-v1
• The client does not expose balance helpers; use x402z-shared for that.
• For browser usage, use x402z-client-web with x402z-shared-web.