@t402/extensions 2.4.0 → 2.6.0

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 };

package/dist/esm/erc20-approval-gas-sponsoring/index.mjs

@@ -0,0 +1,31 @@
+import {
+  APPROVE_FUNCTION_SELECTOR,
+  ERC20_APPROVAL_GAS_SPONSOR_EXTENSION_KEY,
+  ERC20_APPROVAL_GAS_SPONSOR_HEADER_NAME,
+  createERC20ApprovalGasSponsorPayload,
+  declareERC20ApprovalGasSponsorExtension,
+  decodeApproveCalldata,
+  encodeApproveCalldata,
+  encodeERC20ApprovalGasSponsorHeader,
+  extractERC20ApprovalGasSponsorPayload,
+  parseERC20ApprovalGasSponsorHeader,
+  processERC20ApprovalPayload,
+  validateAndExtractApproval,
+  validateERC20ApprovalGasSponsorPayload
+} from "../chunk-OAWKCEAR.mjs";
+export {
+  APPROVE_FUNCTION_SELECTOR,
+  ERC20_APPROVAL_GAS_SPONSOR_EXTENSION_KEY,
+  ERC20_APPROVAL_GAS_SPONSOR_HEADER_NAME,
+  createERC20ApprovalGasSponsorPayload,
+  declareERC20ApprovalGasSponsorExtension,
+  decodeApproveCalldata,
+  encodeApproveCalldata,
+  encodeERC20ApprovalGasSponsorHeader,
+  extractERC20ApprovalGasSponsorPayload,
+  parseERC20ApprovalGasSponsorHeader,
+  processERC20ApprovalPayload,
+  validateAndExtractApproval,
+  validateERC20ApprovalGasSponsorPayload
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/erc20-approval-gas-sponsoring/index.mjs.map

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

package/dist/esm/{index-DYNleT-u.d.mts → index-Mk5Ypp8M.d.mts}

@@ -1,4 +1,4 @@
-import { QueryParamMethods, BodyMethods, HTTPFacilitatorClient } from '@t402/core/http';
+import { BodyMethods, QueryParamMethods, HTTPFacilitatorClient } from '@t402/core/http';
 import { ResourceServerExtension, PaymentPayload, PaymentRequirements, PaymentRequirementsV1 } from '@t402/core/types';
 
 /**
@@ -544,4 +544,4 @@ interface BazaarClientExtension {
  */
 declare function withBazaar<T extends HTTPFacilitatorClient>(client: T): WithExtensions<T, BazaarClientExtension>;
 
-export { type BodyDiscoveryInfo as B, type DiscoveryInfo as D, type ListDiscoveryResourcesParams as L, type QueryDiscoveryInfo as Q, type ValidationResult as V, type WithExtensions as W, type QueryDiscoveryExtension as a, bazaarResourceServerExtension as b, type BodyDiscoveryExtension as c, type DiscoveryExtension as d, BAZAAR as e, declareDiscoveryExtension as f, extractDiscoveryInfo as g, extractDiscoveryInfoFromExtension as h, validateAndExtract as i, extractDiscoveryInfoV1 as j, isDiscoverableV1 as k, extractResourceMetadataV1 as l, type BazaarClientExtension as m, type DiscoveryResource as n, type DiscoveryResourcesResponse as o, validateDiscoveryExtension as v, withBazaar as w };
+export { BAZAAR as B, type DiscoveryExtension as D, type ListDiscoveryResourcesParams as L, type QueryDiscoveryExtension as Q, type ValidationResult as V, type WithExtensions as W, type BazaarClientExtension as a, type BodyDiscoveryExtension as b, type BodyDiscoveryInfo as c, type DiscoveryInfo as d, type DiscoveryResource as e, type DiscoveryResourcesResponse as f, type QueryDiscoveryInfo as g, bazaarResourceServerExtension as h, declareDiscoveryExtension as i, extractDiscoveryInfo as j, extractDiscoveryInfoFromExtension as k, extractDiscoveryInfoV1 as l, extractResourceMetadataV1 as m, isDiscoverableV1 as n, validateDiscoveryExtension as o, validateAndExtract as v, withBazaar as w };

package/dist/esm/index.d.mts

@@ -1,4 +1,7 @@
-export { e as BAZAAR, m as BazaarClientExtension, c as BodyDiscoveryExtension, B as BodyDiscoveryInfo, d as DiscoveryExtension, D as DiscoveryInfo, n as DiscoveryResource, o as DiscoveryResourcesResponse, L as ListDiscoveryResourcesParams, a as QueryDiscoveryExtension, Q as QueryDiscoveryInfo, V as ValidationResult, W as WithExtensions, b as bazaarResourceServerExtension, f as declareDiscoveryExtension, g as extractDiscoveryInfo, h as extractDiscoveryInfoFromExtension, j as extractDiscoveryInfoV1, l as extractResourceMetadataV1, k as isDiscoverableV1, i as validateAndExtract, v as validateDiscoveryExtension, w as withBazaar } from './index-DYNleT-u.mjs';
+export { B as BAZAAR, a as BazaarClientExtension, b as BodyDiscoveryExtension, c as BodyDiscoveryInfo, D as DiscoveryExtension, d as DiscoveryInfo, e as DiscoveryResource, f as DiscoveryResourcesResponse, L as ListDiscoveryResourcesParams, Q as QueryDiscoveryExtension, g as QueryDiscoveryInfo, V as ValidationResult, W as WithExtensions, h as bazaarResourceServerExtension, i as declareDiscoveryExtension, j as extractDiscoveryInfo, k as extractDiscoveryInfoFromExtension, l as extractDiscoveryInfoV1, m as extractResourceMetadataV1, n as isDiscoverableV1, v as validateAndExtract, o as validateDiscoveryExtension, w as withBazaar } from './index-Mk5Ypp8M.mjs';
 export { DeclareSIWxOptions, SIWX_EXTENSION_KEY, SIWX_HEADER_NAME, SIWxExtension, SIWxExtensionInfo, SIWxPayload, SIWxSigner, SIWxValidationResult, SIWxVerificationResult, SignatureScheme, ValidateSIWxOptions, VerifySIWxOptions, constructMessage, createSIWxMessage, createSIWxPayload, createSIWxTypedData, declareSIWxExtension, encodeSIWxHeader, hashMessage, parseSIWxHeader, signSIWxMessage, validateSIWxMessage, verifyEIP6492Signature, verifySIWxSignature } from './sign-in-with-x/index.mjs';
+export { DeclarePaymentIdOptions, PAYMENT_ID_EXTENSION_KEY, PaymentIdExtension, PaymentIdExtensionInfo, PaymentIdPayload, createPaymentIdPayload, declarePaymentIdExtension, encodePaymentIdHeader, parsePaymentIdPayload, validatePaymentId } from './payment-id/index.mjs';
+export { CreatePermitParams, DeclareEip2612GasSponsorOptions, EIP2612_GAS_SPONSOR_EXTENSION_KEY, EIP2612_GAS_SPONSOR_HEADER_NAME, Eip2612GasSponsorExtension, Eip2612GasSponsorExtensionInfo, Eip2612GasSponsorPayload, Eip2612GasSponsorValidationResult, PermitSigner, ValidateEip2612GasSponsorOptions, buildPermitCallData, createEip2612GasSponsorPayload, createPermitSignature, declareEip2612GasSponsorExtension, encodeEip2612GasSponsorHeader, extractEip2612GasSponsorPayload, parseEip2612GasSponsorHeader, validateAndExtractPermit, validateEip2612GasSponsorPayload } from './eip2612-gas-sponsoring/index.mjs';
+export { APPROVE_FUNCTION_SELECTOR, CreateERC20ApprovalParams, DeclareERC20ApprovalGasSponsorOptions, ERC20ApprovalGasSponsorExtension, ERC20ApprovalGasSponsorExtensionInfo, ERC20ApprovalGasSponsorPayload, ERC20ApprovalGasSponsorValidationResult, ERC20_APPROVAL_GAS_SPONSOR_EXTENSION_KEY, ERC20_APPROVAL_GAS_SPONSOR_HEADER_NAME, ValidateERC20ApprovalGasSponsorOptions, createERC20ApprovalGasSponsorPayload, declareERC20ApprovalGasSponsorExtension, decodeApproveCalldata, encodeApproveCalldata, encodeERC20ApprovalGasSponsorHeader, extractERC20ApprovalGasSponsorPayload, parseERC20ApprovalGasSponsorHeader, processERC20ApprovalPayload, validateAndExtractApproval, validateERC20ApprovalGasSponsorPayload } from './erc20-approval-gas-sponsoring/index.mjs';
 import '@t402/core/http';
 import '@t402/core/types';

package/dist/esm/index.mjs

@@ -26,29 +26,95 @@ import {
   validateSIWxMessage,
   verifyEIP6492Signature,
   verifySIWxSignature
-} from "./chunk-J3ZMNCIA.mjs";
+} from "./chunk-YKZ5P2JW.mjs";
+import {
+  PAYMENT_ID_EXTENSION_KEY,
+  createPaymentIdPayload,
+  declarePaymentIdExtension,
+  encodePaymentIdHeader,
+  parsePaymentIdPayload,
+  validatePaymentId
+} from "./chunk-S36A7YLQ.mjs";
+import {
+  EIP2612_GAS_SPONSOR_EXTENSION_KEY,
+  EIP2612_GAS_SPONSOR_HEADER_NAME,
+  buildPermitCallData,
+  createEip2612GasSponsorPayload,
+  createPermitSignature,
+  declareEip2612GasSponsorExtension,
+  encodeEip2612GasSponsorHeader,
+  extractEip2612GasSponsorPayload,
+  parseEip2612GasSponsorHeader,
+  validateAndExtractPermit,
+  validateEip2612GasSponsorPayload
+} from "./chunk-VINC22RD.mjs";
+import {
+  APPROVE_FUNCTION_SELECTOR,
+  ERC20_APPROVAL_GAS_SPONSOR_EXTENSION_KEY,
+  ERC20_APPROVAL_GAS_SPONSOR_HEADER_NAME,
+  createERC20ApprovalGasSponsorPayload,
+  declareERC20ApprovalGasSponsorExtension,
+  decodeApproveCalldata,
+  encodeApproveCalldata,
+  encodeERC20ApprovalGasSponsorHeader,
+  extractERC20ApprovalGasSponsorPayload,
+  parseERC20ApprovalGasSponsorHeader,
+  processERC20ApprovalPayload,
+  validateAndExtractApproval,
+  validateERC20ApprovalGasSponsorPayload
+} from "./chunk-OAWKCEAR.mjs";
 export {
+  APPROVE_FUNCTION_SELECTOR,
   BAZAAR,
+  EIP2612_GAS_SPONSOR_EXTENSION_KEY,
+  EIP2612_GAS_SPONSOR_HEADER_NAME,
+  ERC20_APPROVAL_GAS_SPONSOR_EXTENSION_KEY,
+  ERC20_APPROVAL_GAS_SPONSOR_HEADER_NAME,
+  PAYMENT_ID_EXTENSION_KEY,
   SIWX_EXTENSION_KEY,
   SIWX_HEADER_NAME,
   bazaarResourceServerExtension,
+  buildPermitCallData,
   constructMessage,
+  createERC20ApprovalGasSponsorPayload,
+  createEip2612GasSponsorPayload,
+  createPaymentIdPayload,
+  createPermitSignature,
   createSIWxMessage,
   createSIWxPayload,
   createSIWxTypedData,
   declareDiscoveryExtension,
+  declareERC20ApprovalGasSponsorExtension,
+  declareEip2612GasSponsorExtension,
+  declarePaymentIdExtension,
   declareSIWxExtension,
+  decodeApproveCalldata,
+  encodeApproveCalldata,
+  encodeERC20ApprovalGasSponsorHeader,
+  encodeEip2612GasSponsorHeader,
+  encodePaymentIdHeader,
   encodeSIWxHeader,
   extractDiscoveryInfo,
   extractDiscoveryInfoFromExtension,
   extractDiscoveryInfoV1,
+  extractERC20ApprovalGasSponsorPayload,
+  extractEip2612GasSponsorPayload,
   extractResourceMetadataV1,
   hashMessage,
   isDiscoverableV1,
+  parseERC20ApprovalGasSponsorHeader,
+  parseEip2612GasSponsorHeader,
+  parsePaymentIdPayload,
   parseSIWxHeader,
+  processERC20ApprovalPayload,
   signSIWxMessage,
   validateAndExtract,
+  validateAndExtractApproval,
+  validateAndExtractPermit,
   validateDiscoveryExtension,
+  validateERC20ApprovalGasSponsorPayload,
+  validateEip2612GasSponsorPayload,
+  validatePaymentId,
   validateSIWxMessage,
   verifyEIP6492Signature,
   verifySIWxSignature,

package/dist/esm/payment-id/index.d.mts

@@ -0,0 +1,142 @@
+/**
+ * Payment ID Extension Type Definitions
+ *
+ * Allows servers to attach unique identifiers to payments for
+ * correlation, idempotency, and audit trails.
+ */
+/**
+ * Extension key for payment ID in requirements/payload extensions.
+ */
+declare const PAYMENT_ID_EXTENSION_KEY = "paymentId";
+/**
+ * Information provided by server about the payment identifier.
+ */
+interface PaymentIdExtensionInfo {
+    /** Unique payment identifier (UUID v4) */
+    id: string;
+    /** Optional idempotency key for replay protection */
+    idempotencyKey?: string;
+    /** Optional payment group for batching */
+    groupId?: string;
+    /** Optional metadata */
+    metadata?: Record<string, string>;
+}
+/**
+ * Payment ID extension declaration for server responses.
+ */
+interface PaymentIdExtension {
+    /** Extension information */
+    info: PaymentIdExtensionInfo;
+    /** JSON Schema for validation */
+    schema: object;
+}
+/**
+ * Payment ID payload echoed back by the client.
+ */
+interface PaymentIdPayload {
+    /** Payment ID echoed back from requirements */
+    id: string;
+    /** Optional client-generated correlation ID */
+    clientId?: string;
+}
+/**
+ * Options for declaring a payment ID extension.
+ */
+interface DeclarePaymentIdOptions {
+    /** Custom payment ID (defaults to crypto.randomUUID()) */
+    id?: string;
+    /** Optional idempotency key for replay protection */
+    idempotencyKey?: string;
+    /** Optional payment group for batching */
+    groupId?: string;
+    /** Optional metadata */
+    metadata?: Record<string, string>;
+}
+
+/**
+ * Payment ID Extension Server-Side Implementation
+ *
+ * Provides functions for servers to declare payment ID requirements,
+ * parse client payloads, and validate payment IDs.
+ */
+
+/**
+ * Declares a payment ID extension for server responses.
+ *
+ * @param options - Optional configuration for the payment ID
+ * @returns Payment ID extension object ready for response
+ *
+ * @example
+ * ```typescript
+ * const extension = declarePaymentIdExtension();
+ * // Include in PaymentRequired response extensions:
+ * // extensions: { [PAYMENT_ID_EXTENSION_KEY]: extension }
+ * ```
+ */
+declare function declarePaymentIdExtension(options?: DeclarePaymentIdOptions): PaymentIdExtension;
+/**
+ * Parses a payment ID payload from client request extensions.
+ *
+ * @param extensions - Extensions object from the payment payload
+ * @returns Parsed payment ID payload, or null if not present
+ * @throws Error if payload is present but invalid
+ *
+ * @example
+ * ```typescript
+ * const payload = parsePaymentIdPayload(paymentPayload.extensions);
+ * if (payload) {
+ *   console.log("Payment ID:", payload.id);
+ * }
+ * ```
+ */
+declare function parsePaymentIdPayload(extensions?: Record<string, unknown>): PaymentIdPayload | null;
+/**
+ * Validates that a client's payment ID payload matches the expected extension.
+ *
+ * @param payload - The client's payment ID payload
+ * @param expected - The expected payment ID from the server extension
+ * @returns True if the payment ID matches
+ *
+ * @example
+ * ```typescript
+ * const isValid = validatePaymentId(clientPayload, serverExtension.info);
+ * if (!isValid) {
+ *   throw new Error("Payment ID mismatch");
+ * }
+ * ```
+ */
+declare function validatePaymentId(payload: PaymentIdPayload, expected: PaymentIdExtensionInfo): boolean;
+
+/**
+ * Payment ID Extension Client-Side Implementation
+ *
+ * Provides functions for clients to echo payment IDs back to servers.
+ */
+
+/**
+ * Creates a payment ID payload from a server extension.
+ *
+ * Reads the payment ID from requirements and echoes it back.
+ *
+ * @param extension - Payment ID extension from server's 402 response
+ * @param clientId - Optional client-generated correlation ID
+ * @returns Payment ID payload for inclusion in payment extensions
+ *
+ * @example
+ * ```typescript
+ * const extension = paymentRequirements.extensions?.paymentId;
+ * const payload = createPaymentIdPayload(extension, "my-correlation-id");
+ * // Include in payment payload extensions:
+ * // extensions: { [PAYMENT_ID_EXTENSION_KEY]: payload }
+ * ```
+ */
+declare function createPaymentIdPayload(extension: PaymentIdExtension, clientId?: string): PaymentIdPayload;
+/**
+ * Encodes a payment ID payload for header-based transport.
+ *
+ * @param payload - The payment ID payload to encode
+ * @returns Base64-encoded JSON string
+ */
+declare function encodePaymentIdHeader(payload: PaymentIdPayload): string;
+
+export { type DeclarePaymentIdOptions, PAYMENT_ID_EXTENSION_KEY, type PaymentIdExtension, type PaymentIdExtensionInfo, type PaymentIdPayload, createPaymentIdPayload, declarePaymentIdExtension, encodePaymentIdHeader, parsePaymentIdPayload, validatePaymentId };

package/dist/esm/payment-id/index.mjs

@@ -0,0 +1,17 @@
+import {
+  PAYMENT_ID_EXTENSION_KEY,
+  createPaymentIdPayload,
+  declarePaymentIdExtension,
+  encodePaymentIdHeader,
+  parsePaymentIdPayload,
+  validatePaymentId
+} from "../chunk-S36A7YLQ.mjs";
+export {
+  PAYMENT_ID_EXTENSION_KEY,
+  createPaymentIdPayload,
+  declarePaymentIdExtension,
+  encodePaymentIdHeader,
+  parsePaymentIdPayload,
+  validatePaymentId
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/payment-id/index.mjs.map

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

package/dist/esm/sign-in-with-x/index.d.mts

@@ -201,7 +201,8 @@ declare function validateSIWxMessage(message: SIWxPayload, expectedResourceUri:
 /**
  * Verifies a SIWx signature.
  *
- * Supports EIP-191 personal signatures for EVM chains, Ed25519 for Solana/Stellar,
+ * Supports EIP-191 personal signatures for EVM chains, Ed25519 for Solana/Stellar/TON,
+ * TRON secp256k1 with base58check addresses,
  * and can optionally verify smart wallet signatures via EIP-1271/6492.
  *
  * @param message - The SIWx payload to verify

package/dist/esm/sign-in-with-x/index.mjs

@@ -13,7 +13,7 @@ import {
   validateSIWxMessage,
   verifyEIP6492Signature,
   verifySIWxSignature
-} from "../chunk-J3ZMNCIA.mjs";
+} from "../chunk-YKZ5P2JW.mjs";
 export {
   SIWX_EXTENSION_KEY,
   SIWX_HEADER_NAME,