@t402/extensions 2.5.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.d.mts

@@ -1,4 +1,7 @@
 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,