@pafi-dev/trading 0.3.2 → 0.4.0

package/README.md

@@ -187,6 +187,99 @@ simulations.
 
 ---
 
+## Direct path — no AA, no bundler, no sponsor-relayer
+
+`v0.4.0+` ships `swapDirect()` + `perpDepositDirect()` for the FE-only
+flow where the user pays gas in ETH and broadcasts a single type-2 tx
+calling its own EIP-7702 delegated bytecode. No Pimlico API key, no
+sponsor-relayer, no PAFI infra.
+
+**Precondition:** user EOA must already be EIP-7702 delegated (run
+`delegateDirect()` from `@pafi-dev/core` first; both helpers throw a
+clear error otherwise).
+
+### `swapDirect`
+
+```ts
+import { swapDirect, fetchPafiPools } from "@pafi-dev/trading";
+import { createPublicClient, createWalletClient, custom, http, parseUnits } from "viem";
+import { base } from "viem/chains";
+
+const publicClient = createPublicClient({ chain: base, transport: http() });
+// `walletClient` from Privy embedded wallet, MetaMask, etc.
+const walletClient = createWalletClient({
+  account: wallet.address,
+  chain: base,
+  transport: custom(await wallet.getEthereumProvider()),
+});
+
+const pools = await fetchPafiPools(8453, POINT_TOKEN);
+
+const result = await swapDirect({
+  userAddress: wallet.address,
+  chainId: 8453,
+  inputTokenAddress: POINT_TOKEN,
+  outputTokenAddress: USDT,
+  amount: parseUnits("100", 18),
+  pools,
+  publicClient,
+  walletClient,
+  // optional: slippageBps, deadline, gasFeeAmountOutput, waitForReceipt
+});
+
+console.log("Swap tx:", result.txHash);
+// {
+//   txHash, receipt?, estimatedOutputAmount, minAmountOut, hops,
+//   deadline, feeAmountUsed
+// }
+```
+
+**Operator fee:** default `0n` (skip — PAFI not sponsoring this swap).
+Pass an explicit `gasFeeAmountOutput: bigint` only if you want to mirror
+the sponsored flow's fee transfer.
+
+### `perpDepositDirect`
+
+```ts
+import { perpDepositDirect } from "@pafi-dev/trading";
+
+const result = await perpDepositDirect({
+  userAddress: wallet.address,
+  chainId: 8453,
+  amount: parseUnits("10", 6), // 10 USDC
+  brokerId: "orderly",         // | "woofi_pro" | "logx"
+  publicClient,
+  walletClient,
+  // optional: maxRelayFee, gasFeeUsdc, waitForReceipt
+});
+
+// {
+//   txHash, receipt?, relayTokenFee, maxFee, netDeposit,
+//   feeAmountUsed, accountId, brokerHash, usdcAddress, relayAddress
+// }
+```
+
+The Relay still charges its own USDC fee (`Relay.quoteTokenFee`) to
+cover LayerZero `msg.value`; that's separate from PAFI's operator fee
+(which is skipped by default on the direct path).
+
+### When to use direct vs. AA path
+
+| Aspect | `swapDirect` / `perpDepositDirect` | `TradingHandlers.handleSwap` / `handlePerpDeposit` |
+| --- | --- | --- |
+| User pays gas | ETH (native) | Free (sponsor) or ETH (fallback) |
+| Bundler required | No | Yes (Pimlico) |
+| Sponsor-relayer required | No | Yes (sponsored path) |
+| Operator fee charged | Default skip | Default included |
+| Round trips | 1 (broadcast tx) | 2+ (paymaster + bundler) |
+| Precondition | EIP-7702 delegated | Same |
+
+Use direct for FE dev/test, integrations without a Pimlico key, or
+production paths where users explicitly opt to pay gas. Use AA path for
+the production gas-free UX via sponsor-relayer.
+
+---
+
 ## API reference
 
 ### `TradingHandlers`
@@ -213,6 +306,8 @@ Methods:
 - `buildPermit2ApprovalCalldata`, `buildErc20ApprovalCalldata`, `checkAllowance`
 - `simulateSwap` — `eth_call` dry-run
 - `fetchPafiPools(chainId, pointTokenAddress, subgraphUrl?)`
+- `swapDirect(params)` — FE-direct swap (no AA, user pays gas) — see "Direct path" section
+- `perpDepositDirect(params)` — FE-direct perp deposit (no AA, user pays gas)
 
 ---
 

package/dist/index.cjs

@@ -33,10 +33,12 @@ __export(index_exports, {
   combineRoutes: () => combineRoutes,
   fetchPafiPools: () => import_core10.fetchPafiPools,
   findBestQuote: () => findBestQuote,
+  perpDepositDirect: () => perpDepositDirect,
   quoteBestRoute: () => quoteBestRoute,
   quoteExactInput: () => quoteExactInput,
   quoteExactInputSingle: () => quoteExactInputSingle,
-  simulateSwap: () => simulateSwap
+  simulateSwap: () => simulateSwap,
+  swapDirect: () => swapDirect
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -129,6 +131,12 @@ async function quoteBestRoute(client, quoterAddress, exactCurrency, routes, exac
         {
           exactCurrency,
           path,
+          // `as unknown as number` cast — the V4 quoter's solidity
+          // signature takes `uint256` (a bigint at the wire level), but
+          // our pinned ABI types it as `number`. The runtime is fine
+          // (bigint serializes correctly) — this cast tells TS to skip
+          // the structural check until we re-generate the ABI with the
+          // correct uint256 type. Tracked: SDK_CORE_TRADING_AUDIT.md H11.
           exactAmount: BigInt(exactAmount)
         }
       ]
@@ -136,15 +144,21 @@ async function quoteBestRoute(client, quoterAddress, exactCurrency, routes, exac
     allowFailure: true
   });
   const allRoutes = [];
+  let firstFailure;
   for (let i = 0; i < results.length; i++) {
     const r = results[i];
     if (r.status === "success") {
       const [amountOut, gasEstimate] = r.result;
       allRoutes.push({ amountOut, gasEstimate, path: routes[i] });
+    } else if (firstFailure === void 0) {
+      const errMsg = r.error instanceof Error ? r.error.message : String(r.error ?? "unknown");
+      firstFailure = errMsg;
     }
   }
   if (allRoutes.length === 0) {
-    throw new Error("No valid routes found");
+    throw new Error(
+      `No valid routes found from ${exactCurrency} (${routes.length} candidates probed)` + (firstFailure ? `; first failure: ${firstFailure}` : "")
+    );
   }
   const bestRoute = allRoutes.reduce(
     (best, current) => current.amountOut > best.amountOut ? current : best
@@ -318,6 +332,12 @@ function buildSwapUserOp(params) {
       "buildSwapUserOp: swapPath must contain at least one PathKey"
     );
   }
+  const PERMIT2_EXPIRATION_MAX = 2n ** 48n - 1n;
+  if (params.deadline <= 0n || params.deadline > PERMIT2_EXPIRATION_MAX) {
+    throw new Error(
+      `buildSwapUserOp: deadline (${params.deadline}) must be unix seconds in (0, 2^48-1]. Did you accidentally pass milliseconds?`
+    );
+  }
   const { commands, inputs } = buildUniversalRouterExecuteArgs(
     params.inputTokenAddress,
     params.swapPath,
@@ -383,7 +403,11 @@ var TradingHandlers = class {
    */
   async handleQuote(request) {
     if (request.chainId !== this.chainId) {
-      throw new Error(`handleQuote: unsupported chainId ${request.chainId}`);
+      throw new import_core9.ValidationError(
+        "UNSUPPORTED_CHAIN_ID",
+        `handleQuote: unsupported chainId ${request.chainId}`,
+        { requested: request.chainId, supported: this.chainId }
+      );
     }
     if (request.amount === 0n) {
       return {
@@ -452,20 +476,31 @@ var TradingHandlers = class {
    */
   async handleSwap(authenticatedAddress, request) {
     if ((0, import_viem4.getAddress)(authenticatedAddress) !== (0, import_viem4.getAddress)(request.userAddress)) {
-      throw new Error(
+      throw new import_core9.ValidationError(
+        "USER_ADDRESS_MISMATCH",
         `handleSwap: authenticatedAddress (${authenticatedAddress}) does not match request.userAddress (${request.userAddress})`
       );
     }
     if (request.chainId !== this.chainId) {
-      throw new Error(`handleSwap: unsupported chainId ${request.chainId}`);
+      throw new import_core9.ValidationError(
+        "UNSUPPORTED_CHAIN_ID",
+        `handleSwap: unsupported chainId ${request.chainId}`,
+        { requested: request.chainId, supported: this.chainId }
+      );
     }
     if (request.amount <= 0n) {
-      throw new Error("handleSwap: amount must be positive");
+      throw new import_core9.ValidationError(
+        "INVALID_AMOUNT",
+        "handleSwap: amount must be positive"
+      );
     }
     const { pafiFeeRecipient } = (0, import_core9.getContractAddresses)(request.chainId);
     const universalRouter = import_core9.UNIVERSAL_ROUTER_ADDRESSES[request.chainId];
     if (!universalRouter) {
-      throw new Error(`handleSwap: no UniversalRouter for chainId ${request.chainId}`);
+      throw new import_core9.ValidationError(
+        "ROUTER_NOT_DEPLOYED",
+        `handleSwap: no UniversalRouter for chainId ${request.chainId}`
+      );
     }
     const inputTokenAddress = (0, import_viem4.getAddress)(request.inputTokenAddress);
     const outputTokenAddress = (0, import_viem4.getAddress)(request.outputTokenAddress);
@@ -481,9 +516,11 @@ var TradingHandlers = class {
         request.amount,
         pools
       );
-    } catch {
-      throw new Error(
-        `handleSwap: no swap path found from ${inputTokenAddress} to ${outputTokenAddress}`
+    } catch (err) {
+      const cause = err instanceof Error ? err.message : String(err);
+      throw new import_core9.ValidationError(
+        "NO_SWAP_PATH",
+        `handleSwap: no swap path found from ${inputTokenAddress} to ${outputTokenAddress} (cause: ${cause})`
       );
     }
     const gasFeeAmountOutput = request.gasFeeAmountOutput !== void 0 ? request.gasFeeAmountOutput : await quoteOperatorFeeOutput(
@@ -496,8 +533,13 @@ var TradingHandlers = class {
     const estimatedOutputAmount = quoteResult.bestRoute.amountOut;
     const minAmountOut = estimatedOutputAmount * BigInt(1e4 - slippageBps) / 10000n;
     if (gasFeeAmountOutput > 0n && minAmountOut < gasFeeAmountOutput) {
-      throw new Error(
-        `handleSwap: minAmountOut (${minAmountOut}) below operator fee (${gasFeeAmountOutput}) \u2014 increase swap amount or accept tighter slippage`
+      throw new import_core9.ValidationError(
+        "AMOUNT_TOO_SMALL_FOR_FEE",
+        `handleSwap: minAmountOut (${minAmountOut}) below operator fee (${gasFeeAmountOutput}) \u2014 increase swap amount or accept tighter slippage`,
+        {
+          minAmountOut: minAmountOut.toString(),
+          gasFeeAmountOutput: gasFeeAmountOutput.toString()
+        }
       );
     }
     const deadline = BigInt(Math.floor(Date.now() / 1e3) + 5 * 60);
@@ -561,23 +603,38 @@ var TradingHandlers = class {
    */
   async handlePerpDeposit(authenticatedAddress, request) {
     if ((0, import_viem4.getAddress)(authenticatedAddress) !== (0, import_viem4.getAddress)(request.userAddress)) {
-      throw new Error(
+      throw new import_core9.ValidationError(
+        "USER_ADDRESS_MISMATCH",
         `handlePerpDeposit: authenticatedAddress (${authenticatedAddress}) does not match request.userAddress (${request.userAddress})`
       );
     }
     if (request.chainId !== this.chainId) {
-      throw new Error(`handlePerpDeposit: unsupported chainId ${request.chainId}`);
+      throw new import_core9.ValidationError(
+        "UNSUPPORTED_CHAIN_ID",
+        `handlePerpDeposit: unsupported chainId ${request.chainId}`,
+        { requested: request.chainId, supported: this.chainId }
+      );
     }
     if (request.amount <= 0n) {
-      throw new Error("handlePerpDeposit: amount must be positive");
+      throw new import_core9.ValidationError(
+        "INVALID_AMOUNT",
+        "handlePerpDeposit: amount must be positive"
+      );
     }
     const vault = import_core9.ORDERLY_VAULT_ADDRESSES[request.chainId];
     if (!vault) {
-      throw new Error(`handlePerpDeposit: no Orderly Vault for chainId ${request.chainId}`);
+      throw new import_core9.ValidationError(
+        "VAULT_NOT_DEPLOYED",
+        `handlePerpDeposit: no Orderly Vault for chainId ${request.chainId}`
+      );
     }
     const brokerHash = import_core9.BROKER_HASHES[request.brokerId];
     if (!brokerHash) {
-      throw new Error(`handlePerpDeposit: unknown brokerId "${request.brokerId}"`);
+      throw new import_core9.ValidationError(
+        "UNKNOWN_BROKER_ID",
+        `handlePerpDeposit: unknown brokerId "${request.brokerId}"`,
+        { brokerId: request.brokerId }
+      );
     }
     const tokenHash = import_core9.TOKEN_HASHES.USDC;
     const userAddress = (0, import_viem4.getAddress)(request.userAddress);
@@ -596,8 +653,10 @@ var TradingHandlers = class {
       })
     ]);
     if (!brokerAllowed) {
-      throw new Error(
-        `handlePerpDeposit: broker "${request.brokerId}" is not whitelisted on Orderly Vault`
+      throw new import_core9.ValidationError(
+        "BROKER_NOT_WHITELISTED",
+        `handlePerpDeposit: broker "${request.brokerId}" is not whitelisted on Orderly Vault`,
+        { brokerId: request.brokerId, brokerHash }
       );
     }
     const accountId = (0, import_core9.computeAccountId)(userAddress, brokerHash);
@@ -638,15 +697,25 @@ var TradingHandlers = class {
         args: [relayRequest]
       });
       if (relayTokenFee > maxRelayFee) {
-        throw new Error(
-          `handlePerpDeposit: Relay tokenFee ${relayTokenFee} (\u2248 ${Number(relayTokenFee) / 1e6} USDC) exceeds maxRelayFee ${maxRelayFee} \u2014 pass a larger \`maxRelayFee\` or increase the deposit \`amount\` so the fee becomes a smaller share of the total.`
+        throw new import_core9.ValidationError(
+          "RELAY_FEE_EXCEEDS_MAX",
+          `handlePerpDeposit: Relay tokenFee ${relayTokenFee} (\u2248 ${Number(relayTokenFee) / 1e6} USDC) exceeds maxRelayFee ${maxRelayFee} \u2014 pass a larger \`maxRelayFee\` or increase the deposit \`amount\` so the fee becomes a smaller share of the total.`,
+          {
+            relayTokenFee: relayTokenFee.toString(),
+            maxRelayFee: maxRelayFee.toString()
+          }
         );
       }
       if (relayTokenFee >= request.amount) {
         const feeUsdc = Number(relayTokenFee) / 1e6;
         const amountUsdc = Number(request.amount) / 1e6;
-        throw new Error(
-          `handlePerpDeposit: deposit amount ${amountUsdc} USDC is below the Relay fee ${feeUsdc} USDC \u2014 increase \`amount\` to at least ${(feeUsdc * 2).toFixed(6)} USDC so a meaningful balance reaches your Orderly account after the Relay charge.`
+        throw new import_core9.ValidationError(
+          "RELAY_FEE_EXCEEDS_AMOUNT",
+          `handlePerpDeposit: deposit amount ${amountUsdc} USDC is below the Relay fee ${feeUsdc} USDC \u2014 increase \`amount\` to at least ${(feeUsdc * 2).toFixed(6)} USDC so a meaningful balance reaches your Orderly account after the Relay charge.`,
+          {
+            relayTokenFee: relayTokenFee.toString(),
+            amount: request.amount.toString()
+          }
         );
       }
       const userOp2 = (0, import_core9.buildPerpDepositViaRelay)({
@@ -721,6 +790,241 @@ async function quoteOperatorFeeOutput(provider, chainId, outputTokenAddress) {
 
 // src/pools.ts
 var import_core10 = require("@pafi-dev/core");
+
+// src/direct/swapDirect.ts
+var import_core11 = require("@pafi-dev/core");
+async function swapDirect(params) {
+  const code = await params.publicClient.getCode({
+    address: params.userAddress
+  });
+  const delegate = (0, import_core11.parseEip7702DelegatedAddress)(code);
+  if (!delegate) {
+    throw new Error(
+      `swapDirect: user ${params.userAddress} is not EIP-7702 delegated. Run \`delegateDirect()\` first (user pays a one-time delegation tx) or use the AA path via \`TradingHandlers.handleSwap()\` + sponsor-relayer.`
+    );
+  }
+  const impl = (0, import_core11.detectDelegateImpl)(delegate);
+  if (impl === "unknown") {
+    params.onWarning?.(
+      `swapDirect: user delegated to ${delegate} which is not a PAFI-recognised impl (expected ${import_core11.SIMPLE_7702_IMPL_BASE_MAINNET} or ${import_core11.BATCH_EXECUTOR_7702_IMPL}). Continuing \u2014 execute will revert if the impl doesn't expose executeBatch.`
+    );
+  }
+  const universalRouter = import_core11.UNIVERSAL_ROUTER_ADDRESSES[params.chainId];
+  if (!universalRouter) {
+    throw new Error(`swapDirect: no UniversalRouter for chainId ${params.chainId}`);
+  }
+  if (params.amount <= 0n) {
+    throw new Error("swapDirect: amount must be positive");
+  }
+  let quoteResult;
+  try {
+    quoteResult = await findBestQuote(
+      params.publicClient,
+      params.chainId,
+      params.inputTokenAddress,
+      params.outputTokenAddress,
+      params.amount,
+      params.pools ?? []
+    );
+  } catch (err) {
+    const cause = err instanceof Error ? err.message : String(err);
+    throw new Error(
+      `swapDirect: no swap path found from ${params.inputTokenAddress} to ${params.outputTokenAddress} (cause: ${cause})`
+    );
+  }
+  const hops = quoteResult.bestRoute.path.length;
+  const slippageBps = params.slippageBps ?? (hops > 1 ? 100 : 50);
+  const estimatedOutputAmount = quoteResult.bestRoute.amountOut;
+  const minAmountOut = estimatedOutputAmount * BigInt(1e4 - slippageBps) / 10000n;
+  const gasFeeAmountOutput = params.gasFeeAmountOutput ?? 0n;
+  if (gasFeeAmountOutput > 0n && minAmountOut < gasFeeAmountOutput) {
+    throw new Error(
+      `swapDirect: minAmountOut (${minAmountOut}) below operator fee (${gasFeeAmountOutput})`
+    );
+  }
+  const deadline = params.deadline ?? BigInt(Math.floor(Date.now() / 1e3) + 5 * 60);
+  const { pafiFeeRecipient } = (0, import_core11.getContractAddresses)(params.chainId);
+  const userOp = buildSwapUserOp({
+    userAddress: params.userAddress,
+    aaNonce: 0n,
+    // ignored on the native-tx path; nonce comes from EOA tx count
+    inputTokenAddress: params.inputTokenAddress,
+    outputTokenAddress: params.outputTokenAddress,
+    universalRouterAddress: universalRouter,
+    amountIn: params.amount,
+    minAmountOut,
+    swapPath: quoteResult.bestRoute.path,
+    deadline,
+    gasFeeAmountOutput,
+    feeRecipient: pafiFeeRecipient
+  });
+  const account = params.walletClient.account;
+  if (!account) {
+    throw new Error(
+      "swapDirect: walletClient has no account attached \u2014 cannot send tx"
+    );
+  }
+  const txHash = await params.walletClient.sendTransaction({
+    account,
+    chain: params.walletClient.chain,
+    to: params.userAddress,
+    value: 0n,
+    data: userOp.callData
+  });
+  let receipt;
+  if (params.waitForReceipt !== false) {
+    try {
+      receipt = await params.publicClient.waitForTransactionReceipt({
+        hash: txHash
+      });
+    } catch (err) {
+      params.onWarning?.(
+        `swapDirect: tx ${txHash} sent but receipt fetch failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
+  return {
+    txHash,
+    receipt,
+    estimatedOutputAmount,
+    minAmountOut,
+    hops,
+    deadline,
+    feeAmountUsed: gasFeeAmountOutput
+  };
+}
+
+// src/direct/perpDepositDirect.ts
+var import_core12 = require("@pafi-dev/core");
+async function perpDepositDirect(params) {
+  if (params.amount <= 0n) {
+    throw new Error("perpDepositDirect: amount must be positive");
+  }
+  const code = await params.publicClient.getCode({
+    address: params.userAddress
+  });
+  const delegate = (0, import_core12.parseEip7702DelegatedAddress)(code);
+  if (!delegate) {
+    throw new Error(
+      `perpDepositDirect: user ${params.userAddress} is not EIP-7702 delegated. Run \`delegateDirect()\` first or use the AA path via \`TradingHandlers.handlePerpDeposit()\` + sponsor-relayer.`
+    );
+  }
+  const impl = (0, import_core12.detectDelegateImpl)(delegate);
+  if (impl === "unknown") {
+    params.onWarning?.(
+      `perpDepositDirect: user delegated to ${delegate} (not a PAFI-recognised impl ${import_core12.SIMPLE_7702_IMPL_BASE_MAINNET} / ${import_core12.BATCH_EXECUTOR_7702_IMPL}). Continuing \u2014 execute will revert if the impl doesn't expose executeBatch.`
+    );
+  }
+  const vault = import_core12.ORDERLY_VAULT_ADDRESSES[params.chainId];
+  if (!vault) {
+    throw new Error(
+      `perpDepositDirect: no Orderly Vault for chainId ${params.chainId}`
+    );
+  }
+  const brokerHash = import_core12.BROKER_HASHES[params.brokerId];
+  if (!brokerHash) {
+    throw new Error(
+      `perpDepositDirect: unknown brokerId "${params.brokerId}"`
+    );
+  }
+  const tokenHash = import_core12.TOKEN_HASHES.USDC;
+  const [usdcAddress, brokerAllowed] = await Promise.all([
+    params.publicClient.readContract({
+      address: vault,
+      abi: import_core12.ORDERLY_VAULT_ABI,
+      functionName: "getAllowedToken",
+      args: [tokenHash]
+    }),
+    params.publicClient.readContract({
+      address: vault,
+      abi: import_core12.ORDERLY_VAULT_ABI,
+      functionName: "getAllowedBroker",
+      args: [brokerHash]
+    })
+  ]);
+  if (!brokerAllowed) {
+    throw new Error(
+      `perpDepositDirect: broker "${params.brokerId}" is not whitelisted on Orderly Vault`
+    );
+  }
+  const { orderlyRelay: relayAddress, pafiFeeRecipient } = (0, import_core12.getContractAddresses)(
+    params.chainId
+  );
+  const RELAY_FEE_FLOOR_USDC = 2000000n;
+  const percentCap = params.amount * 500n / 10000n;
+  const maxFee = params.maxRelayFee ?? (percentCap > RELAY_FEE_FLOOR_USDC ? percentCap : RELAY_FEE_FLOOR_USDC);
+  const relayRequest = {
+    token: usdcAddress,
+    receiver: params.userAddress,
+    brokerHash,
+    totalAmount: params.amount,
+    maxFee
+  };
+  const relayTokenFee = await params.publicClient.readContract({
+    address: relayAddress,
+    abi: import_core12.ORDERLY_RELAY_ABI,
+    functionName: "quoteTokenFee",
+    args: [relayRequest]
+  });
+  if (relayTokenFee > maxFee) {
+    throw new Error(
+      `perpDepositDirect: Relay tokenFee ${relayTokenFee} exceeds maxFee ${maxFee} \u2014 pass a larger \`maxRelayFee\` or increase \`amount\`.`
+    );
+  }
+  if (relayTokenFee >= params.amount) {
+    throw new Error(
+      `perpDepositDirect: deposit amount ${params.amount} below Relay fee ${relayTokenFee} \u2014 increase \`amount\`.`
+    );
+  }
+  const gasFeeUsdc = params.gasFeeUsdc ?? 0n;
+  const partial = (0, import_core12.buildPerpDepositViaRelay)({
+    userAddress: params.userAddress,
+    aaNonce: 0n,
+    // ignored on the native-tx path
+    relayAddress,
+    request: relayRequest,
+    gasFeeUsdc: gasFeeUsdc > 0n ? gasFeeUsdc : void 0,
+    gasFeeUsdcRecipient: gasFeeUsdc > 0n ? pafiFeeRecipient : void 0
+  });
+  const account = params.walletClient.account;
+  if (!account) {
+    throw new Error(
+      "perpDepositDirect: walletClient has no account attached \u2014 cannot send tx"
+    );
+  }
+  const txHash = await params.walletClient.sendTransaction({
+    account,
+    chain: params.walletClient.chain,
+    to: params.userAddress,
+    value: 0n,
+    data: partial.callData
+  });
+  let receipt;
+  if (params.waitForReceipt !== false) {
+    try {
+      receipt = await params.publicClient.waitForTransactionReceipt({
+        hash: txHash
+      });
+    } catch (err) {
+      params.onWarning?.(
+        `perpDepositDirect: tx ${txHash} sent but receipt fetch failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
+  const accountId = (0, import_core12.computeAccountId)(params.userAddress, brokerHash);
+  return {
+    txHash,
+    receipt,
+    relayTokenFee,
+    maxFee,
+    netDeposit: params.amount - relayTokenFee,
+    feeAmountUsed: gasFeeUsdc,
+    accountId,
+    brokerHash,
+    usdcAddress,
+    relayAddress
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PAFI_SUBGRAPH_URL,
@@ -736,9 +1040,11 @@ var import_core10 = require("@pafi-dev/core");
   combineRoutes,
   fetchPafiPools,
   findBestQuote,
+  perpDepositDirect,
   quoteBestRoute,
   quoteExactInput,
   quoteExactInputSingle,
-  simulateSwap
+  simulateSwap,
+  swapDirect
 });
 //# sourceMappingURL=index.cjs.map