@sodax/wallet-sdk-react 1.2.7-beta → 1.3.0-beta

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sodax/wallet-sdk-react",
   "license": "MIT",
-  "version": "1.2.7-beta",
+  "version": "1.3.0-beta",
   "description": "Wallet SDK of Sodax",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -25,16 +25,18 @@
   "dependencies": {
     "@coral-xyz/anchor": "0.30.1",
     "@creit.tech/stellar-wallets-kit": "^1.7.5",
+    "@hot-labs/near-connect": "0.10.0",
     "@injectivelabs/networks": "1.16.10",
     "@injectivelabs/sdk-ts": "1.16.10",
     "@injectivelabs/ts-types": "1.16.10",
     "@injectivelabs/wallet-base": "1.16.10",
     "@injectivelabs/wallet-core": "1.16.10",
-    "@injectivelabs/wallet-strategy": "1.16.10",
-    "@injectivelabs/wallet-evm": "1.16.10",
     "@injectivelabs/wallet-cosmos": "1.16.10",
+    "@injectivelabs/wallet-evm": "1.16.10",
+    "@injectivelabs/wallet-strategy": "1.16.10",
     "@mysten/dapp-kit": "0.14.18",
     "@mysten/sui": "1.21.2",
+    "near-api-js": "7.1.1",
     "@solana/spl-token": "0.4.9",
     "@solana/wallet-adapter-react": "0.15.35",
     "@solana/wallet-adapter-wallets": "0.19.30",
@@ -46,8 +48,8 @@
     "wagmi": "2.16.9",
     "zustand": "4.5.2",
     "bs58": "6.0.0",
-    "@sodax/wallet-sdk-core": "1.2.7-beta",
-    "@sodax/types": "1.2.7-beta"
+    "@sodax/types": "1.3.0-beta",
+    "@sodax/wallet-sdk-core": "1.3.0-beta"
   },
   "devDependencies": {
     "@types/react": "^19.0.8",

package/src/actions/getXService.ts

@@ -4,6 +4,7 @@ import { IconXService, InjectiveXService, SolanaXService, StellarXService } from
 import { SuiXService } from '..';
 import { EvmXService } from '..';
 import type { XService } from '../core';
+import { NearXService } from '../xchains/near/NearXService';
 
 export function getXService(xChainType: ChainType): XService {
   switch (xChainType) {
@@ -19,6 +20,8 @@ export function getXService(xChainType: ChainType): XService {
       return InjectiveXService.getInstance();
     case 'STELLAR':
       return StellarXService.getInstance();
+    case 'NEAR':
+      return NearXService.getInstance();
     default:
       throw new Error(`Unsupported chain type: ${xChainType}`);
   }

package/src/hooks/useWalletProvider.ts

@@ -3,6 +3,7 @@ import type {
   IEvmWalletProvider,
   IIconWalletProvider,
   IInjectiveWalletProvider,
+  INearWalletProvider,
   ISolanaWalletProvider,
   IStellarWalletProvider,
   ISuiWalletProvider,
@@ -15,6 +16,7 @@ import {
   InjectiveWalletProvider,
   StellarWalletProvider,
   SolanaWalletProvider,
+  NearWalletProvider,
 } from '@sodax/wallet-sdk-core';
 import { getXChainType } from '../actions';
 import { usePublicClient, useWalletClient } from 'wagmi';
@@ -22,10 +24,11 @@ import { type SolanaXService, type StellarXService, useXAccount, useXService } f
 import type { SuiXService } from '../xchains/sui/SuiXService';
 import { CHAIN_INFO, SupportedChainId } from '../xchains/icon/IconXService';
 import type { InjectiveXService } from '../xchains/injective/InjectiveXService';
+import type { NearXService } from '../xchains/near/NearXService';
 
 /**
  * Hook to get the appropriate wallet provider based on the chain type.
- * Supports EVM, SUI, ICON and INJECTIVE chains.
+ * Supports EVM, SUI, ICON, INJECTIVE, STELLAR, SOLANA and NEAR chains.
  *
  * @param {ChainId | undefined} spokeChainId - The chain ID to get the wallet provider for. Can be any valid ChainId value.
  * @returns {EvmWalletProvider | SuiWalletProvider | IconWalletProvider | InjectiveWalletProvider | undefined}
@@ -49,6 +52,7 @@ export function useWalletProvider(
   | IInjectiveWalletProvider
   | IStellarWalletProvider
   | ISolanaWalletProvider
+  | INearWalletProvider
   | undefined {
   const xChainType = getXChainType(spokeChainId);
   // EVM-specific hooks
@@ -141,6 +145,15 @@ export function useWalletProvider(
         });
       }
 
+      case 'NEAR': {
+        const nearXService = xService as NearXService;
+        if (!nearXService.walletSelector) {
+          return undefined;
+        }
+
+        return new NearWalletProvider({ wallet: nearXService.walletSelector });
+      }
+
       default:
         return undefined;
     }

package/src/hooks/useXConnectors.ts

@@ -9,6 +9,7 @@ import { SolanaXConnector } from '../xchains/solana';
 import { useStellarXConnectors } from '../xchains/stellar/useStellarXConnectors';
 import { SuiXConnector } from '../xchains/sui';
 import { useXService } from './useXService';
+import { useNearXConnectors } from '../xchains/near/useNearXConnectors';
 
 /**
  * Hook to retrieve available wallet connectors for a specific blockchain type.
@@ -19,7 +20,7 @@ import { useXService } from './useXService';
  * - Stellar: Uses custom Stellar connectors
  * - Solana: Uses Solana wallet adapters (filtered to installed wallets only)
  *
- * @param xChainType - The blockchain type to get connectors for ('EVM' | 'SUI' | 'STELLAR' | 'SOLANA')
+ * @param xChainType - The blockchain type to get connectors for ('EVM' | 'SUI' | 'STELLAR' | 'SOLANA' | 'NEAR')
  * @returns An array of XConnector instances compatible with the specified chain type
  */
 
@@ -28,7 +29,7 @@ export function useXConnectors(xChainType: ChainType | undefined): XConnector[]
   const evmConnectors = useConnectors();
   const suiWallets = useWallets();
   const { data: stellarXConnectors } = useStellarXConnectors();
-
+  const { data: nearXConnectors } = useNearXConnectors();
   const { wallets: solanaWallets } = useWallet();
 
   const xConnectors = useMemo((): XConnector[] => {
@@ -47,10 +48,12 @@ export function useXConnectors(xChainType: ChainType | undefined): XConnector[]
         return solanaWallets
           .filter(wallet => wallet.readyState === 'Installed')
           .map(wallet => new SolanaXConnector(wallet));
+      case 'NEAR':
+        return nearXConnectors || [];
       default:
         return xService.getXConnectors();
     }
-  }, [xService, xChainType, evmConnectors, suiWallets, stellarXConnectors, solanaWallets]);
+  }, [xService, xChainType, evmConnectors, suiWallets, stellarXConnectors, solanaWallets, nearXConnectors]);
 
   return xConnectors;
 }

package/src/hooks/useXDisconnect.ts

@@ -5,6 +5,7 @@ import { useCallback } from 'react';
 import { useDisconnect } from 'wagmi';
 import { getXService } from '../actions';
 import { useXWagmiStore } from '../useXWagmiStore';
+import type { NearXService } from '@/xchains/near/NearXService';
 
 /**
  * Hook for disconnecting from a specific blockchain wallet
@@ -47,6 +48,13 @@ export function useXDisconnect(): (xChainType: ChainType) => Promise<void> {
         case 'SOLANA':
           await solanaWallet.disconnect();
           break;
+
+        case 'NEAR': {
+          const nearXService = getXService('NEAR') as NearXService;
+          nearXService.walletSelector.disconnect();
+          break;
+        }
+
         default: {
           // Handle other chain types
           const xService = getXService(xChainType);

package/src/useXWagmiStore.ts

@@ -13,6 +13,7 @@ import { StellarXService } from './xchains/stellar';
 import { SuiXService } from './xchains/sui';
 import { IconXService } from './xchains/icon';
 import { IconHanaXConnector } from './xchains/icon/IconHanaXConnector';
+import { NearXService } from './xchains/near/NearXService';
 
 type XWagmiStore = {
   xServices: Partial<Record<ChainType, XService>>;
@@ -24,7 +25,7 @@ type XWagmiStore = {
 
 const initXServices = () => {
   const xServices = {};
-  ['EVM', 'INJECTIVE', 'STELLAR', 'SUI', 'SOLANA', 'ICON'].forEach(key => {
+  ['EVM', 'INJECTIVE', 'STELLAR', 'SUI', 'SOLANA', 'ICON', 'NEAR'].forEach(key => {
     const xChainType = key as ChainType;
 
     switch (xChainType) {
@@ -55,6 +56,10 @@ const initXServices = () => {
         xServices[xChainType] = IconXService.getInstance();
         xServices[xChainType].setXConnectors([new IconHanaXConnector()]);
         break;
+      case 'NEAR':
+        xServices[xChainType] = NearXService.getInstance();
+        xServices[xChainType].setXConnectors([]);
+        break;
       default:
         break;
     }

package/src/xchains/near/NearXConnector.ts

@@ -0,0 +1,42 @@
+import type { XAccount } from '@/types';
+
+import { XConnector } from '@/core';
+import type { NearWalletBase } from '@hot-labs/near-connect';
+import { NearXService } from './NearXService';
+
+export class NearXConnector extends XConnector {
+  _wallet: NearWalletBase;
+
+  constructor(wallet: NearWalletBase) {
+    super('NEAR', wallet.manifest.name, wallet.manifest.id);
+    this._wallet = wallet;
+  }
+
+  getXService(): NearXService {
+    return NearXService.getInstance();
+  }
+
+  async connect(): Promise<XAccount | undefined> {
+    const walletSelector = this.getXService().walletSelector;
+    const wallet = await walletSelector.connect({ walletId: this._wallet.manifest.id });
+    const accounts = await wallet.getAccounts();
+
+    if (accounts.length === 0 || accounts[0] === undefined) {
+      return undefined;
+    }
+
+    return {
+      address: accounts[0].accountId,
+      xChainType: this.xChainType,
+    };
+  }
+
+  async disconnect(): Promise<void> {
+    const walletSelector = this.getXService().walletSelector;
+    await walletSelector.disconnect(this._wallet);
+  }
+
+  public get icon() {
+    return this._wallet.manifest.icon;
+  }
+}

package/src/xchains/near/NearXService.ts

@@ -0,0 +1,46 @@
+import { XService } from '@/core/XService';
+import type { XToken } from '@sodax/types';
+import { NearConnector } from '@hot-labs/near-connect';
+import { JsonRpcProvider } from 'near-api-js';
+
+export class NearXService extends XService {
+  private static instance: NearXService;
+
+  public walletSelector: NearConnector;
+
+  private constructor() {
+    super('NEAR');
+
+    this.walletSelector = new NearConnector({
+      network: 'mainnet',
+      logger: console,
+      autoConnect: true,
+      excludedWallets: ['okx-wallet'],
+    });
+  }
+
+  public static getInstance(): NearXService {
+    if (!NearXService.instance) {
+      NearXService.instance = new NearXService();
+    }
+    return NearXService.instance;
+  }
+
+  async getBalance(address: string | undefined, xToken: XToken): Promise<bigint> {
+    const url = 'https://1rpc.io/near';
+    // reference: https://near.github.io/near-api-js/classes/_near-js_providers.json-rpc-provider.JsonRpcProvider.html
+    const provider = new JsonRpcProvider({ url });
+
+    // get native balance
+    if (xToken.symbol === 'NEAR') {
+      const account = await provider.viewAccount({ accountId: address ?? '' });
+      return BigInt(account.amount);
+    }
+
+    // Near Fungible Token Standard(https://github.com/near/NEPs/blob/master/neps/nep-0141.md)
+    // get balance of the token
+
+    const res = await provider.callFunction<number>({ contractId: xToken.address, method: 'ft_balance_of', args: { account_id: address } });
+    return BigInt(res ?? 0);
+  }
+}

package/src/xchains/near/useNearXConnectors.ts

@@ -0,0 +1,23 @@
+import { useXService } from '@/hooks';
+import { type UseQueryResult, useQuery } from '@tanstack/react-query';
+
+import { NearXConnector } from './NearXConnector';
+import type { NearXService } from './NearXService';
+
+export const useNearXConnectors = (): UseQueryResult<NearXConnector[] | undefined, Error | null> => {
+  const xService = useXService('NEAR') as NearXService;
+
+  return useQuery({
+    queryKey: ['near-wallets'],
+    queryFn: async () => {
+      if (!xService) {
+        return [];
+      }
+
+      await xService.walletSelector.whenManifestLoaded;
+      const wallets = xService.walletSelector.availableWallets;
+
+      return wallets.map(wallet => new NearXConnector(wallet));
+    },
+  });
+};

package/src/xchains/stellar/StellarWalletsKitXConnector.ts

@@ -2,7 +2,15 @@ import type { XAccount } from '@/types';
 
 import { XConnector } from '@/core';
 import { StellarXService } from './StellarXService';
-import type { StellarWalletType } from './useStellarXConnectors';
+
+export type StellarWalletType = {
+  icon: string;
+  id: string;
+  isAvailable: boolean;
+  name: string;
+  type: string;
+  url: string;
+};
 
 export class StellarWalletsKitXConnector extends XConnector {
   _wallet: StellarWalletType;

package/src/xchains/stellar/useStellarXConnectors.ts

@@ -3,15 +3,6 @@ import { type UseQueryResult, useQuery } from '@tanstack/react-query';
 
 import { StellarWalletsKitXConnector, type StellarXService } from '.';
 
-export type StellarWalletType = {
-  icon: string;
-  id: string;
-  isAvailable: boolean;
-  name: string;
-  type: string;
-  url: string;
-};
-
 export const useStellarXConnectors = (): UseQueryResult<StellarWalletsKitXConnector[] | undefined, Error | null> => {
   const xService = useXService('STELLAR') as StellarXService;
 
@@ -22,7 +13,7 @@ export const useStellarXConnectors = (): UseQueryResult<StellarWalletsKitXConnec
         return [];
       }
 
-      const wallets: StellarWalletType[] = await xService.walletsKit.getSupportedWallets();
+      const wallets = await xService.walletsKit.getSupportedWallets();
 
       return wallets.filter(wallet => wallet.isAvailable).map(wallet => new StellarWalletsKitXConnector(wallet));
     },