@pafi-dev/issuer 0.5.28 → 0.5.30

package/dist/index.d.cts

@@ -1730,6 +1730,26 @@ interface PendingUserOpEntry {
     chainId: number;
     /** Hex-encoded userOpHash — the value the user signed via personal_sign. */
     userOpHash: Hex;
+    /**
+     * Fee-stripped fallback variant. Set by `/claim/prepare` and
+     * `/redeem/prepare` when a PT operator fee is configured AND the
+     * paymaster sponsorship attached successfully — i.e. the user might
+     * still want to submit without paymaster (paying ETH gas), and in
+     * that case shouldn't be charged the PT fee. `/claim/submit` reads
+     * this branch when its request body specifies
+     * `variant: "fallback"`.
+     *
+     * Has a different `callData` (no PT.transfer prepended) and
+     * therefore a different `userOpHash`. Paymaster fields are NOT
+     * present — the fallback is by definition unsponsored.
+     */
+    fallback?: {
+        callData: Hex;
+        callGasLimit: string;
+        verificationGasLimit: string;
+        preVerificationGas: string;
+        userOpHash: Hex;
+    };
 }
 /**
  * Storage backend for pending UserOps in the mobile prepare/submit pattern.
@@ -1755,7 +1775,7 @@ interface IPendingUserOpStore {
  * Bridges the gap between the serialized storage format (decimal strings,
  * safe for JSON/Redis) and `serializeUserOpToJsonRpc` which expects bigints.
  */
-declare function serializeEntryToJsonRpc(entry: PendingUserOpEntry, signature: Hex): Record<string, string | null>;
+declare function serializeEntryToJsonRpc(entry: PendingUserOpEntry, signature: Hex, variant?: "sponsored" | "fallback"): Record<string, string | null>;
 
 interface IssuerRegistryRecord {
     issuerAddress: Address;

package/dist/index.d.ts

@@ -1730,6 +1730,26 @@ interface PendingUserOpEntry {
     chainId: number;
     /** Hex-encoded userOpHash — the value the user signed via personal_sign. */
     userOpHash: Hex;
+    /**
+     * Fee-stripped fallback variant. Set by `/claim/prepare` and
+     * `/redeem/prepare` when a PT operator fee is configured AND the
+     * paymaster sponsorship attached successfully — i.e. the user might
+     * still want to submit without paymaster (paying ETH gas), and in
+     * that case shouldn't be charged the PT fee. `/claim/submit` reads
+     * this branch when its request body specifies
+     * `variant: "fallback"`.
+     *
+     * Has a different `callData` (no PT.transfer prepended) and
+     * therefore a different `userOpHash`. Paymaster fields are NOT
+     * present — the fallback is by definition unsponsored.
+     */
+    fallback?: {
+        callData: Hex;
+        callGasLimit: string;
+        verificationGasLimit: string;
+        preVerificationGas: string;
+        userOpHash: Hex;
+    };
 }
 /**
  * Storage backend for pending UserOps in the mobile prepare/submit pattern.
@@ -1755,7 +1775,7 @@ interface IPendingUserOpStore {
  * Bridges the gap between the serialized storage format (decimal strings,
  * safe for JSON/Redis) and `serializeUserOpToJsonRpc` which expects bigints.
  */
-declare function serializeEntryToJsonRpc(entry: PendingUserOpEntry, signature: Hex): Record<string, string | null>;
+declare function serializeEntryToJsonRpc(entry: PendingUserOpEntry, signature: Hex, variant?: "sponsored" | "fallback"): Record<string, string | null>;
 
 interface IssuerRegistryRecord {
     issuerAddress: Address;

package/dist/index.js

@@ -2280,7 +2280,28 @@ function createIssuerService(config) {
 
 // src/userop-store/serialize.ts
 import { serializeUserOpToJsonRpc } from "@pafi-dev/core";
-function serializeEntryToJsonRpc(entry, signature) {
+function serializeEntryToJsonRpc(entry, signature, variant = "sponsored") {
+  if (variant === "fallback") {
+    if (!entry.fallback) {
+      throw new Error(
+        "serializeEntryToJsonRpc: variant=fallback requested but the stored entry has no `fallback` branch \u2014 caller should resubmit with variant='sponsored' or re-prepare with a fee configured."
+      );
+    }
+    return serializeUserOpToJsonRpc(
+      {
+        sender: entry.sender,
+        nonce: BigInt(entry.nonce),
+        callData: entry.fallback.callData,
+        callGasLimit: BigInt(entry.fallback.callGasLimit),
+        verificationGasLimit: BigInt(entry.fallback.verificationGasLimit),
+        preVerificationGas: BigInt(entry.fallback.preVerificationGas),
+        maxFeePerGas: BigInt(entry.maxFeePerGas),
+        maxPriorityFeePerGas: BigInt(entry.maxPriorityFeePerGas)
+        // intentionally no paymaster — user pays ETH gas
+      },
+      signature
+    );
+  }
   return serializeUserOpToJsonRpc(
     {
       sender: entry.sender,