@pafi-dev/issuer 0.31.0 → 0.33.0

package/dist/index.cjs

@@ -2414,11 +2414,23 @@ var PTRedeemHandler = class {
       );
     }
     if (this.redemptionService) {
-      const decision = await this.redemptionService.evaluate(
-        request.userAddress,
-        request.amount,
-        pointTokenAddress
-      );
+      let decision;
+      try {
+        decision = await this.redemptionService.evaluate(
+          request.userAddress,
+          request.amount,
+          pointTokenAddress
+        );
+      } catch (err) {
+        const code = err && typeof err === "object" && "code" in err ? err.code : void 0;
+        if (code === "POLICY_PROVIDER_UNAVAILABLE") {
+          throw new PTRedeemError(
+            "REDEMPTION_POLICY_UNAVAILABLE",
+            "Redemption policy temporarily unavailable \u2014 please try again shortly."
+          );
+        }
+        throw err;
+      }
       if (!decision.allowed) {
         const denial = decision.denial;
         throw new PTRedeemError(
@@ -2634,6 +2646,45 @@ var PTRedeemHandler = class {
 };
 
 // src/api/statusHandlers.ts
+var DEFAULT_STATUS_CONFIRMATIONS = 3;
+async function isReceiptPastConfirmations(receipt, provider, confirmations, onWarning, handlerName) {
+  if (!provider) {
+    onWarning?.(
+      `${handlerName}: provider missing \u2014 cannot enforce confirmation depth; deferring receipt fallback to on-chain indexer (audit PACI5-13).`
+    );
+    return false;
+  }
+  if (!receipt.blockNumber) {
+    onWarning?.(
+      `${handlerName}: receipt has no blockNumber \u2014 cannot enforce confirmation depth; deferring to indexer (audit PACI5-13).`
+    );
+    return false;
+  }
+  const requiredConfs = BigInt(confirmations ?? DEFAULT_STATUS_CONFIRMATIONS);
+  let receiptBlock;
+  try {
+    receiptBlock = BigInt(receipt.blockNumber);
+  } catch {
+    onWarning?.(
+      `${handlerName}: malformed receipt blockNumber (${receipt.blockNumber}) \u2014 deferring to indexer (audit PACI5-13).`
+    );
+    return false;
+  }
+  let head;
+  try {
+    head = await provider.getBlockNumber();
+  } catch (err) {
+    onWarning?.(
+      `${handlerName}: getBlockNumber failed (${err instanceof Error ? err.message : String(err)}) \u2014 deferring to indexer (audit PACI5-13).`
+    );
+    return false;
+  }
+  const depth = head - receiptBlock;
+  if (depth < requiredConfs) {
+    return false;
+  }
+  return true;
+}
 var LockNotFoundError = class extends import_core.PafiSdkError {
   code = "LOCK_NOT_FOUND";
   httpStatus = "not_found";
@@ -2662,6 +2713,23 @@ async function handleClaimStatus(params) {
         lock.userOpHash
       );
       if (receipt) {
+        const passesConfirmationDepth = await isReceiptPastConfirmations(
+          receipt,
+          params.provider,
+          params.confirmations,
+          params.onWarning,
+          "handleClaimStatus"
+        );
+        if (!passesConfirmationDepth) {
+          return {
+            lockId: lock.lockId,
+            status: "PENDING",
+            txHash: lock.txHash ?? null,
+            amount: lock.amount.toString(),
+            createdAt: new Date(lock.createdAt).toISOString(),
+            expiresAt: new Date(lock.expiresAt).toISOString()
+          };
+        }
         if (receipt.success && receipt.txHash) {
           if (!lock.tokenAddress) {
             params.onWarning?.(
@@ -2736,14 +2804,23 @@ async function handleRedeemStatus(params) {
         credit.userOpHash
       );
       if (receipt && receipt.success) {
-        status = "RESOLVED";
-        txHash = receipt.txHash;
-        if (params.ledger.resolveCreditByBurnTx) {
-          await params.ledger.resolveCreditByBurnTx(credit.lockId, receipt.txHash).catch((err) => {
-            params.onWarning?.(
-              `handleRedeemStatus: resolveCreditByBurnTx failed for lock ${credit.lockId}: ${err}`
-            );
-          });
+        const passesConfirmationDepth = await isReceiptPastConfirmations(
+          receipt,
+          params.provider,
+          params.confirmations,
+          params.onWarning,
+          "handleRedeemStatus"
+        );
+        if (passesConfirmationDepth) {
+          status = "RESOLVED";
+          txHash = receipt.txHash;
+          if (params.ledger.resolveCreditByBurnTx) {
+            await params.ledger.resolveCreditByBurnTx(credit.lockId, receipt.txHash).catch((err) => {
+              params.onWarning?.(
+                `handleRedeemStatus: resolveCreditByBurnTx failed for lock ${credit.lockId}: ${err}`
+              );
+            });
+          }
         }
       }
     } catch (err) {
@@ -3872,10 +3949,6 @@ var IssuerApiAdapter = class {
       pointTokenAddress,
       redeemResponse.expiresInSeconds,
       input.eip7702Auth,
-      // Audit PACI5-21 — fallback path reserves a separate
-      // PendingCredit row for the full `amount`. Surface its lockId so
-      // mobile FE can poll the correct row + `handleMobileSubmit`
-      // routes the userOpHash bind to it on fallback submit.
       redeemResponse.fallback?.lockId
     );
     return {
@@ -3911,6 +3984,9 @@ var IssuerApiAdapter = class {
       userAddress: authenticatedAddress,
       ledger: this.cfg.ledger,
       pafiBackendClient: this.cfg.pafiBackendClient,
+      // Audit PACI5-13 — pass the same provider the indexers use so
+      // the receipt fallback gates on the same reorg depth.
+      provider: this.cfg.provider,
       onWarning: this.cfg.onWarning
     });
   }
@@ -3920,6 +3996,8 @@ var IssuerApiAdapter = class {
       userAddress: authenticatedAddress,
       ledger: this.cfg.ledger,
       pafiBackendClient: this.cfg.pafiBackendClient,
+      // Audit PACI5-13 — see claimStatus comment.
+      provider: this.cfg.provider,
       onWarning: this.cfg.onWarning
     });
   }
@@ -4454,7 +4532,9 @@ var PafiBackendClient = class {
     if (!config.issuerId) throw new Error("PafiBackendClient: issuerId is required");
     if (!config.apiKey) throw new Error("PafiBackendClient: apiKey is required");
     this.config = config;
-    this.baseUrl = (0, import_core16.getPafiServiceUrls)(config.chainId).sponsorRelayer;
+    this.baseUrl = (0, import_core16.getPafiServiceUrls)(config.chainId, {
+      sponsorRelayer: config.baseUrl
+    }).sponsorRelayer;
   }
   async requestSponsorship(request) {
     const maxAttempts = this.config.retry?.maxAttempts ?? 1;
@@ -4615,7 +4695,7 @@ var PafiBackendClient = class {
 
 // src/config.ts
 var import_viem15 = require("viem");
-var import_core18 = require("@pafi-dev/core");
+var import_core19 = require("@pafi-dev/core");
 
 // src/redemption/evaluator.ts
 var SECONDS_PER_DAY = 24 * 60 * 60;
@@ -4719,6 +4799,9 @@ function nextBlackoutEndAfter(windows, nowUnixSec) {
 }
 var REDEMPTION_HISTORY_WINDOW_SEC = SECONDS_PER_DAY;
 
+// src/redemption/policyProvider.ts
+var import_core18 = require("@pafi-dev/core");
+
 // src/redemption/settlementClient.ts
 var import_core17 = require("@pafi-dev/core");
 var DEFAULT_TIMEOUT_MS = 1e3;
@@ -4729,7 +4812,9 @@ var SettlementClient = class {
     if (!config.issuerId) throw new Error("SettlementClient: issuerId is required");
     if (!config.apiKey) throw new Error("SettlementClient: apiKey is required");
     this.config = {
-      baseUrl: (0, import_core17.getPafiServiceUrls)(config.chainId).issuerApi.replace(/\/+$/, ""),
+      baseUrl: (0, import_core17.getPafiServiceUrls)(config.chainId, {
+        issuerApi: config.baseUrl
+      }).issuerApi.replace(/\/+$/, ""),
       issuerId: config.issuerId,
       apiKey: config.apiKey,
       fetchTimeoutMs: config.fetchTimeoutMs ?? DEFAULT_TIMEOUT_MS,
@@ -4833,10 +4918,23 @@ function defaultPolicyFor(issuerId) {
 
 // src/redemption/policyProvider.ts
 var DEFAULT_CACHE_TTL_MS3 = 5 * 60 * 1e3;
+var PolicyProviderUnavailableError = class extends import_core18.PafiSdkError {
+  code = "POLICY_PROVIDER_UNAVAILABLE";
+  httpStatus = "service_unavailable";
+  details;
+  constructor(issuerId, reason) {
+    super(
+      `Redemption policy provider unavailable for issuer ${issuerId}: ${reason}. Pre-flight redeem limit cannot be enforced \u2014 refusing to sign BurnRequest. Mobile FE: surface "try again shortly" and retry with backoff.`
+    );
+    this.details = { issuerId, reason };
+  }
+};
 var PolicyProvider = class {
   client;
   issuerId;
   cacheTtlMs;
+  onFetchFailure;
+  onWarning;
   now;
   cache = null;
   inflight = null;
@@ -4844,6 +4942,8 @@ var PolicyProvider = class {
     this.client = new SettlementClient(config);
     this.issuerId = config.issuerId;
     this.cacheTtlMs = config.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS3;
+    this.onFetchFailure = config.onFetchFailure ?? "fail-closed";
+    this.onWarning = config.onWarning;
     this.now = config.now ?? (() => Date.now());
   }
   async getPolicy() {
@@ -4876,7 +4976,19 @@ var PolicyProvider = class {
       };
       return { policy: result.policy, source: "settlement" };
     }
-    return { policy: defaultPolicyFor(this.issuerId), source: "default" };
+    const reason = "reason" in result && typeof result.reason === "string" ? result.reason : "unknown";
+    if (this.onFetchFailure === "permissive-default") {
+      this.onWarning?.(
+        "PolicyProvider: settlement-api unreachable, falling back to permissive default. Pre-flight redeem limit is DEGRADED until settlement-api recovers.",
+        {
+          event: "policy_provider_fallback",
+          issuerId: this.issuerId,
+          reason
+        }
+      );
+      return { policy: defaultPolicyFor(this.issuerId), source: "default" };
+    }
+    throw new PolicyProviderUnavailableError(this.issuerId, reason);
   }
 };
 
@@ -4966,7 +5078,7 @@ async function createIssuerService(config) {
       provider: config.provider
     });
   }
-  const sdkWrapperAddress = (0, import_core18.getContractAddresses)(config.chainId).mintFeeWrapper;
+  const sdkWrapperAddress = (0, import_core19.getContractAddresses)(config.chainId).mintFeeWrapper;
   const wrapperOverride = config.indexer?.mintFeeWrapperAddress;
   const resolvedWrapperAddress = wrapperOverride !== void 0 ? wrapperOverride : sdkWrapperAddress;
   const baseCursorStore = config.indexer?.cursorStore;
@@ -5005,7 +5117,7 @@ async function createIssuerService(config) {
     }
     indexers.set(tokenAddress, new PointIndexer(indexerConfig));
   }
-  const chainAddresses = (0, import_core18.getContractAddresses)(config.chainId);
+  const chainAddresses = (0, import_core19.getContractAddresses)(config.chainId);
   const resolvedContracts = {
     batchExecutor: chainAddresses.batchExecutor,
     usdt: chainAddresses.usdt,
@@ -5023,6 +5135,15 @@ async function createIssuerService(config) {
       issuerId: config.redemption.issuerId,
       apiKey: config.redemption.apiKey
     };
+    if (config.redemption.baseUrl) {
+      policyConfig.baseUrl = config.redemption.baseUrl;
+    }
+    if (config.redemption.onFetchFailure) {
+      policyConfig.onFetchFailure = config.redemption.onFetchFailure;
+    }
+    if (config.redemption.onPolicyWarning) {
+      policyConfig.onWarning = config.redemption.onPolicyWarning;
+    }
     if (config.redemption.fetchImpl) policyConfig.fetchImpl = config.redemption.fetchImpl;
     if (config.redemption.fetchTimeoutMs !== void 0) {
       policyConfig.fetchTimeoutMs = config.redemption.fetchTimeoutMs;
@@ -5088,7 +5209,7 @@ async function createIssuerService(config) {
 
 // src/issuer-state/validator.ts
 var import_viem16 = require("viem");
-var import_core19 = require("@pafi-dev/core");
+var import_core20 = require("@pafi-dev/core");
 var ISSUER_RECORD_TTL_MS = 3e4;
 var IssuerStateValidator = class _IssuerStateValidator {
   constructor(provider, registryAddress) {
@@ -5105,7 +5226,7 @@ var IssuerStateValidator = class _IssuerStateValidator {
    * `CONTRACT_ADDRESSES` map for the given chain.
    */
   static forChain(provider, chainId) {
-    const { issuerRegistry } = (0, import_core19.getContractAddresses)(chainId);
+    const { issuerRegistry } = (0, import_core20.getContractAddresses)(chainId);
     return new _IssuerStateValidator(provider, issuerRegistry);
   }
   /**
@@ -5134,7 +5255,7 @@ var IssuerStateValidator = class _IssuerStateValidator {
     if (cached) return cached;
     const issuer = await this.provider.readContract({
       address: key,
-      abi: import_core19.POINT_TOKEN_ABI,
+      abi: import_core20.POINT_TOKEN_ABI,
       functionName: "issuer"
     });
     this.pointTokenIssuerCache.set(key, (0, import_viem16.getAddress)(issuer));
@@ -5214,7 +5335,7 @@ var IssuerStateValidator = class _IssuerStateValidator {
     const issuerAddr = await this.getIssuerAddressForPointToken(tokenAddr);
     const issuerStruct = await this.provider.readContract({
       address: this.registryAddress,
-      abi: import_core19.issuerRegistryAbi,
+      abi: import_core20.issuerRegistryAbi,
       functionName: "getIssuer",
       args: [issuerAddr]
     });
@@ -5227,7 +5348,7 @@ var IssuerStateValidator = class _IssuerStateValidator {
     };
     const equitySupply = await this.provider.readContract({
       address: tokenAddr,
-      abi: import_core19.POINT_TOKEN_ABI,
+      abi: import_core20.POINT_TOKEN_ABI,
       functionName: "equitySupply"
     });
     const hardCap = issuer.capitalBase * BigInt(issuer.basisPoints) / 10000n;
@@ -5283,7 +5404,7 @@ var MemoryRedemptionHistoryStore = class {
 };
 
 // src/index.ts
-var PAFI_ISSUER_SDK_VERSION = true ? "0.31.0" : "dev";
+var PAFI_ISSUER_SDK_VERSION = true ? "0.33.0" : "dev";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AdapterMisconfiguredError,