@pafi-dev/trading 0.1.2 → 0.1.4

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,64 @@ 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
+
+Quotes are pure on-chain reads (Uniswap V4 Quoter via Base RPC) — **no
+auth, no issuer-side state, nothing to proxy through the issuer
+backend.** Call `handleQuote` directly from the browser / React Native.
+
+```tsx
+import { TradingHandlers, fetchPafiPools } from "@pafi-dev/trading";
+import { createPublicClient, http, formatUnits } from "viem";
+import { base } from "viem/chains";
+
+const trading = new TradingHandlers({
+  provider: createPublicClient({ chain: base, transport: http(RPC_URL) }),
+  chainId: 8453,
+});
+
+useEffect(() => {
+  if (amount <= 0n) return setQuote(null);
+  const t = setTimeout(async () => {
+    const pools = await fetchPafiPools(8453, POINT_TOKEN);
+    const result = await trading.handleQuote({
+      chainId: 8453,
+      pointTokenAddress: POINT_TOKEN,
+      amount,
+      pools,
+    });
+    setQuote(result);
+  }, 400);
+  return () => clearTimeout(t);
+}, [amount]);
+
+// Render:
+//   In:           formatUnits(amount, 18)                     PT
+//   You receive:  formatUnits(quote.estimatedUsdtOut, 6)      USDT
+//   Rate:         estimatedUsdtOut · 1e18 / amount / 1e6      USDT per 1 PT
+// On `quote.quoteError === "QUOTE_UNAVAILABLE"` → hide the Swap CTA.
+```
+
+Why client-direct (no `GET /quote` HTTP hop):
+
+- The quoter is stateless and reads from the public RPC — there's no
+  secret to hide and nothing to validate against an issuer's database.
+- One fewer round-trip on every keystroke (debounce hits the Quoter
+  directly, ~150 ms vs. ~400 ms via a backend proxy).
+- The quote stays internally consistent with the swap path that
+  `handleSwap` will pick — both use the same `findBestQuote()` call
+  under the hood with the same `pools` array, so what the user sees in
+  the review card is what they get on submit.
+
+> **Operator fee in USDT** is **NOT** part of the quote — it's an
+> issuer-policy concern decided at swap-build time. If you want a
+> "net out after fee" preview, fetch the issuer's gas-fee endpoint
+> separately and subtract on the client.
+
+Reference 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`).
+
 ---
 
 ### `handleSwap` — POST /swap
@@ -234,6 +297,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.4",
   "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"