@pafi-dev/trading 0.1.8 → 0.1.10

package/README.md

@@ -17,10 +17,10 @@ client-side (React, React Native).
 - TypeScript >= 5.0
 - `viem` ^2.0.0 and `@pafi-dev/core` ^0.5.17 (peer dependencies)
 
-> **Latest:** `0.1.3` — bumps the `@pafi-dev/core` peer to `0.5.17` for
-> the v0.8 EIP-712 userOpHash + `buildUserOpTypedData()` helpers required
-> by the EIP-7702 swap path. Also adds a frontend "quote review"
-> example. See [Changelog](#changelog).
+> **Latest:** `0.1.9` — `handleSwap` / `handlePerpDeposit` now
+> auto-quote the operator fee and auto-resolve the PAFI fee recipient.
+> Caller no longer pre-fetches anything from the issuer backend. See
+> [Changelog](#changelog).
 
 ---
 
@@ -341,6 +341,56 @@ It does not depend on `@pafi-dev/issuer`.
 
 ## Changelog
 
+### 0.1.9
+
+`handleSwap` and `handlePerpDeposit` now **auto-quote the operator fee
++ auto-resolve the PAFI fee recipient**. Caller no longer needs to
+pre-fetch anything from the issuer backend.
+
+**API changes** (additive — passing the old explicit values still works
+as overrides):
+
+- `ApiSwapRequest.gasFeePt` — semantics changed:
+  - `undefined` (default): handler runs `quoteOperatorFeePt` (Chainlink
+    + V4 subgraph) to compute the PT fee.
+  - `0n`: strips the `PT.transfer(...)` from the batch (unsponsored
+    fallback).
+  - explicit bigint: override (issuer markup / subsidy).
+- `ApiSwapRequest.feeRecipient` — **REMOVED**. Hardcoded to
+  `getContractAddresses(chainId).pafiFeeRecipient`. Sponsor-relayer's
+  L1 gate would reject any other recipient anyway, so the option was
+  removed to keep the API honest.
+- `ApiPerpDepositRequest.gasFeePtRecipient` — **REMOVED** (same
+  reason). `pointTokenAddress` still required when fee > 0 (handler
+  needs the token to call `transfer` against).
+- `ApiSwapResponse.feeAmountUsed` / `.feeRecipient` — **NEW**. Echo
+  what the handler actually embedded so the FE can display it without
+  re-quoting.
+- `ApiPerpDepositResponse.feeAmountUsed` / `.feeRecipient` — same.
+
+**Migration**:
+
+```diff
+- const gasFeePt = await quoteOperatorFeePt({...});
+- const result = await trading.handleSwap({
+-   ..., gasFeePt, feeRecipient: PAFI_FEE_RECIPIENT,
+- });
++ const result = await trading.handleSwap({...});
++ console.log(`Fee charged: ${result.feeAmountUsed} → ${result.feeRecipient}`);
+```
+
+Force unsponsored / fallback (no fee transfer):
+
+```ts
+const result = await trading.handleSwap({ ..., gasFeePt: 0n });
+```
+
+Fee policy override (rare):
+
+```ts
+const result = await trading.handleSwap({ ..., gasFeePt: customAmount });
+```
+
 ### 0.1.5
 
 `handlePerpDeposit` now defaults to the **PAFI Orderly Relay** path —

package/dist/index.cjs

@@ -99,7 +99,7 @@ var TradingHandlers = class {
     if (request.amount <= 0n) {
       throw new Error("handleSwap: amount must be positive");
     }
-    const { usdt } = (0, import_core.getContractAddresses)(request.chainId);
+    const { usdt, pafiFeeRecipient } = (0, import_core.getContractAddresses)(request.chainId);
     const universalRouter = import_core.UNIVERSAL_ROUTER_ADDRESSES[request.chainId];
     if (!universalRouter) {
       throw new Error(`handleSwap: no UniversalRouter for chainId ${request.chainId}`);
@@ -108,10 +108,11 @@ var TradingHandlers = class {
     const userAddress = (0, import_viem.getAddress)(request.userAddress);
     const pools = request.pools ?? [];
     const slippageBps = request.slippageBps ?? 50;
-    const gasFeePt = request.gasFeePt ?? 0n;
-    if (gasFeePt > 0n && !request.feeRecipient) {
-      throw new Error("handleSwap: feeRecipient required when gasFeePt > 0");
-    }
+    const gasFeePt = request.gasFeePt !== void 0 ? request.gasFeePt : await (0, import_core.quoteOperatorFeePt)({
+      provider: this.provider,
+      chainId: request.chainId,
+      pointTokenAddress
+    });
     let quoteResult;
     try {
       quoteResult = await (0, import_core.findBestQuote)(
@@ -139,7 +140,9 @@ var TradingHandlers = class {
       swapPath: quoteResult.bestRoute.path,
       deadline,
       gasFeePt,
-      feeRecipient: request.feeRecipient ?? userAddress
+      // Recipient is always PAFI's canonical address — sponsor-relayer's
+      // L1 gate will reject any other recipient anyway. No override.
+      feeRecipient: pafiFeeRecipient
     });
     const userOpFallback = gasFeePt > 0n ? (0, import_core.buildSwapWithGasDeduction)({
       userAddress,
@@ -154,7 +157,15 @@ var TradingHandlers = class {
       gasFeePt: 0n,
       feeRecipient: userAddress
     }) : void 0;
-    return { userOp, userOpFallback, estimatedUsdtOut, minAmountOut, deadline };
+    return {
+      userOp,
+      userOpFallback,
+      estimatedUsdtOut,
+      minAmountOut,
+      deadline,
+      feeAmountUsed: gasFeePt,
+      feeRecipient: pafiFeeRecipient
+    };
   }
   // =========================================================================
   // POST /perp-deposit
@@ -227,8 +238,13 @@ var TradingHandlers = class {
       args: [userAddress, depositData]
     });
     const useRelay = request.viaRelay !== false;
-    const relayAddress = (0, import_core.getContractAddresses)(request.chainId).orderlyRelay;
+    const { orderlyRelay: relayAddress, pafiFeeRecipient } = (0, import_core.getContractAddresses)(request.chainId);
     const relayDeployed = !isPlaceholderAddress(relayAddress);
+    const gasFeePt = request.gasFeePt !== void 0 ? request.gasFeePt : useRelay && relayDeployed && request.pointTokenAddress ? await (0, import_core.quoteOperatorFeePt)({
+      provider: this.provider,
+      chainId: request.chainId,
+      pointTokenAddress: (0, import_viem.getAddress)(request.pointTokenAddress)
+    }) : 0n;
     if (useRelay && relayDeployed) {
       const RELAY_FEE_FLOOR_USDC = 2000000n;
       const percentCap = request.amount * 500n / 10000n;
@@ -263,11 +279,16 @@ var TradingHandlers = class {
         aaNonce: request.aaNonce,
         relayAddress,
         request: relayRequest,
+        // Only attach the PT-fee transfer when the caller actually
+        // supplies a PointToken; otherwise the SDK has no token to
+        // transfer from. `gasFeePt` resolves to 0 in that case via the
+        // ?? chain above, so the call below collapses to a no-op
+        // batch (USDC.approve + relay.deposit only).
         pointTokenAddress: request.pointTokenAddress,
-        gasFeePt: request.gasFeePt,
-        gasFeePtRecipient: request.gasFeePtRecipient
+        gasFeePt: gasFeePt > 0n ? gasFeePt : void 0,
+        gasFeePtRecipient: gasFeePt > 0n ? pafiFeeRecipient : void 0
       });
-      const userOpFallback = request.gasFeePt && request.gasFeePt > 0n ? (0, import_core.buildPerpDepositViaRelay)({
+      const userOpFallback = gasFeePt > 0n ? (0, import_core.buildPerpDepositViaRelay)({
         userAddress,
         aaNonce: request.aaNonce,
         relayAddress,
@@ -282,7 +303,9 @@ var TradingHandlers = class {
         accountId,
         brokerHash,
         usdcAddress,
-        relayAddress
+        relayAddress,
+        feeAmountUsed: gasFeePt,
+        feeRecipient: pafiFeeRecipient
       };
     }
     const userOp = (0, import_core.buildPerpDepositWithGasDeduction)({
@@ -302,7 +325,13 @@ var TradingHandlers = class {
       accountId,
       brokerHash,
       usdcAddress,
-      relayAddress: vault
+      relayAddress: vault,
+      // Vault path doesn't include the PT operator fee transfer (it's
+      // an unsponsored path on chains without a Relay deployment, and
+      // the user is paying msg.value in ETH already). Echo 0n + the
+      // canonical recipient so the response shape stays consistent.
+      feeAmountUsed: 0n,
+      feeRecipient: pafiFeeRecipient
     };
   }
 };

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/api/handlers.ts","../src/pools.ts"],"sourcesContent":["export { TradingHandlers } from \"./api/handlers\";\nexport type { TradingHandlersConfig } from \"./api/handlers\";\n\nexport type {\n  ApiQuoteRequest,\n  ApiQuoteResponse,\n  ApiQuoteError,\n  ApiSwapRequest,\n  ApiSwapResponse,\n  ApiPerpDepositRequest,\n  ApiPerpDepositResponse,\n} from \"./api/types\";\n\nexport { fetchPafiPools, PAFI_SUBGRAPH_URL } from \"./pools\";\n","import { getAddress } from \"viem\";\nimport type { Address, PublicClient } from \"viem\";\nimport {\n  findBestQuote,\n  buildSwapWithGasDeduction,\n  buildPerpDepositWithGasDeduction,\n  buildPerpDepositViaRelay,\n  ORDERLY_RELAY_ABI,\n  getContractAddresses,\n  UNIVERSAL_ROUTER_ADDRESSES,\n  ORDERLY_VAULT_ABI,\n  ORDERLY_VAULT_ADDRESSES,\n  BROKER_HASHES,\n  TOKEN_HASHES,\n  computeAccountId,\n} from \"@pafi-dev/core\";\nimport type {\n  ApiQuoteRequest,\n  ApiQuoteResponse,\n  ApiSwapRequest,\n  ApiSwapResponse,\n  ApiPerpDepositRequest,\n  ApiPerpDepositResponse,\n} from \"./types\";\n\nexport interface TradingHandlersConfig {\n  provider: PublicClient;\n  chainId: number;\n}\n\n/**\n * Framework-agnostic handlers for on-chain trading actions.\n *\n * All handlers are stateless — they need only a PublicClient for RPC\n * calls. No ledger, no signer, no DB. Issuers wrap these in their own\n * HTTP controllers (Express / NestJS / Hono / etc.) the same way they\n * wrap `IssuerApiHandlers` from `@pafi-dev/issuer`.\n *\n * Example (NestJS):\n *\n *   const trading = new TradingHandlers({ provider, chainId });\n *\n *   // GET /quote\n *   const quote = await trading.handleQuote({ chainId, pointTokenAddress, amount, pools });\n *\n *   // POST /swap\n *   const swap = await trading.handleSwap({ chainId, userAddress, pointTokenAddress, amount, aaNonce });\n *\n *   // POST /perp-deposit\n *   const deposit = await trading.handlePerpDeposit({ chainId, userAddress, amount, aaNonce, brokerId });\n */\nexport class TradingHandlers {\n  private readonly provider: PublicClient;\n  private readonly chainId: number;\n\n  constructor(config: TradingHandlersConfig) {\n    this.provider = config.provider;\n    this.chainId = config.chainId;\n  }\n\n  // =========================================================================\n  // GET /quote\n  // =========================================================================\n\n  /**\n   * Quote exact-input PT → USDT via Uniswap V4 on-chain Quoter.\n   *\n   * Uses multicall to batch all candidate routes into a single RPC call.\n   * Returns `quoteError: \"QUOTE_UNAVAILABLE\"` when no pool/path exists\n   * rather than throwing, so callers can show a soft \"unavailable\" UI\n   * state without 500-ing.\n   */\n  async handleQuote(request: ApiQuoteRequest): Promise<ApiQuoteResponse> {\n    if (request.chainId !== this.chainId) {\n      throw new Error(`handleQuote: unsupported chainId ${request.chainId}`);\n    }\n    if (request.amount === 0n) {\n      return { pointAmount: 0n, estimatedUsdtOut: 0n, gasEstimate: 0n };\n    }\n\n    const { usdt } = getContractAddresses(request.chainId);\n    const pointTokenAddress = getAddress(request.pointTokenAddress);\n    const pools = request.pools ?? [];\n\n    try {\n      const best = await findBestQuote(\n        this.provider,\n        request.chainId,\n        pointTokenAddress,\n        usdt,\n        request.amount,\n        pools,\n      );\n      return {\n        pointAmount: request.amount,\n        estimatedUsdtOut: best.bestRoute.amountOut,\n        gasEstimate: best.bestRoute.gasEstimate,\n      };\n    } catch {\n      return {\n        pointAmount: request.amount,\n        estimatedUsdtOut: 0n,\n        gasEstimate: 0n,\n        quoteError: \"QUOTE_UNAVAILABLE\",\n      };\n    }\n  }\n\n  // =========================================================================\n  // POST /swap\n  // =========================================================================\n\n  /**\n   * Build a PT → USDT swap UserOp.\n   *\n   * Quotes the best route, applies slippage, then encodes a 4-step\n   * batch: PT.approve → Permit2.approve → UniversalRouter.execute →\n   * PT.transfer (fee, omitted when gasFeePt = 0). Returns an unsigned\n   * `PartialUserOperation`; caller attaches paymaster data + user\n   * signature and submits to the Bundler.\n   */\n  async handleSwap(request: ApiSwapRequest): Promise<ApiSwapResponse> {\n    if (request.chainId !== this.chainId) {\n      throw new Error(`handleSwap: unsupported chainId ${request.chainId}`);\n    }\n    if (request.amount <= 0n) {\n      throw new Error(\"handleSwap: amount must be positive\");\n    }\n\n    const { usdt } = getContractAddresses(request.chainId);\n    const universalRouter = UNIVERSAL_ROUTER_ADDRESSES[request.chainId];\n    if (!universalRouter) {\n      throw new Error(`handleSwap: no UniversalRouter for chainId ${request.chainId}`);\n    }\n\n    const pointTokenAddress = getAddress(request.pointTokenAddress);\n    const userAddress = getAddress(request.userAddress);\n    const pools = request.pools ?? [];\n    const slippageBps = request.slippageBps ?? 50;\n    const gasFeePt = request.gasFeePt ?? 0n;\n\n    if (gasFeePt > 0n && !request.feeRecipient) {\n      throw new Error(\"handleSwap: feeRecipient required when gasFeePt > 0\");\n    }\n\n    let quoteResult: Awaited<ReturnType<typeof findBestQuote>>;\n    try {\n      quoteResult = await findBestQuote(\n        this.provider,\n        request.chainId,\n        pointTokenAddress,\n        usdt,\n        request.amount,\n        pools,\n      );\n    } catch {\n      throw new Error(\"handleSwap: no swap path found for this point token\");\n    }\n\n    const estimatedUsdtOut = quoteResult.bestRoute.amountOut;\n    const minAmountOut = (estimatedUsdtOut * BigInt(10000 - slippageBps)) / 10000n;\n    const deadline = BigInt(Math.floor(Date.now() / 1000) + 5 * 60);\n\n    const userOp = buildSwapWithGasDeduction({\n      userAddress,\n      aaNonce: request.aaNonce,\n      pointTokenAddress,\n      outputTokenAddress: usdt,\n      universalRouterAddress: universalRouter,\n      amountIn: request.amount,\n      minAmountOut,\n      swapPath: quoteResult.bestRoute.path,\n      deadline,\n      gasFeePt,\n      feeRecipient: request.feeRecipient ?? userAddress,\n    });\n\n    // Fee-stripped variant for the paymaster-refused fallback path.\n    // Building it is essentially free (same quote, same path, just\n    // skip the PT.transfer call) so always emit it when fee > 0; the\n    // FE feeds it to `sendWithPaymasterFallback({ txParamsFallback })`.\n    const userOpFallback =\n      gasFeePt > 0n\n        ? buildSwapWithGasDeduction({\n            userAddress,\n            aaNonce: request.aaNonce,\n            pointTokenAddress,\n            outputTokenAddress: usdt,\n            universalRouterAddress: universalRouter,\n            amountIn: request.amount,\n            minAmountOut,\n            swapPath: quoteResult.bestRoute.path,\n            deadline,\n            gasFeePt: 0n,\n            feeRecipient: userAddress,\n          })\n        : undefined;\n\n    return { userOp, userOpFallback, estimatedUsdtOut, minAmountOut, deadline };\n  }\n\n  // =========================================================================\n  // POST /perp-deposit\n  // =========================================================================\n\n  /**\n   * Build an Orderly perp deposit UserOp.\n   *\n   * Default path is the **PAFI Orderly Relay** (`viaRelay: true`):\n   * USDC.approve(relay) + relay.deposit(req). The Relay holds an ETH\n   * reserve and pays Orderly's LayerZero `msg.value` out of it; the\n   * user pays a USDC fee (quoted via `Relay.quoteTokenFee`) instead.\n   * No native ETH on the user wallet is required, so paymaster\n   * sponsorship of the ERC-4337 gas is sufficient end-to-end.\n   *\n   * Fallback path (`viaRelay: false`): direct `Vault.deposit{value}`.\n   * Reserved for chains where no Relay is deployed — the user wallet\n   * **must** hold `layerZeroFee` as native ETH.\n   *\n   * The Relay path automatically falls back to Vault when\n   * `getContractAddresses(chainId).orderlyRelay` is the placeholder\n   * sentinel (Relay not deployed for that chain).\n   */\n  async handlePerpDeposit(request: ApiPerpDepositRequest): Promise<ApiPerpDepositResponse> {\n    if (request.chainId !== this.chainId) {\n      throw new Error(`handlePerpDeposit: unsupported chainId ${request.chainId}`);\n    }\n    if (request.amount <= 0n) {\n      throw new Error(\"handlePerpDeposit: amount must be positive\");\n    }\n\n    const vault = ORDERLY_VAULT_ADDRESSES[request.chainId];\n    if (!vault) {\n      throw new Error(`handlePerpDeposit: no Orderly Vault for chainId ${request.chainId}`);\n    }\n\n    const brokerHash = BROKER_HASHES[request.brokerId as keyof typeof BROKER_HASHES];\n    if (!brokerHash) {\n      throw new Error(`handlePerpDeposit: unknown brokerId \"${request.brokerId}\"`);\n    }\n    const tokenHash = TOKEN_HASHES.USDC;\n    const userAddress = getAddress(request.userAddress);\n\n    const [usdcAddress, brokerAllowed] = await Promise.all([\n      this.provider.readContract({\n        address: vault,\n        abi: ORDERLY_VAULT_ABI,\n        functionName: \"getAllowedToken\",\n        args: [tokenHash],\n      }) as Promise<Address>,\n      this.provider.readContract({\n        address: vault,\n        abi: ORDERLY_VAULT_ABI,\n        functionName: \"getAllowedBroker\",\n        args: [brokerHash],\n      }) as Promise<boolean>,\n    ]);\n\n    if (!brokerAllowed) {\n      throw new Error(\n        `handlePerpDeposit: broker \"${request.brokerId}\" is not whitelisted on Orderly Vault`,\n      );\n    }\n\n    const accountId = computeAccountId(userAddress, brokerHash);\n    const depositData = {\n      accountId,\n      brokerHash,\n      tokenHash,\n      tokenAmount: request.amount,\n    };\n\n    // Always read layerZeroFee for response — even on the Relay path\n    // it's useful informational output (lets the FE show \"Relay\n    // covers ~X ETH for you\").\n    const layerZeroFee = (await this.provider.readContract({\n      address: vault,\n      abi: ORDERLY_VAULT_ABI,\n      functionName: \"getDepositFee\",\n      args: [userAddress, depositData],\n    })) as bigint;\n\n    const useRelay = request.viaRelay !== false;\n    const relayAddress = getContractAddresses(request.chainId).orderlyRelay;\n    const relayDeployed = !isPlaceholderAddress(relayAddress);\n\n    if (useRelay && relayDeployed) {\n      // Cap = max(amount * 5%, 2 USDC). The Relay fee is a flat USDC\n      // amount derived from the LayerZero ETH cost at oracle price —\n      // it does NOT scale with deposit size. A pure percentage cap\n      // breaks for small deposits (e.g. 0.01 USDC test deposit, 5%\n      // cap = 500 wei < 14k wei real fee). The 2 USDC floor covers\n      // normal LayerZero pricing on Base; the 5% slope still guards\n      // against oracle spikes on large deposits.\n      const RELAY_FEE_FLOOR_USDC = 2_000_000n; // 2 USDC (6 decimals)\n      const percentCap = (request.amount * 500n) / 10_000n;\n      const maxRelayFee =\n        request.maxRelayFee ??\n        (percentCap > RELAY_FEE_FLOOR_USDC ? percentCap : RELAY_FEE_FLOOR_USDC);\n\n      const relayRequest = {\n        token: usdcAddress,\n        receiver: userAddress,\n        brokerHash,\n        totalAmount: request.amount,\n        maxFee: maxRelayFee,\n      };\n\n      const relayTokenFee = (await this.provider.readContract({\n        address: relayAddress,\n        abi: ORDERLY_RELAY_ABI,\n        functionName: \"quoteTokenFee\",\n        args: [relayRequest],\n      })) as bigint;\n\n      if (relayTokenFee > maxRelayFee) {\n        throw new Error(\n          `handlePerpDeposit: Relay tokenFee ${relayTokenFee} (≈ ${\n            Number(relayTokenFee) / 1e6\n          } USDC) exceeds maxRelayFee ${maxRelayFee} — pass a larger ` +\n            `\\`maxRelayFee\\` or increase the deposit \\`amount\\` so the fee ` +\n            `becomes a smaller share of the total.`,\n        );\n      }\n\n      // Sanity-check: Relay forwards `(totalAmount − tokenFee)` to\n      // Orderly Vault. When `tokenFee >= totalAmount` the forwarded\n      // amount is zero / negative and the Relay reverts on-chain with\n      // `FeeExceedsAmount(fee, totalAmount)` (selector 0x536766bf),\n      // which propagates as an opaque `BatchExecutor.CallFailed(1, …)`\n      // revert at simulation time. Catch this early on the client so\n      // the UX shows an actionable message instead of an AA21/AA34\n      // bundler error wrapped around the raw selector.\n      if (relayTokenFee >= request.amount) {\n        const feeUsdc = Number(relayTokenFee) / 1e6;\n        const amountUsdc = Number(request.amount) / 1e6;\n        throw new Error(\n          `handlePerpDeposit: deposit amount ${amountUsdc} USDC is below the ` +\n            `Relay fee ${feeUsdc} USDC — increase \\`amount\\` to at least ` +\n            `${(feeUsdc * 2).toFixed(6)} USDC so a meaningful balance reaches ` +\n            `your Orderly account after the Relay charge.`,\n        );\n      }\n\n      const userOp = buildPerpDepositViaRelay({\n        userAddress,\n        aaNonce: request.aaNonce,\n        relayAddress,\n        request: relayRequest,\n        pointTokenAddress: request.pointTokenAddress,\n        gasFeePt: request.gasFeePt,\n        gasFeePtRecipient: request.gasFeePtRecipient,\n      });\n\n      // Same shape, no PT fee transfer — for the paymaster-refused\n      // fallback path. The Relay still charges its USDC token-fee\n      // (that compensates LayerZero ETH spend, NOT PAFI's gas).\n      const userOpFallback =\n        request.gasFeePt && request.gasFeePt > 0n\n          ? buildPerpDepositViaRelay({\n              userAddress,\n              aaNonce: request.aaNonce,\n              relayAddress,\n              request: relayRequest,\n            })\n          : undefined;\n\n      return {\n        userOp,\n        userOpFallback,\n        path: \"relay\",\n        layerZeroFee,\n        relayTokenFee,\n        accountId,\n        brokerHash,\n        usdcAddress,\n        relayAddress,\n      };\n    }\n\n    // Fallback: direct Vault.deposit{value} — user wallet MUST hold\n    // `layerZeroFee` as native ETH (paymaster does not sponsor msg.value).\n    const userOp = buildPerpDepositWithGasDeduction({\n      userAddress,\n      aaNonce: request.aaNonce,\n      chainId: request.chainId,\n      usdcAddress,\n      amount: request.amount,\n      depositData,\n      layerZeroFee,\n    });\n\n    return {\n      userOp,\n      path: \"vault\",\n      layerZeroFee,\n      relayTokenFee: 0n,\n      accountId,\n      brokerHash,\n      usdcAddress,\n      relayAddress: vault,\n    };\n  }\n}\n\n/**\n * `addresses.ts` uses `0x000…<suffix>` sentinels for chains where a\n * given contract is not yet deployed. Detect them by upper-160-bits =\n * 0 so we route to the Vault fallback automatically.\n */\nfunction isPlaceholderAddress(addr: Address): boolean {\n  return /^0x0{36}[0-9a-fA-F]{4}$/i.test(addr);\n}\n","// Re-export from @pafi-dev/core — fetchPafiPools lives in core so all\n// SDK packages share one implementation.\nexport { fetchPafiPools, PAFI_SUBGRAPH_URL } from \"@pafi-dev/core\";\n"],"mappings":"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","names":["userOp","import_core"]}
+{"version":3,"sources":["../src/index.ts","../src/api/handlers.ts","../src/pools.ts"],"sourcesContent":["export { TradingHandlers } from \"./api/handlers\";\nexport type { TradingHandlersConfig } from \"./api/handlers\";\n\nexport type {\n  ApiQuoteRequest,\n  ApiQuoteResponse,\n  ApiQuoteError,\n  ApiSwapRequest,\n  ApiSwapResponse,\n  ApiPerpDepositRequest,\n  ApiPerpDepositResponse,\n} from \"./api/types\";\n\nexport { fetchPafiPools, PAFI_SUBGRAPH_URL } from \"./pools\";\n","import { getAddress } from \"viem\";\nimport type { Address, PublicClient } from \"viem\";\nimport {\n  findBestQuote,\n  buildSwapWithGasDeduction,\n  buildPerpDepositWithGasDeduction,\n  buildPerpDepositViaRelay,\n  ORDERLY_RELAY_ABI,\n  getContractAddresses,\n  UNIVERSAL_ROUTER_ADDRESSES,\n  ORDERLY_VAULT_ABI,\n  ORDERLY_VAULT_ADDRESSES,\n  BROKER_HASHES,\n  TOKEN_HASHES,\n  computeAccountId,\n  quoteOperatorFeePt,\n} from \"@pafi-dev/core\";\nimport type {\n  ApiQuoteRequest,\n  ApiQuoteResponse,\n  ApiSwapRequest,\n  ApiSwapResponse,\n  ApiPerpDepositRequest,\n  ApiPerpDepositResponse,\n} from \"./types\";\n\nexport interface TradingHandlersConfig {\n  provider: PublicClient;\n  chainId: number;\n}\n\n/**\n * Framework-agnostic handlers for on-chain trading actions.\n *\n * All handlers are stateless — they need only a PublicClient for RPC\n * calls. No ledger, no signer, no DB. Issuers wrap these in their own\n * HTTP controllers (Express / NestJS / Hono / etc.) the same way they\n * wrap `IssuerApiHandlers` from `@pafi-dev/issuer`.\n *\n * Example (NestJS):\n *\n *   const trading = new TradingHandlers({ provider, chainId });\n *\n *   // GET /quote\n *   const quote = await trading.handleQuote({ chainId, pointTokenAddress, amount, pools });\n *\n *   // POST /swap\n *   const swap = await trading.handleSwap({ chainId, userAddress, pointTokenAddress, amount, aaNonce });\n *\n *   // POST /perp-deposit\n *   const deposit = await trading.handlePerpDeposit({ chainId, userAddress, amount, aaNonce, brokerId });\n */\nexport class TradingHandlers {\n  private readonly provider: PublicClient;\n  private readonly chainId: number;\n\n  constructor(config: TradingHandlersConfig) {\n    this.provider = config.provider;\n    this.chainId = config.chainId;\n  }\n\n  // =========================================================================\n  // GET /quote\n  // =========================================================================\n\n  /**\n   * Quote exact-input PT → USDT via Uniswap V4 on-chain Quoter.\n   *\n   * Uses multicall to batch all candidate routes into a single RPC call.\n   * Returns `quoteError: \"QUOTE_UNAVAILABLE\"` when no pool/path exists\n   * rather than throwing, so callers can show a soft \"unavailable\" UI\n   * state without 500-ing.\n   */\n  async handleQuote(request: ApiQuoteRequest): Promise<ApiQuoteResponse> {\n    if (request.chainId !== this.chainId) {\n      throw new Error(`handleQuote: unsupported chainId ${request.chainId}`);\n    }\n    if (request.amount === 0n) {\n      return { pointAmount: 0n, estimatedUsdtOut: 0n, gasEstimate: 0n };\n    }\n\n    const { usdt } = getContractAddresses(request.chainId);\n    const pointTokenAddress = getAddress(request.pointTokenAddress);\n    const pools = request.pools ?? [];\n\n    try {\n      const best = await findBestQuote(\n        this.provider,\n        request.chainId,\n        pointTokenAddress,\n        usdt,\n        request.amount,\n        pools,\n      );\n      return {\n        pointAmount: request.amount,\n        estimatedUsdtOut: best.bestRoute.amountOut,\n        gasEstimate: best.bestRoute.gasEstimate,\n      };\n    } catch {\n      return {\n        pointAmount: request.amount,\n        estimatedUsdtOut: 0n,\n        gasEstimate: 0n,\n        quoteError: \"QUOTE_UNAVAILABLE\",\n      };\n    }\n  }\n\n  // =========================================================================\n  // POST /swap\n  // =========================================================================\n\n  /**\n   * Build a PT → USDT swap UserOp.\n   *\n   * Quotes the best route, applies slippage, then encodes a 4-step\n   * batch: PT.approve → Permit2.approve → UniversalRouter.execute →\n   * PT.transfer (fee, omitted when gasFeePt = 0). Returns an unsigned\n   * `PartialUserOperation`; caller attaches paymaster data + user\n   * signature and submits to the Bundler.\n   */\n  async handleSwap(request: ApiSwapRequest): Promise<ApiSwapResponse> {\n    if (request.chainId !== this.chainId) {\n      throw new Error(`handleSwap: unsupported chainId ${request.chainId}`);\n    }\n    if (request.amount <= 0n) {\n      throw new Error(\"handleSwap: amount must be positive\");\n    }\n\n    const { usdt, pafiFeeRecipient } = getContractAddresses(request.chainId);\n    const universalRouter = UNIVERSAL_ROUTER_ADDRESSES[request.chainId];\n    if (!universalRouter) {\n      throw new Error(`handleSwap: no UniversalRouter for chainId ${request.chainId}`);\n    }\n\n    const pointTokenAddress = getAddress(request.pointTokenAddress);\n    const userAddress = getAddress(request.userAddress);\n    const pools = request.pools ?? [];\n    const slippageBps = request.slippageBps ?? 50;\n\n    // Resolve the operator fee:\n    // - undefined → auto-quote via Chainlink + V4 subgraph\n    // - 0n        → unsponsored mode, strip fee transfer\n    // - bigint    → explicit override\n    const gasFeePt =\n      request.gasFeePt !== undefined\n        ? request.gasFeePt\n        : await quoteOperatorFeePt({\n            provider: this.provider,\n            chainId: request.chainId,\n            pointTokenAddress,\n          });\n\n    let quoteResult: Awaited<ReturnType<typeof findBestQuote>>;\n    try {\n      quoteResult = await findBestQuote(\n        this.provider,\n        request.chainId,\n        pointTokenAddress,\n        usdt,\n        request.amount,\n        pools,\n      );\n    } catch {\n      throw new Error(\"handleSwap: no swap path found for this point token\");\n    }\n\n    const estimatedUsdtOut = quoteResult.bestRoute.amountOut;\n    const minAmountOut = (estimatedUsdtOut * BigInt(10000 - slippageBps)) / 10000n;\n    const deadline = BigInt(Math.floor(Date.now() / 1000) + 5 * 60);\n\n    const userOp = buildSwapWithGasDeduction({\n      userAddress,\n      aaNonce: request.aaNonce,\n      pointTokenAddress,\n      outputTokenAddress: usdt,\n      universalRouterAddress: universalRouter,\n      amountIn: request.amount,\n      minAmountOut,\n      swapPath: quoteResult.bestRoute.path,\n      deadline,\n      gasFeePt,\n      // Recipient is always PAFI's canonical address — sponsor-relayer's\n      // L1 gate will reject any other recipient anyway. No override.\n      feeRecipient: pafiFeeRecipient,\n    });\n\n    // Fee-stripped variant for the paymaster-refused fallback path.\n    // Building it is essentially free (same quote, same path, just\n    // skip the PT.transfer call) so always emit it when fee > 0; the\n    // FE feeds it to `sendWithPaymasterFallback({ txParamsFallback })`.\n    const userOpFallback =\n      gasFeePt > 0n\n        ? buildSwapWithGasDeduction({\n            userAddress,\n            aaNonce: request.aaNonce,\n            pointTokenAddress,\n            outputTokenAddress: usdt,\n            universalRouterAddress: universalRouter,\n            amountIn: request.amount,\n            minAmountOut,\n            swapPath: quoteResult.bestRoute.path,\n            deadline,\n            gasFeePt: 0n,\n            feeRecipient: userAddress,\n          })\n        : undefined;\n\n    return {\n      userOp,\n      userOpFallback,\n      estimatedUsdtOut,\n      minAmountOut,\n      deadline,\n      feeAmountUsed: gasFeePt,\n      feeRecipient: pafiFeeRecipient,\n    };\n  }\n\n  // =========================================================================\n  // POST /perp-deposit\n  // =========================================================================\n\n  /**\n   * Build an Orderly perp deposit UserOp.\n   *\n   * Default path is the **PAFI Orderly Relay** (`viaRelay: true`):\n   * USDC.approve(relay) + relay.deposit(req). The Relay holds an ETH\n   * reserve and pays Orderly's LayerZero `msg.value` out of it; the\n   * user pays a USDC fee (quoted via `Relay.quoteTokenFee`) instead.\n   * No native ETH on the user wallet is required, so paymaster\n   * sponsorship of the ERC-4337 gas is sufficient end-to-end.\n   *\n   * Fallback path (`viaRelay: false`): direct `Vault.deposit{value}`.\n   * Reserved for chains where no Relay is deployed — the user wallet\n   * **must** hold `layerZeroFee` as native ETH.\n   *\n   * The Relay path automatically falls back to Vault when\n   * `getContractAddresses(chainId).orderlyRelay` is the placeholder\n   * sentinel (Relay not deployed for that chain).\n   */\n  async handlePerpDeposit(request: ApiPerpDepositRequest): Promise<ApiPerpDepositResponse> {\n    if (request.chainId !== this.chainId) {\n      throw new Error(`handlePerpDeposit: unsupported chainId ${request.chainId}`);\n    }\n    if (request.amount <= 0n) {\n      throw new Error(\"handlePerpDeposit: amount must be positive\");\n    }\n\n    const vault = ORDERLY_VAULT_ADDRESSES[request.chainId];\n    if (!vault) {\n      throw new Error(`handlePerpDeposit: no Orderly Vault for chainId ${request.chainId}`);\n    }\n\n    const brokerHash = BROKER_HASHES[request.brokerId as keyof typeof BROKER_HASHES];\n    if (!brokerHash) {\n      throw new Error(`handlePerpDeposit: unknown brokerId \"${request.brokerId}\"`);\n    }\n    const tokenHash = TOKEN_HASHES.USDC;\n    const userAddress = getAddress(request.userAddress);\n\n    const [usdcAddress, brokerAllowed] = await Promise.all([\n      this.provider.readContract({\n        address: vault,\n        abi: ORDERLY_VAULT_ABI,\n        functionName: \"getAllowedToken\",\n        args: [tokenHash],\n      }) as Promise<Address>,\n      this.provider.readContract({\n        address: vault,\n        abi: ORDERLY_VAULT_ABI,\n        functionName: \"getAllowedBroker\",\n        args: [brokerHash],\n      }) as Promise<boolean>,\n    ]);\n\n    if (!brokerAllowed) {\n      throw new Error(\n        `handlePerpDeposit: broker \"${request.brokerId}\" is not whitelisted on Orderly Vault`,\n      );\n    }\n\n    const accountId = computeAccountId(userAddress, brokerHash);\n    const depositData = {\n      accountId,\n      brokerHash,\n      tokenHash,\n      tokenAmount: request.amount,\n    };\n\n    // Always read layerZeroFee for response — even on the Relay path\n    // it's useful informational output (lets the FE show \"Relay\n    // covers ~X ETH for you\").\n    const layerZeroFee = (await this.provider.readContract({\n      address: vault,\n      abi: ORDERLY_VAULT_ABI,\n      functionName: \"getDepositFee\",\n      args: [userAddress, depositData],\n    })) as bigint;\n\n    const useRelay = request.viaRelay !== false;\n    const { orderlyRelay: relayAddress, pafiFeeRecipient } =\n      getContractAddresses(request.chainId);\n    const relayDeployed = !isPlaceholderAddress(relayAddress);\n\n    // Resolve operator fee — same auto/explicit/zero semantics as\n    // handleSwap. Only applied to the Relay path; the legacy direct\n    // Vault path skips operator fee entirely (it's already gas-heavy\n    // due to the user-paid LayerZero msg.value, and PAFI doesn't\n    // sponsor that path on Base anyway).\n    const gasFeePt =\n      request.gasFeePt !== undefined\n        ? request.gasFeePt\n        : useRelay && relayDeployed && request.pointTokenAddress\n          ? await quoteOperatorFeePt({\n              provider: this.provider,\n              chainId: request.chainId,\n              pointTokenAddress: getAddress(request.pointTokenAddress),\n            })\n          : 0n;\n\n    if (useRelay && relayDeployed) {\n      // Cap = max(amount * 5%, 2 USDC). The Relay fee is a flat USDC\n      // amount derived from the LayerZero ETH cost at oracle price —\n      // it does NOT scale with deposit size. A pure percentage cap\n      // breaks for small deposits (e.g. 0.01 USDC test deposit, 5%\n      // cap = 500 wei < 14k wei real fee). The 2 USDC floor covers\n      // normal LayerZero pricing on Base; the 5% slope still guards\n      // against oracle spikes on large deposits.\n      const RELAY_FEE_FLOOR_USDC = 2_000_000n; // 2 USDC (6 decimals)\n      const percentCap = (request.amount * 500n) / 10_000n;\n      const maxRelayFee =\n        request.maxRelayFee ??\n        (percentCap > RELAY_FEE_FLOOR_USDC ? percentCap : RELAY_FEE_FLOOR_USDC);\n\n      const relayRequest = {\n        token: usdcAddress,\n        receiver: userAddress,\n        brokerHash,\n        totalAmount: request.amount,\n        maxFee: maxRelayFee,\n      };\n\n      const relayTokenFee = (await this.provider.readContract({\n        address: relayAddress,\n        abi: ORDERLY_RELAY_ABI,\n        functionName: \"quoteTokenFee\",\n        args: [relayRequest],\n      })) as bigint;\n\n      if (relayTokenFee > maxRelayFee) {\n        throw new Error(\n          `handlePerpDeposit: Relay tokenFee ${relayTokenFee} (≈ ${\n            Number(relayTokenFee) / 1e6\n          } USDC) exceeds maxRelayFee ${maxRelayFee} — pass a larger ` +\n            `\\`maxRelayFee\\` or increase the deposit \\`amount\\` so the fee ` +\n            `becomes a smaller share of the total.`,\n        );\n      }\n\n      // Sanity-check: Relay forwards `(totalAmount − tokenFee)` to\n      // Orderly Vault. When `tokenFee >= totalAmount` the forwarded\n      // amount is zero / negative and the Relay reverts on-chain with\n      // `FeeExceedsAmount(fee, totalAmount)` (selector 0x536766bf),\n      // which propagates as an opaque `BatchExecutor.CallFailed(1, …)`\n      // revert at simulation time. Catch this early on the client so\n      // the UX shows an actionable message instead of an AA21/AA34\n      // bundler error wrapped around the raw selector.\n      if (relayTokenFee >= request.amount) {\n        const feeUsdc = Number(relayTokenFee) / 1e6;\n        const amountUsdc = Number(request.amount) / 1e6;\n        throw new Error(\n          `handlePerpDeposit: deposit amount ${amountUsdc} USDC is below the ` +\n            `Relay fee ${feeUsdc} USDC — increase \\`amount\\` to at least ` +\n            `${(feeUsdc * 2).toFixed(6)} USDC so a meaningful balance reaches ` +\n            `your Orderly account after the Relay charge.`,\n        );\n      }\n\n      const userOp = buildPerpDepositViaRelay({\n        userAddress,\n        aaNonce: request.aaNonce,\n        relayAddress,\n        request: relayRequest,\n        // Only attach the PT-fee transfer when the caller actually\n        // supplies a PointToken; otherwise the SDK has no token to\n        // transfer from. `gasFeePt` resolves to 0 in that case via the\n        // ?? chain above, so the call below collapses to a no-op\n        // batch (USDC.approve + relay.deposit only).\n        pointTokenAddress: request.pointTokenAddress,\n        gasFeePt: gasFeePt > 0n ? gasFeePt : undefined,\n        gasFeePtRecipient: gasFeePt > 0n ? pafiFeeRecipient : undefined,\n      });\n\n      // Same shape, no PT fee transfer — for the paymaster-refused\n      // fallback path. The Relay still charges its USDC token-fee\n      // (that compensates LayerZero ETH spend, NOT PAFI's gas).\n      const userOpFallback =\n        gasFeePt > 0n\n          ? buildPerpDepositViaRelay({\n              userAddress,\n              aaNonce: request.aaNonce,\n              relayAddress,\n              request: relayRequest,\n            })\n          : undefined;\n\n      return {\n        userOp,\n        userOpFallback,\n        path: \"relay\",\n        layerZeroFee,\n        relayTokenFee,\n        accountId,\n        brokerHash,\n        usdcAddress,\n        relayAddress,\n        feeAmountUsed: gasFeePt,\n        feeRecipient: pafiFeeRecipient,\n      };\n    }\n\n    // Fallback: direct Vault.deposit{value} — user wallet MUST hold\n    // `layerZeroFee` as native ETH (paymaster does not sponsor msg.value).\n    const userOp = buildPerpDepositWithGasDeduction({\n      userAddress,\n      aaNonce: request.aaNonce,\n      chainId: request.chainId,\n      usdcAddress,\n      amount: request.amount,\n      depositData,\n      layerZeroFee,\n    });\n\n    return {\n      userOp,\n      path: \"vault\",\n      layerZeroFee,\n      relayTokenFee: 0n,\n      accountId,\n      brokerHash,\n      usdcAddress,\n      relayAddress: vault,\n      // Vault path doesn't include the PT operator fee transfer (it's\n      // an unsponsored path on chains without a Relay deployment, and\n      // the user is paying msg.value in ETH already). Echo 0n + the\n      // canonical recipient so the response shape stays consistent.\n      feeAmountUsed: 0n,\n      feeRecipient: pafiFeeRecipient,\n    };\n  }\n}\n\n/**\n * `addresses.ts` uses `0x000…<suffix>` sentinels for chains where a\n * given contract is not yet deployed. Detect them by upper-160-bits =\n * 0 so we route to the Vault fallback automatically.\n */\nfunction isPlaceholderAddress(addr: Address): boolean {\n  return /^0x0{36}[0-9a-fA-F]{4}$/i.test(addr);\n}\n","// Re-export from @pafi-dev/core — fetchPafiPools lives in core so all\n// SDK packages share one implementation.\nexport { fetchPafiPools, PAFI_SUBGRAPH_URL } from \"@pafi-dev/core\";\n"],"mappings":"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","names":["userOp","import_core"]}

package/dist/index.d.cts

@@ -33,12 +33,21 @@ interface ApiSwapRequest {
     /** PT/USDT pools. Combined with COMMON_POOLS. Pass empty to use only COMMON_POOLS. */
     pools?: PoolKey[];
     /**
-     * PT amount deducted from user balance as operator gas fee.
-     * Default: 0n (no fee deduction). When > 0, `feeRecipient` is required.
+     * PT operator fee (paid to PAFI fee recipient as reimbursement for
+     * sponsoring ERC-4337 gas).
+     *
+     * - `undefined` (default): handler auto-quotes via Chainlink + V4
+     *   subgraph using `quoteOperatorFeePt` from `@pafi-dev/core`.
+     *   Recommended for normal usage — caller doesn't need to know the
+     *   fee policy or pre-fetch oracle data.
+     * - `0n`: strip the `PT.transfer(pafiFeeRecipient, ...)` call (used
+     *   for the unsponsored fallback path — user pays ETH gas
+     *   themselves so there's nothing to reimburse).
+     * - explicit `bigint`: override for issuer markup / subsidy
+     *   scenarios. Sponsor-relayer's `FeeValidator` enforces a 5%
+     *   tolerance vs its own quote — too low → `INSUFFICIENT_FEE`.
      */
     gasFeePt?: bigint;
-    /** Recipient of the gasFeePt deduction. Required when gasFeePt > 0. */
-    feeRecipient?: Address;
 }
 interface ApiSwapResponse {
     /** Unsigned UserOp — attach paymaster data + user signature, then submit to Bundler. */
@@ -60,6 +69,18 @@ interface ApiSwapResponse {
     minAmountOut: bigint;
     /** Swap deadline (unix seconds). Re-request if user doesn't submit in time. */
     deadline: bigint;
+    /**
+     * Actual PT fee amount the handler embedded in the sponsored
+     * UserOp. Echoes the auto-quote result (or the explicit override).
+     * `0n` when the caller forced no-fee mode.
+     */
+    feeAmountUsed: bigint;
+    /**
+     * Recipient address used for the PT fee transfer (always
+     * `getContractAddresses(chainId).pafiFeeRecipient`). Echoed for
+     * client-side verification before signing.
+     */
+    feeRecipient: Address;
 }
 interface ApiPerpDepositRequest {
     chainId: number;
@@ -106,14 +127,22 @@ interface ApiPerpDepositRequest {
      */
     maxRelayFee?: bigint;
     /**
-     * Optional PT gas-fee transfer prepended to the batch (sponsored
-     * flow — issuer reimburses PAFI in PT for the ERC-4337 gas it
-     * sponsored). Set both `gasFeePt` and `gasFeePtRecipient`, or pass
-     * neither for the unsponsored fallback path.
+     * Address of the user's PointToken — required when the operator-fee
+     * transfer is included in the batch (every sponsored path). When
+     * omitted, the handler skips the fee transfer entirely; useful for
+     * the unsponsored fallback variant.
      */
     pointTokenAddress?: Address;
+    /**
+     * PT operator fee. Same semantics as `ApiSwapRequest.gasFeePt`:
+     * - `undefined` (default): auto-quote via `quoteOperatorFeePt`
+     * - `0n`: strip fee transfer (force unsponsored mode)
+     * - explicit `bigint`: override
+     *
+     * `pointTokenAddress` must be set whenever the fee transfer is
+     * actually included (i.e. when fee resolves to > 0).
+     */
     gasFeePt?: bigint;
-    gasFeePtRecipient?: Address;
 }
 interface ApiPerpDepositResponse {
     /** Unsigned UserOp — attach paymaster data + user signature, then submit to Bundler. */
@@ -124,6 +153,10 @@ interface ApiPerpDepositResponse {
      * Submit when the paymaster refuses — see `ApiSwapResponse.userOpFallback`.
      */
     userOpFallback?: PartialUserOperation;
+    /** Actual PT fee amount embedded — echoes auto-quote or override. `0n` if no-fee mode. */
+    feeAmountUsed: bigint;
+    /** Recipient used for the fee transfer (= `pafiFeeRecipient`). */
+    feeRecipient: Address;
     /**
      * Which execution path the handler chose.
      * - `"relay"`: zero-ETH path — paymaster sponsorship alone is sufficient.

package/dist/index.d.ts

@@ -33,12 +33,21 @@ interface ApiSwapRequest {
     /** PT/USDT pools. Combined with COMMON_POOLS. Pass empty to use only COMMON_POOLS. */
     pools?: PoolKey[];
     /**
-     * PT amount deducted from user balance as operator gas fee.
-     * Default: 0n (no fee deduction). When > 0, `feeRecipient` is required.
+     * PT operator fee (paid to PAFI fee recipient as reimbursement for
+     * sponsoring ERC-4337 gas).
+     *
+     * - `undefined` (default): handler auto-quotes via Chainlink + V4
+     *   subgraph using `quoteOperatorFeePt` from `@pafi-dev/core`.
+     *   Recommended for normal usage — caller doesn't need to know the
+     *   fee policy or pre-fetch oracle data.
+     * - `0n`: strip the `PT.transfer(pafiFeeRecipient, ...)` call (used
+     *   for the unsponsored fallback path — user pays ETH gas
+     *   themselves so there's nothing to reimburse).
+     * - explicit `bigint`: override for issuer markup / subsidy
+     *   scenarios. Sponsor-relayer's `FeeValidator` enforces a 5%
+     *   tolerance vs its own quote — too low → `INSUFFICIENT_FEE`.
      */
     gasFeePt?: bigint;
-    /** Recipient of the gasFeePt deduction. Required when gasFeePt > 0. */
-    feeRecipient?: Address;
 }
 interface ApiSwapResponse {
     /** Unsigned UserOp — attach paymaster data + user signature, then submit to Bundler. */
@@ -60,6 +69,18 @@ interface ApiSwapResponse {
     minAmountOut: bigint;
     /** Swap deadline (unix seconds). Re-request if user doesn't submit in time. */
     deadline: bigint;
+    /**
+     * Actual PT fee amount the handler embedded in the sponsored
+     * UserOp. Echoes the auto-quote result (or the explicit override).
+     * `0n` when the caller forced no-fee mode.
+     */
+    feeAmountUsed: bigint;
+    /**
+     * Recipient address used for the PT fee transfer (always
+     * `getContractAddresses(chainId).pafiFeeRecipient`). Echoed for
+     * client-side verification before signing.
+     */
+    feeRecipient: Address;
 }
 interface ApiPerpDepositRequest {
     chainId: number;
@@ -106,14 +127,22 @@ interface ApiPerpDepositRequest {
      */
     maxRelayFee?: bigint;
     /**
-     * Optional PT gas-fee transfer prepended to the batch (sponsored
-     * flow — issuer reimburses PAFI in PT for the ERC-4337 gas it
-     * sponsored). Set both `gasFeePt` and `gasFeePtRecipient`, or pass
-     * neither for the unsponsored fallback path.
+     * Address of the user's PointToken — required when the operator-fee
+     * transfer is included in the batch (every sponsored path). When
+     * omitted, the handler skips the fee transfer entirely; useful for
+     * the unsponsored fallback variant.
      */
     pointTokenAddress?: Address;
+    /**
+     * PT operator fee. Same semantics as `ApiSwapRequest.gasFeePt`:
+     * - `undefined` (default): auto-quote via `quoteOperatorFeePt`
+     * - `0n`: strip fee transfer (force unsponsored mode)
+     * - explicit `bigint`: override
+     *
+     * `pointTokenAddress` must be set whenever the fee transfer is
+     * actually included (i.e. when fee resolves to > 0).
+     */
     gasFeePt?: bigint;
-    gasFeePtRecipient?: Address;
 }
 interface ApiPerpDepositResponse {
     /** Unsigned UserOp — attach paymaster data + user signature, then submit to Bundler. */
@@ -124,6 +153,10 @@ interface ApiPerpDepositResponse {
      * Submit when the paymaster refuses — see `ApiSwapResponse.userOpFallback`.
      */
     userOpFallback?: PartialUserOperation;
+    /** Actual PT fee amount embedded — echoes auto-quote or override. `0n` if no-fee mode. */
+    feeAmountUsed: bigint;
+    /** Recipient used for the fee transfer (= `pafiFeeRecipient`). */
+    feeRecipient: Address;
     /**
      * Which execution path the handler chose.
      * - `"relay"`: zero-ETH path — paymaster sponsorship alone is sufficient.

package/dist/index.js

@@ -12,7 +12,8 @@ import {
   ORDERLY_VAULT_ADDRESSES,
   BROKER_HASHES,
   TOKEN_HASHES,
-  computeAccountId
+  computeAccountId,
+  quoteOperatorFeePt
 } from "@pafi-dev/core";
 var TradingHandlers = class {
   provider;
@@ -84,7 +85,7 @@ var TradingHandlers = class {
     if (request.amount <= 0n) {
       throw new Error("handleSwap: amount must be positive");
     }
-    const { usdt } = getContractAddresses(request.chainId);
+    const { usdt, pafiFeeRecipient } = getContractAddresses(request.chainId);
     const universalRouter = UNIVERSAL_ROUTER_ADDRESSES[request.chainId];
     if (!universalRouter) {
       throw new Error(`handleSwap: no UniversalRouter for chainId ${request.chainId}`);
@@ -93,10 +94,11 @@ var TradingHandlers = class {
     const userAddress = getAddress(request.userAddress);
     const pools = request.pools ?? [];
     const slippageBps = request.slippageBps ?? 50;
-    const gasFeePt = request.gasFeePt ?? 0n;
-    if (gasFeePt > 0n && !request.feeRecipient) {
-      throw new Error("handleSwap: feeRecipient required when gasFeePt > 0");
-    }
+    const gasFeePt = request.gasFeePt !== void 0 ? request.gasFeePt : await quoteOperatorFeePt({
+      provider: this.provider,
+      chainId: request.chainId,
+      pointTokenAddress
+    });
     let quoteResult;
     try {
       quoteResult = await findBestQuote(
@@ -124,7 +126,9 @@ var TradingHandlers = class {
       swapPath: quoteResult.bestRoute.path,
       deadline,
       gasFeePt,
-      feeRecipient: request.feeRecipient ?? userAddress
+      // Recipient is always PAFI's canonical address — sponsor-relayer's
+      // L1 gate will reject any other recipient anyway. No override.
+      feeRecipient: pafiFeeRecipient
     });
     const userOpFallback = gasFeePt > 0n ? buildSwapWithGasDeduction({
       userAddress,
@@ -139,7 +143,15 @@ var TradingHandlers = class {
       gasFeePt: 0n,
       feeRecipient: userAddress
     }) : void 0;
-    return { userOp, userOpFallback, estimatedUsdtOut, minAmountOut, deadline };
+    return {
+      userOp,
+      userOpFallback,
+      estimatedUsdtOut,
+      minAmountOut,
+      deadline,
+      feeAmountUsed: gasFeePt,
+      feeRecipient: pafiFeeRecipient
+    };
   }
   // =========================================================================
   // POST /perp-deposit
@@ -212,8 +224,13 @@ var TradingHandlers = class {
       args: [userAddress, depositData]
     });
     const useRelay = request.viaRelay !== false;
-    const relayAddress = getContractAddresses(request.chainId).orderlyRelay;
+    const { orderlyRelay: relayAddress, pafiFeeRecipient } = getContractAddresses(request.chainId);
     const relayDeployed = !isPlaceholderAddress(relayAddress);
+    const gasFeePt = request.gasFeePt !== void 0 ? request.gasFeePt : useRelay && relayDeployed && request.pointTokenAddress ? await quoteOperatorFeePt({
+      provider: this.provider,
+      chainId: request.chainId,
+      pointTokenAddress: getAddress(request.pointTokenAddress)
+    }) : 0n;
     if (useRelay && relayDeployed) {
       const RELAY_FEE_FLOOR_USDC = 2000000n;
       const percentCap = request.amount * 500n / 10000n;
@@ -248,11 +265,16 @@ var TradingHandlers = class {
         aaNonce: request.aaNonce,
         relayAddress,
         request: relayRequest,
+        // Only attach the PT-fee transfer when the caller actually
+        // supplies a PointToken; otherwise the SDK has no token to
+        // transfer from. `gasFeePt` resolves to 0 in that case via the
+        // ?? chain above, so the call below collapses to a no-op
+        // batch (USDC.approve + relay.deposit only).
         pointTokenAddress: request.pointTokenAddress,
-        gasFeePt: request.gasFeePt,
-        gasFeePtRecipient: request.gasFeePtRecipient
+        gasFeePt: gasFeePt > 0n ? gasFeePt : void 0,
+        gasFeePtRecipient: gasFeePt > 0n ? pafiFeeRecipient : void 0
       });
-      const userOpFallback = request.gasFeePt && request.gasFeePt > 0n ? buildPerpDepositViaRelay({
+      const userOpFallback = gasFeePt > 0n ? buildPerpDepositViaRelay({
         userAddress,
         aaNonce: request.aaNonce,
         relayAddress,
@@ -267,7 +289,9 @@ var TradingHandlers = class {
         accountId,
         brokerHash,
         usdcAddress,
-        relayAddress
+        relayAddress,
+        feeAmountUsed: gasFeePt,
+        feeRecipient: pafiFeeRecipient
       };
     }
     const userOp = buildPerpDepositWithGasDeduction({
@@ -287,7 +311,13 @@ var TradingHandlers = class {
       accountId,
       brokerHash,
       usdcAddress,
-      relayAddress: vault
+      relayAddress: vault,
+      // Vault path doesn't include the PT operator fee transfer (it's
+      // an unsponsored path on chains without a Relay deployment, and
+      // the user is paying msg.value in ETH already). Echo 0n + the
+      // canonical recipient so the response shape stays consistent.
+      feeAmountUsed: 0n,
+      feeRecipient: pafiFeeRecipient
     };
   }
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/api/handlers.ts","../src/pools.ts"],"sourcesContent":["import { getAddress } from \"viem\";\nimport type { Address, PublicClient } from \"viem\";\nimport {\n  findBestQuote,\n  buildSwapWithGasDeduction,\n  buildPerpDepositWithGasDeduction,\n  buildPerpDepositViaRelay,\n  ORDERLY_RELAY_ABI,\n  getContractAddresses,\n  UNIVERSAL_ROUTER_ADDRESSES,\n  ORDERLY_VAULT_ABI,\n  ORDERLY_VAULT_ADDRESSES,\n  BROKER_HASHES,\n  TOKEN_HASHES,\n  computeAccountId,\n} from \"@pafi-dev/core\";\nimport type {\n  ApiQuoteRequest,\n  ApiQuoteResponse,\n  ApiSwapRequest,\n  ApiSwapResponse,\n  ApiPerpDepositRequest,\n  ApiPerpDepositResponse,\n} from \"./types\";\n\nexport interface TradingHandlersConfig {\n  provider: PublicClient;\n  chainId: number;\n}\n\n/**\n * Framework-agnostic handlers for on-chain trading actions.\n *\n * All handlers are stateless — they need only a PublicClient for RPC\n * calls. No ledger, no signer, no DB. Issuers wrap these in their own\n * HTTP controllers (Express / NestJS / Hono / etc.) the same way they\n * wrap `IssuerApiHandlers` from `@pafi-dev/issuer`.\n *\n * Example (NestJS):\n *\n *   const trading = new TradingHandlers({ provider, chainId });\n *\n *   // GET /quote\n *   const quote = await trading.handleQuote({ chainId, pointTokenAddress, amount, pools });\n *\n *   // POST /swap\n *   const swap = await trading.handleSwap({ chainId, userAddress, pointTokenAddress, amount, aaNonce });\n *\n *   // POST /perp-deposit\n *   const deposit = await trading.handlePerpDeposit({ chainId, userAddress, amount, aaNonce, brokerId });\n */\nexport class TradingHandlers {\n  private readonly provider: PublicClient;\n  private readonly chainId: number;\n\n  constructor(config: TradingHandlersConfig) {\n    this.provider = config.provider;\n    this.chainId = config.chainId;\n  }\n\n  // =========================================================================\n  // GET /quote\n  // =========================================================================\n\n  /**\n   * Quote exact-input PT → USDT via Uniswap V4 on-chain Quoter.\n   *\n   * Uses multicall to batch all candidate routes into a single RPC call.\n   * Returns `quoteError: \"QUOTE_UNAVAILABLE\"` when no pool/path exists\n   * rather than throwing, so callers can show a soft \"unavailable\" UI\n   * state without 500-ing.\n   */\n  async handleQuote(request: ApiQuoteRequest): Promise<ApiQuoteResponse> {\n    if (request.chainId !== this.chainId) {\n      throw new Error(`handleQuote: unsupported chainId ${request.chainId}`);\n    }\n    if (request.amount === 0n) {\n      return { pointAmount: 0n, estimatedUsdtOut: 0n, gasEstimate: 0n };\n    }\n\n    const { usdt } = getContractAddresses(request.chainId);\n    const pointTokenAddress = getAddress(request.pointTokenAddress);\n    const pools = request.pools ?? [];\n\n    try {\n      const best = await findBestQuote(\n        this.provider,\n        request.chainId,\n        pointTokenAddress,\n        usdt,\n        request.amount,\n        pools,\n      );\n      return {\n        pointAmount: request.amount,\n        estimatedUsdtOut: best.bestRoute.amountOut,\n        gasEstimate: best.bestRoute.gasEstimate,\n      };\n    } catch {\n      return {\n        pointAmount: request.amount,\n        estimatedUsdtOut: 0n,\n        gasEstimate: 0n,\n        quoteError: \"QUOTE_UNAVAILABLE\",\n      };\n    }\n  }\n\n  // =========================================================================\n  // POST /swap\n  // =========================================================================\n\n  /**\n   * Build a PT → USDT swap UserOp.\n   *\n   * Quotes the best route, applies slippage, then encodes a 4-step\n   * batch: PT.approve → Permit2.approve → UniversalRouter.execute →\n   * PT.transfer (fee, omitted when gasFeePt = 0). Returns an unsigned\n   * `PartialUserOperation`; caller attaches paymaster data + user\n   * signature and submits to the Bundler.\n   */\n  async handleSwap(request: ApiSwapRequest): Promise<ApiSwapResponse> {\n    if (request.chainId !== this.chainId) {\n      throw new Error(`handleSwap: unsupported chainId ${request.chainId}`);\n    }\n    if (request.amount <= 0n) {\n      throw new Error(\"handleSwap: amount must be positive\");\n    }\n\n    const { usdt } = getContractAddresses(request.chainId);\n    const universalRouter = UNIVERSAL_ROUTER_ADDRESSES[request.chainId];\n    if (!universalRouter) {\n      throw new Error(`handleSwap: no UniversalRouter for chainId ${request.chainId}`);\n    }\n\n    const pointTokenAddress = getAddress(request.pointTokenAddress);\n    const userAddress = getAddress(request.userAddress);\n    const pools = request.pools ?? [];\n    const slippageBps = request.slippageBps ?? 50;\n    const gasFeePt = request.gasFeePt ?? 0n;\n\n    if (gasFeePt > 0n && !request.feeRecipient) {\n      throw new Error(\"handleSwap: feeRecipient required when gasFeePt > 0\");\n    }\n\n    let quoteResult: Awaited<ReturnType<typeof findBestQuote>>;\n    try {\n      quoteResult = await findBestQuote(\n        this.provider,\n        request.chainId,\n        pointTokenAddress,\n        usdt,\n        request.amount,\n        pools,\n      );\n    } catch {\n      throw new Error(\"handleSwap: no swap path found for this point token\");\n    }\n\n    const estimatedUsdtOut = quoteResult.bestRoute.amountOut;\n    const minAmountOut = (estimatedUsdtOut * BigInt(10000 - slippageBps)) / 10000n;\n    const deadline = BigInt(Math.floor(Date.now() / 1000) + 5 * 60);\n\n    const userOp = buildSwapWithGasDeduction({\n      userAddress,\n      aaNonce: request.aaNonce,\n      pointTokenAddress,\n      outputTokenAddress: usdt,\n      universalRouterAddress: universalRouter,\n      amountIn: request.amount,\n      minAmountOut,\n      swapPath: quoteResult.bestRoute.path,\n      deadline,\n      gasFeePt,\n      feeRecipient: request.feeRecipient ?? userAddress,\n    });\n\n    // Fee-stripped variant for the paymaster-refused fallback path.\n    // Building it is essentially free (same quote, same path, just\n    // skip the PT.transfer call) so always emit it when fee > 0; the\n    // FE feeds it to `sendWithPaymasterFallback({ txParamsFallback })`.\n    const userOpFallback =\n      gasFeePt > 0n\n        ? buildSwapWithGasDeduction({\n            userAddress,\n            aaNonce: request.aaNonce,\n            pointTokenAddress,\n            outputTokenAddress: usdt,\n            universalRouterAddress: universalRouter,\n            amountIn: request.amount,\n            minAmountOut,\n            swapPath: quoteResult.bestRoute.path,\n            deadline,\n            gasFeePt: 0n,\n            feeRecipient: userAddress,\n          })\n        : undefined;\n\n    return { userOp, userOpFallback, estimatedUsdtOut, minAmountOut, deadline };\n  }\n\n  // =========================================================================\n  // POST /perp-deposit\n  // =========================================================================\n\n  /**\n   * Build an Orderly perp deposit UserOp.\n   *\n   * Default path is the **PAFI Orderly Relay** (`viaRelay: true`):\n   * USDC.approve(relay) + relay.deposit(req). The Relay holds an ETH\n   * reserve and pays Orderly's LayerZero `msg.value` out of it; the\n   * user pays a USDC fee (quoted via `Relay.quoteTokenFee`) instead.\n   * No native ETH on the user wallet is required, so paymaster\n   * sponsorship of the ERC-4337 gas is sufficient end-to-end.\n   *\n   * Fallback path (`viaRelay: false`): direct `Vault.deposit{value}`.\n   * Reserved for chains where no Relay is deployed — the user wallet\n   * **must** hold `layerZeroFee` as native ETH.\n   *\n   * The Relay path automatically falls back to Vault when\n   * `getContractAddresses(chainId).orderlyRelay` is the placeholder\n   * sentinel (Relay not deployed for that chain).\n   */\n  async handlePerpDeposit(request: ApiPerpDepositRequest): Promise<ApiPerpDepositResponse> {\n    if (request.chainId !== this.chainId) {\n      throw new Error(`handlePerpDeposit: unsupported chainId ${request.chainId}`);\n    }\n    if (request.amount <= 0n) {\n      throw new Error(\"handlePerpDeposit: amount must be positive\");\n    }\n\n    const vault = ORDERLY_VAULT_ADDRESSES[request.chainId];\n    if (!vault) {\n      throw new Error(`handlePerpDeposit: no Orderly Vault for chainId ${request.chainId}`);\n    }\n\n    const brokerHash = BROKER_HASHES[request.brokerId as keyof typeof BROKER_HASHES];\n    if (!brokerHash) {\n      throw new Error(`handlePerpDeposit: unknown brokerId \"${request.brokerId}\"`);\n    }\n    const tokenHash = TOKEN_HASHES.USDC;\n    const userAddress = getAddress(request.userAddress);\n\n    const [usdcAddress, brokerAllowed] = await Promise.all([\n      this.provider.readContract({\n        address: vault,\n        abi: ORDERLY_VAULT_ABI,\n        functionName: \"getAllowedToken\",\n        args: [tokenHash],\n      }) as Promise<Address>,\n      this.provider.readContract({\n        address: vault,\n        abi: ORDERLY_VAULT_ABI,\n        functionName: \"getAllowedBroker\",\n        args: [brokerHash],\n      }) as Promise<boolean>,\n    ]);\n\n    if (!brokerAllowed) {\n      throw new Error(\n        `handlePerpDeposit: broker \"${request.brokerId}\" is not whitelisted on Orderly Vault`,\n      );\n    }\n\n    const accountId = computeAccountId(userAddress, brokerHash);\n    const depositData = {\n      accountId,\n      brokerHash,\n      tokenHash,\n      tokenAmount: request.amount,\n    };\n\n    // Always read layerZeroFee for response — even on the Relay path\n    // it's useful informational output (lets the FE show \"Relay\n    // covers ~X ETH for you\").\n    const layerZeroFee = (await this.provider.readContract({\n      address: vault,\n      abi: ORDERLY_VAULT_ABI,\n      functionName: \"getDepositFee\",\n      args: [userAddress, depositData],\n    })) as bigint;\n\n    const useRelay = request.viaRelay !== false;\n    const relayAddress = getContractAddresses(request.chainId).orderlyRelay;\n    const relayDeployed = !isPlaceholderAddress(relayAddress);\n\n    if (useRelay && relayDeployed) {\n      // Cap = max(amount * 5%, 2 USDC). The Relay fee is a flat USDC\n      // amount derived from the LayerZero ETH cost at oracle price —\n      // it does NOT scale with deposit size. A pure percentage cap\n      // breaks for small deposits (e.g. 0.01 USDC test deposit, 5%\n      // cap = 500 wei < 14k wei real fee). The 2 USDC floor covers\n      // normal LayerZero pricing on Base; the 5% slope still guards\n      // against oracle spikes on large deposits.\n      const RELAY_FEE_FLOOR_USDC = 2_000_000n; // 2 USDC (6 decimals)\n      const percentCap = (request.amount * 500n) / 10_000n;\n      const maxRelayFee =\n        request.maxRelayFee ??\n        (percentCap > RELAY_FEE_FLOOR_USDC ? percentCap : RELAY_FEE_FLOOR_USDC);\n\n      const relayRequest = {\n        token: usdcAddress,\n        receiver: userAddress,\n        brokerHash,\n        totalAmount: request.amount,\n        maxFee: maxRelayFee,\n      };\n\n      const relayTokenFee = (await this.provider.readContract({\n        address: relayAddress,\n        abi: ORDERLY_RELAY_ABI,\n        functionName: \"quoteTokenFee\",\n        args: [relayRequest],\n      })) as bigint;\n\n      if (relayTokenFee > maxRelayFee) {\n        throw new Error(\n          `handlePerpDeposit: Relay tokenFee ${relayTokenFee} (≈ ${\n            Number(relayTokenFee) / 1e6\n          } USDC) exceeds maxRelayFee ${maxRelayFee} — pass a larger ` +\n            `\\`maxRelayFee\\` or increase the deposit \\`amount\\` so the fee ` +\n            `becomes a smaller share of the total.`,\n        );\n      }\n\n      // Sanity-check: Relay forwards `(totalAmount − tokenFee)` to\n      // Orderly Vault. When `tokenFee >= totalAmount` the forwarded\n      // amount is zero / negative and the Relay reverts on-chain with\n      // `FeeExceedsAmount(fee, totalAmount)` (selector 0x536766bf),\n      // which propagates as an opaque `BatchExecutor.CallFailed(1, …)`\n      // revert at simulation time. Catch this early on the client so\n      // the UX shows an actionable message instead of an AA21/AA34\n      // bundler error wrapped around the raw selector.\n      if (relayTokenFee >= request.amount) {\n        const feeUsdc = Number(relayTokenFee) / 1e6;\n        const amountUsdc = Number(request.amount) / 1e6;\n        throw new Error(\n          `handlePerpDeposit: deposit amount ${amountUsdc} USDC is below the ` +\n            `Relay fee ${feeUsdc} USDC — increase \\`amount\\` to at least ` +\n            `${(feeUsdc * 2).toFixed(6)} USDC so a meaningful balance reaches ` +\n            `your Orderly account after the Relay charge.`,\n        );\n      }\n\n      const userOp = buildPerpDepositViaRelay({\n        userAddress,\n        aaNonce: request.aaNonce,\n        relayAddress,\n        request: relayRequest,\n        pointTokenAddress: request.pointTokenAddress,\n        gasFeePt: request.gasFeePt,\n        gasFeePtRecipient: request.gasFeePtRecipient,\n      });\n\n      // Same shape, no PT fee transfer — for the paymaster-refused\n      // fallback path. The Relay still charges its USDC token-fee\n      // (that compensates LayerZero ETH spend, NOT PAFI's gas).\n      const userOpFallback =\n        request.gasFeePt && request.gasFeePt > 0n\n          ? buildPerpDepositViaRelay({\n              userAddress,\n              aaNonce: request.aaNonce,\n              relayAddress,\n              request: relayRequest,\n            })\n          : undefined;\n\n      return {\n        userOp,\n        userOpFallback,\n        path: \"relay\",\n        layerZeroFee,\n        relayTokenFee,\n        accountId,\n        brokerHash,\n        usdcAddress,\n        relayAddress,\n      };\n    }\n\n    // Fallback: direct Vault.deposit{value} — user wallet MUST hold\n    // `layerZeroFee` as native ETH (paymaster does not sponsor msg.value).\n    const userOp = buildPerpDepositWithGasDeduction({\n      userAddress,\n      aaNonce: request.aaNonce,\n      chainId: request.chainId,\n      usdcAddress,\n      amount: request.amount,\n      depositData,\n      layerZeroFee,\n    });\n\n    return {\n      userOp,\n      path: \"vault\",\n      layerZeroFee,\n      relayTokenFee: 0n,\n      accountId,\n      brokerHash,\n      usdcAddress,\n      relayAddress: vault,\n    };\n  }\n}\n\n/**\n * `addresses.ts` uses `0x000…<suffix>` sentinels for chains where a\n * given contract is not yet deployed. Detect them by upper-160-bits =\n * 0 so we route to the Vault fallback automatically.\n */\nfunction isPlaceholderAddress(addr: Address): boolean {\n  return /^0x0{36}[0-9a-fA-F]{4}$/i.test(addr);\n}\n","// Re-export from @pafi-dev/core — fetchPafiPools lives in core so all\n// SDK packages share one implementation.\nexport { fetchPafiPools, PAFI_SUBGRAPH_URL } from \"@pafi-dev/core\";\n"],"mappings":"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","names":["userOp"]}
+{"version":3,"sources":["../src/api/handlers.ts","../src/pools.ts"],"sourcesContent":["import { getAddress } from \"viem\";\nimport type { Address, PublicClient } from \"viem\";\nimport {\n  findBestQuote,\n  buildSwapWithGasDeduction,\n  buildPerpDepositWithGasDeduction,\n  buildPerpDepositViaRelay,\n  ORDERLY_RELAY_ABI,\n  getContractAddresses,\n  UNIVERSAL_ROUTER_ADDRESSES,\n  ORDERLY_VAULT_ABI,\n  ORDERLY_VAULT_ADDRESSES,\n  BROKER_HASHES,\n  TOKEN_HASHES,\n  computeAccountId,\n  quoteOperatorFeePt,\n} from \"@pafi-dev/core\";\nimport type {\n  ApiQuoteRequest,\n  ApiQuoteResponse,\n  ApiSwapRequest,\n  ApiSwapResponse,\n  ApiPerpDepositRequest,\n  ApiPerpDepositResponse,\n} from \"./types\";\n\nexport interface TradingHandlersConfig {\n  provider: PublicClient;\n  chainId: number;\n}\n\n/**\n * Framework-agnostic handlers for on-chain trading actions.\n *\n * All handlers are stateless — they need only a PublicClient for RPC\n * calls. No ledger, no signer, no DB. Issuers wrap these in their own\n * HTTP controllers (Express / NestJS / Hono / etc.) the same way they\n * wrap `IssuerApiHandlers` from `@pafi-dev/issuer`.\n *\n * Example (NestJS):\n *\n *   const trading = new TradingHandlers({ provider, chainId });\n *\n *   // GET /quote\n *   const quote = await trading.handleQuote({ chainId, pointTokenAddress, amount, pools });\n *\n *   // POST /swap\n *   const swap = await trading.handleSwap({ chainId, userAddress, pointTokenAddress, amount, aaNonce });\n *\n *   // POST /perp-deposit\n *   const deposit = await trading.handlePerpDeposit({ chainId, userAddress, amount, aaNonce, brokerId });\n */\nexport class TradingHandlers {\n  private readonly provider: PublicClient;\n  private readonly chainId: number;\n\n  constructor(config: TradingHandlersConfig) {\n    this.provider = config.provider;\n    this.chainId = config.chainId;\n  }\n\n  // =========================================================================\n  // GET /quote\n  // =========================================================================\n\n  /**\n   * Quote exact-input PT → USDT via Uniswap V4 on-chain Quoter.\n   *\n   * Uses multicall to batch all candidate routes into a single RPC call.\n   * Returns `quoteError: \"QUOTE_UNAVAILABLE\"` when no pool/path exists\n   * rather than throwing, so callers can show a soft \"unavailable\" UI\n   * state without 500-ing.\n   */\n  async handleQuote(request: ApiQuoteRequest): Promise<ApiQuoteResponse> {\n    if (request.chainId !== this.chainId) {\n      throw new Error(`handleQuote: unsupported chainId ${request.chainId}`);\n    }\n    if (request.amount === 0n) {\n      return { pointAmount: 0n, estimatedUsdtOut: 0n, gasEstimate: 0n };\n    }\n\n    const { usdt } = getContractAddresses(request.chainId);\n    const pointTokenAddress = getAddress(request.pointTokenAddress);\n    const pools = request.pools ?? [];\n\n    try {\n      const best = await findBestQuote(\n        this.provider,\n        request.chainId,\n        pointTokenAddress,\n        usdt,\n        request.amount,\n        pools,\n      );\n      return {\n        pointAmount: request.amount,\n        estimatedUsdtOut: best.bestRoute.amountOut,\n        gasEstimate: best.bestRoute.gasEstimate,\n      };\n    } catch {\n      return {\n        pointAmount: request.amount,\n        estimatedUsdtOut: 0n,\n        gasEstimate: 0n,\n        quoteError: \"QUOTE_UNAVAILABLE\",\n      };\n    }\n  }\n\n  // =========================================================================\n  // POST /swap\n  // =========================================================================\n\n  /**\n   * Build a PT → USDT swap UserOp.\n   *\n   * Quotes the best route, applies slippage, then encodes a 4-step\n   * batch: PT.approve → Permit2.approve → UniversalRouter.execute →\n   * PT.transfer (fee, omitted when gasFeePt = 0). Returns an unsigned\n   * `PartialUserOperation`; caller attaches paymaster data + user\n   * signature and submits to the Bundler.\n   */\n  async handleSwap(request: ApiSwapRequest): Promise<ApiSwapResponse> {\n    if (request.chainId !== this.chainId) {\n      throw new Error(`handleSwap: unsupported chainId ${request.chainId}`);\n    }\n    if (request.amount <= 0n) {\n      throw new Error(\"handleSwap: amount must be positive\");\n    }\n\n    const { usdt, pafiFeeRecipient } = getContractAddresses(request.chainId);\n    const universalRouter = UNIVERSAL_ROUTER_ADDRESSES[request.chainId];\n    if (!universalRouter) {\n      throw new Error(`handleSwap: no UniversalRouter for chainId ${request.chainId}`);\n    }\n\n    const pointTokenAddress = getAddress(request.pointTokenAddress);\n    const userAddress = getAddress(request.userAddress);\n    const pools = request.pools ?? [];\n    const slippageBps = request.slippageBps ?? 50;\n\n    // Resolve the operator fee:\n    // - undefined → auto-quote via Chainlink + V4 subgraph\n    // - 0n        → unsponsored mode, strip fee transfer\n    // - bigint    → explicit override\n    const gasFeePt =\n      request.gasFeePt !== undefined\n        ? request.gasFeePt\n        : await quoteOperatorFeePt({\n            provider: this.provider,\n            chainId: request.chainId,\n            pointTokenAddress,\n          });\n\n    let quoteResult: Awaited<ReturnType<typeof findBestQuote>>;\n    try {\n      quoteResult = await findBestQuote(\n        this.provider,\n        request.chainId,\n        pointTokenAddress,\n        usdt,\n        request.amount,\n        pools,\n      );\n    } catch {\n      throw new Error(\"handleSwap: no swap path found for this point token\");\n    }\n\n    const estimatedUsdtOut = quoteResult.bestRoute.amountOut;\n    const minAmountOut = (estimatedUsdtOut * BigInt(10000 - slippageBps)) / 10000n;\n    const deadline = BigInt(Math.floor(Date.now() / 1000) + 5 * 60);\n\n    const userOp = buildSwapWithGasDeduction({\n      userAddress,\n      aaNonce: request.aaNonce,\n      pointTokenAddress,\n      outputTokenAddress: usdt,\n      universalRouterAddress: universalRouter,\n      amountIn: request.amount,\n      minAmountOut,\n      swapPath: quoteResult.bestRoute.path,\n      deadline,\n      gasFeePt,\n      // Recipient is always PAFI's canonical address — sponsor-relayer's\n      // L1 gate will reject any other recipient anyway. No override.\n      feeRecipient: pafiFeeRecipient,\n    });\n\n    // Fee-stripped variant for the paymaster-refused fallback path.\n    // Building it is essentially free (same quote, same path, just\n    // skip the PT.transfer call) so always emit it when fee > 0; the\n    // FE feeds it to `sendWithPaymasterFallback({ txParamsFallback })`.\n    const userOpFallback =\n      gasFeePt > 0n\n        ? buildSwapWithGasDeduction({\n            userAddress,\n            aaNonce: request.aaNonce,\n            pointTokenAddress,\n            outputTokenAddress: usdt,\n            universalRouterAddress: universalRouter,\n            amountIn: request.amount,\n            minAmountOut,\n            swapPath: quoteResult.bestRoute.path,\n            deadline,\n            gasFeePt: 0n,\n            feeRecipient: userAddress,\n          })\n        : undefined;\n\n    return {\n      userOp,\n      userOpFallback,\n      estimatedUsdtOut,\n      minAmountOut,\n      deadline,\n      feeAmountUsed: gasFeePt,\n      feeRecipient: pafiFeeRecipient,\n    };\n  }\n\n  // =========================================================================\n  // POST /perp-deposit\n  // =========================================================================\n\n  /**\n   * Build an Orderly perp deposit UserOp.\n   *\n   * Default path is the **PAFI Orderly Relay** (`viaRelay: true`):\n   * USDC.approve(relay) + relay.deposit(req). The Relay holds an ETH\n   * reserve and pays Orderly's LayerZero `msg.value` out of it; the\n   * user pays a USDC fee (quoted via `Relay.quoteTokenFee`) instead.\n   * No native ETH on the user wallet is required, so paymaster\n   * sponsorship of the ERC-4337 gas is sufficient end-to-end.\n   *\n   * Fallback path (`viaRelay: false`): direct `Vault.deposit{value}`.\n   * Reserved for chains where no Relay is deployed — the user wallet\n   * **must** hold `layerZeroFee` as native ETH.\n   *\n   * The Relay path automatically falls back to Vault when\n   * `getContractAddresses(chainId).orderlyRelay` is the placeholder\n   * sentinel (Relay not deployed for that chain).\n   */\n  async handlePerpDeposit(request: ApiPerpDepositRequest): Promise<ApiPerpDepositResponse> {\n    if (request.chainId !== this.chainId) {\n      throw new Error(`handlePerpDeposit: unsupported chainId ${request.chainId}`);\n    }\n    if (request.amount <= 0n) {\n      throw new Error(\"handlePerpDeposit: amount must be positive\");\n    }\n\n    const vault = ORDERLY_VAULT_ADDRESSES[request.chainId];\n    if (!vault) {\n      throw new Error(`handlePerpDeposit: no Orderly Vault for chainId ${request.chainId}`);\n    }\n\n    const brokerHash = BROKER_HASHES[request.brokerId as keyof typeof BROKER_HASHES];\n    if (!brokerHash) {\n      throw new Error(`handlePerpDeposit: unknown brokerId \"${request.brokerId}\"`);\n    }\n    const tokenHash = TOKEN_HASHES.USDC;\n    const userAddress = getAddress(request.userAddress);\n\n    const [usdcAddress, brokerAllowed] = await Promise.all([\n      this.provider.readContract({\n        address: vault,\n        abi: ORDERLY_VAULT_ABI,\n        functionName: \"getAllowedToken\",\n        args: [tokenHash],\n      }) as Promise<Address>,\n      this.provider.readContract({\n        address: vault,\n        abi: ORDERLY_VAULT_ABI,\n        functionName: \"getAllowedBroker\",\n        args: [brokerHash],\n      }) as Promise<boolean>,\n    ]);\n\n    if (!brokerAllowed) {\n      throw new Error(\n        `handlePerpDeposit: broker \"${request.brokerId}\" is not whitelisted on Orderly Vault`,\n      );\n    }\n\n    const accountId = computeAccountId(userAddress, brokerHash);\n    const depositData = {\n      accountId,\n      brokerHash,\n      tokenHash,\n      tokenAmount: request.amount,\n    };\n\n    // Always read layerZeroFee for response — even on the Relay path\n    // it's useful informational output (lets the FE show \"Relay\n    // covers ~X ETH for you\").\n    const layerZeroFee = (await this.provider.readContract({\n      address: vault,\n      abi: ORDERLY_VAULT_ABI,\n      functionName: \"getDepositFee\",\n      args: [userAddress, depositData],\n    })) as bigint;\n\n    const useRelay = request.viaRelay !== false;\n    const { orderlyRelay: relayAddress, pafiFeeRecipient } =\n      getContractAddresses(request.chainId);\n    const relayDeployed = !isPlaceholderAddress(relayAddress);\n\n    // Resolve operator fee — same auto/explicit/zero semantics as\n    // handleSwap. Only applied to the Relay path; the legacy direct\n    // Vault path skips operator fee entirely (it's already gas-heavy\n    // due to the user-paid LayerZero msg.value, and PAFI doesn't\n    // sponsor that path on Base anyway).\n    const gasFeePt =\n      request.gasFeePt !== undefined\n        ? request.gasFeePt\n        : useRelay && relayDeployed && request.pointTokenAddress\n          ? await quoteOperatorFeePt({\n              provider: this.provider,\n              chainId: request.chainId,\n              pointTokenAddress: getAddress(request.pointTokenAddress),\n            })\n          : 0n;\n\n    if (useRelay && relayDeployed) {\n      // Cap = max(amount * 5%, 2 USDC). The Relay fee is a flat USDC\n      // amount derived from the LayerZero ETH cost at oracle price —\n      // it does NOT scale with deposit size. A pure percentage cap\n      // breaks for small deposits (e.g. 0.01 USDC test deposit, 5%\n      // cap = 500 wei < 14k wei real fee). The 2 USDC floor covers\n      // normal LayerZero pricing on Base; the 5% slope still guards\n      // against oracle spikes on large deposits.\n      const RELAY_FEE_FLOOR_USDC = 2_000_000n; // 2 USDC (6 decimals)\n      const percentCap = (request.amount * 500n) / 10_000n;\n      const maxRelayFee =\n        request.maxRelayFee ??\n        (percentCap > RELAY_FEE_FLOOR_USDC ? percentCap : RELAY_FEE_FLOOR_USDC);\n\n      const relayRequest = {\n        token: usdcAddress,\n        receiver: userAddress,\n        brokerHash,\n        totalAmount: request.amount,\n        maxFee: maxRelayFee,\n      };\n\n      const relayTokenFee = (await this.provider.readContract({\n        address: relayAddress,\n        abi: ORDERLY_RELAY_ABI,\n        functionName: \"quoteTokenFee\",\n        args: [relayRequest],\n      })) as bigint;\n\n      if (relayTokenFee > maxRelayFee) {\n        throw new Error(\n          `handlePerpDeposit: Relay tokenFee ${relayTokenFee} (≈ ${\n            Number(relayTokenFee) / 1e6\n          } USDC) exceeds maxRelayFee ${maxRelayFee} — pass a larger ` +\n            `\\`maxRelayFee\\` or increase the deposit \\`amount\\` so the fee ` +\n            `becomes a smaller share of the total.`,\n        );\n      }\n\n      // Sanity-check: Relay forwards `(totalAmount − tokenFee)` to\n      // Orderly Vault. When `tokenFee >= totalAmount` the forwarded\n      // amount is zero / negative and the Relay reverts on-chain with\n      // `FeeExceedsAmount(fee, totalAmount)` (selector 0x536766bf),\n      // which propagates as an opaque `BatchExecutor.CallFailed(1, …)`\n      // revert at simulation time. Catch this early on the client so\n      // the UX shows an actionable message instead of an AA21/AA34\n      // bundler error wrapped around the raw selector.\n      if (relayTokenFee >= request.amount) {\n        const feeUsdc = Number(relayTokenFee) / 1e6;\n        const amountUsdc = Number(request.amount) / 1e6;\n        throw new Error(\n          `handlePerpDeposit: deposit amount ${amountUsdc} USDC is below the ` +\n            `Relay fee ${feeUsdc} USDC — increase \\`amount\\` to at least ` +\n            `${(feeUsdc * 2).toFixed(6)} USDC so a meaningful balance reaches ` +\n            `your Orderly account after the Relay charge.`,\n        );\n      }\n\n      const userOp = buildPerpDepositViaRelay({\n        userAddress,\n        aaNonce: request.aaNonce,\n        relayAddress,\n        request: relayRequest,\n        // Only attach the PT-fee transfer when the caller actually\n        // supplies a PointToken; otherwise the SDK has no token to\n        // transfer from. `gasFeePt` resolves to 0 in that case via the\n        // ?? chain above, so the call below collapses to a no-op\n        // batch (USDC.approve + relay.deposit only).\n        pointTokenAddress: request.pointTokenAddress,\n        gasFeePt: gasFeePt > 0n ? gasFeePt : undefined,\n        gasFeePtRecipient: gasFeePt > 0n ? pafiFeeRecipient : undefined,\n      });\n\n      // Same shape, no PT fee transfer — for the paymaster-refused\n      // fallback path. The Relay still charges its USDC token-fee\n      // (that compensates LayerZero ETH spend, NOT PAFI's gas).\n      const userOpFallback =\n        gasFeePt > 0n\n          ? buildPerpDepositViaRelay({\n              userAddress,\n              aaNonce: request.aaNonce,\n              relayAddress,\n              request: relayRequest,\n            })\n          : undefined;\n\n      return {\n        userOp,\n        userOpFallback,\n        path: \"relay\",\n        layerZeroFee,\n        relayTokenFee,\n        accountId,\n        brokerHash,\n        usdcAddress,\n        relayAddress,\n        feeAmountUsed: gasFeePt,\n        feeRecipient: pafiFeeRecipient,\n      };\n    }\n\n    // Fallback: direct Vault.deposit{value} — user wallet MUST hold\n    // `layerZeroFee` as native ETH (paymaster does not sponsor msg.value).\n    const userOp = buildPerpDepositWithGasDeduction({\n      userAddress,\n      aaNonce: request.aaNonce,\n      chainId: request.chainId,\n      usdcAddress,\n      amount: request.amount,\n      depositData,\n      layerZeroFee,\n    });\n\n    return {\n      userOp,\n      path: \"vault\",\n      layerZeroFee,\n      relayTokenFee: 0n,\n      accountId,\n      brokerHash,\n      usdcAddress,\n      relayAddress: vault,\n      // Vault path doesn't include the PT operator fee transfer (it's\n      // an unsponsored path on chains without a Relay deployment, and\n      // the user is paying msg.value in ETH already). Echo 0n + the\n      // canonical recipient so the response shape stays consistent.\n      feeAmountUsed: 0n,\n      feeRecipient: pafiFeeRecipient,\n    };\n  }\n}\n\n/**\n * `addresses.ts` uses `0x000…<suffix>` sentinels for chains where a\n * given contract is not yet deployed. Detect them by upper-160-bits =\n * 0 so we route to the Vault fallback automatically.\n */\nfunction isPlaceholderAddress(addr: Address): boolean {\n  return /^0x0{36}[0-9a-fA-F]{4}$/i.test(addr);\n}\n","// Re-export from @pafi-dev/core — fetchPafiPools lives in core so all\n// SDK packages share one implementation.\nexport { fetchPafiPools, PAFI_SUBGRAPH_URL } from \"@pafi-dev/core\";\n"],"mappings":"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","names":["userOp"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pafi-dev/trading",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Stateless on-chain trading handlers for PAFI — swap, quote, perp deposit",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -22,7 +22,7 @@
     "dist"
   ],
   "dependencies": {
-    "@pafi-dev/core": "0.5.18"
+    "@pafi-dev/core": "0.5.19"
   },
   "peerDependencies": {
     "viem": "^2.0.0"