@pafi-dev/issuer 0.22.1 → 0.24.1

package/dist/index.js

@@ -579,12 +579,14 @@ import {
   erc20Abi
 } from "viem";
 import {
-  POINT_TOKEN_ABI,
+  POINT_TOKEN_MINT_SIG_ABI,
+  POINT_TOKEN_BURN_SIG_ABI,
   mintFeeWrapperAbi,
   buildPartialUserOperation,
   signMintRequest,
   getContractAddresses,
-  quoteOperatorFeePt
+  quoteOperatorFeePt,
+  Source
 } from "@pafi-dev/core";
 var RelayService = class {
   provider;
@@ -673,6 +675,7 @@ var RelayService = class {
         "prepareMint: deadline exceeds maximum allowed window (1 hour)"
       );
     }
+    const MINT_SOURCE = Source.EQUITY;
     const useWrapper = params.mintFeeWrapperAddress !== void 0;
     const receiverForSig = useWrapper ? params.mintFeeWrapperAddress : params.userAddress;
     let minterSig;
@@ -684,6 +687,7 @@ var RelayService = class {
           user: params.userAddress,
           receiver: receiverForSig,
           amount: params.amount,
+          source: MINT_SOURCE,
           nonce: params.mintRequestNonce,
           deadline: params.deadline
         }
@@ -714,9 +718,15 @@ var RelayService = class {
         mintTarget = params.mintFeeWrapperAddress;
       } else {
         mintCallData = encodeFunctionData({
-          abi: POINT_TOKEN_ABI,
+          abi: POINT_TOKEN_MINT_SIG_ABI,
           functionName: "mint",
-          args: [params.userAddress, params.amount, params.deadline, minterSig]
+          args: [
+            params.userAddress,
+            params.amount,
+            MINT_SOURCE,
+            params.deadline,
+            minterSig
+          ]
         });
         mintTarget = params.pointTokenAddress;
       }
@@ -801,11 +811,12 @@ var RelayService = class {
     let burnCallData;
     try {
       burnCallData = encodeFunctionData({
-        abi: POINT_TOKEN_ABI,
+        abi: POINT_TOKEN_BURN_SIG_ABI,
         functionName: "burn",
         args: [
           params.burnRequest.from,
           params.burnRequest.amount,
+          params.burnRequest.source,
           params.burnRequest.deadline,
           params.burnerSignature
         ]
@@ -900,11 +911,12 @@ var RelayService = class {
       mintTarget = params.mintFeeWrapperAddress;
     } else {
       mintCallData = encodeFunctionData({
-        abi: POINT_TOKEN_ABI,
+        abi: POINT_TOKEN_MINT_SIG_ABI,
         functionName: "mint",
         args: [
           params.userAddress,
           params.amount,
+          Source.EQUITY,
           params.deadline,
           PLACEHOLDER_SIG_65
         ]
@@ -926,11 +938,12 @@ var RelayService = class {
   /** Burn-side mirror of `previewMintUserOp`. */
   previewBurnUserOp(params) {
     const burnCallData = encodeFunctionData({
-      abi: POINT_TOKEN_ABI,
+      abi: POINT_TOKEN_BURN_SIG_ABI,
       functionName: "burn",
       args: [
         params.userAddress,
         params.amount,
+        Source.EQUITY,
         params.deadline,
         PLACEHOLDER_SIG_65
       ]
@@ -1122,18 +1135,42 @@ function createPafiEstimatorClient(config) {
 }
 
 // src/indexer/types.ts
-var InMemoryCursorStore = class {
+var InMemoryCursorStore = class _InMemoryCursorStore {
   cursor;
+  /**
+   * Child stores keyed by `forKey()`. Each child has its own cursor
+   * (the H-05 fix), so a single InMemoryCursorStore can back N
+   * PointIndexers in tests / single-process callers.
+   */
+  children = /* @__PURE__ */ new Map();
   async load() {
     return this.cursor;
   }
   async save(blockNumber) {
     this.cursor = blockNumber;
   }
+  forKey(key) {
+    let child = this.children.get(key);
+    if (!child) {
+      child = new _InMemoryCursorStore();
+      this.children.set(key, child);
+    }
+    return child;
+  }
 };
 
 // src/indexer/pointIndexer.ts
 import { getAddress as getAddress3, parseAbiItem } from "viem";
+var PointIndexerFinalizeError = class extends Error {
+  constructor(message, context, cause) {
+    super(message);
+    this.context = context;
+    this.cause = cause;
+    this.name = "PointIndexerFinalizeError";
+  }
+  context;
+  cause;
+};
 var TRANSFER_EVENT = parseAbiItem(
   "event Transfer(address indexed from, address indexed to, uint256 value)"
 );
@@ -1359,8 +1396,18 @@ var PointIndexer = class {
         evt.txHash,
         this.pointTokenAddress
       );
-    } catch {
-      return;
+    } catch (err) {
+      throw new PointIndexerFinalizeError(
+        `PointIndexer.deductBalance failed for tx ${evt.txHash} (to=${evt.to}, amount=${evt.amount}, block=${evt.blockNumber}); cursor will NOT advance, next tick retries.`,
+        {
+          pointToken: this.pointTokenAddress,
+          to: evt.to,
+          amount: evt.amount,
+          txHash: evt.txHash,
+          blockNumber: evt.blockNumber
+        },
+        err
+      );
     }
     try {
       await this.ledger.updateMintStatus(match.lockId, "MINTED", evt.txHash);
@@ -1382,6 +1429,16 @@ function pickMatchingLock(locks, amount) {
 
 // src/indexer/burnIndexer.ts
 import { getAddress as getAddress4, parseAbiItem as parseAbiItem2 } from "viem";
+var BurnIndexerFinalizeError = class extends Error {
+  constructor(message, context, cause) {
+    super(message);
+    this.context = context;
+    this.cause = cause;
+    this.name = "BurnIndexerFinalizeError";
+  }
+  context;
+  cause;
+};
 var TRANSFER_EVENT2 = parseAbiItem2(
   "event Transfer(address indexed from, address indexed to, uint256 value)"
 );
@@ -1393,7 +1450,7 @@ var BurnIndexer = class {
   provider;
   /**
    * The PointToken this indexer watches. Exposed so callers can key
-   * leader-election locks / cursor stores by token (audit H-04 fix).
+   * leader-election locks / cursor stores by token
    */
   pointTokenAddress;
   ledger;
@@ -1549,7 +1606,18 @@ var BurnIndexer = class {
     try {
       await this.ledger.resolveCreditByBurnTx(lockId, evt.txHash);
     } catch (err) {
-      console.error("[PAFI] BurnIndexer finalize error \u2014 credit may be lost:", err);
+      throw new BurnIndexerFinalizeError(
+        `BurnIndexer.resolveCreditByBurnTx failed for tx ${evt.txHash} (lockId=${lockId}, from=${evt.from}, amount=${evt.amount}, block=${evt.blockNumber}); cursor will NOT advance, next tick retries.`,
+        {
+          pointToken: this.pointTokenAddress,
+          from: evt.from,
+          amount: evt.amount,
+          txHash: evt.txHash,
+          blockNumber: evt.blockNumber,
+          lockId
+        },
+        err
+      );
     }
   }
 };
@@ -2013,9 +2081,10 @@ var PointTokenDomainResolver = class {
 import { getAddress as getAddress7 } from "viem";
 import {
   signBurnRequest,
-  POINT_TOKEN_ABI as POINT_TOKEN_ABI2,
+  POINT_TOKEN_ABI,
   getPointTokenBalance as getPointTokenBalance2,
-  getContractAddresses as getContractAddresses2
+  getContractAddresses as getContractAddresses2,
+  Source as Source2
 } from "@pafi-dev/core";
 var DEFAULT_REDEEM_LOCK_MS = 15 * 60 * 1e3;
 var DEFAULT_SIG_DEADLINE_SEC = 15 * 60;
@@ -2119,7 +2188,7 @@ var PTRedeemHandler = class {
     try {
       burnNonce = await this.provider.readContract({
         address: pointTokenAddress,
-        abi: POINT_TOKEN_ABI2,
+        abi: POINT_TOKEN_ABI,
         functionName: "burnRequestNonces",
         args: [request.userAddress]
       });
@@ -2201,10 +2270,12 @@ var PTRedeemHandler = class {
       chainId: this.chainId,
       verifyingContract: pointTokenAddress
     };
+    const BURN_SOURCE = Source2.EQUITY;
     const sponsoredBurnAmount = request.amount - fee;
     const sponsoredBurnRequest = {
       from: request.userAddress,
       amount: sponsoredBurnAmount,
+      source: BURN_SOURCE,
       nonce: burnNonce,
       deadline
     };
@@ -2240,6 +2311,7 @@ var PTRedeemHandler = class {
         const fallbackBurnRequest = {
           from: request.userAddress,
           amount: request.amount,
+          source: BURN_SOURCE,
           nonce: burnNonce,
           deadline
         };
@@ -4567,6 +4639,13 @@ async function createIssuerService(config) {
   const sdkWrapperAddress = getContractAddresses7(config.chainId).mintFeeWrapper;
   const wrapperOverride = config.indexer?.mintFeeWrapperAddress;
   const resolvedWrapperAddress = wrapperOverride !== void 0 ? wrapperOverride : sdkWrapperAddress;
+  const baseCursorStore = config.indexer?.cursorStore;
+  const sharedCursorWithMultipleTokens = baseCursorStore !== void 0 && typeof baseCursorStore.forKey !== "function" && tokenAddresses.length > 1;
+  if (sharedCursorWithMultipleTokens) {
+    console.warn(
+      `[@pafi-dev/issuer] cursorStore lacks forKey() and ${tokenAddresses.length} PointTokens are configured. All PointIndexers will share one cursor row, causing token-skipping (audit finding H-05). Implement IIndexerCursorStore.forKey to return per-token derived stores. This permissive path will be removed in a future major release.`
+    );
+  }
   const indexers = /* @__PURE__ */ new Map();
   for (const tokenAddress of tokenAddresses) {
     const indexerConfig = {
@@ -4580,8 +4659,10 @@ async function createIssuerService(config) {
     if (config.indexer?.fromBlock !== void 0) {
       indexerConfig.fromBlock = config.indexer.fromBlock;
     }
-    if (config.indexer?.cursorStore) {
-      indexerConfig.cursorStore = config.indexer.cursorStore;
+    if (baseCursorStore) {
+      indexerConfig.cursorStore = typeof baseCursorStore.forKey === "function" ? baseCursorStore.forKey(
+        `point-indexer:${tokenAddress.toLowerCase()}`
+      ) : baseCursorStore;
     }
     if (config.indexer?.confirmations !== void 0) {
       indexerConfig.confirmations = config.indexer.confirmations;
@@ -4678,10 +4759,9 @@ async function createIssuerService(config) {
 // src/issuer-state/validator.ts
 import { getAddress as getAddress13 } from "viem";
 import {
-  POINT_TOKEN_ABI as POINT_TOKEN_ABI3,
+  POINT_TOKEN_ABI as POINT_TOKEN_ABI2,
   issuerRegistryAbi,
-  getContractAddresses as getContractAddresses8,
-  getTokenCap
+  getContractAddresses as getContractAddresses8
 } from "@pafi-dev/core";
 var ISSUER_RECORD_TTL_MS = 3e4;
 var IssuerStateValidator = class _IssuerStateValidator {
@@ -4728,7 +4808,7 @@ var IssuerStateValidator = class _IssuerStateValidator {
     if (cached) return cached;
     const issuer = await this.provider.readContract({
       address: key,
-      abi: POINT_TOKEN_ABI3,
+      abi: POINT_TOKEN_ABI2,
       functionName: "issuer"
     });
     this.pointTokenIssuerCache.set(key, getAddress13(issuer));
@@ -4782,22 +4862,22 @@ var IssuerStateValidator = class _IssuerStateValidator {
       }
       throw err;
     }
-    const { issuer, totalSupply, hardCap, remaining } = state;
+    const { issuer, equityCap, equitySupply, remaining } = state;
     if (!issuer.active) {
       throw new IssuerStateError(
         "ISSUER_INACTIVE",
-        `Issuer ${issuer.issuerAddress} is deactivated on IssuerRegistry`,
-        { issuer: issuer.issuerAddress, pointToken: issuer.pointToken }
+        `Issuer "${issuer.name}" is deactivated on IssuerRegistry`,
+        { pointToken }
       );
     }
-    if (totalSupply + amount > hardCap) {
+    if (equitySupply + amount > equityCap.hardCap) {
       throw new IssuerStateError(
         "MINT_CAP_EXCEEDED",
-        `Requested ${amount} PT would exceed mint cap. Cap=${hardCap}, minted=${totalSupply}, remaining=${remaining}`,
+        `Requested ${amount} PT would exceed EQUITY mint cap. Cap=${equityCap.hardCap}, equityMinted=${equitySupply}, remaining=${remaining}`,
         {
           requested: amount.toString(),
-          cap: hardCap.toString(),
-          minted: totalSupply.toString(),
+          cap: equityCap.hardCap.toString(),
+          equityMinted: equitySupply.toString(),
           remaining: remaining.toString()
         }
       );
@@ -4813,33 +4893,28 @@ var IssuerStateValidator = class _IssuerStateValidator {
       args: [issuerAddr]
     });
     const issuer = {
-      issuerAddress: issuerStruct.issuerAddress,
       signerAddress: issuerStruct.signerAddress,
       name: issuerStruct.name,
-      symbol: issuerStruct.symbol,
       active: issuerStruct.active,
-      pointToken: issuerStruct.pointToken,
-      mintingOracle: issuerStruct.mintingOracle
+      capitalBase: issuerStruct.capitalBase,
+      basisPoints: Number(issuerStruct.basisPoints)
     };
-    const [tokenCap, totalSupply] = await Promise.all([
-      getTokenCap(this.provider, issuer.mintingOracle, tokenAddr),
-      this.provider.readContract({
-        address: tokenAddr,
-        abi: POINT_TOKEN_ABI3,
-        functionName: "totalSupply"
-      })
-    ]);
-    const tokenCapRecord = {
-      declaredTotalSupply: tokenCap.declaredTotalSupply,
-      capBasisPoints: tokenCap.capBasisPoints
+    const equitySupply = await this.provider.readContract({
+      address: tokenAddr,
+      abi: POINT_TOKEN_ABI2,
+      functionName: "equitySupply"
+    });
+    const hardCap = issuer.capitalBase * BigInt(issuer.basisPoints) / 10000n;
+    const equityCap = {
+      capitalBase: issuer.capitalBase,
+      basisPoints: issuer.basisPoints,
+      hardCap
     };
-    const hardCap = tokenCapRecord.declaredTotalSupply * BigInt(tokenCapRecord.capBasisPoints) / 10000n;
-    const remaining = hardCap > totalSupply ? hardCap - totalSupply : 0n;
+    const remaining = hardCap > equitySupply ? hardCap - equitySupply : 0n;
     return {
       issuer,
-      tokenCap: tokenCapRecord,
-      totalSupply,
-      hardCap,
+      equityCap,
+      equitySupply,
       remaining
     };
   }
@@ -4882,7 +4957,7 @@ var MemoryRedemptionHistoryStore = class {
 };
 
 // src/index.ts
-var PAFI_ISSUER_SDK_VERSION = true ? "0.22.1" : "dev";
+var PAFI_ISSUER_SDK_VERSION = true ? "0.24.1" : "dev";
 export {
   AdapterMisconfiguredError,
   AuthError,
@@ -4890,6 +4965,7 @@ export {
   BundlerNotConfiguredError,
   BundlerRejectedError,
   BurnIndexer,
+  BurnIndexerFinalizeError,
   ConfigurationError,
   DEFAULT_REDEMPTION_POLICY,
   DefaultPolicyEngine,
@@ -4921,6 +4997,7 @@ export {
   PerpDepositError,
   PerpDepositHandler,
   PointIndexer,
+  PointIndexerFinalizeError,
   PointTokenDomainResolver,
   PolicyProvider,
   REDEMPTION_HISTORY_WINDOW_SEC,