@remitmd/sdk 0.1.0

package/dist/wallet.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Wallet — read + write operations, requires a private key (or custom Signer).
+ */
+import { RemitClient, type RemitClientOptions } from "./client.js";
+import { type Signer } from "./signer.js";
+import { type PaymentRequired } from "./x402.js";
+import type { Transaction, WalletStatus, Webhook, LinkResponse } from "./models/index.js";
+import type { Invoice } from "./models/invoice.js";
+import type { Escrow } from "./models/escrow.js";
+import type { Tab, TabCharge } from "./models/tab.js";
+import type { Stream } from "./models/stream.js";
+import type { Bounty } from "./models/bounty.js";
+import type { Deposit } from "./models/deposit.js";
+export interface WalletOptions extends RemitClientOptions {
+    privateKey?: string;
+    signer?: Signer;
+    /** Router contract address for EIP-712 domain — must match server's ROUTER_ADDRESS. */
+    routerAddress?: string;
+    /** JSON-RPC URL for on-chain reads (nonce fetching). Falls back to REMITMD_RPC_URL env var, then public defaults. */
+    rpcUrl?: string;
+}
+export interface OpenTabOptions {
+    to: string;
+    limit: number;
+    perUnit: number;
+    expires?: number;
+    /** Optional EIP-2612 permit for gasless USDC approval. */
+    permit?: PermitSignature;
+}
+export interface CloseTabOptions {
+    /** Final charged amount in USDC. Defaults to 0 (full refund). */
+    finalAmount?: number;
+    /** Provider's EIP-712 TabCharge signature covering the final state. */
+    providerSig?: string;
+}
+export interface ChargeTabOptions {
+    amount: number;
+    cumulative: number;
+    callCount: number;
+    /** Provider's EIP-712 TabCharge signature. */
+    providerSig: string;
+}
+export interface OpenStreamOptions {
+    to: string;
+    rate: number;
+    maxDuration?: number;
+    maxTotal?: number;
+    /** Optional EIP-2612 permit for gasless USDC approval. */
+    permit?: PermitSignature;
+}
+/** EIP-2612 permit signature for gasless USDC approval. */
+export interface PermitSignature {
+    value: number;
+    deadline: number;
+    v: number;
+    r: string;
+    s: string;
+}
+/** Options for signing an EIP-2612 USDC permit. */
+export interface SignPermitOptions {
+    /** Contract address that will be approved as spender. */
+    spender: string;
+    /** Amount in USDC base units (6 decimals). */
+    value: bigint;
+    /** Permit deadline (Unix timestamp). */
+    deadline: number;
+    /** Current permit nonce for this wallet (default: 0). */
+    nonce?: number;
+    /** USDC contract address (defaults to Base Sepolia MockUSDC). */
+    usdcAddress?: string;
+}
+export interface PostBountyOptions {
+    amount: number;
+    task: string;
+    deadline: number;
+    validation?: "poster" | "oracle" | "multisig";
+    maxAttempts?: number;
+    /** Optional EIP-2612 permit for gasless USDC approval. */
+    permit?: PermitSignature;
+}
+export interface PlaceDepositOptions {
+    to: string;
+    amount: number;
+    expires: number;
+    /** Optional EIP-2612 permit for gasless USDC approval. */
+    permit?: PermitSignature;
+}
+export declare class Wallet extends RemitClient {
+    #private;
+    constructor(options?: WalletOptions);
+    /** Generate a new random wallet (for testing / onboarding). */
+    static create(options?: RemitClientOptions): Wallet;
+    /** Load from REMITMD_KEY and REMITMD_CHAIN environment variables. */
+    static fromEnv(overrides?: RemitClientOptions): Wallet;
+    /** Checksummed public address. */
+    get address(): string;
+    /** Prevent private key leakage. */
+    toJSON(): Record<string, string>;
+    /** Default USDC addresses per chain. */
+    static readonly USDC_ADDRESSES: Record<string, string>;
+    /**
+     * Sign an EIP-2612 permit for USDC approval.
+     * Returns a PermitSignature object that can be passed to postBounty() or placeDeposit().
+     */
+    signUsdcPermit(options: SignPermitOptions): Promise<PermitSignature>;
+    /**
+     * Convenience: sign an EIP-2612 permit for USDC approval.
+     * Auto-fetches the on-chain nonce and sets a default deadline (1 hour).
+     * @param spender Contract address that will call transferFrom (e.g. Router, Escrow).
+     * @param amount Amount in USDC (e.g. 1.50 for $1.50).
+     * @param deadline Optional Unix timestamp. Defaults to 1 hour from now.
+     */
+    signPermit(spender: string, amount: number, deadline?: number): Promise<PermitSignature>;
+    payDirect(to: string, amount: number, memo?: string, options?: {
+        permit?: PermitSignature;
+    }): Promise<Transaction>;
+    pay(invoice: Invoice, options?: {
+        permit?: PermitSignature;
+    }): Promise<Escrow>;
+    claimStart(invoiceId: string): Promise<Transaction>;
+    submitEvidence(invoiceId: string, evidenceUri: string, milestoneIndex?: number): Promise<Transaction>;
+    releaseEscrow(invoiceId: string): Promise<Transaction>;
+    releaseMilestone(invoiceId: string, milestoneIndex: number): Promise<Transaction>;
+    cancelEscrow(invoiceId: string): Promise<Transaction>;
+    openTab(options: OpenTabOptions): Promise<Tab>;
+    /** Sign a TabCharge EIP-712 message (provider-side, for charging or closing a tab). */
+    signTabCharge(tabContract: string, tabId: string, totalCharged: bigint, callCount: number): Promise<string>;
+    /** Charge a tab (provider-side). Requires a TabCharge EIP-712 signature. */
+    chargeTab(tabId: string, options: ChargeTabOptions): Promise<TabCharge>;
+    closeTab(tabId: string, options?: CloseTabOptions): Promise<Transaction>;
+    openStream(options: OpenStreamOptions): Promise<Stream>;
+    closeStream(streamId: string): Promise<Transaction>;
+    postBounty(options: PostBountyOptions): Promise<Bounty>;
+    submitBounty(bountyId: string, evidenceHash: string, evidenceUri?: string): Promise<Transaction>;
+    awardBounty(bountyId: string, submissionId: number): Promise<Transaction>;
+    placeDeposit(options: PlaceDepositOptions): Promise<Deposit>;
+    returnDeposit(depositId: string): Promise<Transaction>;
+    /** GET /escrows/{id} — authenticated; server requires auth to access escrow details. */
+    getEscrow(invoiceId: string): Promise<Escrow>;
+    /** GET /tabs/{id} — authenticated; server requires auth to access tab details. */
+    getTab(tabId: string): Promise<Tab>;
+    status(): Promise<WalletStatus>;
+    balance(): Promise<number>;
+    registerWebhook(url: string, events: string[], chains?: string[]): Promise<Webhook>;
+    /** Generate a one-time URL for the operator to fund this wallet. */
+    createFundLink(): Promise<LinkResponse>;
+    /** Generate a one-time URL for the operator to withdraw funds. */
+    createWithdrawLink(): Promise<LinkResponse>;
+    /** @deprecated Use mint() instead. Faucet endpoint returns 410 Gone. */
+    requestTestnetFunds(): Promise<Transaction>;
+    /** Mint testnet USDC via POST /mint. Max $2,500 per call, once per hour per wallet. */
+    mint(amount: number): Promise<{
+        tx_hash: string;
+        balance: number;
+    }>;
+    /** Make a fetch request, auto-paying any x402 402 responses within maxAutoPayUsdc. */
+    x402Fetch(url: string, maxAutoPayUsdc?: number, init?: RequestInit): Promise<{
+        response: Response;
+        lastPayment: PaymentRequired | null;
+    }>;
+}
+//# sourceMappingURL=wallet.d.ts.map

package/dist/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../src/wallet.ts"],"names":[],"mappings":"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"}

package/dist/wallet.js

@@ -0,0 +1,365 @@
+/**
+ * Wallet — read + write operations, requires a private key (or custom Signer).
+ */
+import { randomBytes } from "node:crypto";
+import { generatePrivateKey } from "viem/accounts";
+import { RemitClient } from "./client.js";
+import { AuthenticatedClient } from "./http.js";
+import { PrivateKeySigner } from "./signer.js";
+import { X402Client } from "./x402.js";
+/** Default public RPC URLs per chain. */
+const DEFAULT_RPC_URLS = {
+    "base-sepolia": "https://sepolia.base.org",
+    base: "https://mainnet.base.org",
+    localhost: "http://127.0.0.1:8545",
+};
+/**
+ * Convert a UUID string to bytes32 matching the server's id_to_bytes32().
+ * Encodes the UUID's UTF-8 bytes, left-aligned, zero-padded to 32.
+ */
+function uuidToBytes32(uuid) {
+    const padded = new Uint8Array(32);
+    for (let i = 0; i < Math.min(uuid.length, 32); i++) {
+        padded[i] = uuid.charCodeAt(i);
+    }
+    return ("0x" + Array.from(padded, (b) => b.toString(16).padStart(2, "0")).join(""));
+}
+export class Wallet extends RemitClient {
+    #signer;
+    #auth;
+    #rpcUrl;
+    constructor(options = {}) {
+        const { privateKey: explicitKey, signer, routerAddress, rpcUrl, ...clientOptions } = options;
+        const privateKey = explicitKey ?? (!signer ? process.env["REMITMD_KEY"] : undefined);
+        if (!privateKey && !signer) {
+            throw new Error("Wallet requires privateKey, signer, or the REMITMD_KEY environment variable.");
+        }
+        super(clientOptions);
+        this.#rpcUrl = rpcUrl ?? process.env["REMITMD_RPC_URL"] ?? DEFAULT_RPC_URLS[this._chain] ?? DEFAULT_RPC_URLS["base-sepolia"];
+        // Router contract address for EIP-712 domain — falls back to env var.
+        const verifyingContract = routerAddress ?? process.env["REMITMD_ROUTER_ADDRESS"] ?? "";
+        this.#signer = signer ?? new PrivateKeySigner(privateKey);
+        this.#auth = new AuthenticatedClient({
+            signer: this.#signer,
+            baseUrl: this._apiUrl,
+            chainId: this._chainId,
+            verifyingContract,
+        });
+    }
+    /** Generate a new random wallet (for testing / onboarding). */
+    static create(options) {
+        const key = generatePrivateKey();
+        return new Wallet({ ...options, privateKey: key });
+    }
+    /** Load from REMITMD_KEY and REMITMD_CHAIN environment variables. */
+    static fromEnv(overrides) {
+        const key = process.env["REMITMD_KEY"];
+        const chain = process.env["REMITMD_CHAIN"] ?? "base";
+        if (!key)
+            throw new Error("REMITMD_KEY environment variable is not set.");
+        return new Wallet({ chain, ...overrides, privateKey: key });
+    }
+    /** Checksummed public address. */
+    get address() {
+        return this.#signer.getAddress();
+    }
+    /** Prevent private key leakage. */
+    toJSON() {
+        return { address: this.address, chain: this._chain };
+    }
+    [Symbol.for("nodejs.util.inspect.custom")]() {
+        return `Wallet { address: '${this.address}', chain: '${this._chain}' }`;
+    }
+    // ─── EIP-2612 Permit ─────────────────────────────────────────────────────────
+    /** Default USDC addresses per chain. */
+    static USDC_ADDRESSES = {
+        "base-sepolia": "0x142aD61B8d2edD6b3807D9266866D97C35Ee0317",
+        base: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+        localhost: "0x5FbDB2315678afecb367f032d93F642f64180aa3",
+    };
+    /**
+     * Sign an EIP-2612 permit for USDC approval.
+     * Returns a PermitSignature object that can be passed to postBounty() or placeDeposit().
+     */
+    async signUsdcPermit(options) {
+        const usdcAddress = options.usdcAddress ?? Wallet.USDC_ADDRESSES[this._chain] ?? "";
+        const domain = {
+            name: "USD Coin",
+            version: "2",
+            chainId: this._chainId,
+            verifyingContract: usdcAddress,
+        };
+        const types = {
+            Permit: [
+                { name: "owner", type: "address" },
+                { name: "spender", type: "address" },
+                { name: "value", type: "uint256" },
+                { name: "nonce", type: "uint256" },
+                { name: "deadline", type: "uint256" },
+            ],
+        };
+        const value = {
+            owner: this.address,
+            spender: options.spender,
+            value: options.value.toString(),
+            nonce: options.nonce ?? 0,
+            deadline: options.deadline,
+        };
+        const sig = await this.#signer.signTypedData(domain, types, value);
+        // Split signature into v, r, s
+        const sigBytes = sig.startsWith("0x") ? sig.slice(2) : sig;
+        const r = `0x${sigBytes.slice(0, 64)}`;
+        const s = `0x${sigBytes.slice(64, 128)}`;
+        const v = parseInt(sigBytes.slice(128, 130), 16);
+        return {
+            value: Number(options.value),
+            deadline: options.deadline,
+            v,
+            r,
+            s,
+        };
+    }
+    /**
+     * Convenience: sign an EIP-2612 permit for USDC approval.
+     * Auto-fetches the on-chain nonce and sets a default deadline (1 hour).
+     * @param spender Contract address that will call transferFrom (e.g. Router, Escrow).
+     * @param amount Amount in USDC (e.g. 1.50 for $1.50).
+     * @param deadline Optional Unix timestamp. Defaults to 1 hour from now.
+     */
+    async signPermit(spender, amount, deadline) {
+        const usdcAddress = Wallet.USDC_ADDRESSES[this._chain] ?? "";
+        const nonce = await this.#fetchUsdcNonce(usdcAddress);
+        const dl = deadline ?? Math.floor(Date.now() / 1000) + 3600;
+        const rawAmount = BigInt(Math.round(amount * 1e6));
+        return this.signUsdcPermit({
+            spender,
+            value: rawAmount,
+            deadline: dl,
+            nonce,
+            usdcAddress,
+        });
+    }
+    /** Fetch the current EIP-2612 nonce for this wallet from the USDC contract via JSON-RPC. */
+    async #fetchUsdcNonce(usdcAddress) {
+        // nonces(address) selector = 0x7ecebe00 + address padded to 32 bytes
+        const paddedAddress = this.address.toLowerCase().replace("0x", "").padStart(64, "0");
+        const data = `0x7ecebe00${paddedAddress}`;
+        const response = await fetch(this.#rpcUrl, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                jsonrpc: "2.0",
+                id: 1,
+                method: "eth_call",
+                params: [{ to: usdcAddress, data }, "latest"],
+            }),
+        });
+        const json = await response.json();
+        if (json.error)
+            throw new Error(`RPC error fetching nonce: ${json.error.message}`);
+        return parseInt(json.result ?? "0x0", 16);
+    }
+    // ─── Direct Payment ─────────────────────────────────────────────────────────
+    payDirect(to, amount, memo = "", options) {
+        return this.#auth.post("/payments/direct", {
+            to,
+            amount,
+            task: memo,
+            chain: this._chain,
+            nonce: randomBytes(16).toString("hex"),
+            signature: "0x",
+            ...(options?.permit ? { permit: options.permit } : {}),
+        });
+    }
+    // ─── Escrow ─────────────────────────────────────────────────────────────────
+    async pay(invoice, options) {
+        // Step 1: create invoice on server.
+        const invoiceId = invoice.id || randomBytes(16).toString("hex");
+        await this.#auth.post("/invoices", {
+            id: invoiceId,
+            chain: invoice.chain || this._chain,
+            from_agent: this.address.toLowerCase(),
+            to_agent: invoice.to.toLowerCase(),
+            amount: invoice.amount,
+            type: invoice.paymentType ?? "escrow",
+            task: invoice.memo ?? "",
+            nonce: randomBytes(16).toString("hex"),
+            signature: "0x",
+            ...(invoice.timeout ? { escrow_timeout: invoice.timeout } : {}),
+        });
+        // Step 2: fund the escrow and return it.
+        return this.#auth.post("/escrows", {
+            invoice_id: invoiceId,
+            ...(options?.permit ? { permit: options.permit } : {}),
+        });
+    }
+    claimStart(invoiceId) {
+        return this.#auth.post(`/escrows/${invoiceId}/claim-start`, {});
+    }
+    submitEvidence(invoiceId, evidenceUri, milestoneIndex = 0) {
+        return this.#auth.post(`/escrows/${invoiceId}/evidence`, {
+            evidenceUri,
+            milestoneIndex,
+        });
+    }
+    releaseEscrow(invoiceId) {
+        return this.#auth.post(`/escrows/${invoiceId}/release`, {});
+    }
+    releaseMilestone(invoiceId, milestoneIndex) {
+        return this.#auth.post(`/escrows/${invoiceId}/milestones/${milestoneIndex}/release`, {});
+    }
+    cancelEscrow(invoiceId) {
+        return this.#auth.post(`/escrows/${invoiceId}/cancel`, {});
+    }
+    // ─── Metered Tabs ───────────────────────────────────────────────────────────
+    openTab(options) {
+        return this.#auth.post("/tabs", {
+            chain: this._chain,
+            provider: options.to,
+            limit_amount: options.limit,
+            per_unit: options.perUnit,
+            expiry: Math.floor(Date.now() / 1000) + (options.expires ?? 86400),
+            ...(options.permit ? { permit: options.permit } : {}),
+        });
+    }
+    /** Sign a TabCharge EIP-712 message (provider-side, for charging or closing a tab). */
+    async signTabCharge(tabContract, tabId, totalCharged, callCount) {
+        return this.#signer.signTypedData({
+            name: "RemitTab",
+            version: "1",
+            chainId: this._chainId,
+            verifyingContract: tabContract,
+        }, {
+            TabCharge: [
+                { name: "tabId", type: "bytes32" },
+                { name: "totalCharged", type: "uint96" },
+                { name: "callCount", type: "uint32" },
+            ],
+        }, {
+            tabId: uuidToBytes32(tabId),
+            totalCharged,
+            callCount,
+        });
+    }
+    /** Charge a tab (provider-side). Requires a TabCharge EIP-712 signature. */
+    chargeTab(tabId, options) {
+        return this.#auth.post(`/tabs/${tabId}/charge`, {
+            amount: options.amount,
+            cumulative: options.cumulative,
+            call_count: options.callCount,
+            provider_sig: options.providerSig,
+        });
+    }
+    closeTab(tabId, options) {
+        return this.#auth.post(`/tabs/${tabId}/close`, {
+            final_amount: options?.finalAmount ?? 0,
+            provider_sig: options?.providerSig ?? "0x",
+        });
+    }
+    // ─── Streaming ──────────────────────────────────────────────────────────────
+    openStream(options) {
+        return this.#auth.post("/streams", {
+            chain: this._chain,
+            payee: options.to,
+            rate_per_second: options.rate,
+            max_total: options.maxTotal,
+            ...(options.permit ? { permit: options.permit } : {}),
+        });
+    }
+    closeStream(streamId) {
+        return this.#auth.post(`/streams/${streamId}/close`);
+    }
+    // ─── Bounties ───────────────────────────────────────────────────────────────
+    postBounty(options) {
+        return this.#auth.post("/bounties", {
+            chain: this._chain,
+            amount: options.amount,
+            task_description: options.task,
+            deadline: options.deadline,
+            max_attempts: options.maxAttempts ?? 10,
+            ...(options.permit ? { permit: options.permit } : {}),
+        });
+    }
+    submitBounty(bountyId, evidenceHash, evidenceUri) {
+        return this.#auth.post(`/bounties/${bountyId}/submit`, {
+            evidence_hash: evidenceHash,
+            ...(evidenceUri ? { evidence_uri: evidenceUri } : {}),
+        });
+    }
+    awardBounty(bountyId, submissionId) {
+        return this.#auth.post(`/bounties/${bountyId}/award`, { submission_id: submissionId });
+    }
+    // ─── Deposits ───────────────────────────────────────────────────────────────
+    placeDeposit(options) {
+        return this.#auth.post("/deposits", {
+            chain: this._chain,
+            provider: options.to,
+            amount: options.amount,
+            expiry: Math.floor(Date.now() / 1000) + options.expires,
+            ...(options.permit ? { permit: options.permit } : {}),
+        });
+    }
+    returnDeposit(depositId) {
+        return this.#auth.post(`/deposits/${depositId}/return`, {});
+    }
+    // ─── Authenticated reads (override unauthenticated base class versions) ──────
+    /** GET /escrows/{id} — authenticated; server requires auth to access escrow details. */
+    getEscrow(invoiceId) {
+        return this.#auth.get(`/escrows/${invoiceId}`);
+    }
+    /** GET /tabs/{id} — authenticated; server requires auth to access tab details. */
+    getTab(tabId) {
+        return this.#auth.get(`/tabs/${tabId}`);
+    }
+    // ─── Status ─────────────────────────────────────────────────────────────────
+    status() {
+        return this.#auth.get(`/status/${this.address}`);
+    }
+    async balance() {
+        const s = await this.status();
+        return parseFloat(s.balance);
+    }
+    // ─── Webhooks ───────────────────────────────────────────────────────────────
+    registerWebhook(url, events, chains) {
+        return this.#auth.post("/webhooks", {
+            url,
+            events,
+            chains: chains ?? [this._chain],
+        });
+    }
+    // ─── One-time operator links ─────────────────────────────────────────────────
+    /** Generate a one-time URL for the operator to fund this wallet. */
+    createFundLink() {
+        return this.#auth.post("/links/fund", {});
+    }
+    /** Generate a one-time URL for the operator to withdraw funds. */
+    createWithdrawLink() {
+        return this.#auth.post("/links/withdraw", {});
+    }
+    // ─── Testnet ────────────────────────────────────────────────────────────────
+    /** @deprecated Use mint() instead. Faucet endpoint returns 410 Gone. */
+    requestTestnetFunds() {
+        return this.#auth.post("/faucet", { wallet: this.address });
+    }
+    /** Mint testnet USDC via POST /mint. Max $2,500 per call, once per hour per wallet. */
+    async mint(amount) {
+        const res = await fetch(`${this._apiUrl}/mint`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ wallet: this.address, amount }),
+        });
+        if (!res.ok) {
+            const body = await res.json().catch(() => ({}));
+            throw new Error(`mint failed (${res.status}): ${body.message ?? res.statusText}`);
+        }
+        return res.json();
+    }
+    // ─── x402 ───────────────────────────────────────────────────────────────────
+    /** Make a fetch request, auto-paying any x402 402 responses within maxAutoPayUsdc. */
+    async x402Fetch(url, maxAutoPayUsdc = 0.1, init) {
+        const client = new X402Client({ signer: this.#signer, address: this.address, maxAutoPayUsdc });
+        const response = await client.fetch(url, init);
+        return { response, lastPayment: client.lastPayment };
+    }
+}
+//# sourceMappingURL=wallet.js.map

package/dist/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../src/wallet.ts"],"names":[],"mappings":"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"}

package/dist/x402.d.ts

@@ -0,0 +1,78 @@
+/**
+ * x402 client middleware for auto-paying HTTP 402 Payment Required responses.
+ *
+ * x402 is an open payment standard where resource servers return HTTP 402 with
+ * a `PAYMENT-REQUIRED` header describing the cost. This module provides a
+ * `fetch` wrapper that intercepts those responses, signs an EIP-3009
+ * authorization, and retries the request with a `PAYMENT-SIGNATURE` header.
+ *
+ * Usage:
+ *   ```typescript
+ *   import { PrivateKeySigner } from "@remitmd/sdk";
+ *   import { X402Client } from "@remitmd/sdk/x402";
+ *
+ *   const signer = new PrivateKeySigner("0x...");
+ *   const client = new X402Client({
+ *     signer,
+ *     address: signer.getAddress(),
+ *     maxAutoPayUsdc: 0.10,
+ *   });
+ *
+ *   const response = await client.fetch("https://api.provider.com/v1/data");
+ *   ```
+ */
+import type { Signer } from "./signer.js";
+/** Raised when an x402 payment amount exceeds the configured auto-pay limit. */
+export declare class AllowanceExceededError extends Error {
+    readonly amountUsdc: number;
+    readonly limitUsdc: number;
+    constructor(amountUsdc: number, limitUsdc: number);
+}
+/** Configuration for {@link X402Client}. */
+export interface X402ClientOptions {
+    /** Signer used for EIP-3009 authorization signatures. */
+    signer: Signer;
+    /** Checksummed payer address — must match the signer's public key. */
+    address: string;
+    /** Maximum USDC amount to auto-pay per request (default: 0.10). */
+    maxAutoPayUsdc?: number;
+}
+/** Shape of the base64-decoded PAYMENT-REQUIRED header (V2). */
+export interface PaymentRequired {
+    scheme: string;
+    network: string;
+    amount: string;
+    asset: string;
+    payTo: string;
+    maxTimeoutSeconds?: number;
+    /** URL or path of the resource being protected (e.g. "/api/v0/data"). */
+    resource?: string;
+    /** Human-readable description of what the payment is for. */
+    description?: string;
+    /** MIME type of the resource (e.g. "application/json"). */
+    mimeType?: string;
+}
+/**
+ * `fetch` wrapper that auto-handles HTTP 402 Payment Required responses.
+ *
+ * On receiving a 402, the client:
+ * 1. Decodes the `PAYMENT-REQUIRED` header (base64 JSON)
+ * 2. Checks the amount is within `maxAutoPayUsdc`
+ * 3. Builds and signs an EIP-3009 `transferWithAuthorization`
+ * 4. Base64-encodes the `PAYMENT-SIGNATURE` header
+ * 5. Retries the original request with payment attached
+ *
+ * V2: The decoded `PAYMENT-REQUIRED` may include `resource`, `description`,
+ * and `mimeType` fields. Access the last payment via `lastPayment`.
+ */
+export declare class X402Client {
+    #private;
+    /** The last PAYMENT-REQUIRED decoded before payment. Useful for logging/display. */
+    lastPayment: PaymentRequired | null;
+    constructor({ signer, address, maxAutoPayUsdc }: X402ClientOptions);
+    /** Make a fetch request, auto-paying any 402 responses within the configured limit. */
+    fetch(url: string, init?: RequestInit): Promise<Response>;
+    /** Prevent address leakage via structured cloning / serialisation. */
+    toJSON(): Record<string, string>;
+}
+//# sourceMappingURL=x402.d.ts.map

package/dist/x402.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.d.ts","sourceRoot":"","sources":["../src/x402.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAc1C,gFAAgF;AAChF,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAQlD;AAED,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAU;;IAIrB,oFAAoF;IACpF,WAAW,EAAE,eAAe,GAAG,IAAI,CAAQ;gBAE/B,EAAE,MAAM,EAAE,OAAO,EAAE,cAAoB,EAAE,EAAE,iBAAiB;IAMxE,uFAAuF;IACjF,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAyF/D,sEAAsE;IACtE,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAGjC"}