@x402/extensions 2.6.0 → 2.7.0

package/dist/cjs/index.d.ts

@@ -1,9 +1,12 @@
 export { k as BAZAAR, A as BazaarClientExtension, c as BodyDiscoveryExtension, B as BodyDiscoveryInfo, g as DeclareBodyDiscoveryExtensionConfig, i as DeclareDiscoveryExtensionConfig, j as DeclareDiscoveryExtensionInput, h as DeclareMcpDiscoveryExtensionConfig, f as DeclareQueryDiscoveryExtensionConfig, s as DiscoveredHTTPResource, t as DiscoveredMCPResource, u as DiscoveredResource, e as DiscoveryExtension, D as DiscoveryInfo, C as DiscoveryResource, E as DiscoveryResourcesResponse, L as ListDiscoveryResourcesParams, d as McpDiscoveryExtension, M as McpDiscoveryInfo, a as QueryDiscoveryExtension, Q as QueryDiscoveryInfo, V as ValidationResult, W as WithExtensions, b as bazaarResourceServerExtension, o as declareDiscoveryExtension, p as extractDiscoveryInfo, q as extractDiscoveryInfoFromExtension, w as extractDiscoveryInfoV1, y as extractResourceMetadataV1, n as isBodyExtensionConfig, x as isDiscoverableV1, l as isMcpExtensionConfig, m as isQueryExtensionConfig, r as validateAndExtract, v as validateDiscoveryExtension, z as withBazaar } from './index-CtOzXcjN.js';
 export { CompleteSIWxInfo, CreateSIWxHookOptions, DeclareSIWxOptions, EVMMessageVerifier, EVMSigner, InMemorySIWxStorage, SIGN_IN_WITH_X, SIWxExtension, SIWxExtensionInfo, SIWxExtensionSchema, SIWxHookEvent, SIWxPayload, SIWxPayloadSchema, SIWxSigner, SIWxStorage, SIWxValidationOptions, SIWxValidationResult, SIWxVerifyOptions, SIWxVerifyResult, SOLANA_DEVNET, SOLANA_MAINNET, SOLANA_TESTNET, SignatureScheme, SignatureType, SolanaSigner, SupportedChain, buildSIWxSchema, createSIWxClientHook, createSIWxMessage, createSIWxPayload, createSIWxRequestHook, createSIWxSettleHook, declareSIWxExtension, decodeBase58, encodeBase58, encodeSIWxHeader, extractEVMChainId, extractSolanaChainReference, formatSIWEMessage, formatSIWSMessage, getEVMAddress, getSolanaAddress, isEVMSigner, isSolanaSigner, parseSIWxHeader, signEVMMessage, signSolanaMessage, siwxResourceServerExtension, validateSIWxMessage, verifyEVMSignature, verifySIWxSignature, verifySolanaSignature, wrapFetchWithSIWx } from './sign-in-with-x/index.js';
+export { DecodedOffer, EIP712SignedOffer, EIP712SignedReceipt, EIP712Signer, EIP712VerificationResult, JWSSignedOffer, JWSSignedReceipt, JWSSigner, OFFER_RECEIPT, OFFER_TYPES, OfferInput, OfferPayload, OfferReceiptDeclaration, OfferReceiptIssuer, RECEIPT_TYPES, ReceiptInput, ReceiptPayload, SignTypedDataFn, SignatureFormat, SignedOffer, SignedReceipt, Signer, canonicalize, convertNetworkStringToCAIP2, createEIP712OfferReceiptIssuer, createJWS, createJWSOfferReceiptIssuer, createOfferDomain, createOfferEIP712, createOfferJWS, createOfferReceiptExtension, createReceiptDomain, createReceiptEIP712, createReceiptJWS, declareOfferReceiptExtension, decodeSignedOffers, extractChainIdFromCAIP2, extractEIP155ChainId, extractJWSHeader, extractJWSPayload, extractOfferPayload, extractOffersFromPaymentRequired, extractPublicKeyFromKid, extractReceiptFromResponse, extractReceiptPayload, findAcceptsObjectFromSignedOffer, getCanonicalBytes, hashCanonical, hashOfferTypedData, hashReceiptTypedData, isEIP712SignedOffer, isEIP712SignedReceipt, isEIP712Signer, isJWSSignedOffer, isJWSSignedReceipt, isJWSSigner, prepareOfferForEIP712, prepareReceiptForEIP712, signOfferEIP712, signReceiptEIP712, verifyOfferSignatureEIP712, verifyOfferSignatureJWS, verifyReceiptMatchesOffer, verifyReceiptSignatureEIP712, verifyReceiptSignatureJWS } from './offer-receipt/index.js';
 export { PAYMENT_IDENTIFIER, PAYMENT_ID_MAX_LENGTH, PAYMENT_ID_MIN_LENGTH, PAYMENT_ID_PATTERN, PaymentIdentifierExtension, PaymentIdentifierInfo, PaymentIdentifierSchema, PaymentIdentifierValidationResult, appendPaymentIdentifierToExtensions, declarePaymentIdentifierExtension, extractAndValidatePaymentIdentifier, extractPaymentIdentifier, generatePaymentId, hasPaymentIdentifier, isPaymentIdentifierExtension, isPaymentIdentifierRequired, isValidPaymentId, paymentIdentifierResourceServerExtension, paymentIdentifierSchema, validatePaymentIdentifier, validatePaymentIdentifierRequirement } from './payment-identifier/index.js';
 import { FacilitatorExtension, PaymentPayload } from '@x402/core/types';
 import '@x402/core/http';
 import 'zod';
+import 'jose';
+import 'viem';
 
 /**
  * Type definitions for the EIP-2612 Gas Sponsoring Extension
@@ -140,13 +143,23 @@ declare function validateEip2612GasSponsoringInfo(info: Eip2612GasSponsoringInfo
  * it atomically before settling the Permit2 payment.
  */
 
+/**
+ * A single transaction to be executed by the signer.
+ * - `0x${string}`: a pre-signed serialized transaction (broadcast as-is via sendRawTransaction)
+ * - `{ to, data, gas? }`: an unsigned call intent (signer signs and broadcasts)
+ */
+type TransactionRequest = `0x${string}` | {
+    to: `0x${string}`;
+    data: `0x${string}`;
+    gas?: bigint;
+};
 /**
  * Signer capability carried by the ERC-20 approval extension when registered in a facilitator.
  *
- * Mirrors FacilitatorEvmSigner (from @x402/evm) plus `sendRawTransaction`.
- * The extension signer owns the full approve+settle flow: it broadcasts the
- * pre-signed approval transaction AND executes the Permit2 settle call, enabling
- * production implementations to bundle both atomically (e.g., Flashbots, multicall).
+ * Mirrors FacilitatorEvmSigner (from @x402/evm) plus `sendTransactions`.
+ * The signer owns execution of multiple transactions, enabling production implementations
+ * to bundle them atomically (e.g., Flashbots, multicall, smart account batching)
+ * while simpler implementations can execute them sequentially.
  *
  * The method signatures are duplicated here (rather than extending FacilitatorEvmSigner)
  * to avoid a circular dependency between @x402/extensions and @x402/evm.
@@ -172,6 +185,7 @@ interface Erc20ApprovalGasSponsoringSigner {
         abi: readonly unknown[];
         functionName: string;
         args: readonly unknown[];
+        gas?: bigint;
     }): Promise<`0x${string}`>;
     sendTransaction(args: {
         to: `0x${string}`;
@@ -185,9 +199,7 @@ interface Erc20ApprovalGasSponsoringSigner {
     getCode(args: {
         address: `0x${string}`;
     }): Promise<`0x${string}` | undefined>;
-    sendRawTransaction(args: {
-        serializedTransaction: `0x${string}`;
-    }): Promise<`0x${string}`>;
+    sendTransactions(transactions: TransactionRequest[]): Promise<`0x${string}`[]>;
 }
 /**
  * Extension identifier for the ERC-20 approval gas sponsoring extension.
@@ -200,41 +212,39 @@ declare const ERC20_APPROVAL_GAS_SPONSORING_VERSION = "1";
 /**
  * Extended extension object registered in a facilitator via registerExtension().
  * Carries the signer that owns the full approve+settle flow for ERC-20 tokens
- * that lack EIP-2612. The signer must have all FacilitatorEvmSigner capabilities
- * plus `sendRawTransaction` for broadcasting the pre-signed approval tx.
+ * that lack EIP-2612.
  *
  * @example
  * ```typescript
  * import { createErc20ApprovalGasSponsoringExtension } from '@x402/extensions';
  *
  * facilitator.registerExtension(
- *   createErc20ApprovalGasSponsoringExtension(evmSigner, viemClient),
+ *   createErc20ApprovalGasSponsoringExtension(signer),
  * );
  * ```
  */
 interface Erc20ApprovalGasSponsoringFacilitatorExtension extends FacilitatorExtension {
     key: "erc20ApprovalGasSponsoring";
-    /** Signer with broadcast + settle capability. Optional — settlement fails gracefully if absent. */
+    /** Default signer with approve+settle capability. Optional — settlement fails gracefully if absent. */
     signer?: Erc20ApprovalGasSponsoringSigner;
+    /** Network-specific signer resolver. Takes precedence over `signer` when provided. */
+    signerForNetwork?: (network: string) => Erc20ApprovalGasSponsoringSigner | undefined;
 }
 /**
- * Signer input for {@link createErc20ApprovalGasSponsoringExtension}.
+ * Base signer shape without `sendTransactions`.
  * Matches the FacilitatorEvmSigner shape from @x402/evm (duplicated to avoid circular dep).
  */
-type Erc20ApprovalGasSponsoringBaseSigner = Omit<Erc20ApprovalGasSponsoringSigner, "sendRawTransaction">;
+type Erc20ApprovalGasSponsoringBaseSigner = Omit<Erc20ApprovalGasSponsoringSigner, "sendTransactions">;
 /**
  * Create an ERC-20 approval gas sponsoring extension ready to register in a facilitator.
  *
- * @param signer - The EVM facilitator signer (e.g. from `toFacilitatorEvmSigner()`)
- * @param client - Object providing `sendRawTransaction` (e.g. a viem WalletClient)
- * @param client.sendRawTransaction - Broadcasts a signed transaction to the network
+ * @param signer - A complete signer with `sendTransactions` already implemented.
+ *   The signer decides how to execute the transactions (sequentially, batched, or atomically).
+ * @param signerForNetwork - Optional network-specific signer resolver. When provided,
+ *   takes precedence over `signer` and allows different settlement signers per network.
  * @returns A fully configured extension to pass to `facilitator.registerExtension()`
  */
-declare function createErc20ApprovalGasSponsoringExtension(signer: Erc20ApprovalGasSponsoringBaseSigner, client: {
-    sendRawTransaction: (args: {
-        serializedTransaction: `0x${string}`;
-    }) => Promise<`0x${string}`>;
-}): Erc20ApprovalGasSponsoringFacilitatorExtension;
+declare function createErc20ApprovalGasSponsoringExtension(signer: Erc20ApprovalGasSponsoringSigner, signerForNetwork?: (network: string) => Erc20ApprovalGasSponsoringSigner | undefined): Erc20ApprovalGasSponsoringFacilitatorExtension;
 /**
  * ERC-20 approval gas sponsoring info populated by the client.
  *
@@ -357,4 +367,4 @@ declare function extractErc20ApprovalGasSponsoringInfo(paymentPayload: PaymentPa
  */
 declare function validateErc20ApprovalGasSponsoringInfo(info: Erc20ApprovalGasSponsoringInfo): boolean;
 
-export { EIP2612_GAS_SPONSORING, ERC20_APPROVAL_GAS_SPONSORING, ERC20_APPROVAL_GAS_SPONSORING_VERSION, type Eip2612GasSponsoringExtension, type Eip2612GasSponsoringInfo, type Eip2612GasSponsoringServerInfo, type Erc20ApprovalGasSponsoringBaseSigner, type Erc20ApprovalGasSponsoringExtension, type Erc20ApprovalGasSponsoringFacilitatorExtension, type Erc20ApprovalGasSponsoringInfo, type Erc20ApprovalGasSponsoringServerInfo, type Erc20ApprovalGasSponsoringSigner, createErc20ApprovalGasSponsoringExtension, declareEip2612GasSponsoringExtension, declareErc20ApprovalGasSponsoringExtension, erc20ApprovalGasSponsoringSchema, extractEip2612GasSponsoringInfo, extractErc20ApprovalGasSponsoringInfo, validateEip2612GasSponsoringInfo, validateErc20ApprovalGasSponsoringInfo };
+export { EIP2612_GAS_SPONSORING, ERC20_APPROVAL_GAS_SPONSORING, ERC20_APPROVAL_GAS_SPONSORING_VERSION, type Eip2612GasSponsoringExtension, type Eip2612GasSponsoringInfo, type Eip2612GasSponsoringServerInfo, type Erc20ApprovalGasSponsoringBaseSigner, type Erc20ApprovalGasSponsoringExtension, type Erc20ApprovalGasSponsoringFacilitatorExtension, type Erc20ApprovalGasSponsoringInfo, type Erc20ApprovalGasSponsoringServerInfo, type Erc20ApprovalGasSponsoringSigner, type TransactionRequest, createErc20ApprovalGasSponsoringExtension, declareEip2612GasSponsoringExtension, declareErc20ApprovalGasSponsoringExtension, erc20ApprovalGasSponsoringSchema, extractEip2612GasSponsoringInfo, extractErc20ApprovalGasSponsoringInfo, validateEip2612GasSponsoringInfo, validateErc20ApprovalGasSponsoringInfo };