@puga-labs/x402-mantle-sdk 0.2.0 → 0.3.1

package/dist/client.d.ts

@@ -0,0 +1,17 @@
+import { P as PaymentClientConfig, b as PaymentClient } from './createMantleClient-DVFkbBfS.js';
+export { C as CallWithPaymentResult, M as MantleClient, a as MantleClientConfig, c as createMantleClient } from './createMantleClient-DVFkbBfS.js';
+export { A as AssetConfig, a as Authorization, E as EIP1193Provider, N as NetworkId, d as PaymentHeaderBase64, c as PaymentHeaderObject, b as PaymentHeaderPayload, P as PaymentRequirements } from './types-2zqbJvcz.js';
+export { M as MANTLE_DEFAULTS } from './constants-CVFF0ray.js';
+
+/**
+ * Creates a high-level payment client that:
+ *  - makes an initial request
+ *  - if it receives 402 + paymentRequirements, builds & signs an authorization
+ *  - calls facilitator /settle
+ *  - retries the original request with X-PAYMENT header
+ *
+ * This logic is x402 and tailored for Mantle + USDC.
+ */
+declare function createPaymentClient(config: PaymentClientConfig): PaymentClient;
+
+export { PaymentClient, PaymentClientConfig, createPaymentClient };

package/dist/client.js

@@ -0,0 +1,12 @@
+import {
+  createMantleClient,
+  createPaymentClient
+} from "./chunk-CTI5CRDY.js";
+import {
+  MANTLE_DEFAULTS
+} from "./chunk-XAQGMFSR.js";
+export {
+  MANTLE_DEFAULTS,
+  createMantleClient,
+  createPaymentClient
+};

package/dist/constants-C7aY8u5b.d.cts

@@ -0,0 +1,77 @@
+/** Network identifier used in x402 paymentRequirements / paymentHeader. */
+type NetworkId = "mantle-mainnet" | (string & {});
+/** Basic ERC-20 asset config (e.g. USDC on Mantle). */
+interface AssetConfig {
+    symbol: string;
+    address: string;
+    decimals: number;
+}
+/** x402-style payment requirements (returned in 402 response). */
+interface PaymentRequirements {
+    scheme: "exact";
+    network: NetworkId;
+    asset: string;
+    maxAmountRequired: string;
+    payTo: `0x${string}`;
+    price?: string;
+    currency?: string;
+}
+/** EIP-3009 TransferWithAuthorization payload. */
+interface Authorization {
+    from: string;
+    to: string;
+    value: string;
+    validAfter: string;
+    validBefore: string;
+    nonce: string;
+}
+/** Inner payload of x402-style payment header. */
+interface PaymentHeaderPayload {
+    signature: string;
+    authorization: Authorization;
+}
+/** Structured x402-style payment header (before base64 encoding). */
+interface PaymentHeaderObject {
+    x402Version: number;
+    scheme: "exact";
+    network: NetworkId;
+    payload: PaymentHeaderPayload;
+}
+/** Base64-encoded payment header, sent in X-PAYMENT. */
+type PaymentHeaderBase64 = string;
+/**
+ * EIP-1193 provider interface (window.ethereum, MetaMask, etc.)
+ * Standard interface for Ethereum wallet providers.
+ */
+interface EIP1193Provider {
+    request(args: {
+        method: string;
+        params?: unknown[];
+    }): Promise<unknown>;
+    on?(event: string, listener: (...args: unknown[]) => void): void;
+    removeListener?(event: string, listener: (...args: unknown[]) => void): void;
+}
+/**
+ * Window ethereum extension for TypeScript
+ */
+declare global {
+    interface Window {
+        ethereum?: EIP1193Provider;
+    }
+}
+
+/**
+ * Default values for Mantle mainnet x402 payments.
+ * These are used by the simplified API (mantlePaywall, createMantleClient).
+ */
+declare const MANTLE_DEFAULTS: {
+    readonly NETWORK: "mantle-mainnet";
+    readonly CHAIN_ID: 5000;
+    readonly USDC_ADDRESS: "0x09Bc4E0D864854c6aFB6eB9A9cdF58aC190D0dF9";
+    readonly USDC_DECIMALS: 6;
+    readonly CURRENCY: "USD";
+    readonly SCHEME: "exact";
+    readonly FACILITATOR_URL: string;
+};
+
+export { type AssetConfig as A, type EIP1193Provider as E, MANTLE_DEFAULTS as M, type NetworkId as N, type PaymentRequirements as P, type Authorization as a, type PaymentHeaderPayload as b, type PaymentHeaderObject as c, type PaymentHeaderBase64 as d };

package/dist/constants-C7aY8u5b.d.ts

@@ -0,0 +1,77 @@
+/** Network identifier used in x402 paymentRequirements / paymentHeader. */
+type NetworkId = "mantle-mainnet" | (string & {});
+/** Basic ERC-20 asset config (e.g. USDC on Mantle). */
+interface AssetConfig {
+    symbol: string;
+    address: string;
+    decimals: number;
+}
+/** x402-style payment requirements (returned in 402 response). */
+interface PaymentRequirements {
+    scheme: "exact";
+    network: NetworkId;
+    asset: string;
+    maxAmountRequired: string;
+    payTo: `0x${string}`;
+    price?: string;
+    currency?: string;
+}
+/** EIP-3009 TransferWithAuthorization payload. */
+interface Authorization {
+    from: string;
+    to: string;
+    value: string;
+    validAfter: string;
+    validBefore: string;
+    nonce: string;
+}
+/** Inner payload of x402-style payment header. */
+interface PaymentHeaderPayload {
+    signature: string;
+    authorization: Authorization;
+}
+/** Structured x402-style payment header (before base64 encoding). */
+interface PaymentHeaderObject {
+    x402Version: number;
+    scheme: "exact";
+    network: NetworkId;
+    payload: PaymentHeaderPayload;
+}
+/** Base64-encoded payment header, sent in X-PAYMENT. */
+type PaymentHeaderBase64 = string;
+/**
+ * EIP-1193 provider interface (window.ethereum, MetaMask, etc.)
+ * Standard interface for Ethereum wallet providers.
+ */
+interface EIP1193Provider {
+    request(args: {
+        method: string;
+        params?: unknown[];
+    }): Promise<unknown>;
+    on?(event: string, listener: (...args: unknown[]) => void): void;
+    removeListener?(event: string, listener: (...args: unknown[]) => void): void;
+}
+/**
+ * Window ethereum extension for TypeScript
+ */
+declare global {
+    interface Window {
+        ethereum?: EIP1193Provider;
+    }
+}
+
+/**
+ * Default values for Mantle mainnet x402 payments.
+ * These are used by the simplified API (mantlePaywall, createMantleClient).
+ */
+declare const MANTLE_DEFAULTS: {
+    readonly NETWORK: "mantle-mainnet";
+    readonly CHAIN_ID: 5000;
+    readonly USDC_ADDRESS: "0x09Bc4E0D864854c6aFB6eB9A9cdF58aC190D0dF9";
+    readonly USDC_DECIMALS: 6;
+    readonly CURRENCY: "USD";
+    readonly SCHEME: "exact";
+    readonly FACILITATOR_URL: string;
+};
+
+export { type AssetConfig as A, type EIP1193Provider as E, MANTLE_DEFAULTS as M, type NetworkId as N, type PaymentRequirements as P, type Authorization as a, type PaymentHeaderPayload as b, type PaymentHeaderObject as c, type PaymentHeaderBase64 as d };

package/dist/constants-CVFF0ray.d.ts

@@ -0,0 +1,17 @@
+import './types-2zqbJvcz.js';
+
+/**
+ * Default values for Mantle mainnet x402 payments.
+ * These are used by the simplified API (mantlePaywall, createMantleClient).
+ */
+declare const MANTLE_DEFAULTS: {
+    readonly NETWORK: "mantle-mainnet";
+    readonly CHAIN_ID: 5000;
+    readonly USDC_ADDRESS: "0x09Bc4E0D864854c6aFB6eB9A9cdF58aC190D0dF9";
+    readonly USDC_DECIMALS: 6;
+    readonly CURRENCY: "USD";
+    readonly SCHEME: "exact";
+    readonly FACILITATOR_URL: string;
+};
+
+export { MANTLE_DEFAULTS as M };

package/dist/constants-DzCGK0Q3.d.cts

@@ -0,0 +1,17 @@
+import './types-2zqbJvcz.cjs';
+
+/**
+ * Default values for Mantle mainnet x402 payments.
+ * These are used by the simplified API (mantlePaywall, createMantleClient).
+ */
+declare const MANTLE_DEFAULTS: {
+    readonly NETWORK: "mantle-mainnet";
+    readonly CHAIN_ID: 5000;
+    readonly USDC_ADDRESS: "0x09Bc4E0D864854c6aFB6eB9A9cdF58aC190D0dF9";
+    readonly USDC_DECIMALS: 6;
+    readonly CURRENCY: "USD";
+    readonly SCHEME: "exact";
+    readonly FACILITATOR_URL: string;
+};
+
+export { MANTLE_DEFAULTS as M };

package/dist/createMantleClient-DS1Ghqrz.d.cts

@@ -0,0 +1,51 @@
+/**
+ * Configuration for createMantleClient().
+ * All fields are optional - the client auto-detects sensible defaults.
+ */
+interface MantleClientConfig {
+    /** Optional facilitator URL (auto-detects from NEXT_PUBLIC_FACILITATOR_URL or defaults to localhost:8080). */
+    facilitatorUrl?: string;
+    /** Optional resource URL (defaults to current origin in browser, or empty string for relative paths). */
+    resourceUrl?: string;
+    /** Function to get user's wallet address (required for payments). */
+    getAccount?: () => Promise<string | undefined> | string | undefined;
+    /** Function to get wallet provider/client (e.g., viem WalletClient or window.ethereum). */
+    getProvider?: () => any;
+    /** Optional project key for hosted facilitator billing. */
+    projectKey?: string;
+}
+/**
+ * Simplified Mantle payment client interface.
+ * Provides a clean API for making paid POST requests.
+ */
+interface MantleClient {
+    /**
+     * Make a paid POST request to a protected endpoint.
+     * Automatically handles x402 flow (402 response, signing, payment, retry).
+     *
+     * @param url - API endpoint path (e.g., "/api/generate-image").
+     * @param body - Request body (will be JSON stringified).
+     * @returns Response data from the protected endpoint.
+     * @throws Error if wallet is not connected or payment fails.
+     */
+    postWithPayment<TResp = any>(url: string, body?: any): Promise<TResp>;
+}
+/**
+ * Create a simplified Mantle payment client with auto-detected defaults.
+ *
+ * Usage:
+ * ```typescript
+ * const client = createMantleClient({
+ *   getAccount: () => account?.address,
+ *   getProvider: () => walletClient,
+ * });
+ *
+ * const data = await client.postWithPayment("/api/generate", { prompt: "..." });
+ * ```
+ *
+ * @param config - Optional configuration (auto-detects facilitatorUrl and resourceUrl).
+ * @returns MantleClient instance with simplified postWithPayment() method.
+ */
+declare function createMantleClient(config?: MantleClientConfig): MantleClient;
+
+export { type MantleClient as M, type MantleClientConfig as a, createMantleClient as c };

package/dist/createMantleClient-DS1Ghqrz.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Configuration for createMantleClient().
+ * All fields are optional - the client auto-detects sensible defaults.
+ */
+interface MantleClientConfig {
+    /** Optional facilitator URL (auto-detects from NEXT_PUBLIC_FACILITATOR_URL or defaults to localhost:8080). */
+    facilitatorUrl?: string;
+    /** Optional resource URL (defaults to current origin in browser, or empty string for relative paths). */
+    resourceUrl?: string;
+    /** Function to get user's wallet address (required for payments). */
+    getAccount?: () => Promise<string | undefined> | string | undefined;
+    /** Function to get wallet provider/client (e.g., viem WalletClient or window.ethereum). */
+    getProvider?: () => any;
+    /** Optional project key for hosted facilitator billing. */
+    projectKey?: string;
+}
+/**
+ * Simplified Mantle payment client interface.
+ * Provides a clean API for making paid POST requests.
+ */
+interface MantleClient {
+    /**
+     * Make a paid POST request to a protected endpoint.
+     * Automatically handles x402 flow (402 response, signing, payment, retry).
+     *
+     * @param url - API endpoint path (e.g., "/api/generate-image").
+     * @param body - Request body (will be JSON stringified).
+     * @returns Response data from the protected endpoint.
+     * @throws Error if wallet is not connected or payment fails.
+     */
+    postWithPayment<TResp = any>(url: string, body?: any): Promise<TResp>;
+}
+/**
+ * Create a simplified Mantle payment client with auto-detected defaults.
+ *
+ * Usage:
+ * ```typescript
+ * const client = createMantleClient({
+ *   getAccount: () => account?.address,
+ *   getProvider: () => walletClient,
+ * });
+ *
+ * const data = await client.postWithPayment("/api/generate", { prompt: "..." });
+ * ```
+ *
+ * @param config - Optional configuration (auto-detects facilitatorUrl and resourceUrl).
+ * @returns MantleClient instance with simplified postWithPayment() method.
+ */
+declare function createMantleClient(config?: MantleClientConfig): MantleClient;
+
+export { type MantleClient as M, type MantleClientConfig as a, createMantleClient as c };

package/dist/createMantleClient-DVFkbBfS.d.ts

@@ -0,0 +1,87 @@
+import { d as PaymentHeaderBase64, P as PaymentRequirements } from './types-2zqbJvcz.js';
+
+/** Config for the client-side payment helper. */
+interface PaymentClientConfig {
+    /** Base URL of your protected resource server. */
+    resourceUrl: string;
+    /** Facilitator URL (hosted or self-hosted). */
+    facilitatorUrl: string;
+    /** EIP-1193 provider (window.ethereum) or similar. */
+    provider: unknown;
+    /** Optional user address override; otherwise derived from provider. */
+    userAddress?: string;
+    /** Optional: Project key for hosted facilitator billing. */
+    projectKey?: string;
+}
+/** Result of a callWithPayment() client operation. */
+interface CallWithPaymentResult<TResponseBody = unknown> {
+    response: TResponseBody;
+    txHash?: string;
+    paymentHeader?: PaymentHeaderBase64;
+    paymentRequirements?: PaymentRequirements;
+}
+/** Shape of the client instance returned by createPaymentClient. */
+interface PaymentClient {
+    callWithPayment<TBody = unknown, TResp = unknown>(path: string, options?: {
+        method?: "GET" | "POST" | "PUT" | "DELETE";
+        body?: TBody;
+        headers?: Record<string, string>;
+        /**
+         * Optional override if you want to send less than maxAmountRequired.
+         * In most cases you won't need this and will just pay maxAmountRequired.
+         */
+        valueOverrideAtomic?: string;
+    }): Promise<CallWithPaymentResult<TResp>>;
+}
+
+/**
+ * Configuration for createMantleClient().
+ * All fields are optional - the client auto-detects sensible defaults.
+ */
+interface MantleClientConfig {
+    /** Optional facilitator URL (auto-detects from NEXT_PUBLIC_FACILITATOR_URL or defaults to localhost:8080). */
+    facilitatorUrl?: string;
+    /** Optional resource URL (defaults to current origin in browser, or empty string for relative paths). */
+    resourceUrl?: string;
+    /** Function to get user's wallet address (required for payments). */
+    getAccount?: () => Promise<string | undefined> | string | undefined;
+    /** Function to get wallet provider/client (e.g., viem WalletClient or window.ethereum). */
+    getProvider?: () => any;
+    /** Optional project key for hosted facilitator billing. */
+    projectKey?: string;
+}
+/**
+ * Simplified Mantle payment client interface.
+ * Provides a clean API for making paid POST requests.
+ */
+interface MantleClient {
+    /**
+     * Make a paid POST request to a protected endpoint.
+     * Automatically handles x402 flow (402 response, signing, payment, retry).
+     *
+     * @param url - API endpoint path (e.g., "/api/generate-image").
+     * @param body - Request body (will be JSON stringified).
+     * @returns Full payment result including response body and tx hash.
+     * @throws Error if wallet is not connected or payment fails.
+     */
+    postWithPayment<TResp = any>(url: string, body?: any): Promise<CallWithPaymentResult<TResp>>;
+}
+/**
+ * Create a simplified Mantle payment client with auto-detected defaults.
+ *
+ * Usage:
+ * ```typescript
+ * const client = createMantleClient({
+ *   getAccount: () => account?.address,
+ *   getProvider: () => walletClient,
+ * });
+ *
+ * const data = await client.postWithPayment("/api/generate", { prompt: "..." });
+ * ```
+ *
+ * @param config - Optional configuration (auto-detects facilitatorUrl and resourceUrl).
+ * @returns MantleClient instance with simplified postWithPayment() method.
+ */
+declare function createMantleClient(config?: MantleClientConfig): MantleClient;
+
+export { type CallWithPaymentResult as C, type MantleClient as M, type PaymentClientConfig as P, type MantleClientConfig as a, type PaymentClient as b, createMantleClient as c };

package/dist/createMantleClient-NN0Nitp9.d.cts

@@ -0,0 +1,87 @@
+import { d as PaymentHeaderBase64, P as PaymentRequirements } from './types-2zqbJvcz.cjs';
+
+/** Config for the client-side payment helper. */
+interface PaymentClientConfig {
+    /** Base URL of your protected resource server. */
+    resourceUrl: string;
+    /** Facilitator URL (hosted or self-hosted). */
+    facilitatorUrl: string;
+    /** EIP-1193 provider (window.ethereum) or similar. */
+    provider: unknown;
+    /** Optional user address override; otherwise derived from provider. */
+    userAddress?: string;
+    /** Optional: Project key for hosted facilitator billing. */
+    projectKey?: string;
+}
+/** Result of a callWithPayment() client operation. */
+interface CallWithPaymentResult<TResponseBody = unknown> {
+    response: TResponseBody;
+    txHash?: string;
+    paymentHeader?: PaymentHeaderBase64;
+    paymentRequirements?: PaymentRequirements;
+}
+/** Shape of the client instance returned by createPaymentClient. */
+interface PaymentClient {
+    callWithPayment<TBody = unknown, TResp = unknown>(path: string, options?: {
+        method?: "GET" | "POST" | "PUT" | "DELETE";
+        body?: TBody;
+        headers?: Record<string, string>;
+        /**
+         * Optional override if you want to send less than maxAmountRequired.
+         * In most cases you won't need this and will just pay maxAmountRequired.
+         */
+        valueOverrideAtomic?: string;
+    }): Promise<CallWithPaymentResult<TResp>>;
+}
+
+/**
+ * Configuration for createMantleClient().
+ * All fields are optional - the client auto-detects sensible defaults.
+ */
+interface MantleClientConfig {
+    /** Optional facilitator URL (auto-detects from NEXT_PUBLIC_FACILITATOR_URL or defaults to localhost:8080). */
+    facilitatorUrl?: string;
+    /** Optional resource URL (defaults to current origin in browser, or empty string for relative paths). */
+    resourceUrl?: string;
+    /** Function to get user's wallet address (required for payments). */
+    getAccount?: () => Promise<string | undefined> | string | undefined;
+    /** Function to get wallet provider/client (e.g., viem WalletClient or window.ethereum). */
+    getProvider?: () => any;
+    /** Optional project key for hosted facilitator billing. */
+    projectKey?: string;
+}
+/**
+ * Simplified Mantle payment client interface.
+ * Provides a clean API for making paid POST requests.
+ */
+interface MantleClient {
+    /**
+     * Make a paid POST request to a protected endpoint.
+     * Automatically handles x402 flow (402 response, signing, payment, retry).
+     *
+     * @param url - API endpoint path (e.g., "/api/generate-image").
+     * @param body - Request body (will be JSON stringified).
+     * @returns Full payment result including response body and tx hash.
+     * @throws Error if wallet is not connected or payment fails.
+     */
+    postWithPayment<TResp = any>(url: string, body?: any): Promise<CallWithPaymentResult<TResp>>;
+}
+/**
+ * Create a simplified Mantle payment client with auto-detected defaults.
+ *
+ * Usage:
+ * ```typescript
+ * const client = createMantleClient({
+ *   getAccount: () => account?.address,
+ *   getProvider: () => walletClient,
+ * });
+ *
+ * const data = await client.postWithPayment("/api/generate", { prompt: "..." });
+ * ```
+ *
+ * @param config - Optional configuration (auto-detects facilitatorUrl and resourceUrl).
+ * @returns MantleClient instance with simplified postWithPayment() method.
+ */
+declare function createMantleClient(config?: MantleClientConfig): MantleClient;
+
+export { type CallWithPaymentResult as C, type MantleClient as M, type PaymentClientConfig as P, type MantleClientConfig as a, type PaymentClient as b, createMantleClient as c };