@pepu-chain/sdk 0.0.0-stage → 0.2.0

package/dist/aa/react.cjs

@@ -0,0 +1,151 @@
+'use strict';
+
+var chunkAJS4UFQX_cjs = require('../chunk-AJS4UFQX.cjs');
+var chunkSLW7FRTL_cjs = require('../chunk-SLW7FRTL.cjs');
+var chunkWANILJZQ_cjs = require('../chunk-WANILJZQ.cjs');
+require('../chunk-TIEAZYHF.cjs');
+var chunkC7IC36XS_cjs = require('../chunk-C7IC36XS.cjs');
+var chunk4GINFJO6_cjs = require('../chunk-4GINFJO6.cjs');
+require('../chunk-VF3D6KLQ.cjs');
+var chunkDPCZJLB3_cjs = require('../chunk-DPCZJLB3.cjs');
+var chunkYQL7NISX_cjs = require('../chunk-YQL7NISX.cjs');
+var reactAuth = require('@privy-io/react-auth');
+var smartWallets = require('@privy-io/react-auth/smart-wallets');
+var react = require('react');
+
+var sharedClient;
+function publicClient() {
+  sharedClient ??= chunkC7IC36XS_cjs.getPublicClient(chunkDPCZJLB3_cjs.pepuMainnet);
+  return sharedClient;
+}
+function useEmbeddedWallet() {
+  const { wallets } = reactAuth.useWallets();
+  return wallets.find((w) => w.walletClientType === "privy");
+}
+function usePepuSmartAccount() {
+  const embedded = useEmbeddedWallet();
+  const { client, getClientForChain } = smartWallets.useSmartWallets();
+  const getClientRef = react.useRef(getClientForChain);
+  getClientRef.current = getClientForChain;
+  const owner = embedded?.address;
+  const fromProvider = client?.account?.address;
+  const [resolved, setResolved] = react.useState();
+  react.useEffect(() => {
+    if (!owner || fromProvider) return;
+    let cancelled = false;
+    Promise.resolve(getClientRef.current?.({ id: chunkDPCZJLB3_cjs.pepuMainnet.id })).then((c) => {
+      const address = c?.account?.address;
+      if (!cancelled && address) setResolved({ owner, address });
+    }).catch(() => {
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [owner, fromProvider]);
+  const smartAccount = fromProvider ?? (resolved && resolved.owner === owner ? resolved.address : void 0);
+  return {
+    ...owner ? { owner } : {},
+    ...smartAccount ? { smartAccount } : {},
+    ready: owner !== void 0 && smartAccount !== void 0
+  };
+}
+function useSponsoredSend(_options = {}) {
+  const { client, getClientForChain } = smartWallets.useSmartWallets();
+  const [status, setStatus] = react.useState("idle");
+  const [result, setResult] = react.useState();
+  const [error, setError] = react.useState();
+  const inFlight = react.useRef(false);
+  const send = react.useCallback(
+    async (calls) => {
+      if (inFlight.current) {
+        throw new chunkYQL7NISX_cjs.PepuConfigError("UNKNOWN", "A sponsored send is already in progress.", {
+          hint: "Wait for the current send to finish."
+        });
+      }
+      inFlight.current = true;
+      setStatus("signing");
+      setError(void 0);
+      setResult(void 0);
+      try {
+        const encoded = chunkAJS4UFQX_cjs.normalizeCalls(calls);
+        const pc = publicClient();
+        const sw = client ?? await getClientForChain({ id: chunkDPCZJLB3_cjs.pepuMainnet.id });
+        if (!sw) {
+          throw new chunkYQL7NISX_cjs.PepuConfigError(
+            "CONFIG_PRIVY_DASHBOARD",
+            "No Privy smart-wallet client is available.",
+            { hint: 'Enable "Smart Wallets" for chain 97741 in the Privy dashboard and wrap the app in SmartWalletsProvider.' }
+          );
+        }
+        setStatus("submitting");
+        const hash = encoded.length === 1 && encoded[0] ? await sw.sendTransaction({ to: encoded[0].to, data: encoded[0].data, value: encoded[0].value }) : await sw.sendTransaction({ calls: encoded });
+        const receipt = await pc.waitForTransactionReceipt({ hash });
+        const paid = chunkAJS4UFQX_cjs.userOpEventFromReceipt(receipt, sw.account.address);
+        const out = {
+          userOpHash: paid?.userOpHash ?? null,
+          transactionHash: hash,
+          success: paid?.success ?? receipt.status === "success",
+          paymaster: paid?.paymaster ?? null,
+          actualGasCostWei: paid?.actualGasCost ?? 0n,
+          explorerUrl: chunk4GINFJO6_cjs.txUrl(chunkDPCZJLB3_cjs.pepuMainnet, hash)
+        };
+        setResult(out);
+        setStatus("confirmed");
+        return out;
+      } catch (caught) {
+        const err = chunkYQL7NISX_cjs.toPepuError(caught) === caught ? caught : chunkWANILJZQ_cjs.describeUserOpFailure(caught);
+        setError(err);
+        setStatus("error");
+        throw err;
+      } finally {
+        inFlight.current = false;
+      }
+    },
+    [client, getClientForChain]
+  );
+  return { send, status, ...result ? { result } : {}, ...error ? { error } : {} };
+}
+function usePepuSponsorship(o = {}) {
+  const [report, setReport] = react.useState({
+    available: false,
+    transport: "none",
+    bundler: { configured: false },
+    paymaster: { configured: false },
+    reason: "Checking sponsorship status.",
+    fixes: []
+  });
+  const [loading, setLoading] = react.useState(true);
+  const { pollMs = 3e4, bundlerUrl, paymasterUrl } = o;
+  react.useEffect(() => {
+    let cancelled = false;
+    const run = async () => {
+      try {
+        const r = await chunkSLW7FRTL_cjs.checkSponsorship({
+          publicClient: publicClient(),
+          ...bundlerUrl !== void 0 ? { bundlerUrl } : {},
+          ...paymasterUrl !== void 0 ? { paymasterUrl } : {}
+        });
+        if (!cancelled) setReport(r);
+      } catch (e) {
+        if (!cancelled) {
+          setReport((prev) => ({ ...prev, available: false, reason: chunkYQL7NISX_cjs.toPepuError(e).message, fixes: [chunkYQL7NISX_cjs.toPepuError(e).hint] }));
+        }
+      } finally {
+        if (!cancelled) setLoading(false);
+      }
+    };
+    void run();
+    const id = pollMs > 0 ? setInterval(() => void run(), pollMs) : void 0;
+    return () => {
+      cancelled = true;
+      if (id !== void 0) clearInterval(id);
+    };
+  }, [pollMs, bundlerUrl, paymasterUrl]);
+  return { ...report, loading };
+}
+
+exports.usePepuSmartAccount = usePepuSmartAccount;
+exports.usePepuSponsorship = usePepuSponsorship;
+exports.useSponsoredSend = useSponsoredSend;
+//# sourceMappingURL=react.cjs.map
+//# sourceMappingURL=react.cjs.map

package/dist/aa/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/aa/react.ts"],"names":["getPublicClient","pepuMainnet","useWallets","useSmartWallets","useRef","useState","useEffect","useCallback","PepuConfigError","normalizeCalls","userOpEventFromReceipt","txUrl","toPepuError","describeUserOpFailure","checkSponsorship"],"mappings":";;;;;;;;;;;;;;;AA+BA,IAAI,YAAA;AACJ,SAAS,YAAA,GAA6B;AACpC,EAAA,YAAA,KAAiBA,kCAAgBC,6BAAW,CAAA;AAC5C,EAAA,OAAO,YAAA;AACT;AAGA,SAAS,iBAAA,GAAoB;AAC3B,EAAA,MAAM,EAAE,OAAA,EAAQ,GAAIC,oBAAA,EAAW;AAC/B,EAAA,OAAO,QAAQ,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,qBAAqB,OAAO,CAAA;AAC3D;AAaO,SAAS,mBAAA,GAAmF;AACjG,EAAA,MAAM,WAAW,iBAAA,EAAkB;AACnC,EAAA,MAAM,EAAE,MAAA,EAAQ,iBAAA,EAAkB,GAAIC,4BAAA,EAAgB;AACtD,EAAA,MAAM,YAAA,GAAeC,aAAO,iBAAiB,CAAA;AAC7C,EAAA,YAAA,CAAa,OAAA,GAAU,iBAAA;AACvB,EAAA,MAAM,QAAQ,QAAA,EAAU,OAAA;AACxB,EAAA,MAAM,YAAA,GAAe,QAAQ,OAAA,EAAS,OAAA;AACtC,EAAA,MAAM,CAAC,QAAA,EAAU,WAAW,CAAA,GAAIC,cAAA,EAA2D;AAE3F,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,SAAS,YAAA,EAAc;AAC5B,IAAA,IAAI,SAAA,GAAY,KAAA;AAEhB,IAAA,OAAA,CAAQ,OAAA,CAAQ,YAAA,CAAa,OAAA,GAAU,EAAE,EAAA,EAAIL,6BAAA,CAAY,EAAA,EAAI,CAAC,CAAA,CAC3D,IAAA,CAAK,CAAC,CAAA,KAAM;AACX,MAAA,MAAM,OAAA,GAAU,GAAG,OAAA,EAAS,OAAA;AAC5B,MAAA,IAAI,CAAC,SAAA,IAAa,OAAA,cAAqB,EAAE,KAAA,EAAO,SAAS,CAAA;AAAA,IAC3D,CAAC,CAAA,CACA,KAAA,CAAM,MAAM;AAAA,IAEb,CAAC,CAAA;AACH,IAAA,OAAO,MAAM;AACX,MAAA,SAAA,GAAY,IAAA;AAAA,IACd,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,KAAA,EAAO,YAAY,CAAC,CAAA;AAExB,EAAA,MAAM,eAAe,YAAA,KAAiB,QAAA,IAAY,SAAS,KAAA,KAAU,KAAA,GAAQ,SAAS,OAAA,GAAU,MAAA,CAAA;AAChG,EAAA,OAAO;AAAA,IACL,GAAI,KAAA,GAAQ,EAAE,KAAA,KAAU,EAAC;AAAA,IACzB,GAAI,YAAA,GAAe,EAAE,YAAA,KAAiB,EAAC;AAAA,IACvC,KAAA,EAAO,KAAA,KAAU,MAAA,IAAa,YAAA,KAAiB;AAAA,GACjD;AACF;AAqBO,SAAS,gBAAA,CAAiB,QAAA,GAAoC,EAAC,EAKpE;AACA,EAAA,MAAM,EAAE,MAAA,EAAQ,iBAAA,EAAkB,GAAIE,4BAAA,EAAgB;AACtD,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAIE,eAA8B,MAAM,CAAA;AAChE,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAIA,cAAA,EAAsC;AAClE,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,cAAA,EAAgC;AAC1D,EAAA,MAAM,QAAA,GAAWD,aAAO,KAAK,CAAA;AAE7B,EAAA,MAAM,IAAA,GAAOG,iBAAA;AAAA,IACX,OAAO,KAAA,KAA4C;AACjD,MAAA,IAAI,SAAS,OAAA,EAAS;AACpB,QAAA,MAAM,IAAIC,iCAAA,CAAgB,SAAA,EAAW,0CAAA,EAA4C;AAAA,UAC/E,IAAA,EAAM;AAAA,SACP,CAAA;AAAA,MACH;AACA,MAAA,QAAA,CAAS,OAAA,GAAU,IAAA;AACnB,MAAA,SAAA,CAAU,SAAS,CAAA;AACnB,MAAA,QAAA,CAAS,MAAS,CAAA;AAClB,MAAA,SAAA,CAAU,MAAS,CAAA;AACnB,MAAA,IAAI;AACF,QAAA,MAAM,OAAA,GAAUC,iCAAe,KAAK,CAAA;AACpC,QAAA,MAAM,KAAK,YAAA,EAAa;AAGxB,QAAA,MAAM,EAAA,GAAK,UAAW,MAAM,iBAAA,CAAkB,EAAE,EAAA,EAAIR,6BAAA,CAAY,IAAI,CAAA;AACpE,QAAA,IAAI,CAAC,EAAA,EAAI;AACP,UAAA,MAAM,IAAIO,iCAAA;AAAA,YACR,wBAAA;AAAA,YACA,4CAAA;AAAA,YACA,EAAE,MAAM,yGAAA;AAA0G,WACpH;AAAA,QACF;AACA,QAAA,SAAA,CAAU,YAAY,CAAA;AACtB,QAAA,MAAM,IAAA,GACJ,OAAA,CAAQ,MAAA,KAAW,CAAA,IAAK,QAAQ,CAAC,CAAA,GAC7B,MAAM,EAAA,CAAG,gBAAgB,EAAE,EAAA,EAAI,OAAA,CAAQ,CAAC,EAAE,EAAA,EAAI,IAAA,EAAM,OAAA,CAAQ,CAAC,CAAA,CAAE,IAAA,EAAM,KAAA,EAAO,OAAA,CAAQ,CAAC,CAAA,CAAE,KAAA,EAAO,CAAA,GAC9F,MAAM,EAAA,CAAG,eAAA,CAAgB,EAAE,KAAA,EAAO,SAAS,CAAA;AACjD,QAAA,MAAM,UAAU,MAAM,EAAA,CAAG,yBAAA,CAA0B,EAAE,MAAM,CAAA;AAC3D,QAAA,MAAM,IAAA,GAAOE,wCAAA,CAAuB,OAAA,EAAS,EAAA,CAAG,QAAQ,OAAkB,CAAA;AAC1E,QAAA,MAAM,GAAA,GAAuB;AAAA,UAC3B,UAAA,EAAY,MAAM,UAAA,IAAc,IAAA;AAAA,UAChC,eAAA,EAAiB,IAAA;AAAA,UACjB,OAAA,EAAS,IAAA,EAAM,OAAA,IAAW,OAAA,CAAQ,MAAA,KAAW,SAAA;AAAA,UAC7C,SAAA,EAAW,MAAM,SAAA,IAAa,IAAA;AAAA,UAC9B,gBAAA,EAAkB,MAAM,aAAA,IAAiB,EAAA;AAAA,UACzC,WAAA,EAAaC,uBAAA,CAAMV,6BAAA,EAAa,IAAI;AAAA,SACtC;AACA,QAAA,SAAA,CAAU,GAAG,CAAA;AACb,QAAA,SAAA,CAAU,WAAW,CAAA;AACrB,QAAA,OAAO,GAAA;AAAA,MACT,SAAS,MAAA,EAAQ;AACf,QAAA,MAAM,MAAMW,6BAAA,CAAY,MAAM,MAAM,MAAA,GAAU,MAAA,GAAuBC,wCAAsB,MAAM,CAAA;AACjG,QAAA,QAAA,CAAS,GAAG,CAAA;AACZ,QAAA,SAAA,CAAU,OAAO,CAAA;AACjB,QAAA,MAAM,GAAA;AAAA,MACR,CAAA,SAAE;AACA,QAAA,QAAA,CAAS,OAAA,GAAU,KAAA;AAAA,MACrB;AAAA,IACF,CAAA;AAAA,IACA,CAAC,QAAQ,iBAAiB;AAAA,GAC5B;AAEA,EAAA,OAAO,EAAE,IAAA,EAAM,MAAA,EAAQ,GAAI,MAAA,GAAS,EAAE,MAAA,EAAO,GAAI,EAAC,EAAI,GAAI,KAAA,GAAQ,EAAE,KAAA,EAAM,GAAI,EAAC,EAAG;AACpF;AAUO,SAAS,kBAAA,CACd,CAAA,GAAqE,EAAC,EAC5B;AAC1C,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAIR,cAAA,CAA4B;AAAA,IACtD,SAAA,EAAW,KAAA;AAAA,IACX,SAAA,EAAW,MAAA;AAAA,IACX,OAAA,EAAS,EAAE,UAAA,EAAY,KAAA,EAAM;AAAA,IAC7B,SAAA,EAAW,EAAE,UAAA,EAAY,KAAA,EAAM;AAAA,IAC/B,MAAA,EAAQ,8BAAA;AAAA,IACR,OAAO;AAAC,GACT,CAAA;AACD,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAIA,eAAS,IAAI,CAAA;AAC3C,EAAA,MAAM,EAAE,MAAA,GAAS,GAAA,EAAQ,UAAA,EAAY,cAAa,GAAI,CAAA;AAEtD,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,SAAA,GAAY,KAAA;AAChB,IAAA,MAAM,MAAM,YAA2B;AACrC,MAAA,IAAI;AACF,QAAA,MAAM,CAAA,GAAI,MAAMQ,kCAAA,CAAiB;AAAA,UAC/B,cAAc,YAAA,EAAa;AAAA,UAC3B,GAAI,UAAA,KAAe,KAAA,CAAA,GAAY,EAAE,UAAA,KAAe,EAAC;AAAA,UACjD,GAAI,YAAA,KAAiB,KAAA,CAAA,GAAY,EAAE,YAAA,KAAiB;AAAC,SACtD,CAAA;AACD,QAAA,IAAI,CAAC,SAAA,EAAW,SAAA,CAAU,CAAC,CAAA;AAAA,MAC7B,SAAS,CAAA,EAAG;AACV,QAAA,IAAI,CAAC,SAAA,EAAW;AACd,UAAA,SAAA,CAAU,CAAC,IAAA,MAAU,EAAE,GAAG,IAAA,EAAM,SAAA,EAAW,OAAO,MAAA,EAAQF,6BAAA,CAAY,CAAC,CAAA,CAAE,OAAA,EAAS,OAAO,CAACA,6BAAA,CAAY,CAAC,CAAA,CAAE,IAAI,GAAE,CAAE,CAAA;AAAA,QACnH;AAAA,MACF,CAAA,SAAE;AACA,QAAA,IAAI,CAAC,SAAA,EAAW,UAAA,CAAW,KAAK,CAAA;AAAA,MAClC;AAAA,IACF,CAAA;AACA,IAAA,KAAK,GAAA,EAAI;AACT,IAAA,MAAM,EAAA,GAAK,SAAS,CAAA,GAAI,WAAA,CAAY,MAAM,KAAK,GAAA,EAAI,EAAG,MAAM,CAAA,GAAI,MAAA;AAChE,IAAA,OAAO,MAAM;AACX,MAAA,SAAA,GAAY,IAAA;AACZ,MAAA,IAAI,EAAA,KAAO,MAAA,EAAW,aAAA,CAAc,EAAE,CAAA;AAAA,IACxC,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,MAAA,EAAQ,UAAA,EAAY,YAAY,CAAC,CAAA;AAErC,EAAA,OAAO,EAAE,GAAG,MAAA,EAAQ,OAAA,EAAQ;AAC9B","file":"react.cjs","sourcesContent":["/**\n * @pepu-chain/sdk/aa/react: React hooks for sponsored transactions with Privy\n * Smart Wallets.\n *\n * Needs `react`, `@privy-io/react-auth` and, because Privy's smart-wallets\n * module requires it, `permissionless`. It never references `@zerodev/*`,\n * statically or dynamically, so a bundler resolving it needs no ZeroDev. The\n * transport reads bundler and paymaster URLs from the Privy dashboard. To use\n * your own bundler and paymaster instead, see `@pepu-chain/sdk/aa/react-direct`.\n *\n * Flow ported from `templates/sponsored-demo/components/sponsored-tap-demo.tsx`\n * (smart-wallet client, in-flight guard, real error text via describeUserOpFailure).\n */\nimport { useWallets } from \"@privy-io/react-auth\";\nimport { useSmartWallets } from \"@privy-io/react-auth/smart-wallets\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { Address, PublicClient } from \"viem\";\n\nimport { pepuMainnet } from \"../chains.js\";\nimport { getPublicClient } from \"../client.js\";\nimport { PepuConfigError, toPepuError } from \"../errors.js\";\nimport type { PepuError } from \"../errors.js\";\nimport { txUrl } from \"../explorer.js\";\nimport { normalizeCalls, userOpEventFromReceipt } from \"./calls.js\";\nimport { describeUserOpFailure } from \"./describe.js\";\nimport { checkSponsorship } from \"./status.js\";\nimport type { SponsorshipReport } from \"./status.js\";\nimport type { Call, SponsoredResult } from \"./types.js\";\n\nexport type { Call, SponsoredResult } from \"./types.js\";\n\nlet sharedClient: PublicClient | undefined;\nfunction publicClient(): PublicClient {\n  sharedClient ??= getPublicClient(pepuMainnet) as unknown as PublicClient;\n  return sharedClient;\n}\n\n/** The Privy embedded wallet, the owner of the smart account. */\nfunction useEmbeddedWallet() {\n  const { wallets } = useWallets();\n  return wallets.find((w) => w.walletClientType === \"privy\");\n}\n\n/**\n * The two-address model made explicit: `owner` is the Privy embedded wallet\n * (an EOA that signs), `smartAccount` is the Kernel account that sends and\n * holds assets. With Privy Smart Wallets the smart account comes from the\n * provider: `useSmartWallets().client`, or, while that is still unset,\n * `getClientForChain({ id: 97741 })`. For an address derived without Privy\n * Smart Wallets, use `useDirectSmartAccount` from `@pepu-chain/sdk/aa/react-direct`.\n *\n * @example\n * const { owner, smartAccount, ready } = usePepuSmartAccount();\n */\nexport function usePepuSmartAccount(): { owner?: Address; smartAccount?: Address; ready: boolean } {\n  const embedded = useEmbeddedWallet();\n  const { client, getClientForChain } = useSmartWallets();\n  const getClientRef = useRef(getClientForChain);\n  getClientRef.current = getClientForChain;\n  const owner = embedded?.address as Address | undefined;\n  const fromProvider = client?.account?.address as Address | undefined;\n  const [resolved, setResolved] = useState<{ owner: Address; address: Address } | undefined>();\n\n  useEffect(() => {\n    if (!owner || fromProvider) return;\n    let cancelled = false;\n    // Privy's per-chain client may populate after `client`.\n    Promise.resolve(getClientRef.current?.({ id: pepuMainnet.id }))\n      .then((c) => {\n        const address = c?.account?.address as Address | undefined;\n        if (!cancelled && address) setResolved({ owner, address });\n      })\n      .catch(() => {\n        // Smart Wallets not configured for this chain: `ready` stays false.\n      });\n    return () => {\n      cancelled = true;\n    };\n  }, [owner, fromProvider]);\n\n  const smartAccount = fromProvider ?? (resolved && resolved.owner === owner ? resolved.address : undefined);\n  return {\n    ...(owner ? { owner } : {}),\n    ...(smartAccount ? { smartAccount } : {}),\n    ready: owner !== undefined && smartAccount !== undefined,\n  };\n}\n\n/** Status of a {@link useSponsoredSend} send. */\nexport type SponsoredSendStatus = \"idle\" | \"signing\" | \"submitting\" | \"confirmed\" | \"error\";\n\n/** Options for {@link useSponsoredSend}. */\nexport interface UseSponsoredSendOptions {\n  /** The only transport here. Your own bundler and paymaster: `useDirectSponsoredSend` in `@pepu-chain/sdk/aa/react-direct`. */\n  transport?: \"privy-smart-wallets\";\n}\n\n/**\n * Send calls with gas sponsored through Privy's smart-wallet client (bundler\n * and paymaster URLs come from the Privy dashboard). One send at a time: a\n * second call while one is in flight is ignored. For your own bundler and\n * paymaster, use `useDirectSponsoredSend` from `@pepu-chain/sdk/aa/react-direct`.\n *\n * @example\n * const { send, status, result, error } = useSponsoredSend({ transport: \"privy-smart-wallets\" });\n * await send([{ to: tapScore, abi: tapScoreAbi, functionName: \"tap\" }]);\n */\nexport function useSponsoredSend(_options: UseSponsoredSendOptions = {}): {\n  send: (calls: Call[]) => Promise<SponsoredResult>;\n  status: SponsoredSendStatus;\n  result?: SponsoredResult;\n  error?: PepuError;\n} {\n  const { client, getClientForChain } = useSmartWallets();\n  const [status, setStatus] = useState<SponsoredSendStatus>(\"idle\");\n  const [result, setResult] = useState<SponsoredResult | undefined>();\n  const [error, setError] = useState<PepuError | undefined>();\n  const inFlight = useRef(false);\n\n  const send = useCallback(\n    async (calls: Call[]): Promise<SponsoredResult> => {\n      if (inFlight.current) {\n        throw new PepuConfigError(\"UNKNOWN\", \"A sponsored send is already in progress.\", {\n          hint: \"Wait for the current send to finish.\",\n        });\n      }\n      inFlight.current = true;\n      setStatus(\"signing\");\n      setError(undefined);\n      setResult(undefined);\n      try {\n        const encoded = normalizeCalls(calls);\n        const pc = publicClient();\n\n\n        const sw = client ?? (await getClientForChain({ id: pepuMainnet.id }));\n        if (!sw) {\n          throw new PepuConfigError(\n            \"CONFIG_PRIVY_DASHBOARD\",\n            \"No Privy smart-wallet client is available.\",\n            { hint: 'Enable \"Smart Wallets\" for chain 97741 in the Privy dashboard and wrap the app in SmartWalletsProvider.' },\n          );\n        }\n        setStatus(\"submitting\");\n        const hash =\n          encoded.length === 1 && encoded[0]\n            ? await sw.sendTransaction({ to: encoded[0].to, data: encoded[0].data, value: encoded[0].value })\n            : await sw.sendTransaction({ calls: encoded });\n        const receipt = await pc.waitForTransactionReceipt({ hash });\n        const paid = userOpEventFromReceipt(receipt, sw.account.address as Address);\n        const out: SponsoredResult = {\n          userOpHash: paid?.userOpHash ?? null,\n          transactionHash: hash,\n          success: paid?.success ?? receipt.status === \"success\",\n          paymaster: paid?.paymaster ?? null,\n          actualGasCostWei: paid?.actualGasCost ?? 0n,\n          explorerUrl: txUrl(pepuMainnet, hash),\n        };\n        setResult(out);\n        setStatus(\"confirmed\");\n        return out;\n      } catch (caught) {\n        const err = toPepuError(caught) === caught ? (caught as PepuError) : describeUserOpFailure(caught);\n        setError(err);\n        setStatus(\"error\");\n        throw err;\n      } finally {\n        inFlight.current = false;\n      }\n    },\n    [client, getClientForChain],\n  );\n\n  return { send, status, ...(result ? { result } : {}), ...(error ? { error } : {}) };\n}\n\n/**\n * Live sponsorship status, polled. The live replacement for the deprecated\n * `useSponsorshipStatus` (which always said unavailable).\n *\n * @example\n * const s = usePepuSponsorship({ pollMs: 15000 });\n * if (!s.loading && !s.available) console.log(s.reason, s.fixes);\n */\nexport function usePepuSponsorship(\n  o: { pollMs?: number; bundlerUrl?: string; paymasterUrl?: string } = {},\n): SponsorshipReport & { loading: boolean } {\n  const [report, setReport] = useState<SponsorshipReport>({\n    available: false,\n    transport: \"none\",\n    bundler: { configured: false },\n    paymaster: { configured: false },\n    reason: \"Checking sponsorship status.\",\n    fixes: [],\n  });\n  const [loading, setLoading] = useState(true);\n  const { pollMs = 30_000, bundlerUrl, paymasterUrl } = o;\n\n  useEffect(() => {\n    let cancelled = false;\n    const run = async (): Promise<void> => {\n      try {\n        const r = await checkSponsorship({\n          publicClient: publicClient(),\n          ...(bundlerUrl !== undefined ? { bundlerUrl } : {}),\n          ...(paymasterUrl !== undefined ? { paymasterUrl } : {}),\n        });\n        if (!cancelled) setReport(r);\n      } catch (e) {\n        if (!cancelled) {\n          setReport((prev) => ({ ...prev, available: false, reason: toPepuError(e).message, fixes: [toPepuError(e).hint] }));\n        }\n      } finally {\n        if (!cancelled) setLoading(false);\n      }\n    };\n    void run();\n    const id = pollMs > 0 ? setInterval(() => void run(), pollMs) : undefined;\n    return () => {\n      cancelled = true;\n      if (id !== undefined) clearInterval(id);\n    };\n  }, [pollMs, bundlerUrl, paymasterUrl]);\n\n  return { ...report, loading };\n}\n"]}

package/dist/aa/react.d.cts

@@ -0,0 +1,62 @@
+import { Address } from 'viem';
+import { P as PepuError } from '../errors-CgX1vNj7.cjs';
+import { S as SponsorshipReport } from '../status-CmOsyPmO.cjs';
+import { C as Call, S as SponsoredResult } from '../types-BilBTDqK.cjs';
+import '../chains-DK13zGIp.cjs';
+
+/**
+ * The two-address model made explicit: `owner` is the Privy embedded wallet
+ * (an EOA that signs), `smartAccount` is the Kernel account that sends and
+ * holds assets. With Privy Smart Wallets the smart account comes from the
+ * provider: `useSmartWallets().client`, or, while that is still unset,
+ * `getClientForChain({ id: 97741 })`. For an address derived without Privy
+ * Smart Wallets, use `useDirectSmartAccount` from `@pepu-chain/sdk/aa/react-direct`.
+ *
+ * @example
+ * const { owner, smartAccount, ready } = usePepuSmartAccount();
+ */
+declare function usePepuSmartAccount(): {
+    owner?: Address;
+    smartAccount?: Address;
+    ready: boolean;
+};
+/** Status of a {@link useSponsoredSend} send. */
+type SponsoredSendStatus = "idle" | "signing" | "submitting" | "confirmed" | "error";
+/** Options for {@link useSponsoredSend}. */
+interface UseSponsoredSendOptions {
+    /** The only transport here. Your own bundler and paymaster: `useDirectSponsoredSend` in `@pepu-chain/sdk/aa/react-direct`. */
+    transport?: "privy-smart-wallets";
+}
+/**
+ * Send calls with gas sponsored through Privy's smart-wallet client (bundler
+ * and paymaster URLs come from the Privy dashboard). One send at a time: a
+ * second call while one is in flight is ignored. For your own bundler and
+ * paymaster, use `useDirectSponsoredSend` from `@pepu-chain/sdk/aa/react-direct`.
+ *
+ * @example
+ * const { send, status, result, error } = useSponsoredSend({ transport: "privy-smart-wallets" });
+ * await send([{ to: tapScore, abi: tapScoreAbi, functionName: "tap" }]);
+ */
+declare function useSponsoredSend(_options?: UseSponsoredSendOptions): {
+    send: (calls: Call[]) => Promise<SponsoredResult>;
+    status: SponsoredSendStatus;
+    result?: SponsoredResult;
+    error?: PepuError;
+};
+/**
+ * Live sponsorship status, polled. The live replacement for the deprecated
+ * `useSponsorshipStatus` (which always said unavailable).
+ *
+ * @example
+ * const s = usePepuSponsorship({ pollMs: 15000 });
+ * if (!s.loading && !s.available) console.log(s.reason, s.fixes);
+ */
+declare function usePepuSponsorship(o?: {
+    pollMs?: number;
+    bundlerUrl?: string;
+    paymasterUrl?: string;
+}): SponsorshipReport & {
+    loading: boolean;
+};
+
+export { Call, SponsoredResult, type SponsoredSendStatus, type UseSponsoredSendOptions, usePepuSmartAccount, usePepuSponsorship, useSponsoredSend };

package/dist/aa/react.d.ts

@@ -0,0 +1,62 @@
+import { Address } from 'viem';
+import { P as PepuError } from '../errors-CgX1vNj7.js';
+import { S as SponsorshipReport } from '../status-DwkkOrGQ.js';
+import { C as Call, S as SponsoredResult } from '../types-BilBTDqK.js';
+import '../chains-DK13zGIp.js';
+
+/**
+ * The two-address model made explicit: `owner` is the Privy embedded wallet
+ * (an EOA that signs), `smartAccount` is the Kernel account that sends and
+ * holds assets. With Privy Smart Wallets the smart account comes from the
+ * provider: `useSmartWallets().client`, or, while that is still unset,
+ * `getClientForChain({ id: 97741 })`. For an address derived without Privy
+ * Smart Wallets, use `useDirectSmartAccount` from `@pepu-chain/sdk/aa/react-direct`.
+ *
+ * @example
+ * const { owner, smartAccount, ready } = usePepuSmartAccount();
+ */
+declare function usePepuSmartAccount(): {
+    owner?: Address;
+    smartAccount?: Address;
+    ready: boolean;
+};
+/** Status of a {@link useSponsoredSend} send. */
+type SponsoredSendStatus = "idle" | "signing" | "submitting" | "confirmed" | "error";
+/** Options for {@link useSponsoredSend}. */
+interface UseSponsoredSendOptions {
+    /** The only transport here. Your own bundler and paymaster: `useDirectSponsoredSend` in `@pepu-chain/sdk/aa/react-direct`. */
+    transport?: "privy-smart-wallets";
+}
+/**
+ * Send calls with gas sponsored through Privy's smart-wallet client (bundler
+ * and paymaster URLs come from the Privy dashboard). One send at a time: a
+ * second call while one is in flight is ignored. For your own bundler and
+ * paymaster, use `useDirectSponsoredSend` from `@pepu-chain/sdk/aa/react-direct`.
+ *
+ * @example
+ * const { send, status, result, error } = useSponsoredSend({ transport: "privy-smart-wallets" });
+ * await send([{ to: tapScore, abi: tapScoreAbi, functionName: "tap" }]);
+ */
+declare function useSponsoredSend(_options?: UseSponsoredSendOptions): {
+    send: (calls: Call[]) => Promise<SponsoredResult>;
+    status: SponsoredSendStatus;
+    result?: SponsoredResult;
+    error?: PepuError;
+};
+/**
+ * Live sponsorship status, polled. The live replacement for the deprecated
+ * `useSponsorshipStatus` (which always said unavailable).
+ *
+ * @example
+ * const s = usePepuSponsorship({ pollMs: 15000 });
+ * if (!s.loading && !s.available) console.log(s.reason, s.fixes);
+ */
+declare function usePepuSponsorship(o?: {
+    pollMs?: number;
+    bundlerUrl?: string;
+    paymasterUrl?: string;
+}): SponsorshipReport & {
+    loading: boolean;
+};
+
+export { Call, SponsoredResult, type SponsoredSendStatus, type UseSponsoredSendOptions, usePepuSmartAccount, usePepuSponsorship, useSponsoredSend };

package/dist/aa/react.js

@@ -0,0 +1,147 @@
+import { normalizeCalls, userOpEventFromReceipt } from '../chunk-VBH3JLQ5.js';
+import { checkSponsorship } from '../chunk-KIIFL4VM.js';
+import { describeUserOpFailure } from '../chunk-D52PADVY.js';
+import '../chunk-FCXSP2YF.js';
+import { getPublicClient } from '../chunk-OH3QMAIB.js';
+import { txUrl } from '../chunk-J6UXXHBE.js';
+import '../chunk-XC4IBCI2.js';
+import { pepuMainnet } from '../chunk-VTQIHMF3.js';
+import { PepuConfigError, toPepuError } from '../chunk-6DSZ4Z2N.js';
+import { useWallets } from '@privy-io/react-auth';
+import { useSmartWallets } from '@privy-io/react-auth/smart-wallets';
+import { useRef, useState, useEffect, useCallback } from 'react';
+
+var sharedClient;
+function publicClient() {
+  sharedClient ??= getPublicClient(pepuMainnet);
+  return sharedClient;
+}
+function useEmbeddedWallet() {
+  const { wallets } = useWallets();
+  return wallets.find((w) => w.walletClientType === "privy");
+}
+function usePepuSmartAccount() {
+  const embedded = useEmbeddedWallet();
+  const { client, getClientForChain } = useSmartWallets();
+  const getClientRef = useRef(getClientForChain);
+  getClientRef.current = getClientForChain;
+  const owner = embedded?.address;
+  const fromProvider = client?.account?.address;
+  const [resolved, setResolved] = useState();
+  useEffect(() => {
+    if (!owner || fromProvider) return;
+    let cancelled = false;
+    Promise.resolve(getClientRef.current?.({ id: pepuMainnet.id })).then((c) => {
+      const address = c?.account?.address;
+      if (!cancelled && address) setResolved({ owner, address });
+    }).catch(() => {
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [owner, fromProvider]);
+  const smartAccount = fromProvider ?? (resolved && resolved.owner === owner ? resolved.address : void 0);
+  return {
+    ...owner ? { owner } : {},
+    ...smartAccount ? { smartAccount } : {},
+    ready: owner !== void 0 && smartAccount !== void 0
+  };
+}
+function useSponsoredSend(_options = {}) {
+  const { client, getClientForChain } = useSmartWallets();
+  const [status, setStatus] = useState("idle");
+  const [result, setResult] = useState();
+  const [error, setError] = useState();
+  const inFlight = useRef(false);
+  const send = useCallback(
+    async (calls) => {
+      if (inFlight.current) {
+        throw new PepuConfigError("UNKNOWN", "A sponsored send is already in progress.", {
+          hint: "Wait for the current send to finish."
+        });
+      }
+      inFlight.current = true;
+      setStatus("signing");
+      setError(void 0);
+      setResult(void 0);
+      try {
+        const encoded = normalizeCalls(calls);
+        const pc = publicClient();
+        const sw = client ?? await getClientForChain({ id: pepuMainnet.id });
+        if (!sw) {
+          throw new PepuConfigError(
+            "CONFIG_PRIVY_DASHBOARD",
+            "No Privy smart-wallet client is available.",
+            { hint: 'Enable "Smart Wallets" for chain 97741 in the Privy dashboard and wrap the app in SmartWalletsProvider.' }
+          );
+        }
+        setStatus("submitting");
+        const hash = encoded.length === 1 && encoded[0] ? await sw.sendTransaction({ to: encoded[0].to, data: encoded[0].data, value: encoded[0].value }) : await sw.sendTransaction({ calls: encoded });
+        const receipt = await pc.waitForTransactionReceipt({ hash });
+        const paid = userOpEventFromReceipt(receipt, sw.account.address);
+        const out = {
+          userOpHash: paid?.userOpHash ?? null,
+          transactionHash: hash,
+          success: paid?.success ?? receipt.status === "success",
+          paymaster: paid?.paymaster ?? null,
+          actualGasCostWei: paid?.actualGasCost ?? 0n,
+          explorerUrl: txUrl(pepuMainnet, hash)
+        };
+        setResult(out);
+        setStatus("confirmed");
+        return out;
+      } catch (caught) {
+        const err = toPepuError(caught) === caught ? caught : describeUserOpFailure(caught);
+        setError(err);
+        setStatus("error");
+        throw err;
+      } finally {
+        inFlight.current = false;
+      }
+    },
+    [client, getClientForChain]
+  );
+  return { send, status, ...result ? { result } : {}, ...error ? { error } : {} };
+}
+function usePepuSponsorship(o = {}) {
+  const [report, setReport] = useState({
+    available: false,
+    transport: "none",
+    bundler: { configured: false },
+    paymaster: { configured: false },
+    reason: "Checking sponsorship status.",
+    fixes: []
+  });
+  const [loading, setLoading] = useState(true);
+  const { pollMs = 3e4, bundlerUrl, paymasterUrl } = o;
+  useEffect(() => {
+    let cancelled = false;
+    const run = async () => {
+      try {
+        const r = await checkSponsorship({
+          publicClient: publicClient(),
+          ...bundlerUrl !== void 0 ? { bundlerUrl } : {},
+          ...paymasterUrl !== void 0 ? { paymasterUrl } : {}
+        });
+        if (!cancelled) setReport(r);
+      } catch (e) {
+        if (!cancelled) {
+          setReport((prev) => ({ ...prev, available: false, reason: toPepuError(e).message, fixes: [toPepuError(e).hint] }));
+        }
+      } finally {
+        if (!cancelled) setLoading(false);
+      }
+    };
+    void run();
+    const id = pollMs > 0 ? setInterval(() => void run(), pollMs) : void 0;
+    return () => {
+      cancelled = true;
+      if (id !== void 0) clearInterval(id);
+    };
+  }, [pollMs, bundlerUrl, paymasterUrl]);
+  return { ...report, loading };
+}
+
+export { usePepuSmartAccount, usePepuSponsorship, useSponsoredSend };
+//# sourceMappingURL=react.js.map
+//# sourceMappingURL=react.js.map

package/dist/aa/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/aa/react.ts"],"names":[],"mappings":"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","file":"react.js","sourcesContent":["/**\n * @pepu-chain/sdk/aa/react: React hooks for sponsored transactions with Privy\n * Smart Wallets.\n *\n * Needs `react`, `@privy-io/react-auth` and, because Privy's smart-wallets\n * module requires it, `permissionless`. It never references `@zerodev/*`,\n * statically or dynamically, so a bundler resolving it needs no ZeroDev. The\n * transport reads bundler and paymaster URLs from the Privy dashboard. To use\n * your own bundler and paymaster instead, see `@pepu-chain/sdk/aa/react-direct`.\n *\n * Flow ported from `templates/sponsored-demo/components/sponsored-tap-demo.tsx`\n * (smart-wallet client, in-flight guard, real error text via describeUserOpFailure).\n */\nimport { useWallets } from \"@privy-io/react-auth\";\nimport { useSmartWallets } from \"@privy-io/react-auth/smart-wallets\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { Address, PublicClient } from \"viem\";\n\nimport { pepuMainnet } from \"../chains.js\";\nimport { getPublicClient } from \"../client.js\";\nimport { PepuConfigError, toPepuError } from \"../errors.js\";\nimport type { PepuError } from \"../errors.js\";\nimport { txUrl } from \"../explorer.js\";\nimport { normalizeCalls, userOpEventFromReceipt } from \"./calls.js\";\nimport { describeUserOpFailure } from \"./describe.js\";\nimport { checkSponsorship } from \"./status.js\";\nimport type { SponsorshipReport } from \"./status.js\";\nimport type { Call, SponsoredResult } from \"./types.js\";\n\nexport type { Call, SponsoredResult } from \"./types.js\";\n\nlet sharedClient: PublicClient | undefined;\nfunction publicClient(): PublicClient {\n  sharedClient ??= getPublicClient(pepuMainnet) as unknown as PublicClient;\n  return sharedClient;\n}\n\n/** The Privy embedded wallet, the owner of the smart account. */\nfunction useEmbeddedWallet() {\n  const { wallets } = useWallets();\n  return wallets.find((w) => w.walletClientType === \"privy\");\n}\n\n/**\n * The two-address model made explicit: `owner` is the Privy embedded wallet\n * (an EOA that signs), `smartAccount` is the Kernel account that sends and\n * holds assets. With Privy Smart Wallets the smart account comes from the\n * provider: `useSmartWallets().client`, or, while that is still unset,\n * `getClientForChain({ id: 97741 })`. For an address derived without Privy\n * Smart Wallets, use `useDirectSmartAccount` from `@pepu-chain/sdk/aa/react-direct`.\n *\n * @example\n * const { owner, smartAccount, ready } = usePepuSmartAccount();\n */\nexport function usePepuSmartAccount(): { owner?: Address; smartAccount?: Address; ready: boolean } {\n  const embedded = useEmbeddedWallet();\n  const { client, getClientForChain } = useSmartWallets();\n  const getClientRef = useRef(getClientForChain);\n  getClientRef.current = getClientForChain;\n  const owner = embedded?.address as Address | undefined;\n  const fromProvider = client?.account?.address as Address | undefined;\n  const [resolved, setResolved] = useState<{ owner: Address; address: Address } | undefined>();\n\n  useEffect(() => {\n    if (!owner || fromProvider) return;\n    let cancelled = false;\n    // Privy's per-chain client may populate after `client`.\n    Promise.resolve(getClientRef.current?.({ id: pepuMainnet.id }))\n      .then((c) => {\n        const address = c?.account?.address as Address | undefined;\n        if (!cancelled && address) setResolved({ owner, address });\n      })\n      .catch(() => {\n        // Smart Wallets not configured for this chain: `ready` stays false.\n      });\n    return () => {\n      cancelled = true;\n    };\n  }, [owner, fromProvider]);\n\n  const smartAccount = fromProvider ?? (resolved && resolved.owner === owner ? resolved.address : undefined);\n  return {\n    ...(owner ? { owner } : {}),\n    ...(smartAccount ? { smartAccount } : {}),\n    ready: owner !== undefined && smartAccount !== undefined,\n  };\n}\n\n/** Status of a {@link useSponsoredSend} send. */\nexport type SponsoredSendStatus = \"idle\" | \"signing\" | \"submitting\" | \"confirmed\" | \"error\";\n\n/** Options for {@link useSponsoredSend}. */\nexport interface UseSponsoredSendOptions {\n  /** The only transport here. Your own bundler and paymaster: `useDirectSponsoredSend` in `@pepu-chain/sdk/aa/react-direct`. */\n  transport?: \"privy-smart-wallets\";\n}\n\n/**\n * Send calls with gas sponsored through Privy's smart-wallet client (bundler\n * and paymaster URLs come from the Privy dashboard). One send at a time: a\n * second call while one is in flight is ignored. For your own bundler and\n * paymaster, use `useDirectSponsoredSend` from `@pepu-chain/sdk/aa/react-direct`.\n *\n * @example\n * const { send, status, result, error } = useSponsoredSend({ transport: \"privy-smart-wallets\" });\n * await send([{ to: tapScore, abi: tapScoreAbi, functionName: \"tap\" }]);\n */\nexport function useSponsoredSend(_options: UseSponsoredSendOptions = {}): {\n  send: (calls: Call[]) => Promise<SponsoredResult>;\n  status: SponsoredSendStatus;\n  result?: SponsoredResult;\n  error?: PepuError;\n} {\n  const { client, getClientForChain } = useSmartWallets();\n  const [status, setStatus] = useState<SponsoredSendStatus>(\"idle\");\n  const [result, setResult] = useState<SponsoredResult | undefined>();\n  const [error, setError] = useState<PepuError | undefined>();\n  const inFlight = useRef(false);\n\n  const send = useCallback(\n    async (calls: Call[]): Promise<SponsoredResult> => {\n      if (inFlight.current) {\n        throw new PepuConfigError(\"UNKNOWN\", \"A sponsored send is already in progress.\", {\n          hint: \"Wait for the current send to finish.\",\n        });\n      }\n      inFlight.current = true;\n      setStatus(\"signing\");\n      setError(undefined);\n      setResult(undefined);\n      try {\n        const encoded = normalizeCalls(calls);\n        const pc = publicClient();\n\n\n        const sw = client ?? (await getClientForChain({ id: pepuMainnet.id }));\n        if (!sw) {\n          throw new PepuConfigError(\n            \"CONFIG_PRIVY_DASHBOARD\",\n            \"No Privy smart-wallet client is available.\",\n            { hint: 'Enable \"Smart Wallets\" for chain 97741 in the Privy dashboard and wrap the app in SmartWalletsProvider.' },\n          );\n        }\n        setStatus(\"submitting\");\n        const hash =\n          encoded.length === 1 && encoded[0]\n            ? await sw.sendTransaction({ to: encoded[0].to, data: encoded[0].data, value: encoded[0].value })\n            : await sw.sendTransaction({ calls: encoded });\n        const receipt = await pc.waitForTransactionReceipt({ hash });\n        const paid = userOpEventFromReceipt(receipt, sw.account.address as Address);\n        const out: SponsoredResult = {\n          userOpHash: paid?.userOpHash ?? null,\n          transactionHash: hash,\n          success: paid?.success ?? receipt.status === \"success\",\n          paymaster: paid?.paymaster ?? null,\n          actualGasCostWei: paid?.actualGasCost ?? 0n,\n          explorerUrl: txUrl(pepuMainnet, hash),\n        };\n        setResult(out);\n        setStatus(\"confirmed\");\n        return out;\n      } catch (caught) {\n        const err = toPepuError(caught) === caught ? (caught as PepuError) : describeUserOpFailure(caught);\n        setError(err);\n        setStatus(\"error\");\n        throw err;\n      } finally {\n        inFlight.current = false;\n      }\n    },\n    [client, getClientForChain],\n  );\n\n  return { send, status, ...(result ? { result } : {}), ...(error ? { error } : {}) };\n}\n\n/**\n * Live sponsorship status, polled. The live replacement for the deprecated\n * `useSponsorshipStatus` (which always said unavailable).\n *\n * @example\n * const s = usePepuSponsorship({ pollMs: 15000 });\n * if (!s.loading && !s.available) console.log(s.reason, s.fixes);\n */\nexport function usePepuSponsorship(\n  o: { pollMs?: number; bundlerUrl?: string; paymasterUrl?: string } = {},\n): SponsorshipReport & { loading: boolean } {\n  const [report, setReport] = useState<SponsorshipReport>({\n    available: false,\n    transport: \"none\",\n    bundler: { configured: false },\n    paymaster: { configured: false },\n    reason: \"Checking sponsorship status.\",\n    fixes: [],\n  });\n  const [loading, setLoading] = useState(true);\n  const { pollMs = 30_000, bundlerUrl, paymasterUrl } = o;\n\n  useEffect(() => {\n    let cancelled = false;\n    const run = async (): Promise<void> => {\n      try {\n        const r = await checkSponsorship({\n          publicClient: publicClient(),\n          ...(bundlerUrl !== undefined ? { bundlerUrl } : {}),\n          ...(paymasterUrl !== undefined ? { paymasterUrl } : {}),\n        });\n        if (!cancelled) setReport(r);\n      } catch (e) {\n        if (!cancelled) {\n          setReport((prev) => ({ ...prev, available: false, reason: toPepuError(e).message, fixes: [toPepuError(e).hint] }));\n        }\n      } finally {\n        if (!cancelled) setLoading(false);\n      }\n    };\n    void run();\n    const id = pollMs > 0 ? setInterval(() => void run(), pollMs) : undefined;\n    return () => {\n      cancelled = true;\n      if (id !== undefined) clearInterval(id);\n    };\n  }, [pollMs, bundlerUrl, paymasterUrl]);\n\n  return { ...report, loading };\n}\n"]}

package/dist/aa.cjs

@@ -0,0 +1,84 @@
+'use strict';
+
+var chunk7MNJF2OB_cjs = require('./chunk-7MNJF2OB.cjs');
+var chunkAJS4UFQX_cjs = require('./chunk-AJS4UFQX.cjs');
+require('./chunk-A5LP2UCS.cjs');
+var chunkSLW7FRTL_cjs = require('./chunk-SLW7FRTL.cjs');
+var chunkWANILJZQ_cjs = require('./chunk-WANILJZQ.cjs');
+require('./chunk-TIEAZYHF.cjs');
+require('./chunk-VF3D6KLQ.cjs');
+require('./chunk-DPCZJLB3.cjs');
+require('./chunk-YQL7NISX.cjs');
+
+
+
+Object.defineProperty(exports, "ENTRY_POINT_V07", {
+  enumerable: true,
+  get: function () { return chunk7MNJF2OB_cjs.ENTRY_POINT_V07; }
+});
+Object.defineProperty(exports, "createPepuBundlerClient", {
+  enumerable: true,
+  get: function () { return chunk7MNJF2OB_cjs.createPepuBundlerClient; }
+});
+Object.defineProperty(exports, "createPepuPaymasterClient", {
+  enumerable: true,
+  get: function () { return chunk7MNJF2OB_cjs.createPepuPaymasterClient; }
+});
+Object.defineProperty(exports, "estimatePepuUserOpFees", {
+  enumerable: true,
+  get: function () { return chunk7MNJF2OB_cjs.estimatePepuUserOpFees; }
+});
+Object.defineProperty(exports, "encodeKernelExecute", {
+  enumerable: true,
+  get: function () { return chunkAJS4UFQX_cjs.encodeKernelExecute; }
+});
+Object.defineProperty(exports, "normalizeCalls", {
+  enumerable: true,
+  get: function () { return chunkAJS4UFQX_cjs.normalizeCalls; }
+});
+Object.defineProperty(exports, "userOpEventFromReceipt", {
+  enumerable: true,
+  get: function () { return chunkAJS4UFQX_cjs.userOpEventFromReceipt; }
+});
+Object.defineProperty(exports, "userOpEventsFromReceipt", {
+  enumerable: true,
+  get: function () { return chunkAJS4UFQX_cjs.userOpEventsFromReceipt; }
+});
+Object.defineProperty(exports, "checkSponsorship", {
+  enumerable: true,
+  get: function () { return chunkSLW7FRTL_cjs.checkSponsorship; }
+});
+Object.defineProperty(exports, "getKernelAccountAddress", {
+  enumerable: true,
+  get: function () { return chunkSLW7FRTL_cjs.getKernelAccountAddress; }
+});
+Object.defineProperty(exports, "getPaymasterDeposit", {
+  enumerable: true,
+  get: function () { return chunkSLW7FRTL_cjs.getPaymasterDeposit; }
+});
+Object.defineProperty(exports, "getPepuKernelStack", {
+  enumerable: true,
+  get: function () { return chunkSLW7FRTL_cjs.getPepuKernelStack; }
+});
+Object.defineProperty(exports, "getSponsorshipStatus", {
+  enumerable: true,
+  get: function () { return chunkSLW7FRTL_cjs.getSponsorshipStatus; }
+});
+Object.defineProperty(exports, "probeBundler", {
+  enumerable: true,
+  get: function () { return chunkSLW7FRTL_cjs.probeBundler; }
+});
+Object.defineProperty(exports, "probePaymaster", {
+  enumerable: true,
+  get: function () { return chunkSLW7FRTL_cjs.probePaymaster; }
+});
+Object.defineProperty(exports, "describeUserOpFailure", {
+  enumerable: true,
+  get: function () { return chunkWANILJZQ_cjs.describeUserOpFailure; }
+});
+Object.defineProperty(exports, "redactSecrets", {
+  enumerable: true,
+  get: function () { return chunkWANILJZQ_cjs.redactSecrets; }
+});
+//# sourceMappingURL=aa.cjs.map
+//# sourceMappingURL=aa.cjs.map

package/dist/aa.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"aa.cjs"}

package/dist/aa.d.cts

@@ -0,0 +1,85 @@
+import { PublicClient } from 'viem';
+import { SmartAccount, PaymasterClient, BundlerClient } from 'viem/account-abstraction';
+import { P as PaymasterContext } from './erc7677-DOW58QBE.cjs';
+export { B as BundlerProbeResult, C as CheckSponsorshipOptions, F as FetchLike, G as GetSponsorshipStatusOptions, P as PaymasterProbeResult, a as PepuKernelStack, b as ProbeOptions, S as SponsorshipReport, c as SponsorshipStatus, d as checkSponsorship, g as getKernelAccountAddress, e as getPaymasterDeposit, f as getPepuKernelStack, h as getSponsorshipStatus, p as probeBundler, i as probePaymaster } from './status-CmOsyPmO.cjs';
+import { a as PepuBundlerError, b as PepuPaymasterError } from './errors-CgX1vNj7.cjs';
+export { E as EncodedCall, U as UserOpEvent, e as encodeKernelExecute, n as normalizeCalls, u as userOpEventFromReceipt, a as userOpEventsFromReceipt } from './calls-BRPjKgjl.cjs';
+export { C as Call, S as SponsoredResult } from './types-BilBTDqK.cjs';
+import './chains-DK13zGIp.cjs';
+
+/** EntryPoint v0.7, the only version PEPU's bundler and paymaster speak. */
+declare const ENTRY_POINT_V07: {
+    readonly address: "0x0000000071727De22E5E9d8BAf0edAc6f37da032";
+    readonly version: "0.7";
+};
+/**
+ * The Alto-compatible fee estimator: the chain's own `estimateFeesPerGas`,
+ * with `maxFeePerGas` x 1.2. Alto does not implement ZeroDev's
+ * `zd_getUserOperationGasPrice`, so the default estimator would fail.
+ * Ported from `templates/sponsored-session-app/lib/kernel.ts`.
+ *
+ * @example
+ * const fees = await estimatePepuUserOpFees(publicClient);
+ */
+declare function estimatePepuUserOpFees(publicClient: Pick<PublicClient, "estimateFeesPerGas">): Promise<{
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+}>;
+/**
+ * An ERC-7677 paymaster client for PEPU (viem `createPaymasterClient`), using
+ * the endpoints registry for the URL. A `context` (for example
+ * `buildPaymasterContext({ privyAccessToken })`) is injected into every
+ * `pm_getPaymasterStubData` and `pm_getPaymasterData` call unless the caller
+ * passes one.
+ *
+ * @example
+ * const paymaster = createPepuPaymasterClient({
+ *   context: buildPaymasterContext({ privyAccessToken }),
+ * });
+ */
+declare function createPepuPaymasterClient(o?: {
+    paymasterUrl?: string;
+    paymasterToken?: string;
+    context?: PaymasterContext;
+}): PaymasterClient;
+/**
+ * A viem bundler client for PEPU's bundler, with the fee estimator
+ * pre-wired ({@link estimatePepuUserOpFees}).
+ *
+ * @example
+ * const bundler = createPepuBundlerClient({ account, paymaster: createPepuPaymasterClient() });
+ * const hash = await bundler.sendUserOperation({ calls: [{ to, data }] });
+ */
+declare function createPepuBundlerClient(o: {
+    bundlerUrl?: string;
+    account: SmartAccount;
+    paymaster?: PaymasterClient;
+    paymasterContext?: PaymasterContext;
+    publicClient?: PublicClient;
+}): BundlerClient;
+
+/**
+ * Remove anything credential-shaped from text that may reach a message:
+ * `/paymaster/<token>` URL paths, bearer tokens, API keys, JWTs and URL
+ * credentials.
+ *
+ * @example
+ * redactSecrets("POST https://pm.example/paymaster/sk_live_123 failed");
+ * // "POST https://pm.example/paymaster/[redacted] failed"
+ */
+declare function redactSecrets(text: string): string;
+/**
+ * Turn anything thrown by the bundler, paymaster or viem/Privy stack into a
+ * typed PepuError. Walks the `cause` chain (viem's `details` is where the
+ * paymaster's real denial reason lives; Privy's own log prints
+ * `[object Error]`), maps `AA10`..`AA9x` to a fix, maps paymaster reason codes
+ * through the error catalog, and redacts tokens and URL credentials.
+ * Port of `templates/sponsored-demo/lib/describe-error.ts`.
+ *
+ * @example
+ * try { await sendSponsored({ client, calls }); }
+ * catch (e) { const err = describeUserOpFailure(e); console.log(err.code, err.hint); }
+ */
+declare function describeUserOpFailure(e: unknown): PepuBundlerError | PepuPaymasterError;
+
+export { ENTRY_POINT_V07, createPepuBundlerClient, createPepuPaymasterClient, describeUserOpFailure, estimatePepuUserOpFees, redactSecrets };