@dexterai/x402 3.3.0 → 3.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dexterai/x402",
-  "version": "3.3.0",
+  "version": "3.3.1",
   "description": "Full-stack x402 SDK - add paid API monetization to any endpoint. Express middleware, React hooks, Access Pass, dynamic pricing. Solana, Base, Polygon, Arbitrum, Optimism, Avalanche, SKALE.",
   "author": "Dexter",
   "license": "MIT",
@@ -35,6 +35,11 @@
       "types": "./dist/batch-settlement/index.d.ts",
       "import": "./dist/batch-settlement/index.js",
       "require": "./dist/batch-settlement/index.cjs"
+    },
+    "./batch-settlement/seller": {
+      "types": "./dist/batch-settlement/seller/index.d.ts",
+      "import": "./dist/batch-settlement/seller/index.js",
+      "require": "./dist/batch-settlement/seller/index.cjs"
     }
   },
   "files": [
@@ -57,7 +62,7 @@
   },
   "dependencies": {
     "@dexterai/x402-ads-types": "^0.2.0",
-    "@dexterai/x402-core": "^1.1.0",
+    "@dexterai/x402-core": "^1.4.0",
     "@solana/spl-token": "^0.4.9",
     "@solana/web3.js": "^1.98.0",
     "@x402/core": "^2.12.0",
@@ -70,6 +75,7 @@
     "@types/react": "^18.0.0",
     "bs58": "^6.0.0",
     "ethers": "^6.13.0",
+    "express": "^5.2.1",
     "react": "^18.0.0",
     "stripe": "^20.3.1",
     "tsup": "^8.3.5",

package/dist/types-Bcsi5jQb.d.cts

@@ -1,227 +0,0 @@
-/**
- * x402 v2 SDK — Shared Types
- *
- * Chain-agnostic types for x402 v2 payments.
- * Works with Solana, Base, and any future x402-compatible networks.
- */
-
-/**
- * Context passed to a PayToProvider function.
- * Contains request-scoped information for dynamic address resolution.
- */
-interface PayToContext {
-    /** The PAYMENT-SIGNATURE header value (present on retry/verify, undefined on initial 402) */
-    paymentHeader?: string;
-    /** Amount in atomic units (e.g., '10000' for 0.01 USDC) */
-    amountAtomic?: string;
-    /** The resource URL being accessed */
-    resourceUrl?: string;
-}
-/**
- * Optional defaults a PayToProvider can advertise for auto-configuration.
- * Attached as `_x402Defaults` on the provider function.
- */
-interface PayToProviderDefaults {
-    /** Default CAIP-2 network (e.g., 'eip155:8453' for Base) */
-    network?: string;
-    /** Default facilitator URL */
-    facilitatorUrl?: string;
-}
-/**
- * A function that dynamically resolves a payment address.
- * Used for providers like Stripe that generate per-request deposit addresses.
- *
- * @example
- * ```typescript
- * import { stripePayTo } from '@dexterai/x402/server';
- *
- * const provider = stripePayTo(process.env.STRIPE_SECRET_KEY);
- * const address = await provider({ amountAtomic: '10000' });
- * ```
- */
-type PayToProvider = ((context: PayToContext) => Promise<string>) & {
-    /** Auto-configuration defaults (set by provider factories like stripePayTo) */
-    _x402Defaults?: PayToProviderDefaults;
-};
-/**
- * Resource info included in payment requirements
- */
-interface ResourceInfo {
-    /** Resource URL */
-    url: string;
-    /** Human-readable description */
-    description?: string;
-    /** MIME type of the resource */
-    mimeType?: string;
-}
-/**
- * Extra fields in payment requirements
- * Chain-specific fields may vary
- */
-interface AcceptsExtra {
-    /** Facilitator address that pays tx fees (required for Solana) */
-    feePayer?: string;
-    /** Token decimals (optional - defaults to 6 for USDC) */
-    decimals?: number;
-    /** EIP-712: Token name (EVM only) */
-    name?: string;
-    /** EIP-712: Token version (EVM only) */
-    version?: string;
-    /**
-     * batch-settlement: on-chain authorizer that the escrow channel pays into.
-     * Provided by the facilitator's batch-settlement kind. EVM only.
-     */
-    receiverAuthorizer?: string;
-    /** Additional chain-specific fields */
-    [key: string]: unknown;
-}
-/**
- * A single payment option in the accepts array
- */
-interface PaymentAccept {
-    /** x402 version (1 or 2, defaults to 2 if not specified) */
-    x402Version?: 1 | 2;
-    /**
-     * Payment scheme: 'exact' for EIP-3009 chains, 'exact-approval' for
-     * approval-based chains like BSC, 'batch-settlement' for the EVM
-     * escrow-channel batching scheme (discrete API purchases, gas-amortized).
-     */
-    scheme: 'exact' | 'exact-approval' | 'batch-settlement';
-    /** CAIP-2 network identifier (v1: 'solana', v2: 'solana:5eykt...') */
-    network: string;
-    /** Payment amount in atomic units (x402 v2 spec field) */
-    amount: string;
-    /** @deprecated v1 field — use `amount` instead. Kept for backwards compatibility with v1 data. */
-    maxAmountRequired?: string;
-    /** Token address */
-    asset: string;
-    /** Seller's address to receive payment */
-    payTo: string;
-    /** Maximum seconds until payment expires */
-    maxTimeoutSeconds: number;
-    /** Chain-specific extra data */
-    extra?: AcceptsExtra;
-}
-/**
- * Full PaymentRequired structure (sent in PAYMENT-REQUIRED header)
- */
-interface PaymentRequired {
-    /** x402 version (always 2) */
-    x402Version: 2;
-    /** Resource being accessed */
-    resource: ResourceInfo;
-    /** Available payment options */
-    accepts: PaymentAccept[];
-    /** Optional error message */
-    error?: string;
-    /** Protocol extensions */
-    extensions?: Record<string, unknown>;
-}
-/**
- * Response from /verify endpoint
- */
-interface VerifyResponse {
-    /** Whether the payment is valid */
-    isValid: boolean;
-    /** Reason for invalidity (if invalid) */
-    invalidReason?: string;
-    /** Payer address */
-    payer?: string;
-}
-/**
- * Response from /settle endpoint
- */
-interface SettleResponse {
-    /** Whether settlement succeeded */
-    success: boolean;
-    /** Transaction signature/hash */
-    transaction?: string;
-    /** Network the payment was made on */
-    network: string;
-    /** Error reason (if failed) */
-    errorReason?: string;
-    /** Error code (if failed) */
-    errorCode?: string;
-    /** Payer address */
-    payer?: string;
-    /** Protocol extensions returned by the facilitator (e.g., sponsored-access recommendations) */
-    extensions?: Record<string, unknown>;
-}
-/**
- * A single access pass tier offered by a seller
- */
-interface AccessPassTier {
-    /** Tier ID (e.g., '1h', '24h') */
-    id: string;
-    /** Human-readable label (e.g., '1 hour') */
-    label: string;
-    /** Duration in seconds */
-    seconds: number;
-    /** Price in USD (e.g., '0.50') */
-    price: string;
-    /** Price in atomic units (e.g., '500000') */
-    priceAtomic: string;
-}
-/**
- * Access pass info returned in X-ACCESS-PASS-TIERS header
- */
-interface AccessPassInfo {
-    /** Available tiers (if tier-based pricing) */
-    tiers?: AccessPassTier[];
-    /** Rate per hour in USD (if custom duration pricing) */
-    ratePerHour?: string;
-    /** Pass issuer identifier */
-    issuer?: string;
-}
-/**
- * JWT claims inside an access pass token
- */
-interface AccessPassClaims {
-    /** Subject — always 'x402-access-pass' */
-    sub: string;
-    /** Tier ID or 'custom' */
-    tier: string;
-    /** Duration in seconds */
-    duration: number;
-    /** Issued at (unix seconds) */
-    iat: number;
-    /** Expires at (unix seconds) */
-    exp: number;
-    /** Payer wallet address */
-    payer: string;
-    /** Network used for payment */
-    network: string;
-    /** Issuer identifier */
-    iss: string;
-}
-/**
- * Client-side access pass configuration
- */
-interface AccessPassClientConfig {
-    /** Enable access pass mode (default: true when this config is present) */
-    enabled?: boolean;
-    /** Preferred tier ID (e.g., '1h') — pick this tier if available */
-    preferTier?: string;
-    /** Preferred custom duration in seconds (e.g., 3600) */
-    preferDuration?: number;
-    /** Maximum amount willing to spend in USD (e.g., '2.00') */
-    maxSpend?: string;
-    /** Auto-renew expired passes (default: true) */
-    autoRenew?: boolean;
-}
-/**
- * SDK error codes
- */
-type X402ErrorCode = 'missing_payment_required_header' | 'invalid_payment_required' | 'unsupported_network' | 'no_matching_payment_option' | 'missing_fee_payer' | 'missing_decimals' | 'missing_amount' | 'amount_exceeds_max' | 'insufficient_balance' | 'wallet_missing_sign_transaction' | 'wallet_not_connected' | 'wallet_disconnected' | 'user_rejected_signature' | 'transaction_build_failed' | 'payment_rejected' | 'rpc_timeout' | 'facilitator_timeout' | 'invalid_payment_signature' | 'facilitator_verify_failed' | 'facilitator_settle_failed' | 'facilitator_request_failed' | 'no_matching_requirement' | 'access_pass_expired' | 'access_pass_invalid' | 'access_pass_tier_not_found' | 'access_pass_exceeds_max_spend';
-/**
- * Custom error class for x402 operations
- */
-declare class X402Error extends Error {
-    /** Error code for programmatic handling */
-    code: X402ErrorCode;
-    /** Additional error details */
-    details?: unknown;
-    constructor(code: X402ErrorCode, message: string, details?: unknown);
-}
-
-export { type AccessPassClientConfig as A, type PaymentAccept as P, type SettleResponse as S, type VerifyResponse as V, X402Error as X, type AccessPassTier as a, type AccessPassInfo as b, type PayToProvider as c, type PaymentRequired as d, type PayToContext as e, type PayToProviderDefaults as f, type AccessPassClaims as g };

package/dist/types-Bcsi5jQb.d.ts

@@ -1,227 +0,0 @@
-/**
- * x402 v2 SDK — Shared Types
- *
- * Chain-agnostic types for x402 v2 payments.
- * Works with Solana, Base, and any future x402-compatible networks.
- */
-
-/**
- * Context passed to a PayToProvider function.
- * Contains request-scoped information for dynamic address resolution.
- */
-interface PayToContext {
-    /** The PAYMENT-SIGNATURE header value (present on retry/verify, undefined on initial 402) */
-    paymentHeader?: string;
-    /** Amount in atomic units (e.g., '10000' for 0.01 USDC) */
-    amountAtomic?: string;
-    /** The resource URL being accessed */
-    resourceUrl?: string;
-}
-/**
- * Optional defaults a PayToProvider can advertise for auto-configuration.
- * Attached as `_x402Defaults` on the provider function.
- */
-interface PayToProviderDefaults {
-    /** Default CAIP-2 network (e.g., 'eip155:8453' for Base) */
-    network?: string;
-    /** Default facilitator URL */
-    facilitatorUrl?: string;
-}
-/**
- * A function that dynamically resolves a payment address.
- * Used for providers like Stripe that generate per-request deposit addresses.
- *
- * @example
- * ```typescript
- * import { stripePayTo } from '@dexterai/x402/server';
- *
- * const provider = stripePayTo(process.env.STRIPE_SECRET_KEY);
- * const address = await provider({ amountAtomic: '10000' });
- * ```
- */
-type PayToProvider = ((context: PayToContext) => Promise<string>) & {
-    /** Auto-configuration defaults (set by provider factories like stripePayTo) */
-    _x402Defaults?: PayToProviderDefaults;
-};
-/**
- * Resource info included in payment requirements
- */
-interface ResourceInfo {
-    /** Resource URL */
-    url: string;
-    /** Human-readable description */
-    description?: string;
-    /** MIME type of the resource */
-    mimeType?: string;
-}
-/**
- * Extra fields in payment requirements
- * Chain-specific fields may vary
- */
-interface AcceptsExtra {
-    /** Facilitator address that pays tx fees (required for Solana) */
-    feePayer?: string;
-    /** Token decimals (optional - defaults to 6 for USDC) */
-    decimals?: number;
-    /** EIP-712: Token name (EVM only) */
-    name?: string;
-    /** EIP-712: Token version (EVM only) */
-    version?: string;
-    /**
-     * batch-settlement: on-chain authorizer that the escrow channel pays into.
-     * Provided by the facilitator's batch-settlement kind. EVM only.
-     */
-    receiverAuthorizer?: string;
-    /** Additional chain-specific fields */
-    [key: string]: unknown;
-}
-/**
- * A single payment option in the accepts array
- */
-interface PaymentAccept {
-    /** x402 version (1 or 2, defaults to 2 if not specified) */
-    x402Version?: 1 | 2;
-    /**
-     * Payment scheme: 'exact' for EIP-3009 chains, 'exact-approval' for
-     * approval-based chains like BSC, 'batch-settlement' for the EVM
-     * escrow-channel batching scheme (discrete API purchases, gas-amortized).
-     */
-    scheme: 'exact' | 'exact-approval' | 'batch-settlement';
-    /** CAIP-2 network identifier (v1: 'solana', v2: 'solana:5eykt...') */
-    network: string;
-    /** Payment amount in atomic units (x402 v2 spec field) */
-    amount: string;
-    /** @deprecated v1 field — use `amount` instead. Kept for backwards compatibility with v1 data. */
-    maxAmountRequired?: string;
-    /** Token address */
-    asset: string;
-    /** Seller's address to receive payment */
-    payTo: string;
-    /** Maximum seconds until payment expires */
-    maxTimeoutSeconds: number;
-    /** Chain-specific extra data */
-    extra?: AcceptsExtra;
-}
-/**
- * Full PaymentRequired structure (sent in PAYMENT-REQUIRED header)
- */
-interface PaymentRequired {
-    /** x402 version (always 2) */
-    x402Version: 2;
-    /** Resource being accessed */
-    resource: ResourceInfo;
-    /** Available payment options */
-    accepts: PaymentAccept[];
-    /** Optional error message */
-    error?: string;
-    /** Protocol extensions */
-    extensions?: Record<string, unknown>;
-}
-/**
- * Response from /verify endpoint
- */
-interface VerifyResponse {
-    /** Whether the payment is valid */
-    isValid: boolean;
-    /** Reason for invalidity (if invalid) */
-    invalidReason?: string;
-    /** Payer address */
-    payer?: string;
-}
-/**
- * Response from /settle endpoint
- */
-interface SettleResponse {
-    /** Whether settlement succeeded */
-    success: boolean;
-    /** Transaction signature/hash */
-    transaction?: string;
-    /** Network the payment was made on */
-    network: string;
-    /** Error reason (if failed) */
-    errorReason?: string;
-    /** Error code (if failed) */
-    errorCode?: string;
-    /** Payer address */
-    payer?: string;
-    /** Protocol extensions returned by the facilitator (e.g., sponsored-access recommendations) */
-    extensions?: Record<string, unknown>;
-}
-/**
- * A single access pass tier offered by a seller
- */
-interface AccessPassTier {
-    /** Tier ID (e.g., '1h', '24h') */
-    id: string;
-    /** Human-readable label (e.g., '1 hour') */
-    label: string;
-    /** Duration in seconds */
-    seconds: number;
-    /** Price in USD (e.g., '0.50') */
-    price: string;
-    /** Price in atomic units (e.g., '500000') */
-    priceAtomic: string;
-}
-/**
- * Access pass info returned in X-ACCESS-PASS-TIERS header
- */
-interface AccessPassInfo {
-    /** Available tiers (if tier-based pricing) */
-    tiers?: AccessPassTier[];
-    /** Rate per hour in USD (if custom duration pricing) */
-    ratePerHour?: string;
-    /** Pass issuer identifier */
-    issuer?: string;
-}
-/**
- * JWT claims inside an access pass token
- */
-interface AccessPassClaims {
-    /** Subject — always 'x402-access-pass' */
-    sub: string;
-    /** Tier ID or 'custom' */
-    tier: string;
-    /** Duration in seconds */
-    duration: number;
-    /** Issued at (unix seconds) */
-    iat: number;
-    /** Expires at (unix seconds) */
-    exp: number;
-    /** Payer wallet address */
-    payer: string;
-    /** Network used for payment */
-    network: string;
-    /** Issuer identifier */
-    iss: string;
-}
-/**
- * Client-side access pass configuration
- */
-interface AccessPassClientConfig {
-    /** Enable access pass mode (default: true when this config is present) */
-    enabled?: boolean;
-    /** Preferred tier ID (e.g., '1h') — pick this tier if available */
-    preferTier?: string;
-    /** Preferred custom duration in seconds (e.g., 3600) */
-    preferDuration?: number;
-    /** Maximum amount willing to spend in USD (e.g., '2.00') */
-    maxSpend?: string;
-    /** Auto-renew expired passes (default: true) */
-    autoRenew?: boolean;
-}
-/**
- * SDK error codes
- */
-type X402ErrorCode = 'missing_payment_required_header' | 'invalid_payment_required' | 'unsupported_network' | 'no_matching_payment_option' | 'missing_fee_payer' | 'missing_decimals' | 'missing_amount' | 'amount_exceeds_max' | 'insufficient_balance' | 'wallet_missing_sign_transaction' | 'wallet_not_connected' | 'wallet_disconnected' | 'user_rejected_signature' | 'transaction_build_failed' | 'payment_rejected' | 'rpc_timeout' | 'facilitator_timeout' | 'invalid_payment_signature' | 'facilitator_verify_failed' | 'facilitator_settle_failed' | 'facilitator_request_failed' | 'no_matching_requirement' | 'access_pass_expired' | 'access_pass_invalid' | 'access_pass_tier_not_found' | 'access_pass_exceeds_max_spend';
-/**
- * Custom error class for x402 operations
- */
-declare class X402Error extends Error {
-    /** Error code for programmatic handling */
-    code: X402ErrorCode;
-    /** Additional error details */
-    details?: unknown;
-    constructor(code: X402ErrorCode, message: string, details?: unknown);
-}
-
-export { type AccessPassClientConfig as A, type PaymentAccept as P, type SettleResponse as S, type VerifyResponse as V, X402Error as X, type AccessPassTier as a, type AccessPassInfo as b, type PayToProvider as c, type PaymentRequired as d, type PayToContext as e, type PayToProviderDefaults as f, type AccessPassClaims as g };