@cfxdevkit/react 1.0.0

package/dist/hooks/index.cjs

@@ -0,0 +1,198 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/hooks/index.ts
+var hooks_exports = {};
+__export(hooks_exports, {
+  useBalance: () => useBalance,
+  useContract: () => useContract,
+  useTransaction: () => useTransaction
+});
+module.exports = __toCommonJS(hooks_exports);
+
+// src/hooks/useBalance.ts
+var import_react2 = require("react");
+
+// src/providers/DevKitProvider.tsx
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var DevKitContext = (0, import_react.createContext)(void 0);
+function useDevKitContext() {
+  const context = (0, import_react.useContext)(DevKitContext);
+  if (!context) {
+    throw new Error("useDevKitContext must be used within DevKitProvider");
+  }
+  return context;
+}
+
+// src/hooks/useBalance.ts
+function useBalance(options) {
+  const { address, enabled = true, refreshInterval } = options;
+  useDevKitContext();
+  const [balance, setBalance] = (0, import_react2.useState)();
+  const [isLoading, setIsLoading] = (0, import_react2.useState)(false);
+  const [error, setError] = (0, import_react2.useState)();
+  const fetchBalance = (0, import_react2.useCallback)(async () => {
+    if (!address || !enabled) return;
+    setIsLoading(true);
+    setError(void 0);
+    try {
+      const mockBalance = "1000000000000000000";
+      setBalance(mockBalance);
+    } catch (err) {
+      setError(
+        err instanceof Error ? err : new Error("Failed to fetch balance")
+      );
+    } finally {
+      setIsLoading(false);
+    }
+  }, [address, enabled]);
+  (0, import_react2.useEffect)(() => {
+    void fetchBalance();
+    if (refreshInterval) {
+      const interval = setInterval(() => {
+        void fetchBalance();
+      }, refreshInterval);
+      return () => clearInterval(interval);
+    }
+  }, [fetchBalance, refreshInterval]);
+  return {
+    balance,
+    isLoading,
+    error,
+    refetch: fetchBalance
+  };
+}
+
+// src/hooks/useContract.ts
+var import_react4 = require("react");
+
+// src/providers/WalletProvider.tsx
+var import_react3 = require("react");
+var import_jsx_runtime2 = require("react/jsx-runtime");
+var WalletContext = (0, import_react3.createContext)(void 0);
+function useWalletContext() {
+  const context = (0, import_react3.useContext)(WalletContext);
+  if (!context) {
+    throw new Error("useWalletContext must be used within WalletProvider");
+  }
+  return context;
+}
+
+// src/hooks/useContract.ts
+function useContract() {
+  useDevKitContext();
+  const { accountIndex } = useWalletContext();
+  const [isLoading, setIsLoading] = (0, import_react4.useState)(false);
+  const [error, setError] = (0, import_react4.useState)();
+  const read = async (_options) => {
+    setIsLoading(true);
+    setError(void 0);
+    try {
+      return {};
+    } catch (err) {
+      const errorObj = err instanceof Error ? err : new Error("Contract read failed");
+      setError(errorObj);
+      throw errorObj;
+    } finally {
+      setIsLoading(false);
+    }
+  };
+  const write = async (_options) => {
+    if (accountIndex === void 0) {
+      throw new Error("Wallet not connected");
+    }
+    setIsLoading(true);
+    setError(void 0);
+    try {
+      const hash = `0x${Array.from(
+        { length: 64 },
+        () => Math.floor(Math.random() * 16).toString(16)
+      ).join("")}`;
+      return hash;
+    } catch (err) {
+      const errorObj = err instanceof Error ? err : new Error("Contract write failed");
+      setError(errorObj);
+      throw errorObj;
+    } finally {
+      setIsLoading(false);
+    }
+  };
+  return {
+    read,
+    write,
+    isLoading,
+    error
+  };
+}
+
+// src/hooks/useTransaction.ts
+var import_react5 = require("react");
+function useTransaction() {
+  useDevKitContext();
+  const { accountIndex } = useWalletContext();
+  const [isLoading, setIsLoading] = (0, import_react5.useState)(false);
+  const [error, setError] = (0, import_react5.useState)();
+  const [transaction, setTransaction] = (0, import_react5.useState)();
+  const send = async (_options) => {
+    if (accountIndex === void 0) {
+      throw new Error("Wallet not connected");
+    }
+    setIsLoading(true);
+    setError(void 0);
+    try {
+      const result = {
+        hash: `0x${Array.from(
+          { length: 64 },
+          () => Math.floor(Math.random() * 16).toString(16)
+        ).join("")}`,
+        status: "pending"
+      };
+      setTransaction(result);
+      setTimeout(() => {
+        setTransaction({ ...result, status: "success" });
+      }, 2e3);
+      return result;
+    } catch (err) {
+      const errorObj = err instanceof Error ? err : new Error("Transaction failed");
+      setError(errorObj);
+      throw errorObj;
+    } finally {
+      setIsLoading(false);
+    }
+  };
+  const reset = () => {
+    setTransaction(void 0);
+    setError(void 0);
+  };
+  return {
+    send,
+    isLoading,
+    error,
+    transaction,
+    reset
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useBalance,
+  useContract,
+  useTransaction
+});
+//# sourceMappingURL=index.cjs.map

package/dist/hooks/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/index.ts","../../src/hooks/useBalance.ts","../../src/providers/DevKitProvider.tsx","../../src/hooks/useContract.ts","../../src/providers/WalletProvider.tsx","../../src/hooks/useTransaction.ts"],"sourcesContent":["/*\n * Copyright 2025 Conflux DevKit Team\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport type { UseBalanceOptions, UseBalanceReturn } from './useBalance.js';\nexport { useBalance } from './useBalance.js';\nexport type {\n  ReadContractOptions,\n  UseContractReturn,\n  WriteContractOptions,\n} from './useContract.js';\nexport { useContract } from './useContract.js';\nexport type {\n  SendTransactionOptions,\n  TransactionResult,\n  UseTransactionReturn,\n} from './useTransaction.js';\nexport { useTransaction } from './useTransaction.js';\n","/*\n * Copyright 2025 Conflux DevKit Team\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * useBalance Hook\n *\n * Fetches and tracks balance for an address\n */\n\nimport type { ChainType } from '@cfxdevkit/core';\nimport { useCallback, useEffect, useState } from 'react';\nimport { useDevKitContext } from '../providers/DevKitProvider.js';\n\nexport interface UseBalanceOptions {\n  address?: string;\n  chain: ChainType;\n  enabled?: boolean;\n  refreshInterval?: number;\n}\n\nexport interface UseBalanceReturn {\n  balance?: string;\n  isLoading: boolean;\n  error?: Error;\n  refetch: () => Promise<void>;\n}\n\n/**\n * Hook to fetch and track address balance\n *\n * @example\n * ```tsx\n * const { balance, isLoading } = useBalance({\n *   address: '0x...',\n *   chain: 'evm'\n * });\n * ```\n */\nexport function useBalance(options: UseBalanceOptions): UseBalanceReturn {\n  const { address, enabled = true, refreshInterval } = options;\n  useDevKitContext(); // ensure provider is present; apiUrl and chain used in production impl\n\n  const [balance, setBalance] = useState<string>();\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<Error>();\n\n  const fetchBalance = useCallback(async () => {\n    if (!address || !enabled) return;\n\n    setIsLoading(true);\n    setError(undefined);\n\n    try {\n      // In production, call backend API with `chain` to select Core vs eSpace\n      // For now, simulate balance fetch\n      const mockBalance = '1000000000000000000'; // 1 token\n      setBalance(mockBalance);\n    } catch (err) {\n      setError(\n        err instanceof Error ? err : new Error('Failed to fetch balance')\n      );\n    } finally {\n      setIsLoading(false);\n    }\n  }, [address, enabled]);\n\n  useEffect(() => {\n    void fetchBalance();\n\n    // Set up refresh interval if provided\n    if (refreshInterval) {\n      const interval = setInterval(() => {\n        void fetchBalance();\n      }, refreshInterval);\n      return () => clearInterval(interval);\n    }\n  }, [fetchBalance, refreshInterval]);\n\n  return {\n    balance,\n    isLoading,\n    error,\n    refetch: fetchBalance,\n  };\n}\n","/*\n * Copyright 2025 Conflux DevKit Team\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * DevKit Provider\n *\n * Provides DevKit instance and configuration to all child components\n */\n\nimport { createContext, type ReactNode, useContext } from 'react';\n\nexport interface DevKitContextValue {\n  /** Backend API URL */\n  apiUrl: string;\n  /** WebSocket URL */\n  wsUrl?: string;\n  /** Current network */\n  network: 'local' | 'testnet' | 'mainnet';\n  /** Enable debug mode */\n  debug?: boolean;\n}\n\nconst DevKitContext = createContext<DevKitContextValue | undefined>(undefined);\n\nexport interface DevKitProviderProps {\n  apiUrl: string;\n  wsUrl?: string;\n  network?: 'local' | 'testnet' | 'mainnet';\n  debug?: boolean;\n  children: ReactNode;\n}\n\n/**\n * DevKit Provider Component\n *\n * Wrap your app with this provider to enable DevKit functionality\n *\n * @example\n * ```tsx\n * <DevKitProvider apiUrl=\"http://localhost:3000\" network=\"local\">\n *   <App />\n * </DevKitProvider>\n * ```\n */\nexport function DevKitProvider({\n  apiUrl,\n  wsUrl,\n  network = 'local',\n  debug = false,\n  children,\n}: DevKitProviderProps) {\n  const value: DevKitContextValue = {\n    apiUrl,\n    wsUrl,\n    network,\n    debug,\n  };\n\n  return (\n    <DevKitContext.Provider value={value}>{children}</DevKitContext.Provider>\n  );\n}\n\n/**\n * Hook to access DevKit context\n *\n * @throws Error if used outside DevKitProvider\n */\nexport function useDevKitContext() {\n  const context = useContext(DevKitContext);\n  if (!context) {\n    throw new Error('useDevKitContext must be used within DevKitProvider');\n  }\n  return context;\n}\n","/*\n * Copyright 2025 Conflux DevKit Team\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * useContract Hook\n *\n * Interact with smart contracts (read and write)\n */\n\nimport type { ChainType } from '@cfxdevkit/core';\nimport { useState } from 'react';\nimport { useDevKitContext } from '../providers/DevKitProvider.js';\nimport { useWalletContext } from '../providers/WalletProvider.js';\n\nexport interface ReadContractOptions {\n  address: string;\n  abi: unknown[];\n  functionName: string;\n  args?: unknown[];\n  chain: ChainType;\n}\n\nexport interface WriteContractOptions extends ReadContractOptions {\n  value?: string;\n}\n\nexport interface UseContractReturn {\n  read: <T = unknown>(options: ReadContractOptions) => Promise<T>;\n  write: (options: WriteContractOptions) => Promise<string>;\n  isLoading: boolean;\n  error?: Error;\n}\n\n/**\n * Hook to interact with smart contracts\n *\n * @example\n * ```tsx\n * const { read, write, isLoading } = useContract();\n *\n * // Read contract\n * const balance = await read({\n *   address: '0x...',\n *   abi: ERC20_ABI,\n *   functionName: 'balanceOf',\n *   args: ['0x...'],\n *   chain: 'evm'\n * });\n *\n * // Write contract\n * const hash = await write({\n *   address: '0x...',\n *   abi: ERC20_ABI,\n *   functionName: 'transfer',\n *   args: ['0x...', '1000000000000000000'],\n *   chain: 'evm'\n * });\n * ```\n */\nexport function useContract(): UseContractReturn {\n  useDevKitContext(); // ensure provider is present; apiUrl used in production impl\n  const { accountIndex } = useWalletContext();\n\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<Error>();\n\n  const read = async <T = unknown>(\n    _options: ReadContractOptions\n  ): Promise<T> => {\n    setIsLoading(true);\n    setError(undefined);\n\n    try {\n      // In production, call backend API\n      // For now, return mock data\n      return {} as T;\n    } catch (err) {\n      const errorObj =\n        err instanceof Error ? err : new Error('Contract read failed');\n      setError(errorObj);\n      throw errorObj;\n    } finally {\n      setIsLoading(false);\n    }\n  };\n\n  const write = async (_options: WriteContractOptions): Promise<string> => {\n    if (accountIndex === undefined) {\n      throw new Error('Wallet not connected');\n    }\n\n    setIsLoading(true);\n    setError(undefined);\n\n    try {\n      // In production, call backend API\n      // For now, return mock hash\n      const hash = `0x${Array.from({ length: 64 }, () =>\n        Math.floor(Math.random() * 16).toString(16)\n      ).join('')}`;\n\n      return hash;\n    } catch (err) {\n      const errorObj =\n        err instanceof Error ? err : new Error('Contract write failed');\n      setError(errorObj);\n      throw errorObj;\n    } finally {\n      setIsLoading(false);\n    }\n  };\n\n  return {\n    read,\n    write,\n    isLoading,\n    error,\n  };\n}\n","/*\n * Copyright 2025 Conflux DevKit Team\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Wallet Provider\n *\n * Manages wallet connection state and provides wallet-related functionality\n */\n\nimport type { ChainType } from '@cfxdevkit/core';\nimport { createContext, type ReactNode, useContext, useState } from 'react';\n\nexport interface WalletContextValue {\n  isConnected: boolean;\n  address?: string;\n  coreAddress?: string;\n  evmAddress?: string;\n  chain?: ChainType;\n  accountIndex?: number;\n  connect: (accountIndex: number) => Promise<void>;\n  disconnect: () => void;\n  switchChain: (chain: ChainType) => void;\n}\n\nconst WalletContext = createContext<WalletContextValue | undefined>(undefined);\n\nexport interface WalletProviderProps {\n  children: ReactNode;\n}\n\n/**\n * Wallet Provider Component\n *\n * Manages wallet connection state\n *\n * @example\n * ```tsx\n * <WalletProvider>\n *   <ConnectButton />\n *   <AccountCard />\n * </WalletProvider>\n * ```\n */\nexport function WalletProvider({ children }: WalletProviderProps) {\n  const [isConnected, setIsConnected] = useState(false);\n  const [coreAddress, setCoreAddress] = useState<string>();\n  const [evmAddress, setEvmAddress] = useState<string>();\n  const [chain, setChain] = useState<ChainType>('evm');\n  const [accountIndex, setAccountIndex] = useState<number>();\n\n  const connect = async (index: number) => {\n    // In production, this would fetch account info from backend\n    // For now, simulate connection\n    setAccountIndex(index);\n    setCoreAddress(`cfx:account${index}`);\n    setEvmAddress(`0xaccount${index}`);\n    setIsConnected(true);\n  };\n\n  const disconnect = () => {\n    setIsConnected(false);\n    setCoreAddress(undefined);\n    setEvmAddress(undefined);\n    setAccountIndex(undefined);\n  };\n\n  const switchChain = (newChain: ChainType) => {\n    setChain(newChain);\n  };\n\n  const value: WalletContextValue = {\n    isConnected,\n    address: chain === 'core' ? coreAddress : evmAddress,\n    coreAddress,\n    evmAddress,\n    chain,\n    accountIndex,\n    connect,\n    disconnect,\n    switchChain,\n  };\n\n  return (\n    <WalletContext.Provider value={value}>{children}</WalletContext.Provider>\n  );\n}\n\n/**\n * Hook to access Wallet context\n *\n * @throws Error if used outside WalletProvider\n */\nexport function useWalletContext() {\n  const context = useContext(WalletContext);\n  if (!context) {\n    throw new Error('useWalletContext must be used within WalletProvider');\n  }\n  return context;\n}\n","/*\n * Copyright 2025 Conflux DevKit Team\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * useTransaction Hook\n *\n * Sends transactions and tracks their status\n */\n\nimport type { ChainType } from '@cfxdevkit/core';\nimport { useState } from 'react';\nimport { useDevKitContext } from '../providers/DevKitProvider.js';\nimport { useWalletContext } from '../providers/WalletProvider.js';\n\nexport interface SendTransactionOptions {\n  to: string;\n  value?: string;\n  data?: string;\n  chain?: ChainType;\n}\n\nexport interface TransactionResult {\n  hash: string;\n  status: 'pending' | 'success' | 'failed';\n}\n\nexport interface UseTransactionReturn {\n  send: (options: SendTransactionOptions) => Promise<TransactionResult>;\n  isLoading: boolean;\n  error?: Error;\n  transaction?: TransactionResult;\n  reset: () => void;\n}\n\n/**\n * Hook to send transactions\n *\n * @example\n * ```tsx\n * const { send, isLoading, transaction } = useTransaction();\n *\n * const handleSend = async () => {\n *   const result = await send({\n *     to: '0x...',\n *     value: '1000000000000000000',\n *     chain: 'evm'\n *   });\n * };\n * ```\n */\nexport function useTransaction(): UseTransactionReturn {\n  useDevKitContext(); // ensure provider is present; apiUrl used in production impl\n  const { accountIndex } = useWalletContext();\n\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<Error>();\n  const [transaction, setTransaction] = useState<TransactionResult>();\n\n  const send = async (\n    _options: SendTransactionOptions\n  ): Promise<TransactionResult> => {\n    if (accountIndex === undefined) {\n      throw new Error('Wallet not connected');\n    }\n\n    setIsLoading(true);\n    setError(undefined);\n\n    try {\n      // In production, call backend API to send transaction\n      // For now, simulate transaction\n      const result: TransactionResult = {\n        hash: `0x${Array.from({ length: 64 }, () =>\n          Math.floor(Math.random() * 16).toString(16)\n        ).join('')}`,\n        status: 'pending',\n      };\n\n      setTransaction(result);\n\n      // Simulate confirmation\n      setTimeout(() => {\n        setTransaction({ ...result, status: 'success' });\n      }, 2000);\n\n      return result;\n    } catch (err) {\n      const errorObj =\n        err instanceof Error ? err : new Error('Transaction failed');\n      setError(errorObj);\n      throw errorObj;\n    } finally {\n      setIsLoading(false);\n    }\n  };\n\n  const reset = () => {\n    setTransaction(undefined);\n    setError(undefined);\n  };\n\n  return {\n    send,\n    isLoading,\n    error,\n    transaction,\n    reset,\n  };\n}\n"],"mappings":"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","names":["import_react","import_react","import_react","import_jsx_runtime","import_react"]}

package/dist/hooks/index.d.cts

@@ -0,0 +1,125 @@
+import { ChainType } from '@cfxdevkit/core';
+
+/**
+ * useBalance Hook
+ *
+ * Fetches and tracks balance for an address
+ */
+
+interface UseBalanceOptions {
+    address?: string;
+    chain: ChainType;
+    enabled?: boolean;
+    refreshInterval?: number;
+}
+interface UseBalanceReturn {
+    balance?: string;
+    isLoading: boolean;
+    error?: Error;
+    refetch: () => Promise<void>;
+}
+/**
+ * Hook to fetch and track address balance
+ *
+ * @example
+ * ```tsx
+ * const { balance, isLoading } = useBalance({
+ *   address: '0x...',
+ *   chain: 'evm'
+ * });
+ * ```
+ */
+declare function useBalance(options: UseBalanceOptions): UseBalanceReturn;
+
+/**
+ * useContract Hook
+ *
+ * Interact with smart contracts (read and write)
+ */
+
+interface ReadContractOptions {
+    address: string;
+    abi: unknown[];
+    functionName: string;
+    args?: unknown[];
+    chain: ChainType;
+}
+interface WriteContractOptions extends ReadContractOptions {
+    value?: string;
+}
+interface UseContractReturn {
+    read: <T = unknown>(options: ReadContractOptions) => Promise<T>;
+    write: (options: WriteContractOptions) => Promise<string>;
+    isLoading: boolean;
+    error?: Error;
+}
+/**
+ * Hook to interact with smart contracts
+ *
+ * @example
+ * ```tsx
+ * const { read, write, isLoading } = useContract();
+ *
+ * // Read contract
+ * const balance = await read({
+ *   address: '0x...',
+ *   abi: ERC20_ABI,
+ *   functionName: 'balanceOf',
+ *   args: ['0x...'],
+ *   chain: 'evm'
+ * });
+ *
+ * // Write contract
+ * const hash = await write({
+ *   address: '0x...',
+ *   abi: ERC20_ABI,
+ *   functionName: 'transfer',
+ *   args: ['0x...', '1000000000000000000'],
+ *   chain: 'evm'
+ * });
+ * ```
+ */
+declare function useContract(): UseContractReturn;
+
+/**
+ * useTransaction Hook
+ *
+ * Sends transactions and tracks their status
+ */
+
+interface SendTransactionOptions {
+    to: string;
+    value?: string;
+    data?: string;
+    chain?: ChainType;
+}
+interface TransactionResult {
+    hash: string;
+    status: 'pending' | 'success' | 'failed';
+}
+interface UseTransactionReturn {
+    send: (options: SendTransactionOptions) => Promise<TransactionResult>;
+    isLoading: boolean;
+    error?: Error;
+    transaction?: TransactionResult;
+    reset: () => void;
+}
+/**
+ * Hook to send transactions
+ *
+ * @example
+ * ```tsx
+ * const { send, isLoading, transaction } = useTransaction();
+ *
+ * const handleSend = async () => {
+ *   const result = await send({
+ *     to: '0x...',
+ *     value: '1000000000000000000',
+ *     chain: 'evm'
+ *   });
+ * };
+ * ```
+ */
+declare function useTransaction(): UseTransactionReturn;
+
+export { type ReadContractOptions, type SendTransactionOptions, type TransactionResult, type UseBalanceOptions, type UseBalanceReturn, type UseContractReturn, type UseTransactionReturn, type WriteContractOptions, useBalance, useContract, useTransaction };

package/dist/hooks/index.d.ts

@@ -0,0 +1,125 @@
+import { ChainType } from '@cfxdevkit/core';
+
+/**
+ * useBalance Hook
+ *
+ * Fetches and tracks balance for an address
+ */
+
+interface UseBalanceOptions {
+    address?: string;
+    chain: ChainType;
+    enabled?: boolean;
+    refreshInterval?: number;
+}
+interface UseBalanceReturn {
+    balance?: string;
+    isLoading: boolean;
+    error?: Error;
+    refetch: () => Promise<void>;
+}
+/**
+ * Hook to fetch and track address balance
+ *
+ * @example
+ * ```tsx
+ * const { balance, isLoading } = useBalance({
+ *   address: '0x...',
+ *   chain: 'evm'
+ * });
+ * ```
+ */
+declare function useBalance(options: UseBalanceOptions): UseBalanceReturn;
+
+/**
+ * useContract Hook
+ *
+ * Interact with smart contracts (read and write)
+ */
+
+interface ReadContractOptions {
+    address: string;
+    abi: unknown[];
+    functionName: string;
+    args?: unknown[];
+    chain: ChainType;
+}
+interface WriteContractOptions extends ReadContractOptions {
+    value?: string;
+}
+interface UseContractReturn {
+    read: <T = unknown>(options: ReadContractOptions) => Promise<T>;
+    write: (options: WriteContractOptions) => Promise<string>;
+    isLoading: boolean;
+    error?: Error;
+}
+/**
+ * Hook to interact with smart contracts
+ *
+ * @example
+ * ```tsx
+ * const { read, write, isLoading } = useContract();
+ *
+ * // Read contract
+ * const balance = await read({
+ *   address: '0x...',
+ *   abi: ERC20_ABI,
+ *   functionName: 'balanceOf',
+ *   args: ['0x...'],
+ *   chain: 'evm'
+ * });
+ *
+ * // Write contract
+ * const hash = await write({
+ *   address: '0x...',
+ *   abi: ERC20_ABI,
+ *   functionName: 'transfer',
+ *   args: ['0x...', '1000000000000000000'],
+ *   chain: 'evm'
+ * });
+ * ```
+ */
+declare function useContract(): UseContractReturn;
+
+/**
+ * useTransaction Hook
+ *
+ * Sends transactions and tracks their status
+ */
+
+interface SendTransactionOptions {
+    to: string;
+    value?: string;
+    data?: string;
+    chain?: ChainType;
+}
+interface TransactionResult {
+    hash: string;
+    status: 'pending' | 'success' | 'failed';
+}
+interface UseTransactionReturn {
+    send: (options: SendTransactionOptions) => Promise<TransactionResult>;
+    isLoading: boolean;
+    error?: Error;
+    transaction?: TransactionResult;
+    reset: () => void;
+}
+/**
+ * Hook to send transactions
+ *
+ * @example
+ * ```tsx
+ * const { send, isLoading, transaction } = useTransaction();
+ *
+ * const handleSend = async () => {
+ *   const result = await send({
+ *     to: '0x...',
+ *     value: '1000000000000000000',
+ *     chain: 'evm'
+ *   });
+ * };
+ * ```
+ */
+declare function useTransaction(): UseTransactionReturn;
+
+export { type ReadContractOptions, type SendTransactionOptions, type TransactionResult, type UseBalanceOptions, type UseBalanceReturn, type UseContractReturn, type UseTransactionReturn, type WriteContractOptions, useBalance, useContract, useTransaction };

package/dist/hooks/index.js

@@ -0,0 +1,169 @@
+// src/hooks/useBalance.ts
+import { useCallback, useEffect, useState } from "react";
+
+// src/providers/DevKitProvider.tsx
+import { createContext, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+var DevKitContext = createContext(void 0);
+function useDevKitContext() {
+  const context = useContext(DevKitContext);
+  if (!context) {
+    throw new Error("useDevKitContext must be used within DevKitProvider");
+  }
+  return context;
+}
+
+// src/hooks/useBalance.ts
+function useBalance(options) {
+  const { address, enabled = true, refreshInterval } = options;
+  useDevKitContext();
+  const [balance, setBalance] = useState();
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState();
+  const fetchBalance = useCallback(async () => {
+    if (!address || !enabled) return;
+    setIsLoading(true);
+    setError(void 0);
+    try {
+      const mockBalance = "1000000000000000000";
+      setBalance(mockBalance);
+    } catch (err) {
+      setError(
+        err instanceof Error ? err : new Error("Failed to fetch balance")
+      );
+    } finally {
+      setIsLoading(false);
+    }
+  }, [address, enabled]);
+  useEffect(() => {
+    void fetchBalance();
+    if (refreshInterval) {
+      const interval = setInterval(() => {
+        void fetchBalance();
+      }, refreshInterval);
+      return () => clearInterval(interval);
+    }
+  }, [fetchBalance, refreshInterval]);
+  return {
+    balance,
+    isLoading,
+    error,
+    refetch: fetchBalance
+  };
+}
+
+// src/hooks/useContract.ts
+import { useState as useState3 } from "react";
+
+// src/providers/WalletProvider.tsx
+import { createContext as createContext2, useContext as useContext2, useState as useState2 } from "react";
+import { jsx as jsx2 } from "react/jsx-runtime";
+var WalletContext = createContext2(void 0);
+function useWalletContext() {
+  const context = useContext2(WalletContext);
+  if (!context) {
+    throw new Error("useWalletContext must be used within WalletProvider");
+  }
+  return context;
+}
+
+// src/hooks/useContract.ts
+function useContract() {
+  useDevKitContext();
+  const { accountIndex } = useWalletContext();
+  const [isLoading, setIsLoading] = useState3(false);
+  const [error, setError] = useState3();
+  const read = async (_options) => {
+    setIsLoading(true);
+    setError(void 0);
+    try {
+      return {};
+    } catch (err) {
+      const errorObj = err instanceof Error ? err : new Error("Contract read failed");
+      setError(errorObj);
+      throw errorObj;
+    } finally {
+      setIsLoading(false);
+    }
+  };
+  const write = async (_options) => {
+    if (accountIndex === void 0) {
+      throw new Error("Wallet not connected");
+    }
+    setIsLoading(true);
+    setError(void 0);
+    try {
+      const hash = `0x${Array.from(
+        { length: 64 },
+        () => Math.floor(Math.random() * 16).toString(16)
+      ).join("")}`;
+      return hash;
+    } catch (err) {
+      const errorObj = err instanceof Error ? err : new Error("Contract write failed");
+      setError(errorObj);
+      throw errorObj;
+    } finally {
+      setIsLoading(false);
+    }
+  };
+  return {
+    read,
+    write,
+    isLoading,
+    error
+  };
+}
+
+// src/hooks/useTransaction.ts
+import { useState as useState4 } from "react";
+function useTransaction() {
+  useDevKitContext();
+  const { accountIndex } = useWalletContext();
+  const [isLoading, setIsLoading] = useState4(false);
+  const [error, setError] = useState4();
+  const [transaction, setTransaction] = useState4();
+  const send = async (_options) => {
+    if (accountIndex === void 0) {
+      throw new Error("Wallet not connected");
+    }
+    setIsLoading(true);
+    setError(void 0);
+    try {
+      const result = {
+        hash: `0x${Array.from(
+          { length: 64 },
+          () => Math.floor(Math.random() * 16).toString(16)
+        ).join("")}`,
+        status: "pending"
+      };
+      setTransaction(result);
+      setTimeout(() => {
+        setTransaction({ ...result, status: "success" });
+      }, 2e3);
+      return result;
+    } catch (err) {
+      const errorObj = err instanceof Error ? err : new Error("Transaction failed");
+      setError(errorObj);
+      throw errorObj;
+    } finally {
+      setIsLoading(false);
+    }
+  };
+  const reset = () => {
+    setTransaction(void 0);
+    setError(void 0);
+  };
+  return {
+    send,
+    isLoading,
+    error,
+    transaction,
+    reset
+  };
+}
+export {
+  useBalance,
+  useContract,
+  useTransaction
+};
+//# sourceMappingURL=index.js.map