@pafi-dev/issuer 0.5.37 → 0.5.39

package/dist/index.js

@@ -1,3 +1,19 @@
+// 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;
@@ -1311,21 +1327,27 @@ var IssuerApiHandlers = class {
 
 // src/api/handlers/ptRedeemHandler.ts
 import { getAddress as getAddress6 } from "viem";
-import { signBurnRequest, POINT_TOKEN_V2_ABI as POINT_TOKEN_V2_ABI2, getPointTokenBalance as getPointTokenBalance2 } from "@pafi-dev/core";
+import {
+  signBurnRequest,
+  POINT_TOKEN_V2_ABI as POINT_TOKEN_V2_ABI2,
+  getPointTokenBalance as getPointTokenBalance2,
+  getContractAddresses as getContractAddresses2
+} from "@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;
@@ -1364,6 +1386,7 @@ var PTRedeemHandler = class {
     this.ledger = config.ledger;
     this.relayService = config.relayService;
     this.provider = config.provider;
+    this.feeService = config.feeService;
     this.pointTokenAddress = getAddress6(config.pointTokenAddress);
     this.batchExecutorAddress = getAddress6(config.batchExecutorAddress);
     this.chainId = config.chainId;
@@ -1421,7 +1444,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 ? getContractAddresses2(request.chainId).pafiFeeRecipient : getContractAddresses2(this.chainId).pafiFeeRecipient);
     if (fee > 0n && fee >= request.amount) {
       throw new PTRedeemError(
         "INVALID_AMOUNT",
@@ -1478,7 +1509,7 @@ var PTRedeemHandler = class {
       burnRequest: sponsoredBurnRequest,
       burnerSignature: sponsoredSig,
       feeAmount: fee,
-      feeRecipient: request.feeRecipient
+      feeRecipient
     });
     let fallback = void 0;
     if (fee > 0n) {
@@ -1527,6 +1558,7 @@ var PTRedeemHandler = class {
       lockId: sponsoredLockId,
       userOp: sponsoredUserOp,
       netCreditAmount: sponsoredBurnAmount,
+      feeAmount: fee,
       fallback,
       expiresInSeconds: Math.floor(this.redeemLockDurationMs / 1e3),
       signatureDeadline: deadline
@@ -1599,11 +1631,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) {
@@ -1699,6 +1731,7 @@ async function handleRedeemStatus(params) {
 }
 
 // src/api/mobileHandlers.ts
+import { getAddress as getAddress8 } from "viem";
 import {
   ENTRY_POINT_V08,
   parseEip7702DelegatedAddress
@@ -1841,21 +1874,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;
   }
 };
@@ -1911,13 +1944,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) {
@@ -1959,6 +2001,9 @@ async function handleMobileSubmit(params) {
   if (!entry) {
     throw new PendingUserOpNotFoundError(params.lockId);
   }
+  if (getAddress8(entry.sender) !== getAddress8(params.authenticatedAddress)) {
+    throw new PendingUserOpForbiddenError(params.lockId);
+  }
   const variant = params.variant ?? "sponsored";
   const userOpJson = serializeEntryToJsonRpc(entry, params.signature, variant);
   const result = await relayUserOp({
@@ -1972,34 +2017,36 @@ async function handleMobileSubmit(params) {
 }
 
 // src/api/handlers/ptClaimHandler.ts
-import { getAddress as getAddress8 } from "viem";
+import { getAddress as getAddress9 } from "viem";
 import {
   decodeBatchExecuteCalls,
-  getContractAddresses as getContractAddresses2
+  getContractAddresses as getContractAddresses3
 } from "@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;
@@ -2014,7 +2061,7 @@ var PTClaimHandler = class {
     };
   }
   async handle(request) {
-    if (getAddress8(request.authenticatedAddress) !== getAddress8(request.userAddress)) {
+    if (getAddress9(request.authenticatedAddress) !== getAddress9(request.userAddress)) {
       throw new PTClaimError(
         "VALIDATION_FAILED",
         `userAddress (${request.userAddress}) does not match authenticated session (${request.authenticatedAddress})`
@@ -2037,7 +2084,7 @@ var PTClaimHandler = class {
         );
       }
     }
-    const { batchExecutor: batchExecutorAddress } = getContractAddresses2(
+    const { batchExecutor: batchExecutorAddress } = getContractAddresses3(
       request.chainId
     );
     const lockId = await this.cfg.ledger.lockForMinting(
@@ -2117,15 +2164,15 @@ import {
   buildSwapWithGasDeduction,
   decodeBatchExecuteCalls as decodeBatchExecuteCalls2,
   findBestQuote,
-  getContractAddresses as getContractAddresses3
+  getContractAddresses as getContractAddresses4
 } from "@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;
@@ -2144,7 +2191,7 @@ var SwapHandler = class {
       throw new SwapError("INVALID_AMOUNT", "amountIn must be positive");
     }
     const slippageBps = request.slippageBps ?? this.cfg.defaultSlippageBps;
-    const { usdt, pafiFeeRecipient, universalRouter } = getContractAddresses3(
+    const { usdt, pafiFeeRecipient, universalRouter } = getContractAddresses4(
       request.chainId
     );
     const poolsResponse = await this.cfg.poolsProvider({
@@ -2259,15 +2306,17 @@ import {
   buildPerpDepositViaRelay,
   computeAccountId,
   decodeBatchExecuteCalls as decodeBatchExecuteCalls3,
-  getContractAddresses as getContractAddresses4
+  getContractAddresses as getContractAddresses5
 } from "@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 {
@@ -2291,7 +2340,7 @@ var PerpDepositHandler = class {
         `no Orderly Vault for chainId ${request.chainId}`
       );
     }
-    const { orderlyRelay: relayAddress, pafiFeeRecipient } = getContractAddresses4(request.chainId);
+    const { orderlyRelay: relayAddress, pafiFeeRecipient } = getContractAddresses5(request.chainId);
     const [usdcAddress, brokerAllowed] = await Promise.all([
       this.cfg.provider.readContract({
         address: vault,
@@ -2380,7 +2429,7 @@ import {
   ENTRY_POINT_V08 as ENTRY_POINT_V082,
   buildEip7702Authorization,
   encodeBatchExecute,
-  getContractAddresses as getContractAddresses5,
+  getContractAddresses as getContractAddresses6,
   serializeUserOpToJsonRpc as serializeUserOpToJsonRpc2
 } from "@pafi-dev/core";
 var DEFAULT_DELEGATE_GAS = {
@@ -2389,7 +2438,7 @@ var DEFAULT_DELEGATE_GAS = {
   preVerificationGas: 50000n
 };
 async function handleDelegateSubmit(params) {
-  const { batchExecutor } = getContractAddresses5(params.chainId);
+  const { batchExecutor } = getContractAddresses6(params.chainId);
   const callData = encodeBatchExecute([]);
   const userOp = {
     sender: params.userAddress,
@@ -2454,7 +2503,7 @@ async function handleDelegateSubmit(params) {
 // src/api/quoteHelper.ts
 import {
   findBestQuote as findBestQuote2,
-  getContractAddresses as getContractAddresses6
+  getContractAddresses as getContractAddresses7
 } from "@pafi-dev/core";
 var DEFAULT_DEADLINE_SECONDS = 300;
 async function quotePointTokenToUsdt(params) {
@@ -2479,7 +2528,7 @@ async function quotePointTokenToUsdt(params) {
       quoteError: "QUOTE_UNAVAILABLE"
     };
   }
-  const { usdt: usdtAddress } = getContractAddresses6(params.chainId);
+  const { usdt: usdtAddress } = getContractAddresses7(params.chainId);
   let estimatedUsdtOut = 0n;
   let gasEstimate = 0n;
   try {
@@ -2519,6 +2568,31 @@ 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
 import { isAddress } from "viem";
 import { PAFI_SUBGRAPH_URL } from "@pafi-dev/core";
@@ -3137,8 +3211,8 @@ var PafiBackendClient = class {
 };
 
 // src/config.ts
-import { getAddress as getAddress9 } from "viem";
-import { getContractAddresses as getContractAddresses7 } from "@pafi-dev/core";
+import { getAddress as getAddress10 } from "viem";
+import { getContractAddresses as getContractAddresses8 } from "@pafi-dev/core";
 function createIssuerService(config) {
   if (!config.provider) {
     throw new Error("createIssuerService: provider is required");
@@ -3158,7 +3232,7 @@ function createIssuerService(config) {
       "createIssuerService: at least one of pointTokenAddress / pointTokenAddresses is required"
     );
   }
-  const tokenAddresses = rawAddresses.map((a) => getAddress9(a));
+  const tokenAddresses = rawAddresses.map((a) => getAddress10(a));
   const ledger = config.ledger;
   const sessionStore = config.sessionStore ?? new MemorySessionStore();
   const policy = config.policy ?? new DefaultPolicyEngine({ ledger });
@@ -3208,7 +3282,7 @@ function createIssuerService(config) {
     indexers.set(tokenAddress, new PointIndexer(indexerConfig));
   }
   const firstIndexer = indexers.get(tokenAddresses[0]);
-  const chainAddresses = getContractAddresses7(config.chainId);
+  const chainAddresses = getContractAddresses8(config.chainId);
   const resolvedContracts = {
     batchExecutor: chainAddresses.batchExecutor,
     usdt: chainAddresses.usdt,
@@ -3256,11 +3330,11 @@ function createIssuerService(config) {
 }
 
 // src/issuer-state/validator.ts
-import { getAddress as getAddress10 } from "viem";
+import { getAddress as getAddress11 } from "viem";
 import {
   POINT_TOKEN_V2_ABI as POINT_TOKEN_V2_ABI3,
   issuerRegistryGetIssuerFlatAbi,
-  getContractAddresses as getContractAddresses8
+  getContractAddresses as getContractAddresses9
 } from "@pafi-dev/core";
 var ISSUER_RECORD_TTL_MS = 3e4;
 var IssuerStateValidator = class _IssuerStateValidator {
@@ -3278,7 +3352,7 @@ var IssuerStateValidator = class _IssuerStateValidator {
    * `CONTRACT_ADDRESSES` map for the given chain.
    */
   static forChain(provider, chainId) {
-    const { issuerRegistry } = getContractAddresses8(chainId);
+    const { issuerRegistry } = getContractAddresses9(chainId);
     return new _IssuerStateValidator(provider, issuerRegistry);
   }
   /**
@@ -3287,7 +3361,7 @@ var IssuerStateValidator = class _IssuerStateValidator {
    */
   invalidate(pointToken) {
     if (pointToken) {
-      const key = getAddress10(pointToken);
+      const key = getAddress11(pointToken);
       this.pointTokenIssuerCache.delete(key);
       this.stateCache.delete(key);
       this.inflight.delete(key);
@@ -3302,7 +3376,7 @@ var IssuerStateValidator = class _IssuerStateValidator {
    * The issuer field is set at `initialize()` and never changes.
    */
   async getIssuerAddressForPointToken(pointToken) {
-    const key = getAddress10(pointToken);
+    const key = getAddress11(pointToken);
     const cached = this.pointTokenIssuerCache.get(key);
     if (cached) return cached;
     const issuer = await this.provider.readContract({
@@ -3310,15 +3384,15 @@ var IssuerStateValidator = class _IssuerStateValidator {
       abi: POINT_TOKEN_V2_ABI3,
       functionName: "issuer"
     });
-    this.pointTokenIssuerCache.set(key, getAddress10(issuer));
-    return getAddress10(issuer);
+    this.pointTokenIssuerCache.set(key, getAddress11(issuer));
+    return getAddress11(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 = getAddress10(pointToken);
+    const tokenAddr = getAddress11(pointToken);
     const now = Date.now();
     const cached = this.stateCache.get(tokenAddr);
     if (cached && cached.expiresAt > now) return cached.value;
@@ -3441,6 +3515,8 @@ export {
   PTRedeemHandler,
   PafiBackendClient,
   PafiBackendError,
+  PafiSdkError,
+  PendingUserOpForbiddenError,
   PendingUserOpNotFoundError,
   PerpDepositError,
   PerpDepositHandler,
@@ -3454,6 +3530,7 @@ export {
   authenticateRequest,
   createIssuerService,
   createNativePtQuoter,
+  createSdkErrorMapper,
   createSubgraphNativeUsdtQuoter,
   createSubgraphPoolsProvider,
   handleClaimStatus,