@pafi-dev/trading 0.1.3 → 0.1.5

package/README.md

@@ -72,37 +72,61 @@ 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`.
+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
-const [quote, setQuote] = useState<QuoteResponseDto | null>(null);
+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 (!token || amount <= 0n) return setQuote(null);
+  if (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());
+    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, token]);
+}, [amount]);
 
-// 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
+// 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.
 ```
 
-A working implementation lives in
+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`). It reuses the same `/quote` endpoint the
-issuer backend exposes — no extra SDK call needed on the client.
+(search for `Quote review`).
 
 ---
 
@@ -140,28 +164,70 @@ After receiving the response, the frontend:
 
 ### `handlePerpDeposit` — POST /perp-deposit
 
-Quote the LayerZero fee and build an unsigned UserOp that batches:
-`USDC.approve(vault)` → `vault.deposit{value: layerZeroFee}(data)`.
+Build an unsigned UserOp that deposits USDC into Orderly perp. The
+handler picks one of two paths automatically:
+
+#### Path 1 — Relay (default, gas-sponsored)
+
+`USDC.approve(relay)` → `relay.deposit(req)`
+
+The PAFI Orderly Relay holds an ETH reserve and pays Orderly's
+LayerZero `msg.value` out of it. The user pays a USDC fee instead
+(quoted via `Relay.quoteTokenFee` and capped by `maxRelayFee`).
+Combined with paymaster sponsorship of ERC-4337 gas, **the user does
+not need any native ETH** — they only need USDC.
 
 ```ts
 const deposit = await trading.handlePerpDeposit({
   chainId: 8453,
   userAddress: "0xUserEOA",
-  amount: 100_000_000n,   // 100 USDC (6 decimals)
+  amount: 100_000_000n,    // 100 USDC (6 decimals)
   aaNonce: 0n,
-  brokerId: "woofi_pro",  // "woofi_pro" | "orderly" | "logx"
+  brokerId: "woofi_pro",   // "woofi_pro" | "orderly" | "logx"
+  // viaRelay: true,       // default
+  // maxRelayFee: 5_000_000n,  // optional, default = 5% of amount
 });
 
+// deposit.path === "relay"
+// deposit.userOp          — USDC.approve(relay) + relay.deposit(req)
+// deposit.relayTokenFee   — USDC fee charged by the Relay
+// deposit.layerZeroFee    — ETH wei the Relay covers on the user's behalf (informational)
+// deposit.relayAddress    — getContractAddresses(chainId).orderlyRelay
+```
+
+#### Path 2 — Vault (fallback, requires native ETH)
+
+`USDC.approve(vault)` → `vault.deposit{value: layerZeroFee}(data)`
+
+```ts
+const deposit = await trading.handlePerpDeposit({
+  chainId: 8453,
+  userAddress: "0xUserEOA",
+  amount: 100_000_000n,
+  aaNonce: 0n,
+  brokerId: "woofi_pro",
+  viaRelay: false,         // explicit opt-out of Relay
+});
+
+// deposit.path === "vault"
 // deposit.userOp        — unsigned PartialUserOperation
-// deposit.layerZeroFee  — ETH wei — user wallet must hold this as native ETH
-// deposit.accountId     — Orderly account ID for (user, broker) pair
-// deposit.brokerHash    — keccak256(brokerId)
-// deposit.usdcAddress   — USDC resolved from Vault.getAllowedToken()
+// deposit.layerZeroFee  — REQUIRED native ETH balance on the sender
+// deposit.relayTokenFee — 0n
 ```
 
-> **Native ETH constraint:** The paymaster sponsors ERC-4337 gas, but `msg.value` (the
-> LayerZero fee) must come from the user's own native ETH balance. Surface `layerZeroFee`
-> in the UI and warn the user if their ETH is insufficient before submitting.
+> **Vault path = native ETH required.** The paymaster sponsors ERC-4337
+> gas, but `msg.value` (the LayerZero fee) must come from the user's
+> own ETH balance. Always check `walletEth >= layerZeroFee` before
+> submitting, OR — far better — leave `viaRelay` at its default to
+> stay on the zero-ETH path.
+
+#### Auto-fallback
+
+When `viaRelay` is `true` (default) but
+`getContractAddresses(chainId).orderlyRelay` is the placeholder
+sentinel (Relay not deployed for that chain), the handler silently
+falls back to the Vault path. Inspect `deposit.path` if you need to
+distinguish.
 
 ---
 
@@ -275,6 +341,56 @@ It does not depend on `@pafi-dev/issuer`.
 
 ## Changelog
 
+### 0.1.5
+
+`handlePerpDeposit` now defaults to the **PAFI Orderly Relay** path —
+zero native ETH required.
+
+**Why.** The previous Vault-direct path required the user wallet to
+hold `layerZeroFee` as native ETH (paymaster sponsors ERC-4337 gas
+but never `msg.value`). For users coming through Privy embedded
+wallets / sponsored onboarding flows that's often `0 ETH`, so the
+deposit reverted with `BatchExecutor.CallFailed(1, 0x)` (no-data
+revert from the Vault when it can't pay LayerZero out of the EOA).
+
+The Relay (deployed at `getContractAddresses(8453).orderlyRelay
+=` `0xDA082DAce1522c185aeB5A713FcA6fa6B6E99e7f` on Base) holds an ETH
+reserve and pays LayerZero out of it; the user pays a USDC fee
+instead. Combined with paymaster sponsorship, the user only needs
+USDC.
+
+**API additions** on `ApiPerpDepositRequest`:
+
+- `viaRelay?: boolean` — default `true`. Set `false` to force the
+  Vault fallback.
+- `maxRelayFee?: bigint` — slippage cap on the Relay's USDC fee.
+  Defaults to 5% of `amount`.
+- `pointTokenAddress?` / `gasFeePt?` / `gasFeePtRecipient?` — optional
+  PT gas-fee transfer prepended to the batch (sponsored issuer flow).
+
+**API additions** on `ApiPerpDepositResponse`:
+
+- `path: "relay" | "vault"` — which execution path the handler chose.
+  Inspect this when `viaRelay` was left at its default to know if the
+  auto-fallback to Vault triggered (e.g. on a chain without a deployed
+  Relay).
+- `relayTokenFee: bigint` — USDC fee the Relay will charge. `0n` when
+  `path === "vault"`.
+- `relayAddress: Address` — the address the UserOp targets. Equal to
+  the Vault address when `path === "vault"`.
+
+When `viaRelay` is `true` but no Relay is deployed for the chain
+(`getContractAddresses(chainId).orderlyRelay` is a placeholder), the
+handler silently falls back to the Vault path — inspect
+`response.path` to detect this.
+
+### 0.1.4
+
+- README rewrite for the **frontend "quote review" pattern** — direct
+  client-side `trading.handleQuote` call, no HTTP hop through the
+  issuer backend. Quotes are stateless on-chain reads, so the
+  pre-existing `GET /quote` proxy was redundant.
+
 ### 0.1.3
 
 - Peer dependency `@pafi-dev/core` bumped to `0.5.17` so the swap path

package/dist/index.cjs

@@ -149,10 +149,20 @@ var TradingHandlers = class {
   /**
    * Build an Orderly perp deposit UserOp.
    *
-   * Resolves USDC address and LayerZero fee from on-chain Vault reads,
-   * then encodes a 2-step batch: USDC.approve → Vault.deposit{value}.
-   * The `layerZeroFee` in the response is the ETH the user must hold
-   * natively — paymaster sponsors ERC-4337 gas only, not msg.value.
+   * Default path is the **PAFI Orderly Relay** (`viaRelay: true`):
+   * USDC.approve(relay) + relay.deposit(req). The Relay holds an ETH
+   * reserve and pays Orderly's LayerZero `msg.value` out of it; the
+   * user pays a USDC fee (quoted via `Relay.quoteTokenFee`) instead.
+   * No native ETH on the user wallet is required, so paymaster
+   * sponsorship of the ERC-4337 gas is sufficient end-to-end.
+   *
+   * Fallback path (`viaRelay: false`): direct `Vault.deposit{value}`.
+   * Reserved for chains where no Relay is deployed — the user wallet
+   * **must** hold `layerZeroFee` as native ETH.
+   *
+   * The Relay path automatically falls back to Vault when
+   * `getContractAddresses(chainId).orderlyRelay` is the placeholder
+   * sentinel (Relay not deployed for that chain).
    */
   async handlePerpDeposit(request) {
     if (request.chainId !== this.chainId) {
@@ -203,6 +213,49 @@ var TradingHandlers = class {
       functionName: "getDepositFee",
       args: [userAddress, depositData]
     });
+    const useRelay = request.viaRelay !== false;
+    const relayAddress = (0, import_core.getContractAddresses)(request.chainId).orderlyRelay;
+    const relayDeployed = !isPlaceholderAddress(relayAddress);
+    if (useRelay && relayDeployed) {
+      const maxRelayFee = request.maxRelayFee ?? request.amount * 500n / 10000n;
+      const relayRequest = {
+        token: usdcAddress,
+        receiver: userAddress,
+        brokerHash,
+        totalAmount: request.amount,
+        maxFee: maxRelayFee
+      };
+      const relayTokenFee = await this.provider.readContract({
+        address: relayAddress,
+        abi: import_core.ORDERLY_RELAY_ABI,
+        functionName: "quoteTokenFee",
+        args: [relayRequest]
+      });
+      if (relayTokenFee > maxRelayFee) {
+        throw new Error(
+          `handlePerpDeposit: Relay tokenFee ${relayTokenFee} exceeds maxRelayFee ${maxRelayFee}`
+        );
+      }
+      const userOp2 = (0, import_core.buildPerpDepositViaRelay)({
+        userAddress,
+        aaNonce: request.aaNonce,
+        relayAddress,
+        request: relayRequest,
+        pointTokenAddress: request.pointTokenAddress,
+        gasFeePt: request.gasFeePt,
+        gasFeePtRecipient: request.gasFeePtRecipient
+      });
+      return {
+        userOp: userOp2,
+        path: "relay",
+        layerZeroFee,
+        relayTokenFee,
+        accountId,
+        brokerHash,
+        usdcAddress,
+        relayAddress
+      };
+    }
     const userOp = (0, import_core.buildPerpDepositWithGasDeduction)({
       userAddress,
       aaNonce: request.aaNonce,
@@ -212,9 +265,21 @@ var TradingHandlers = class {
       depositData,
       layerZeroFee
     });
-    return { userOp, layerZeroFee, accountId, brokerHash, usdcAddress };
+    return {
+      userOp,
+      path: "vault",
+      layerZeroFee,
+      relayTokenFee: 0n,
+      accountId,
+      brokerHash,
+      usdcAddress,
+      relayAddress: vault
+    };
   }
 };
+function isPlaceholderAddress(addr) {
+  return /^0x0{36}[0-9a-fA-F]{4}$/i.test(addr);
+}
 
 // src/pools.ts
 var import_core2 = require("@pafi-dev/core");

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  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    return { userOp, estimatedUsdtOut, minAmountOut, deadline };\n  }\n\n  // =========================================================================\n  // POST /perp-deposit\n  // =========================================================================\n\n  /**\n   * Build an Orderly perp deposit UserOp.\n   *\n   * Resolves USDC address and LayerZero fee from on-chain Vault reads,\n   * then encodes a 2-step batch: USDC.approve → Vault.deposit{value}.\n   * The `layerZeroFee` in the response is the ETH the user must hold\n   * natively — paymaster sponsors ERC-4337 gas only, not msg.value.\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    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 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 { userOp, layerZeroFee, accountId, brokerHash, usdcAddress };\n  }\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":["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} 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    return { userOp, 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      // Default: 5% slippage cap on the Relay's USDC fee. The Relay\n      // converts msg.value (ETH) to USDC at its oracle price; capping\n      // protects the user from outsized swings between request and\n      // mining.\n      const maxRelayFee =\n        request.maxRelayFee ?? (request.amount * 500n) / 10_000n;\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} exceeds maxRelayFee ${maxRelayFee}`,\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      return {\n        userOp,\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"]}

package/dist/index.d.cts

@@ -62,21 +62,67 @@ interface ApiPerpDepositRequest {
      * Known values: woofi_pro, orderly, logx.
      */
     brokerId: string;
+    /**
+     * Route via the PAFI Orderly Relay (recommended).
+     *
+     * - `true` (default): zero-ETH path. Relay covers the LayerZero
+     *   `msg.value`, user pays a USDC fee. Paymaster sponsorship is
+     *   sufficient — user does not need native ETH.
+     * - `false`: direct Vault call. User must hold the returned
+     *   `layerZeroFee` as native ETH or the deposit reverts.
+     *
+     * The Relay path falls back to Vault automatically if
+     * `getContractAddresses(chainId).orderlyRelay` is the placeholder
+     * sentinel (no Relay deployed for this chain).
+     */
+    viaRelay?: boolean;
+    /**
+     * Max acceptable USDC fee charged by the Relay (slippage cap on
+     * its USD-pricing of `msg.value`). Ignored when `viaRelay: false`.
+     * Defaults to 5% of `amount` (`amount * 500 / 10000`).
+     */
+    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.
+     */
+    pointTokenAddress?: Address;
+    gasFeePt?: bigint;
+    gasFeePtRecipient?: Address;
 }
 interface ApiPerpDepositResponse {
     /** Unsigned UserOp — attach paymaster data + user signature, then submit to Bundler. */
     userOp: PartialUserOperation;
     /**
-     * LayerZero fee in ETH wei. User wallet must hold at least this as
-     * native ETH — even when ERC-4337 gas is sponsored by paymaster.
+     * Which execution path the handler chose.
+     * - `"relay"`: zero-ETH path — paymaster sponsorship alone is sufficient.
+     * - `"vault"`: direct Vault call — user wallet must hold
+     *   `layerZeroFee` as native ETH.
+     */
+    path: "relay" | "vault";
+    /**
+     * Orderly Vault deposit fee, ETH wei (LayerZero msg.value).
+     * - When `path === "relay"`: informational only — the Relay covers
+     *   it, the user does not pay this in ETH.
+     * - When `path === "vault"`: required native-ETH balance on the
+     *   sender wallet.
      */
     layerZeroFee: bigint;
+    /**
+     * USDC fee charged by the Relay (`Relay.quoteTokenFee`), capped at
+     * `maxRelayFee`. `0n` when `path === "vault"`.
+     */
+    relayTokenFee: bigint;
     /** Orderly account ID for this (user, broker) pair. */
     accountId: `0x${string}`;
     /** keccak256(brokerId) — for client-side verification. */
     brokerHash: `0x${string}`;
     /** USDC contract address (resolved from Vault.getAllowedToken). */
     usdcAddress: Address;
+    /** Relay address used. Same as `vaultAddress` when `path === "vault"`. */
+    relayAddress: Address;
 }
 
 interface TradingHandlersConfig {
@@ -130,10 +176,20 @@ declare class TradingHandlers {
     /**
      * Build an Orderly perp deposit UserOp.
      *
-     * Resolves USDC address and LayerZero fee from on-chain Vault reads,
-     * then encodes a 2-step batch: USDC.approve → Vault.deposit{value}.
-     * The `layerZeroFee` in the response is the ETH the user must hold
-     * natively — paymaster sponsors ERC-4337 gas only, not msg.value.
+     * Default path is the **PAFI Orderly Relay** (`viaRelay: true`):
+     * USDC.approve(relay) + relay.deposit(req). The Relay holds an ETH
+     * reserve and pays Orderly's LayerZero `msg.value` out of it; the
+     * user pays a USDC fee (quoted via `Relay.quoteTokenFee`) instead.
+     * No native ETH on the user wallet is required, so paymaster
+     * sponsorship of the ERC-4337 gas is sufficient end-to-end.
+     *
+     * Fallback path (`viaRelay: false`): direct `Vault.deposit{value}`.
+     * Reserved for chains where no Relay is deployed — the user wallet
+     * **must** hold `layerZeroFee` as native ETH.
+     *
+     * The Relay path automatically falls back to Vault when
+     * `getContractAddresses(chainId).orderlyRelay` is the placeholder
+     * sentinel (Relay not deployed for that chain).
      */
     handlePerpDeposit(request: ApiPerpDepositRequest): Promise<ApiPerpDepositResponse>;
 }

package/dist/index.d.ts

@@ -62,21 +62,67 @@ interface ApiPerpDepositRequest {
      * Known values: woofi_pro, orderly, logx.
      */
     brokerId: string;
+    /**
+     * Route via the PAFI Orderly Relay (recommended).
+     *
+     * - `true` (default): zero-ETH path. Relay covers the LayerZero
+     *   `msg.value`, user pays a USDC fee. Paymaster sponsorship is
+     *   sufficient — user does not need native ETH.
+     * - `false`: direct Vault call. User must hold the returned
+     *   `layerZeroFee` as native ETH or the deposit reverts.
+     *
+     * The Relay path falls back to Vault automatically if
+     * `getContractAddresses(chainId).orderlyRelay` is the placeholder
+     * sentinel (no Relay deployed for this chain).
+     */
+    viaRelay?: boolean;
+    /**
+     * Max acceptable USDC fee charged by the Relay (slippage cap on
+     * its USD-pricing of `msg.value`). Ignored when `viaRelay: false`.
+     * Defaults to 5% of `amount` (`amount * 500 / 10000`).
+     */
+    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.
+     */
+    pointTokenAddress?: Address;
+    gasFeePt?: bigint;
+    gasFeePtRecipient?: Address;
 }
 interface ApiPerpDepositResponse {
     /** Unsigned UserOp — attach paymaster data + user signature, then submit to Bundler. */
     userOp: PartialUserOperation;
     /**
-     * LayerZero fee in ETH wei. User wallet must hold at least this as
-     * native ETH — even when ERC-4337 gas is sponsored by paymaster.
+     * Which execution path the handler chose.
+     * - `"relay"`: zero-ETH path — paymaster sponsorship alone is sufficient.
+     * - `"vault"`: direct Vault call — user wallet must hold
+     *   `layerZeroFee` as native ETH.
+     */
+    path: "relay" | "vault";
+    /**
+     * Orderly Vault deposit fee, ETH wei (LayerZero msg.value).
+     * - When `path === "relay"`: informational only — the Relay covers
+     *   it, the user does not pay this in ETH.
+     * - When `path === "vault"`: required native-ETH balance on the
+     *   sender wallet.
      */
     layerZeroFee: bigint;
+    /**
+     * USDC fee charged by the Relay (`Relay.quoteTokenFee`), capped at
+     * `maxRelayFee`. `0n` when `path === "vault"`.
+     */
+    relayTokenFee: bigint;
     /** Orderly account ID for this (user, broker) pair. */
     accountId: `0x${string}`;
     /** keccak256(brokerId) — for client-side verification. */
     brokerHash: `0x${string}`;
     /** USDC contract address (resolved from Vault.getAllowedToken). */
     usdcAddress: Address;
+    /** Relay address used. Same as `vaultAddress` when `path === "vault"`. */
+    relayAddress: Address;
 }
 
 interface TradingHandlersConfig {
@@ -130,10 +176,20 @@ declare class TradingHandlers {
     /**
      * Build an Orderly perp deposit UserOp.
      *
-     * Resolves USDC address and LayerZero fee from on-chain Vault reads,
-     * then encodes a 2-step batch: USDC.approve → Vault.deposit{value}.
-     * The `layerZeroFee` in the response is the ETH the user must hold
-     * natively — paymaster sponsors ERC-4337 gas only, not msg.value.
+     * Default path is the **PAFI Orderly Relay** (`viaRelay: true`):
+     * USDC.approve(relay) + relay.deposit(req). The Relay holds an ETH
+     * reserve and pays Orderly's LayerZero `msg.value` out of it; the
+     * user pays a USDC fee (quoted via `Relay.quoteTokenFee`) instead.
+     * No native ETH on the user wallet is required, so paymaster
+     * sponsorship of the ERC-4337 gas is sufficient end-to-end.
+     *
+     * Fallback path (`viaRelay: false`): direct `Vault.deposit{value}`.
+     * Reserved for chains where no Relay is deployed — the user wallet
+     * **must** hold `layerZeroFee` as native ETH.
+     *
+     * The Relay path automatically falls back to Vault when
+     * `getContractAddresses(chainId).orderlyRelay` is the placeholder
+     * sentinel (Relay not deployed for that chain).
      */
     handlePerpDeposit(request: ApiPerpDepositRequest): Promise<ApiPerpDepositResponse>;
 }

package/dist/index.js

@@ -4,6 +4,8 @@ import {
   findBestQuote,
   buildSwapWithGasDeduction,
   buildPerpDepositWithGasDeduction,
+  buildPerpDepositViaRelay,
+  ORDERLY_RELAY_ABI,
   getContractAddresses,
   UNIVERSAL_ROUTER_ADDRESSES,
   ORDERLY_VAULT_ABI,
@@ -132,10 +134,20 @@ var TradingHandlers = class {
   /**
    * Build an Orderly perp deposit UserOp.
    *
-   * Resolves USDC address and LayerZero fee from on-chain Vault reads,
-   * then encodes a 2-step batch: USDC.approve → Vault.deposit{value}.
-   * The `layerZeroFee` in the response is the ETH the user must hold
-   * natively — paymaster sponsors ERC-4337 gas only, not msg.value.
+   * Default path is the **PAFI Orderly Relay** (`viaRelay: true`):
+   * USDC.approve(relay) + relay.deposit(req). The Relay holds an ETH
+   * reserve and pays Orderly's LayerZero `msg.value` out of it; the
+   * user pays a USDC fee (quoted via `Relay.quoteTokenFee`) instead.
+   * No native ETH on the user wallet is required, so paymaster
+   * sponsorship of the ERC-4337 gas is sufficient end-to-end.
+   *
+   * Fallback path (`viaRelay: false`): direct `Vault.deposit{value}`.
+   * Reserved for chains where no Relay is deployed — the user wallet
+   * **must** hold `layerZeroFee` as native ETH.
+   *
+   * The Relay path automatically falls back to Vault when
+   * `getContractAddresses(chainId).orderlyRelay` is the placeholder
+   * sentinel (Relay not deployed for that chain).
    */
   async handlePerpDeposit(request) {
     if (request.chainId !== this.chainId) {
@@ -186,6 +198,49 @@ var TradingHandlers = class {
       functionName: "getDepositFee",
       args: [userAddress, depositData]
     });
+    const useRelay = request.viaRelay !== false;
+    const relayAddress = getContractAddresses(request.chainId).orderlyRelay;
+    const relayDeployed = !isPlaceholderAddress(relayAddress);
+    if (useRelay && relayDeployed) {
+      const maxRelayFee = request.maxRelayFee ?? request.amount * 500n / 10000n;
+      const relayRequest = {
+        token: usdcAddress,
+        receiver: userAddress,
+        brokerHash,
+        totalAmount: request.amount,
+        maxFee: maxRelayFee
+      };
+      const relayTokenFee = await this.provider.readContract({
+        address: relayAddress,
+        abi: ORDERLY_RELAY_ABI,
+        functionName: "quoteTokenFee",
+        args: [relayRequest]
+      });
+      if (relayTokenFee > maxRelayFee) {
+        throw new Error(
+          `handlePerpDeposit: Relay tokenFee ${relayTokenFee} exceeds maxRelayFee ${maxRelayFee}`
+        );
+      }
+      const userOp2 = buildPerpDepositViaRelay({
+        userAddress,
+        aaNonce: request.aaNonce,
+        relayAddress,
+        request: relayRequest,
+        pointTokenAddress: request.pointTokenAddress,
+        gasFeePt: request.gasFeePt,
+        gasFeePtRecipient: request.gasFeePtRecipient
+      });
+      return {
+        userOp: userOp2,
+        path: "relay",
+        layerZeroFee,
+        relayTokenFee,
+        accountId,
+        brokerHash,
+        usdcAddress,
+        relayAddress
+      };
+    }
     const userOp = buildPerpDepositWithGasDeduction({
       userAddress,
       aaNonce: request.aaNonce,
@@ -195,9 +250,21 @@ var TradingHandlers = class {
       depositData,
       layerZeroFee
     });
-    return { userOp, layerZeroFee, accountId, brokerHash, usdcAddress };
+    return {
+      userOp,
+      path: "vault",
+      layerZeroFee,
+      relayTokenFee: 0n,
+      accountId,
+      brokerHash,
+      usdcAddress,
+      relayAddress: vault
+    };
   }
 };
+function isPlaceholderAddress(addr) {
+  return /^0x0{36}[0-9a-fA-F]{4}$/i.test(addr);
+}
 
 // src/pools.ts
 import { fetchPafiPools, PAFI_SUBGRAPH_URL } from "@pafi-dev/core";

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  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    return { userOp, estimatedUsdtOut, minAmountOut, deadline };\n  }\n\n  // =========================================================================\n  // POST /perp-deposit\n  // =========================================================================\n\n  /**\n   * Build an Orderly perp deposit UserOp.\n   *\n   * Resolves USDC address and LayerZero fee from on-chain Vault reads,\n   * then encodes a 2-step batch: USDC.approve → Vault.deposit{value}.\n   * The `layerZeroFee` in the response is the ETH the user must hold\n   * natively — paymaster sponsors ERC-4337 gas only, not msg.value.\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    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 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 { userOp, layerZeroFee, accountId, brokerHash, usdcAddress };\n  }\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":[]}
+{"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    return { userOp, 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      // Default: 5% slippage cap on the Relay's USDC fee. The Relay\n      // converts msg.value (ETH) to USDC at its oracle price; capping\n      // protects the user from outsized swings between request and\n      // mining.\n      const maxRelayFee =\n        request.maxRelayFee ?? (request.amount * 500n) / 10_000n;\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} exceeds maxRelayFee ${maxRelayFee}`,\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      return {\n        userOp,\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":";AAAA,SAAS,kBAAkB;AAE3B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAoCA,IAAM,kBAAN,MAAsB;AAAA,EACV;AAAA,EACA;AAAA,EAEjB,YAAY,QAA+B;AACzC,SAAK,WAAW,OAAO;AACvB,SAAK,UAAU,OAAO;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,YAAY,SAAqD;AACrE,QAAI,QAAQ,YAAY,KAAK,SAAS;AACpC,YAAM,IAAI,MAAM,oCAAoC,QAAQ,OAAO,EAAE;AAAA,IACvE;AACA,QAAI,QAAQ,WAAW,IAAI;AACzB,aAAO,EAAE,aAAa,IAAI,kBAAkB,IAAI,aAAa,GAAG;AAAA,IAClE;AAEA,UAAM,EAAE,KAAK,IAAI,qBAAqB,QAAQ,OAAO;AACrD,UAAM,oBAAoB,WAAW,QAAQ,iBAAiB;AAC9D,UAAM,QAAQ,QAAQ,SAAS,CAAC;AAEhC,QAAI;AACF,YAAM,OAAO,MAAM;AAAA,QACjB,KAAK;AAAA,QACL,QAAQ;AAAA,QACR;AAAA,QACA;AAAA,QACA,QAAQ;AAAA,QACR;AAAA,MACF;AACA,aAAO;AAAA,QACL,aAAa,QAAQ;AAAA,QACrB,kBAAkB,KAAK,UAAU;AAAA,QACjC,aAAa,KAAK,UAAU;AAAA,MAC9B;AAAA,IACF,QAAQ;AACN,aAAO;AAAA,QACL,aAAa,QAAQ;AAAA,QACrB,kBAAkB;AAAA,QAClB,aAAa;AAAA,QACb,YAAY;AAAA,MACd;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,MAAM,WAAW,SAAmD;AAClE,QAAI,QAAQ,YAAY,KAAK,SAAS;AACpC,YAAM,IAAI,MAAM,mCAAmC,QAAQ,OAAO,EAAE;AAAA,IACtE;AACA,QAAI,QAAQ,UAAU,IAAI;AACxB,YAAM,IAAI,MAAM,qCAAqC;AAAA,IACvD;AAEA,UAAM,EAAE,KAAK,IAAI,qBAAqB,QAAQ,OAAO;AACrD,UAAM,kBAAkB,2BAA2B,QAAQ,OAAO;AAClE,QAAI,CAAC,iBAAiB;AACpB,YAAM,IAAI,MAAM,8CAA8C,QAAQ,OAAO,EAAE;AAAA,IACjF;AAEA,UAAM,oBAAoB,WAAW,QAAQ,iBAAiB;AAC9D,UAAM,cAAc,WAAW,QAAQ,WAAW;AAClD,UAAM,QAAQ,QAAQ,SAAS,CAAC;AAChC,UAAM,cAAc,QAAQ,eAAe;AAC3C,UAAM,WAAW,QAAQ,YAAY;AAErC,QAAI,WAAW,MAAM,CAAC,QAAQ,cAAc;AAC1C,YAAM,IAAI,MAAM,qDAAqD;AAAA,IACvE;AAEA,QAAI;AACJ,QAAI;AACF,oBAAc,MAAM;AAAA,QAClB,KAAK;AAAA,QACL,QAAQ;AAAA,QACR;AAAA,QACA;AAAA,QACA,QAAQ;AAAA,QACR;AAAA,MACF;AAAA,IACF,QAAQ;AACN,YAAM,IAAI,MAAM,qDAAqD;AAAA,IACvE;AAEA,UAAM,mBAAmB,YAAY,UAAU;AAC/C,UAAM,eAAgB,mBAAmB,OAAO,MAAQ,WAAW,IAAK;AACxE,UAAM,WAAW,OAAO,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI,IAAI,IAAI,EAAE;AAE9D,UAAM,SAAS,0BAA0B;AAAA,MACvC;AAAA,MACA,SAAS,QAAQ;AAAA,MACjB;AAAA,MACA,oBAAoB;AAAA,MACpB,wBAAwB;AAAA,MACxB,UAAU,QAAQ;AAAA,MAClB;AAAA,MACA,UAAU,YAAY,UAAU;AAAA,MAChC;AAAA,MACA;AAAA,MACA,cAAc,QAAQ,gBAAgB;AAAA,IACxC,CAAC;AAED,WAAO,EAAE,QAAQ,kBAAkB,cAAc,SAAS;AAAA,EAC5D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAwBA,MAAM,kBAAkB,SAAiE;AACvF,QAAI,QAAQ,YAAY,KAAK,SAAS;AACpC,YAAM,IAAI,MAAM,0CAA0C,QAAQ,OAAO,EAAE;AAAA,IAC7E;AACA,QAAI,QAAQ,UAAU,IAAI;AACxB,YAAM,IAAI,MAAM,4CAA4C;AAAA,IAC9D;AAEA,UAAM,QAAQ,wBAAwB,QAAQ,OAAO;AACrD,QAAI,CAAC,OAAO;AACV,YAAM,IAAI,MAAM,mDAAmD,QAAQ,OAAO,EAAE;AAAA,IACtF;AAEA,UAAM,aAAa,cAAc,QAAQ,QAAsC;AAC/E,QAAI,CAAC,YAAY;AACf,YAAM,IAAI,MAAM,wCAAwC,QAAQ,QAAQ,GAAG;AAAA,IAC7E;AACA,UAAM,YAAY,aAAa;AAC/B,UAAM,cAAc,WAAW,QAAQ,WAAW;AAElD,UAAM,CAAC,aAAa,aAAa,IAAI,MAAM,QAAQ,IAAI;AAAA,MACrD,KAAK,SAAS,aAAa;AAAA,QACzB,SAAS;AAAA,QACT,KAAK;AAAA,QACL,cAAc;AAAA,QACd,MAAM,CAAC,SAAS;AAAA,MAClB,CAAC;AAAA,MACD,KAAK,SAAS,aAAa;AAAA,QACzB,SAAS;AAAA,QACT,KAAK;AAAA,QACL,cAAc;AAAA,QACd,MAAM,CAAC,UAAU;AAAA,MACnB,CAAC;AAAA,IACH,CAAC;AAED,QAAI,CAAC,eAAe;AAClB,YAAM,IAAI;AAAA,QACR,8BAA8B,QAAQ,QAAQ;AAAA,MAChD;AAAA,IACF;AAEA,UAAM,YAAY,iBAAiB,aAAa,UAAU;AAC1D,UAAM,cAAc;AAAA,MAClB;AAAA,MACA;AAAA,MACA;AAAA,MACA,aAAa,QAAQ;AAAA,IACvB;AAKA,UAAM,eAAgB,MAAM,KAAK,SAAS,aAAa;AAAA,MACrD,SAAS;AAAA,MACT,KAAK;AAAA,MACL,cAAc;AAAA,MACd,MAAM,CAAC,aAAa,WAAW;AAAA,IACjC,CAAC;AAED,UAAM,WAAW,QAAQ,aAAa;AACtC,UAAM,eAAe,qBAAqB,QAAQ,OAAO,EAAE;AAC3D,UAAM,gBAAgB,CAAC,qBAAqB,YAAY;AAExD,QAAI,YAAY,eAAe;AAK7B,YAAM,cACJ,QAAQ,eAAgB,QAAQ,SAAS,OAAQ;AAEnD,YAAM,eAAe;AAAA,QACnB,OAAO;AAAA,QACP,UAAU;AAAA,QACV;AAAA,QACA,aAAa,QAAQ;AAAA,QACrB,QAAQ;AAAA,MACV;AAEA,YAAM,gBAAiB,MAAM,KAAK,SAAS,aAAa;AAAA,QACtD,SAAS;AAAA,QACT,KAAK;AAAA,QACL,cAAc;AAAA,QACd,MAAM,CAAC,YAAY;AAAA,MACrB,CAAC;AAED,UAAI,gBAAgB,aAAa;AAC/B,cAAM,IAAI;AAAA,UACR,qCAAqC,aAAa,wBAAwB,WAAW;AAAA,QACvF;AAAA,MACF;AAEA,YAAMA,UAAS,yBAAyB;AAAA,QACtC;AAAA,QACA,SAAS,QAAQ;AAAA,QACjB;AAAA,QACA,SAAS;AAAA,QACT,mBAAmB,QAAQ;AAAA,QAC3B,UAAU,QAAQ;AAAA,QAClB,mBAAmB,QAAQ;AAAA,MAC7B,CAAC;AAED,aAAO;AAAA,QACL,QAAAA;AAAA,QACA,MAAM;AAAA,QACN;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAIA,UAAM,SAAS,iCAAiC;AAAA,MAC9C;AAAA,MACA,SAAS,QAAQ;AAAA,MACjB,SAAS,QAAQ;AAAA,MACjB;AAAA,MACA,QAAQ,QAAQ;AAAA,MAChB;AAAA,MACA;AAAA,IACF,CAAC;AAED,WAAO;AAAA,MACL;AAAA,MACA,MAAM;AAAA,MACN;AAAA,MACA,eAAe;AAAA,MACf;AAAA,MACA;AAAA,MACA;AAAA,MACA,cAAc;AAAA,IAChB;AAAA,EACF;AACF;AAOA,SAAS,qBAAqB,MAAwB;AACpD,SAAO,2BAA2B,KAAK,IAAI;AAC7C;;;AC1VA,SAAS,gBAAgB,yBAAyB;","names":["userOp"]}

package/package.json

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