@pepu-chain/sdk 0.0.0-stage → 0.2.1

package/dist/privy/wagmi.d.ts

@@ -0,0 +1,90 @@
+import { QueryClient } from '@tanstack/react-query';
+import { Config } from 'wagmi';
+import { P as PepuChain } from '../chains-DK13zGIp.js';
+import { PepuPrivyProviderProps, PepuPrivyProvider } from './react.js';
+import 'viem';
+import 'react';
+import '@privy-io/react-auth';
+import '../errors-CgX1vNj7.js';
+import '../config-COjhIZTh.js';
+
+/**
+ * `@pepu-chain/sdk/privy/wagmi` (browser). wagmi config for PEPU, a combined
+ * Privy + react-query + wagmi provider, and the active-wallet pin.
+ *
+ * `react` is never imported here directly (the boundary test only allows it in
+ * `react.ts` files): React-level glue lives in `./react.ts` and is reused.
+ *
+ * Optional peers of this entry only: `wagmi`, `@privy-io/wagmi`,
+ * `@tanstack/react-query`.
+ */
+/**
+ * Default policy: keep the user's Privy embedded wallet pinned as wagmi's active
+ * account whenever one exists. Pass `{ enabled: false }` to `useActiveWalletPin`
+ * (or `pinEmbeddedWallet={false}` to the provider) to opt out, for example for
+ * an app that is deliberately external-wallet-first.
+ *
+ * Ported from templates/consumer-app/lib/wallet.ts.
+ */
+declare const EMBEDDED_WALLET_IS_ACTIVE_BY_DEFAULT = true;
+/**
+ * A wagmi config for PEPU, built with `@privy-io/wagmi`'s `createConfig` (plain
+ * wagmi's is a documented footgun with Privy: embedded wallets would not appear
+ * as a connector). The chain carries `contracts.multicall3` at PEPU's own
+ * address, so batched reads work.
+ *
+ * Ported from templates/consumer-app/lib/wagmi-config.ts.
+ *
+ * @example
+ * ```ts
+ * const wagmiConfig = pepuWagmiConfig();
+ * const custom = pepuWagmiConfig({ rpcUrl: "https://my-rpc.example.com" });
+ * ```
+ */
+declare function pepuWagmiConfig(o?: {
+    chain?: PepuChain;
+    rpcUrl?: string;
+}): Config;
+/**
+ * Keeps wagmi's active account (what `useAccount`, `useBalance` and
+ * `useSendTransaction` act on) pinned to the user's Privy embedded wallet.
+ * Without it an installed extension such as Phantom can silently become the
+ * active account. It only calls `setActiveWallet` when the active address
+ * differs from the embedded wallet's, so it cannot loop; a user with no
+ * embedded wallet is left alone. Call it once near the root, inside the wagmi
+ * provider (`PepuPrivyWagmiProvider` already does).
+ *
+ * Ported from templates/consumer-app/lib/wallet.ts (`useActiveWalletSync`).
+ *
+ * @example
+ * ```tsx
+ * function Pin() { useActiveWalletPin(); return null; }
+ * ```
+ */
+declare function useActiveWalletPin(o?: {
+    enabled?: boolean;
+}): void;
+type PepuPrivyWagmiProviderProps = Omit<PepuPrivyProviderProps, "wrapper"> & {
+    wagmiConfig?: Config | undefined;
+    queryClient?: QueryClient | undefined;
+    /** Default {@link EMBEDDED_WALLET_IS_ACTIVE_BY_DEFAULT}. */
+    pinEmbeddedWallet?: boolean | undefined;
+};
+/**
+ * `PepuPrivyProvider` + react-query + `@privy-io/wagmi`'s `WagmiProvider`, in
+ * the order Privy requires, with the active-wallet pin mounted. Defaults to
+ * {@link pepuWagmiConfig} and a shared `QueryClient` (a fresh one per render on
+ * the server, so requests never share a cache).
+ *
+ * Ported from templates/consumer-app/app/providers.tsx.
+ *
+ * @example
+ * ```tsx
+ * <PepuPrivyWagmiProvider appId={process.env.NEXT_PUBLIC_PRIVY_APP_ID}>
+ *   <App />
+ * </PepuPrivyWagmiProvider>
+ * ```
+ */
+declare function PepuPrivyWagmiProvider(p: PepuPrivyWagmiProviderProps): ReturnType<typeof PepuPrivyProvider>;
+
+export { EMBEDDED_WALLET_IS_ACTIVE_BY_DEFAULT, PepuPrivyWagmiProvider, type PepuPrivyWagmiProviderProps, pepuWagmiConfig, useActiveWalletPin };

package/dist/privy/wagmi.guard.js

@@ -0,0 +1,15 @@
+// Generated by scripts/guard-peers.mjs. Used only under the "node" export condition.
+const peers = ["react","@privy-io/react-auth","@privy-io/wagmi","wagmi","@tanstack/react-query"];
+for (const peer of peers) {
+  try {
+    import.meta.resolve?.(peer);
+  } catch (e) {
+    if (e && e.code === "ERR_MODULE_NOT_FOUND") {
+      const err = new Error("@pepu-chain/sdk/privy/wagmi needs peer packages that are not installed: react @privy-io/react-auth @privy-io/wagmi wagmi @tanstack/react-query. Install with: npm i react @privy-io/react-auth @privy-io/wagmi wagmi @tanstack/react-query  (or let create-pepu-app scaffold everything).");
+      err.code = "PEPU_MISSING_PEER";
+      throw err;
+    }
+  }
+}
+const mod = await import("./wagmi.js");
+export const { EMBEDDED_WALLET_IS_ACTIVE_BY_DEFAULT, PepuPrivyWagmiProvider, pepuWagmiConfig, useActiveWalletPin } = mod;

package/dist/privy/wagmi.js

@@ -0,0 +1,55 @@
+import { usePinEmbeddedWallet, PepuPrivyProvider, composeProviders } from '../chunk-EHBPIYY4.js';
+import '../chunk-JLZ4LZ4Z.js';
+import { pepuMainnet } from '../chunk-VTQIHMF3.js';
+import '../chunk-3XUGQODR.js';
+import '../chunk-6DSZ4Z2N.js';
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { createConfig, useSetActiveWallet, WagmiProvider } from '@privy-io/wagmi';
+import { http, useAccount } from 'wagmi';
+
+var EMBEDDED_WALLET_IS_ACTIVE_BY_DEFAULT = true;
+function pepuWagmiConfig(o = {}) {
+  const chain = o.chain ?? pepuMainnet;
+  return createConfig({
+    chains: [chain],
+    transports: { [chain.id]: http(o.rpcUrl) }
+  });
+}
+function useActiveWalletPin(o = {}) {
+  const { enabled = EMBEDDED_WALLET_IS_ACTIVE_BY_DEFAULT } = o;
+  const { address } = useAccount();
+  const { setActiveWallet } = useSetActiveWallet();
+  usePinEmbeddedWallet({ enabled, activeAddress: address, setActiveWallet });
+}
+function ActiveWalletPinLeaf() {
+  useActiveWalletPin();
+  return null;
+}
+var wrapperCache = /* @__PURE__ */ new WeakMap();
+function wrapperFor(config, client, pin) {
+  let byClient = wrapperCache.get(config);
+  if (!byClient) wrapperCache.set(config, byClient = /* @__PURE__ */ new WeakMap());
+  let slot = byClient.get(client);
+  if (!slot) byClient.set(client, slot = {});
+  const key = pin ? "pin" : "nopin";
+  return slot[key] ??= composeProviders(
+    [
+      [QueryClientProvider, { client }],
+      [WagmiProvider, { config }]
+    ],
+    pin ? [ActiveWalletPinLeaf] : []
+  );
+}
+var defaultConfig;
+var defaultClient;
+function PepuPrivyWagmiProvider(p) {
+  const { wagmiConfig, queryClient, pinEmbeddedWallet, ...rest } = p;
+  const config = wagmiConfig ?? (defaultConfig ??= pepuWagmiConfig());
+  const client = queryClient ?? (globalThis.window === void 0 ? new QueryClient() : defaultClient ??= new QueryClient());
+  const wrapper = wrapperFor(config, client, pinEmbeddedWallet ?? EMBEDDED_WALLET_IS_ACTIVE_BY_DEFAULT);
+  return PepuPrivyProvider({ ...rest, wrapper });
+}
+
+export { EMBEDDED_WALLET_IS_ACTIVE_BY_DEFAULT, PepuPrivyWagmiProvider, pepuWagmiConfig, useActiveWalletPin };
+//# sourceMappingURL=wagmi.js.map
+//# sourceMappingURL=wagmi.js.map

package/dist/privy/wagmi.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/privy/wagmi.ts"],"names":[],"mappings":";;;;;;;;;AA4BO,IAAM,oCAAA,GAAuC;AAgB7C,SAAS,eAAA,CAAgB,CAAA,GAA4C,EAAC,EAAW;AACtF,EAAA,MAAM,KAAA,GAAQ,EAAE,KAAA,IAAS,WAAA;AACzB,EAAA,OAAO,YAAA,CAAa;AAAA,IAClB,MAAA,EAAQ,CAAC,KAAK,CAAA;AAAA,IACd,UAAA,EAAY,EAAE,CAAC,KAAA,CAAM,EAAE,GAAG,IAAA,CAAK,CAAA,CAAE,MAAM,CAAA;AAAE,GACJ,CAAA;AACzC;AAkBO,SAAS,kBAAA,CAAmB,CAAA,GAA2B,EAAC,EAAS;AACtE,EAAA,MAAM,EAAE,OAAA,GAAU,oCAAA,EAAqC,GAAI,CAAA;AAC3D,EAAA,MAAM,EAAE,OAAA,EAAQ,GAAI,UAAA,EAAW;AAC/B,EAAA,MAAM,EAAE,eAAA,EAAgB,GAAI,kBAAA,EAAmB;AAC/C,EAAA,oBAAA,CAAqB,EAAE,OAAA,EAAS,aAAA,EAAe,OAAA,EAAS,iBAAiB,CAAA;AAC3E;AAEA,SAAS,mBAAA,GAA4B;AACnC,EAAA,kBAAA,EAAmB;AACnB,EAAA,OAAO,IAAA;AACT;AAaA,IAAM,YAAA,uBAAmB,OAAA,EAAiF;AAE1G,SAAS,UAAA,CAAW,MAAA,EAAgB,MAAA,EAAqB,GAAA,EAAuB;AAC9E,EAAA,IAAI,QAAA,GAAW,YAAA,CAAa,GAAA,CAAI,MAAM,CAAA;AACtC,EAAA,IAAI,CAAC,UAAU,YAAA,CAAa,GAAA,CAAI,QAAS,QAAA,mBAAW,IAAI,SAAU,CAAA;AAClE,EAAA,IAAI,IAAA,GAAO,QAAA,CAAS,GAAA,CAAI,MAAM,CAAA;AAC9B,EAAA,IAAI,CAAC,IAAA,EAAM,QAAA,CAAS,IAAI,MAAA,EAAS,IAAA,GAAO,EAAG,CAAA;AAC3C,EAAA,MAAM,GAAA,GAAM,MAAM,KAAA,GAAQ,OAAA;AAC1B,EAAA,OAAQ,IAAA,CAAK,GAAG,CAAA,KAAM,gBAAA;AAAA,IACpB;AAAA,MACE,CAAC,mBAAA,EAAqB,EAAE,MAAA,EAAQ,CAAA;AAAA,MAChC,CAAC,aAAA,EAAe,EAAE,MAAA,EAAQ;AAAA,KAC5B;AAAA,IACA,GAAA,GAAM,CAAC,mBAA2B,CAAA,GAAI;AAAC,GACzC;AACF;AAEA,IAAI,aAAA;AACJ,IAAI,aAAA;AAiBG,SAAS,uBAAuB,CAAA,EAAsE;AAC3G,EAAA,MAAM,EAAE,WAAA,EAAa,WAAA,EAAa,iBAAA,EAAmB,GAAG,MAAK,GAAI,CAAA;AACjE,EAAA,MAAM,MAAA,GAAS,WAAA,KAAgB,aAAA,KAAkB,eAAA,EAAgB,CAAA;AACjE,EAAA,MAAM,MAAA,GACJ,WAAA,KACE,UAAA,CAAoC,MAAA,KAAW,MAAA,GAAY,IAAI,WAAA,EAAY,GAAK,aAAA,KAAkB,IAAI,WAAA,EAAY,CAAA;AACtH,EAAA,MAAM,OAAA,GAAU,UAAA,CAAW,MAAA,EAAQ,MAAA,EAAQ,qBAAqB,oCAAoC,CAAA;AAGpG,EAAA,OAAO,iBAAA,CAAkB,EAAE,GAAG,IAAA,EAAM,SAAS,CAAA;AAC/C","file":"wagmi.js","sourcesContent":["import { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport { createConfig, WagmiProvider, useSetActiveWallet } from \"@privy-io/wagmi\";\nimport { http, useAccount } from \"wagmi\";\nimport type { Config } from \"wagmi\";\nimport { pepuMainnet } from \"../chains.js\";\nimport type { PepuChain } from \"../chains.js\";\nimport { composeProviders, PepuPrivyProvider, usePinEmbeddedWallet } from \"./react.js\";\nimport type { PepuPrivyProviderProps } from \"./react.js\";\n\n/**\n * `@pepu-chain/sdk/privy/wagmi` (browser). wagmi config for PEPU, a combined\n * Privy + react-query + wagmi provider, and the active-wallet pin.\n *\n * `react` is never imported here directly (the boundary test only allows it in\n * `react.ts` files): React-level glue lives in `./react.ts` and is reused.\n *\n * Optional peers of this entry only: `wagmi`, `@privy-io/wagmi`,\n * `@tanstack/react-query`.\n */\n\n/**\n * Default policy: keep the user's Privy embedded wallet pinned as wagmi's active\n * account whenever one exists. Pass `{ enabled: false }` to `useActiveWalletPin`\n * (or `pinEmbeddedWallet={false}` to the provider) to opt out, for example for\n * an app that is deliberately external-wallet-first.\n *\n * Ported from templates/consumer-app/lib/wallet.ts.\n */\nexport const EMBEDDED_WALLET_IS_ACTIVE_BY_DEFAULT = true;\n\n/**\n * A wagmi config for PEPU, built with `@privy-io/wagmi`'s `createConfig` (plain\n * wagmi's is a documented footgun with Privy: embedded wallets would not appear\n * as a connector). The chain carries `contracts.multicall3` at PEPU's own\n * address, so batched reads work.\n *\n * Ported from templates/consumer-app/lib/wagmi-config.ts.\n *\n * @example\n * ```ts\n * const wagmiConfig = pepuWagmiConfig();\n * const custom = pepuWagmiConfig({ rpcUrl: \"https://my-rpc.example.com\" });\n * ```\n */\nexport function pepuWagmiConfig(o: { chain?: PepuChain; rpcUrl?: string } = {}): Config {\n  const chain = o.chain ?? pepuMainnet;\n  return createConfig({\n    chains: [chain],\n    transports: { [chain.id]: http(o.rpcUrl) },\n  } as Parameters<typeof createConfig>[0]) as unknown as Config;\n}\n\n/**\n * Keeps wagmi's active account (what `useAccount`, `useBalance` and\n * `useSendTransaction` act on) pinned to the user's Privy embedded wallet.\n * Without it an installed extension such as Phantom can silently become the\n * active account. It only calls `setActiveWallet` when the active address\n * differs from the embedded wallet's, so it cannot loop; a user with no\n * embedded wallet is left alone. Call it once near the root, inside the wagmi\n * provider (`PepuPrivyWagmiProvider` already does).\n *\n * Ported from templates/consumer-app/lib/wallet.ts (`useActiveWalletSync`).\n *\n * @example\n * ```tsx\n * function Pin() { useActiveWalletPin(); return null; }\n * ```\n */\nexport function useActiveWalletPin(o: { enabled?: boolean } = {}): void {\n  const { enabled = EMBEDDED_WALLET_IS_ACTIVE_BY_DEFAULT } = o;\n  const { address } = useAccount();\n  const { setActiveWallet } = useSetActiveWallet();\n  usePinEmbeddedWallet({ enabled, activeAddress: address, setActiveWallet });\n}\n\nfunction ActiveWalletPinLeaf(): null {\n  useActiveWalletPin();\n  return null;\n}\n\nexport type PepuPrivyWagmiProviderProps = Omit<PepuPrivyProviderProps, \"wrapper\"> & {\n  wagmiConfig?: Config | undefined;\n  queryClient?: QueryClient | undefined;\n  /** Default {@link EMBEDDED_WALLET_IS_ACTIVE_BY_DEFAULT}. */\n  pinEmbeddedWallet?: boolean | undefined;\n};\n\ntype Wrapper = NonNullable<PepuPrivyProviderProps[\"wrapper\"]>;\ntype Leaf = NonNullable<Parameters<typeof composeProviders>[1]>[number];\n// A wrapper must keep one component identity per (config, client, pin), or\n// React would remount the whole tree on every render.\nconst wrapperCache = new WeakMap<Config, WeakMap<QueryClient, Partial<Record<\"pin\" | \"nopin\", Wrapper>>>>();\n\nfunction wrapperFor(config: Config, client: QueryClient, pin: boolean): Wrapper {\n  let byClient = wrapperCache.get(config);\n  if (!byClient) wrapperCache.set(config, (byClient = new WeakMap()));\n  let slot = byClient.get(client);\n  if (!slot) byClient.set(client, (slot = {}));\n  const key = pin ? \"pin\" : \"nopin\";\n  return (slot[key] ??= composeProviders(\n    [\n      [QueryClientProvider, { client }],\n      [WagmiProvider, { config }],\n    ],\n    pin ? [ActiveWalletPinLeaf as Leaf] : [],\n  ));\n}\n\nlet defaultConfig: Config | undefined;\nlet defaultClient: QueryClient | undefined;\n\n/**\n * `PepuPrivyProvider` + react-query + `@privy-io/wagmi`'s `WagmiProvider`, in\n * the order Privy requires, with the active-wallet pin mounted. Defaults to\n * {@link pepuWagmiConfig} and a shared `QueryClient` (a fresh one per render on\n * the server, so requests never share a cache).\n *\n * Ported from templates/consumer-app/app/providers.tsx.\n *\n * @example\n * ```tsx\n * <PepuPrivyWagmiProvider appId={process.env.NEXT_PUBLIC_PRIVY_APP_ID}>\n *   <App />\n * </PepuPrivyWagmiProvider>\n * ```\n */\nexport function PepuPrivyWagmiProvider(p: PepuPrivyWagmiProviderProps): ReturnType<typeof PepuPrivyProvider> {\n  const { wagmiConfig, queryClient, pinEmbeddedWallet, ...rest } = p;\n  const config = wagmiConfig ?? (defaultConfig ??= pepuWagmiConfig());\n  const client =\n    queryClient ??\n    ((globalThis as { window?: unknown }).window === undefined ? new QueryClient() : (defaultClient ??= new QueryClient()));\n  const wrapper = wrapperFor(config, client, pinEmbeddedWallet ?? EMBEDDED_WALLET_IS_ACTIVE_BY_DEFAULT);\n  // PepuPrivyProvider is a hook-free function component, so calling it returns\n  // its element without needing `createElement` (and so without importing react).\n  return PepuPrivyProvider({ ...rest, wrapper });\n}\n"]}

package/dist/privy.cjs

@@ -0,0 +1,34 @@
+'use strict';
+
+var chunkNE3QKDOB_cjs = require('./chunk-NE3QKDOB.cjs');
+require('./chunk-DPCZJLB3.cjs');
+var chunkC2XW44FI_cjs = require('./chunk-C2XW44FI.cjs');
+
+
+
+Object.defineProperty(exports, "createPepuPrivyConfig", {
+  enumerable: true,
+  get: function () { return chunkNE3QKDOB_cjs.createPepuPrivyConfig; }
+});
+Object.defineProperty(exports, "PEPU_PRIVY_REQUIREMENTS", {
+  enumerable: true,
+  get: function () { return chunkC2XW44FI_cjs.PEPU_PRIVY_REQUIREMENTS; }
+});
+Object.defineProperty(exports, "PRIVY_ENV", {
+  enumerable: true,
+  get: function () { return chunkC2XW44FI_cjs.PRIVY_ENV; }
+});
+Object.defineProperty(exports, "PRIVY_ENV_ALIASES", {
+  enumerable: true,
+  get: function () { return chunkC2XW44FI_cjs.PRIVY_ENV_ALIASES; }
+});
+Object.defineProperty(exports, "checkPrivyDashboardConfig", {
+  enumerable: true,
+  get: function () { return chunkC2XW44FI_cjs.checkPrivyDashboardConfig; }
+});
+Object.defineProperty(exports, "privyDashboardChecker", {
+  enumerable: true,
+  get: function () { return chunkC2XW44FI_cjs.privyDashboardChecker; }
+});
+//# sourceMappingURL=privy.cjs.map
+//# sourceMappingURL=privy.cjs.map

package/dist/privy.cjs.map

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

package/dist/privy.d.cts

@@ -0,0 +1,4 @@
+export { C as CreatePepuPrivyConfigOptions, E as EmbeddedWalletCreateOnLogin, P as PepuPrivyClientConfig, a as PrivyLoginMethod, c as createPepuPrivyConfig } from './config-CHjz7ZjZ.cjs';
+export { P as PEPU_PRIVY_REQUIREMENTS, a as PRIVY_ENV, b as PRIVY_ENV_ALIASES, c as PrivyDashboardCheckItem, d as PrivyDoctorCheck, e as PrivyPublicAppConfig, f as PrivyRequirement, g as PrivyRequirementResult, h as checkPrivyDashboardConfig, p as privyDashboardChecker } from './requirements-C-QiJkL9.cjs';
+import './chains-DK13zGIp.cjs';
+import 'viem';

package/dist/privy.d.ts

@@ -0,0 +1,4 @@
+export { C as CreatePepuPrivyConfigOptions, E as EmbeddedWalletCreateOnLogin, P as PepuPrivyClientConfig, a as PrivyLoginMethod, c as createPepuPrivyConfig } from './config-COjhIZTh.js';
+export { P as PEPU_PRIVY_REQUIREMENTS, a as PRIVY_ENV, b as PRIVY_ENV_ALIASES, c as PrivyDashboardCheckItem, d as PrivyDoctorCheck, e as PrivyPublicAppConfig, f as PrivyRequirement, g as PrivyRequirementResult, h as checkPrivyDashboardConfig, p as privyDashboardChecker } from './requirements-C-QiJkL9.js';
+import './chains-DK13zGIp.js';
+import 'viem';

package/dist/privy.js

@@ -0,0 +1,5 @@
+export { createPepuPrivyConfig } from './chunk-JLZ4LZ4Z.js';
+import './chunk-VTQIHMF3.js';
+export { PEPU_PRIVY_REQUIREMENTS, PRIVY_ENV, PRIVY_ENV_ALIASES, checkPrivyDashboardConfig, privyDashboardChecker } from './chunk-3XUGQODR.js';
+//# sourceMappingURL=privy.js.map
+//# sourceMappingURL=privy.js.map

package/dist/privy.js.map

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

package/dist/react.cjs

@@ -0,0 +1,73 @@
+'use strict';
+/* @pepu-chain/peer-guard */(function(){var p=["react"];for(var i=0;i<p.length;i++){try{require.resolve(p[i])}catch(e){if(e&&e.code==="MODULE_NOT_FOUND"){var m="@pepu-chain/sdk/react needs a peer package that is not installed: react. Install with: npm i react  (or let create-pepu-app scaffold everything).";var x=new Error(m);x.code="PEPU_MISSING_PEER";throw x}}}})();
+
+var chunkBGALSKAF_cjs = require('./chunk-BGALSKAF.cjs');
+require('./chunk-WANILJZQ.cjs');
+require('./chunk-K7JSQPZO.cjs');
+require('./chunk-VF3D6KLQ.cjs');
+var chunkDPCZJLB3_cjs = require('./chunk-DPCZJLB3.cjs');
+require('./chunk-YQL7NISX.cjs');
+var react = require('react');
+var viem = require('viem');
+
+function usePepuBalance(client, options) {
+  const { address, token, pollingInterval } = options;
+  const [data, setData] = react.useState(void 0);
+  const [error, setError] = react.useState(void 0);
+  const [isLoading, setIsLoading] = react.useState(false);
+  const fetchBalance = react.useCallback(async () => {
+    if (!address) {
+      setData(void 0);
+      setError(void 0);
+      return;
+    }
+    setIsLoading(true);
+    try {
+      const balance = token ? await client.readContract({
+        address: token,
+        abi: viem.erc20Abi,
+        functionName: "balanceOf",
+        args: [address]
+      }) : await client.getBalance({ address });
+      setData(balance);
+      setError(void 0);
+    } catch (caught) {
+      setError(caught instanceof Error ? caught : new Error(String(caught)));
+    } finally {
+      setIsLoading(false);
+    }
+  }, [client, address, token]);
+  react.useEffect(() => {
+    void fetchBalance();
+    if (!pollingInterval) {
+      return;
+    }
+    const id = setInterval(() => {
+      void fetchBalance();
+    }, pollingInterval);
+    return () => clearInterval(id);
+  }, [fetchBalance, pollingInterval]);
+  const refetch = react.useCallback(() => {
+    void fetchBalance();
+  }, [fetchBalance]);
+  return { data, isLoading, error, refetch };
+}
+function usePepuChain(chainId) {
+  return react.useMemo(() => {
+    const chain = chunkDPCZJLB3_cjs.pepuChains.find((candidate) => candidate.id === chainId);
+    return { chain, isPepuChain: chain !== void 0 };
+  }, [chainId]);
+}
+function useSponsorshipStatus(options) {
+  const bundlerUrl = options?.bundlerUrl;
+  return react.useMemo(
+    () => chunkBGALSKAF_cjs.getSponsorshipStatus(bundlerUrl === void 0 ? void 0 : { bundlerUrl }),
+    [bundlerUrl]
+  );
+}
+
+exports.usePepuBalance = usePepuBalance;
+exports.usePepuChain = usePepuChain;
+exports.useSponsorshipStatus = useSponsorshipStatus;
+//# sourceMappingURL=react.cjs.map
+//# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/usePepuBalance.ts","../src/react/usePepuChain.ts","../src/react/useSponsorshipStatus.ts"],"names":["useState","useCallback","erc20Abi","useEffect","useMemo","pepuChains","getSponsorshipStatus"],"mappings":";;;;;;;;;;;AAoCO,SAAS,cAAA,CACd,QACA,OAAA,EACsB;AACtB,EAAA,MAAM,EAAE,OAAA,EAAS,KAAA,EAAO,eAAA,EAAgB,GAAI,OAAA;AAC5C,EAAA,MAAM,CAAC,IAAA,EAAM,OAAO,CAAA,GAAIA,eAA6B,MAAS,CAAA;AAC9D,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,eAA4B,MAAS,CAAA;AAC/D,EAAA,MAAM,CAAC,SAAA,EAAW,YAAY,CAAA,GAAIA,eAAS,KAAK,CAAA;AAEhD,EAAA,MAAM,YAAA,GAAeC,kBAAY,YAAY;AAC3C,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA,OAAA,CAAQ,MAAS,CAAA;AACjB,MAAA,QAAA,CAAS,MAAS,CAAA;AAClB,MAAA;AAAA,IACF;AACA,IAAA,YAAA,CAAa,IAAI,CAAA;AACjB,IAAA,IAAI;AACF,MAAA,MAAM,OAAA,GAAU,KAAA,GACZ,MAAM,MAAA,CAAO,YAAA,CAAa;AAAA,QACxB,OAAA,EAAS,KAAA;AAAA,QACT,GAAA,EAAKC,aAAA;AAAA,QACL,YAAA,EAAc,WAAA;AAAA,QACd,IAAA,EAAM,CAAC,OAAO;AAAA,OACf,CAAA,GACD,MAAM,OAAO,UAAA,CAAW,EAAE,SAAS,CAAA;AACvC,MAAA,OAAA,CAAQ,OAAO,CAAA;AACf,MAAA,QAAA,CAAS,KAAA,CAAS,CAAA;AAAA,IACpB,SAAS,MAAA,EAAQ;AACf,MAAA,QAAA,CAAS,MAAA,YAAkB,QAAQ,MAAA,GAAS,IAAI,MAAM,MAAA,CAAO,MAAM,CAAC,CAAC,CAAA;AAAA,IACvE,CAAA,SAAE;AACA,MAAA,YAAA,CAAa,KAAK,CAAA;AAAA,IACpB;AAAA,EACF,CAAA,EAAG,CAAC,MAAA,EAAQ,OAAA,EAAS,KAAK,CAAC,CAAA;AAE3B,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,KAAK,YAAA,EAAa;AAClB,IAAA,IAAI,CAAC,eAAA,EAAiB;AACpB,MAAA;AAAA,IACF;AACA,IAAA,MAAM,EAAA,GAAK,YAAY,MAAM;AAC3B,MAAA,KAAK,YAAA,EAAa;AAAA,IACpB,GAAG,eAAe,CAAA;AAClB,IAAA,OAAO,MAAM,cAAc,EAAE,CAAA;AAAA,EAC/B,CAAA,EAAG,CAAC,YAAA,EAAc,eAAe,CAAC,CAAA;AAElC,EAAA,MAAM,OAAA,GAAUF,kBAAY,MAAM;AAChC,IAAA,KAAK,YAAA,EAAa;AAAA,EACpB,CAAA,EAAG,CAAC,YAAY,CAAC,CAAA;AAEjB,EAAA,OAAO,EAAE,IAAA,EAAM,SAAA,EAAW,KAAA,EAAO,OAAA,EAAQ;AAC3C;ACnEO,SAAS,aAAa,OAAA,EAAiD;AAC5E,EAAA,OAAOG,cAAQ,MAAM;AACnB,IAAA,MAAM,QAAQC,4BAAA,CAAW,IAAA,CAAK,CAAC,SAAA,KAAc,SAAA,CAAU,OAAO,OAAO,CAAA;AACrE,IAAA,OAAO,EAAE,KAAA,EAAO,WAAA,EAAa,KAAA,KAAU,MAAA,EAAU;AAAA,EACnD,CAAA,EAAG,CAAC,OAAO,CAAC,CAAA;AACd;ACNO,SAAS,qBACd,OAAA,EACmB;AACnB,EAAA,MAAM,aAAa,OAAA,EAAS,UAAA;AAC5B,EAAA,OAAOD,aAAAA;AAAA,IACL,MAAME,sCAAA,CAAqB,UAAA,KAAe,SAAY,MAAA,GAAY,EAAE,YAAY,CAAA;AAAA,IAChF,CAAC,UAAU;AAAA,GACb;AACF","file":"react.cjs","sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\nimport { erc20Abi } from \"viem\";\nimport type { Address, PublicClient, Transport } from \"viem\";\n\nimport type { PepuChain } from \"../chains.js\";\n\n/** Options for {@link usePepuBalance}. */\nexport interface UsePepuBalanceOptions {\n  /** Address to read a balance for. The hook holds `data` at `undefined` while this is `undefined`. */\n  readonly address: Address | undefined;\n  /** ERC-20 token address to read `balanceOf` for. Omit for the native PEPU balance (`client.getBalance`). */\n  readonly token?: Address;\n  /** Re-fetch on an interval, in milliseconds. Omit (or `0`) to fetch once. */\n  readonly pollingInterval?: number;\n}\n\n/** Result of {@link usePepuBalance}. */\nexport interface UsePepuBalanceResult {\n  /** The balance in the smallest unit (wei for native PEPU, the token's own base unit for an ERC-20), or `undefined` before the first successful fetch. */\n  readonly data: bigint | undefined;\n  readonly isLoading: boolean;\n  readonly error: Error | undefined;\n  /** Re-run the fetch immediately, outside the polling interval. */\n  readonly refetch: () => void;\n}\n\n/**\n * Read (and optionally poll) an address's native PEPU balance, or an\n * ERC-20 token balance on a PEPU chain, given a viem `PublicClient`.\n *\n * Deliberately takes the client as a parameter rather than reaching for one\n * itself (e.g. via a context provider this package would have to define\n * and ship) — this keeps the hook usable with whatever client the host app\n * already has (its own `getPublicClient` call, wagmi's `usePublicClient()`,\n * etc.) instead of introducing a second, competing way to obtain one.\n */\nexport function usePepuBalance(\n  client: PublicClient<Transport, PepuChain>,\n  options: UsePepuBalanceOptions,\n): UsePepuBalanceResult {\n  const { address, token, pollingInterval } = options;\n  const [data, setData] = useState<bigint | undefined>(undefined);\n  const [error, setError] = useState<Error | undefined>(undefined);\n  const [isLoading, setIsLoading] = useState(false);\n\n  const fetchBalance = useCallback(async () => {\n    if (!address) {\n      setData(undefined);\n      setError(undefined);\n      return;\n    }\n    setIsLoading(true);\n    try {\n      const balance = token\n        ? await client.readContract({\n            address: token,\n            abi: erc20Abi,\n            functionName: \"balanceOf\",\n            args: [address],\n          })\n        : await client.getBalance({ address });\n      setData(balance);\n      setError(undefined);\n    } catch (caught) {\n      setError(caught instanceof Error ? caught : new Error(String(caught)));\n    } finally {\n      setIsLoading(false);\n    }\n  }, [client, address, token]);\n\n  useEffect(() => {\n    void fetchBalance();\n    if (!pollingInterval) {\n      return;\n    }\n    const id = setInterval(() => {\n      void fetchBalance();\n    }, pollingInterval);\n    return () => clearInterval(id);\n  }, [fetchBalance, pollingInterval]);\n\n  const refetch = useCallback(() => {\n    void fetchBalance();\n  }, [fetchBalance]);\n\n  return { data, isLoading, error, refetch };\n}\n","import { useMemo } from \"react\";\n\nimport { pepuChains } from \"../chains.js\";\nimport type { PepuChain } from \"../chains.js\";\n\n/** Result of {@link usePepuChain}. */\nexport interface UsePepuChainResult {\n  /** The matching {@link PepuChain}, or `undefined` if `chainId` isn't one of PEPU's. */\n  readonly chain: PepuChain | undefined;\n  /** `true` iff `chainId` is one of PEPU's chain ids. Equivalent to `chain !== undefined`. */\n  readonly isPepuChain: boolean;\n}\n\n/**\n * Resolve a raw chain id (e.g. from wagmi's `useChainId()`, or an injected\n * wallet's `eth_chainId`) to its {@link PepuChain} definition, if it's one\n * of PEPU's. Pure lookup over {@link pepuChains} — makes no network call\n * and holds no state beyond memoizing the result.\n */\nexport function usePepuChain(chainId: number | undefined): UsePepuChainResult {\n  return useMemo(() => {\n    const chain = pepuChains.find((candidate) => candidate.id === chainId);\n    return { chain, isPepuChain: chain !== undefined };\n  }, [chainId]);\n}\n","import { useMemo } from \"react\";\n\nimport { getSponsorshipStatus } from \"../aa/status.js\";\nimport type { GetSponsorshipStatusOptions, SponsorshipStatus } from \"../aa/status.js\";\n\n/**\n * React wrapper around {@link getSponsorshipStatus} — reports whether PEPU\n * gas sponsorship is available. **Deprecated: always reports unavailable.**\n * The hosted bundler and paymaster service are live and sponsorship is proven\n * on mainnet, but the ERC-7677 URL embeds a project token, so availability can\n * only be answered by a live probe. Use `usePepuSponsorship()` from\n * `@pepu-chain/sdk/aa/react` (it wraps `checkSponsorship`) instead. This hook\n * stays so 0.1 callers keep compiling.\n */\n/**\n * @deprecated Always reports unavailable. Use `usePepuSponsorship()` from\n * `@pepu-chain/sdk/aa/react` (live probe). Kept for 0.1 callers.\n */\nexport function useSponsorshipStatus(\n  options?: GetSponsorshipStatusOptions,\n): SponsorshipStatus {\n  const bundlerUrl = options?.bundlerUrl;\n  return useMemo(\n    () => getSponsorshipStatus(bundlerUrl === undefined ? undefined : { bundlerUrl }),\n    [bundlerUrl],\n  );\n}\n"]}

package/dist/react.d.cts

@@ -0,0 +1,66 @@
+import { Address, PublicClient, Transport } from 'viem';
+import { P as PepuChain } from './chains-DK13zGIp.cjs';
+import { G as GetSponsorshipStatusOptions, c as SponsorshipStatus } from './status-wgTM26V7.cjs';
+import './errors-CgX1vNj7.cjs';
+
+/** Options for {@link usePepuBalance}. */
+interface UsePepuBalanceOptions {
+    /** Address to read a balance for. The hook holds `data` at `undefined` while this is `undefined`. */
+    readonly address: Address | undefined;
+    /** ERC-20 token address to read `balanceOf` for. Omit for the native PEPU balance (`client.getBalance`). */
+    readonly token?: Address;
+    /** Re-fetch on an interval, in milliseconds. Omit (or `0`) to fetch once. */
+    readonly pollingInterval?: number;
+}
+/** Result of {@link usePepuBalance}. */
+interface UsePepuBalanceResult {
+    /** The balance in the smallest unit (wei for native PEPU, the token's own base unit for an ERC-20), or `undefined` before the first successful fetch. */
+    readonly data: bigint | undefined;
+    readonly isLoading: boolean;
+    readonly error: Error | undefined;
+    /** Re-run the fetch immediately, outside the polling interval. */
+    readonly refetch: () => void;
+}
+/**
+ * Read (and optionally poll) an address's native PEPU balance, or an
+ * ERC-20 token balance on a PEPU chain, given a viem `PublicClient`.
+ *
+ * Deliberately takes the client as a parameter rather than reaching for one
+ * itself (e.g. via a context provider this package would have to define
+ * and ship) — this keeps the hook usable with whatever client the host app
+ * already has (its own `getPublicClient` call, wagmi's `usePublicClient()`,
+ * etc.) instead of introducing a second, competing way to obtain one.
+ */
+declare function usePepuBalance(client: PublicClient<Transport, PepuChain>, options: UsePepuBalanceOptions): UsePepuBalanceResult;
+
+/** Result of {@link usePepuChain}. */
+interface UsePepuChainResult {
+    /** The matching {@link PepuChain}, or `undefined` if `chainId` isn't one of PEPU's. */
+    readonly chain: PepuChain | undefined;
+    /** `true` iff `chainId` is one of PEPU's chain ids. Equivalent to `chain !== undefined`. */
+    readonly isPepuChain: boolean;
+}
+/**
+ * Resolve a raw chain id (e.g. from wagmi's `useChainId()`, or an injected
+ * wallet's `eth_chainId`) to its {@link PepuChain} definition, if it's one
+ * of PEPU's. Pure lookup over {@link pepuChains} — makes no network call
+ * and holds no state beyond memoizing the result.
+ */
+declare function usePepuChain(chainId: number | undefined): UsePepuChainResult;
+
+/**
+ * React wrapper around {@link getSponsorshipStatus} — reports whether PEPU
+ * gas sponsorship is available. **Deprecated: always reports unavailable.**
+ * The hosted bundler and paymaster service are live and sponsorship is proven
+ * on mainnet, but the ERC-7677 URL embeds a project token, so availability can
+ * only be answered by a live probe. Use `usePepuSponsorship()` from
+ * `@pepu-chain/sdk/aa/react` (it wraps `checkSponsorship`) instead. This hook
+ * stays so 0.1 callers keep compiling.
+ */
+/**
+ * @deprecated Always reports unavailable. Use `usePepuSponsorship()` from
+ * `@pepu-chain/sdk/aa/react` (live probe). Kept for 0.1 callers.
+ */
+declare function useSponsorshipStatus(options?: GetSponsorshipStatusOptions): SponsorshipStatus;
+
+export { type UsePepuBalanceOptions, type UsePepuBalanceResult, type UsePepuChainResult, usePepuBalance, usePepuChain, useSponsorshipStatus };

package/dist/react.d.ts

@@ -0,0 +1,66 @@
+import { Address, PublicClient, Transport } from 'viem';
+import { P as PepuChain } from './chains-DK13zGIp.js';
+import { G as GetSponsorshipStatusOptions, c as SponsorshipStatus } from './status-Dx9zAFo9.js';
+import './errors-CgX1vNj7.js';
+
+/** Options for {@link usePepuBalance}. */
+interface UsePepuBalanceOptions {
+    /** Address to read a balance for. The hook holds `data` at `undefined` while this is `undefined`. */
+    readonly address: Address | undefined;
+    /** ERC-20 token address to read `balanceOf` for. Omit for the native PEPU balance (`client.getBalance`). */
+    readonly token?: Address;
+    /** Re-fetch on an interval, in milliseconds. Omit (or `0`) to fetch once. */
+    readonly pollingInterval?: number;
+}
+/** Result of {@link usePepuBalance}. */
+interface UsePepuBalanceResult {
+    /** The balance in the smallest unit (wei for native PEPU, the token's own base unit for an ERC-20), or `undefined` before the first successful fetch. */
+    readonly data: bigint | undefined;
+    readonly isLoading: boolean;
+    readonly error: Error | undefined;
+    /** Re-run the fetch immediately, outside the polling interval. */
+    readonly refetch: () => void;
+}
+/**
+ * Read (and optionally poll) an address's native PEPU balance, or an
+ * ERC-20 token balance on a PEPU chain, given a viem `PublicClient`.
+ *
+ * Deliberately takes the client as a parameter rather than reaching for one
+ * itself (e.g. via a context provider this package would have to define
+ * and ship) — this keeps the hook usable with whatever client the host app
+ * already has (its own `getPublicClient` call, wagmi's `usePublicClient()`,
+ * etc.) instead of introducing a second, competing way to obtain one.
+ */
+declare function usePepuBalance(client: PublicClient<Transport, PepuChain>, options: UsePepuBalanceOptions): UsePepuBalanceResult;
+
+/** Result of {@link usePepuChain}. */
+interface UsePepuChainResult {
+    /** The matching {@link PepuChain}, or `undefined` if `chainId` isn't one of PEPU's. */
+    readonly chain: PepuChain | undefined;
+    /** `true` iff `chainId` is one of PEPU's chain ids. Equivalent to `chain !== undefined`. */
+    readonly isPepuChain: boolean;
+}
+/**
+ * Resolve a raw chain id (e.g. from wagmi's `useChainId()`, or an injected
+ * wallet's `eth_chainId`) to its {@link PepuChain} definition, if it's one
+ * of PEPU's. Pure lookup over {@link pepuChains} — makes no network call
+ * and holds no state beyond memoizing the result.
+ */
+declare function usePepuChain(chainId: number | undefined): UsePepuChainResult;
+
+/**
+ * React wrapper around {@link getSponsorshipStatus} — reports whether PEPU
+ * gas sponsorship is available. **Deprecated: always reports unavailable.**
+ * The hosted bundler and paymaster service are live and sponsorship is proven
+ * on mainnet, but the ERC-7677 URL embeds a project token, so availability can
+ * only be answered by a live probe. Use `usePepuSponsorship()` from
+ * `@pepu-chain/sdk/aa/react` (it wraps `checkSponsorship`) instead. This hook
+ * stays so 0.1 callers keep compiling.
+ */
+/**
+ * @deprecated Always reports unavailable. Use `usePepuSponsorship()` from
+ * `@pepu-chain/sdk/aa/react` (live probe). Kept for 0.1 callers.
+ */
+declare function useSponsorshipStatus(options?: GetSponsorshipStatusOptions): SponsorshipStatus;
+
+export { type UsePepuBalanceOptions, type UsePepuBalanceResult, type UsePepuChainResult, usePepuBalance, usePepuChain, useSponsorshipStatus };

package/dist/react.guard.js

@@ -0,0 +1,15 @@
+// Generated by scripts/guard-peers.mjs. Used only under the "node" export condition.
+const peers = ["react"];
+for (const peer of peers) {
+  try {
+    import.meta.resolve?.(peer);
+  } catch (e) {
+    if (e && e.code === "ERR_MODULE_NOT_FOUND") {
+      const err = new Error("@pepu-chain/sdk/react needs a peer package that is not installed: react. Install with: npm i react  (or let create-pepu-app scaffold everything).");
+      err.code = "PEPU_MISSING_PEER";
+      throw err;
+    }
+  }
+}
+const mod = await import("./react.js");
+export const { usePepuBalance, usePepuChain, useSponsorshipStatus } = mod;

package/dist/react.js

@@ -0,0 +1,68 @@
+import { getSponsorshipStatus } from './chunk-F2R473FR.js';
+import './chunk-D52PADVY.js';
+import './chunk-KJYNF5KH.js';
+import './chunk-XC4IBCI2.js';
+import { pepuChains } from './chunk-VTQIHMF3.js';
+import './chunk-6DSZ4Z2N.js';
+import { useState, useCallback, useEffect, useMemo } from 'react';
+import { erc20Abi } from 'viem';
+
+function usePepuBalance(client, options) {
+  const { address, token, pollingInterval } = options;
+  const [data, setData] = useState(void 0);
+  const [error, setError] = useState(void 0);
+  const [isLoading, setIsLoading] = useState(false);
+  const fetchBalance = useCallback(async () => {
+    if (!address) {
+      setData(void 0);
+      setError(void 0);
+      return;
+    }
+    setIsLoading(true);
+    try {
+      const balance = token ? await client.readContract({
+        address: token,
+        abi: erc20Abi,
+        functionName: "balanceOf",
+        args: [address]
+      }) : await client.getBalance({ address });
+      setData(balance);
+      setError(void 0);
+    } catch (caught) {
+      setError(caught instanceof Error ? caught : new Error(String(caught)));
+    } finally {
+      setIsLoading(false);
+    }
+  }, [client, address, token]);
+  useEffect(() => {
+    void fetchBalance();
+    if (!pollingInterval) {
+      return;
+    }
+    const id = setInterval(() => {
+      void fetchBalance();
+    }, pollingInterval);
+    return () => clearInterval(id);
+  }, [fetchBalance, pollingInterval]);
+  const refetch = useCallback(() => {
+    void fetchBalance();
+  }, [fetchBalance]);
+  return { data, isLoading, error, refetch };
+}
+function usePepuChain(chainId) {
+  return useMemo(() => {
+    const chain = pepuChains.find((candidate) => candidate.id === chainId);
+    return { chain, isPepuChain: chain !== void 0 };
+  }, [chainId]);
+}
+function useSponsorshipStatus(options) {
+  const bundlerUrl = options?.bundlerUrl;
+  return useMemo(
+    () => getSponsorshipStatus(bundlerUrl === void 0 ? void 0 : { bundlerUrl }),
+    [bundlerUrl]
+  );
+}
+
+export { usePepuBalance, usePepuChain, useSponsorshipStatus };
+//# sourceMappingURL=react.js.map
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/usePepuBalance.ts","../src/react/usePepuChain.ts","../src/react/useSponsorshipStatus.ts"],"names":["useMemo"],"mappings":";;;;;;;;;AAoCO,SAAS,cAAA,CACd,QACA,OAAA,EACsB;AACtB,EAAA,MAAM,EAAE,OAAA,EAAS,KAAA,EAAO,eAAA,EAAgB,GAAI,OAAA;AAC5C,EAAA,MAAM,CAAC,IAAA,EAAM,OAAO,CAAA,GAAI,SAA6B,MAAS,CAAA;AAC9D,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,SAA4B,MAAS,CAAA;AAC/D,EAAA,MAAM,CAAC,SAAA,EAAW,YAAY,CAAA,GAAI,SAAS,KAAK,CAAA;AAEhD,EAAA,MAAM,YAAA,GAAe,YAAY,YAAY;AAC3C,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA,OAAA,CAAQ,MAAS,CAAA;AACjB,MAAA,QAAA,CAAS,MAAS,CAAA;AAClB,MAAA;AAAA,IACF;AACA,IAAA,YAAA,CAAa,IAAI,CAAA;AACjB,IAAA,IAAI;AACF,MAAA,MAAM,OAAA,GAAU,KAAA,GACZ,MAAM,MAAA,CAAO,YAAA,CAAa;AAAA,QACxB,OAAA,EAAS,KAAA;AAAA,QACT,GAAA,EAAK,QAAA;AAAA,QACL,YAAA,EAAc,WAAA;AAAA,QACd,IAAA,EAAM,CAAC,OAAO;AAAA,OACf,CAAA,GACD,MAAM,OAAO,UAAA,CAAW,EAAE,SAAS,CAAA;AACvC,MAAA,OAAA,CAAQ,OAAO,CAAA;AACf,MAAA,QAAA,CAAS,KAAA,CAAS,CAAA;AAAA,IACpB,SAAS,MAAA,EAAQ;AACf,MAAA,QAAA,CAAS,MAAA,YAAkB,QAAQ,MAAA,GAAS,IAAI,MAAM,MAAA,CAAO,MAAM,CAAC,CAAC,CAAA;AAAA,IACvE,CAAA,SAAE;AACA,MAAA,YAAA,CAAa,KAAK,CAAA;AAAA,IACpB;AAAA,EACF,CAAA,EAAG,CAAC,MAAA,EAAQ,OAAA,EAAS,KAAK,CAAC,CAAA;AAE3B,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,KAAK,YAAA,EAAa;AAClB,IAAA,IAAI,CAAC,eAAA,EAAiB;AACpB,MAAA;AAAA,IACF;AACA,IAAA,MAAM,EAAA,GAAK,YAAY,MAAM;AAC3B,MAAA,KAAK,YAAA,EAAa;AAAA,IACpB,GAAG,eAAe,CAAA;AAClB,IAAA,OAAO,MAAM,cAAc,EAAE,CAAA;AAAA,EAC/B,CAAA,EAAG,CAAC,YAAA,EAAc,eAAe,CAAC,CAAA;AAElC,EAAA,MAAM,OAAA,GAAU,YAAY,MAAM;AAChC,IAAA,KAAK,YAAA,EAAa;AAAA,EACpB,CAAA,EAAG,CAAC,YAAY,CAAC,CAAA;AAEjB,EAAA,OAAO,EAAE,IAAA,EAAM,SAAA,EAAW,KAAA,EAAO,OAAA,EAAQ;AAC3C;ACnEO,SAAS,aAAa,OAAA,EAAiD;AAC5E,EAAA,OAAO,QAAQ,MAAM;AACnB,IAAA,MAAM,QAAQ,UAAA,CAAW,IAAA,CAAK,CAAC,SAAA,KAAc,SAAA,CAAU,OAAO,OAAO,CAAA;AACrE,IAAA,OAAO,EAAE,KAAA,EAAO,WAAA,EAAa,KAAA,KAAU,MAAA,EAAU;AAAA,EACnD,CAAA,EAAG,CAAC,OAAO,CAAC,CAAA;AACd;ACNO,SAAS,qBACd,OAAA,EACmB;AACnB,EAAA,MAAM,aAAa,OAAA,EAAS,UAAA;AAC5B,EAAA,OAAOA,OAAAA;AAAA,IACL,MAAM,oBAAA,CAAqB,UAAA,KAAe,SAAY,MAAA,GAAY,EAAE,YAAY,CAAA;AAAA,IAChF,CAAC,UAAU;AAAA,GACb;AACF","file":"react.js","sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\nimport { erc20Abi } from \"viem\";\nimport type { Address, PublicClient, Transport } from \"viem\";\n\nimport type { PepuChain } from \"../chains.js\";\n\n/** Options for {@link usePepuBalance}. */\nexport interface UsePepuBalanceOptions {\n  /** Address to read a balance for. The hook holds `data` at `undefined` while this is `undefined`. */\n  readonly address: Address | undefined;\n  /** ERC-20 token address to read `balanceOf` for. Omit for the native PEPU balance (`client.getBalance`). */\n  readonly token?: Address;\n  /** Re-fetch on an interval, in milliseconds. Omit (or `0`) to fetch once. */\n  readonly pollingInterval?: number;\n}\n\n/** Result of {@link usePepuBalance}. */\nexport interface UsePepuBalanceResult {\n  /** The balance in the smallest unit (wei for native PEPU, the token's own base unit for an ERC-20), or `undefined` before the first successful fetch. */\n  readonly data: bigint | undefined;\n  readonly isLoading: boolean;\n  readonly error: Error | undefined;\n  /** Re-run the fetch immediately, outside the polling interval. */\n  readonly refetch: () => void;\n}\n\n/**\n * Read (and optionally poll) an address's native PEPU balance, or an\n * ERC-20 token balance on a PEPU chain, given a viem `PublicClient`.\n *\n * Deliberately takes the client as a parameter rather than reaching for one\n * itself (e.g. via a context provider this package would have to define\n * and ship) — this keeps the hook usable with whatever client the host app\n * already has (its own `getPublicClient` call, wagmi's `usePublicClient()`,\n * etc.) instead of introducing a second, competing way to obtain one.\n */\nexport function usePepuBalance(\n  client: PublicClient<Transport, PepuChain>,\n  options: UsePepuBalanceOptions,\n): UsePepuBalanceResult {\n  const { address, token, pollingInterval } = options;\n  const [data, setData] = useState<bigint | undefined>(undefined);\n  const [error, setError] = useState<Error | undefined>(undefined);\n  const [isLoading, setIsLoading] = useState(false);\n\n  const fetchBalance = useCallback(async () => {\n    if (!address) {\n      setData(undefined);\n      setError(undefined);\n      return;\n    }\n    setIsLoading(true);\n    try {\n      const balance = token\n        ? await client.readContract({\n            address: token,\n            abi: erc20Abi,\n            functionName: \"balanceOf\",\n            args: [address],\n          })\n        : await client.getBalance({ address });\n      setData(balance);\n      setError(undefined);\n    } catch (caught) {\n      setError(caught instanceof Error ? caught : new Error(String(caught)));\n    } finally {\n      setIsLoading(false);\n    }\n  }, [client, address, token]);\n\n  useEffect(() => {\n    void fetchBalance();\n    if (!pollingInterval) {\n      return;\n    }\n    const id = setInterval(() => {\n      void fetchBalance();\n    }, pollingInterval);\n    return () => clearInterval(id);\n  }, [fetchBalance, pollingInterval]);\n\n  const refetch = useCallback(() => {\n    void fetchBalance();\n  }, [fetchBalance]);\n\n  return { data, isLoading, error, refetch };\n}\n","import { useMemo } from \"react\";\n\nimport { pepuChains } from \"../chains.js\";\nimport type { PepuChain } from \"../chains.js\";\n\n/** Result of {@link usePepuChain}. */\nexport interface UsePepuChainResult {\n  /** The matching {@link PepuChain}, or `undefined` if `chainId` isn't one of PEPU's. */\n  readonly chain: PepuChain | undefined;\n  /** `true` iff `chainId` is one of PEPU's chain ids. Equivalent to `chain !== undefined`. */\n  readonly isPepuChain: boolean;\n}\n\n/**\n * Resolve a raw chain id (e.g. from wagmi's `useChainId()`, or an injected\n * wallet's `eth_chainId`) to its {@link PepuChain} definition, if it's one\n * of PEPU's. Pure lookup over {@link pepuChains} — makes no network call\n * and holds no state beyond memoizing the result.\n */\nexport function usePepuChain(chainId: number | undefined): UsePepuChainResult {\n  return useMemo(() => {\n    const chain = pepuChains.find((candidate) => candidate.id === chainId);\n    return { chain, isPepuChain: chain !== undefined };\n  }, [chainId]);\n}\n","import { useMemo } from \"react\";\n\nimport { getSponsorshipStatus } from \"../aa/status.js\";\nimport type { GetSponsorshipStatusOptions, SponsorshipStatus } from \"../aa/status.js\";\n\n/**\n * React wrapper around {@link getSponsorshipStatus} — reports whether PEPU\n * gas sponsorship is available. **Deprecated: always reports unavailable.**\n * The hosted bundler and paymaster service are live and sponsorship is proven\n * on mainnet, but the ERC-7677 URL embeds a project token, so availability can\n * only be answered by a live probe. Use `usePepuSponsorship()` from\n * `@pepu-chain/sdk/aa/react` (it wraps `checkSponsorship`) instead. This hook\n * stays so 0.1 callers keep compiling.\n */\n/**\n * @deprecated Always reports unavailable. Use `usePepuSponsorship()` from\n * `@pepu-chain/sdk/aa/react` (live probe). Kept for 0.1 callers.\n */\nexport function useSponsorshipStatus(\n  options?: GetSponsorshipStatusOptions,\n): SponsorshipStatus {\n  const bundlerUrl = options?.bundlerUrl;\n  return useMemo(\n    () => getSponsorshipStatus(bundlerUrl === undefined ? undefined : { bundlerUrl }),\n    [bundlerUrl],\n  );\n}\n"]}