@pafi-dev/issuer 0.18.0 → 0.20.0

package/dist/index.cjs

@@ -30,7 +30,6 @@ __export(index_exports, {
   DEFAULT_REDEMPTION_POLICY: () => DEFAULT_REDEMPTION_POLICY,
   DefaultPolicyEngine: () => DefaultPolicyEngine,
   FeeManager: () => FeeManager,
-  GasUnitsCache: () => GasUnitsCache,
   InMemoryCursorStore: () => InMemoryCursorStore,
   IssuerApiAdapter: () => IssuerApiAdapter,
   IssuerApiHandlers: () => IssuerApiHandlers,
@@ -51,6 +50,7 @@ __export(index_exports, {
   PTRedeemHandler: () => PTRedeemHandler,
   PafiBackendClient: () => PafiBackendClient,
   PafiBackendError: () => PafiBackendError,
+  PafiEstimatorHttpError: () => PafiEstimatorHttpError,
   PafiSdkError: () => import_core.PafiSdkError,
   PendingUserOpForbiddenError: () => PendingUserOpForbiddenError,
   PendingUserOpNotFoundError: () => PendingUserOpNotFoundError,
@@ -71,6 +71,7 @@ __export(index_exports, {
   buildSdkErrorBody: () => buildSdkErrorBody,
   createIssuerService: () => createIssuerService,
   createNativePtQuoter: () => createNativePtQuoter,
+  createPafiEstimatorClient: () => createPafiEstimatorClient,
   createSdkErrorMapper: () => createSdkErrorMapper,
   createSubgraphNativeUsdtQuoter: () => createSubgraphNativeUsdtQuoter,
   createSubgraphPoolsProvider: () => createSubgraphPoolsProvider,
@@ -1097,21 +1098,21 @@ var RelayService = class {
   // =========================================================================
   // Preview methods — produce bundler-ready partial UserOps WITHOUT signing.
   //
-  // These exist so callers can compute an accurate gas estimate via
-  // `bundlerClient.estimateUserOperationGas(...)` BEFORE committing to a
-  // signed MintRequest / BurnRequest (signing is HSM-backed and expensive
-  // in prod). The returned `callData` matches the SHAPE of the real call;
-  // the EIP-712 signature bytes are placeholder. Bundler simulation
-  // doesn't validate the signature, so the gas units come back accurate.
+  // These exist so callers can fetch an accurate gas estimate from PAFI's
+  // `/v1/estimate-gas-fee` BEFORE committing to a signed MintRequest /
+  // BurnRequest (HSM/KMS signing is expensive in production). The
+  // returned `callData` matches the SHAPE of the real call; the EIP-712
+  // signature bytes are a placeholder. Bundler simulation doesn't
+  // validate the signature, so the gas estimate comes back accurate.
   //
-  // Cache-wise: same SC version + same scenario → same calldata shape →
-  // same bundler-returned gas units. The first call seeds the cache; the
-  // rest hit it.
+  // Cache-wise: same SC version + same scenario produce identical
+  // calldata shape → identical bundler-returned gas units. The first
+  // call seeds the cache; subsequent ones hit it.
   // =========================================================================
   /**
    * Build a dummy `PartialUserOperation` for the mint scenario, suitable
    * for `feeManager.estimateGasFee({ partialUserOp, ... })`. NO signing —
-   * uses a 65-byte zero signature in place of the real minter sig.
+   * uses a 65-byte zero signature placeholder.
    */
   previewMintUserOp(params) {
     const useWrapper = params.mintFeeWrapperAddress !== void 0;
@@ -1148,7 +1149,11 @@ var RelayService = class {
       nonce: params.aaNonce,
       operations: [{ target: mintTarget, value: 0n, data: mintCallData }],
       // Gas limits ignored by bundler estimate — it computes them.
-      gasLimits: { callGasLimit: 1n, verificationGasLimit: 1n, preVerificationGas: 1n }
+      gasLimits: {
+        callGasLimit: 1n,
+        verificationGasLimit: 1n,
+        preVerificationGas: 1n
+      }
     });
   }
   /** Burn-side mirror of `previewMintUserOp`. */
@@ -1169,7 +1174,11 @@ var RelayService = class {
       operations: [
         { target: params.pointTokenAddress, value: 0n, data: burnCallData }
       ],
-      gasLimits: { callGasLimit: 1n, verificationGasLimit: 1n, preVerificationGas: 1n }
+      gasLimits: {
+        callGasLimit: 1n,
+        verificationGasLimit: 1n,
+        preVerificationGas: 1n
+      }
     });
   }
 };
@@ -1178,85 +1187,21 @@ function errorMessage(err) {
   return err instanceof Error ? err.message : String(err);
 }
 
-// src/relay/gasUnitsCache.ts
-var import_viem4 = require("viem");
-var DEFAULT_TTL_MS = 5 * 6e4;
-var DEFAULT_CODEHASH_TTL_MS = 60 * 6e4;
-var DEFAULT_MAX_ENTRIES = 100;
-var GasUnitsCache = class {
-  entries = /* @__PURE__ */ new Map();
-  codehashEntries = /* @__PURE__ */ new Map();
-  ttlMs;
-  codehashTtlMs;
-  maxEntries;
-  constructor(config = {}) {
-    this.ttlMs = config.ttlMs ?? DEFAULT_TTL_MS;
-    this.codehashTtlMs = config.codehashTtlMs ?? DEFAULT_CODEHASH_TTL_MS;
-    this.maxEntries = config.maxEntries ?? DEFAULT_MAX_ENTRIES;
-  }
-  async buildKey(params) {
-    const codehash = await this.getCodehash(
-      params.provider,
-      params.contractAddress
-    );
-    const pm = params.paymasterAddress?.toLowerCase() ?? "0x0";
-    return `${params.scenario}:${codehash}:${pm}`;
-  }
-  get(key, now = Date.now()) {
-    const entry = this.entries.get(key);
-    if (!entry) return null;
-    if (entry.expiresAt <= now) {
-      this.entries.delete(key);
-      return null;
-    }
-    return entry.gasUnits;
-  }
-  set(key, gasUnits, now = Date.now()) {
-    if (this.entries.size >= this.maxEntries && !this.entries.has(key)) {
-      const eldest = this.entries.keys().next().value;
-      if (eldest !== void 0) this.entries.delete(eldest);
-    }
-    this.entries.set(key, { gasUnits, expiresAt: now + this.ttlMs });
-  }
-  invalidate() {
-    this.entries.clear();
-    this.codehashEntries.clear();
-  }
-  size() {
-    return this.entries.size;
-  }
-  async getCodehash(provider, address) {
-    const lower = address.toLowerCase();
-    const now = Date.now();
-    const cached = this.codehashEntries.get(lower);
-    if (cached && cached.expiresAt > now) return cached.codehash;
-    const code = await provider.getCode({ address });
-    const codehash = code ? (0, import_viem4.keccak256)(code) : "0x0";
-    this.codehashEntries.set(lower, {
-      codehash,
-      expiresAt: now + this.codehashTtlMs
-    });
-    return codehash;
-  }
-};
-
 // src/relay/feeManager.ts
 var DEFAULT_GAS_UNITS = 500000n;
 var DEFAULT_PREMIUM_BPS = 1e4;
-var DEFAULT_PAYMASTER_OVERHEAD = 80000n;
-var DUMMY_SIGNATURE = "0xfffffffffffffffffffffffffffffff0000000000000000000000000000000007aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa1c";
 var FeeManager = class _FeeManager {
   provider;
-  gasUnits;
+  fallbackGasUnits;
   gasPremiumBps;
   quoteNativeToFee;
   bundlerClient;
-  cache;
-  paymasterOverheadGas;
   metrics;
-  // Short-lived in-flight fee cache (legacy behavior). Distinct from
-  // `cache` — that one stores gasUnits per scenario; this one stores the
-  // FULL computed fee value, valid for 10s to absorb burst calls.
+  // Short-lived fee-value cache. Distinct from the estimator's cache:
+  // this absorbs burst calls (e.g. 5 user requests in 5s all hit the
+  // /gas-fee endpoint) by remembering the COMPUTED PT amount, not the
+  // gas units. Only used by the no-opts legacy path; estimator path
+  // gets its caching from the PAFI side instead.
   cachedFee = null;
   cacheExpiresAt = 0;
   static FEE_CACHE_TTL_MS = 1e4;
@@ -1265,29 +1210,26 @@ var FeeManager = class _FeeManager {
     if (!config.quoteNativeToFee)
       throw new Error("FeeManager: quoteNativeToFee required");
     this.provider = config.provider;
-    this.gasUnits = config.gasUnits ?? DEFAULT_GAS_UNITS;
+    this.fallbackGasUnits = config.gasUnits ?? DEFAULT_GAS_UNITS;
     this.gasPremiumBps = config.gasPremiumBps ?? DEFAULT_PREMIUM_BPS;
     this.quoteNativeToFee = config.quoteNativeToFee;
     this.bundlerClient = config.bundlerClient;
-    this.cache = new GasUnitsCache(config.cache);
-    this.paymasterOverheadGas = config.paymasterOverheadGas ?? DEFAULT_PAYMASTER_OVERHEAD;
     this.metrics = config.metrics;
   }
   /**
-   * Estimate the fee (in the caller's fee currency) to charge for the
-   * next sponsored UserOp.
+   * Estimate the operator fee for the next sponsored UserOp.
    *
-   *   gasUnits      = bundler-estimated (cached) or hardcoded fallback
-   *   nativeCost    = gasUnits × gasPrice
-   *   withPremium   = nativeCost × premiumBps / 10_000
-   *   fee           = quoteNativeToFee(withPremium)
+   * Without `opts` → legacy path: `gasUnits × gasPrice × premium →
+   * quoteNativeToFee`. Cached for 10 s to absorb bursts.
    *
-   * When `opts.partialUserOp` is omitted, behaves exactly like v0.16.x:
-   * uses the hardcoded `gasUnits` default.
+   * With `opts` AND `bundlerClient` → estimator path. Each call may
+   * hit a different bundler-cached result; the SDK does NOT add its
+   * own value cache because the estimator's cache TTL is the source
+   * of truth for "how long is this estimate good for".
    */
   async estimateGasFee(opts = {}) {
-    const now = Date.now();
     const isLegacyCall = !opts.partialUserOp && !opts.scenario && !opts.contractAddress;
+    const now = Date.now();
     if (isLegacyCall && this.cachedFee !== null && now < this.cacheExpiresAt) {
       return this.cachedFee;
     }
@@ -1312,49 +1254,32 @@ var FeeManager = class _FeeManager {
     }
     return fee;
   }
-  /**
-   * Manually purge the per-scenario gas-units cache. Useful after an SC
-   * upgrade when ops wants the next estimate to refresh immediately
-   * (the codehash check would catch it on the NEXT call anyway, but
-   * this forces it now).
-   */
+  /** Manually purge the legacy 10s fee cache. */
   invalidateCache() {
-    this.cache.invalidate();
     this.cachedFee = null;
     this.cacheExpiresAt = 0;
   }
   async resolveGasUnits(opts) {
     if (!this.bundlerClient || !opts.partialUserOp || !opts.scenario || !opts.contractAddress) {
-      return { gasUnits: this.gasUnits, source: "fallback" };
+      return { gasUnits: this.fallbackGasUnits, source: "fallback" };
     }
     try {
-      const cacheKey = await this.cache.buildKey({
+      const result = await this.bundlerClient.getGasUnits({
         scenario: opts.scenario,
         contractAddress: opts.contractAddress,
         paymasterAddress: opts.paymasterAddress,
-        provider: this.provider
+        partialUserOp: opts.partialUserOp
       });
-      const cached = this.cache.get(cacheKey);
-      if (cached !== null) {
-        return { gasUnits: cached, source: "cache" };
-      }
-      const estimate = await this.bundlerClient.estimateUserOperationGas({
-        sender: opts.partialUserOp.sender,
-        nonce: opts.partialUserOp.nonce,
-        callData: opts.partialUserOp.callData,
-        signature: opts.partialUserOp.signature ?? DUMMY_SIGNATURE
-        // Intentionally NO paymaster fields — avoids chicken-and-egg
-        // (paymasterData depends on gasLimits). Overhead added below.
-      });
-      const gasUnits = estimate.callGasLimit + estimate.verificationGasLimit + estimate.preVerificationGas + (estimate.paymasterVerificationGasLimit ?? 0n) + (estimate.paymasterPostOpGasLimit ?? 0n) + this.paymasterOverheadGas;
-      this.cache.set(cacheKey, gasUnits);
-      return { gasUnits, source: "bundler" };
+      return { gasUnits: result.gasUnits, source: "estimator" };
     } catch (err) {
       const reason = err instanceof Error ? err.message : String(err);
       this.safeEmit(
-        () => this.metrics?.onBundlerError?.({ scenario: opts.scenario, reason })
+        () => this.metrics?.onEstimatorError?.({
+          scenario: opts.scenario,
+          reason
+        })
       );
-      return { gasUnits: this.gasUnits, source: "fallback" };
+      return { gasUnits: this.fallbackGasUnits, source: "fallback" };
     }
   }
   safeEmit(fn) {
@@ -1365,6 +1290,70 @@ var FeeManager = class _FeeManager {
   }
 };
 
+// src/relay/bundlerEstimator.ts
+var PafiEstimatorHttpError = class extends Error {
+  status;
+  body;
+  constructor(status, body, message) {
+    super(message ?? `PAFI estimator HTTP ${status}`);
+    this.status = status;
+    this.body = body;
+  }
+};
+function createPafiEstimatorClient(config) {
+  const { baseUrl, apiKey, issuerId } = config;
+  if (!baseUrl) throw new Error("createPafiEstimatorClient: baseUrl required");
+  if (!apiKey) throw new Error("createPafiEstimatorClient: apiKey required");
+  if (!issuerId) throw new Error("createPafiEstimatorClient: issuerId required");
+  const fetchImpl = config.fetchImpl ?? globalThis.fetch;
+  if (!fetchImpl) {
+    throw new Error(
+      "createPafiEstimatorClient: no fetch implementation available \u2014 pass `fetchImpl`"
+    );
+  }
+  const url = `${baseUrl.replace(/\/$/, "")}/v1/estimate-gas-fee`;
+  return {
+    async getGasUnits(input) {
+      const body = JSON.stringify({
+        partialUserOp: {
+          sender: input.partialUserOp.sender,
+          // Hex-encode bigint for JSON safety. Sponsor-relayer parses
+          // back to bigint at the DTO layer.
+          nonce: `0x${input.partialUserOp.nonce.toString(16)}`,
+          callData: input.partialUserOp.callData,
+          signature: input.partialUserOp.signature
+        },
+        scenario: input.scenario,
+        contractAddress: input.contractAddress,
+        paymasterAddress: input.paymasterAddress
+      });
+      const res = await fetchImpl(url, {
+        method: "POST",
+        headers: {
+          "content-type": "application/json",
+          authorization: `Bearer ${apiKey}`,
+          "x-issuer-id": issuerId
+        },
+        body
+      });
+      if (!res.ok) {
+        let errBody = null;
+        try {
+          errBody = await res.json();
+        } catch {
+        }
+        throw new PafiEstimatorHttpError(res.status, errBody);
+      }
+      const json = await res.json();
+      return {
+        gasUnits: BigInt(json.gasUnits),
+        source: json.source,
+        expiresAt: json.expiresAt
+      };
+    }
+  };
+}
+
 // src/indexer/types.ts
 var InMemoryCursorStore = class {
   cursor;
@@ -1377,11 +1366,11 @@ var InMemoryCursorStore = class {
 };
 
 // src/indexer/pointIndexer.ts
-var import_viem5 = require("viem");
-var TRANSFER_EVENT = (0, import_viem5.parseAbiItem)(
+var import_viem4 = require("viem");
+var TRANSFER_EVENT = (0, import_viem4.parseAbiItem)(
   "event Transfer(address indexed from, address indexed to, uint256 value)"
 );
-var MINT_WITH_FEE_EVENT = (0, import_viem5.parseAbiItem)(
+var MINT_WITH_FEE_EVENT = (0, import_viem4.parseAbiItem)(
   "event MintWithFee(address indexed pointToken, address indexed to, uint256 grossAmount, uint256 netAmount, uint256 feeAmount)"
 );
 var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
@@ -1391,7 +1380,7 @@ var DEFAULT_BATCH_SIZE = 2000n;
 var DEFAULT_POLL_INTERVAL_MS = 5e3;
 function isNoWrapper(addr) {
   if (!addr) return true;
-  const checksummed = (0, import_viem5.getAddress)(addr);
+  const checksummed = (0, import_viem4.getAddress)(addr);
   return checksummed === ZERO_ADDRESS || checksummed === DEAD_ADDRESS;
 }
 var PointIndexer = class {
@@ -1413,8 +1402,8 @@ var PointIndexer = class {
       throw new Error("PointIndexer: pointTokenAddress required");
     if (!config.ledger) throw new Error("PointIndexer: ledger required");
     this.provider = config.provider;
-    this.pointTokenAddress = (0, import_viem5.getAddress)(config.pointTokenAddress);
-    this.mintFeeWrapperAddress = isNoWrapper(config.mintFeeWrapperAddress) ? void 0 : (0, import_viem5.getAddress)(config.mintFeeWrapperAddress);
+    this.pointTokenAddress = (0, import_viem4.getAddress)(config.pointTokenAddress);
+    this.mintFeeWrapperAddress = isNoWrapper(config.mintFeeWrapperAddress) ? void 0 : (0, import_viem4.getAddress)(config.mintFeeWrapperAddress);
     this.ledger = config.ledger;
     this.cursorStore = config.cursorStore ?? new InMemoryCursorStore();
     this.startBlock = config.fromBlock ?? 0n;
@@ -1533,9 +1522,9 @@ var PointIndexer = class {
       if (!args.pointToken || !args.to || args.grossAmount === void 0 || log.blockNumber === null || log.transactionHash === null) {
         continue;
       }
-      if ((0, import_viem5.getAddress)(args.pointToken) !== this.pointTokenAddress) continue;
+      if ((0, import_viem4.getAddress)(args.pointToken) !== this.pointTokenAddress) continue;
       out.push({
-        to: (0, import_viem5.getAddress)(args.to),
+        to: (0, import_viem4.getAddress)(args.to),
         amount: args.grossAmount,
         blockNumber: log.blockNumber,
         txHash: log.transactionHash,
@@ -1563,10 +1552,10 @@ var PointIndexer = class {
     for (const log of logs) {
       const args = log.args;
       if (!args.from || !args.to || args.value === void 0) continue;
-      if ((0, import_viem5.getAddress)(args.from) !== ZERO_ADDRESS) continue;
+      if ((0, import_viem4.getAddress)(args.from) !== ZERO_ADDRESS) continue;
       if (log.blockNumber === null || log.transactionHash === null) continue;
       out.push({
-        to: (0, import_viem5.getAddress)(args.to),
+        to: (0, import_viem4.getAddress)(args.to),
         amount: args.value,
         blockNumber: log.blockNumber,
         txHash: log.transactionHash,
@@ -1625,8 +1614,8 @@ function pickMatchingLock(locks, amount) {
 }
 
 // src/indexer/burnIndexer.ts
-var import_viem6 = require("viem");
-var TRANSFER_EVENT2 = (0, import_viem6.parseAbiItem)(
+var import_viem5 = require("viem");
+var TRANSFER_EVENT2 = (0, import_viem5.parseAbiItem)(
   "event Transfer(address indexed from, address indexed to, uint256 value)"
 );
 var ZERO_ADDRESS2 = "0x0000000000000000000000000000000000000000";
@@ -1757,10 +1746,10 @@ var BurnIndexer = class {
     for (const log of logs) {
       const args = log.args;
       if (!args.from || !args.to || args.value === void 0) continue;
-      if ((0, import_viem6.getAddress)(args.to) !== ZERO_ADDRESS2) continue;
+      if ((0, import_viem5.getAddress)(args.to) !== ZERO_ADDRESS2) continue;
       if (log.blockNumber === null || log.transactionHash === null) continue;
       out.push({
-        from: (0, import_viem6.getAddress)(args.from),
+        from: (0, import_viem5.getAddress)(args.from),
         amount: args.value,
         blockNumber: log.blockNumber,
         txHash: log.transactionHash,
@@ -1795,7 +1784,7 @@ var BurnIndexer = class {
 };
 
 // src/api/handlers.ts
-var import_viem7 = require("viem");
+var import_viem6 = require("viem");
 var import_core6 = require("@pafi-dev/core");
 var IssuerApiHandlers = class _IssuerApiHandlers {
   authService;
@@ -1832,7 +1821,7 @@ var IssuerApiHandlers = class _IssuerApiHandlers {
         "IssuerApiHandlers: pointTokenAddress or pointTokenAddresses required"
       );
     }
-    const normalized = raw.map((a) => (0, import_viem7.getAddress)(a));
+    const normalized = raw.map((a) => (0, import_viem6.getAddress)(a));
     this.supportedTokens = new Set(normalized);
     this.chainId = config.chainId;
     this.contracts = config.contracts;
@@ -1841,7 +1830,7 @@ var IssuerApiHandlers = class _IssuerApiHandlers {
     if (config.poolsProvider) this.poolsProvider = config.poolsProvider;
     if (config.redemption) this.redemption = config.redemption;
     if (config.mintFeeWrapperAddress) {
-      this.mintFeeWrapperAddress = (0, import_viem7.getAddress)(config.mintFeeWrapperAddress);
+      this.mintFeeWrapperAddress = (0, import_viem6.getAddress)(config.mintFeeWrapperAddress);
     }
   }
   // =========================================================================
@@ -2048,8 +2037,8 @@ var IssuerApiHandlers = class _IssuerApiHandlers {
         { requested: request.chainId, supported: this.chainId }
       );
     }
-    const normalizedAuthed = (0, import_viem7.getAddress)(userAddress);
-    const normalizedRequest = (0, import_viem7.getAddress)(request.userAddress);
+    const normalizedAuthed = (0, import_viem6.getAddress)(userAddress);
+    const normalizedRequest = (0, import_viem6.getAddress)(request.userAddress);
     if (normalizedAuthed !== normalizedRequest) {
       throw new import_core3.ValidationError(
         "USER_ADDRESS_MISMATCH",
@@ -2057,7 +2046,7 @@ var IssuerApiHandlers = class _IssuerApiHandlers {
         { authenticated: normalizedAuthed, requested: normalizedRequest }
       );
     }
-    const pointToken = (0, import_viem7.getAddress)(request.pointTokenAddress);
+    const pointToken = (0, import_viem6.getAddress)(request.pointTokenAddress);
     if (!this.supportedTokens.has(pointToken)) {
       throw new import_core3.ValidationError(
         "UNSUPPORTED_POINT_TOKEN",
@@ -2098,9 +2087,9 @@ var IssuerApiHandlers = class _IssuerApiHandlers {
         "handleRedemptionPreview: redemption is not configured on this issuer"
       );
     }
-    const tokenAddress = request.pointTokenAddress ? this.requireSupportedToken((0, import_viem7.getAddress)(request.pointTokenAddress), "handleRedemptionPreview") : void 0;
+    const tokenAddress = request.pointTokenAddress ? this.requireSupportedToken((0, import_viem6.getAddress)(request.pointTokenAddress), "handleRedemptionPreview") : void 0;
     const preview = await this.redemption.preview(
-      (0, import_viem7.getAddress)(userAddress),
+      (0, import_viem6.getAddress)(userAddress),
       tokenAddress
     );
     return preview;
@@ -2129,9 +2118,9 @@ var IssuerApiHandlers = class _IssuerApiHandlers {
         { amountPt: request.amountPt.toString() }
       );
     }
-    const tokenAddress = request.pointTokenAddress ? this.requireSupportedToken((0, import_viem7.getAddress)(request.pointTokenAddress), "handleRedemptionEvaluate") : void 0;
+    const tokenAddress = request.pointTokenAddress ? this.requireSupportedToken((0, import_viem6.getAddress)(request.pointTokenAddress), "handleRedemptionEvaluate") : void 0;
     const decision = await this.redemption.evaluate(
-      (0, import_viem7.getAddress)(userAddress),
+      (0, import_viem6.getAddress)(userAddress),
       request.amountPt,
       tokenAddress
     );
@@ -2155,7 +2144,7 @@ var IssuerApiHandlers = class _IssuerApiHandlers {
 };
 
 // src/api/handlers/ptRedeemHandler.ts
-var import_viem8 = require("viem");
+var import_viem7 = require("viem");
 var import_core7 = require("@pafi-dev/core");
 var DEFAULT_REDEEM_LOCK_MS = 15 * 60 * 1e3;
 var DEFAULT_SIG_DEADLINE_SEC = 15 * 60;
@@ -2216,8 +2205,8 @@ var PTRedeemHandler = class {
     this.relayService = config.relayService;
     this.provider = config.provider;
     this.feeService = config.feeService;
-    this.pointTokenAddress = (0, import_viem8.getAddress)(config.pointTokenAddress);
-    this.batchExecutorAddress = (0, import_viem8.getAddress)(config.batchExecutorAddress);
+    this.pointTokenAddress = (0, import_viem7.getAddress)(config.pointTokenAddress);
+    this.batchExecutorAddress = (0, import_viem7.getAddress)(config.batchExecutorAddress);
     this.chainId = config.chainId;
     this.domain = config.domain;
     this.burnerSignerWallet = config.burnerSignerWallet;
@@ -2232,7 +2221,7 @@ var PTRedeemHandler = class {
     }
   }
   async handle(request) {
-    if ((0, import_viem8.getAddress)(request.authenticatedAddress) !== (0, import_viem8.getAddress)(request.userAddress)) {
+    if ((0, import_viem7.getAddress)(request.authenticatedAddress) !== (0, import_viem7.getAddress)(request.userAddress)) {
       throw new PTRedeemError(
         "UNAUTHORIZED",
         `userAddress (${request.userAddress}) does not match authenticated session (${request.authenticatedAddress})`
@@ -2270,7 +2259,7 @@ var PTRedeemHandler = class {
         `failed to read burnRequestNonces(${request.userAddress}): ${err instanceof Error ? err.message : String(err)}`
       );
     }
-    const userKey = (0, import_viem8.getAddress)(request.userAddress).toLowerCase();
+    const userKey = (0, import_viem7.getAddress)(request.userAddress).toLowerCase();
     let userNonces = this.inFlightNonces.get(userKey);
     if (!userNonces) {
       userNonces = /* @__PURE__ */ new Set();
@@ -2552,7 +2541,7 @@ async function handleRedeemStatus(params) {
 }
 
 // src/api/mobileHandlers.ts
-var import_viem9 = require("viem");
+var import_viem8 = require("viem");
 var import_core10 = require("@pafi-dev/core");
 
 // src/userop-store/serialize.ts
@@ -2898,7 +2887,7 @@ async function handleMobileSubmit(params) {
   if (!entry) {
     throw new PendingUserOpNotFoundError(params.lockId);
   }
-  if ((0, import_viem9.getAddress)(entry.sender) !== (0, import_viem9.getAddress)(params.authenticatedAddress)) {
+  if ((0, import_viem8.getAddress)(entry.sender) !== (0, import_viem8.getAddress)(params.authenticatedAddress)) {
     throw new PendingUserOpForbiddenError(params.lockId);
   }
   const variant = params.variant ?? "sponsored";
@@ -2914,7 +2903,7 @@ async function handleMobileSubmit(params) {
 }
 
 // src/api/handlers/ptClaimHandler.ts
-var import_viem10 = require("viem");
+var import_viem9 = require("viem");
 var import_core11 = require("@pafi-dev/core");
 
 // src/issuer-state/types.ts
@@ -2960,7 +2949,7 @@ var PTClaimHandler = class {
     };
   }
   async handle(request) {
-    if ((0, import_viem10.getAddress)(request.authenticatedAddress) !== (0, import_viem10.getAddress)(request.userAddress)) {
+    if ((0, import_viem9.getAddress)(request.authenticatedAddress) !== (0, import_viem9.getAddress)(request.userAddress)) {
       throw new PTClaimError(
         "VALIDATION_FAILED",
         `userAddress (${request.userAddress}) does not match authenticated session (${request.authenticatedAddress})`
@@ -3214,7 +3203,7 @@ var PerpDepositHandler = class {
 
 // src/api/delegateHandler.ts
 var import_core13 = require("@pafi-dev/core");
-var import_viem11 = require("viem");
+var import_viem10 = require("viem");
 var DEFAULT_DELEGATE_GAS = {
   callGasLimit: 100000n,
   verificationGasLimit: 150000n,
@@ -3301,7 +3290,7 @@ async function handleDelegateSubmit(params) {
   if (!entry) {
     throw new PendingUserOpNotFoundError(params.lockId);
   }
-  if ((0, import_viem11.getAddress)(entry.sender) !== (0, import_viem11.getAddress)(params.authenticatedAddress)) {
+  if ((0, import_viem10.getAddress)(entry.sender) !== (0, import_viem10.getAddress)(params.authenticatedAddress)) {
     throw new PendingUserOpForbiddenError(params.lockId);
   }
   if (!entry.eip7702Auth) {
@@ -3322,7 +3311,7 @@ async function handleDelegateSubmit(params) {
 
 // src/api/issuerApiAdapter.ts
 var import_node_crypto3 = require("crypto");
-var import_viem12 = require("viem");
+var import_viem11 = require("viem");
 var import_core14 = require("@pafi-dev/core");
 var AdapterMisconfiguredError = class extends Error {
   code = "ADAPTER_MISCONFIGURED";
@@ -3380,7 +3369,7 @@ var IssuerApiAdapter = class {
   async pools(authenticatedAddress, chainId, pointTokenAddress) {
     const result = await this.cfg.issuerService.api.handlePools(
       authenticatedAddress,
-      { chainId, pointTokenAddress: (0, import_viem12.getAddress)(pointTokenAddress) }
+      { chainId, pointTokenAddress: (0, import_viem11.getAddress)(pointTokenAddress) }
     );
     return { pools: result.pools };
   }
@@ -3389,8 +3378,8 @@ var IssuerApiAdapter = class {
       authenticatedAddress,
       {
         chainId,
-        userAddress: (0, import_viem12.getAddress)(userAddress),
-        pointTokenAddress: (0, import_viem12.getAddress)(pointTokenAddress)
+        userAddress: (0, import_viem11.getAddress)(userAddress),
+        pointTokenAddress: (0, import_viem11.getAddress)(pointTokenAddress)
       }
     );
     return {
@@ -3411,7 +3400,7 @@ var IssuerApiAdapter = class {
       "ptClaimHandler",
       "claim"
     );
-    const pointTokenAddress = (0, import_viem12.getAddress)(input.pointTokenAddress);
+    const pointTokenAddress = (0, import_viem11.getAddress)(input.pointTokenAddress);
     const result = await ptClaimHandler.handle({
       authenticatedAddress: input.authenticatedAddress,
       userAddress: input.authenticatedAddress,
@@ -3506,7 +3495,7 @@ var IssuerApiAdapter = class {
       "ptClaimHandler",
       "claimPrepare"
     );
-    const pointTokenAddress = (0, import_viem12.getAddress)(input.pointTokenAddress);
+    const pointTokenAddress = (0, import_viem11.getAddress)(input.pointTokenAddress);
     const claimResult = await ptClaimHandler.handle({
       authenticatedAddress: input.authenticatedAddress,
       userAddress: input.authenticatedAddress,
@@ -3552,7 +3541,7 @@ var IssuerApiAdapter = class {
   }
   async redeemPrepare(input) {
     this.assertRedeemHandler();
-    const pointTokenAddress = (0, import_viem12.getAddress)(input.pointTokenAddress);
+    const pointTokenAddress = (0, import_viem11.getAddress)(input.pointTokenAddress);
     const redeemResponse = await this.cfg.ptRedeemHandler.handle({
       userAddress: input.authenticatedAddress,
       authenticatedAddress: input.authenticatedAddress,
@@ -3742,7 +3731,7 @@ var IssuerApiAdapter = class {
 };
 
 // src/pools/subgraphPoolsProvider.ts
-var import_viem13 = require("viem");
+var import_viem12 = require("viem");
 var import_core15 = require("@pafi-dev/core");
 var DEFAULT_CACHE_TTL_MS = 3e4;
 var MAX_REASONABLE_FEE_TIER = 1e6;
@@ -3865,7 +3854,7 @@ async function fetchPoolsFromSubgraph(fetchImpl, subgraphUrl, pointTokenAddress,
     return [];
   }
   const { pool } = token;
-  if (!(0, import_viem13.isAddress)(pool.token0.id) || !(0, import_viem13.isAddress)(pool.token1.id)) {
+  if (!(0, import_viem12.isAddress)(pool.token0.id) || !(0, import_viem12.isAddress)(pool.token1.id)) {
     const error = new Error(
       "[PAFI] SubgraphPoolsProvider: invalid token address in response"
     );
@@ -4018,8 +4007,8 @@ function toUsdtPerNative(priceFloat, usdtDecimals) {
 }
 
 // src/pools/nativePtQuoter.ts
-var import_viem14 = require("viem");
-var CHAINLINK_ABI = (0, import_viem14.parseAbi)([
+var import_viem13 = require("viem");
+var CHAINLINK_ABI = (0, import_viem13.parseAbi)([
   "function latestRoundData() external view returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound)"
 ]);
 var CHAINLINK_MAX_AGE_S = 3600n;
@@ -4303,7 +4292,7 @@ var PafiBackendClient = class {
 };
 
 // src/config.ts
-var import_viem15 = require("viem");
+var import_viem14 = require("viem");
 var import_core18 = require("@pafi-dev/core");
 
 // src/redemption/evaluator.ts
@@ -4630,7 +4619,7 @@ function createIssuerService(config) {
       "createIssuerService: at least one of pointTokenAddress / pointTokenAddresses is required"
     );
   }
-  const tokenAddresses = rawAddresses.map((a) => (0, import_viem15.getAddress)(a));
+  const tokenAddresses = rawAddresses.map((a) => (0, import_viem14.getAddress)(a));
   const ledger = config.ledger;
   const sessionStore = config.sessionStore ?? new MemorySessionStore();
   const policy = config.policy ?? new DefaultPolicyEngine({ ledger });
@@ -4749,7 +4738,7 @@ function createIssuerService(config) {
 }
 
 // src/issuer-state/validator.ts
-var import_viem16 = require("viem");
+var import_viem15 = require("viem");
 var import_core19 = require("@pafi-dev/core");
 var ISSUER_RECORD_TTL_MS = 3e4;
 var IssuerStateValidator = class _IssuerStateValidator {
@@ -4776,7 +4765,7 @@ var IssuerStateValidator = class _IssuerStateValidator {
    */
   invalidate(pointToken) {
     if (pointToken) {
-      const key = (0, import_viem16.getAddress)(pointToken);
+      const key = (0, import_viem15.getAddress)(pointToken);
       this.pointTokenIssuerCache.delete(key);
       this.stateCache.delete(key);
       this.inflight.delete(key);
@@ -4791,7 +4780,7 @@ var IssuerStateValidator = class _IssuerStateValidator {
    * The issuer field is set at `initialize()` and never changes.
    */
   async getIssuerAddressForPointToken(pointToken) {
-    const key = (0, import_viem16.getAddress)(pointToken);
+    const key = (0, import_viem15.getAddress)(pointToken);
     const cached = this.pointTokenIssuerCache.get(key);
     if (cached) return cached;
     const issuer = await this.provider.readContract({
@@ -4799,15 +4788,15 @@ var IssuerStateValidator = class _IssuerStateValidator {
       abi: import_core19.POINT_TOKEN_ABI,
       functionName: "issuer"
     });
-    this.pointTokenIssuerCache.set(key, (0, import_viem16.getAddress)(issuer));
-    return (0, import_viem16.getAddress)(issuer);
+    this.pointTokenIssuerCache.set(key, (0, import_viem15.getAddress)(issuer));
+    return (0, import_viem15.getAddress)(issuer);
   }
   /**
    * Read registry record + totalSupply, with 30s cache and in-flight
    * deduplication. Does NOT throw on inactive/missing — returns raw state.
    */
   async getIssuerState(pointToken) {
-    const tokenAddr = (0, import_viem16.getAddress)(pointToken);
+    const tokenAddr = (0, import_viem15.getAddress)(pointToken);
     const now = Date.now();
     const cached = this.stateCache.get(tokenAddr);
     if (cached && cached.expiresAt > now) return cached.value;
@@ -4950,7 +4939,7 @@ var MemoryRedemptionHistoryStore = class {
 };
 
 // src/index.ts
-var PAFI_ISSUER_SDK_VERSION = true ? "0.18.0" : "dev";
+var PAFI_ISSUER_SDK_VERSION = true ? "0.20.0" : "dev";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AdapterMisconfiguredError,
@@ -4963,7 +4952,6 @@ var PAFI_ISSUER_SDK_VERSION = true ? "0.18.0" : "dev";
   DEFAULT_REDEMPTION_POLICY,
   DefaultPolicyEngine,
   FeeManager,
-  GasUnitsCache,
   InMemoryCursorStore,
   IssuerApiAdapter,
   IssuerApiHandlers,
@@ -4984,6 +4972,7 @@ var PAFI_ISSUER_SDK_VERSION = true ? "0.18.0" : "dev";
   PTRedeemHandler,
   PafiBackendClient,
   PafiBackendError,
+  PafiEstimatorHttpError,
   PafiSdkError,
   PendingUserOpForbiddenError,
   PendingUserOpNotFoundError,
@@ -5004,6 +4993,7 @@ var PAFI_ISSUER_SDK_VERSION = true ? "0.18.0" : "dev";
   buildSdkErrorBody,
   createIssuerService,
   createNativePtQuoter,
+  createPafiEstimatorClient,
   createSdkErrorMapper,
   createSubgraphNativeUsdtQuoter,
   createSubgraphPoolsProvider,