@pafi-dev/core 0.5.17 → 0.5.19

package/dist/index.d.ts

@@ -1073,6 +1073,14 @@ interface SendWithPaymasterFallbackParams {
     fallbackClient: SmartAccountSender | null | undefined;
     /** Transaction params forwarded verbatim to `sendTransaction`. */
     txParams: Record<string, unknown>;
+    /**
+     * Optional alternate `txParams` used **only on the fallback attempt**.
+     * Lets callers strip operator-fee transfers from the calldata when the
+     * paymaster refuses — there's no point charging a "PAFI gas
+     * reimbursement" fee in PT/USDC if PAFI didn't actually sponsor the
+     * gas. When omitted, the same `txParams` is reused for both attempts.
+     */
+    txParamsFallback?: 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.
@@ -1104,6 +1112,37 @@ interface SendWithPaymasterFallbackParams {
  */
 declare function sendWithPaymasterFallback(params: SendWithPaymasterFallbackParams): Promise<Hex>;
 
+interface QuoteOperatorFeePtConfig {
+    provider: PublicClient;
+    chainId: number;
+    pointTokenAddress: Address;
+    /**
+     * ERC-4337 gas units the UserOp will consume on chain. Default
+     * 500_000n covers the common scenarios (mint, swap, perp deposit
+     * via Relay) with margin. Pass a tighter number when you have a
+     * Pimlico estimate to feed in.
+     */
+    gasUnits?: bigint;
+    /**
+     * Premium applied on top of raw gas cost in basis points. Default
+     * 12_000 (= 1.2×, 20% buffer to cover oracle drift + paymaster
+     * overhead). Same default the issuer SDK's `FeeManager` uses.
+     */
+    premiumBps?: number;
+    /** Chainlink ETH/USD feed override. Defaults to chain's address. */
+    chainlinkFeedAddress?: Address;
+    /** Subgraph URL override. Defaults to `PAFI_SUBGRAPH_URL`. */
+    subgraphUrl?: string;
+    /** USDT token decimals. Default 6 (USDC/USDT on Base/Ethereum). */
+    usdtDecimals?: number;
+    /** Fallback ETH price (USD) when Chainlink is unreachable. Default 3000. */
+    fallbackEthPriceUsd?: number;
+    /** Fallback PT price (USDT per 1 PT) when subgraph is unreachable. Default 0.1. */
+    fallbackPtPriceUsdt?: number;
+    fetchImpl?: typeof fetch;
+}
+declare function quoteOperatorFeePt(config: QuoteOperatorFeePtConfig): Promise<bigint>;
+
 declare const BATCH_EXECUTOR_ADDRESS_BASE_MAINNET: `0x${string}`;
 declare const BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA: `0x${string}`;
 
@@ -1558,4 +1597,4 @@ declare class PafiSDK {
     signLoginMessage(message: string): Promise<Hex>;
 }
 
-export { ApiError, BATCH_EXECUTOR_7702_IMPL, BATCH_EXECUTOR_ABI, BATCH_EXECUTOR_ADDRESS_BASE_MAINNET, BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA, BROKER_HASHES, BestQuote, type BuildDelegationUserOpParams, type BuildPartialUserOpParams, type BuildPerpDepositViaRelayParams, type BuildPerpDepositWithGasDeductionParams, COMMON_POOLS, COMMON_TOKENS, CONTRACT_ADDRESSES, ChainConfig, type CheckEthAndBranchParams, ConfigurationError, type ContractAddresses, DUMMY_SIGNATURE_V07, type DelegateImpl, EIP712Signature, ENTRY_POINT_V07, ENTRY_POINT_V08, LoginMessageParams, MintRequest, type ModalOpenOptions, ORDERLY_RELAY_ABI, ORDERLY_VAULT_ABI, ORDERLY_VAULT_ADDRESSES, ORDERLY_VAULT_BASE_MAINNET, Operation, type OrderlyRelayDepositRequest, PAFI_SUBGRAPH_URL, PERMIT2_ADDRESS, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_POOLS, type PackedUserOperationMessage, type PafiProxyTransportParams, PafiSDK, PafiSDKConfig, PafiSDKError, type PafiWebModalAdapter, type PafiWebModalHandle, PartialUserOperation, type PaymasterConfig, PointTokenDomainConfig, PoolKey, QuoteResult, ReceiverConsent, SIMPLE_7702_IMPL_BASE_MAINNET, SUPPORTED_CHAINS, type SendWithPaymasterFallbackParams, type SignatureStruct, SignatureVerification, SigningError, SimulationError, type SmartAccountSender, type SponsorshipScenario, type SubmissionPath, SwapSimulationResult, TOKEN_HASHES, UNIVERSAL_ROUTER_ADDRESSES, type UserOpTypedData, UserOperation, V4_QUOTER_ADDRESSES, type VaultDepositFE, _resetPaymasterConfigForTests, assembleUserOperation, buildDelegationUserOp, buildPartialUserOperation, buildPerpDepositViaRelay, buildPerpDepositWithGasDeduction, buildUserOpTypedData, burnRequestTypes, checkDelegation, checkEthAndBranch, computeAccountId, computeAuthorizationHash, computeUserOpHash, createPafiProxyTransport, decodeBatchExecuteCalls, detectDelegateImpl, encodeBatchExecute, erc20ApproveOp, erc20BurnOp, erc20TransferOp, fetchPafiPools, getAaNonce, getContractAddresses, getDummySignatureFor7702, getPafiWebModalAdapter, getPaymasterConfig, isDelegatedTo, isDelegatedToTarget, isPaymasterConfigured, isPaymasterError, mintRequestTypes, openPafiWebModal, openWebPopup, parseEip7702DelegatedAddress, rawCallOp, receiverConsentTypes, sendWithPaymasterFallback, serializeUserOpToJsonRpc, setPafiWebModalAdapter, setPaymasterConfig, webPopupAdapter };
+export { ApiError, BATCH_EXECUTOR_7702_IMPL, BATCH_EXECUTOR_ABI, BATCH_EXECUTOR_ADDRESS_BASE_MAINNET, BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA, BROKER_HASHES, BestQuote, type BuildDelegationUserOpParams, type BuildPartialUserOpParams, type BuildPerpDepositViaRelayParams, type BuildPerpDepositWithGasDeductionParams, COMMON_POOLS, COMMON_TOKENS, CONTRACT_ADDRESSES, ChainConfig, type CheckEthAndBranchParams, ConfigurationError, type ContractAddresses, DUMMY_SIGNATURE_V07, type DelegateImpl, EIP712Signature, ENTRY_POINT_V07, ENTRY_POINT_V08, LoginMessageParams, MintRequest, type ModalOpenOptions, ORDERLY_RELAY_ABI, ORDERLY_VAULT_ABI, ORDERLY_VAULT_ADDRESSES, ORDERLY_VAULT_BASE_MAINNET, Operation, type OrderlyRelayDepositRequest, PAFI_SUBGRAPH_URL, PERMIT2_ADDRESS, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_POOLS, type PackedUserOperationMessage, type PafiProxyTransportParams, PafiSDK, PafiSDKConfig, PafiSDKError, type PafiWebModalAdapter, type PafiWebModalHandle, PartialUserOperation, type PaymasterConfig, PointTokenDomainConfig, PoolKey, type QuoteOperatorFeePtConfig, QuoteResult, ReceiverConsent, SIMPLE_7702_IMPL_BASE_MAINNET, SUPPORTED_CHAINS, type SendWithPaymasterFallbackParams, type SignatureStruct, SignatureVerification, SigningError, SimulationError, type SmartAccountSender, type SponsorshipScenario, type SubmissionPath, SwapSimulationResult, TOKEN_HASHES, UNIVERSAL_ROUTER_ADDRESSES, type UserOpTypedData, UserOperation, V4_QUOTER_ADDRESSES, type VaultDepositFE, _resetPaymasterConfigForTests, assembleUserOperation, buildDelegationUserOp, buildPartialUserOperation, buildPerpDepositViaRelay, buildPerpDepositWithGasDeduction, buildUserOpTypedData, burnRequestTypes, checkDelegation, checkEthAndBranch, computeAccountId, computeAuthorizationHash, computeUserOpHash, createPafiProxyTransport, decodeBatchExecuteCalls, detectDelegateImpl, encodeBatchExecute, erc20ApproveOp, erc20BurnOp, erc20TransferOp, fetchPafiPools, getAaNonce, getContractAddresses, getDummySignatureFor7702, getPafiWebModalAdapter, getPaymasterConfig, isDelegatedTo, isDelegatedToTarget, isPaymasterConfigured, isPaymasterError, mintRequestTypes, openPafiWebModal, openWebPopup, parseEip7702DelegatedAddress, quoteOperatorFeePt, rawCallOp, receiverConsentTypes, sendWithPaymasterFallback, serializeUserOpToJsonRpc, setPafiWebModalAdapter, setPaymasterConfig, webPopupAdapter };

package/dist/index.js

@@ -611,19 +611,89 @@ function isPaymasterError(err) {
   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;
+  const { primaryClient, fallbackClient, txParams, txParamsFallback, 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);
+      return await fallbackClient.sendTransaction(txParamsFallback ?? txParams);
     }
     throw err;
   }
 }
 
+// src/fee/operatorFeeQuoter.ts
+import { parseAbi } from "viem";
+
+// src/subgraph/pools.ts
+import { isAddress } from "viem";
+var PAFI_SUBGRAPH_URL = "https://graph-base-mainnet.pacificfinance.org/subgraphs/name/pafi-subgraph-v2";
+var POOL_QUERY = `
+  query GetPoolForPointToken($id: ID!) {
+    pafiToken(id: $id) {
+      id
+      pool {
+        id
+        feeTier
+        tickSpacing
+        hooks
+        token0 { id }
+        token1 { id }
+      }
+    }
+  }
+`;
+function sortCurrencies(a, b) {
+  return a.toLowerCase() < b.toLowerCase() ? [a, b] : [b, a];
+}
+async function fetchPafiPools(_chainId, pointTokenAddress, subgraphUrl = PAFI_SUBGRAPH_URL) {
+  let response;
+  try {
+    response = await fetch(subgraphUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        query: POOL_QUERY,
+        variables: { id: pointTokenAddress.toLowerCase() }
+      })
+    });
+  } catch (err) {
+    console.warn("[fetchPafiPools] subgraph unreachable:", err.message);
+    return [];
+  }
+  if (!response.ok) {
+    console.warn(`[fetchPafiPools] subgraph returned ${response.status}`);
+    return [];
+  }
+  const json = await response.json();
+  if (json.errors && json.errors.length > 0) {
+    console.warn(
+      "[fetchPafiPools] subgraph errors:",
+      json.errors.map((e) => e.message).join("; ")
+    );
+    return [];
+  }
+  const pool = json.data?.pafiToken?.pool;
+  if (!pool) return [];
+  if (!isAddress(pool.hooks) || !isAddress(pool.token0.id) || !isAddress(pool.token1.id) || !Number.isFinite(Number(pool.feeTier)) || !Number.isFinite(Number(pool.tickSpacing))) {
+    console.error("[fetchPafiPools] invalid pool data in subgraph response \u2014 skipping");
+    return [];
+  }
+  const [currency0, currency1] = sortCurrencies(
+    pool.token0.id,
+    pool.token1.id
+  );
+  return [{
+    currency0,
+    currency1,
+    fee: Number(pool.feeTier),
+    tickSpacing: Number(pool.tickSpacing),
+    hooks: pool.hooks
+  }];
+}
+
 // src/contracts/real/addresses.ts
 var PLACEHOLDER_DEAD = (suffix) => `0x000000000000000000000000000000000000${suffix.toLowerCase().padStart(4, "0")}`;
 var CONTRACT_ADDRESSES = {
@@ -679,6 +749,120 @@ function getContractAddresses(chainId) {
   return addrs;
 }
 
+// src/fee/operatorFeeQuoter.ts
+var CHAINLINK_ABI = parseAbi([
+  "function latestRoundData() external view returns (uint80, int256, uint256, uint256, uint80)"
+]);
+var CHAINLINK_MAX_AGE_S = 3600n;
+var POOL_PRICE_QUERY = `
+  query GetPoolPrice($id: ID!) {
+    pafiToken(id: $id) {
+      pool {
+        token0 { id }
+        token1 { id }
+        token0Price
+        token1Price
+      }
+    }
+  }
+`;
+var DEFAULT_GAS_UNITS = 500000n;
+var DEFAULT_PREMIUM_BPS = 12e3;
+var DEFAULT_USDT_DECIMALS = 6;
+async function quoteOperatorFeePt(config) {
+  const {
+    provider,
+    chainId,
+    pointTokenAddress,
+    gasUnits = DEFAULT_GAS_UNITS,
+    premiumBps = DEFAULT_PREMIUM_BPS,
+    subgraphUrl = PAFI_SUBGRAPH_URL,
+    usdtDecimals = DEFAULT_USDT_DECIMALS,
+    fallbackEthPriceUsd = 3e3,
+    fallbackPtPriceUsdt = 0.1,
+    fetchImpl = globalThis.fetch
+  } = config;
+  const chainlinkFeedAddress = config.chainlinkFeedAddress ?? getContractAddresses(chainId).chainlinkEthUsd;
+  const gasPrice = await provider.getGasPrice();
+  const nativeCost = gasPrice * gasUnits;
+  const withPremium = nativeCost * BigInt(premiumBps) / 10000n;
+  const [ethPrice8dec, ptPerUsdt18dec] = await Promise.all([
+    getEthPrice8dec(provider, chainlinkFeedAddress, fallbackEthPriceUsd),
+    getPtPerUsdt18dec(
+      fetchImpl,
+      subgraphUrl,
+      pointTokenAddress,
+      fallbackPtPriceUsdt
+    )
+  ]);
+  return withPremium * ethPrice8dec * ptPerUsdt18dec / 10n ** 26n;
+}
+async function getEthPrice8dec(provider, feed, fallback) {
+  try {
+    const result = await provider.readContract({
+      address: feed,
+      abi: CHAINLINK_ABI,
+      functionName: "latestRoundData"
+    });
+    const answer = result[1];
+    const updatedAt = result[3];
+    if (answer <= 0n) throw new Error("Chainlink: non-positive price");
+    const ageS = BigInt(Math.floor(Date.now() / 1e3)) - updatedAt;
+    if (ageS > CHAINLINK_MAX_AGE_S) {
+      throw new Error(`Chainlink: price stale by ${ageS}s`);
+    }
+    return answer;
+  } catch (err) {
+    console.warn(
+      "[quoteOperatorFeePt] Chainlink unavailable, using fallback:",
+      err.message
+    );
+    return BigInt(Math.round(fallback * 1e8));
+  }
+}
+async function getPtPerUsdt18dec(fetchImpl, subgraphUrl, pointTokenAddress, fallbackPtPriceUsdt) {
+  try {
+    const response = await fetchImpl(subgraphUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        query: POOL_PRICE_QUERY,
+        variables: { id: pointTokenAddress.toLowerCase() }
+      })
+    });
+    if (!response.ok) throw new Error(`subgraph HTTP ${response.status}`);
+    const json = await response.json();
+    if (json.errors?.length) {
+      throw new Error(json.errors.map((e) => e.message).join("; "));
+    }
+    const pool = json.data?.pafiToken?.pool;
+    if (!pool) throw new Error("pafiToken or pool not found");
+    const isPtToken0 = pool.token0.id.toLowerCase() === pointTokenAddress.toLowerCase();
+    const priceStr = isPtToken0 ? pool.token0Price : pool.token1Price;
+    if (!priceStr || Number(priceStr) <= 0) {
+      throw new Error(`invalid pool price from subgraph: ${priceStr}`);
+    }
+    const raw = parseBigDecimalTo18(priceStr);
+    if (raw === 0n) {
+      throw new Error(`pool price parsed to zero: ${priceStr}`);
+    }
+    return 10n ** 24n / raw;
+  } catch (err) {
+    console.warn(
+      "[quoteOperatorFeePt] subgraph unavailable, using fallback:",
+      err.message
+    );
+    const ptPerUsdtHuman = 1 / fallbackPtPriceUsdt;
+    return parseBigDecimalTo18(ptPerUsdtHuman.toFixed(18));
+  }
+}
+function parseBigDecimalTo18(s) {
+  const SCALE = 18;
+  const [whole = "0", frac = ""] = s.split(".");
+  const padded = (frac + "0".repeat(SCALE)).slice(0, SCALE);
+  return BigInt(whole + padded);
+}
+
 // src/contracts/real/batchExecutor.ts
 var BATCH_EXECUTOR_ADDRESS_BASE_MAINNET = getContractAddresses(8453).batchExecutor;
 var BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA = getContractAddresses(84532).batchExecutor;
@@ -804,73 +988,6 @@ async function openPafiWebModal(url, options = {}) {
   );
 }
 
-// src/subgraph/pools.ts
-import { isAddress } from "viem";
-var PAFI_SUBGRAPH_URL = "https://graph-base-mainnet.pacificfinance.org/subgraphs/name/pafi-subgraph-v2";
-var POOL_QUERY = `
-  query GetPoolForPointToken($id: ID!) {
-    pafiToken(id: $id) {
-      id
-      pool {
-        id
-        feeTier
-        tickSpacing
-        hooks
-        token0 { id }
-        token1 { id }
-      }
-    }
-  }
-`;
-function sortCurrencies(a, b) {
-  return a.toLowerCase() < b.toLowerCase() ? [a, b] : [b, a];
-}
-async function fetchPafiPools(_chainId, pointTokenAddress, subgraphUrl = PAFI_SUBGRAPH_URL) {
-  let response;
-  try {
-    response = await fetch(subgraphUrl, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        query: POOL_QUERY,
-        variables: { id: pointTokenAddress.toLowerCase() }
-      })
-    });
-  } catch (err) {
-    console.warn("[fetchPafiPools] subgraph unreachable:", err.message);
-    return [];
-  }
-  if (!response.ok) {
-    console.warn(`[fetchPafiPools] subgraph returned ${response.status}`);
-    return [];
-  }
-  const json = await response.json();
-  if (json.errors && json.errors.length > 0) {
-    console.warn(
-      "[fetchPafiPools] subgraph errors:",
-      json.errors.map((e) => e.message).join("; ")
-    );
-    return [];
-  }
-  const pool = json.data?.pafiToken?.pool;
-  if (!pool) return [];
-  if (!isAddress(pool.hooks) || !isAddress(pool.token0.id) || !isAddress(pool.token1.id) || !Number.isFinite(Number(pool.feeTier)) || !Number.isFinite(Number(pool.tickSpacing))) {
-    console.error("[fetchPafiPools] invalid pool data in subgraph response \u2014 skipping");
-    return [];
-  }
-  const [currency0, currency1] = sortCurrencies(
-    pool.token0.id,
-    pool.token1.id
-  );
-  return [{
-    currency0,
-    currency1,
-    fee: Number(pool.feeTier),
-    tickSpacing: Number(pool.tickSpacing),
-    hooks: pool.hooks
-  }];
-}
-
 // src/index.ts
 var PafiSDK = class {
   _pointTokenAddress;
@@ -1203,6 +1320,7 @@ export {
   quoteBestRoute,
   quoteExactInput,
   quoteExactInputSingle,
+  quoteOperatorFeePt,
   rawCallOp,
   receiverConsentTypes,
   sendWithPaymasterFallback,