@pafi-dev/trading 0.1.9 → 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pafi-dev/trading",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Stateless on-chain trading handlers for PAFI — swap, quote, perp deposit",
   "type": "module",
   "main": "./dist/index.cjs",