npm - erc4337-kit - Versions diffs - 0.1.0 - Mend

erc4337-kit 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/README.md +167 -0
package/dist/index.cjs +321 -0
package/dist/index.cjs.map +1 -0
package/dist/index.js +295 -0
package/dist/index.js.map +1 -0
package/package.json +67 -0
package/src/contracts/BaseStorage.sol +221 -0

package/README.md ADDED Viewed

@@ -0,0 +1,167 @@
+# erc4337-kit
+ERC-4337 Account Abstraction for React apps — gasless transactions, social login, smart accounts. Plug in, don't plumb.
+Built on: Privy · Pimlico · Permissionless · Polygon Amoy
+---
+## Install
+```bash
+npm install erc4337-kit
+```
+Also install peer dependencies if you haven't already:
+```bash
+npm install @privy-io/react-auth @privy-io/wagmi viem wagmi @tanstack/react-query permissionless
+```
+---
+## Vite setup (required)
+Add this to `vite.config.js` — viem needs these polyfills in the browser:
+```js
+export default defineConfig({
+  define: { global: 'globalThis' },
+  resolve: {
+    alias: { '@noble/curves/nist.js': '@noble/curves/nist' },
+  },
+})
+```
+Add this to your `index.html` `<head>` before your app script:
+```html
+<script type="module">
+  import { Buffer } from 'buffer'
+  import process from 'process'
+  window.Buffer = Buffer
+  window.process = process
+</script>
+```
+---
+## Quick start
+### 1. Wrap your app
+```jsx
+import { ChainProvider } from 'erc4337-kit'
+import { polygonAmoy } from 'erc4337-kit'
+function main() {
+  return (
+    <ChainProvider
+      privyAppId={import.meta.env.VITE_PRIVY_APP_ID}
+      chain={polygonAmoy}
+      rpcUrl={import.meta.env.VITE_RPC_URL}
+    >
+      <App />
+    </ChainProvider>
+  )
+}
+```
+### 2. Initialize the smart account
+```jsx
+import { useSmartAccount } from 'erc4337-kit'
+import { polygonAmoy } from 'erc4337-kit'
+function App() {
+  const {
+    login, logout, authenticated,
+    smartAccountClient, smartAccountAddress,
+    isReady, isLoading, error
+  } = useSmartAccount({
+    pimlicoApiKey: import.meta.env.VITE_PIMLICO_API_KEY,
+    rpcUrl:        import.meta.env.VITE_RPC_URL,
+    chain:         polygonAmoy,
+  })
+  if (!authenticated) return <button onClick={login}>Login with Google</button>
+  if (isLoading) return <p>Setting up your wallet...</p>
+  if (error) return <p>Error: {error}</p>
+  return <Dashboard smartAccountClient={smartAccountClient} />
+}
+```
+### 3. Store data on-chain (gasless)
+```jsx
+import { useStoreOnChain, sha256Hash } from 'erc4337-kit'
+const MY_CONTRACT_ABI = [
+  {
+    name: 'storeRecord',
+    type: 'function',
+    inputs: [{ name: 'dataHash', type: 'bytes32' }],
+  },
+]
+function ReportForm({ smartAccountClient }) {
+  const { submit, txHash, isLoading, error } = useStoreOnChain({
+    smartAccountClient,
+    contractAddress: import.meta.env.VITE_CONTRACT_ADDRESS,
+    abi: MY_CONTRACT_ABI,
+    functionName: 'storeRecord',
+  })
+  const handleSubmit = async (reportText) => {
+    const hash = await sha256Hash(reportText)  // hashed locally
+    await submit([hash])
+  }
+  return (
+    <div>
+      <button onClick={() => handleSubmit('incident details')} disabled={isLoading}>
+        {isLoading ? 'Storing...' : 'Submit Report'}
+      </button>
+      {txHash && <p>Stored! Tx: {txHash}</p>}
+      {error && <p>Error: {error}</p>}
+    </div>
+  )
+}
+```
+---
+## Contract template
+Copy `src/contracts/BaseStorage.sol` from this package as a starting point. It is pre-commented with all ERC-4337 compatibility rules. Add fields to the struct and parameters to `storeRecord()` as needed for your use case.
+Deploy it with Hardhat or Remix to your chain, then pass the address to `useStoreOnChain()`.
+---
+## Environment variables
+```env
+VITE_PRIVY_APP_ID=       # dashboard.privy.io
+VITE_PIMLICO_API_KEY=    # dashboard.pimlico.io
+VITE_RPC_URL=            # Alchemy or Infura RPC for your chain
+VITE_CONTRACT_ADDRESS=   # deployed BaseStorage.sol address
+```
+---
+## Supported chains
+Any EVM chain supported by Pimlico and Privy. Chains exported from this package for convenience:
+- `polygonAmoy` — Polygon testnet (recommended for dev)
+- `polygon` — Polygon mainnet
+- `sepolia` — Ethereum testnet
+- `baseSepolia` — Base testnet
+---
+## License
+MIT

package/dist/index.cjs ADDED Viewed

@@ -0,0 +1,321 @@
+'use strict';
+var React = require('react');
+var reactAuth = require('@privy-io/react-auth');
+var wagmi = require('@privy-io/wagmi');
+var reactQuery = require('@tanstack/react-query');
+var viem = require('viem');
+var permissionless = require('permissionless');
+var accounts = require('permissionless/accounts');
+var pimlico = require('permissionless/clients/pimlico');
+var accountAbstraction = require('viem/account-abstraction');
+var chains = require('viem/chains');
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+var React__default = /*#__PURE__*/_interopDefault(React);
+// src/providers/ChainProvider.jsx
+var queryClient = new reactQuery.QueryClient({
+  defaultOptions: {
+    queries: {
+      retry: 2,
+      staleTime: 3e4
+    }
+  }
+});
+function ChainProvider({
+  privyAppId,
+  chain,
+  rpcUrl,
+  loginMethods = ["google", "email"],
+  appearance = {},
+  children
+}) {
+  const wagmiConfig = wagmi.createConfig({
+    chains: [chain],
+    transports: {
+      [chain.id]: viem.http(rpcUrl)
+    }
+  });
+  return /* @__PURE__ */ React__default.default.createElement(
+    reactAuth.PrivyProvider,
+    {
+      appId: privyAppId,
+      config: {
+        loginMethods,
+        embeddedWallets: {
+          // CRITICAL: this tells Privy to create a wallet for EVERY user
+          // automatically on login. Without this, you'd have to call
+          // createWallet() manually and handle the timing yourself.
+          createOnLogin: "all-users"
+        },
+        defaultChain: chain,
+        supportedChains: [chain],
+        appearance: {
+          theme: "light",
+          accentColor: "#7c3aed",
+          ...appearance
+        }
+      }
+    },
+    /* @__PURE__ */ React__default.default.createElement(reactQuery.QueryClientProvider, { client: queryClient }, /* @__PURE__ */ React__default.default.createElement(wagmi.WagmiProvider, { config: wagmiConfig }, children))
+  );
+}
+function buildPimlicoUrl(chainId, apiKey) {
+  return `https://api.pimlico.io/v2/${chainId}/rpc?apikey=${apiKey}`;
+}
+function useSmartAccount({ pimlicoApiKey, rpcUrl, chain }) {
+  const { login, logout, authenticated, user, ready } = reactAuth.usePrivy();
+  const { wallets } = reactAuth.useWallets();
+  const { createWallet } = reactAuth.useCreateWallet();
+  const [smartAccountAddress, setSmartAccountAddress] = React.useState(null);
+  const [smartAccountClient, setSmartAccountClient] = React.useState(null);
+  const [pimlicoClient, setPimlicoClient] = React.useState(null);
+  const [isLoading, setIsLoading] = React.useState(false);
+  const [error, setError] = React.useState(null);
+  const initCalledRef = React.useRef(false);
+  const walletCreationAttempted = React.useRef(false);
+  const pimlicoUrl = buildPimlicoUrl(chain.id, pimlicoApiKey);
+  const initSmartAccount = React.useCallback(async () => {
+    var _a;
+    if (!authenticated || !ready) return;
+    if (!wallets || wallets.length === 0) {
+      if (!walletCreationAttempted.current) {
+        walletCreationAttempted.current = true;
+        try {
+          await createWallet();
+          return;
+        } catch (err) {
+          if (!((_a = err.message) == null ? void 0 : _a.includes("already has"))) {
+            setError("Failed to create embedded wallet: " + err.message);
+          }
+          return;
+        }
+      }
+      return;
+    }
+    if (initCalledRef.current) return;
+    initCalledRef.current = true;
+    setIsLoading(true);
+    setError(null);
+    try {
+      const wallet = wallets[0];
+      await wallet.switchChain(chain.id);
+      const provider = await wallet.getEthereumProvider();
+      const walletClient = viem.createWalletClient({
+        account: wallet.address,
+        chain,
+        transport: viem.custom(provider)
+      });
+      const publicClient = viem.createPublicClient({
+        chain,
+        transport: viem.http(rpcUrl)
+      });
+      const pimlico$1 = pimlico.createPimlicoClient({
+        transport: viem.http(pimlicoUrl),
+        entryPoint: {
+          address: accountAbstraction.entryPoint07Address,
+          version: "0.7"
+        }
+      });
+      const smartAccount = await accounts.toSimpleSmartAccount({
+        client: publicClient,
+        owner: walletClient,
+        entryPoint: {
+          address: accountAbstraction.entryPoint07Address,
+          version: "0.7"
+        }
+      });
+      const client = permissionless.createSmartAccountClient({
+        account: smartAccount,
+        chain,
+        bundlerTransport: viem.http(pimlicoUrl),
+        paymaster: pimlico$1,
+        // userOperation config: tell Pimlico to sponsor everything
+        userOperation: {
+          estimateFeesPerGas: async () => {
+            const fees = await pimlico$1.getUserOperationGasPrice();
+            return fees.fast;
+          }
+        }
+      });
+      setPimlicoClient(pimlico$1);
+      setSmartAccountClient(client);
+      setSmartAccountAddress(smartAccount.address);
+    } catch (err) {
+      console.error("[erc4337-kit] Smart account init failed:", err);
+      setError(err.message || "Failed to initialize smart account");
+      initCalledRef.current = false;
+    } finally {
+      setIsLoading(false);
+    }
+  }, [authenticated, wallets, ready, createWallet, chain, rpcUrl, pimlicoUrl]);
+  React.useEffect(() => {
+    initSmartAccount();
+  }, [initSmartAccount]);
+  const handleLogout = React.useCallback(async () => {
+    await logout();
+    initCalledRef.current = false;
+    walletCreationAttempted.current = false;
+    setSmartAccountAddress(null);
+    setSmartAccountClient(null);
+    setPimlicoClient(null);
+    setError(null);
+  }, [logout]);
+  return {
+    login,
+    logout: handleLogout,
+    authenticated,
+    user,
+    smartAccountAddress,
+    smartAccountClient,
+    pimlicoClient,
+    isReady: !!smartAccountClient && !!smartAccountAddress,
+    isLoading,
+    error
+  };
+}
+function useStoreOnChain({
+  smartAccountClient,
+  contractAddress,
+  abi,
+  functionName
+}) {
+  const [txHash, setTxHash] = React.useState(null);
+  const [recordId, setRecordId] = React.useState(null);
+  const [isLoading, setIsLoading] = React.useState(false);
+  const [isSuccess, setIsSuccess] = React.useState(false);
+  const [error, setError] = React.useState(null);
+  const submit = React.useCallback(
+    async (args = []) => {
+      var _a, _b;
+      if (!smartAccountClient) {
+        setError("Smart account not initialized. Make sure user is logged in.");
+        return null;
+      }
+      setIsLoading(true);
+      setIsSuccess(false);
+      setError(null);
+      setTxHash(null);
+      setRecordId(null);
+      try {
+        const calldata = viem.encodeFunctionData({
+          abi,
+          functionName,
+          args
+        });
+        const hash = await smartAccountClient.sendTransaction({
+          to: contractAddress,
+          data: calldata,
+          value: 0n
+          // no ETH/MATIC sent — this is just a contract call
+        });
+        setTxHash(hash);
+        setIsSuccess(true);
+        try {
+          const receipt = await smartAccountClient.waitForTransactionReceipt({ hash });
+          const firstLog = (_a = receipt.logs) == null ? void 0 : _a[0];
+          if ((_b = firstLog == null ? void 0 : firstLog.topics) == null ? void 0 : _b[1]) {
+            setRecordId(firstLog.topics[1]);
+          }
+        } catch {
+        }
+        return hash;
+      } catch (err) {
+        const message = parseError(err);
+        setError(message);
+        console.error("[erc4337-kit] Transaction failed:", err);
+        return null;
+      } finally {
+        setIsLoading(false);
+      }
+    },
+    [smartAccountClient, contractAddress, abi, functionName]
+  );
+  const reset = React.useCallback(() => {
+    setTxHash(null);
+    setRecordId(null);
+    setIsLoading(false);
+    setIsSuccess(false);
+    setError(null);
+  }, []);
+  return {
+    submit,
+    txHash,
+    recordId,
+    isLoading,
+    isSuccess,
+    error,
+    reset
+  };
+}
+function parseError(err) {
+  const msg = (err == null ? void 0 : err.message) || (err == null ? void 0 : err.toString()) || "Unknown error";
+  if (msg.includes("AA21")) {
+    return "Paymaster rejected: your Pimlico API key may be invalid or the policy does not cover this chain.";
+  }
+  if (msg.includes("AA31")) {
+    return "Paymaster out of funds. Check your Pimlico dashboard deposit balance.";
+  }
+  if (msg.includes("AA23") || msg.includes("invalid signature")) {
+    return "Wallet signature failed. Try logging out and back in.";
+  }
+  if (msg.includes("gas") && msg.includes("too low")) {
+    return "Gas estimate too low. The contract function may be too expensive for the paymaster policy.";
+  }
+  if (msg.includes("nonce")) {
+    return "Nonce error. A previous transaction may still be pending \u2014 wait a moment and retry.";
+  }
+  if (msg.includes("user rejected") || msg.includes("User rejected")) {
+    return "Transaction was cancelled.";
+  }
+  if (msg.includes("fetch") || msg.includes("network")) {
+    return "Network error. Check your RPC URL and Pimlico API key.";
+  }
+  return msg;
+}
+// src/utils/hash.js
+async function sha256Hash(text) {
+  if (typeof text !== "string") {
+    throw new Error("sha256Hash: input must be a string");
+  }
+  const encoded = new TextEncoder().encode(text);
+  const hashBuffer = await crypto.subtle.digest("SHA-256", encoded);
+  const hashArray = Array.from(new Uint8Array(hashBuffer));
+  return "0x" + hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+async function sha256HashFile(file) {
+  if (!(file instanceof File)) {
+    throw new Error("sha256HashFile: input must be a File object");
+  }
+  const arrayBuffer = await file.arrayBuffer();
+  const hashBuffer = await crypto.subtle.digest("SHA-256", arrayBuffer);
+  const hashArray = Array.from(new Uint8Array(hashBuffer));
+  return "0x" + hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+Object.defineProperty(exports, "baseSepolia", {
+  enumerable: true,
+  get: function () { return chains.baseSepolia; }
+});
+Object.defineProperty(exports, "polygon", {
+  enumerable: true,
+  get: function () { return chains.polygon; }
+});
+Object.defineProperty(exports, "polygonAmoy", {
+  enumerable: true,
+  get: function () { return chains.polygonAmoy; }
+});
+Object.defineProperty(exports, "sepolia", {
+  enumerable: true,
+  get: function () { return chains.sepolia; }
+});
+exports.ChainProvider = ChainProvider;
+exports.sha256Hash = sha256Hash;
+exports.sha256HashFile = sha256HashFile;
+exports.useSmartAccount = useSmartAccount;
+exports.useStoreOnChain = useStoreOnChain;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/providers/ChainProvider.jsx","../src/hooks/useSmartAccount.js","../src/hooks/useStoreOnChain.js","../src/utils/hash.js"],"names":["QueryClient","createConfig","http","React","PrivyProvider","QueryClientProvider","WagmiProvider","usePrivy","useWallets","useCreateWallet","useState","useRef","useCallback","createWalletClient","custom","createPublicClient","pimlico","createPimlicoClient","entryPoint07Address","toSimpleSmartAccount","createSmartAccountClient","useEffect","encodeFunctionData"],"mappings":"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","file":"index.cjs","sourcesContent":["import React from 'react'\nimport { PrivyProvider } from '@privy-io/react-auth'\nimport { WagmiProvider, createConfig } from '@privy-io/wagmi'\nimport { QueryClient, QueryClientProvider } from '@tanstack/react-query'\nimport { http } from 'viem'\n\nconst queryClient = new QueryClient({\n defaultOptions: {\n queries: {\n retry: 2,\n staleTime: 30_000,\n },\n },\n})\n\n/**\n * ChainProvider\n *\n * Wraps your app with all providers required for ERC-4337:\n * Privy (auth + embedded wallets) → QueryClient → Wagmi\n *\n * Put this at the ROOT of your app, outside your router.\n *\n * @param {object} props\n * @param {string} props.privyAppId — from dashboard.privy.io\n * @param {object} props.chain — viem chain (e.g. polygonAmoy)\n * @param {string} props.rpcUrl — your Alchemy/Infura RPC URL\n * @param {string[]} [props.loginMethods] — default: ['google', 'email']\n * @param {object} [props.appearance] — Privy modal theme config\n * @param {node} props.children\n *\n * @example\n * import { ChainProvider } from '@atharva/erc4337-kit'\n * import { polygonAmoy } from 'viem/chains'\n *\n * <ChainProvider\n * privyAppId={import.meta.env.VITE_PRIVY_APP_ID}\n * chain={polygonAmoy}\n * rpcUrl={import.meta.env.VITE_RPC_URL}\n * >\n * <App />\n * </ChainProvider>\n */\nexport function ChainProvider({\n privyAppId,\n chain,\n rpcUrl,\n loginMethods = ['google', 'email'],\n appearance = {},\n children,\n}) {\n const wagmiConfig = createConfig({\n chains: [chain],\n transports: {\n [chain.id]: http(rpcUrl),\n },\n })\n\n return (\n <PrivyProvider\n appId={privyAppId}\n config={{\n loginMethods,\n embeddedWallets: {\n // CRITICAL: this tells Privy to create a wallet for EVERY user\n // automatically on login. Without this, you'd have to call\n // createWallet() manually and handle the timing yourself.\n createOnLogin: 'all-users',\n },\n defaultChain: chain,\n supportedChains: [chain],\n appearance: {\n theme: 'light',\n accentColor: '#7c3aed',\n ...appearance,\n },\n }}\n >\n <QueryClientProvider client={queryClient}>\n <WagmiProvider config={wagmiConfig}>\n {children}\n </WagmiProvider>\n </QueryClientProvider>\n </PrivyProvider>\n )\n}\n","import { useState, useCallback, useRef, useEffect } from 'react'\nimport { usePrivy, useWallets, useCreateWallet } from '@privy-io/react-auth'\nimport { createPublicClient, createWalletClient, http, custom } from 'viem'\nimport { createSmartAccountClient } from 'permissionless'\nimport { toSimpleSmartAccount } from 'permissionless/accounts'\nimport { createPimlicoClient } from 'permissionless/clients/pimlico'\nimport { entryPoint07Address } from 'viem/account-abstraction'\n\n// Internal helper — builds the Pimlico endpoint URL from chain ID\nfunction buildPimlicoUrl(chainId, apiKey) {\n return `https://api.pimlico.io/v2/${chainId}/rpc?apikey=${apiKey}`\n}\n\n/**\n * useSmartAccount\n *\n * Manages ERC-4337 Smart Account creation and lifecycle.\n * Handles Privy auth, embedded wallet creation, and Pimlico setup.\n *\n * @param {object} config\n * @param {string} config.pimlicoApiKey — from dashboard.pimlico.io\n * @param {string} config.rpcUrl — Alchemy/Infura RPC for your chain\n * @param {object} config.chain — viem chain object (e.g. polygonAmoy)\n *\n * @returns {object} {\n * login, logout, authenticated, user,\n * smartAccountAddress,\n * smartAccountClient, ← use this to send transactions\n * pimlicoClient,\n * isReady, ← true when SA is initialized and ready\n * isLoading,\n * error\n * }\n */\nexport function useSmartAccount({ pimlicoApiKey, rpcUrl, chain }) {\n const { login, logout, authenticated, user, ready } = usePrivy()\n const { wallets } = useWallets()\n const { createWallet } = useCreateWallet()\n\n const [smartAccountAddress, setSmartAccountAddress] = useState(null)\n const [smartAccountClient, setSmartAccountClient] = useState(null)\n const [pimlicoClient, setPimlicoClient] = useState(null)\n const [isLoading, setIsLoading] = useState(false)\n const [error, setError] = useState(null)\n\n // Refs to prevent duplicate initialization — same pattern as your ProofChain\n const initCalledRef = useRef(false)\n const walletCreationAttempted = useRef(false)\n\n const pimlicoUrl = buildPimlicoUrl(chain.id, pimlicoApiKey)\n\n const initSmartAccount = useCallback(async () => {\n // Guard: only proceed when Privy is fully ready and user is logged in\n if (!authenticated || !ready) return\n\n // If no wallet yet, try to create one (Privy sometimes needs a nudge)\n if (!wallets || wallets.length === 0) {\n if (!walletCreationAttempted.current) {\n walletCreationAttempted.current = true\n try {\n await createWallet()\n // Don't continue here — wait for next effect run after wallet appears\n return\n } catch (err) {\n // 'already has' means the wallet exists but wasn't in state yet — safe to ignore\n if (!err.message?.includes('already has')) {\n setError('Failed to create embedded wallet: ' + err.message)\n }\n return\n }\n }\n return\n }\n\n // Guard: don't initialize twice\n if (initCalledRef.current) return\n initCalledRef.current = true\n\n setIsLoading(true)\n setError(null)\n\n try {\n const wallet = wallets[0]\n\n // Switch to the configured chain before doing anything\n await wallet.switchChain(chain.id)\n\n const provider = await wallet.getEthereumProvider()\n\n // Wallet client signs UserOperations using the embedded wallet\n const walletClient = createWalletClient({\n account: wallet.address,\n chain,\n transport: custom(provider),\n })\n\n // Public client reads from chain (balance, contract state, etc.)\n const publicClient = createPublicClient({\n chain,\n transport: http(rpcUrl),\n })\n\n // Pimlico client handles bundling + gas sponsorship\n const pimlico = createPimlicoClient({\n transport: http(pimlicoUrl),\n entryPoint: {\n address: entryPoint07Address,\n version: '0.7',\n },\n })\n\n // SimpleSmartAccount: the simplest ERC-4337 account type\n // deterministic address — same owner always gets same SA address\n const smartAccount = await toSimpleSmartAccount({\n client: publicClient,\n owner: walletClient,\n entryPoint: {\n address: entryPoint07Address,\n version: '0.7',\n },\n })\n\n // SmartAccountClient: the object you use to send transactions\n // It automatically builds UserOperations, gets gas estimates,\n // requests paymaster sponsorship, and submits to the bundler\n const client = createSmartAccountClient({\n account: smartAccount,\n chain,\n bundlerTransport: http(pimlicoUrl),\n paymaster: pimlico,\n // userOperation config: tell Pimlico to sponsor everything\n userOperation: {\n estimateFeesPerGas: async () => {\n const fees = await pimlico.getUserOperationGasPrice()\n return fees.fast\n },\n },\n })\n\n setPimlicoClient(pimlico)\n setSmartAccountClient(client)\n setSmartAccountAddress(smartAccount.address)\n\n } catch (err) {\n console.error('[erc4337-kit] Smart account init failed:', err)\n setError(err.message || 'Failed to initialize smart account')\n // Reset so the user can retry\n initCalledRef.current = false\n } finally {\n setIsLoading(false)\n }\n }, [authenticated, wallets, ready, createWallet, chain, rpcUrl, pimlicoUrl])\n\n useEffect(() => {\n initSmartAccount()\n }, [initSmartAccount])\n\n const handleLogout = useCallback(async () => {\n await logout()\n // Full reset so next login starts fresh\n initCalledRef.current = false\n walletCreationAttempted.current = false\n setSmartAccountAddress(null)\n setSmartAccountClient(null)\n setPimlicoClient(null)\n setError(null)\n }, [logout])\n\n return {\n login,\n logout: handleLogout,\n authenticated,\n user,\n smartAccountAddress,\n smartAccountClient,\n pimlicoClient,\n isReady: !!smartAccountClient && !!smartAccountAddress,\n isLoading,\n error,\n }\n}\n","import { useState, useCallback } from 'react'\nimport { encodeFunctionData } from 'viem'\n\n/**\n * useStoreOnChain\n *\n * Generic hook to call any write function on any contract\n * via ERC-4337 gasless UserOperation.\n *\n * @param {object} params\n * @param {object} params.smartAccountClient — from useSmartAccount()\n * @param {string} params.contractAddress — deployed contract address\n * @param {array} params.abi — contract ABI (just the functions you need)\n * @param {string} params.functionName — which function to call\n *\n * @returns {object} {\n * submit(args), ← call this with your function arguments as an array\n * txHash,\n * recordId, ← decoded from logs if contract returns bytes32\n * isLoading,\n * isSuccess,\n * error,\n * reset\n * }\n *\n * @example\n * const { submit, txHash, isLoading } = useStoreOnChain({\n * smartAccountClient,\n * contractAddress: '0x...',\n * abi: incidentABI,\n * functionName: 'storeRecord',\n * })\n *\n * // In your handler:\n * await submit([dataHash])\n */\nexport function useStoreOnChain({\n smartAccountClient,\n contractAddress,\n abi,\n functionName,\n}) {\n const [txHash, setTxHash] = useState(null)\n const [recordId, setRecordId] = useState(null)\n const [isLoading, setIsLoading] = useState(false)\n const [isSuccess, setIsSuccess] = useState(false)\n const [error, setError] = useState(null)\n\n const submit = useCallback(\n async (args = []) => {\n // Guard: smartAccountClient must exist (user must be logged in)\n if (!smartAccountClient) {\n setError('Smart account not initialized. Make sure user is logged in.')\n return null\n }\n\n setIsLoading(true)\n setIsSuccess(false)\n setError(null)\n setTxHash(null)\n setRecordId(null)\n\n try {\n // encodeFunctionData turns your ABI + args into the raw calldata bytes\n // that the smart account will call on the target contract\n const calldata = encodeFunctionData({\n abi,\n functionName,\n args,\n })\n\n // sendTransaction on a SmartAccountClient works differently than a normal\n // wallet tx. Under the hood it:\n // 1. Builds a UserOperation\n // 2. Estimates gas (callGasLimit, verificationGasLimit, preVerificationGas)\n // 3. Calls your paymaster (Pimlico) for sponsorship\n // 4. Signs the UserOperation with the embedded wallet\n // 5. Sends it to the Pimlico bundler\n // 6. Returns the tx hash once the bundler accepts it\n //\n // The tx hash here is the ACTUAL on-chain tx hash, not the UserOp hash.\n const hash = await smartAccountClient.sendTransaction({\n to: contractAddress,\n data: calldata,\n value: 0n, // no ETH/MATIC sent — this is just a contract call\n })\n\n setTxHash(hash)\n setIsSuccess(true)\n\n // Try to extract the returned bytes32 record ID from the receipt logs\n // This is specific to BaseStorage.sol which emits RecordStored(id, ...)\n try {\n const receipt = await smartAccountClient.waitForTransactionReceipt({ hash })\n const firstLog = receipt.logs?.[0]\n if (firstLog?.topics?.[1]) {\n setRecordId(firstLog.topics[1])\n }\n } catch {\n // Log parsing failing is not a fatal error — tx already succeeded\n }\n\n return hash\n\n } catch (err) {\n const message = parseError(err)\n setError(message)\n console.error('[erc4337-kit] Transaction failed:', err)\n return null\n } finally {\n setIsLoading(false)\n }\n },\n [smartAccountClient, contractAddress, abi, functionName]\n )\n\n const reset = useCallback(() => {\n setTxHash(null)\n setRecordId(null)\n setIsLoading(false)\n setIsSuccess(false)\n setError(null)\n }, [])\n\n return {\n submit,\n txHash,\n recordId,\n isLoading,\n isSuccess,\n error,\n reset,\n }\n}\n\n// -----------------------------------------------------------------\n// Internal: parse common ERC-4337 / Pimlico errors into human messages\n// These are the exact errors you hit during ProofChain development\n// -----------------------------------------------------------------\nfunction parseError(err) {\n const msg = err?.message || err?.toString() || 'Unknown error'\n\n if (msg.includes('AA21')) {\n return 'Paymaster rejected: your Pimlico API key may be invalid or the policy does not cover this chain.'\n }\n if (msg.includes('AA31')) {\n return 'Paymaster out of funds. Check your Pimlico dashboard deposit balance.'\n }\n if (msg.includes('AA23') || msg.includes('invalid signature')) {\n return 'Wallet signature failed. Try logging out and back in.'\n }\n if (msg.includes('gas') && msg.includes('too low')) {\n return 'Gas estimate too low. The contract function may be too expensive for the paymaster policy.'\n }\n if (msg.includes('nonce')) {\n return 'Nonce error. A previous transaction may still be pending — wait a moment and retry.'\n }\n if (msg.includes('user rejected') || msg.includes('User rejected')) {\n return 'Transaction was cancelled.'\n }\n if (msg.includes('fetch') || msg.includes('network')) {\n return 'Network error. Check your RPC URL and Pimlico API key.'\n }\n\n return msg\n}\n","/**\r\n * SHA-256 hashing utilities for client-side data hashing\r\n * \r\n * These functions hash data BEFORE sending to blockchain,\r\n * preserving privacy while creating tamper-proof proofs.\r\n */\r\n\r\n/**\r\n * Hash a string using SHA-256\r\n * \r\n * @param {string} text - The text to hash\r\n * @returns {Promise<string>} - Hex-encoded hash with 0x prefix\r\n * \r\n * @example\r\n * const hash = await sha256Hash(\"my secret data\")\r\n * // Returns: \"0x2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae\"\r\n */\r\nexport async function sha256Hash(text) {\r\n if (typeof text !== 'string') {\r\n throw new Error('sha256Hash: input must be a string')\r\n }\r\n\r\n const encoded = new TextEncoder().encode(text)\r\n const hashBuffer = await crypto.subtle.digest('SHA-256', encoded)\r\n const hashArray = Array.from(new Uint8Array(hashBuffer))\r\n return '0x' + hashArray.map(b => b.toString(16).padStart(2, '0')).join('')\r\n}\r\n\r\n/**\r\n * Hash a File object using SHA-256\r\n * \r\n * @param {File} file - The file to hash\r\n * @returns {Promise<string>} - Hex-encoded hash with 0x prefix\r\n * \r\n * @example\r\n * const fileInput = document.querySelector('input[type=\"file\"]')\r\n * const file = fileInput.files[0]\r\n * const hash = await sha256HashFile(file)\r\n */\r\nexport async function sha256HashFile(file) {\r\n if (!(file instanceof File)) {\r\n throw new Error('sha256HashFile: input must be a File object')\r\n }\r\n\r\n const arrayBuffer = await file.arrayBuffer()\r\n const hashBuffer = await crypto.subtle.digest('SHA-256', arrayBuffer)\r\n const hashArray = Array.from(new Uint8Array(hashBuffer))\r\n return '0x' + hashArray.map(b => b.toString(16).padStart(2, '0')).join('')\r\n}\r\n"]}

package/dist/index.js ADDED Viewed

@@ -0,0 +1,295 @@
+import React, { useState, useRef, useCallback, useEffect } from 'react';
+import { PrivyProvider, usePrivy, useWallets, useCreateWallet } from '@privy-io/react-auth';
+import { createConfig, WagmiProvider } from '@privy-io/wagmi';
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { http, createWalletClient, custom, createPublicClient, encodeFunctionData } from 'viem';
+import { createSmartAccountClient } from 'permissionless';
+import { toSimpleSmartAccount } from 'permissionless/accounts';
+import { createPimlicoClient } from 'permissionless/clients/pimlico';
+import { entryPoint07Address } from 'viem/account-abstraction';
+export { baseSepolia, polygon, polygonAmoy, sepolia } from 'viem/chains';
+// src/providers/ChainProvider.jsx
+var queryClient = new QueryClient({
+  defaultOptions: {
+    queries: {
+      retry: 2,
+      staleTime: 3e4
+    }
+  }
+});
+function ChainProvider({
+  privyAppId,
+  chain,
+  rpcUrl,
+  loginMethods = ["google", "email"],
+  appearance = {},
+  children
+}) {
+  const wagmiConfig = createConfig({
+    chains: [chain],
+    transports: {
+      [chain.id]: http(rpcUrl)
+    }
+  });
+  return /* @__PURE__ */ React.createElement(
+    PrivyProvider,
+    {
+      appId: privyAppId,
+      config: {
+        loginMethods,
+        embeddedWallets: {
+          // CRITICAL: this tells Privy to create a wallet for EVERY user
+          // automatically on login. Without this, you'd have to call
+          // createWallet() manually and handle the timing yourself.
+          createOnLogin: "all-users"
+        },
+        defaultChain: chain,
+        supportedChains: [chain],
+        appearance: {
+          theme: "light",
+          accentColor: "#7c3aed",
+          ...appearance
+        }
+      }
+    },
+    /* @__PURE__ */ React.createElement(QueryClientProvider, { client: queryClient }, /* @__PURE__ */ React.createElement(WagmiProvider, { config: wagmiConfig }, children))
+  );
+}
+function buildPimlicoUrl(chainId, apiKey) {
+  return `https://api.pimlico.io/v2/${chainId}/rpc?apikey=${apiKey}`;
+}
+function useSmartAccount({ pimlicoApiKey, rpcUrl, chain }) {
+  const { login, logout, authenticated, user, ready } = usePrivy();
+  const { wallets } = useWallets();
+  const { createWallet } = useCreateWallet();
+  const [smartAccountAddress, setSmartAccountAddress] = useState(null);
+  const [smartAccountClient, setSmartAccountClient] = useState(null);
+  const [pimlicoClient, setPimlicoClient] = useState(null);
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const initCalledRef = useRef(false);
+  const walletCreationAttempted = useRef(false);
+  const pimlicoUrl = buildPimlicoUrl(chain.id, pimlicoApiKey);
+  const initSmartAccount = useCallback(async () => {
+    var _a;
+    if (!authenticated || !ready) return;
+    if (!wallets || wallets.length === 0) {
+      if (!walletCreationAttempted.current) {
+        walletCreationAttempted.current = true;
+        try {
+          await createWallet();
+          return;
+        } catch (err) {
+          if (!((_a = err.message) == null ? void 0 : _a.includes("already has"))) {
+            setError("Failed to create embedded wallet: " + err.message);
+          }
+          return;
+        }
+      }
+      return;
+    }
+    if (initCalledRef.current) return;
+    initCalledRef.current = true;
+    setIsLoading(true);
+    setError(null);
+    try {
+      const wallet = wallets[0];
+      await wallet.switchChain(chain.id);
+      const provider = await wallet.getEthereumProvider();
+      const walletClient = createWalletClient({
+        account: wallet.address,
+        chain,
+        transport: custom(provider)
+      });
+      const publicClient = createPublicClient({
+        chain,
+        transport: http(rpcUrl)
+      });
+      const pimlico = createPimlicoClient({
+        transport: http(pimlicoUrl),
+        entryPoint: {
+          address: entryPoint07Address,
+          version: "0.7"
+        }
+      });
+      const smartAccount = await toSimpleSmartAccount({
+        client: publicClient,
+        owner: walletClient,
+        entryPoint: {
+          address: entryPoint07Address,
+          version: "0.7"
+        }
+      });
+      const client = createSmartAccountClient({
+        account: smartAccount,
+        chain,
+        bundlerTransport: http(pimlicoUrl),
+        paymaster: pimlico,
+        // userOperation config: tell Pimlico to sponsor everything
+        userOperation: {
+          estimateFeesPerGas: async () => {
+            const fees = await pimlico.getUserOperationGasPrice();
+            return fees.fast;
+          }
+        }
+      });
+      setPimlicoClient(pimlico);
+      setSmartAccountClient(client);
+      setSmartAccountAddress(smartAccount.address);
+    } catch (err) {
+      console.error("[erc4337-kit] Smart account init failed:", err);
+      setError(err.message || "Failed to initialize smart account");
+      initCalledRef.current = false;
+    } finally {
+      setIsLoading(false);
+    }
+  }, [authenticated, wallets, ready, createWallet, chain, rpcUrl, pimlicoUrl]);
+  useEffect(() => {
+    initSmartAccount();
+  }, [initSmartAccount]);
+  const handleLogout = useCallback(async () => {
+    await logout();
+    initCalledRef.current = false;
+    walletCreationAttempted.current = false;
+    setSmartAccountAddress(null);
+    setSmartAccountClient(null);
+    setPimlicoClient(null);
+    setError(null);
+  }, [logout]);
+  return {
+    login,
+    logout: handleLogout,
+    authenticated,
+    user,
+    smartAccountAddress,
+    smartAccountClient,
+    pimlicoClient,
+    isReady: !!smartAccountClient && !!smartAccountAddress,
+    isLoading,
+    error
+  };
+}
+function useStoreOnChain({
+  smartAccountClient,
+  contractAddress,
+  abi,
+  functionName
+}) {
+  const [txHash, setTxHash] = useState(null);
+  const [recordId, setRecordId] = useState(null);
+  const [isLoading, setIsLoading] = useState(false);
+  const [isSuccess, setIsSuccess] = useState(false);
+  const [error, setError] = useState(null);
+  const submit = useCallback(
+    async (args = []) => {
+      var _a, _b;
+      if (!smartAccountClient) {
+        setError("Smart account not initialized. Make sure user is logged in.");
+        return null;
+      }
+      setIsLoading(true);
+      setIsSuccess(false);
+      setError(null);
+      setTxHash(null);
+      setRecordId(null);
+      try {
+        const calldata = encodeFunctionData({
+          abi,
+          functionName,
+          args
+        });
+        const hash = await smartAccountClient.sendTransaction({
+          to: contractAddress,
+          data: calldata,
+          value: 0n
+          // no ETH/MATIC sent — this is just a contract call
+        });
+        setTxHash(hash);
+        setIsSuccess(true);
+        try {
+          const receipt = await smartAccountClient.waitForTransactionReceipt({ hash });
+          const firstLog = (_a = receipt.logs) == null ? void 0 : _a[0];
+          if ((_b = firstLog == null ? void 0 : firstLog.topics) == null ? void 0 : _b[1]) {
+            setRecordId(firstLog.topics[1]);
+          }
+        } catch {
+        }
+        return hash;
+      } catch (err) {
+        const message = parseError(err);
+        setError(message);
+        console.error("[erc4337-kit] Transaction failed:", err);
+        return null;
+      } finally {
+        setIsLoading(false);
+      }
+    },
+    [smartAccountClient, contractAddress, abi, functionName]
+  );
+  const reset = useCallback(() => {
+    setTxHash(null);
+    setRecordId(null);
+    setIsLoading(false);
+    setIsSuccess(false);
+    setError(null);
+  }, []);
+  return {
+    submit,
+    txHash,
+    recordId,
+    isLoading,
+    isSuccess,
+    error,
+    reset
+  };
+}
+function parseError(err) {
+  const msg = (err == null ? void 0 : err.message) || (err == null ? void 0 : err.toString()) || "Unknown error";
+  if (msg.includes("AA21")) {
+    return "Paymaster rejected: your Pimlico API key may be invalid or the policy does not cover this chain.";
+  }
+  if (msg.includes("AA31")) {
+    return "Paymaster out of funds. Check your Pimlico dashboard deposit balance.";
+  }
+  if (msg.includes("AA23") || msg.includes("invalid signature")) {
+    return "Wallet signature failed. Try logging out and back in.";
+  }
+  if (msg.includes("gas") && msg.includes("too low")) {
+    return "Gas estimate too low. The contract function may be too expensive for the paymaster policy.";
+  }
+  if (msg.includes("nonce")) {
+    return "Nonce error. A previous transaction may still be pending \u2014 wait a moment and retry.";
+  }
+  if (msg.includes("user rejected") || msg.includes("User rejected")) {
+    return "Transaction was cancelled.";
+  }
+  if (msg.includes("fetch") || msg.includes("network")) {
+    return "Network error. Check your RPC URL and Pimlico API key.";
+  }
+  return msg;
+}
+// src/utils/hash.js
+async function sha256Hash(text) {
+  if (typeof text !== "string") {
+    throw new Error("sha256Hash: input must be a string");
+  }
+  const encoded = new TextEncoder().encode(text);
+  const hashBuffer = await crypto.subtle.digest("SHA-256", encoded);
+  const hashArray = Array.from(new Uint8Array(hashBuffer));
+  return "0x" + hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+async function sha256HashFile(file) {
+  if (!(file instanceof File)) {
+    throw new Error("sha256HashFile: input must be a File object");
+  }
+  const arrayBuffer = await file.arrayBuffer();
+  const hashBuffer = await crypto.subtle.digest("SHA-256", arrayBuffer);
+  const hashArray = Array.from(new Uint8Array(hashBuffer));
+  return "0x" + hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+export { ChainProvider, sha256Hash, sha256HashFile, useSmartAccount, useStoreOnChain };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/providers/ChainProvider.jsx","../src/hooks/useSmartAccount.js","../src/hooks/useStoreOnChain.js","../src/utils/hash.js"],"names":["http","useState","useCallback"],"mappings":"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","file":"index.js","sourcesContent":["import React from 'react'\nimport { PrivyProvider } from '@privy-io/react-auth'\nimport { WagmiProvider, createConfig } from '@privy-io/wagmi'\nimport { QueryClient, QueryClientProvider } from '@tanstack/react-query'\nimport { http } from 'viem'\n\nconst queryClient = new QueryClient({\n defaultOptions: {\n queries: {\n retry: 2,\n staleTime: 30_000,\n },\n },\n})\n\n/**\n * ChainProvider\n *\n * Wraps your app with all providers required for ERC-4337:\n * Privy (auth + embedded wallets) → QueryClient → Wagmi\n *\n * Put this at the ROOT of your app, outside your router.\n *\n * @param {object} props\n * @param {string} props.privyAppId — from dashboard.privy.io\n * @param {object} props.chain — viem chain (e.g. polygonAmoy)\n * @param {string} props.rpcUrl — your Alchemy/Infura RPC URL\n * @param {string[]} [props.loginMethods] — default: ['google', 'email']\n * @param {object} [props.appearance] — Privy modal theme config\n * @param {node} props.children\n *\n * @example\n * import { ChainProvider } from '@atharva/erc4337-kit'\n * import { polygonAmoy } from 'viem/chains'\n *\n * <ChainProvider\n * privyAppId={import.meta.env.VITE_PRIVY_APP_ID}\n * chain={polygonAmoy}\n * rpcUrl={import.meta.env.VITE_RPC_URL}\n * >\n * <App />\n * </ChainProvider>\n */\nexport function ChainProvider({\n privyAppId,\n chain,\n rpcUrl,\n loginMethods = ['google', 'email'],\n appearance = {},\n children,\n}) {\n const wagmiConfig = createConfig({\n chains: [chain],\n transports: {\n [chain.id]: http(rpcUrl),\n },\n })\n\n return (\n <PrivyProvider\n appId={privyAppId}\n config={{\n loginMethods,\n embeddedWallets: {\n // CRITICAL: this tells Privy to create a wallet for EVERY user\n // automatically on login. Without this, you'd have to call\n // createWallet() manually and handle the timing yourself.\n createOnLogin: 'all-users',\n },\n defaultChain: chain,\n supportedChains: [chain],\n appearance: {\n theme: 'light',\n accentColor: '#7c3aed',\n ...appearance,\n },\n }}\n >\n <QueryClientProvider client={queryClient}>\n <WagmiProvider config={wagmiConfig}>\n {children}\n </WagmiProvider>\n </QueryClientProvider>\n </PrivyProvider>\n )\n}\n","import { useState, useCallback, useRef, useEffect } from 'react'\nimport { usePrivy, useWallets, useCreateWallet } from '@privy-io/react-auth'\nimport { createPublicClient, createWalletClient, http, custom } from 'viem'\nimport { createSmartAccountClient } from 'permissionless'\nimport { toSimpleSmartAccount } from 'permissionless/accounts'\nimport { createPimlicoClient } from 'permissionless/clients/pimlico'\nimport { entryPoint07Address } from 'viem/account-abstraction'\n\n// Internal helper — builds the Pimlico endpoint URL from chain ID\nfunction buildPimlicoUrl(chainId, apiKey) {\n return `https://api.pimlico.io/v2/${chainId}/rpc?apikey=${apiKey}`\n}\n\n/**\n * useSmartAccount\n *\n * Manages ERC-4337 Smart Account creation and lifecycle.\n * Handles Privy auth, embedded wallet creation, and Pimlico setup.\n *\n * @param {object} config\n * @param {string} config.pimlicoApiKey — from dashboard.pimlico.io\n * @param {string} config.rpcUrl — Alchemy/Infura RPC for your chain\n * @param {object} config.chain — viem chain object (e.g. polygonAmoy)\n *\n * @returns {object} {\n * login, logout, authenticated, user,\n * smartAccountAddress,\n * smartAccountClient, ← use this to send transactions\n * pimlicoClient,\n * isReady, ← true when SA is initialized and ready\n * isLoading,\n * error\n * }\n */\nexport function useSmartAccount({ pimlicoApiKey, rpcUrl, chain }) {\n const { login, logout, authenticated, user, ready } = usePrivy()\n const { wallets } = useWallets()\n const { createWallet } = useCreateWallet()\n\n const [smartAccountAddress, setSmartAccountAddress] = useState(null)\n const [smartAccountClient, setSmartAccountClient] = useState(null)\n const [pimlicoClient, setPimlicoClient] = useState(null)\n const [isLoading, setIsLoading] = useState(false)\n const [error, setError] = useState(null)\n\n // Refs to prevent duplicate initialization — same pattern as your ProofChain\n const initCalledRef = useRef(false)\n const walletCreationAttempted = useRef(false)\n\n const pimlicoUrl = buildPimlicoUrl(chain.id, pimlicoApiKey)\n\n const initSmartAccount = useCallback(async () => {\n // Guard: only proceed when Privy is fully ready and user is logged in\n if (!authenticated || !ready) return\n\n // If no wallet yet, try to create one (Privy sometimes needs a nudge)\n if (!wallets || wallets.length === 0) {\n if (!walletCreationAttempted.current) {\n walletCreationAttempted.current = true\n try {\n await createWallet()\n // Don't continue here — wait for next effect run after wallet appears\n return\n } catch (err) {\n // 'already has' means the wallet exists but wasn't in state yet — safe to ignore\n if (!err.message?.includes('already has')) {\n setError('Failed to create embedded wallet: ' + err.message)\n }\n return\n }\n }\n return\n }\n\n // Guard: don't initialize twice\n if (initCalledRef.current) return\n initCalledRef.current = true\n\n setIsLoading(true)\n setError(null)\n\n try {\n const wallet = wallets[0]\n\n // Switch to the configured chain before doing anything\n await wallet.switchChain(chain.id)\n\n const provider = await wallet.getEthereumProvider()\n\n // Wallet client signs UserOperations using the embedded wallet\n const walletClient = createWalletClient({\n account: wallet.address,\n chain,\n transport: custom(provider),\n })\n\n // Public client reads from chain (balance, contract state, etc.)\n const publicClient = createPublicClient({\n chain,\n transport: http(rpcUrl),\n })\n\n // Pimlico client handles bundling + gas sponsorship\n const pimlico = createPimlicoClient({\n transport: http(pimlicoUrl),\n entryPoint: {\n address: entryPoint07Address,\n version: '0.7',\n },\n })\n\n // SimpleSmartAccount: the simplest ERC-4337 account type\n // deterministic address — same owner always gets same SA address\n const smartAccount = await toSimpleSmartAccount({\n client: publicClient,\n owner: walletClient,\n entryPoint: {\n address: entryPoint07Address,\n version: '0.7',\n },\n })\n\n // SmartAccountClient: the object you use to send transactions\n // It automatically builds UserOperations, gets gas estimates,\n // requests paymaster sponsorship, and submits to the bundler\n const client = createSmartAccountClient({\n account: smartAccount,\n chain,\n bundlerTransport: http(pimlicoUrl),\n paymaster: pimlico,\n // userOperation config: tell Pimlico to sponsor everything\n userOperation: {\n estimateFeesPerGas: async () => {\n const fees = await pimlico.getUserOperationGasPrice()\n return fees.fast\n },\n },\n })\n\n setPimlicoClient(pimlico)\n setSmartAccountClient(client)\n setSmartAccountAddress(smartAccount.address)\n\n } catch (err) {\n console.error('[erc4337-kit] Smart account init failed:', err)\n setError(err.message || 'Failed to initialize smart account')\n // Reset so the user can retry\n initCalledRef.current = false\n } finally {\n setIsLoading(false)\n }\n }, [authenticated, wallets, ready, createWallet, chain, rpcUrl, pimlicoUrl])\n\n useEffect(() => {\n initSmartAccount()\n }, [initSmartAccount])\n\n const handleLogout = useCallback(async () => {\n await logout()\n // Full reset so next login starts fresh\n initCalledRef.current = false\n walletCreationAttempted.current = false\n setSmartAccountAddress(null)\n setSmartAccountClient(null)\n setPimlicoClient(null)\n setError(null)\n }, [logout])\n\n return {\n login,\n logout: handleLogout,\n authenticated,\n user,\n smartAccountAddress,\n smartAccountClient,\n pimlicoClient,\n isReady: !!smartAccountClient && !!smartAccountAddress,\n isLoading,\n error,\n }\n}\n","import { useState, useCallback } from 'react'\nimport { encodeFunctionData } from 'viem'\n\n/**\n * useStoreOnChain\n *\n * Generic hook to call any write function on any contract\n * via ERC-4337 gasless UserOperation.\n *\n * @param {object} params\n * @param {object} params.smartAccountClient — from useSmartAccount()\n * @param {string} params.contractAddress — deployed contract address\n * @param {array} params.abi — contract ABI (just the functions you need)\n * @param {string} params.functionName — which function to call\n *\n * @returns {object} {\n * submit(args), ← call this with your function arguments as an array\n * txHash,\n * recordId, ← decoded from logs if contract returns bytes32\n * isLoading,\n * isSuccess,\n * error,\n * reset\n * }\n *\n * @example\n * const { submit, txHash, isLoading } = useStoreOnChain({\n * smartAccountClient,\n * contractAddress: '0x...',\n * abi: incidentABI,\n * functionName: 'storeRecord',\n * })\n *\n * // In your handler:\n * await submit([dataHash])\n */\nexport function useStoreOnChain({\n smartAccountClient,\n contractAddress,\n abi,\n functionName,\n}) {\n const [txHash, setTxHash] = useState(null)\n const [recordId, setRecordId] = useState(null)\n const [isLoading, setIsLoading] = useState(false)\n const [isSuccess, setIsSuccess] = useState(false)\n const [error, setError] = useState(null)\n\n const submit = useCallback(\n async (args = []) => {\n // Guard: smartAccountClient must exist (user must be logged in)\n if (!smartAccountClient) {\n setError('Smart account not initialized. Make sure user is logged in.')\n return null\n }\n\n setIsLoading(true)\n setIsSuccess(false)\n setError(null)\n setTxHash(null)\n setRecordId(null)\n\n try {\n // encodeFunctionData turns your ABI + args into the raw calldata bytes\n // that the smart account will call on the target contract\n const calldata = encodeFunctionData({\n abi,\n functionName,\n args,\n })\n\n // sendTransaction on a SmartAccountClient works differently than a normal\n // wallet tx. Under the hood it:\n // 1. Builds a UserOperation\n // 2. Estimates gas (callGasLimit, verificationGasLimit, preVerificationGas)\n // 3. Calls your paymaster (Pimlico) for sponsorship\n // 4. Signs the UserOperation with the embedded wallet\n // 5. Sends it to the Pimlico bundler\n // 6. Returns the tx hash once the bundler accepts it\n //\n // The tx hash here is the ACTUAL on-chain tx hash, not the UserOp hash.\n const hash = await smartAccountClient.sendTransaction({\n to: contractAddress,\n data: calldata,\n value: 0n, // no ETH/MATIC sent — this is just a contract call\n })\n\n setTxHash(hash)\n setIsSuccess(true)\n\n // Try to extract the returned bytes32 record ID from the receipt logs\n // This is specific to BaseStorage.sol which emits RecordStored(id, ...)\n try {\n const receipt = await smartAccountClient.waitForTransactionReceipt({ hash })\n const firstLog = receipt.logs?.[0]\n if (firstLog?.topics?.[1]) {\n setRecordId(firstLog.topics[1])\n }\n } catch {\n // Log parsing failing is not a fatal error — tx already succeeded\n }\n\n return hash\n\n } catch (err) {\n const message = parseError(err)\n setError(message)\n console.error('[erc4337-kit] Transaction failed:', err)\n return null\n } finally {\n setIsLoading(false)\n }\n },\n [smartAccountClient, contractAddress, abi, functionName]\n )\n\n const reset = useCallback(() => {\n setTxHash(null)\n setRecordId(null)\n setIsLoading(false)\n setIsSuccess(false)\n setError(null)\n }, [])\n\n return {\n submit,\n txHash,\n recordId,\n isLoading,\n isSuccess,\n error,\n reset,\n }\n}\n\n// -----------------------------------------------------------------\n// Internal: parse common ERC-4337 / Pimlico errors into human messages\n// These are the exact errors you hit during ProofChain development\n// -----------------------------------------------------------------\nfunction parseError(err) {\n const msg = err?.message || err?.toString() || 'Unknown error'\n\n if (msg.includes('AA21')) {\n return 'Paymaster rejected: your Pimlico API key may be invalid or the policy does not cover this chain.'\n }\n if (msg.includes('AA31')) {\n return 'Paymaster out of funds. Check your Pimlico dashboard deposit balance.'\n }\n if (msg.includes('AA23') || msg.includes('invalid signature')) {\n return 'Wallet signature failed. Try logging out and back in.'\n }\n if (msg.includes('gas') && msg.includes('too low')) {\n return 'Gas estimate too low. The contract function may be too expensive for the paymaster policy.'\n }\n if (msg.includes('nonce')) {\n return 'Nonce error. A previous transaction may still be pending — wait a moment and retry.'\n }\n if (msg.includes('user rejected') || msg.includes('User rejected')) {\n return 'Transaction was cancelled.'\n }\n if (msg.includes('fetch') || msg.includes('network')) {\n return 'Network error. Check your RPC URL and Pimlico API key.'\n }\n\n return msg\n}\n","/**\r\n * SHA-256 hashing utilities for client-side data hashing\r\n * \r\n * These functions hash data BEFORE sending to blockchain,\r\n * preserving privacy while creating tamper-proof proofs.\r\n */\r\n\r\n/**\r\n * Hash a string using SHA-256\r\n * \r\n * @param {string} text - The text to hash\r\n * @returns {Promise<string>} - Hex-encoded hash with 0x prefix\r\n * \r\n * @example\r\n * const hash = await sha256Hash(\"my secret data\")\r\n * // Returns: \"0x2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae\"\r\n */\r\nexport async function sha256Hash(text) {\r\n if (typeof text !== 'string') {\r\n throw new Error('sha256Hash: input must be a string')\r\n }\r\n\r\n const encoded = new TextEncoder().encode(text)\r\n const hashBuffer = await crypto.subtle.digest('SHA-256', encoded)\r\n const hashArray = Array.from(new Uint8Array(hashBuffer))\r\n return '0x' + hashArray.map(b => b.toString(16).padStart(2, '0')).join('')\r\n}\r\n\r\n/**\r\n * Hash a File object using SHA-256\r\n * \r\n * @param {File} file - The file to hash\r\n * @returns {Promise<string>} - Hex-encoded hash with 0x prefix\r\n * \r\n * @example\r\n * const fileInput = document.querySelector('input[type=\"file\"]')\r\n * const file = fileInput.files[0]\r\n * const hash = await sha256HashFile(file)\r\n */\r\nexport async function sha256HashFile(file) {\r\n if (!(file instanceof File)) {\r\n throw new Error('sha256HashFile: input must be a File object')\r\n }\r\n\r\n const arrayBuffer = await file.arrayBuffer()\r\n const hashBuffer = await crypto.subtle.digest('SHA-256', arrayBuffer)\r\n const hashArray = Array.from(new Uint8Array(hashBuffer))\r\n return '0x' + hashArray.map(b => b.toString(16).padStart(2, '0')).join('')\r\n}\r\n"]}

package/package.json ADDED Viewed

@@ -0,0 +1,67 @@
+{
+  "name": "erc4337-kit",
+  "version": "0.1.0",
+  "description": "Plug-and-play ERC-4337 Account Abstraction for React apps. Gasless txs, social login, smart accounts — without the complexity.",
+  "author": "Atharva Baodhankar",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/op_athu_17/erc4337-kit"
+  },
+  "keywords": [
+    "erc4337",
+    "account-abstraction",
+    "gasless",
+    "privy",
+    "pimlico",
+    "polygon",
+    "web3",
+    "react",
+    "smart-account",
+    "userops"
+  ],
+  "type": "module",
+  "main":    "./dist/index.cjs",
+  "module":  "./dist/index.js",
+  "exports": {
+    ".": {
+      "types":   "./dist/index.d.ts",
+      "import":  "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src/contracts/BaseStorage.sol",
+    "README.md"
+  ],
+  "scripts": {
+    "build":   "tsup",
+    "dev":     "tsup --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "react":               ">=18.0.0",
+    "react-dom":           ">=18.0.0",
+    "@privy-io/react-auth":">=3.0.0",
+    "@privy-io/wagmi":     ">=4.0.0",
+    "viem":                ">=2.0.0",
+    "wagmi":               ">=3.0.0",
+    "@tanstack/react-query":">=5.0.0"
+  },
+  "dependencies": {
+    "permissionless": "^0.3.4"
+  },
+  "devDependencies": {
+    "tsup":       "^8.0.0",
+    "react":      "^18.2.0",
+    "react-dom":  "^18.2.0",
+    "typescript": "^5.0.0"
+  }
+}

package/src/contracts/BaseStorage.sol ADDED Viewed

@@ -0,0 +1,221 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.20;
+// =============================================================
+//  ERC-4337 BASE STORAGE CONTRACT — erc4337-kit
+//  Copy this file, rename the contract, change the struct.
+//  DO NOT remove or change anything marked [ERC-4337 RULE].
+// =============================================================
+//
+//  WHAT THIS CONTRACT DOES:
+//  Stores a SHA-256 hash of your data permanently on-chain.
+//  The actual data never touches the blockchain — only the hash.
+//  This gives you tamper-proof proof that data existed at a
+//  specific time, without exposing any private content.
+//
+//  HOW ERC-4337 CALLS THIS CONTRACT:
+//  Normal flow: User wallet → calls your contract
+//  ERC-4337 flow: User wallet → Smart Account → EntryPoint → your contract
+//
+//  The key difference: msg.sender will NEVER be the user's real wallet
+//  address. It will be their Smart Account address (a contract).
+//  Keep this in mind when you design identity or access control.
+//
+// =============================================================
+contract BaseStorage {
+    // ---------------------------------------------------------
+    //  DATA STRUCTURES
+    //  Customize the Record struct for your use case.
+    //  Examples: add locationHash, severity, category, etc.
+    // ---------------------------------------------------------
+    struct Record {
+        bytes32 dataHash;       // SHA-256 hash of your actual data (computed in the frontend)
+        uint256 timestamp;      // block.timestamp at submission — fine for ordering, not for security
+        address submitter;      // [ERC-4337 RULE] This is the Smart Account address, NOT the user's EOA
+        bool exists;            // guard for duplicate-check pattern
+    }
+    // ---------------------------------------------------------
+    //  STATE
+    // ---------------------------------------------------------
+    // Primary lookup: unique ID → Record
+    mapping(bytes32 => Record) private _records;
+    // Reverse lookup: submitter address → all their record IDs
+    // Lets you fetch "all records by this user" efficiently
+    mapping(address => bytes32[]) private _submitterRecords;
+    // Total count — useful for off-chain indexing
+    uint256 public totalRecords;
+    // ---------------------------------------------------------
+    //  EVENTS
+    //  Always emit events. Off-chain apps (your frontend, indexers)
+    //  listen to these to know something happened without polling.
+    // ---------------------------------------------------------
+    event RecordStored(
+        bytes32 indexed id,
+        bytes32 indexed dataHash,
+        address indexed submitter,
+        uint256 timestamp
+    );
+    event RecordUpdated(
+        bytes32 indexed id,
+        bytes32 newDataHash,
+        uint256 timestamp
+    );
+    // ---------------------------------------------------------
+    //  ERRORS
+    //  Custom errors use less gas than require strings.
+    //  Use these instead of require("...") in production.
+    // ---------------------------------------------------------
+    error RecordAlreadyExists(bytes32 id);
+    error RecordNotFound(bytes32 id);
+    error NotSubmitter(address caller, address expected);
+    // ---------------------------------------------------------
+    //  WRITE FUNCTIONS
+    // ---------------------------------------------------------
+    /**
+     * @notice Store a new record on-chain.
+     *
+     * @dev [ERC-4337 RULE] msg.sender here is the user's Smart Account,
+     *      not their original EOA (e.g. Google-login wallet). If you need
+     *      to track the original user, pass an identifier in calldata
+     *      (like a hash of their email) and store it in the struct.
+     *
+     * @dev [ERC-4337 RULE] Do NOT do heavy computation here.
+     *      Paymasters cap gas. If this function is too expensive,
+     *      the UserOp will be rejected before it even reaches chain.
+     *      Keep storage writes minimal. One SSTORE = ~20,000 gas.
+     *
+     * @param dataHash  SHA-256 hash computed in the frontend. Never send
+     *                  raw data — only the hash belongs on-chain.
+     *
+     * @return id  Unique identifier for this record (use this to verify later)
+     */
+    function storeRecord(bytes32 dataHash) external returns (bytes32 id) {
+        // Generate a deterministic ID from hash + block + sender
+        // This makes IDs reproducible for the same input in the same block
+        id = keccak256(abi.encodePacked(dataHash, block.timestamp, msg.sender));
+        // Revert if this exact ID was already stored
+        // (prevents accidental double-submit)
+        if (_records[id].exists) revert RecordAlreadyExists(id);
+        // Write to storage
+        _records[id] = Record({
+            dataHash:  dataHash,
+            timestamp: block.timestamp,
+            submitter: msg.sender,   // Smart Account address
+            exists:    true
+        });
+        // Update reverse index
+        _submitterRecords[msg.sender].push(id);
+        totalRecords++;
+        emit RecordStored(id, dataHash, msg.sender, block.timestamp);
+    }
+    // ---------------------------------------------------------
+    //  READ FUNCTIONS
+    //  These are free (no gas) — call them as often as you want.
+    // ---------------------------------------------------------
+    /**
+     * @notice Get a record by ID.
+     * @dev Returns all fields. Your frontend can use dataHash to
+     *      verify against the original data the user still has.
+     */
+    function getRecord(bytes32 id)
+        external
+        view
+        returns (
+            bytes32 dataHash,
+            uint256 timestamp,
+            address submitter
+        )
+    {
+        if (!_records[id].exists) revert RecordNotFound(id);
+        Record storage r = _records[id];
+        return (r.dataHash, r.timestamp, r.submitter);
+    }
+    /**
+     * @notice Verify: does this record exist AND match the given hash?
+     * @dev This is your tamper-proof check. If someone gives you
+     *      the original data + a record ID, you hash the data and
+     *      call this. If it returns true, the data is authentic.
+     *
+     * @param id        Record ID returned from storeRecord()
+     * @param dataHash  SHA-256 hash you computed of the original data
+     * @return bool     true = record exists and hash matches
+     */
+    function verifyRecord(bytes32 id, bytes32 dataHash)
+        external
+        view
+        returns (bool)
+    {
+        if (!_records[id].exists) return false;
+        return _records[id].dataHash == dataHash;
+    }
+    /**
+     * @notice Get all record IDs submitted by a specific Smart Account.
+     * @dev Pass the Smart Account address (not the user's EOA).
+     *      Your frontend gets this from useSmartAccount().smartAccountAddress
+     */
+    function getRecordsBySubmitter(address submitter)
+        external
+        view
+        returns (bytes32[] memory)
+    {
+        return _submitterRecords[submitter];
+    }
+    /**
+     * @notice Check if a record exists without reverting.
+     * @dev Useful for frontend validation before showing a verify button.
+     */
+    function recordExists(bytes32 id) external view returns (bool) {
+        return _records[id].exists;
+    }
+}
+// =============================================================
+//  HOW TO CUSTOMIZE THIS CONTRACT
+//
+//  1. RENAME IT:
+//     contract IncidentRegistry { ... }
+//     contract DrugVerification { ... }
+//     contract DocumentProof { ... }
+//
+//  2. ADD FIELDS TO THE STRUCT:
+//     struct Record {
+//         bytes32 dataHash;
+//         uint256 timestamp;
+//         address submitter;
+//         bool exists;
+//         // ADD YOUR FIELDS:
+//         string locationHash;   // hashed GPS coords
+//         uint8 severity;        // 1-5 scale
+//         bytes32 category;      // incident type, drug type, etc.
+//     }
+//
+//  3. UPDATE storeRecord() PARAMS:
+//     function storeRecord(bytes32 dataHash, string calldata locationHash, uint8 severity)
+//
+//  4. THAT'S IT. The ERC-4337 rules above still apply.
+//     You do NOT need to change anything about how UserOps work.
+//     The SDK handles all of that.
+// =============================================================