@pafi-dev/issuer 0.5.14 → 0.5.15

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,6 +1121,12 @@ 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. */

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,6 +1121,12 @@ 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. */

package/dist/index.js

@@ -567,6 +567,29 @@ var RelayService = class {
         data: burnCallData
       }
     ];
+    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: encodeFunctionData({
+          abi: erc20Abi,
+          functionName: "transfer",
+          args: [params.feeRecipient, params.feeAmount]
+        })
+      });
+    }
     return buildPartialUserOperation({
       sender: params.userAddress,
       nonce: params.aaNonce,
@@ -1355,10 +1378,11 @@ var PTRedeemHandler = class {
       this.pointTokenAddress,
       request.userAddress
     );
-    if (onChainBalance < request.amount) {
+    const totalRequired = request.amount + (request.feeAmount && request.feeAmount > 0n ? request.feeAmount : 0n);
+    if (onChainBalance < totalRequired) {
       throw new PTRedeemError(
         "INVALID_AMOUNT",
-        `insufficient on-chain PT balance: have ${onChainBalance}, need ${request.amount}`
+        `insufficient on-chain PT balance: have ${onChainBalance}, need ${totalRequired}` + (request.feeAmount && request.feeAmount > 0n ? ` (${request.amount} burn + ${request.feeAmount} fee)` : "")
       );
     }
     const deadline = BigInt(
@@ -1402,7 +1426,9 @@ var PTRedeemHandler = class {
       pointTokenAddress: this.pointTokenAddress,
       batchExecutorAddress: this.batchExecutorAddress,
       burnRequest,
-      burnerSignature
+      burnerSignature,
+      feeAmount: request.feeAmount,
+      feeRecipient: request.feeRecipient
     });
     return {
       lockId,