@pafi-dev/core 0.7.5 → 0.7.6

package/README.md

@@ -49,6 +49,10 @@ in sibling packages:
 > **0.6.1 (2026-04-27):** added `quoteOperatorFeeUsdt` so FE can
 > compute USDT-denominated gas fee without round-tripping the issuer
 > backend (`/gas-fee` is now optional).
+>
+> **0.7.5 (2026-04-28):** added `delegateDirect()` — FE one-shot EIP-7702
+> delegation that user pays gas for. Bypasses the AA + sponsor-relayer
+> stack entirely. See [section below](#delegatedirect--fe-one-shot-delegation-no-aa--no-sponsor).
 
 ---
 
@@ -65,6 +69,7 @@ in sibling packages:
 | `encodeBatchExecute`, `decodeBatchExecuteCalls` | BatchExecutor (Coinbase SW v2) calldata |
 | `buildDelegationUserOp`, `computeAuthorizationHash`, `parseEip7702DelegatedAddress` | EIP-7702 helpers |
 | `splitAuthorizationSig`, `buildEip7702Authorization` | Split user's authSig + assemble bundler tuple |
+| `delegateDirect` | One-shot FE-direct EIP-7702 delegation (user pays gas, no AA) |
 | `buildPerpDepositViaRelay`, `buildPerpDepositWithGasDeduction`, `ORDERLY_RELAY_ABI`, `ORDERLY_VAULT_ABI`, `BROKER_HASHES`, `TOKEN_HASHES`, `computeAccountId` | Orderly perp deposit calldata + types |
 | `quoteOperatorFeePt`, `quoteOperatorFeeUsdt` | Off-issuer fee quoter (Chainlink + V4 subgraph) |
 | `fetchPafiPools`, `PAFI_SUBGRAPH_URL` | Pool discovery via PAFI subgraph |
@@ -186,6 +191,85 @@ const authorization = buildEip7702Authorization({
 
 ---
 
+## `delegateDirect` — FE one-shot delegation, no AA / no sponsor
+
+For the **FE-direct** path where the user pays gas in ETH and you don't
+want a dependency on `permissionless` / Pimlico bundlers / PAFI
+sponsor-relayer:
+
+```ts
+import { useSign7702Authorization, useWallets } from "@privy-io/react-auth";
+import { delegateDirect } from "@pafi-dev/core";
+import { createWalletClient, custom, createPublicClient, http } from "viem";
+import { base } from "viem/chains";
+
+const publicClient = createPublicClient({ chain: base, transport: http() });
+
+function DelegateButton() {
+  const { wallets } = useWallets();
+  const { signAuthorization } = useSign7702Authorization();
+
+  // Privy ALWAYS signs EIP-7702 with the embedded wallet — pick that
+  // one as the smart-account owner regardless of how user logged in.
+  const wallet = wallets.find((w) => w.walletClientType === "privy");
+
+  async function handleClick() {
+    if (!wallet) return;
+    const provider = await wallet.getEthereumProvider();
+    const walletClient = createWalletClient({
+      account: wallet.address as `0x${string}`,
+      chain: base,
+      transport: custom(provider),
+    });
+
+    const result = await delegateDirect({
+      userAddress: wallet.address as `0x${string}`,
+      chainId: 8453,
+      publicClient,
+      walletClient,
+      signAuthorization,
+      // optional: skipIfAlreadyDelegated (default true), waitForReceipt (default true)
+    });
+
+    if (result.status === "already-delegated") {
+      console.log("Already delegated to", result.delegatedTo);
+    } else {
+      console.log("Delegated! tx:", result.txHash);
+      // result.receipt — full TransactionReceipt when waitForReceipt=true
+    }
+  }
+
+  return <button onClick={handleClick}>Delegate</button>;
+}
+```
+
+**What happens internally:**
+
+1. `getCode(userAddress)` → if already delegated to expected impl, return early.
+2. `getTransactionCount(userAddress, 'pending')` → tx nonce.
+3. `signAuthorization({ contractAddress, chainId, nonce })` — Privy hook signs with embedded wallet (raw `secp256k1_sign`, no EIP-191 prefix).
+4. `walletClient.sendTransaction({ to: userAddress, data: '0x', authorizationList: [auth] })` — viem encodes a type-4 EIP-7702 transaction.
+5. `waitForTransactionReceipt(txHash)` (optional).
+
+**Requirements:**
+
+- Privy embedded wallet (external wallets like MetaMask **cannot**
+  sign EIP-7702 — only Privy's embedded wallet exposes raw
+  `secp256k1_sign`).
+- A few cents of ETH on Base for gas (~$0.01–0.10).
+
+**vs. AA path:** `delegateDirect` produces 1 native L1 tx instead of an
+ERC-4337 UserOp. Cheaper, simpler, no bundler / paymaster involvement —
+but the user pays gas. Use the AA path (via `permissionless` +
+sponsor-relayer) when you want gas-free UX.
+
+**vs. mobile gg56 flow:** mobile delegate flow goes through gg56's
+`/delegate/{prepare,submit}` + sponsor-relayer for the gas sponsorship.
+`delegateDirect` is the FE-only counterpart that bypasses that
+infrastructure entirely.
+
+---
+
 ## Operator fee quoter
 
 Two helpers for FE direct-mode usage (no backend round-trip):

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pafi-dev/core",
-  "version": "0.7.5",
+  "version": "0.7.6",
   "description": "EIP-712 signing, contract interaction, and Relay calldata for the PAFI point token system",
   "type": "module",
   "main": "./dist/index.cjs",