@dexterai/x402 6.0.0-rc.4 → 6.0.0

package/dist/{types-BvQpNtFw.d.ts → types-CRs5sEcb.d.cts}

@@ -1,238 +1,4 @@
-/**
- * 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;
-    /** Tab seller-wire header advertised by the default hosted scheme. */
-    voucherHeader?: string;
-    /** Tab registration encoding carried inside each seller voucher. */
-    registrationEncoding?: string;
-    /** Immutable commercial-terms version for this Tab offer. */
-    termsVersion?: string;
-    /** Event that makes usage accepted under the advertised terms version. */
-    acceptanceRule?: 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),
-     * 'tab' (SVM only) for streaming session-key vouchers against an
-     * on-chain vault.
-     */
-    scheme: 'exact' | 'exact-approval' | 'batch-settlement' | 'tab';
-    /** 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);
-}
+import { P as PaymentAccept } from './types-DolSK-3d.cjs';
 
 /**
  * EVM Chain Adapter
@@ -645,4 +411,4 @@ interface BalanceInfo {
     asset: string;
 }
 
-export { type AdapterConfig as A, type BalanceInfo as B, type ChainAdapter as C, EvmAdapter as E, type GenericWallet as G, type PaymentAccept as P, SolanaAdapter as S, type VerifyResponse as V, type WalletSet as W, X402Error as X, type EvmWallet as a, type SignedTransaction as b, type SolanaWallet as c, createEvmAdapter as d, createSolanaAdapter as e, isSolanaWallet as f, type SettlementProbe as g, type AccessPassClientConfig as h, isEvmWallet as i, type AccessPassInfo as j, type AccessPassTier as k, type SettleResponse as l, type PaymentRequired as m, type PayToProvider as n, type AccessPassClaims as o, type PayToContext as p, type PayToProviderDefaults as q };
+export { type AdapterConfig as A, type BalanceInfo as B, type ChainAdapter as C, EvmAdapter as E, type GenericWallet as G, SolanaAdapter as S, type WalletSet as W, type EvmWallet as a, type SignedTransaction as b, type SolanaWallet as c, createEvmAdapter as d, createSolanaAdapter as e, isSolanaWallet as f, type SettlementProbe as g, isEvmWallet as i };

package/dist/{types-CBQKKFxJ.d.cts → types-Cyyl3Cw_.d.cts}

@@ -1,4 +1,4 @@
-import { W as WalletSet } from './types-BvQpNtFw.cjs';
+import { W as WalletSet } from './types-CRs5sEcb.cjs';
 import { T as Tab } from './types-D0IFR4Ro.cjs';
 
 /**

package/dist/{types-DwVhPqOZ.d.ts → types-DGVtb7cl.d.cts}

@@ -1,5 +1,5 @@
 import { ClientChannelStorage } from '@x402/evm/batch-settlement/client';
-import { a as EvmWallet } from './types-BvQpNtFw.js';
+import { a as EvmWallet } from './types-CRs5sEcb.cjs';
 
 /**
  * Buyer withdrawal escape hatch for batch-settlement escrow channels.
@@ -58,7 +58,7 @@ interface OpenBatchChannelOptions {
     wallet: EvmWallet;
     /** CAIP-2 network: eip155:8453 (Base), eip155:42161 (Arbitrum), eip155:137 (Polygon). */
     network: string;
-    /** Total escrow for the channel, USDC human units, e.g. "0.30". */
+    /** Fixed escrow budget in USDC, e.g. "0.30". Funds once; exhaustion requires a new channel. */
     deposit: string;
     /** Facilitator base URL. Default: https://x402.dexter.cash */
     facilitatorUrl?: string;
@@ -84,6 +84,8 @@ interface ResumeBatchChannelOptions {
     facilitatorUrl?: string;
     rpcUrl?: string;
     store?: ChannelStore;
+    /** Per-call USDC limit, e.g. "2.00". Defaults to "1". Resume never adds escrow. */
+    maxAmountPerPayment?: string;
     /**
      * 32-byte hex channel-config salt of the channel being resumed — REQUIRED.
      * `channelId` cannot be reversed to a salt, so resuming a channel needs the

package/dist/{types-BbvuPNXl.d.cts → types-DjDjuUc6.d.ts}

@@ -1,5 +1,5 @@
 import { ClientChannelStorage } from '@x402/evm/batch-settlement/client';
-import { a as EvmWallet } from './types-BvQpNtFw.cjs';
+import { a as EvmWallet } from './types-C08JT9MG.js';
 
 /**
  * Buyer withdrawal escape hatch for batch-settlement escrow channels.
@@ -58,7 +58,7 @@ interface OpenBatchChannelOptions {
     wallet: EvmWallet;
     /** CAIP-2 network: eip155:8453 (Base), eip155:42161 (Arbitrum), eip155:137 (Polygon). */
     network: string;
-    /** Total escrow for the channel, USDC human units, e.g. "0.30". */
+    /** Fixed escrow budget in USDC, e.g. "0.30". Funds once; exhaustion requires a new channel. */
     deposit: string;
     /** Facilitator base URL. Default: https://x402.dexter.cash */
     facilitatorUrl?: string;
@@ -84,6 +84,8 @@ interface ResumeBatchChannelOptions {
     facilitatorUrl?: string;
     rpcUrl?: string;
     store?: ChannelStore;
+    /** Per-call USDC limit, e.g. "2.00". Defaults to "1". Resume never adds escrow. */
+    maxAmountPerPayment?: string;
     /**
      * 32-byte hex channel-config salt of the channel being resumed — REQUIRED.
      * `channelId` cannot be reversed to a salt, so resuming a channel needs the

package/dist/types-DolSK-3d.d.cts

@@ -0,0 +1,237 @@
+/**
+ * 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;
+    /** Tab seller-wire header advertised by the default hosted scheme. */
+    voucherHeader?: string;
+    /** Tab registration encoding carried inside each seller voucher. */
+    registrationEncoding?: string;
+    /** Immutable commercial-terms version for this Tab offer. */
+    termsVersion?: string;
+    /** Event that makes usage accepted under the advertised terms version. */
+    acceptanceRule?: 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),
+     * 'tab' (SVM only) for streaming session-key vouchers against an
+     * on-chain vault.
+     */
+    scheme: 'exact' | 'exact-approval' | 'batch-settlement' | 'tab';
+    /** 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 ResourceInfo as R, type SettleResponse as S, type VerifyResponse as V, X402Error as X, type AccessPassInfo as a, type AccessPassTier as b, type PaymentRequired as c, type PayToProvider as d, type AccessPassClaims as e, type PayToContext as f, type PayToProviderDefaults as g };