@provex/react 1.2.5 → 1.3.0

package/dist/wagmi.d.cts

@@ -0,0 +1,82 @@
+import { j as WalletAdapter, s as ProvexProviderProps, o as ProvexTheme } from './ProvexProvider-DWxHsaR8.cjs';
+import { PublicClient } from 'viem';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React__default from 'react';
+import { ProviderKey } from '@provex/utils/payment';
+import '@tanstack/react-query';
+import '@provex/utils/chain';
+import '@provex/utils/reputation';
+import '@provex/utils/currencies';
+import '@provex/utils/tokens';
+
+/**
+ * @fileoverview Bridge wagmi's wallet to the WalletAdapter interface.
+ *
+ * Creates a memoized WalletAdapter from wagmi's `useWalletClient` and
+ * `useAccount` hooks. Pass the result to `useProveXClient(wallet)` or
+ * directly to any hook that accepts a WalletAdapter.
+ *
+ * This hook lives in `@provex/react/wagmi` so that the main entry
+ * does not import `wagmi`. Consumers without wagmi ignore it.
+ */
+
+/**
+ * Create a WalletAdapter from the connected wagmi wallet.
+ *
+ * Returns `null` when no wallet is connected.
+ *
+ * @example
+ * ```tsx
+ * import { useWagmiWallet } from '@provex/react/wagmi'
+ * const wallet = useWagmiWallet()
+ * const client = useProveXClient(wallet ?? undefined)
+ * ```
+ */
+declare function useWagmiWallet(): WalletAdapter | null;
+
+/**
+ * @fileoverview Build a ProvexProvider `publicClients` map from wagmi config.
+ *
+ * Reads every configured chain from WagmiProvider and exposes each chain's
+ * public client so Provex hooks can make RPC calls without invoking
+ * wagmi APIs directly.
+ */
+
+/**
+ * Returns a `{ chainId: publicClient }` map ready to pass to `ProvexProvider`'s
+ * `publicClients` prop. Covers every chain registered on the surrounding
+ * WagmiProvider.
+ */
+declare function useWagmiPublicClients(): Record<number, PublicClient>;
+
+type WagmiProvexProviderProps = Omit<ProvexProviderProps, 'publicClient' | 'publicClients' | 'wallet'>;
+/**
+ * ProvexProvider preset for wagmi apps. Equivalent to manually passing
+ * `publicClients={useWagmiPublicClients()}` and `wallet={useWagmiWallet()}`.
+ */
+declare function WagmiProvexProvider(props: WagmiProvexProviderProps): react_jsx_runtime.JSX.Element;
+
+/** Props for the ProvexBuyWagmi component. Same as BuyProps minus `wallet`. */
+interface ProvexBuyWagmiProps {
+    /** Called when the user signals intent (USDC reserved). */
+    onIntentSignaled?: (intentHash: string, chainId: number) => void;
+    /** Called when the full flow completes (USDC released). */
+    onComplete?: (intentHash: string, chainId: number) => void;
+    /** Restrict to specific payment methods. */
+    paymentMethods?: ProviderKey[];
+    /** CSS class name for the root container. */
+    className?: string;
+    /** Inline styles for the root container. */
+    style?: React__default.CSSProperties;
+    /** Theme overrides applied as CSS custom properties. */
+    theme?: ProvexTheme;
+}
+/**
+ * ProvexBuyWagmi — drop-in buy widget for wagmi apps.
+ *
+ * Reads the connected wallet from wagmi context automatically.
+ * No need to create a WalletAdapter manually.
+ */
+declare function ProvexBuyWagmi({ onIntentSignaled, onComplete, paymentMethods, className, style, theme, }: ProvexBuyWagmiProps): react_jsx_runtime.JSX.Element;
+
+export { ProvexBuyWagmi, type ProvexBuyWagmiProps, WagmiProvexProvider, type WagmiProvexProviderProps, useWagmiPublicClients, useWagmiWallet };

package/dist/wagmi.d.ts

@@ -0,0 +1,82 @@
+import { j as WalletAdapter, s as ProvexProviderProps, o as ProvexTheme } from './ProvexProvider-DWxHsaR8.js';
+import { PublicClient } from 'viem';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React__default from 'react';
+import { ProviderKey } from '@provex/utils/payment';
+import '@tanstack/react-query';
+import '@provex/utils/chain';
+import '@provex/utils/reputation';
+import '@provex/utils/currencies';
+import '@provex/utils/tokens';
+
+/**
+ * @fileoverview Bridge wagmi's wallet to the WalletAdapter interface.
+ *
+ * Creates a memoized WalletAdapter from wagmi's `useWalletClient` and
+ * `useAccount` hooks. Pass the result to `useProveXClient(wallet)` or
+ * directly to any hook that accepts a WalletAdapter.
+ *
+ * This hook lives in `@provex/react/wagmi` so that the main entry
+ * does not import `wagmi`. Consumers without wagmi ignore it.
+ */
+
+/**
+ * Create a WalletAdapter from the connected wagmi wallet.
+ *
+ * Returns `null` when no wallet is connected.
+ *
+ * @example
+ * ```tsx
+ * import { useWagmiWallet } from '@provex/react/wagmi'
+ * const wallet = useWagmiWallet()
+ * const client = useProveXClient(wallet ?? undefined)
+ * ```
+ */
+declare function useWagmiWallet(): WalletAdapter | null;
+
+/**
+ * @fileoverview Build a ProvexProvider `publicClients` map from wagmi config.
+ *
+ * Reads every configured chain from WagmiProvider and exposes each chain's
+ * public client so Provex hooks can make RPC calls without invoking
+ * wagmi APIs directly.
+ */
+
+/**
+ * Returns a `{ chainId: publicClient }` map ready to pass to `ProvexProvider`'s
+ * `publicClients` prop. Covers every chain registered on the surrounding
+ * WagmiProvider.
+ */
+declare function useWagmiPublicClients(): Record<number, PublicClient>;
+
+type WagmiProvexProviderProps = Omit<ProvexProviderProps, 'publicClient' | 'publicClients' | 'wallet'>;
+/**
+ * ProvexProvider preset for wagmi apps. Equivalent to manually passing
+ * `publicClients={useWagmiPublicClients()}` and `wallet={useWagmiWallet()}`.
+ */
+declare function WagmiProvexProvider(props: WagmiProvexProviderProps): react_jsx_runtime.JSX.Element;
+
+/** Props for the ProvexBuyWagmi component. Same as BuyProps minus `wallet`. */
+interface ProvexBuyWagmiProps {
+    /** Called when the user signals intent (USDC reserved). */
+    onIntentSignaled?: (intentHash: string, chainId: number) => void;
+    /** Called when the full flow completes (USDC released). */
+    onComplete?: (intentHash: string, chainId: number) => void;
+    /** Restrict to specific payment methods. */
+    paymentMethods?: ProviderKey[];
+    /** CSS class name for the root container. */
+    className?: string;
+    /** Inline styles for the root container. */
+    style?: React__default.CSSProperties;
+    /** Theme overrides applied as CSS custom properties. */
+    theme?: ProvexTheme;
+}
+/**
+ * ProvexBuyWagmi — drop-in buy widget for wagmi apps.
+ *
+ * Reads the connected wallet from wagmi context automatically.
+ * No need to create a WalletAdapter manually.
+ */
+declare function ProvexBuyWagmi({ onIntentSignaled, onComplete, paymentMethods, className, style, theme, }: ProvexBuyWagmiProps): react_jsx_runtime.JSX.Element;
+
+export { ProvexBuyWagmi, type ProvexBuyWagmiProps, WagmiProvexProvider, type WagmiProvexProviderProps, useWagmiPublicClients, useWagmiWallet };

package/dist/wagmi.js

@@ -0,0 +1,72 @@
+import { ProvexProvider, ProvexBuy } from './chunk-7BVFQVKS.js';
+import { useMemo } from 'react';
+import { useAccount, useWalletClient, useConfig } from 'wagmi';
+import { getPublicClient } from 'wagmi/actions';
+import { jsx } from 'react/jsx-runtime';
+
+function useWagmiWallet() {
+  const { address } = useAccount();
+  const { data: walletClient } = useWalletClient();
+  return useMemo(() => {
+    if (!walletClient || !address) return null;
+    return {
+      address,
+      async sendTransaction(tx) {
+        return walletClient.sendTransaction({
+          to: tx.to,
+          data: tx.data,
+          value: tx.value ?? 0n,
+          chain: walletClient.chain,
+          maxFeePerGas: tx.maxFeePerGas,
+          maxPriorityFeePerGas: tx.maxPriorityFeePerGas
+        });
+      }
+    };
+  }, [walletClient, address]);
+}
+function useWagmiPublicClients() {
+  const config = useConfig();
+  return useMemo(() => {
+    const clients = {};
+    for (const chain of config.chains) {
+      const client = getPublicClient(config, { chainId: chain.id });
+      if (client) clients[chain.id] = client;
+    }
+    return clients;
+  }, [config]);
+}
+function WagmiProvexProvider(props) {
+  const publicClients = useWagmiPublicClients();
+  const wallet = useWagmiWallet() ?? void 0;
+  return /* @__PURE__ */ jsx(ProvexProvider, { ...props, publicClients, wallet });
+}
+var DISCONNECTED_WALLET = {
+  address: void 0,
+  sendTransaction: () => Promise.reject(new Error("Wallet not connected"))
+};
+function ProvexBuyWagmi({
+  onIntentSignaled,
+  onComplete,
+  paymentMethods,
+  className,
+  style,
+  theme
+}) {
+  const wallet = useWagmiWallet() ?? DISCONNECTED_WALLET;
+  return /* @__PURE__ */ jsx(
+    ProvexBuy,
+    {
+      wallet,
+      onIntentSignaled,
+      onComplete,
+      paymentMethods,
+      className,
+      style,
+      theme
+    }
+  );
+}
+
+export { ProvexBuyWagmi, WagmiProvexProvider, useWagmiPublicClients, useWagmiWallet };
+//# sourceMappingURL=wagmi.js.map
+//# sourceMappingURL=wagmi.js.map

package/dist/wagmi.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/wagmi/useWagmiWallet.ts","../src/wagmi/useWagmiPublicClients.ts","../src/wagmi/WagmiProvexProvider.tsx","../src/wagmi/ProvexBuyWagmi.tsx"],"names":["useMemo","jsx"],"mappings":";;;;;;AA4BO,SAAS,cAAA,GAAuC;AACrD,EAAA,MAAM,EAAE,OAAA,EAAQ,GAAI,UAAA,EAAW;AAC/B,EAAA,MAAM,EAAE,IAAA,EAAM,YAAA,EAAa,GAAI,eAAA,EAAgB;AAE/C,EAAA,OAAO,QAAQ,MAAM;AACnB,IAAA,IAAI,CAAC,YAAA,IAAgB,CAAC,OAAA,EAAS,OAAO,IAAA;AAEtC,IAAA,OAAO;AAAA,MACL,OAAA;AAAA,MACA,MAAM,gBAAgB,EAAA,EAAI;AACxB,QAAA,OAAO,aAAa,eAAA,CAAgB;AAAA,UAClC,IAAI,EAAA,CAAG,EAAA;AAAA,UACP,MAAM,EAAA,CAAG,IAAA;AAAA,UACT,KAAA,EAAO,GAAG,KAAA,IAAS,EAAA;AAAA,UACnB,OAAO,YAAA,CAAa,KAAA;AAAA,UACpB,cAAc,EAAA,CAAG,YAAA;AAAA,UACjB,sBAAsB,EAAA,CAAG;AAAA,SAC1B,CAAA;AAAA,MACH;AAAA,KACF;AAAA,EACF,CAAA,EAAG,CAAC,YAAA,EAAc,OAAO,CAAC,CAAA;AAC5B;AC/BO,SAAS,qBAAA,GAAsD;AACpE,EAAA,MAAM,SAAS,SAAA,EAAU;AAEzB,EAAA,OAAOA,QAAQ,MAAM;AACnB,IAAA,MAAM,UAAwC,EAAC;AAC/C,IAAA,KAAA,MAAW,KAAA,IAAS,OAAO,MAAA,EAAQ;AACjC,MAAA,MAAM,SAAS,eAAA,CAAgB,MAAA,EAAQ,EAAE,OAAA,EAAS,KAAA,CAAM,IAAI,CAAA;AAC5D,MAAA,IAAI,MAAA,EAAQ,OAAA,CAAQ,KAAA,CAAM,EAAE,CAAA,GAAI,MAAA;AAAA,IAClC;AACA,IAAA,OAAO,OAAA;AAAA,EACT,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AACb;ACQO,SAAS,oBAAoB,KAAA,EAAiC;AACnE,EAAA,MAAM,gBAAgB,qBAAA,EAAsB;AAC5C,EAAA,MAAM,MAAA,GAAS,gBAAe,IAAK,MAAA;AAEnC,EAAA,uBACE,GAAA,CAAC,cAAA,EAAA,EAAgB,GAAG,KAAA,EAAO,eAA8B,MAAA,EAAgB,CAAA;AAE7E;ACAA,IAAM,mBAAA,GAAsB;AAAA,EAC1B,OAAA,EAAS,MAAA;AAAA,EACT,iBAAiB,MAAM,OAAA,CAAQ,OAAO,IAAI,KAAA,CAAM,sBAAsB,CAAC;AACzE,CAAA;AAQO,SAAS,cAAA,CAAe;AAAA,EAC7B,gBAAA;AAAA,EACA,UAAA;AAAA,EACA,cAAA;AAAA,EACA,SAAA;AAAA,EACA,KAAA;AAAA,EACA;AACF,CAAA,EAAwB;AACtB,EAAA,MAAM,MAAA,GAAS,gBAAe,IAAK,mBAAA;AAEnC,EAAA,uBACEC,GAAAA;AAAA,IAAC,SAAA;AAAA,IAAA;AAAA,MACC,MAAA;AAAA,MACA,gBAAA;AAAA,MACA,UAAA;AAAA,MACA,cAAA;AAAA,MACA,SAAA;AAAA,MACA,KAAA;AAAA,MACA;AAAA;AAAA,GACF;AAEJ","file":"wagmi.js","sourcesContent":["/**\n * @fileoverview Bridge wagmi's wallet to the WalletAdapter interface.\n *\n * Creates a memoized WalletAdapter from wagmi's `useWalletClient` and\n * `useAccount` hooks. Pass the result to `useProveXClient(wallet)` or\n * directly to any hook that accepts a WalletAdapter.\n *\n * This hook lives in `@provex/react/wagmi` so that the main entry\n * does not import `wagmi`. Consumers without wagmi ignore it.\n */\n\nimport { useMemo } from 'react'\nimport { useAccount, useWalletClient } from 'wagmi'\nimport type { Hex } from 'viem'\nimport type { WalletAdapter } from '../client/types'\n\n/**\n * Create a WalletAdapter from the connected wagmi wallet.\n *\n * Returns `null` when no wallet is connected.\n *\n * @example\n * ```tsx\n * import { useWagmiWallet } from '@provex/react/wagmi'\n * const wallet = useWagmiWallet()\n * const client = useProveXClient(wallet ?? undefined)\n * ```\n */\nexport function useWagmiWallet(): WalletAdapter | null {\n  const { address } = useAccount()\n  const { data: walletClient } = useWalletClient()\n\n  return useMemo(() => {\n    if (!walletClient || !address) return null\n\n    return {\n      address: address as Hex,\n      async sendTransaction(tx) {\n        return walletClient.sendTransaction({\n          to: tx.to,\n          data: tx.data,\n          value: tx.value ?? 0n,\n          chain: walletClient.chain,\n          maxFeePerGas: tx.maxFeePerGas,\n          maxPriorityFeePerGas: tx.maxPriorityFeePerGas,\n        })\n      },\n    }\n  }, [walletClient, address])\n}\n","/**\n * @fileoverview Build a ProvexProvider `publicClients` map from wagmi config.\n *\n * Reads every configured chain from WagmiProvider and exposes each chain's\n * public client so Provex hooks can make RPC calls without invoking\n * wagmi APIs directly.\n */\n\nimport { useMemo } from 'react'\nimport { useConfig } from 'wagmi'\nimport { getPublicClient } from 'wagmi/actions'\nimport type { PublicClient } from 'viem'\n\n/**\n * Returns a `{ chainId: publicClient }` map ready to pass to `ProvexProvider`'s\n * `publicClients` prop. Covers every chain registered on the surrounding\n * WagmiProvider.\n */\nexport function useWagmiPublicClients(): Record<number, PublicClient> {\n  const config = useConfig()\n\n  return useMemo(() => {\n    const clients: Record<number, PublicClient> = {}\n    for (const chain of config.chains) {\n      const client = getPublicClient(config, { chainId: chain.id })\n      if (client) clients[chain.id] = client as unknown as PublicClient\n    }\n    return clients\n  }, [config])\n}\n","/**\n * @fileoverview Drop-in provider that wires wagmi into ProvexProvider.\n *\n * Must be placed inside a `WagmiProvider`. Reads wagmi's configured chains\n * and wallet, then hands them to ProvexProvider so Provex hooks can work\n * without importing wagmi themselves.\n *\n * @example\n * ```tsx\n * import { WagmiProvider } from 'wagmi'\n * import { WagmiProvexProvider } from '@provex/react/wagmi'\n * import { createPonderAdapter } from '@provex/indexer-client'\n *\n * <WagmiProvider config={wagmiConfig}>\n *   <WagmiProvexProvider\n *     config={{ apiUrl: 'https://app.provex.com', chain: base }}\n *     indexer={createPonderAdapter()}\n *   >\n *     <App />\n *   </WagmiProvexProvider>\n * </WagmiProvider>\n * ```\n */\n\nimport { ProvexProvider, type ProvexProviderProps } from '../ProvexProvider'\nimport { useWagmiWallet } from './useWagmiWallet'\nimport { useWagmiPublicClients } from './useWagmiPublicClients'\n\nexport type WagmiProvexProviderProps = Omit<\n  ProvexProviderProps,\n  'publicClient' | 'publicClients' | 'wallet'\n>\n\n/**\n * ProvexProvider preset for wagmi apps. Equivalent to manually passing\n * `publicClients={useWagmiPublicClients()}` and `wallet={useWagmiWallet()}`.\n */\nexport function WagmiProvexProvider(props: WagmiProvexProviderProps) {\n  const publicClients = useWagmiPublicClients()\n  const wallet = useWagmiWallet() ?? undefined\n\n  return (\n    <ProvexProvider {...props} publicClients={publicClients} wallet={wallet} />\n  )\n}\n","/**\n * @fileoverview ProvexBuyWagmi — convenience wrapper for wagmi apps.\n *\n * Reads the connected wallet from wagmi context via `useWagmiWallet()`\n * and passes it to the standard `ProvexBuy` widget. Consumers only need\n * `WagmiProvider` + `ProvexProvider` (or `WagmiProvexProvider`) above\n * this component.\n *\n * When no wallet is connected, the widget still renders in browse mode\n * (showing deposits and rates) with the submit button disabled.\n *\n * @example\n * ```tsx\n * import { ProvexBuyWagmi } from '@provex/react/wagmi'\n * import '@provex/react/styles'\n *\n * <ProvexBuyWagmi\n *   onComplete={(hash, chainId) => console.log('Done!', hash)}\n * />\n * ```\n */\n\nimport React from 'react'\nimport { ProvexBuy } from '../ProvexBuy'\nimport { useWagmiWallet } from './useWagmiWallet'\nimport type { ProvexTheme } from '../types'\nimport type { ProviderKey } from '@provex/utils/payment'\n\n/** Props for the ProvexBuyWagmi component. Same as BuyProps minus `wallet`. */\nexport interface ProvexBuyWagmiProps {\n  /** Called when the user signals intent (USDC reserved). */\n  onIntentSignaled?: (intentHash: string, chainId: number) => void\n  /** Called when the full flow completes (USDC released). */\n  onComplete?: (intentHash: string, chainId: number) => void\n  /** Restrict to specific payment methods. */\n  paymentMethods?: ProviderKey[]\n  /** CSS class name for the root container. */\n  className?: string\n  /** Inline styles for the root container. */\n  style?: React.CSSProperties\n  /** Theme overrides applied as CSS custom properties. */\n  theme?: ProvexTheme\n}\n\nconst DISCONNECTED_WALLET = {\n  address: undefined,\n  sendTransaction: () => Promise.reject(new Error('Wallet not connected')),\n} as const\n\n/**\n * ProvexBuyWagmi — drop-in buy widget for wagmi apps.\n *\n * Reads the connected wallet from wagmi context automatically.\n * No need to create a WalletAdapter manually.\n */\nexport function ProvexBuyWagmi({\n  onIntentSignaled,\n  onComplete,\n  paymentMethods,\n  className,\n  style,\n  theme,\n}: ProvexBuyWagmiProps) {\n  const wallet = useWagmiWallet() ?? DISCONNECTED_WALLET\n\n  return (\n    <ProvexBuy\n      wallet={wallet}\n      onIntentSignaled={onIntentSignaled}\n      onComplete={onComplete}\n      paymentMethods={paymentMethods}\n      className={className}\n      style={style}\n      theme={theme}\n    />\n  )\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@provex/react",
-  "version": "1.2.5",
+  "version": "1.3.0",
   "description": "Portable React buy-flow component and hooks for the Provex protocol",
   "type": "module",
   "repository": {
@@ -17,6 +17,11 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./wagmi": {
+      "types": "./dist/wagmi.d.ts",
+      "import": "./dist/wagmi.js",
+      "require": "./dist/wagmi.cjs"
+    },
     "./styles": "./dist/styles/default.css"
   },
   "publishConfig": {
@@ -35,15 +40,20 @@
   },
   "dependencies": {
     "@ponder/client": "^0.16.0",
-    "@provex/abis": "1.2.5",
-    "@provex/utils": "1.2.5"
+    "@provex/abis": "1.3.0",
+    "@provex/utils": "1.3.0"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.0.0",
-    "react": "^18.0.0",
+    "react": "^18.0.0 || ^19.0.0",
     "viem": "^2.0.0",
     "wagmi": "^2.0.0"
   },
+  "peerDependenciesMeta": {
+    "wagmi": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@testing-library/dom": "^10.0.0",
     "@testing-library/react": "^16.0.0",
@@ -52,6 +62,7 @@
     "react-dom": "^18.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.9.2",
-    "vitest": "^3.0.0"
+    "vitest": "^3.0.0",
+    "wagmi": "^2.0.0"
   }
 }