@dexterai/x402 3.3.0 → 3.4.0

package/dist/types-Bbt_SDZE.d.cts

@@ -0,0 +1,142 @@
+import { ClientChannelStorage } from '@x402/evm/batch-settlement/client';
+import { E as EvmWallet } from './types-IqnDBsjL.cjs';
+
+/**
+ * Buyer withdrawal escape hatch for batch-settlement escrow channels.
+ *
+ * Normally a buyer's unspent escrow returns via the seller's
+ * `refundWithSignature`. If the seller goes dark and never settles, the buyer
+ * must be able to reclaim the unspent escrow directly on-chain. The
+ * `x402BatchSettlement` contract provides a two-step timed withdrawal:
+ *
+ *   1. `initiateWithdraw(config, amount)` — starts the `withdrawDelay` timer.
+ *   2. `finalizeWithdraw(config)` — after the delay, returns the funds.
+ *
+ * Both are buyer-submitted and cost the buyer gas. There is deliberately no
+ * facilitator-relayed variant: the escape cannot be sponsored by the party
+ * being escaped from.
+ */
+
+/** Thrown by finalizeWithdraw when called before the withdrawDelay elapses. */
+declare class WithdrawNotReadyError extends Error {
+    constructor(message: string);
+}
+/** Result of forceWithdraw — the initiate tx and when finalize becomes possible. */
+interface ForceWithdrawResult {
+    /** initiateWithdraw transaction hash. */
+    initiateTx: string;
+    /** Unix seconds at which finalizeWithdraw becomes callable. */
+    finalizableAt: number;
+}
+/** Result of finalizeWithdraw. */
+interface FinalizeWithdrawResult {
+    /** finalizeWithdraw transaction hash. */
+    finalizeTx: string;
+    /** Amount returned to the buyer, USDC human units. */
+    withdrawnAmount: string;
+}
+
+/**
+ * Channel persistence. This is the upstream `ClientChannelStorage` interface
+ * (`get` / `set` / `delete`, keyed by lowercased channelId). The SDK ships
+ * file-backed and localStorage-backed implementations; a consumer may pass any
+ * `ClientChannelStorage` (e.g. one backed by their own database).
+ */
+type ChannelStore = ClientChannelStorage;
+/** Channel accounting, all amounts USDC human units (e.g. "0.30"). */
+interface ChannelState {
+    /** Total escrowed into the channel. */
+    deposited: string;
+    /** Cumulative amount spent via vouchers. */
+    spent: string;
+    /** deposited - spent. */
+    remaining: string;
+}
+/** Options for opening a fresh (or auto-resumed) channel. */
+interface OpenBatchChannelOptions {
+    /** EVM wallet — any { address, signTypedData }. The same EvmWallet the exact scheme uses. */
+    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". */
+    deposit: string;
+    /** Facilitator base URL. Default: https://x402.dexter.cash */
+    facilitatorUrl?: string;
+    /** RPC URL override. Default: per-network. */
+    rpcUrl?: string;
+    /** Channel persistence. Default: localStorage (browser) / file (Node). */
+    store?: ChannelStore;
+}
+/** Options for explicitly resuming an existing channel. */
+interface ResumeBatchChannelOptions {
+    wallet: EvmWallet;
+    network: string;
+    facilitatorUrl?: string;
+    rpcUrl?: string;
+    store?: ChannelStore;
+}
+/**
+ * Result of the seller runtime's claim -> settle -> refund — the three
+ * settlement tx hashes and final amounts. Used by the SELLER module; the
+ * buyer's channel.close() returns {@link CloseResult} instead.
+ */
+interface CloseReceipt {
+    /** claimWithSignature tx hash. */
+    claimTx: string;
+    /** settle tx hash. */
+    settleTx: string;
+    /** refundWithSignature tx hash. */
+    refundTx: string;
+    /** Amount paid to the seller, USDC human units. */
+    settledAmount: string;
+    /** Unspent amount returned to the buyer, USDC human units. */
+    refundedAmount: string;
+}
+/** Result of the buyer's channel.close() — an intent signal, not a settlement. */
+interface CloseResult {
+    /** Always true — the channel was marked done in the buyer's local store. */
+    closed: true;
+}
+/**
+ * A live escrow channel. Returned by openBatchChannel / resumeBatchChannel.
+ * Hold this handle for the lifetime of a batching session.
+ */
+interface BatchSettlementChannel {
+    /** On-chain channel id (bytes32 hex). Empty until the first fetch resolves it. */
+    readonly channelId: string;
+    /** CAIP-2 network. */
+    readonly network: string;
+    /** Live channel accounting; updated after each fetch. */
+    readonly state: ChannelState;
+    /** Drop-in fetch. On a batch-settlement 402, signs a voucher and retries. */
+    fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
+    /**
+     * Marks the channel done in the buyer's local store (an intent signal).
+     * The buyer does not settle — the seller's runtime claims accumulated
+     * vouchers and refunds the buyer's unspent escrow. Returns { closed: true }.
+     */
+    close(): Promise<CloseResult>;
+    /**
+     * Escape hatch — initiates the contract's on-chain withdrawal of this
+     * channel's unspent escrow, starting the withdrawDelay timer. Use only if
+     * the seller never settles. COSTS THE BUYER GAS — the buyer's wallet must
+     * hold the chain's native token; there is no facilitator-relayed variant.
+     */
+    forceWithdraw(): Promise<ForceWithdrawResult>;
+    /**
+     * Escape hatch — finalizes a withdrawal started by forceWithdraw, after the
+     * withdrawDelay has elapsed; returns the funds. Throws WithdrawNotReadyError
+     * if called too early. COSTS THE BUYER GAS.
+     */
+    finalizeWithdraw(): Promise<FinalizeWithdrawResult>;
+}
+/** Thrown by openBatchChannel when the buyer wallet lacks USDC for the deposit. */
+declare class InsufficientBalanceError extends Error {
+    constructor(message: string);
+}
+/** Thrown when a network has no deployed x402BatchSettlement contract. */
+declare class UnsupportedNetworkError extends Error {
+    constructor(message: string);
+}
+
+export { type BatchSettlementChannel as B, type ChannelStore as C, type ForceWithdrawResult as F, InsufficientBalanceError as I, type OpenBatchChannelOptions as O, type ResumeBatchChannelOptions as R, UnsupportedNetworkError as U, WithdrawNotReadyError as W, type ChannelState as a, type CloseReceipt as b, type CloseResult as c, type FinalizeWithdrawResult as d };

package/dist/types-CwK4mPWV.d.ts

@@ -0,0 +1,60 @@
+import { RequestHandler } from 'express';
+import { ChannelStorage } from '@x402/evm/batch-settlement/server';
+import { b as CloseReceipt } from './types-BIINnfB4.js';
+
+/**
+ * Result of closing one channel from the seller side. Either a settlement
+ * receipt, or an error entry when that channel's claim/settle/refund failed.
+ */
+type SellerCloseResult = (CloseReceipt & {
+    channelId: string;
+}) | {
+    channelId: string;
+    error: string;
+};
+/** Configuration for createBatchSettlementSeller. */
+interface BatchSettlementSellerConfig {
+    /** Seller's payout address; also the channel receiver. */
+    payTo: string;
+    /** CAIP-2 network: eip155:8453 (Base), eip155:42161 (Arbitrum), eip155:137 (Polygon). */
+    network: string;
+    /** USDC charged per request, human units, e.g. "0.08". */
+    price: string;
+    /** Facilitator base URL. Default: https://x402.dexter.cash */
+    facilitatorUrl?: string;
+    /** The protected route, e.g. "GET /api/data". Default: "GET /". */
+    route?: string;
+    /**
+     * Persistent server-side channel storage. Default: file-backed at
+     * ~/.dexter-x402/seller-channels/. Pass RedisChannelStorage or a custom
+     * server-side ChannelStorage for multi-instance deployments.
+     */
+    channelStore?: ChannelStorage;
+    /**
+     * Auto-settlement loop. Default true (loop on, default intervals). Pass an
+     * object to tune; pass false to disable (settle only via closeChannel/closeAll).
+     */
+    autoSettle?: boolean | {
+        claimIntervalSecs?: number;
+        settleIntervalSecs?: number;
+        refundIntervalSecs?: number;
+    };
+    /** Verbose logging. */
+    verbose?: boolean;
+}
+/**
+ * The seller runtime. It is callable — usable directly as an Express
+ * RequestHandler — and exposes lifecycle + settlement methods.
+ */
+interface BatchSettlementSeller extends RequestHandler {
+    /** Returns the Express request handler (same handler the object itself is). */
+    middleware(): RequestHandler;
+    /** Claim -> settle -> refund one channel. */
+    closeChannel(channelId: string): Promise<CloseReceipt>;
+    /** Settle every channel currently in storage; one result per channel. */
+    closeAll(): Promise<SellerCloseResult[]>;
+    /** Halt the auto-settle loop and flush a final claimAndSettle. */
+    stop(): Promise<void>;
+}
+
+export type { BatchSettlementSeller as B, SellerCloseResult as S, BatchSettlementSellerConfig as a };

package/dist/{types-HFS_C6RX.d.ts → types-IqnDBsjL.d.cts}

@@ -1,4 +1,228 @@
-import { P as PaymentAccept } from './types-Bcsi5jQb.js';
+/**
+ * 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);
+}
 
 /**
  * EVM Chain Adapter
@@ -281,4 +505,4 @@ interface BalanceInfo {
     asset: string;
 }
 
-export { type AdapterConfig as A, type BalanceInfo as B, type ChainAdapter as C, type EvmWallet as E, type GenericWallet as G, type SolanaWallet as S, type WalletSet as W, createEvmAdapter as a, SolanaAdapter as b, createSolanaAdapter as c, EvmAdapter as d, type SignedTransaction as e, isEvmWallet as f, isSolanaWallet as i };
+export { type AccessPassClientConfig as A, type BalanceInfo as B, type ChainAdapter as C, type EvmWallet as E, type GenericWallet as G, type PaymentAccept as P, type SolanaWallet as S, type VerifyResponse as V, type WalletSet as W, X402Error as X, createEvmAdapter as a, type AccessPassTier as b, createSolanaAdapter as c, type AccessPassInfo as d, type SettleResponse as e, type PayToProvider as f, type PaymentRequired as g, type PayToContext as h, type PayToProviderDefaults as i, type AccessPassClaims as j, SolanaAdapter as k, EvmAdapter as l, type AdapterConfig as m, type SignedTransaction as n, isSolanaWallet as o, isEvmWallet as p };

package/dist/{types-B3kS1y_t.d.cts → types-IqnDBsjL.d.ts}

@@ -1,4 +1,228 @@
-import { P as PaymentAccept } from './types-Bcsi5jQb.cjs';
+/**
+ * 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);
+}
 
 /**
  * EVM Chain Adapter
@@ -281,4 +505,4 @@ interface BalanceInfo {
     asset: string;
 }
 
-export { type AdapterConfig as A, type BalanceInfo as B, type ChainAdapter as C, type EvmWallet as E, type GenericWallet as G, type SolanaWallet as S, type WalletSet as W, createEvmAdapter as a, SolanaAdapter as b, createSolanaAdapter as c, EvmAdapter as d, type SignedTransaction as e, isEvmWallet as f, isSolanaWallet as i };
+export { type AccessPassClientConfig as A, type BalanceInfo as B, type ChainAdapter as C, type EvmWallet as E, type GenericWallet as G, type PaymentAccept as P, type SolanaWallet as S, type VerifyResponse as V, type WalletSet as W, X402Error as X, createEvmAdapter as a, type AccessPassTier as b, createSolanaAdapter as c, type AccessPassInfo as d, type SettleResponse as e, type PayToProvider as f, type PaymentRequired as g, type PayToContext as h, type PayToProviderDefaults as i, type AccessPassClaims as j, SolanaAdapter as k, EvmAdapter as l, type AdapterConfig as m, type SignedTransaction as n, isSolanaWallet as o, isEvmWallet as p };