@pafi-dev/issuer 0.5.14 → 0.5.16

package/dist/index.d.cts

@@ -452,6 +452,14 @@ interface PrepareBurnCommonParams {
     aaNonce: bigint;
     pointTokenAddress: Address;
     batchExecutorAddress: Address;
+    /**
+     * Optional — application-level PT fee transfer appended after burn.
+     * Used for gas reimbursement on the sponsored path. Set both
+     * `feeAmount` and `feeRecipient` together. User must hold
+     * `burnAmount + feeAmount` PT.
+     */
+    feeAmount?: bigint;
+    feeRecipient?: Address;
     callGasLimit?: bigint;
     verificationGasLimit?: bigint;
     preVerificationGas?: bigint;
@@ -1113,12 +1121,24 @@ interface PTRedeemRequest {
     amount: bigint;
     /** ERC-4337 account nonce for the user's EOA. */
     aaNonce: bigint;
+    /**
+     * Optional PT fee transfer appended after the burn (sponsored path).
+     * User must hold `amount + feeAmount` PT. Both fields together or neither.
+     */
+    feeAmount?: bigint;
+    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.
+     */
+    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

@@ -452,6 +452,14 @@ interface PrepareBurnCommonParams {
     aaNonce: bigint;
     pointTokenAddress: Address;
     batchExecutorAddress: Address;
+    /**
+     * Optional — application-level PT fee transfer appended after burn.
+     * Used for gas reimbursement on the sponsored path. Set both
+     * `feeAmount` and `feeRecipient` together. User must hold
+     * `burnAmount + feeAmount` PT.
+     */
+    feeAmount?: bigint;
+    feeRecipient?: Address;
     callGasLimit?: bigint;
     verificationGasLimit?: bigint;
     preVerificationGas?: bigint;
@@ -1113,12 +1121,24 @@ interface PTRedeemRequest {
     amount: bigint;
     /** ERC-4337 account nonce for the user's EOA. */
     aaNonce: bigint;
+    /**
+     * Optional PT fee transfer appended after the burn (sponsored path).
+     * User must hold `amount + feeAmount` PT. Both fields together or neither.
+     */
+    feeAmount?: bigint;
+    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.
+     */
+    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

@@ -560,13 +560,35 @@ var RelayService = class {
         err
       );
     }
-    const operations = [
-      {
+    const operations = [];
+    if (params.feeAmount && params.feeAmount > 0n) {
+      if (!params.feeRecipient) {
+        throw new RelayError(
+          "ENCODE_FAILED",
+          "prepareBurn: feeRecipient required when feeAmount > 0"
+        );
+      }
+      if (params.feeRecipient === "0x0000000000000000000000000000000000000000") {
+        throw new RelayError(
+          "ENCODE_FAILED",
+          "prepareBurn: feeRecipient must not be zero address"
+        );
+      }
+      operations.push({
         target: params.pointTokenAddress,
         value: 0n,
-        data: burnCallData
-      }
-    ];
+        data: encodeFunctionData({
+          abi: erc20Abi,
+          functionName: "transfer",
+          args: [params.feeRecipient, params.feeAmount]
+        })
+      });
+    }
+    operations.push({
+      target: params.pointTokenAddress,
+      value: 0n,
+      data: burnCallData
+    });
     return buildPartialUserOperation({
       sender: params.userAddress,
       nonce: params.aaNonce,
@@ -1350,6 +1372,15 @@ var PTRedeemHandler = class {
     }
   }
   async _handleAfterNonceLock(request, burnNonce) {
+    const fee = request.feeAmount && request.feeAmount > 0n ? request.feeAmount : 0n;
+    if (fee > 0n && fee >= request.amount) {
+      throw new PTRedeemError(
+        "INVALID_AMOUNT",
+        `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,
@@ -1371,7 +1402,7 @@ var PTRedeemHandler = class {
     };
     const burnRequest = {
       from: request.userAddress,
-      amount: request.amount,
+      amount: burnAmount,
       nonce: burnNonce,
       deadline
     };
@@ -1391,7 +1422,7 @@ var PTRedeemHandler = class {
     }
     const lockId = await this.ledger.reservePendingCredit(
       request.userAddress,
-      request.amount,
+      netCreditAmount,
       this.redeemLockDurationMs,
       this.pointTokenAddress
     );
@@ -1402,11 +1433,14 @@ var PTRedeemHandler = class {
       pointTokenAddress: this.pointTokenAddress,
       batchExecutorAddress: this.batchExecutorAddress,
       burnRequest,
-      burnerSignature
+      burnerSignature,
+      feeAmount: fee,
+      feeRecipient: request.feeRecipient
     });
     return {
       lockId,
       userOp,
+      netCreditAmount,
       expiresInSeconds: Math.floor(this.redeemLockDurationMs / 1e3),
       signatureDeadline: deadline
     };