@pafi-dev/core 0.6.2 → 0.7.0

package/dist/index.d.cts

@@ -505,14 +505,20 @@ interface BuildPerpDepositViaRelayParams {
     /** Deposit request (token, receiver, brokerHash, totalAmount, maxFee). */
     request: OrderlyRelayDepositRequest;
     /**
-     * Optional PT gas-fee transfer prepended to the batch. Set both
-     * `gasFeePtRecipient` and `gasFeePt` together for sponsored flows
-     * (PAFI gas reimbursement). Pass `0n` / `undefined` for the fallback
-     * path where the user pays ERC-4337 gas in ETH directly.
+     * Optional USDC (input-token) gas-fee transfer prepended to the batch.
+     * The user holds USDC at the start of the batch, so the fee comes out
+     * of the same input token — no second-token requirement. Set both
+     * `gasFeeUsdcRecipient` and `gasFeeUsdc` together for sponsored
+     * flows (PAFI gas reimbursement). Pass `0n` / `undefined` for the
+     * fallback path where the user pays ERC-4337 gas in ETH directly.
+     *
+     * v0.7 — input-token fee position rule: user holds USDC BEFORE
+     * deposit (token-availability), so charge there. Replaces the old
+     * `gasFeePt` / `gasFeePtRecipient` / `pointTokenAddress` triple from
+     * v0.6.
      */
-    pointTokenAddress?: Address;
-    gasFeePt?: bigint;
-    gasFeePtRecipient?: Address;
+    gasFeeUsdc?: bigint;
+    gasFeeUsdcRecipient?: Address;
     gasLimits?: {
         callGasLimit?: bigint;
         verificationGasLimit?: bigint;
@@ -522,10 +528,14 @@ interface BuildPerpDepositViaRelayParams {
 /**
  * Build a UserOp for Orderly perp deposit via the PAFI Relay.
  *
- * Sponsored ops: `[PT.transfer(feeRecipient, gasFeePt), USDC.approve(relay, total), Relay.deposit(req)]`
- * Fallback ops:  `[                                     USDC.approve(relay, total), Relay.deposit(req)]`
+ * Sponsored ops: `[USDC.transfer(feeRecipient, gasFeeUsdc), USDC.approve(relay, total), Relay.deposit(req)]`
+ * Fallback ops:  `[                                         USDC.approve(relay, total), Relay.deposit(req)]`
  *
  * No `msg.value` — the Relay covers LayerZero out of its own ETH reserve.
+ *
+ * Fee position rule: user holds USDC at start of batch → fee transfer
+ * runs FIRST in the same token. User must hold `totalAmount + gasFeeUsdc`
+ * USDC; net deposit to Orderly is `totalAmount - relayTokenFee`.
  */
 declare function buildPerpDepositViaRelay(params: BuildPerpDepositViaRelayParams): PartialUserOperation;
 

package/dist/index.d.ts

@@ -505,14 +505,20 @@ interface BuildPerpDepositViaRelayParams {
     /** Deposit request (token, receiver, brokerHash, totalAmount, maxFee). */
     request: OrderlyRelayDepositRequest;
     /**
-     * Optional PT gas-fee transfer prepended to the batch. Set both
-     * `gasFeePtRecipient` and `gasFeePt` together for sponsored flows
-     * (PAFI gas reimbursement). Pass `0n` / `undefined` for the fallback
-     * path where the user pays ERC-4337 gas in ETH directly.
+     * Optional USDC (input-token) gas-fee transfer prepended to the batch.
+     * The user holds USDC at the start of the batch, so the fee comes out
+     * of the same input token — no second-token requirement. Set both
+     * `gasFeeUsdcRecipient` and `gasFeeUsdc` together for sponsored
+     * flows (PAFI gas reimbursement). Pass `0n` / `undefined` for the
+     * fallback path where the user pays ERC-4337 gas in ETH directly.
+     *
+     * v0.7 — input-token fee position rule: user holds USDC BEFORE
+     * deposit (token-availability), so charge there. Replaces the old
+     * `gasFeePt` / `gasFeePtRecipient` / `pointTokenAddress` triple from
+     * v0.6.
      */
-    pointTokenAddress?: Address;
-    gasFeePt?: bigint;
-    gasFeePtRecipient?: Address;
+    gasFeeUsdc?: bigint;
+    gasFeeUsdcRecipient?: Address;
     gasLimits?: {
         callGasLimit?: bigint;
         verificationGasLimit?: bigint;
@@ -522,10 +528,14 @@ interface BuildPerpDepositViaRelayParams {
 /**
  * Build a UserOp for Orderly perp deposit via the PAFI Relay.
  *
- * Sponsored ops: `[PT.transfer(feeRecipient, gasFeePt), USDC.approve(relay, total), Relay.deposit(req)]`
- * Fallback ops:  `[                                     USDC.approve(relay, total), Relay.deposit(req)]`
+ * Sponsored ops: `[USDC.transfer(feeRecipient, gasFeeUsdc), USDC.approve(relay, total), Relay.deposit(req)]`
+ * Fallback ops:  `[                                         USDC.approve(relay, total), Relay.deposit(req)]`
  *
  * No `msg.value` — the Relay covers LayerZero out of its own ETH reserve.
+ *
+ * Fee position rule: user holds USDC at start of batch → fee transfer
+ * runs FIRST in the same token. User must hold `totalAmount + gasFeeUsdc`
+ * USDC; net deposit to Orderly is `totalAmount - relayTokenFee`.
  */
 declare function buildPerpDepositViaRelay(params: BuildPerpDepositViaRelayParams): PartialUserOperation;
 

package/dist/index.js

@@ -344,7 +344,7 @@ function buildPerpDepositWithGasDeduction(params) {
 }
 
 // src/perp/buildPerpDepositViaRelay.ts
-import { encodeFunctionData as encodeFunctionData4, erc20Abi as erc20Abi3 } from "viem";
+import { encodeFunctionData as encodeFunctionData4 } from "viem";
 var ORDERLY_RELAY_ABI = [
   {
     type: "function",
@@ -396,26 +396,19 @@ function buildPerpDepositViaRelay(params) {
     throw new Error("buildPerpDepositViaRelay: relayAddress required");
   }
   const operations = [];
-  if (params.gasFeePt && params.gasFeePt > 0n) {
-    if (!params.pointTokenAddress) {
+  if (params.gasFeeUsdc && params.gasFeeUsdc > 0n) {
+    if (!params.gasFeeUsdcRecipient) {
       throw new Error(
-        "buildPerpDepositViaRelay: pointTokenAddress required when gasFeePt > 0"
+        "buildPerpDepositViaRelay: gasFeeUsdcRecipient required when gasFeeUsdc > 0"
       );
     }
-    if (!params.gasFeePtRecipient) {
-      throw new Error(
-        "buildPerpDepositViaRelay: gasFeePtRecipient required when gasFeePt > 0"
-      );
-    }
-    operations.push({
-      target: params.pointTokenAddress,
-      value: 0n,
-      data: encodeFunctionData4({
-        abi: erc20Abi3,
-        functionName: "transfer",
-        args: [params.gasFeePtRecipient, params.gasFeePt]
-      })
-    });
+    operations.push(
+      erc20TransferOp(
+        params.request.token,
+        params.gasFeeUsdcRecipient,
+        params.gasFeeUsdc
+      )
+    );
   }
   operations.push(
     erc20ApproveOp(