@pafi-dev/trading 0.1.2 → 0.1.3

package/README.md

@@ -15,7 +15,12 @@ client-side (React, React Native).
 
 - Node.js >= 18 (server) or any modern bundler (client)
 - TypeScript >= 5.0
-- `viem` ^2.0.0 and `@pafi-dev/core` ^0.5.0 (peer dependencies)
+- `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).
 
 ---
 
@@ -65,6 +70,40 @@ const quote = await trading.handleQuote({
 Returns `quoteError` instead of throwing when no pool/path is found, so the caller can
 show a soft "unavailable" UI state without 500-ing.
 
+#### Frontend "quote review" pattern
+
+The mobile / web client should refresh `/quote` whenever the user types a
+new amount, so the swap CTA always shows the exact USDT they will
+receive (after the operator gas fee in USDT). Example: poll
+`GET /quote?chainId&pointToken&amount` on a 400 ms debounce after each
+keystroke and render a card with `pointAmount → estimatedUsdtOut −
+gasFeeUsdt = netUsdtOut` plus the `exchangeRate`.
+
+```tsx
+const [quote, setQuote] = useState<QuoteResponseDto | null>(null);
+
+useEffect(() => {
+  if (!token || amount <= 0n) return setQuote(null);
+  const t = setTimeout(async () => {
+    const url = `${API}/quote?chainId=8453&pointToken=${POINT_TOKEN}&amount=${amount}`;
+    const res = await fetch(url, { headers: { Authorization: `Bearer ${token}` } });
+    setQuote(await res.json());
+  }, 400);
+  return () => clearTimeout(t);
+}, [amount, token]);
+
+// quote.estimatedUsdtOut  → "you will receive ~Y USDT"
+// quote.gasFeeUsdt        → "operator gas fee deducted from output"
+// quote.netUsdtOut        → "actually credited to your wallet"
+// quote.exchangeRate      → "1 PT ≈ ${rate} USDT"
+// quote.quoteError        → render warning, hide the Swap CTA
+```
+
+A working implementation lives in
+[`privy-pimlico-eip7702-example/app/components/WalletPanel.tsx`](https://github.com/pacific-finance/pafi-backend/blob/main/privy-pimlico-eip7702-example/app/components/WalletPanel.tsx)
+(search for `Quote review`). It reuses the same `/quote` endpoint the
+issuer backend exposes — no extra SDK call needed on the client.
+
 ---
 
 ### `handleSwap` — POST /swap
@@ -234,6 +273,29 @@ It does not depend on `@pafi-dev/issuer`.
 
 ---
 
+## Changelog
+
+### 0.1.3
+
+- Peer dependency `@pafi-dev/core` bumped to `0.5.17` so the swap path
+  picks up `buildUserOpTypedData()` + the v0.8 EIP-712 `computeUserOpHash`.
+  Required for the EIP-7702 mobile swap flow on Pimlico's
+  `Simple7702Account` — the previous v0.7 hash format and EIP-191
+  signing path both reverted with `AA24 signature error`. See
+  [`@pafi-dev/core` changelog 0.5.16](../core/README.md#0516).
+- README adds a **frontend "quote review" pattern** — debounced
+  `/quote` polling so the user sees `X PT → ~Y USDT` (after operator
+  gas fee) before submitting the swap UserOp. Reference implementation
+  in `privy-pimlico-eip7702-example/app/components/WalletPanel.tsx`.
+
+### 0.1.2
+
+- Initial public release. `handleQuote`, `handleSwap`,
+  `handlePerpDeposit` stateless handlers + `fetchPafiPools` subgraph
+  helper.
+
+---
+
 ## License
 
 Apache-2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pafi-dev/trading",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "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.2"
+    "@pafi-dev/core": "0.5.17"
   },
   "peerDependencies": {
     "viem": "^2.0.0"