@pafi-dev/issuer 0.22.1 → 0.24.1

package/dist/index.cjs

@@ -26,6 +26,7 @@ __export(index_exports, {
   BundlerNotConfiguredError: () => BundlerNotConfiguredError,
   BundlerRejectedError: () => BundlerRejectedError,
   BurnIndexer: () => BurnIndexer,
+  BurnIndexerFinalizeError: () => BurnIndexerFinalizeError,
   ConfigurationError: () => ConfigurationError,
   DEFAULT_REDEMPTION_POLICY: () => DEFAULT_REDEMPTION_POLICY,
   DefaultPolicyEngine: () => DefaultPolicyEngine,
@@ -57,6 +58,7 @@ __export(index_exports, {
   PerpDepositError: () => PerpDepositError,
   PerpDepositHandler: () => PerpDepositHandler,
   PointIndexer: () => PointIndexer,
+  PointIndexerFinalizeError: () => PointIndexerFinalizeError,
   PointTokenDomainResolver: () => PointTokenDomainResolver,
   PolicyProvider: () => PolicyProvider,
   REDEMPTION_HISTORY_WINDOW_SEC: () => REDEMPTION_HISTORY_WINDOW_SEC,
@@ -908,6 +910,7 @@ var RelayService = class {
         "prepareMint: deadline exceeds maximum allowed window (1 hour)"
       );
     }
+    const MINT_SOURCE = import_core5.Source.EQUITY;
     const useWrapper = params.mintFeeWrapperAddress !== void 0;
     const receiverForSig = useWrapper ? params.mintFeeWrapperAddress : params.userAddress;
     let minterSig;
@@ -919,6 +922,7 @@ var RelayService = class {
           user: params.userAddress,
           receiver: receiverForSig,
           amount: params.amount,
+          source: MINT_SOURCE,
           nonce: params.mintRequestNonce,
           deadline: params.deadline
         }
@@ -949,9 +953,15 @@ var RelayService = class {
         mintTarget = params.mintFeeWrapperAddress;
       } else {
         mintCallData = (0, import_viem3.encodeFunctionData)({
-          abi: import_core5.POINT_TOKEN_ABI,
+          abi: import_core5.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;
       }
@@ -1036,11 +1046,12 @@ var RelayService = class {
     let burnCallData;
     try {
       burnCallData = (0, import_viem3.encodeFunctionData)({
-        abi: import_core5.POINT_TOKEN_ABI,
+        abi: import_core5.POINT_TOKEN_BURN_SIG_ABI,
         functionName: "burn",
         args: [
           params.burnRequest.from,
           params.burnRequest.amount,
+          params.burnRequest.source,
           params.burnRequest.deadline,
           params.burnerSignature
         ]
@@ -1135,11 +1146,12 @@ var RelayService = class {
       mintTarget = params.mintFeeWrapperAddress;
     } else {
       mintCallData = (0, import_viem3.encodeFunctionData)({
-        abi: import_core5.POINT_TOKEN_ABI,
+        abi: import_core5.POINT_TOKEN_MINT_SIG_ABI,
         functionName: "mint",
         args: [
           params.userAddress,
           params.amount,
+          import_core5.Source.EQUITY,
           params.deadline,
           PLACEHOLDER_SIG_65
         ]
@@ -1161,11 +1173,12 @@ var RelayService = class {
   /** Burn-side mirror of `previewMintUserOp`. */
   previewBurnUserOp(params) {
     const burnCallData = (0, import_viem3.encodeFunctionData)({
-      abi: import_core5.POINT_TOKEN_ABI,
+      abi: import_core5.POINT_TOKEN_BURN_SIG_ABI,
       functionName: "burn",
       args: [
         params.userAddress,
         params.amount,
+        import_core5.Source.EQUITY,
         params.deadline,
         PLACEHOLDER_SIG_65
       ]
@@ -1357,18 +1370,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
 var import_viem4 = require("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 = (0, import_viem4.parseAbiItem)(
   "event Transfer(address indexed from, address indexed to, uint256 value)"
 );
@@ -1594,8 +1631,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);
@@ -1617,6 +1664,16 @@ function pickMatchingLock(locks, amount) {
 
 // src/indexer/burnIndexer.ts
 var import_viem5 = require("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 = (0, import_viem5.parseAbiItem)(
   "event Transfer(address indexed from, address indexed to, uint256 value)"
 );
@@ -1628,7 +1685,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;
@@ -1784,7 +1841,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
+      );
     }
   }
 };
@@ -2426,10 +2494,12 @@ var PTRedeemHandler = class {
       chainId: this.chainId,
       verifyingContract: pointTokenAddress
     };
+    const BURN_SOURCE = import_core7.Source.EQUITY;
     const sponsoredBurnAmount = request.amount - fee;
     const sponsoredBurnRequest = {
       from: request.userAddress,
       amount: sponsoredBurnAmount,
+      source: BURN_SOURCE,
       nonce: burnNonce,
       deadline
     };
@@ -2465,6 +2535,7 @@ var PTRedeemHandler = class {
         const fallbackBurnRequest = {
           from: request.userAddress,
           amount: request.amount,
+          source: BURN_SOURCE,
           nonce: burnNonce,
           deadline
         };
@@ -4757,6 +4828,13 @@ async function createIssuerService(config) {
   const sdkWrapperAddress = (0, import_core18.getContractAddresses)(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 = {
@@ -4770,8 +4848,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;
@@ -4967,22 +5047,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()
         }
       );
@@ -4998,33 +5078,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([
-      (0, import_core19.getTokenCap)(this.provider, issuer.mintingOracle, tokenAddr),
-      this.provider.readContract({
-        address: tokenAddr,
-        abi: import_core19.POINT_TOKEN_ABI,
-        functionName: "totalSupply"
-      })
-    ]);
-    const tokenCapRecord = {
-      declaredTotalSupply: tokenCap.declaredTotalSupply,
-      capBasisPoints: tokenCap.capBasisPoints
+    const equitySupply = await this.provider.readContract({
+      address: tokenAddr,
+      abi: import_core19.POINT_TOKEN_ABI,
+      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
     };
   }
@@ -5067,7 +5142,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";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AdapterMisconfiguredError,
@@ -5076,6 +5151,7 @@ var PAFI_ISSUER_SDK_VERSION = true ? "0.22.1" : "dev";
   BundlerNotConfiguredError,
   BundlerRejectedError,
   BurnIndexer,
+  BurnIndexerFinalizeError,
   ConfigurationError,
   DEFAULT_REDEMPTION_POLICY,
   DefaultPolicyEngine,
@@ -5107,6 +5183,7 @@ var PAFI_ISSUER_SDK_VERSION = true ? "0.22.1" : "dev";
   PerpDepositError,
   PerpDepositHandler,
   PointIndexer,
+  PointIndexerFinalizeError,
   PointTokenDomainResolver,
   PolicyProvider,
   REDEMPTION_HISTORY_WINDOW_SEC,