@pafi-dev/core 0.4.0 → 0.5.1

package/dist/index.d.ts

@@ -5,8 +5,8 @@ export { erc20Abi, issuerRegistryAbi, mintingOracleAbi, permit2Abi, pointTokenAb
 export { buildBurnRequestTypedData, buildDomain, buildMintRequestTypedData, buildReceiverConsentTypedData, signBurnRequest, signMintRequest, signReceiverConsent, verifyBurnRequest, verifyMintRequest, verifyReceiverConsent } from './eip712/index.js';
 export { getIssuer, getMintRequestNonce, getPointTokenBalance, getPointTokenIssuer, getPointTokenIssuerAddress, getReceiverConsentNonce, getTokenName, isActiveIssuer, isMinter, verifyMintCap } from './contract/index.js';
 export { buildAllPaths, combineRoutes, findBestQuote, quoteBestRoute, quoteExactInput, quoteExactInputSingle } from './quoting/index.js';
-import { P as PartialUserOperation, O as Operation, U as UserOperation, S as SwapSimulationResult } from './index-C1FGQ004.js';
-export { B as BuildSwapWithGasDeductionParams, E as ENTRY_POINT_V07, a as PaymasterFields, b as SETTLE_ALL, c as SWAP_EXACT_IN, T as TAKE_ALL, d as UserOpReceipt, V as V4_SWAP, Z as ZERO_VALUE, e as buildErc20ApprovalCalldata, f as buildPermit2ApprovalCalldata, g as buildSwapFromQuote, h as buildSwapWithGasDeduction, i as buildUniversalRouterExecuteArgs, j as buildV4SwapInput, k as checkAllowance, s as simulateSwap } from './index-C1FGQ004.js';
+import { P as PartialUserOperation, O as Operation, U as UserOperation, S as SwapSimulationResult } from './index-r4xCdQO7.js';
+export { B as BuildSwapWithGasDeductionParams, a as PaymasterFields, b as SETTLE_ALL, c as SWAP_EXACT_IN, T as TAKE_ALL, d as UserOpReceipt, V as V4_SWAP, Z as ZERO_VALUE, e as buildErc20ApprovalCalldata, f as buildPermit2ApprovalCalldata, g as buildSwapFromQuote, h as buildSwapWithGasDeduction, i as buildUniversalRouterExecuteArgs, j as buildV4SwapInput, k as checkAllowance, s as simulateSwap } from './index-r4xCdQO7.js';
 import { LoginMessageParams } from './auth/index.js';
 export { SPONSOR_AUTH_DOMAIN_NAME, SPONSOR_AUTH_TYPES, SponsorAuthPayload, SponsorAuthVerifyResult, VerifyLoginResult, buildSponsorAuthDomain, buildSponsorAuthTypedData, computeCallDataHash, createLoginMessage, parseLoginMessage, signSponsorAuth, verifyLoginMessage, verifySponsorAuth } from './auth/index.js';
 
@@ -67,6 +67,10 @@ declare const UNIVERSAL_ROUTER_ADDRESSES: Record<number, Address>;
 declare const COMMON_TOKENS: Record<number, Record<string, Address>>;
 declare const COMMON_POOLS: Record<number, PoolKey[]>;
 declare const POINT_TOKEN_POOLS: Record<number, Record<Address, PoolKey[]>>;
+/** ERC-4337 v0.7 EntryPoint — deployed deterministically across all EVM chains. */
+declare const ENTRY_POINT_V07: Address;
+/** Permit2 — Uniswap's universal approval contract, same address on all EVM chains. */
+declare const PERMIT2_ADDRESS: Address;
 
 declare class PafiSDKError extends Error {
     constructor(message: string);
@@ -714,6 +718,69 @@ interface PafiProxyTransportParams {
  */
 declare function createPafiProxyTransport(params: PafiProxyTransportParams): HttpTransport;
 
+/**
+ * Minimal interface for any smart-account client capable of submitting
+ * transactions. Deliberately duck-typed so the SDK does not need a hard
+ * dependency on permissionless — any client with this shape works.
+ */
+interface SmartAccountSender {
+    sendTransaction(params: Record<string, unknown>): Promise<Hex>;
+}
+/**
+ * Returns true when `err` originates from the **paymaster layer** rather
+ * than the contract or bundler layer. Covers:
+ *
+ * - ERC-4337 AA3x validation errors (AA31–AA34)
+ * - Pimlico sponsorship rejections (`pm_*` methods, "sponsorship" messages)
+ * - PAFI proxy HTTP errors (401, 403, 429, 503)
+ * - Generic "rate limit" / "unauthorized" strings
+ *
+ * Use this to decide whether retrying without a paymaster makes sense.
+ * Contract reverts (AA23, AA24, AA25) and bundler errors are NOT matched.
+ */
+declare function isPaymasterError(err: unknown): boolean;
+interface SendWithPaymasterFallbackParams {
+    /** Smart-account client with paymaster configured — tried first. */
+    primaryClient: SmartAccountSender;
+    /**
+     * Smart-account client without paymaster — used when `primaryClient`
+     * throws a paymaster error. User pays gas from their ETH balance.
+     * Pass `null` or `undefined` to disable fallback (error re-thrown as-is).
+     */
+    fallbackClient: SmartAccountSender | null | undefined;
+    /** Transaction params forwarded verbatim to `sendTransaction`. */
+    txParams: Record<string, unknown>;
+    /**
+     * Called just before the fallback attempt so the caller can log or
+     * update UI. Receives the error message from the failed primary attempt.
+     */
+    onFallback?: (errorMessage: string) => void;
+}
+/**
+ * Submit a UserOp with paymaster sponsorship, falling back to user-paid gas
+ * if the paymaster refuses.
+ *
+ * Flow:
+ * 1. Call `primaryClient.sendTransaction(txParams)`.
+ * 2. If it throws and `isPaymasterError` returns true, call `onFallback` then
+ *    retry with `fallbackClient` (no paymaster — user pays gas).
+ * 3. All other errors (contract revert, bundler rejection, network) are
+ *    re-thrown immediately without a retry.
+ *
+ * @example
+ * ```ts
+ * import { sendWithPaymasterFallback } from '@pafi-dev/core';
+ *
+ * const txHash = await sendWithPaymasterFallback({
+ *   primaryClient:  smartClientWithPaymaster,
+ *   fallbackClient: smartClientNoPaymaster,
+ *   txParams: { calls, paymasterContext: { sponsorshipPolicyId } },
+ *   onFallback: (msg) => addLog(`Paymaster refused (${msg}) — you will pay gas.`),
+ * });
+ * ```
+ */
+declare function sendWithPaymasterFallback(params: SendWithPaymasterFallbackParams): Promise<Hex>;
+
 /**
  * Real `PointToken` ABI — matches the contract deployed on Base mainnet
  * (POINT at `0x7d25E7156E51F865D522fd3ef257a6B5DD41b97e`). Sourced from
@@ -1052,26 +1119,8 @@ declare const POINT_TOKEN_ABI: readonly [{
     }];
 }];
 
-/**
- * BatchExecutor delegation target addresses.
- *
- * ## Status
- *
- * Base mainnet: points at **Coinbase Smart Wallet v2**
- * (`0x7702cb554e6bFb442cb743A7dF23154544a7176C`). Coinbase publishes
- * this as the canonical EIP-7702 delegation target on Base — every
- * user that wants gas sponsorship via Coinbase Paymaster delegates to
- * this single contract. One contract, all issuers.
- *
- * Base Sepolia: placeholder; Sepolia is not in active use for PAFI.
- *
- * The ABI (`execute(Call[])`) is exported from
- * `../../userop/batchExecute.ts` and works against the Coinbase
- * contract without change — Coinbase Smart Wallet v2 implements the
- * same call-array signature we already use.
- */
-declare const BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA: Address;
-declare const BATCH_EXECUTOR_ADDRESS_BASE_MAINNET: Address;
+declare const BATCH_EXECUTOR_ADDRESS_BASE_MAINNET: `0x${string}`;
+declare const BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA: `0x${string}`;
 
 /**
  * Per-chain deployed contract addresses — v1.4 flow.
@@ -1362,6 +1411,29 @@ declare class PafiSDK {
     private _signer?;
     private _provider?;
     private _chainId?;
+    readonly mint: {
+        buildTypedData: PafiSDK["buildMintRequestTypedData"];
+        sign: PafiSDK["signMintRequest"];
+        verify: PafiSDK["verifyMintRequest"];
+        getNonce: PafiSDK["getMintRequestNonce"];
+    };
+    readonly consent: {
+        buildTypedData: PafiSDK["buildReceiverConsentTypedData"];
+        sign: PafiSDK["signReceiverConsent"];
+        verify: PafiSDK["verifyReceiverConsent"];
+        getNonce: PafiSDK["getReceiverConsentNonce"];
+    };
+    readonly swap: {
+        buildFromQuote: PafiSDK["buildSwapFromQuote"];
+        simulate: PafiSDK["simulateSwap"];
+    };
+    readonly quote: {
+        findBest: PafiSDK["findBestQuote"];
+    };
+    readonly auth: {
+        createLoginMessage: PafiSDK["createLoginMessage"];
+        signMessage: PafiSDK["signLoginMessage"];
+    };
     constructor(config: PafiSDKConfig);
     setPointTokenAddress(address: Address): void;
     setSigner(signer: WalletClient): void;
@@ -1469,4 +1541,4 @@ declare class PafiSDK {
     signLoginMessage(message: string): Promise<Hex>;
 }
 
-export { ApiError, BATCH_EXECUTOR_ABI, BATCH_EXECUTOR_ADDRESS_BASE_MAINNET, BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA, BROKER_HASHES, BestQuote, type BuildDelegationUserOpParams, type BuildPartialUserOpParams, type BuildPerpDepositWithGasDeductionParams, COMMON_POOLS, COMMON_TOKENS, CONTRACT_ADDRESSES, ChainConfig, type CheckEthAndBranchParams, ConfigurationError, type ContractAddresses, EIP712Signature, LoginMessageParams, MintRequest, type ModalOpenOptions, ORDERLY_VAULT_ABI, ORDERLY_VAULT_ADDRESSES, ORDERLY_VAULT_BASE_MAINNET, Operation, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_POOLS, POINT_TOKEN_ABI as POINT_TOKEN_V2_ABI, type PafiProxyTransportParams, PafiSDK, PafiSDKConfig, PafiSDKError, type PafiWebModalAdapter, type PafiWebModalHandle, PartialUserOperation, type PaymasterConfig, PointTokenDomainConfig, PoolKey, QuoteResult, ReceiverConsent, SUPPORTED_CHAINS, type SignatureStruct, SignatureVerification, SigningError, SimulationError, type SponsorshipScenario, type SubmissionPath, SwapSimulationResult, TOKEN_HASHES, UNIVERSAL_ROUTER_ADDRESSES, UserOperation, V4_QUOTER_ADDRESSES, type VaultDepositFE, _resetPaymasterConfigForTests, assembleUserOperation, buildDelegationUserOp, buildPartialUserOperation, buildPerpDepositWithGasDeduction, burnRequestTypes, checkDelegation, checkEthAndBranch, computeAccountId, createPafiProxyTransport, encodeBatchExecute, erc20ApproveOp, erc20BurnOp, erc20TransferOp, getAaNonce, getContractAddresses, getPafiWebModalAdapter, getPaymasterConfig, isDelegatedTo, isPaymasterConfigured, mintRequestTypes, openPafiWebModal, openWebPopup, parseEip7702DelegatedAddress, rawCallOp, receiverConsentTypes, setPafiWebModalAdapter, setPaymasterConfig, webPopupAdapter };
+export { ApiError, BATCH_EXECUTOR_ABI, BATCH_EXECUTOR_ADDRESS_BASE_MAINNET, BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA, BROKER_HASHES, BestQuote, type BuildDelegationUserOpParams, type BuildPartialUserOpParams, type BuildPerpDepositWithGasDeductionParams, COMMON_POOLS, COMMON_TOKENS, CONTRACT_ADDRESSES, ChainConfig, type CheckEthAndBranchParams, ConfigurationError, type ContractAddresses, EIP712Signature, ENTRY_POINT_V07, LoginMessageParams, MintRequest, type ModalOpenOptions, ORDERLY_VAULT_ABI, ORDERLY_VAULT_ADDRESSES, ORDERLY_VAULT_BASE_MAINNET, Operation, PERMIT2_ADDRESS, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_POOLS, POINT_TOKEN_ABI as POINT_TOKEN_V2_ABI, type PafiProxyTransportParams, PafiSDK, PafiSDKConfig, PafiSDKError, type PafiWebModalAdapter, type PafiWebModalHandle, PartialUserOperation, type PaymasterConfig, PointTokenDomainConfig, PoolKey, QuoteResult, ReceiverConsent, SUPPORTED_CHAINS, type SendWithPaymasterFallbackParams, type SignatureStruct, SignatureVerification, SigningError, SimulationError, type SmartAccountSender, type SponsorshipScenario, type SubmissionPath, SwapSimulationResult, TOKEN_HASHES, UNIVERSAL_ROUTER_ADDRESSES, UserOperation, V4_QUOTER_ADDRESSES, type VaultDepositFE, _resetPaymasterConfigForTests, assembleUserOperation, buildDelegationUserOp, buildPartialUserOperation, buildPerpDepositWithGasDeduction, burnRequestTypes, checkDelegation, checkEthAndBranch, computeAccountId, createPafiProxyTransport, encodeBatchExecute, erc20ApproveOp, erc20BurnOp, erc20TransferOp, getAaNonce, getContractAddresses, getPafiWebModalAdapter, getPaymasterConfig, isDelegatedTo, isPaymasterConfigured, isPaymasterError, mintRequestTypes, openPafiWebModal, openWebPopup, parseEip7702DelegatedAddress, rawCallOp, receiverConsentTypes, sendWithPaymasterFallback, setPafiWebModalAdapter, setPaymasterConfig, webPopupAdapter };

package/dist/index.js

@@ -41,7 +41,7 @@ import {
   verifyBurnRequest,
   verifyMintRequest,
   verifyReceiverConsent
-} from "./chunk-DUY7Z2AI.js";
+} from "./chunk-WTWG6QXP.js";
 import {
   buildAllPaths,
   combineRoutes,
@@ -49,21 +49,10 @@ import {
   quoteBestRoute,
   quoteExactInput,
   quoteExactInputSingle
-} from "./chunk-I2P3TIP7.js";
+} from "./chunk-N5M3BLOV.js";
 import {
   v4QuoterAbi
 } from "./chunk-KFWZRL7I.js";
-import {
-  COMMON_POOLS,
-  COMMON_TOKENS,
-  POINT_TOKEN_POOLS,
-  SUPPORTED_CHAINS,
-  UNIVERSAL_ROUTER_ADDRESSES,
-  V4_QUOTER_ADDRESSES,
-  burnRequestTypes,
-  mintRequestTypes,
-  receiverConsentTypes
-} from "./chunk-73CQTNLB.js";
 import {
   ApiError,
   BATCH_EXECUTOR_ABI,
@@ -90,12 +79,25 @@ import {
   erc20TransferOp,
   rawCallOp,
   simulateSwap
-} from "./chunk-543IPI6E.js";
+} from "./chunk-T6Y32SNK.js";
 import {
   erc20Abi,
   permit2Abi,
   universalRouterAbi
 } from "./chunk-2PIXFXA2.js";
+import {
+  COMMON_POOLS,
+  COMMON_TOKENS,
+  ENTRY_POINT_V07,
+  PERMIT2_ADDRESS,
+  POINT_TOKEN_POOLS,
+  SUPPORTED_CHAINS,
+  UNIVERSAL_ROUTER_ADDRESSES,
+  V4_QUOTER_ADDRESSES,
+  burnRequestTypes,
+  mintRequestTypes,
+  receiverConsentTypes
+} from "./chunk-S5CCEO4O.js";
 
 // src/index.ts
 import { createPublicClient, http as http2 } from "viem";
@@ -241,7 +243,6 @@ function buildPerpDepositWithGasDeduction(params) {
 }
 
 // src/userop/types.ts
-var ENTRY_POINT_V07 = "0x0000000071727De22E5E9d8BAf0edAc6f37da032";
 var ZERO_VALUE = 0n;
 
 // src/paymaster/config.ts
@@ -333,7 +334,6 @@ function buildDelegationUserOp(params) {
   });
 }
 async function getAaNonce(client, userAddress) {
-  const ENTRY_POINT = "0x0000000071727De22E5E9d8BAf0edAc6f37da032";
   const NONCE_ABI = [
     {
       inputs: [
@@ -347,7 +347,7 @@ async function getAaNonce(client, userAddress) {
     }
   ];
   return client.readContract({
-    address: ENTRY_POINT,
+    address: ENTRY_POINT_V07,
     abi: NONCE_ABI,
     functionName: "getNonce",
     args: [userAddress, 0n]
@@ -374,6 +374,25 @@ function createPafiProxyTransport(params) {
   });
 }
 
+// src/transport/paymasterFallback.ts
+function isPaymasterError(err) {
+  const msg = (err?.message ?? String(err)).toLowerCase();
+  return msg.includes("paymaster") || msg.includes("sponsorship") || msg.includes("aa31") || msg.includes("aa32") || msg.includes("aa33") || msg.includes("aa34") || msg.includes("pm_") || msg.includes("rate limit") || msg.includes("unauthorized") || msg.includes("403") || msg.includes("429") || msg.includes("503");
+}
+async function sendWithPaymasterFallback(params) {
+  const { primaryClient, fallbackClient, txParams, onFallback } = params;
+  try {
+    return await primaryClient.sendTransaction(txParams);
+  } catch (err) {
+    if (isPaymasterError(err) && fallbackClient) {
+      const msg = err?.message ?? String(err);
+      onFallback?.(msg);
+      return await fallbackClient.sendTransaction(txParams);
+    }
+    throw err;
+  }
+}
+
 // src/contracts/real/pointToken.ts
 import { parseAbi } from "viem";
 var POINT_TOKEN_ABI = parseAbi([
@@ -419,10 +438,6 @@ var POINT_TOKEN_ABI = parseAbi([
   "event MintingOracleUpdated(address indexed mintingOracle)"
 ]);
 
-// src/contracts/real/batchExecutor.ts
-var BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA = "0x000000000000000000000000000000000000DE01";
-var BATCH_EXECUTOR_ADDRESS_BASE_MAINNET = "0x7702cb554e6bFb442cb743A7dF23154544a7176C";
-
 // src/contracts/real/addresses.ts
 var PLACEHOLDER_DEAD = (suffix) => `0x000000000000000000000000000000000000${suffix.toLowerCase().padStart(4, "0")}`;
 var CONTRACT_ADDRESSES = {
@@ -472,6 +487,10 @@ function getContractAddresses(chainId) {
   return addrs;
 }
 
+// src/contracts/real/batchExecutor.ts
+var BATCH_EXECUTOR_ADDRESS_BASE_MAINNET = getContractAddresses(8453).batchExecutor;
+var BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA = getContractAddresses(84532).batchExecutor;
+
 // src/web-handoff/webPopup.ts
 var DEFAULT_WIDTH = 900;
 var DEFAULT_HEIGHT = 700;
@@ -599,6 +618,16 @@ var PafiSDK = class {
   _signer;
   _provider;
   _chainId;
+  // -------------------------------------------------------------------------
+  // Domain namespaces — grouped by concern for better IDE autocomplete.
+  // Each property is a plain object of bound methods; the underlying logic
+  // lives in the flat methods below so both access styles work.
+  // -------------------------------------------------------------------------
+  mint;
+  consent;
+  swap;
+  quote;
+  auth;
   constructor(config) {
     this._pointTokenAddress = config.pointTokenAddress;
     this._signer = config.signer;
@@ -610,6 +639,29 @@ var PafiSDK = class {
         transport: http2(config.rpcUrl)
       });
     }
+    this.mint = {
+      buildTypedData: this.buildMintRequestTypedData.bind(this),
+      sign: this.signMintRequest.bind(this),
+      verify: this.verifyMintRequest.bind(this),
+      getNonce: this.getMintRequestNonce.bind(this)
+    };
+    this.consent = {
+      buildTypedData: this.buildReceiverConsentTypedData.bind(this),
+      sign: this.signReceiverConsent.bind(this),
+      verify: this.verifyReceiverConsent.bind(this),
+      getNonce: this.getReceiverConsentNonce.bind(this)
+    };
+    this.swap = {
+      buildFromQuote: this.buildSwapFromQuote.bind(this),
+      simulate: this.simulateSwap.bind(this)
+    };
+    this.quote = {
+      findBest: this.findBestQuote.bind(this)
+    };
+    this.auth = {
+      createLoginMessage: this.createLoginMessage.bind(this),
+      signMessage: this.signLoginMessage.bind(this)
+    };
   }
   // -------------------------------------------------------------------------
   // Setters
@@ -793,6 +845,7 @@ export {
   ORDERLY_VAULT_ABI,
   ORDERLY_VAULT_ADDRESSES,
   ORDERLY_VAULT_BASE_MAINNET,
+  PERMIT2_ADDRESS,
   POINT_TOKEN_FACTORY_ADDRESSES,
   POINT_TOKEN_IMPL_ADDRESSES,
   POINT_TOKEN_POOLS,
@@ -860,6 +913,7 @@ export {
   isDelegatedTo,
   isMinter,
   isPaymasterConfigured,
+  isPaymasterError,
   issuerRegistryAbi,
   mintRequestTypes,
   mintingOracleAbi,
@@ -875,6 +929,7 @@ export {
   quoteExactInputSingle,
   rawCallOp,
   receiverConsentTypes,
+  sendWithPaymasterFallback,
   setPafiWebModalAdapter,
   setPaymasterConfig,
   signBurnRequest,