@t402/extensions 2.5.0 → 2.6.1

package/dist/esm/eip2612-gas-sponsoring/index.d.mts

@@ -0,0 +1,337 @@
+/**
+ * EIP-2612 Gas Sponsoring Extension Type Definitions
+ *
+ * EIP-2612 permit-based gas sponsoring for the t402 payment protocol.
+ * Allows facilitators to sponsor gas fees by having clients sign off-chain
+ * permits instead of submitting on-chain approval transactions.
+ */
+/**
+ * Information provided by server about gas sponsoring availability.
+ */
+interface Eip2612GasSponsorExtensionInfo {
+    /** CAIP-2 network identifiers where gas sponsoring is available */
+    sponsoredNetworks: string[];
+    /** Maximum token amount (in base units) the sponsor will cover per permit */
+    maxAmount: string;
+    /** Default permit deadline in seconds from now */
+    permitDeadline: number;
+    /** Address of the sponsor/facilitator that will call permit + transferFrom */
+    sponsorAddress: string;
+}
+/**
+ * Gas sponsor extension declaration for server responses.
+ */
+interface Eip2612GasSponsorExtension {
+    /** Extension information */
+    info: Eip2612GasSponsorExtensionInfo;
+    /** JSON Schema for validation */
+    schema: object;
+}
+/**
+ * Complete gas sponsor payload from client including permit signature.
+ */
+interface Eip2612GasSponsorPayload {
+    /** CAIP-2 network identifier (must be in sponsoredNetworks) */
+    network: string;
+    /** Full hex-encoded EIP-2612 permit signature (65 bytes, r + s + v) */
+    permitSignature: string;
+    /** Token owner address (the client's wallet) */
+    owner: string;
+    /** Spender address (must match sponsorAddress) */
+    spender: string;
+    /** Token amount in base units */
+    value: string;
+    /** Unix timestamp for permit expiry */
+    deadline: number;
+    /** Recovery parameter from signature */
+    v: number;
+    /** Signature r component (32 bytes hex) */
+    r: string;
+    /** Signature s component (32 bytes hex) */
+    s: string;
+}
+/**
+ * Options for declaring gas sponsor extension on server.
+ */
+interface DeclareEip2612GasSponsorOptions {
+    /** CAIP-2 network identifiers where gas sponsoring is available */
+    sponsoredNetworks: string[];
+    /** Maximum token amount (in base units) the sponsor will cover per permit */
+    maxAmount: string;
+    /** Default permit deadline in seconds from now (defaults to 300 = 5 minutes) */
+    permitDeadline?: number;
+    /** Address of the sponsor/facilitator */
+    sponsorAddress: string;
+}
+/**
+ * Options for validating gas sponsor payloads.
+ */
+interface ValidateEip2612GasSponsorOptions {
+    /** Custom time function for testing (defaults to Date.now) */
+    now?: () => number;
+}
+/**
+ * Result of gas sponsor payload validation.
+ */
+interface Eip2612GasSponsorValidationResult {
+    /** Whether the payload is valid */
+    valid: boolean;
+    /** Error message if invalid */
+    error?: string;
+}
+/**
+ * Parameters for creating an EIP-2612 permit signature.
+ */
+interface CreatePermitParams {
+    /** EIP-712 signer interface */
+    signer: PermitSigner;
+    /** ERC-20 token contract address */
+    tokenAddress: string;
+    /** Token name (used in EIP-712 domain) */
+    tokenName: string;
+    /** Chain ID (numeric, e.g. 8453 for Base) */
+    chainId: number;
+    /** Spender address (the facilitator/sponsor) */
+    spender: string;
+    /** Token amount in base units */
+    value: string;
+    /** Unix timestamp for permit expiry */
+    deadline: number;
+    /** Current permit nonce for the owner (defaults to 0) */
+    nonce?: number;
+}
+/**
+ * Signer interface for EIP-2612 permit signing.
+ */
+interface PermitSigner {
+    /** Wallet address */
+    address: string;
+    /**
+     * Sign EIP-712 typed data and return hex-encoded signature.
+     *
+     * @param data - EIP-712 typed data to sign
+     * @returns Hex-encoded signature
+     */
+    signTypedData(data: {
+        domain: Record<string, unknown>;
+        types: Record<string, Array<{
+            name: string;
+            type: string;
+        }>>;
+        primaryType: string;
+        message: Record<string, unknown>;
+    }): Promise<string>;
+}
+
+/**
+ * EIP-2612 Gas Sponsoring Extension Server-Side Implementation
+ *
+ * Provides functions for servers to declare gas sponsoring requirements,
+ * parse client headers, and validate permit payloads.
+ */
+
+/**
+ * Declares an EIP-2612 gas sponsor extension for server responses.
+ *
+ * @param options - Extension declaration options
+ * @returns Gas sponsor extension object ready for response
+ *
+ * @example
+ * ```typescript
+ * const extension = declareEip2612GasSponsorExtension({
+ *   sponsoredNetworks: ["eip155:8453", "eip155:42161"],
+ *   maxAmount: "1000000000",
+ *   sponsorAddress: "0xFacilitator...",
+ * });
+ * ```
+ */
+declare function declareEip2612GasSponsorExtension(options: DeclareEip2612GasSponsorOptions): Eip2612GasSponsorExtension;
+/**
+ * Parses an EIP-2612 gas sponsor header from client request.
+ *
+ * The header format is base64-encoded JSON.
+ *
+ * @param header - Base64-encoded gas sponsor header value
+ * @returns Parsed gas sponsor payload
+ * @throws Error if header is invalid
+ *
+ * @example
+ * ```typescript
+ * const payload = parseEip2612GasSponsorHeader(
+ *   request.headers['x-t402-eip2612-gas-sponsoring']
+ * );
+ * ```
+ */
+declare function parseEip2612GasSponsorHeader(header: string): Eip2612GasSponsorPayload;
+/**
+ * Validates an EIP-2612 gas sponsor payload against server extension info.
+ *
+ * @param payload - The gas sponsor payload from the client
+ * @param extensionInfo - The server's gas sponsor extension info
+ * @param options - Validation options
+ * @returns Validation result
+ *
+ * @example
+ * ```typescript
+ * const result = validateEip2612GasSponsorPayload(payload, extension.info);
+ * if (!result.valid) {
+ *   throw new Error(result.error);
+ * }
+ * ```
+ */
+declare function validateEip2612GasSponsorPayload(payload: Eip2612GasSponsorPayload, extensionInfo: Eip2612GasSponsorExtensionInfo, options?: ValidateEip2612GasSponsorOptions): Eip2612GasSponsorValidationResult;
+
+/**
+ * EIP-2612 Gas Sponsoring Extension Client-Side Implementation
+ *
+ * Provides functions for clients to create EIP-2612 permit signatures
+ * and encode gas sponsor payloads for transmission.
+ */
+
+/**
+ * Extension key for EIP-2612 gas sponsoring in payment requirements.
+ */
+declare const EIP2612_GAS_SPONSOR_EXTENSION_KEY = "eip2612GasSponsoring";
+/**
+ * HTTP header name for EIP-2612 gas sponsor payload.
+ */
+declare const EIP2612_GAS_SPONSOR_HEADER_NAME = "X-T402-EIP2612-Gas-Sponsoring";
+/**
+ * Creates an EIP-2612 permit signature using EIP-712 typed data signing.
+ *
+ * @param params - Permit signing parameters
+ * @returns Permit data including the signature components
+ *
+ * @example
+ * ```typescript
+ * const permit = await createPermitSignature({
+ *   signer: wallet,
+ *   tokenAddress: "0xUSDT...",
+ *   tokenName: "Tether USD",
+ *   chainId: 8453,
+ *   spender: facilitatorAddress,
+ *   value: "1000000",
+ *   deadline: Math.floor(Date.now() / 1000) + 300,
+ * });
+ * ```
+ */
+declare function createPermitSignature(params: CreatePermitParams): Promise<{
+    owner: string;
+    spender: string;
+    value: string;
+    deadline: number;
+    v: number;
+    r: string;
+    s: string;
+    permitSignature: string;
+}>;
+/**
+ * Creates a gas sponsor payload from permit data and network.
+ *
+ * @param permit - Permit signature data from createPermitSignature
+ * @param network - CAIP-2 network identifier (e.g., "eip155:8453")
+ * @returns Gas sponsor payload ready for header encoding
+ *
+ * @example
+ * ```typescript
+ * const payload = createEip2612GasSponsorPayload(permit, "eip155:8453");
+ * ```
+ */
+declare function createEip2612GasSponsorPayload(permit: {
+    owner: string;
+    spender: string;
+    value: string;
+    deadline: number;
+    v: number;
+    r: string;
+    s: string;
+    permitSignature: string;
+}, network: string): Eip2612GasSponsorPayload;
+/**
+ * Encodes a gas sponsor payload for transmission in HTTP header.
+ *
+ * @param payload - The gas sponsor payload to encode
+ * @returns Base64-encoded JSON string
+ *
+ * @example
+ * ```typescript
+ * const header = encodeEip2612GasSponsorHeader(payload);
+ * fetch(url, {
+ *   headers: { [EIP2612_GAS_SPONSOR_HEADER_NAME]: header }
+ * });
+ * ```
+ */
+declare function encodeEip2612GasSponsorHeader(payload: Eip2612GasSponsorPayload): string;
+
+/**
+ * EIP-2612 Gas Sponsoring Extension Facilitator-Side Implementation
+ *
+ * Provides functions for facilitators to extract permit data from payment
+ * extensions, validate permits, and prepare on-chain submission.
+ */
+
+/**
+ * Extracts the EIP-2612 gas sponsor payload from payment extensions.
+ *
+ * @param extensions - The extensions map from a PaymentPayload
+ * @returns The gas sponsor payload if present, or null
+ *
+ * @example
+ * ```typescript
+ * const permit = extractEip2612GasSponsorPayload(paymentPayload.extensions);
+ * if (permit) {
+ *   // Submit permit tx then settle via Permit2
+ * }
+ * ```
+ */
+declare function extractEip2612GasSponsorPayload(extensions: Record<string, unknown> | undefined): Eip2612GasSponsorPayload | null;
+/**
+ * Validates and extracts the EIP-2612 gas sponsor payload in one step.
+ *
+ * This is a convenience function for facilitators that combines extraction
+ * and validation against the server's extension info.
+ *
+ * @param extensions - The extensions map from a PaymentPayload
+ * @param extensionInfo - The server's gas sponsor extension info
+ * @returns Validation result with the extracted payload if valid
+ *
+ * @example
+ * ```typescript
+ * const result = validateAndExtractPermit(
+ *   paymentPayload.extensions,
+ *   extensionInfo
+ * );
+ * if (result.valid && result.payload) {
+ *   // Submit permit() on token contract, then settle via Permit2
+ * }
+ * ```
+ */
+declare function validateAndExtractPermit(extensions: Record<string, unknown> | undefined, extensionInfo: Eip2612GasSponsorExtensionInfo): Eip2612GasSponsorValidationResult & {
+    payload?: Eip2612GasSponsorPayload;
+};
+/**
+ * Builds the EIP-2612 permit function call data for on-chain submission.
+ *
+ * Returns the ABI-encoded parameters needed to call `permit(owner, spender, value, deadline, v, r, s)`
+ * on the token contract.
+ *
+ * @param payload - The validated gas sponsor payload
+ * @returns Object with the permit call parameters
+ *
+ * @example
+ * ```typescript
+ * const permitCall = buildPermitCallData(payload);
+ * // Use permitCall with your preferred web3 library to submit the tx
+ * ```
+ */
+declare function buildPermitCallData(payload: Eip2612GasSponsorPayload): {
+    owner: string;
+    spender: string;
+    value: string;
+    deadline: number;
+    v: number;
+    r: string;
+    s: string;
+};
+
+export { type CreatePermitParams, type DeclareEip2612GasSponsorOptions, EIP2612_GAS_SPONSOR_EXTENSION_KEY, EIP2612_GAS_SPONSOR_HEADER_NAME, type Eip2612GasSponsorExtension, type Eip2612GasSponsorExtensionInfo, type Eip2612GasSponsorPayload, type Eip2612GasSponsorValidationResult, type PermitSigner, type ValidateEip2612GasSponsorOptions, buildPermitCallData, createEip2612GasSponsorPayload, createPermitSignature, declareEip2612GasSponsorExtension, encodeEip2612GasSponsorHeader, extractEip2612GasSponsorPayload, parseEip2612GasSponsorHeader, validateAndExtractPermit, validateEip2612GasSponsorPayload };

package/dist/esm/eip2612-gas-sponsoring/index.mjs

@@ -0,0 +1,27 @@
+import {
+  EIP2612_GAS_SPONSOR_EXTENSION_KEY,
+  EIP2612_GAS_SPONSOR_HEADER_NAME,
+  buildPermitCallData,
+  createEip2612GasSponsorPayload,
+  createPermitSignature,
+  declareEip2612GasSponsorExtension,
+  encodeEip2612GasSponsorHeader,
+  extractEip2612GasSponsorPayload,
+  parseEip2612GasSponsorHeader,
+  validateAndExtractPermit,
+  validateEip2612GasSponsorPayload
+} from "../chunk-VINC22RD.mjs";
+export {
+  EIP2612_GAS_SPONSOR_EXTENSION_KEY,
+  EIP2612_GAS_SPONSOR_HEADER_NAME,
+  buildPermitCallData,
+  createEip2612GasSponsorPayload,
+  createPermitSignature,
+  declareEip2612GasSponsorExtension,
+  encodeEip2612GasSponsorHeader,
+  extractEip2612GasSponsorPayload,
+  parseEip2612GasSponsorHeader,
+  validateAndExtractPermit,
+  validateEip2612GasSponsorPayload
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/eip2612-gas-sponsoring/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/erc20-approval-gas-sponsoring/index.d.mts

@@ -0,0 +1,316 @@
+/**
+ * ERC-20 Approval Gas Sponsoring Extension Type Definitions
+ *
+ * ERC-20 approve()-based gas sponsoring for the t402 payment protocol.
+ * For tokens WITHOUT EIP-2612 permit support, the client signs an offline
+ * approve() transaction and the facilitator broadcasts it on their behalf.
+ */
+/**
+ * Information provided by server about ERC-20 approval gas sponsoring availability.
+ */
+interface ERC20ApprovalGasSponsorExtensionInfo {
+    /** CAIP-2 network identifiers where gas sponsoring is available */
+    sponsoredNetworks: string[];
+    /** Maximum token amount (in base units) the sponsor will cover per approval */
+    maxAmount: string;
+    /** Address of the sponsor/facilitator that will submit transactions */
+    sponsorAddress: string;
+    /** Optional Permit2 proxy address for advanced settlement flows */
+    permit2Address?: string;
+    /** Whether atomic batch execution is required (e.g., via Multicall3) */
+    requiresAtomicBatch: boolean;
+}
+/**
+ * ERC-20 approval gas sponsor extension declaration for server responses.
+ */
+interface ERC20ApprovalGasSponsorExtension {
+    /** Extension information */
+    info: ERC20ApprovalGasSponsorExtensionInfo;
+    /** JSON Schema for validation */
+    schema: object;
+}
+/**
+ * Complete ERC-20 approval gas sponsor payload from client.
+ */
+interface ERC20ApprovalGasSponsorPayload {
+    /** CAIP-2 network identifier (must be in sponsoredNetworks) */
+    network: string;
+    /** Client wallet address that signed the transaction */
+    from: string;
+    /** ERC-20 token contract address */
+    asset: string;
+    /** Approval amount in base units */
+    amount: string;
+    /** Raw signed approve() transaction (hex-encoded with 0x prefix) */
+    signedApprovalTx: string;
+    /** Chain ID for replay protection */
+    chainId: number;
+    /** Client's account nonce (if known) */
+    nonce?: number;
+}
+/**
+ * Options for declaring ERC-20 approval gas sponsor extension on server.
+ */
+interface DeclareERC20ApprovalGasSponsorOptions {
+    /** CAIP-2 network identifiers where gas sponsoring is available */
+    sponsoredNetworks: string[];
+    /** Maximum token amount (in base units) the sponsor will cover per approval */
+    maxAmount: string;
+    /** Address of the sponsor/facilitator */
+    sponsorAddress: string;
+    /** Optional Permit2 proxy address */
+    permit2Address?: string;
+    /** Whether atomic batch execution is required (defaults to false) */
+    requiresAtomicBatch?: boolean;
+}
+/**
+ * Options for validating ERC-20 approval gas sponsor payloads.
+ */
+interface ValidateERC20ApprovalGasSponsorOptions {
+    /** Expected chain IDs per CAIP-2 network (e.g., { "eip155:8453": 8453 }) */
+    expectedChainIds?: Record<string, number>;
+}
+/**
+ * Result of ERC-20 approval gas sponsor payload validation.
+ */
+interface ERC20ApprovalGasSponsorValidationResult {
+    /** Whether the payload is valid */
+    valid: boolean;
+    /** Error message if invalid */
+    error?: string;
+}
+/**
+ * Parameters for creating an ERC-20 approval gas sponsor payload.
+ */
+interface CreateERC20ApprovalParams {
+    /** CAIP-2 network identifier */
+    network: string;
+    /** Client wallet address */
+    from: string;
+    /** ERC-20 token contract address */
+    asset: string;
+    /** Approval amount in base units */
+    amount: string;
+    /** Raw signed approve() transaction (hex-encoded) */
+    signedApprovalTx: string;
+    /** Chain ID for replay protection */
+    chainId: number;
+    /** Client's account nonce (if known) */
+    nonce?: number;
+}
+
+/**
+ * ERC-20 Approval Gas Sponsoring Extension Server-Side Implementation
+ *
+ * Provides functions for servers to declare gas sponsoring requirements,
+ * parse client headers, and validate approval payloads.
+ */
+
+/**
+ * Declares an ERC-20 approval gas sponsor extension for server responses.
+ *
+ * @param options - Extension declaration options
+ * @returns Gas sponsor extension object ready for response
+ *
+ * @example
+ * ```typescript
+ * const extension = declareERC20ApprovalGasSponsorExtension({
+ *   sponsoredNetworks: ["eip155:8453", "eip155:42161"],
+ *   maxAmount: "1000000000",
+ *   sponsorAddress: "0xFacilitator...",
+ *   requiresAtomicBatch: true,
+ * });
+ * ```
+ */
+declare function declareERC20ApprovalGasSponsorExtension(options: DeclareERC20ApprovalGasSponsorOptions): ERC20ApprovalGasSponsorExtension;
+/**
+ * Parses an ERC-20 approval gas sponsor header from client request.
+ *
+ * The header format is base64-encoded JSON.
+ *
+ * @param header - Base64-encoded gas sponsor header value
+ * @returns Parsed gas sponsor payload
+ * @throws Error if header is invalid
+ *
+ * @example
+ * ```typescript
+ * const payload = parseERC20ApprovalGasSponsorHeader(
+ *   request.headers['x-t402-erc20-approval-gas-sponsoring']
+ * );
+ * ```
+ */
+declare function parseERC20ApprovalGasSponsorHeader(header: string): ERC20ApprovalGasSponsorPayload;
+/**
+ * Validates an ERC-20 approval gas sponsor payload against server extension info.
+ *
+ * @param payload - The gas sponsor payload from the client
+ * @param extensionInfo - The server's gas sponsor extension info
+ * @param options - Validation options
+ * @returns Validation result
+ *
+ * @example
+ * ```typescript
+ * const result = validateERC20ApprovalGasSponsorPayload(payload, extension.info);
+ * if (!result.valid) {
+ *   throw new Error(result.error);
+ * }
+ * ```
+ */
+declare function validateERC20ApprovalGasSponsorPayload(payload: ERC20ApprovalGasSponsorPayload, extensionInfo: ERC20ApprovalGasSponsorExtensionInfo, options?: ValidateERC20ApprovalGasSponsorOptions): ERC20ApprovalGasSponsorValidationResult;
+
+/**
+ * ERC-20 Approval Gas Sponsoring Extension Client-Side Implementation
+ *
+ * Provides functions for clients to construct ERC-20 approve() calldata
+ * and encode gas sponsor payloads for transmission.
+ */
+
+/**
+ * Extension key for ERC-20 approval gas sponsoring in payment requirements.
+ */
+declare const ERC20_APPROVAL_GAS_SPONSOR_EXTENSION_KEY = "erc20ApprovalGasSponsoring";
+/**
+ * HTTP header name for ERC-20 approval gas sponsor payload.
+ */
+declare const ERC20_APPROVAL_GAS_SPONSOR_HEADER_NAME = "X-T402-ERC20-Approval-Gas-Sponsoring";
+/**
+ * ERC-20 approve(address,uint256) function selector.
+ */
+declare const APPROVE_FUNCTION_SELECTOR = "0x095ea7b3";
+/**
+ * Encodes ERC-20 approve(address spender, uint256 amount) calldata.
+ *
+ * @param spender - The spender address to approve
+ * @param amount - The approval amount in base units
+ * @returns Hex-encoded calldata with 0x prefix
+ *
+ * @example
+ * ```typescript
+ * const calldata = encodeApproveCalldata("0xFacilitator...", "1000000");
+ * // Returns "0x095ea7b3" + abi-encoded args
+ * ```
+ */
+declare function encodeApproveCalldata(spender: string, amount: string): string;
+/**
+ * Creates an ERC-20 approval gas sponsor payload from params and extension info.
+ *
+ * @param info - The server's extension info
+ * @param params - The approval parameters
+ * @returns Gas sponsor payload ready for header encoding
+ *
+ * @example
+ * ```typescript
+ * const payload = createERC20ApprovalGasSponsorPayload(extensionInfo, {
+ *   network: "eip155:8453",
+ *   from: wallet.address,
+ *   asset: "0xUSDT...",
+ *   amount: "1000000",
+ *   signedApprovalTx: signedTx,
+ *   chainId: 8453,
+ * });
+ * ```
+ */
+declare function createERC20ApprovalGasSponsorPayload(_info: ERC20ApprovalGasSponsorExtensionInfo, params: CreateERC20ApprovalParams): ERC20ApprovalGasSponsorPayload;
+/**
+ * Encodes an ERC-20 approval gas sponsor payload for transmission in HTTP header.
+ *
+ * @param payload - The gas sponsor payload to encode
+ * @returns Base64-encoded JSON string
+ *
+ * @example
+ * ```typescript
+ * const header = encodeERC20ApprovalGasSponsorHeader(payload);
+ * fetch(url, {
+ *   headers: { [ERC20_APPROVAL_GAS_SPONSOR_HEADER_NAME]: header }
+ * });
+ * ```
+ */
+declare function encodeERC20ApprovalGasSponsorHeader(payload: ERC20ApprovalGasSponsorPayload): string;
+
+/**
+ * ERC-20 Approval Gas Sponsoring Extension Facilitator-Side Implementation
+ *
+ * Provides functions for facilitators to extract approval data from payment
+ * extensions, validate the signed approve() transaction, and prepare for
+ * on-chain submission.
+ */
+
+/**
+ * Extracts the ERC-20 approval gas sponsor payload from payment extensions.
+ *
+ * @param extensions - The extensions map from a PaymentPayload
+ * @returns The gas sponsor payload if present, or null
+ *
+ * @example
+ * ```typescript
+ * const approval = extractERC20ApprovalGasSponsorPayload(paymentPayload.extensions);
+ * if (approval) {
+ *   // Validate and broadcast the approval tx, then settle
+ * }
+ * ```
+ */
+declare function extractERC20ApprovalGasSponsorPayload(extensions: Record<string, unknown> | undefined): ERC20ApprovalGasSponsorPayload | null;
+/**
+ * Processes and validates an ERC-20 approval payload for the facilitator.
+ *
+ * Combines extraction validation with approve() function selector verification.
+ * Checks that the signed transaction data contains the correct approve() selector
+ * and that the approval amount matches the declared amount.
+ *
+ * @param payload - The ERC-20 approval gas sponsor payload
+ * @param extensionInfo - The server's gas sponsor extension info
+ * @returns Validation result
+ *
+ * @example
+ * ```typescript
+ * const result = processERC20ApprovalPayload(payload, extensionInfo);
+ * if (result.valid) {
+ *   // Safe to broadcast the approval tx and settle
+ * }
+ * ```
+ */
+declare function processERC20ApprovalPayload(payload: ERC20ApprovalGasSponsorPayload, extensionInfo: ERC20ApprovalGasSponsorExtensionInfo): ERC20ApprovalGasSponsorValidationResult;
+/**
+ * Validates and extracts the ERC-20 approval gas sponsor payload in one step.
+ *
+ * This is a convenience function for facilitators that combines extraction
+ * and validation against the server's extension info.
+ *
+ * @param extensions - The extensions map from a PaymentPayload
+ * @param extensionInfo - The server's gas sponsor extension info
+ * @returns Validation result with the extracted payload if valid
+ *
+ * @example
+ * ```typescript
+ * const result = validateAndExtractApproval(
+ *   paymentPayload.extensions,
+ *   extensionInfo
+ * );
+ * if (result.valid && result.payload) {
+ *   // Broadcast approval tx, then settle
+ * }
+ * ```
+ */
+declare function validateAndExtractApproval(extensions: Record<string, unknown> | undefined, extensionInfo: ERC20ApprovalGasSponsorExtensionInfo): ERC20ApprovalGasSponsorValidationResult & {
+    payload?: ERC20ApprovalGasSponsorPayload;
+};
+/**
+ * Decodes the approve() calldata from a hex string to extract spender and amount.
+ *
+ * @param calldata - Hex-encoded approve() calldata (with or without 0x prefix)
+ * @returns Decoded spender and amount, or null if not valid approve() calldata
+ *
+ * @example
+ * ```typescript
+ * const decoded = decodeApproveCalldata("0x095ea7b3...");
+ * if (decoded) {
+ *   console.log(decoded.spender, decoded.amount);
+ * }
+ * ```
+ */
+declare function decodeApproveCalldata(calldata: string): {
+    spender: string;
+    amount: string;
+} | null;
+
+export { APPROVE_FUNCTION_SELECTOR, type CreateERC20ApprovalParams, type DeclareERC20ApprovalGasSponsorOptions, type ERC20ApprovalGasSponsorExtension, type ERC20ApprovalGasSponsorExtensionInfo, type ERC20ApprovalGasSponsorPayload, type ERC20ApprovalGasSponsorValidationResult, ERC20_APPROVAL_GAS_SPONSOR_EXTENSION_KEY, ERC20_APPROVAL_GAS_SPONSOR_HEADER_NAME, type ValidateERC20ApprovalGasSponsorOptions, createERC20ApprovalGasSponsorPayload, declareERC20ApprovalGasSponsorExtension, decodeApproveCalldata, encodeApproveCalldata, encodeERC20ApprovalGasSponsorHeader, extractERC20ApprovalGasSponsorPayload, parseERC20ApprovalGasSponsorHeader, processERC20ApprovalPayload, validateAndExtractApproval, validateERC20ApprovalGasSponsorPayload };