@pafi-dev/issuer 0.5.16 → 0.5.18

package/dist/index.d.cts

@@ -1129,16 +1129,30 @@ interface PTRedeemRequest {
     feeRecipient?: Address;
 }
 interface PTRedeemResponse {
-    /** Lock id from the ledger — client polls status with this. */
-    lockId: string;
-    /** Unsigned UserOp — FE attaches paymaster + user signature + submits. */
-    userOp: PartialUserOperation;
     /**
-     * Actual burn amount signed in BurnRequest (= request.amount - feeAmount).
-     * Equals what BurnIndexer credits off-chain. FE uses this as the user-
-     * facing "amount you'll receive" figure.
+     * Sponsored path — UserOp with PT fee transfer. BurnRequest signed for
+     * `request.amount - feeAmount`. User holds exactly `request.amount` PT
+     * and the fee comes out of the redeem amount, NOT on top.
      */
+    lockId: string;
+    userOp: PartialUserOperation;
+    /** = request.amount - feeAmount. What BurnIndexer credits off-chain on sponsored fire. */
     netCreditAmount: bigint;
+    /**
+     * Fallback path — UserOp with NO fee transfer. BurnRequest signed for
+     * full `request.amount`. User pays gas in ETH directly. Present only
+     * when `feeAmount > 0`.
+     *
+     * Same nonce as sponsored: only one of the two can fire on-chain;
+     * the other lock auto-expires after `expiresInSeconds`. BurnIndexer
+     * matches by burn amount and resolves the correct lock.
+     */
+    fallback?: {
+        lockId: string;
+        userOp: PartialUserOperation;
+        /** = request.amount. Full credit when fallback fires. */
+        netCreditAmount: bigint;
+    };
     /** Seconds until the lock expires if the burn doesn't land. */
     expiresInSeconds: number;
     /** The BurnRequest deadline (unix seconds) — FE uses this to surface a countdown. */

package/dist/index.d.ts

@@ -1129,16 +1129,30 @@ interface PTRedeemRequest {
     feeRecipient?: Address;
 }
 interface PTRedeemResponse {
-    /** Lock id from the ledger — client polls status with this. */
-    lockId: string;
-    /** Unsigned UserOp — FE attaches paymaster + user signature + submits. */
-    userOp: PartialUserOperation;
     /**
-     * Actual burn amount signed in BurnRequest (= request.amount - feeAmount).
-     * Equals what BurnIndexer credits off-chain. FE uses this as the user-
-     * facing "amount you'll receive" figure.
+     * Sponsored path — UserOp with PT fee transfer. BurnRequest signed for
+     * `request.amount - feeAmount`. User holds exactly `request.amount` PT
+     * and the fee comes out of the redeem amount, NOT on top.
      */
+    lockId: string;
+    userOp: PartialUserOperation;
+    /** = request.amount - feeAmount. What BurnIndexer credits off-chain on sponsored fire. */
     netCreditAmount: bigint;
+    /**
+     * Fallback path — UserOp with NO fee transfer. BurnRequest signed for
+     * full `request.amount`. User pays gas in ETH directly. Present only
+     * when `feeAmount > 0`.
+     *
+     * Same nonce as sponsored: only one of the two can fire on-chain;
+     * the other lock auto-expires after `expiresInSeconds`. BurnIndexer
+     * matches by burn amount and resolves the correct lock.
+     */
+    fallback?: {
+        lockId: string;
+        userOp: PartialUserOperation;
+        /** = request.amount. Full credit when fallback fires. */
+        netCreditAmount: bigint;
+    };
     /** Seconds until the lock expires if the burn doesn't land. */
     expiresInSeconds: number;
     /** The BurnRequest deadline (unix seconds) — FE uses this to surface a countdown. */

package/dist/index.js

@@ -1379,8 +1379,6 @@ var PTRedeemHandler = class {
         `fee (${fee}) must be strictly less than redeem amount (${request.amount})`
       );
     }
-    const burnAmount = request.amount - fee;
-    const netCreditAmount = burnAmount;
     const onChainBalance = await getPointTokenBalance2(
       this.provider,
       this.pointTokenAddress,
@@ -1400,47 +1398,83 @@ var PTRedeemHandler = class {
       chainId: this.chainId,
       verifyingContract: this.domain.verifyingContract ?? this.pointTokenAddress
     };
-    const burnRequest = {
+    const sponsoredBurnAmount = request.amount - fee;
+    const sponsoredBurnRequest = {
       from: request.userAddress,
-      amount: burnAmount,
+      amount: sponsoredBurnAmount,
       nonce: burnNonce,
       deadline
     };
-    let burnerSignature;
+    let sponsoredSig;
     try {
-      const sig = await signBurnRequest(
-        this.burnerSignerWallet,
-        domain,
-        burnRequest
-      );
-      burnerSignature = sig.serialized;
+      sponsoredSig = (await signBurnRequest(this.burnerSignerWallet, domain, sponsoredBurnRequest)).serialized;
     } catch (err) {
       throw new PTRedeemError(
         "SIGNING_FAILED",
-        `failed to sign BurnRequest: ${err instanceof Error ? err.message : String(err)}`
+        `failed to sign sponsored BurnRequest: ${err instanceof Error ? err.message : String(err)}`
       );
     }
-    const lockId = await this.ledger.reservePendingCredit(
+    const sponsoredLockId = await this.ledger.reservePendingCredit(
       request.userAddress,
-      netCreditAmount,
+      sponsoredBurnAmount,
       this.redeemLockDurationMs,
       this.pointTokenAddress
     );
-    const userOp = this.relayService.prepareBurn({
+    const sponsoredUserOp = this.relayService.prepareBurn({
       mode: "burnWithSig",
       userAddress: request.userAddress,
       aaNonce: request.aaNonce,
       pointTokenAddress: this.pointTokenAddress,
       batchExecutorAddress: this.batchExecutorAddress,
-      burnRequest,
-      burnerSignature,
+      burnRequest: sponsoredBurnRequest,
+      burnerSignature: sponsoredSig,
       feeAmount: fee,
       feeRecipient: request.feeRecipient
     });
+    let fallback = void 0;
+    if (fee > 0n) {
+      const fallbackBurnRequest = {
+        from: request.userAddress,
+        amount: request.amount,
+        nonce: burnNonce,
+        deadline
+      };
+      let fallbackSig;
+      try {
+        fallbackSig = (await signBurnRequest(this.burnerSignerWallet, domain, fallbackBurnRequest)).serialized;
+      } catch (err) {
+        throw new PTRedeemError(
+          "SIGNING_FAILED",
+          `failed to sign fallback BurnRequest: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+      const fallbackLockId = await this.ledger.reservePendingCredit(
+        request.userAddress,
+        request.amount,
+        this.redeemLockDurationMs,
+        this.pointTokenAddress
+      );
+      const fallbackUserOp = this.relayService.prepareBurn({
+        mode: "burnWithSig",
+        userAddress: request.userAddress,
+        aaNonce: request.aaNonce,
+        pointTokenAddress: this.pointTokenAddress,
+        batchExecutorAddress: this.batchExecutorAddress,
+        burnRequest: fallbackBurnRequest,
+        burnerSignature: fallbackSig
+        // No feeAmount/feeRecipient — fallback is fee-free.
+      });
+      fallback = {
+        lockId: fallbackLockId,
+        userOp: fallbackUserOp,
+        netCreditAmount: request.amount
+      };
+    }
     return {
-      lockId,
-      userOp,
-      netCreditAmount,
+      lockId: sponsoredLockId,
+      userOp: sponsoredUserOp,
+      netCreditAmount: sponsoredBurnAmount,
+      fallback,
       expiresInSeconds: Math.floor(this.redeemLockDurationMs / 1e3),
       signatureDeadline: deadline
     };