@pafi-dev/issuer 0.3.0-beta.2 → 0.3.0-beta.3

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { Address, Hex, PublicClient, Chain } from 'viem';
-import { PointTokenDomainConfig, MintRequest, EIP712Signature, MintParams, SwapParams, MintRequestV2, SignatureStruct, PartialUserOperation, BurnConsent, ReceiverConsent, PathKey, PoolKey, SponsorshipScenario } from '@pafi-dev/core';
+import { PointTokenDomainConfig, MintRequest, EIP712Signature, MintParams, SwapParams, PartialUserOperation, BurnConsent, SignatureStruct, ReceiverConsent, PathKey, PoolKey, SponsorshipScenario } from '@pafi-dev/core';
 export { encodeExtData } from '@pafi-dev/core';
 
 /**
@@ -579,6 +579,19 @@ declare class RelayService {
      *        - paymaster sponsorship (PAFI Backend)
      *        - user signature (Privy)
      */
+    /**
+     * Build an unsigned UserOp for Scenario 1 (Mint) — direct
+     * `PointToken.mint(amount)` flow (v1.4 post-Relayer-removal).
+     *
+     * `msg.sender` inside the batch = user EOA via EIP-7702 delegation.
+     * `PointToken.mint` checks the caller is on its `minters` allowlist
+     * (gg56 BE pre-validates this off-chain to avoid wasted gas).
+     *
+     * Optional PT fee transfer is appended after the mint when
+     * `feeAmount > 0` — this is application-level fee recovery (no
+     * Relayer doing it for us). The user must end up with `amount - fee`
+     * net PT after the batch executes.
+     */
     prepareMint(params: PrepareMintParams): PartialUserOperation;
     /**
      * Build an unsigned UserOp for Scenario 2 (Burn/Redeem).
@@ -594,23 +607,36 @@ declare class RelayService {
      */
     prepareBurn(params: PrepareBurnParams): PartialUserOperation;
 }
+/**
+ * v1.4 — direct PointToken.mint() flow (no Relayer, no MintRequest sig).
+ *
+ * Backend (gg56) validates off-chain:
+ *   - User is on `PointToken.minters[]` allowlist
+ *   - User has enough off-chain points to claim
+ *   - Policy passes (KYC, cap, cooldown)
+ *
+ * Then locks the off-chain balance and returns this UserOp for the FE
+ * to sponsor + submit. On confirmation, PointIndexer watches the
+ * `Transfer(0x0, user, amount)` event and resolves the lock.
+ */
 interface PrepareMintParams {
     /** User EOA that will send the UserOp (via EIP-7702 delegation). */
     userAddress: Address;
-    /** ERC-4337 account nonce (not the MintRequest nonce — different namespace). */
+    /** ERC-4337 account nonce. Caller fetches from EntryPoint v0.7. */
     aaNonce: bigint;
-    /** Deployed Relayer v2 contract address (chain-specific). */
-    relayerAddress: Address;
     /** BatchExecutor delegation target (chain-specific). */
     batchExecutorAddress: Address;
-    /** PointToken being minted — used for optional fee transfer call. */
+    /** PointToken contract — the call target. */
     pointTokenAddress: Address;
-    /** EIP-712-signed MintRequest fields. */
-    mintRequest: MintRequestV2;
-    /** User's EIP-712 signature over `mintRequest`. */
-    userSignature: SignatureStruct;
-    /** Issuer's EIP-712 signature over `mintRequest`. */
-    issuerSignature: SignatureStruct;
+    /** PT amount to mint to `userAddress` (= msg.sender via EIP-7702). */
+    amount: bigint;
+    /**
+     * Optional — application-level fee transfer appended after mint.
+     * Set both `feeAmount` and `feeRecipient` together. Skipped when
+     * `feeAmount` is undefined or 0.
+     */
+    feeAmount?: bigint;
+    feeRecipient?: Address;
     /** Gas limits — defaults are conservative; caller can tighten. */
     callGasLimit?: bigint;
     verificationGasLimit?: bigint;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Address, Hex, PublicClient, Chain } from 'viem';
-import { PointTokenDomainConfig, MintRequest, EIP712Signature, MintParams, SwapParams, MintRequestV2, SignatureStruct, PartialUserOperation, BurnConsent, ReceiverConsent, PathKey, PoolKey, SponsorshipScenario } from '@pafi-dev/core';
+import { PointTokenDomainConfig, MintRequest, EIP712Signature, MintParams, SwapParams, PartialUserOperation, BurnConsent, SignatureStruct, ReceiverConsent, PathKey, PoolKey, SponsorshipScenario } from '@pafi-dev/core';
 export { encodeExtData } from '@pafi-dev/core';
 
 /**
@@ -579,6 +579,19 @@ declare class RelayService {
      *        - paymaster sponsorship (PAFI Backend)
      *        - user signature (Privy)
      */
+    /**
+     * Build an unsigned UserOp for Scenario 1 (Mint) — direct
+     * `PointToken.mint(amount)` flow (v1.4 post-Relayer-removal).
+     *
+     * `msg.sender` inside the batch = user EOA via EIP-7702 delegation.
+     * `PointToken.mint` checks the caller is on its `minters` allowlist
+     * (gg56 BE pre-validates this off-chain to avoid wasted gas).
+     *
+     * Optional PT fee transfer is appended after the mint when
+     * `feeAmount > 0` — this is application-level fee recovery (no
+     * Relayer doing it for us). The user must end up with `amount - fee`
+     * net PT after the batch executes.
+     */
     prepareMint(params: PrepareMintParams): PartialUserOperation;
     /**
      * Build an unsigned UserOp for Scenario 2 (Burn/Redeem).
@@ -594,23 +607,36 @@ declare class RelayService {
      */
     prepareBurn(params: PrepareBurnParams): PartialUserOperation;
 }
+/**
+ * v1.4 — direct PointToken.mint() flow (no Relayer, no MintRequest sig).
+ *
+ * Backend (gg56) validates off-chain:
+ *   - User is on `PointToken.minters[]` allowlist
+ *   - User has enough off-chain points to claim
+ *   - Policy passes (KYC, cap, cooldown)
+ *
+ * Then locks the off-chain balance and returns this UserOp for the FE
+ * to sponsor + submit. On confirmation, PointIndexer watches the
+ * `Transfer(0x0, user, amount)` event and resolves the lock.
+ */
 interface PrepareMintParams {
     /** User EOA that will send the UserOp (via EIP-7702 delegation). */
     userAddress: Address;
-    /** ERC-4337 account nonce (not the MintRequest nonce — different namespace). */
+    /** ERC-4337 account nonce. Caller fetches from EntryPoint v0.7. */
     aaNonce: bigint;
-    /** Deployed Relayer v2 contract address (chain-specific). */
-    relayerAddress: Address;
     /** BatchExecutor delegation target (chain-specific). */
     batchExecutorAddress: Address;
-    /** PointToken being minted — used for optional fee transfer call. */
+    /** PointToken contract — the call target. */
     pointTokenAddress: Address;
-    /** EIP-712-signed MintRequest fields. */
-    mintRequest: MintRequestV2;
-    /** User's EIP-712 signature over `mintRequest`. */
-    userSignature: SignatureStruct;
-    /** Issuer's EIP-712 signature over `mintRequest`. */
-    issuerSignature: SignatureStruct;
+    /** PT amount to mint to `userAddress` (= msg.sender via EIP-7702). */
+    amount: bigint;
+    /**
+     * Optional — application-level fee transfer appended after mint.
+     * Set both `feeAmount` and `feeRecipient` together. Skipped when
+     * `feeAmount` is undefined or 0.
+     */
+    feeAmount?: bigint;
+    feeRecipient?: Address;
     /** Gas limits — defaults are conservative; caller can tighten. */
     callGasLimit?: bigint;
     verificationGasLimit?: bigint;

package/dist/index.js

@@ -582,13 +582,15 @@ var RelayError = class extends Error {
 };
 
 // src/relay/relayService.ts
-import { encodeFunctionData } from "viem";
+import {
+  encodeFunctionData,
+  erc20Abi
+} from "viem";
 import {
   relayAbi,
   encodeMintAndSwap,
   simulateMintAndSwap as coreSimulateMintAndSwap,
   SimulationError,
-  RELAYER_V2_ABI,
   POINT_TOKEN_V2_ABI,
   buildPartialUserOperation
 } from "@pafi-dev/core";
@@ -742,10 +744,20 @@ var RelayService = class {
    *        - paymaster sponsorship (PAFI Backend)
    *        - user signature (Privy)
    */
+  /**
+   * Build an unsigned UserOp for Scenario 1 (Mint) — direct
+   * `PointToken.mint(amount)` flow (v1.4 post-Relayer-removal).
+   *
+   * `msg.sender` inside the batch = user EOA via EIP-7702 delegation.
+   * `PointToken.mint` checks the caller is on its `minters` allowlist
+   * (gg56 BE pre-validates this off-chain to avoid wasted gas).
+   *
+   * Optional PT fee transfer is appended after the mint when
+   * `feeAmount > 0` — this is application-level fee recovery (no
+   * Relayer doing it for us). The user must end up with `amount - fee`
+   * net PT after the batch executes.
+   */
   prepareMint(params) {
-    if (!params.relayerAddress) {
-      throw new RelayError("ENCODE_FAILED", "prepareMint: relayerAddress required");
-    }
     if (!params.batchExecutorAddress) {
       throw new RelayError(
         "ENCODE_FAILED",
@@ -755,36 +767,50 @@ var RelayService = class {
     if (!params.userAddress) {
       throw new RelayError("ENCODE_FAILED", "prepareMint: userAddress required");
     }
+    if (!params.pointTokenAddress) {
+      throw new RelayError(
+        "ENCODE_FAILED",
+        "prepareMint: pointTokenAddress required"
+      );
+    }
+    if (params.amount <= 0n) {
+      throw new RelayError("ENCODE_FAILED", "prepareMint: amount must be positive");
+    }
     let mintCallData;
     try {
       mintCallData = encodeFunctionData({
-        abi: RELAYER_V2_ABI,
+        abi: POINT_TOKEN_V2_ABI,
         functionName: "mint",
-        args: [params.mintRequest, params.userSignature, params.issuerSignature]
+        args: [params.amount]
       });
     } catch (err) {
       throw new RelayError(
         "ENCODE_FAILED",
-        `prepareMint: failed to encode Relayer.mint: ${errorMessage(err)}`,
+        `prepareMint: failed to encode PointToken.mint: ${errorMessage(err)}`,
         err
       );
     }
     const operations = [
       {
-        target: params.relayerAddress,
+        target: params.pointTokenAddress,
         value: 0n,
         data: mintCallData
       }
     ];
-    if (params.mintRequest.feeAmount > 0n) {
+    if (params.feeAmount && params.feeAmount > 0n) {
+      if (!params.feeRecipient) {
+        throw new RelayError(
+          "ENCODE_FAILED",
+          "prepareMint: feeRecipient required when feeAmount > 0"
+        );
+      }
       operations.push({
         target: params.pointTokenAddress,
         value: 0n,
         data: encodeFunctionData({
-          abi: POINT_TOKEN_V2_ABI,
-          functionName: "balanceOf",
-          // placeholder — real impl uses transfer
-          args: [params.mintRequest.feeRecipient]
+          abi: erc20Abi,
+          functionName: "transfer",
+          args: [params.feeRecipient, params.feeAmount]
         })
       });
     }
@@ -793,7 +819,7 @@ var RelayService = class {
       nonce: params.aaNonce,
       operations,
       gasLimits: {
-        callGasLimit: params.callGasLimit ?? 500000n,
+        callGasLimit: params.callGasLimit ?? 300000n,
         verificationGasLimit: params.verificationGasLimit ?? 150000n,
         preVerificationGas: params.preVerificationGas ?? 50000n
       }