@tomo-inc/wallet-connect-kit 0.0.17 → 0.0.19

package/README.md

@@ -646,33 +646,69 @@ export function SwitchChainButton() {
 
 ### Get Wallet Providers and Connectors
 
-Use the `useConnectors` hook to get all available connectors from the currently connected wallet. This is useful for wallets that support multiple chains (e.g., OKX Wallet supports EVM, Solana, and Aptos):
+Use the `useConnectors` hook to get all available providers from the currently connected wallet, grouped by chain type.  
+This is useful for multi-chain wallets (for example, OKX Wallet supports EVM, Solana, Aptos, Dogecoin, etc.).  
+Different chain providers are usually based on different underlying protocols, for example EVM providers commonly follow the EIP-1193 standard, while Dogecoin providers may come from Unisat-compatible implementations.
 
 ```tsx
 import { useConnectors } from "@tomo-inc/wallet-connect-kit";
 
-export function ProvidersInfo() {
-  const { connectors, currentProvider } = useConnectors();
+export function SignMessageExamples() {
+  const { connectors } = useConnectors();
 
   if (!connectors) {
     return <div>No wallet connected</div>;
   }
 
   // connectors is an object with chain types as keys
-  // e.g., { evm: { provider, protocol, standard }, solana: { ... }, aptos: { ... } }
-  const supportedChains = Object.keys(connectors).filter(
-    (chainType) => connectors[chainType as keyof typeof connectors] !== null
-  );
+  // e.g., { evm: { provider, protocol, standard }, dogecoin: { provider, protocol, standard }, ... }
+  const evmConnector = connectors.evm ?? null;
+  const dogeConnector = connectors.dogecoin ?? null;
+
+  // EVM provider usually follows EIP-1193 standard
+  const evmProvider = evmConnector?.provider;
+  // Dogecoin provider usually comes from a Unisat-compatible provider
+  const dogeProvider = dogeConnector?.provider;
+
+  const handleEvmSignMessage = async () => {
+    if (!evmProvider) return;
+
+    const accounts = await evmProvider.request({
+      method: "eth_requestAccounts",
+    });
+    const from = accounts[0];
+
+    const message = "Hello from EVM";
+
+    // EIP-1193 personal_sign example
+    const signature = await evmProvider.request({
+      method: "personal_sign",
+      params: [message, from],
+    });
+
+    console.log("EVM signature:", signature);
+  };
+
+  const handleDogeSignMessage = async () => {
+    if (!dogeProvider) return;
+
+    const message = "Hello from Dogecoin";
+
+    // Unisat-like Dogecoin signMessage example
+    // Most Unisat-compatible providers expose a signMessage method
+    const signature = await dogeProvider.signMessage(message);
+
+    console.log("Dogecoin signature:", signature);
+  };
 
   return (
     <div>
-      <h3>Supported Chains:</h3>
-      <ul>
-        {supportedChains.map((chainType) => (
-          <li key={chainType}>{chainType.toUpperCase()}</li>
-        ))}
-      </ul>
-      <p>Current Provider: {currentProvider ? "Connected" : "Not connected"}</p>
+      <button disabled={!evmProvider} onClick={handleEvmSignMessage}>
+        Sign EVM Message
+      </button>
+      <button disabled={!dogeProvider} onClick={handleDogeSignMessage}>
+        Sign Dogecoin Message
+      </button>
     </div>
   );
 }
@@ -681,15 +717,15 @@ export function ProvidersInfo() {
 **Returns:**
 
 ```tsx
-interface useConnectors {
+interface UseConnectors {
   // All available providers from the current wallet, keyed by chain type
   connectors: ConnectorProviders | null;
-  // The currently active provider
+  // The currently active provider for the selected chain
   currentProvider: WalletProvider | null;
 }
 ```
 
-**Note:** `connectors` contains all connectors supported by the current wallet. For example, if you connect OKX Wallet, `connectors` may include `evm`, `solana`, and `aptos` connectors. The `currentProvider` is the provider currently being used for the active chain.
+**Note:** `connectors` contains all connectors supported by the current wallet. For example, if you connect OKX Wallet, `connectors` may include `evm`, `dogecoin`, `solana`, and `aptos` connectors. Each entry provides a `provider` instance that you can use directly to call chain-specific RPC methods.
 
 ### Integration with Wagmi
 

package/dist/index.d.ts

@@ -7,12 +7,15 @@ import { ConnectorProvider } from '../../../wallet-adaptor-base';
 import { ConnectorProviders } from '../../../../wallet-adaptor-base';
 import { default as default_2 } from 'react';
 import type { DefaultThemeType } from '@heroui/theme';
+import { EmbeddedWallet } from '@tomo-inc/embedded-wallet-providers';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
 import type { LayoutTheme } from '@heroui/theme';
 import { SignInParams } from '../../../wallet-adaptor-base';
 import { WalletConfig } from '../../../wallet-adaptor-base';
 import { WalletConfig as WalletConfig_2 } from '../../../../wallet-adaptor-base';
+import { WalletInfo } from '../../../wallet-adaptor-base';
 import { WalletProvider } from '@tomo-inc/inject-providers';
+import { WalletProvider as WalletProvider_2 } from '../../../wallet-adaptor-base';
 import { WalletProvider as WalletProvider_3 } from '../../../../wallet-adaptor-base';
 
 export declare type BasicLoginType = "email" | "externalWallets";
@@ -65,6 +68,23 @@ export declare interface ConnectVariables {
     chainId?: string;
 }
 
+/**
+ * Connected information from embedded wallet
+ */
+declare interface EmbeddedWalletConnectedInfo {
+    evmProvider?: ProviderConnectionInfo;
+    solanaProvider?: ProviderConnectionInfo;
+    dogeProvider?: ProviderConnectionInfo;
+}
+
+declare interface EmbeddedWalletState {
+    wallet: EmbeddedWallet | null;
+    isAvailable: boolean;
+    message: string | null;
+    connectedInfo: EmbeddedWalletConnectedInfo | null;
+    isLoading: boolean;
+}
+
 export declare type EvmChain = Chain_2;
 
 /**
@@ -101,8 +121,16 @@ export declare enum ModalView {
     SignInWallet = "SIGN_IN_WALLET",
     WalletConnect = "WALLET_CONNECT",
     UnsupportChain = "UNSUPPORT_CHAIN",
-    SocialLogin = "SOCIAL_LOGIN",
-    MyDogeSocialLogin = "MYDOGE_SOCIAL_LOGIN"
+    WalletHome = "WALLET_HOME"
+}
+
+/**
+ * Provider connection information
+ */
+declare interface ProviderConnectionInfo {
+    chainType: ChainTypeEnum;
+    connected: boolean;
+    address?: string[];
 }
 
 /**
@@ -137,6 +165,7 @@ export declare type SwitchChainOptions = {
 export declare type ThemeConfig = ThemeConfig_2;
 
 declare type ThemeConfig_2 = {
+    prefix?: string;
     layout?: LayoutTheme;
     themes?: ConfigThemes;
     defaultTheme?: DefaultThemeType;
@@ -170,6 +199,25 @@ export declare const useConnectors: () => {
     currentProvider: WalletProvider_3 | null;
 };
 
+/**
+ * Hook to access embedded wallet from anywhere in the app
+ * Make sure your component is wrapped with WalletConnectProvider
+ *
+ * @example
+ * ```tsx
+ * const { wallet, isAvailable, message, connectedInfo, isLoading } = useEmbeddedWallet();
+ *
+ * if (isLoading) {
+ *   return <div>Loading embedded wallet...</div>;
+ * }
+ *
+ * if (isAvailable && wallet) {
+ *   // Use embedded wallet
+ * }
+ * ```
+ */
+export declare const useEmbeddedWallet: () => EmbeddedWalletState;
+
 export declare interface UserLoginConfig {
     basicLogins?: BasicLoginType[];
     socialLogins?: SocialLoginProvider[];
@@ -243,7 +291,7 @@ export declare interface WalletConnectKitConfig {
      * ```tsx
      * import { WalletConnectProvider } from "@tomo-inc/wallet-connect-kit";
      * const config: WalletConnectKitConfig = {
-     *   defaultConnectChain: ChainTypeEnum.EVM,
+     *   defaultConnectChain: ChainTypeEnum.EVM as ChainType,
      * };
      */
     defaultConnectChain?: ChainType;
@@ -287,15 +335,11 @@ export declare interface WalletConnectKitConfig {
  * Based on standard Connector from wallet-adaptor-base
  */
 export declare type WalletConnector = Connector & {
+    providers?: any;
     isEmbeddedWallet?: boolean;
     logout?: () => Promise<boolean>;
 };
 
-/**
- * Thin wrapper: only derives config and renders QueryClientProvider > Content.
- * All wallet/context state and useEmbeddedWalletInternal (useQuery) run inside Content,
- * so they are under QueryClientProvider and WalletConnectContext.Provider.
- */
 export declare const WalletConnectProvider: ({ children, config }: WalletConnectProviderProps) => JSX_2.Element | null;
 
 declare interface WalletConnectProviderProps {
@@ -303,36 +347,8 @@ declare interface WalletConnectProviderProps {
     config?: WalletConnectKitConfig;
 }
 
-export { WalletProvider }
+export { WalletInfo }
 
-/**
- * Wallet metadata information (business layer)
- * Contains wallet display information like name, icon, links, etc.
- * This is different from WalletProviderType (actual provider implementation)
- */
-declare interface WalletProvider_2 {
-    uuid: string;
-    name: string;
-    namespace?: string;
-    icon: string;
-    iconBackground?: string;
-    rdns?: string;
-    links: {
-        homepage?: string;
-        ios_install?: string;
-        android_install?: string;
-        chrome_install?: string;
-        mobile?: string;
-        qrCode?: string;
-        edge?: string;
-        firefox?: string;
-        opera?: string;
-        safari?: string;
-        macos?: string;
-        windows?: string;
-        linux?: string;
-        desktop?: string;
-    };
-}
+export { WalletProvider }
 
 export { }