@pafi-dev/issuer 0.5.37 → 0.5.39

package/dist/index.cjs

@@ -43,6 +43,8 @@ __export(index_exports, {
   PTRedeemHandler: () => PTRedeemHandler,
   PafiBackendClient: () => PafiBackendClient,
   PafiBackendError: () => PafiBackendError,
+  PafiSdkError: () => PafiSdkError,
+  PendingUserOpForbiddenError: () => PendingUserOpForbiddenError,
   PendingUserOpNotFoundError: () => PendingUserOpNotFoundError,
   PerpDepositError: () => PerpDepositError,
   PerpDepositHandler: () => PerpDepositHandler,
@@ -56,6 +58,7 @@ __export(index_exports, {
   authenticateRequest: () => authenticateRequest,
   createIssuerService: () => createIssuerService,
   createNativePtQuoter: () => createNativePtQuoter,
+  createSdkErrorMapper: () => createSdkErrorMapper,
   createSubgraphNativeUsdtQuoter: () => createSubgraphNativeUsdtQuoter,
   createSubgraphPoolsProvider: () => createSubgraphPoolsProvider,
   handleClaimStatus: () => handleClaimStatus,
@@ -73,6 +76,22 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/errors.ts
+var PafiSdkError = class extends Error {
+  /**
+   * `true` when the FE should consider a retry safe — typically because
+   * the failure is transient (`MINT_CAP_EXCEEDED` may free up,
+   * `RELAY_FEE_EXCEEDS_AMOUNT` may drop on next quote). Defaults to
+   * `false` — subclasses opt in per-code.
+   */
+  safeToRetry = false;
+  details;
+  constructor(message) {
+    super(message);
+    this.name = new.target.name;
+  }
+};
+
 // src/policy/defaultPolicy.ts
 var DefaultPolicyEngine = class {
   ledger;
@@ -1374,18 +1393,19 @@ var import_viem7 = require("viem");
 var import_core4 = require("@pafi-dev/core");
 var DEFAULT_REDEEM_LOCK_MS = 15 * 60 * 1e3;
 var DEFAULT_SIG_DEADLINE_SEC = 15 * 60;
-var PTRedeemError = class extends Error {
+var PTRedeemError = class extends PafiSdkError {
+  httpStatus = "unprocessable";
+  code;
   constructor(code, message) {
     super(message);
     this.code = code;
-    this.name = "PTRedeemError";
   }
-  code;
 };
 var PTRedeemHandler = class {
   ledger;
   relayService;
   provider;
+  feeService;
   pointTokenAddress;
   batchExecutorAddress;
   chainId;
@@ -1424,6 +1444,7 @@ var PTRedeemHandler = class {
     this.ledger = config.ledger;
     this.relayService = config.relayService;
     this.provider = config.provider;
+    this.feeService = config.feeService;
     this.pointTokenAddress = (0, import_viem7.getAddress)(config.pointTokenAddress);
     this.batchExecutorAddress = (0, import_viem7.getAddress)(config.batchExecutorAddress);
     this.chainId = config.chainId;
@@ -1481,7 +1502,15 @@ var PTRedeemHandler = class {
     }
   }
   async _handleAfterNonceLock(request, burnNonce) {
-    const fee = request.feeAmount && request.feeAmount > 0n ? request.feeAmount : 0n;
+    let fee;
+    if (request.feeAmount !== void 0) {
+      fee = request.feeAmount > 0n ? request.feeAmount : 0n;
+    } else if (this.feeService) {
+      fee = await this.feeService.estimateGasFee();
+    } else {
+      fee = 0n;
+    }
+    const feeRecipient = request.feeRecipient ?? (request.chainId !== void 0 ? (0, import_core4.getContractAddresses)(request.chainId).pafiFeeRecipient : (0, import_core4.getContractAddresses)(this.chainId).pafiFeeRecipient);
     if (fee > 0n && fee >= request.amount) {
       throw new PTRedeemError(
         "INVALID_AMOUNT",
@@ -1538,7 +1567,7 @@ var PTRedeemHandler = class {
       burnRequest: sponsoredBurnRequest,
       burnerSignature: sponsoredSig,
       feeAmount: fee,
-      feeRecipient: request.feeRecipient
+      feeRecipient
     });
     let fallback = void 0;
     if (fee > 0n) {
@@ -1587,6 +1616,7 @@ var PTRedeemHandler = class {
       lockId: sponsoredLockId,
       userOp: sponsoredUserOp,
       netCreditAmount: sponsoredBurnAmount,
+      feeAmount: fee,
       fallback,
       expiresInSeconds: Math.floor(this.redeemLockDurationMs / 1e3),
       signatureDeadline: deadline
@@ -1659,11 +1689,11 @@ var TopUpRedemptionHandler = class {
 };
 
 // src/api/statusHandlers.ts
-var LockNotFoundError = class extends Error {
+var LockNotFoundError = class extends PafiSdkError {
   code = "LOCK_NOT_FOUND";
+  httpStatus = "not_found";
   constructor() {
     super("Lock not found or does not belong to authenticated user");
-    this.name = "LockNotFoundError";
   }
 };
 async function handleClaimStatus(params) {
@@ -1759,6 +1789,7 @@ async function handleRedeemStatus(params) {
 }
 
 // src/api/mobileHandlers.ts
+var import_viem9 = require("viem");
 var import_core8 = require("@pafi-dev/core");
 
 // src/userop-store/serialize.ts
@@ -1895,21 +1926,21 @@ async function prepareMobileUserOp(params) {
 }
 
 // src/pafi-backend/helpers.ts
-var BundlerNotConfiguredError = class extends Error {
+var BundlerNotConfiguredError = class extends PafiSdkError {
   code = "BUNDLER_NOT_CONFIGURED";
+  httpStatus = "service_unavailable";
   constructor() {
     super(
       "PAFI backend client not configured \u2014 set PAFI_BACKEND_URL, PAFI_ISSUER_ID, PAFI_API_KEY to enable mobile submit."
     );
-    this.name = "BundlerNotConfiguredError";
   }
 };
-var BundlerRejectedError = class extends Error {
+var BundlerRejectedError = class extends PafiSdkError {
   code = "BUNDLER_REJECTED";
+  httpStatus = "unprocessable";
   cause;
   constructor(message, cause) {
     super(message);
-    this.name = "BundlerRejectedError";
     this.cause = cause;
   }
 };
@@ -1965,13 +1996,22 @@ async function relayUserOp(params) {
 }
 
 // src/api/mobileHandlers.ts
-var PendingUserOpNotFoundError = class extends Error {
+var PendingUserOpNotFoundError = class extends PafiSdkError {
   code = "PENDING_USEROP_NOT_FOUND";
+  httpStatus = "not_found";
   constructor(lockId) {
     super(
       `No pending UserOp found for lockId ${lockId} \u2014 it may have expired or already been submitted.`
     );
-    this.name = "PendingUserOpNotFoundError";
+  }
+};
+var PendingUserOpForbiddenError = class extends PafiSdkError {
+  code = "PENDING_USEROP_FORBIDDEN";
+  httpStatus = "forbidden";
+  constructor(lockId) {
+    super(
+      `Pending UserOp ${lockId} does not belong to the authenticated user.`
+    );
   }
 };
 async function handleMobilePrepare(params) {
@@ -2013,6 +2053,9 @@ async function handleMobileSubmit(params) {
   if (!entry) {
     throw new PendingUserOpNotFoundError(params.lockId);
   }
+  if ((0, import_viem9.getAddress)(entry.sender) !== (0, import_viem9.getAddress)(params.authenticatedAddress)) {
+    throw new PendingUserOpForbiddenError(params.lockId);
+  }
   const variant = params.variant ?? "sponsored";
   const userOpJson = serializeEntryToJsonRpc(entry, params.signature, variant);
   const result = await relayUserOp({
@@ -2026,31 +2069,33 @@ async function handleMobileSubmit(params) {
 }
 
 // src/api/handlers/ptClaimHandler.ts
-var import_viem9 = require("viem");
+var import_viem10 = require("viem");
 var import_core9 = require("@pafi-dev/core");
 
 // src/issuer-state/types.ts
-var IssuerStateError = class extends Error {
+var IssuerStateError = class extends PafiSdkError {
+  httpStatus = "unprocessable";
+  code;
+  details;
+  safeToRetry;
   constructor(code, message, details) {
     super(message);
     this.code = code;
     this.details = details;
-    this.name = "IssuerStateError";
+    this.safeToRetry = code === "MINT_CAP_EXCEEDED";
   }
-  code;
-  details;
 };
 
 // src/api/handlers/ptClaimHandler.ts
-var PTClaimError = class extends Error {
+var PTClaimError = class extends PafiSdkError {
+  httpStatus = "unprocessable";
+  code;
+  details;
   constructor(code, message, details) {
     super(message);
     this.code = code;
     this.details = details;
-    this.name = "PTClaimError";
   }
-  code;
-  details;
 };
 var DEFAULT_LOCK_MS = 15 * 60 * 1e3;
 var DEFAULT_SIG_DEADLINE_SEC2 = 15 * 60;
@@ -2065,7 +2110,7 @@ var PTClaimHandler = class {
     };
   }
   async handle(request) {
-    if ((0, import_viem9.getAddress)(request.authenticatedAddress) !== (0, import_viem9.getAddress)(request.userAddress)) {
+    if ((0, import_viem10.getAddress)(request.authenticatedAddress) !== (0, import_viem10.getAddress)(request.userAddress)) {
       throw new PTClaimError(
         "VALIDATION_FAILED",
         `userAddress (${request.userAddress}) does not match authenticated session (${request.authenticatedAddress})`
@@ -2165,13 +2210,13 @@ var PTClaimHandler = class {
 
 // src/api/handlers/swapHandler.ts
 var import_core10 = require("@pafi-dev/core");
-var SwapError = class extends Error {
+var SwapError = class extends PafiSdkError {
+  httpStatus = "unprocessable";
+  code;
   constructor(code, message) {
     super(message);
     this.code = code;
-    this.name = "SwapError";
   }
-  code;
 };
 var DEFAULT_SLIPPAGE_BPS = 50;
 var DEFAULT_SWAP_DEADLINE_SEC = 5 * 60;
@@ -2297,13 +2342,15 @@ var SwapHandler = class {
 
 // src/api/handlers/perpDepositHandler.ts
 var import_core11 = require("@pafi-dev/core");
-var PerpDepositError = class extends Error {
+var PerpDepositError = class extends PafiSdkError {
+  httpStatus = "unprocessable";
+  code;
+  safeToRetry;
   constructor(code, message) {
     super(message);
     this.code = code;
-    this.name = "PerpDepositError";
+    this.safeToRetry = code === "RELAY_FEE_EXCEEDS_AMOUNT";
   }
-  code;
 };
 var DEFAULT_MAX_FEE_PREMIUM_BPS = 5e3;
 var PerpDepositHandler = class {
@@ -2546,8 +2593,33 @@ async function quotePointTokenToUsdt(params) {
   };
 }
 
+// src/api/errorMapper.ts
+function createSdkErrorMapper(factories) {
+  return (err) => {
+    if (!(err instanceof PafiSdkError)) {
+      throw err;
+    }
+    const body = {
+      code: err.code,
+      message: err.message,
+      details: err.details,
+      safeToRetry: err.safeToRetry
+    };
+    switch (err.httpStatus) {
+      case "not_found":
+        throw factories.notFound(body);
+      case "forbidden":
+        throw factories.forbidden(body);
+      case "unprocessable":
+        throw factories.unprocessable(body);
+      case "service_unavailable":
+        throw factories.serviceUnavailable(body);
+    }
+  };
+}
+
 // src/pools/subgraphPoolsProvider.ts
-var import_viem10 = require("viem");
+var import_viem11 = require("viem");
 var import_core14 = require("@pafi-dev/core");
 var DEFAULT_CACHE_TTL_MS = 3e4;
 var POOL_QUERY = `
@@ -2648,7 +2720,7 @@ async function fetchPoolsFromSubgraph(fetchImpl, subgraphUrl, pointTokenAddress)
     return [];
   }
   const { pool } = token;
-  if (!(0, import_viem10.isAddress)(pool.hooks)) {
+  if (!(0, import_viem11.isAddress)(pool.hooks)) {
     console.error(
       "[PAFI] SubgraphPoolsProvider: invalid hooks address in response:",
       pool.hooks,
@@ -2656,7 +2728,7 @@ async function fetchPoolsFromSubgraph(fetchImpl, subgraphUrl, pointTokenAddress)
     );
     return [];
   }
-  if (!(0, import_viem10.isAddress)(pool.token0.id) || !(0, import_viem10.isAddress)(pool.token1.id)) {
+  if (!(0, import_viem11.isAddress)(pool.token0.id) || !(0, import_viem11.isAddress)(pool.token1.id)) {
     console.error(
       "[PAFI] SubgraphPoolsProvider: invalid token address in response \u2014 skipping pool"
     );
@@ -2806,8 +2878,8 @@ function toUsdtPerNative(priceFloat, usdtDecimals) {
 }
 
 // src/pools/nativePtQuoter.ts
-var import_viem11 = require("viem");
-var CHAINLINK_ABI = (0, import_viem11.parseAbi)([
+var import_viem12 = require("viem");
+var CHAINLINK_ABI = (0, import_viem12.parseAbi)([
   "function latestRoundData() external view returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound)"
 ]);
 var CHAINLINK_MAX_AGE_S = 3600n;
@@ -3164,7 +3236,7 @@ var PafiBackendClient = class {
 };
 
 // src/config.ts
-var import_viem12 = require("viem");
+var import_viem13 = require("viem");
 var import_core16 = require("@pafi-dev/core");
 function createIssuerService(config) {
   if (!config.provider) {
@@ -3185,7 +3257,7 @@ function createIssuerService(config) {
       "createIssuerService: at least one of pointTokenAddress / pointTokenAddresses is required"
     );
   }
-  const tokenAddresses = rawAddresses.map((a) => (0, import_viem12.getAddress)(a));
+  const tokenAddresses = rawAddresses.map((a) => (0, import_viem13.getAddress)(a));
   const ledger = config.ledger;
   const sessionStore = config.sessionStore ?? new MemorySessionStore();
   const policy = config.policy ?? new DefaultPolicyEngine({ ledger });
@@ -3283,7 +3355,7 @@ function createIssuerService(config) {
 }
 
 // src/issuer-state/validator.ts
-var import_viem13 = require("viem");
+var import_viem14 = require("viem");
 var import_core17 = require("@pafi-dev/core");
 var ISSUER_RECORD_TTL_MS = 3e4;
 var IssuerStateValidator = class _IssuerStateValidator {
@@ -3310,7 +3382,7 @@ var IssuerStateValidator = class _IssuerStateValidator {
    */
   invalidate(pointToken) {
     if (pointToken) {
-      const key = (0, import_viem13.getAddress)(pointToken);
+      const key = (0, import_viem14.getAddress)(pointToken);
       this.pointTokenIssuerCache.delete(key);
       this.stateCache.delete(key);
       this.inflight.delete(key);
@@ -3325,7 +3397,7 @@ var IssuerStateValidator = class _IssuerStateValidator {
    * The issuer field is set at `initialize()` and never changes.
    */
   async getIssuerAddressForPointToken(pointToken) {
-    const key = (0, import_viem13.getAddress)(pointToken);
+    const key = (0, import_viem14.getAddress)(pointToken);
     const cached = this.pointTokenIssuerCache.get(key);
     if (cached) return cached;
     const issuer = await this.provider.readContract({
@@ -3333,15 +3405,15 @@ var IssuerStateValidator = class _IssuerStateValidator {
       abi: import_core17.POINT_TOKEN_V2_ABI,
       functionName: "issuer"
     });
-    this.pointTokenIssuerCache.set(key, (0, import_viem13.getAddress)(issuer));
-    return (0, import_viem13.getAddress)(issuer);
+    this.pointTokenIssuerCache.set(key, (0, import_viem14.getAddress)(issuer));
+    return (0, import_viem14.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_viem13.getAddress)(pointToken);
+    const tokenAddr = (0, import_viem14.getAddress)(pointToken);
     const now = Date.now();
     const cached = this.stateCache.get(tokenAddr);
     if (cached && cached.expiresAt > now) return cached.value;
@@ -3465,6 +3537,8 @@ var PAFI_ISSUER_SDK_VERSION = "0.4.0";
   PTRedeemHandler,
   PafiBackendClient,
   PafiBackendError,
+  PafiSdkError,
+  PendingUserOpForbiddenError,
   PendingUserOpNotFoundError,
   PerpDepositError,
   PerpDepositHandler,
@@ -3478,6 +3552,7 @@ var PAFI_ISSUER_SDK_VERSION = "0.4.0";
   authenticateRequest,
   createIssuerService,
   createNativePtQuoter,
+  createSdkErrorMapper,
   createSubgraphNativeUsdtQuoter,
   createSubgraphPoolsProvider,
   handleClaimStatus,