react-near-ts 0.1.0

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["nearToken","nearGas","createMainnetClient","createTestnetClient"],"sources":["../src/store/NearStoreProvider.tsx","../src/hooks/useAccountInfo.ts","../src/hooks/useConnectedAccount.ts","../src/hooks/useContractReadFunction.ts","../src/hooks/useExecuteTransaction.ts","../src/hooks/useNearConnector.ts","../src/store/nearStore.ts","../src/_common/utils/result.ts","../src/services/nearConnector/executeTransaction/toNearConnectActions.ts","../src/services/nearConnector/executeTransaction/executeTransaction.ts","../src/services/nearConnector/nearConnector.ts","../src/providers/NearProvider.tsx","../src/providers/MainnetNearProvider.tsx","../src/providers/TestnetNearProdiver.tsx"],"sourcesContent":["import { createContext, useContext, type ReactNode } from 'react';\nimport type { NearStore, NearState } from '../../types/store.ts';\nimport { useStore } from 'zustand/react';\n\nconst NearStoreContext = createContext<NearStore | null>(null);\n\nexport const NearStoreProvider = (props: {\n  children: ReactNode;\n  nearStore: NearStore;\n}) => (\n  <NearStoreContext.Provider value={props.nearStore}>\n    {props.children}\n  </NearStoreContext.Provider>\n);\n\nexport const useNearStore = <T extends unknown>(\n  selector: (s: NearState) => T,\n): T => {\n  const store = useContext(NearStoreContext);\n\n  if (!store)\n    throw new Error('useNearStore must be used within NearStoreProvider'); // TODO throw ReactNearTsError\n\n  return useStore(store, selector);\n};\n","import { useQuery, skipToken } from '@tanstack/react-query';\nimport { useNearStore } from '../store/NearStoreProvider.tsx';\nimport type { UseAccountInfo } from '../../types/hooks/useAccountInfo.ts';\n\nexport const useAccountInfo: UseAccountInfo = (args) => {\n  const getContext = useNearStore((store) => store.getContext);\n  const context = getContext();\n\n  const { accountId, query, ...rest } = args;\n\n  return useQuery({\n    queryKey: ['getAccountInfo', accountId],\n    queryFn: accountId\n      ? (args) =>\n          context.client.getAccountInfo({\n            ...rest,\n            accountId,\n            options: { signal: args.signal },\n          })\n      : skipToken,\n    enabled: query?.enabled ?? true,\n  });\n};\n","import { useNearStore } from '../store/NearStoreProvider.tsx';\n\nexport const useConnectedAccount = () => {\n  const connectedAccountId = useNearStore((store) => store.connectedAccountId);\n  return {\n    connectedAccountId,\n    isConnectedAccount: typeof connectedAccountId === 'string',\n  };\n};\n","import { useQuery, skipToken } from '@tanstack/react-query';\nimport type {\n  InnerUseContractReadFunctionArgs,\n  UseContractReadFunction,\n} from '../../types/hooks/useContractReadFunction.ts';\nimport { useNearStore } from '../store/NearStoreProvider.tsx';\n\nexport const useContractReadFunction: UseContractReadFunction = (\n  args: InnerUseContractReadFunctionArgs,\n): ReturnType<UseContractReadFunction> => {\n  const getContext = useNearStore((store) => store.getContext);\n  const context = getContext();\n\n  const { query, contractAccountId, functionName, ...rest } = args;\n\n  return useQuery({\n    queryKey: ['callContractReadFunction', contractAccountId, functionName, rest.functionArgs],\n    queryFn:\n      contractAccountId && functionName\n        ? ({ signal }) =>\n            context.client.callContractReadFunction({\n              ...rest,\n              contractAccountId,\n              functionName,\n              options: {\n                ...rest.options,\n                signal,\n              },\n            })\n        : skipToken,\n    enabled: query?.enabled ?? true,\n  });\n};\n","import { useMutation } from '@tanstack/react-query';\nimport { useNearStore } from '../store/NearStoreProvider.tsx';\nimport type { StoreContext } from '../../types/store.ts';\nimport type {\n  UseExecuteTransaction,\n  ExecuteTransactionArgs,\n} from '../../types/hooks/useExecuteTransaction.ts';\n\nconst tryOnManySigners = async (args: ExecuteTransactionArgs, context: StoreContext) => {\n  const signers = context.signers;\n  if (signers.length === 0) throw new Error('No signers available');\n\n  const executeTransaction = async (signerIndex: number) => {\n    const signer = signers[signerIndex];\n\n    const result = await signer.safeExecuteTransaction({ intent: args.intent });\n    if (result.ok) return result.value;\n\n    // TODO right now we only support one signer - we will support multiple signers after adding\n    // canExecuteTransaction method to all signers\n    throw result.error;\n  };\n\n  return executeTransaction(0);\n};\n\nexport const useExecuteTransaction: UseExecuteTransaction = () => {\n  const getContext = useNearStore((s) => s.getContext);\n  const context = getContext();\n\n  return useMutation({\n    mutationFn: (args) => tryOnManySigners(args, context),\n  });\n};\n","import * as z from 'zod/mini';\nimport { NearConnector } from '@hot-labs/near-connect';\nimport { useNearStore } from '../store/NearStoreProvider.tsx';\nimport { useMutation } from '@tanstack/react-query';\nimport type { UseNearConnect } from '../../types/hooks/useNearConnect.ts';\n\nconst NearConnectorServiceSchema = z.object({\n  nearConnector: z.object({\n    serviceBox: z.object({\n      connector: z.instanceof(NearConnector),\n    }),\n  }),\n});\n\nexport const useNearConnector: UseNearConnect = () => {\n  const getContext = useNearStore((store) => store.getContext);\n  const setSigners = useNearStore((store) => store.setSigners);\n  const clearSigners = useNearStore((store) => store.clearSigners);\n  const setConnectedAccountId = useNearStore((store) => store.setConnectedAccountId);\n  const context = getContext();\n\n  const connect = useMutation<void, Error, void, unknown>({\n    mutationFn: async () => {\n      const services = NearConnectorServiceSchema.parse(context.services);\n      const connector = services.nearConnector.serviceBox.connector;\n\n      const wallet = await connector.connect();\n      const accounts = await wallet.getAccounts();\n      const connectedAccountId = accounts[0].accountId;\n\n      setSigners(connectedAccountId);\n      setConnectedAccountId(connectedAccountId);\n    },\n  });\n\n  const disconnect = useMutation<void, Error, void, unknown>({\n    mutationFn: async () => {\n      const services = NearConnectorServiceSchema.parse(context.services);\n      const connector = services.nearConnector.serviceBox.connector;\n\n      await connector.disconnect();\n      clearSigners();\n      setConnectedAccountId(undefined);\n    },\n  });\n\n  return {\n    connect,\n    disconnect,\n  };\n};\n","import { createStore } from 'zustand/vanilla';\nimport { persist } from 'zustand/middleware';\nimport type { AccountId } from 'near-api-ts';\nimport type { CreateNearStore, StoreContext, NearState } from '../../types/store.ts';\nimport type { ServiceId, Service } from '../../types/services/_common.ts';\n\nexport const createNearStore: CreateNearStore = (args) => {\n  // TODO Validate args\n  const { storeName = 'react-near-ts', networkId, clientCreator, serviceCreators } = args;\n\n  // TODO check if service already exists; If so - throw an error\n  const services = serviceCreators.reduce(\n    (acc, creator) => {\n      acc[creator.serviceId] = creator.createService();\n      return acc;\n    },\n    {} as Record<ServiceId, Service>,\n  );\n\n  // Create Context\n  const context: StoreContext = {\n    serviceCreators,\n    client: clientCreator(),\n    services,\n    signers: [],\n  };\n  const getContext = () => context;\n\n  const setSigners = (connectedAccountId: AccountId) => {\n    context.signers = context.serviceCreators.map((creator) =>\n      creator.createSigner({\n        signerAccountId: connectedAccountId,\n        client: context.client,\n        serviceBox: context.services[creator.serviceId].serviceBox,\n      }),\n    );\n  };\n\n  const clearSigners = () => {\n    context.signers = [];\n  };\n\n  // Create Store\n  return createStore<NearState>()(\n    persist(\n      (set) => ({\n        networkId,\n        connectedAccountId: undefined,\n        getContext,\n        setSigners,\n        clearSigners,\n        setConnectedAccountId: (connectedAccountId) => {\n          set(() => ({ connectedAccountId }));\n        },\n      }),\n      {\n        name: `${storeName}:${networkId}`,\n        version: 1,\n        partialize: (s) => ({ connectedAccountId: s.connectedAccountId }),\n        onRehydrateStorage: () => (state) => {\n          if (state?.connectedAccountId) state.setSigners(state.connectedAccountId);\n        },\n      },\n    ),\n  );\n};\n","import type { ResultErr, ResultOk } from '../../../types/_common.ts';\n\nexport const result = {\n  ok: <V>(value: V): ResultOk<V> => ({ ok: true, value }),\n  err: <E>(error: E): ResultErr<E> => ({ ok: false, error }),\n};\n","import { nearToken, nearGas } from 'near-api-ts';\nimport type { Action as NatAction, TransactionIntent } from 'near-api-ts';\nimport type { NearConnectAction } from '../../../../types/services/nearConnect.ts';\n\nconst toNearConnectAction = (action: NatAction): NearConnectAction => {\n  if (action.actionType === 'CreateAccount')\n    return {\n      createAccount: {},\n    };\n\n  if (action.actionType === 'Transfer')\n    return {\n      transfer: { deposit: nearToken(action.amount).yoctoNear },\n    };\n\n  if (action.actionType === 'AddKey')\n    return {\n      addKey: {\n        publicKey: action.publicKey,\n        accessKey: {\n          nonce: 0n, // deprecated field\n          permission:\n            action.accessType === 'FullAccess'\n              ? { fullAccess: {} }\n              : {\n                  functionCall: {\n                    receiverId: action.contractAccountId,\n                    methodNames: action.allowedFunctions,\n                    allowance: action.gasBudget ? nearToken(action.gasBudget).yoctoNear : undefined,\n                  },\n                },\n        },\n      },\n    };\n\n  if (action.actionType === 'FunctionCall')\n    return {\n      functionCall: {\n        methodName: action.functionName,\n        args: action.functionArgs,\n        gas: nearGas(action.gasLimit).gas,\n        deposit: action.attachedDeposit ? nearToken(action.attachedDeposit).yoctoNear : 0n,\n      },\n    };\n\n  if (action.actionType === 'DeployContract')\n    return {\n      deployContract: {\n        code: action.wasmBytes,\n      },\n    };\n\n  if (action.actionType === 'Stake')\n    return {\n      stake: {\n        stake: nearToken(action.amount).yoctoNear,\n        publicKey: action.validatorPublicKey,\n      },\n    };\n\n  if (action.actionType === 'DeleteKey')\n    return {\n      deleteKey: {\n        publicKey: action.publicKey,\n      },\n    };\n\n  if (action.actionType === 'DeleteAccount')\n    return {\n      deleteAccount: {\n        beneficiaryId: action.beneficiaryAccountId,\n      },\n    };\n\n  // Never reached\n  throw new Error(`Unsupported action type: ${action}`);\n};\n\nexport const toNearConnectActions = (intent: TransactionIntent): NearConnectAction[] => {\n  if (intent.action) return [toNearConnectAction(intent.action)];\n  if (intent.actions) return intent.actions.map((action) => toNearConnectAction(action));\n  return [];\n};\n","import { result } from '../../../_common/utils/result.ts';\nimport type { CreateSafeExecuteTransaction } from '../../../../types/services/nearConnect.ts';\nimport { toNearConnectActions } from './toNearConnectActions.ts';\n\nexport const createSafeExecuteTransaction: CreateSafeExecuteTransaction =\n  (connector) => async (args) => {\n    try {\n      const wallet = await connector.wallet();\n\n      const finalExecutionOutcome = await wallet.signAndSendTransaction({\n        actions: toNearConnectActions(args.intent),\n        receiverId: args.intent.receiverAccountId,\n      });\n\n      return result.ok({ rawRpcResult: finalExecutionOutcome });\n    } catch (e) {\n      return result.err(e);\n    }\n  };\n","import { NearConnector } from '@hot-labs/near-connect';\nimport { createSafeExecuteTransaction } from './executeTransaction/executeTransaction.ts';\nimport type { CreateNearConnectorService } from '../../../types/services/nearConnect.ts';\n\nconst serviceId = 'nearConnector';\n\nexport const createNearConnectorService: CreateNearConnectorService = (args) => ({\n  serviceId,\n\n  createService: () => {\n    const connector = new NearConnector({ network: args.networkId });\n    return {\n      serviceId,\n      serviceBox: { connector },\n    };\n  },\n\n  createSigner: (args: { serviceBox: { connector: NearConnector } }) => {\n    return {\n      serviceId,\n      safeExecuteTransaction: createSafeExecuteTransaction(args.serviceBox.connector),\n    };\n  },\n});\n","import { QueryClient, QueryClientProvider } from '@tanstack/react-query';\nimport { NearStoreProvider } from '../store/NearStoreProvider.tsx';\nimport type { ReactNode } from 'react';\nimport type { NearStore } from '../../types/store.ts';\n\nconst queryClient = new QueryClient({\n  defaultOptions: {\n    queries: { retry: false },\n    mutations: { retry: false },\n  },\n});\n\ntype NearProviderProps = {\n  nearStore: NearStore;\n  children: ReactNode;\n};\n\nexport const NearProvider = (props: NearProviderProps) => (\n  <NearStoreProvider nearStore={props.nearStore}>\n    <QueryClientProvider client={queryClient}>\n      {props.children}\n    </QueryClientProvider>\n  </NearStoreProvider>\n);\n","import { createNearStore } from '../store/nearStore.ts';\nimport { createMainnetClient } from 'near-api-ts';\nimport { createNearConnectorService } from '../services/nearConnector/nearConnector.ts';\nimport { NearProvider } from './NearProvider.tsx';\nimport type { ReactNode } from 'react';\n\nconst createMainnetNearStore = () =>\n  createNearStore({\n    networkId: 'mainnet',\n    clientCreator: createMainnetClient,\n    serviceCreators: [createNearConnectorService({ networkId: 'mainnet' })],\n  });\n\nexport const MainnetNearProvider = (props: { children: ReactNode }) => (\n  <NearProvider nearStore={createMainnetNearStore()}>{props.children}</NearProvider>\n);\n","import { createNearStore } from '../store/nearStore.ts';\nimport { createTestnetClient } from 'near-api-ts';\nimport { createNearConnectorService } from '../services/nearConnector/nearConnector.ts';\nimport { NearProvider } from './NearProvider.tsx';\nimport type { ReactNode } from 'react';\n\nconst createTestnetNearStore = () =>\n  createNearStore({\n    networkId: 'testnet',\n    clientCreator: createTestnetClient,\n    serviceCreators: [createNearConnectorService({ networkId: 'testnet' })],\n  });\n\nexport const TestnetNearProvider = (props: { children: ReactNode }) => (\n  <NearProvider nearStore={createTestnetNearStore()}>{props.children}</NearProvider>\n);\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "react-near-ts",
+  "version": "0.1.0",
+  "description": "TypeScript-first toolkit for integrating NEAR Protocol with your React application",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@tanstack/react-query": ">=5.90.21 <6",
+    "react": ">=19.2.0 <20",
+    "react-dom": ">=19.2.0 <20",
+    "zod": ">=4.3.0 <5"
+  },
+  "dependencies": {
+    "@hot-labs/near-connect": "^0.10.0",
+    "zustand": "^5.0.11",
+    "near-api-ts": "0.8.0"
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.90.21",
+    "@types/node": "^24.10.1",
+    "@types/react": "^19.2.5",
+    "@types/react-dom": "^19.2.3",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "tsdown": "0.20.3",
+    "zod": "^4.3.6"
+  },
+  "types": "./dist/index.d.mts",
+  "module": "./dist/index.mjs",
+  "main": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "types",
+    "package.json",
+    "LICENSE.md",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/near/near-api-ts.git",
+    "directory": "packages/react-near-ts"
+  },
+  "keywords": [
+    "near",
+    "near-protocol",
+    "near-api",
+    "react",
+    "react-query",
+    "typescript",
+    "web3",
+    "blockchain"
+  ],
+  "author": {
+    "name": "Volodymyr <eclipseeer> Bilyk",
+    "email": "volodymyr@lantstool.dev"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/_common/utils/result.ts

@@ -0,0 +1,6 @@
+import type { ResultErr, ResultOk } from '../../../types/_common.ts';
+
+export const result = {
+  ok: <V>(value: V): ResultOk<V> => ({ ok: true, value }),
+  err: <E>(error: E): ResultErr<E> => ({ ok: false, error }),
+};

package/src/hooks/useAccountInfo.ts

@@ -0,0 +1,23 @@
+import { useQuery, skipToken } from '@tanstack/react-query';
+import { useNearStore } from '../store/NearStoreProvider.tsx';
+import type { UseAccountInfo } from '../../types/hooks/useAccountInfo.ts';
+
+export const useAccountInfo: UseAccountInfo = (args) => {
+  const getContext = useNearStore((store) => store.getContext);
+  const context = getContext();
+
+  const { accountId, query, ...rest } = args;
+
+  return useQuery({
+    queryKey: ['getAccountInfo', accountId],
+    queryFn: accountId
+      ? (args) =>
+          context.client.getAccountInfo({
+            ...rest,
+            accountId,
+            options: { signal: args.signal },
+          })
+      : skipToken,
+    enabled: query?.enabled ?? true,
+  });
+};

package/src/hooks/useConnectedAccount.ts

@@ -0,0 +1,9 @@
+import { useNearStore } from '../store/NearStoreProvider.tsx';
+
+export const useConnectedAccount = () => {
+  const connectedAccountId = useNearStore((store) => store.connectedAccountId);
+  return {
+    connectedAccountId,
+    isConnectedAccount: typeof connectedAccountId === 'string',
+  };
+};

package/src/hooks/useContractReadFunction.ts

@@ -0,0 +1,33 @@
+import { useQuery, skipToken } from '@tanstack/react-query';
+import type {
+  InnerUseContractReadFunctionArgs,
+  UseContractReadFunction,
+} from '../../types/hooks/useContractReadFunction.ts';
+import { useNearStore } from '../store/NearStoreProvider.tsx';
+
+export const useContractReadFunction: UseContractReadFunction = (
+  args: InnerUseContractReadFunctionArgs,
+): ReturnType<UseContractReadFunction> => {
+  const getContext = useNearStore((store) => store.getContext);
+  const context = getContext();
+
+  const { query, contractAccountId, functionName, ...rest } = args;
+
+  return useQuery({
+    queryKey: ['callContractReadFunction', contractAccountId, functionName, rest.functionArgs],
+    queryFn:
+      contractAccountId && functionName
+        ? ({ signal }) =>
+            context.client.callContractReadFunction({
+              ...rest,
+              contractAccountId,
+              functionName,
+              options: {
+                ...rest.options,
+                signal,
+              },
+            })
+        : skipToken,
+    enabled: query?.enabled ?? true,
+  });
+};

package/src/hooks/useExecuteTransaction.ts

@@ -0,0 +1,34 @@
+import { useMutation } from '@tanstack/react-query';
+import { useNearStore } from '../store/NearStoreProvider.tsx';
+import type { StoreContext } from '../../types/store.ts';
+import type {
+  UseExecuteTransaction,
+  ExecuteTransactionArgs,
+} from '../../types/hooks/useExecuteTransaction.ts';
+
+const tryOnManySigners = async (args: ExecuteTransactionArgs, context: StoreContext) => {
+  const signers = context.signers;
+  if (signers.length === 0) throw new Error('No signers available');
+
+  const executeTransaction = async (signerIndex: number) => {
+    const signer = signers[signerIndex];
+
+    const result = await signer.safeExecuteTransaction({ intent: args.intent });
+    if (result.ok) return result.value;
+
+    // TODO right now we only support one signer - we will support multiple signers after adding
+    // canExecuteTransaction method to all signers
+    throw result.error;
+  };
+
+  return executeTransaction(0);
+};
+
+export const useExecuteTransaction: UseExecuteTransaction = () => {
+  const getContext = useNearStore((s) => s.getContext);
+  const context = getContext();
+
+  return useMutation({
+    mutationFn: (args) => tryOnManySigners(args, context),
+  });
+};

package/src/hooks/useNearConnector.ts

@@ -0,0 +1,51 @@
+import * as z from 'zod/mini';
+import { NearConnector } from '@hot-labs/near-connect';
+import { useNearStore } from '../store/NearStoreProvider.tsx';
+import { useMutation } from '@tanstack/react-query';
+import type { UseNearConnect } from '../../types/hooks/useNearConnect.ts';
+
+const NearConnectorServiceSchema = z.object({
+  nearConnector: z.object({
+    serviceBox: z.object({
+      connector: z.instanceof(NearConnector),
+    }),
+  }),
+});
+
+export const useNearConnector: UseNearConnect = () => {
+  const getContext = useNearStore((store) => store.getContext);
+  const setSigners = useNearStore((store) => store.setSigners);
+  const clearSigners = useNearStore((store) => store.clearSigners);
+  const setConnectedAccountId = useNearStore((store) => store.setConnectedAccountId);
+  const context = getContext();
+
+  const connect = useMutation<void, Error, void, unknown>({
+    mutationFn: async () => {
+      const services = NearConnectorServiceSchema.parse(context.services);
+      const connector = services.nearConnector.serviceBox.connector;
+
+      const wallet = await connector.connect();
+      const accounts = await wallet.getAccounts();
+      const connectedAccountId = accounts[0].accountId;
+
+      setSigners(connectedAccountId);
+      setConnectedAccountId(connectedAccountId);
+    },
+  });
+
+  const disconnect = useMutation<void, Error, void, unknown>({
+    mutationFn: async () => {
+      const services = NearConnectorServiceSchema.parse(context.services);
+      const connector = services.nearConnector.serviceBox.connector;
+
+      await connector.disconnect();
+      clearSigners();
+      setConnectedAccountId(undefined);
+    },
+  });
+
+  return {
+    connect,
+    disconnect,
+  };
+};

package/src/index.ts

@@ -0,0 +1,44 @@
+'use client';
+
+// Lib
+export { useAccountInfo } from './hooks/useAccountInfo.ts';
+export { useConnectedAccount } from './hooks/useConnectedAccount.ts';
+export { useContractReadFunction } from './hooks/useContractReadFunction.ts';
+export { useExecuteTransaction } from './hooks/useExecuteTransaction.ts';
+export { useNearConnector } from './hooks/useNearConnector.ts';
+export { MainnetNearProvider } from './providers/MainnetNearProvider.tsx';
+export { NearProvider } from './providers/NearProvider.tsx';
+export { TestnetNearProvider } from './providers/TestnetNearProdiver.tsx';
+export { createNearStore } from './store/nearStore.ts';
+export { createNearConnectorService } from './services/nearConnector/nearConnector.ts';
+
+// near-api-ts reexports
+export {
+  createTestnetClient,
+  createMainnetClient,
+  createClient,
+  // actionCreators
+  createAccount,
+  transfer,
+  addFullAccessKey,
+  addFunctionCallKey,
+  functionCall,
+  deployContract,
+  stake,
+  deleteKey,
+  deleteAccount,
+  //utils
+  keyPair,
+  randomEd25519KeyPair,
+  randomSecp256k1KeyPair,
+  nearToken,
+  near,
+  yoctoNear,
+  nearGas,
+  gas,
+  teraGas,
+  fromJsonBytes,
+  toJsonBytes,
+} from 'near-api-ts';
+
+export type { DeserializeResultFnArgs } from 'near-api-ts';

package/src/providers/MainnetNearProvider.tsx

@@ -0,0 +1,16 @@
+import { createNearStore } from '../store/nearStore.ts';
+import { createMainnetClient } from 'near-api-ts';
+import { createNearConnectorService } from '../services/nearConnector/nearConnector.ts';
+import { NearProvider } from './NearProvider.tsx';
+import type { ReactNode } from 'react';
+
+const createMainnetNearStore = () =>
+  createNearStore({
+    networkId: 'mainnet',
+    clientCreator: createMainnetClient,
+    serviceCreator: createNearConnectorService({ networkId: 'mainnet' }),
+  });
+
+export const MainnetNearProvider = (props: { children: ReactNode }) => (
+  <NearProvider nearStore={createMainnetNearStore()}>{props.children}</NearProvider>
+);

package/src/providers/NearProvider.tsx

@@ -0,0 +1,24 @@
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { NearStoreProvider } from '../store/NearStoreProvider.tsx';
+import type { ReactNode } from 'react';
+import type { NearStore } from '../../types/store.ts';
+
+const queryClient = new QueryClient({
+  defaultOptions: {
+    queries: { retry: false },
+    mutations: { retry: false },
+  },
+});
+
+type NearProviderProps = {
+  nearStore: NearStore;
+  children: ReactNode;
+};
+
+export const NearProvider = (props: NearProviderProps) => (
+  <NearStoreProvider nearStore={props.nearStore}>
+    <QueryClientProvider client={queryClient}>
+      {props.children}
+    </QueryClientProvider>
+  </NearStoreProvider>
+);

package/src/providers/TestnetNearProdiver.tsx

@@ -0,0 +1,16 @@
+import { createNearStore } from '../store/nearStore.ts';
+import { createTestnetClient } from 'near-api-ts';
+import { createNearConnectorService } from '../services/nearConnector/nearConnector.ts';
+import { NearProvider } from './NearProvider.tsx';
+import type { ReactNode } from 'react';
+
+const createTestnetNearStore = () =>
+  createNearStore({
+    networkId: 'testnet',
+    clientCreator: createTestnetClient,
+    serviceCreator: createNearConnectorService({ networkId: 'testnet' }),
+  });
+
+export const TestnetNearProvider = (props: { children: ReactNode }) => (
+  <NearProvider nearStore={createTestnetNearStore()}>{props.children}</NearProvider>
+);

package/src/services/memory/memory.ts

@@ -0,0 +1,22 @@
+// import { createMemoryKeyService, createMemorySigner } from 'near-api-ts';
+//
+// export const createMemoryServiceFactory = ({
+//   keySources,
+//   // signer: { taskQueue },
+// }: any) => {
+//   return {
+//     serviceId: 'memory',
+//     createService: () => {
+//       const keyService = createMemoryKeyService({ keySources });
+//       return { keyService };
+//     },
+//     // args should be general and one for all services;
+//     createSigner: ({ signerAccountId, client, service }: any) =>
+//       createMemorySigner({
+//         signerAccountId,
+//         client,
+//         keyService: service.keyService,
+//       }),
+//   };
+// };
+

package/src/services/nearConnector/executeTransaction/executeTransaction.ts

@@ -0,0 +1,19 @@
+import { result } from '../../../_common/utils/result.ts';
+import type { CreateSafeExecuteTransaction } from '../../../../types/services/nearConnect.ts';
+import { toNearConnectActions } from './toNearConnectActions.ts';
+
+export const createSafeExecuteTransaction: CreateSafeExecuteTransaction =
+  (connector) => async (args) => {
+    try {
+      const wallet = await connector.wallet();
+
+      const finalExecutionOutcome = await wallet.signAndSendTransaction({
+        actions: toNearConnectActions(args.intent),
+        receiverId: args.intent.receiverAccountId,
+      });
+
+      return result.ok({ rawRpcResult: finalExecutionOutcome });
+    } catch (e) {
+      return result.err(e);
+    }
+  };

package/src/services/nearConnector/executeTransaction/toNearConnectActions.ts

@@ -0,0 +1,83 @@
+import { nearToken, nearGas } from 'near-api-ts';
+import type { Action as NatAction, TransactionIntent } from 'near-api-ts';
+import type { NearConnectAction } from '../../../../types/services/nearConnect.ts';
+
+const toNearConnectAction = (action: NatAction): NearConnectAction => {
+  if (action.actionType === 'CreateAccount')
+    return {
+      createAccount: {},
+    };
+
+  if (action.actionType === 'Transfer')
+    return {
+      transfer: { deposit: nearToken(action.amount).yoctoNear },
+    };
+
+  if (action.actionType === 'AddKey')
+    return {
+      addKey: {
+        publicKey: action.publicKey,
+        accessKey: {
+          nonce: 0n, // deprecated field
+          permission:
+            action.accessType === 'FullAccess'
+              ? { fullAccess: {} }
+              : {
+                  functionCall: {
+                    receiverId: action.contractAccountId,
+                    methodNames: action.allowedFunctions,
+                    allowance: action.gasBudget ? nearToken(action.gasBudget).yoctoNear : undefined,
+                  },
+                },
+        },
+      },
+    };
+
+  if (action.actionType === 'FunctionCall')
+    return {
+      functionCall: {
+        methodName: action.functionName,
+        args: action.functionArgs,
+        gas: nearGas(action.gasLimit).gas,
+        deposit: action.attachedDeposit ? nearToken(action.attachedDeposit).yoctoNear : 0n,
+      },
+    };
+
+  if (action.actionType === 'DeployContract')
+    return {
+      deployContract: {
+        code: action.wasmBytes,
+      },
+    };
+
+  if (action.actionType === 'Stake')
+    return {
+      stake: {
+        stake: nearToken(action.amount).yoctoNear,
+        publicKey: action.validatorPublicKey,
+      },
+    };
+
+  if (action.actionType === 'DeleteKey')
+    return {
+      deleteKey: {
+        publicKey: action.publicKey,
+      },
+    };
+
+  if (action.actionType === 'DeleteAccount')
+    return {
+      deleteAccount: {
+        beneficiaryId: action.beneficiaryAccountId,
+      },
+    };
+
+  // Never reached
+  throw new Error(`Unsupported action type: ${action}`);
+};
+
+export const toNearConnectActions = (intent: TransactionIntent): NearConnectAction[] => {
+  if (intent.action) return [toNearConnectAction(intent.action)];
+  if (intent.actions) return intent.actions.map((action) => toNearConnectAction(action));
+  return [];
+};

package/src/services/nearConnector/nearConnector.ts

@@ -0,0 +1,24 @@
+import { NearConnector } from '@hot-labs/near-connect';
+import { createSafeExecuteTransaction } from './executeTransaction/executeTransaction.ts';
+import type { CreateNearConnectorService } from '../../../types/services/nearConnect.ts';
+
+const serviceId = 'nearConnector';
+
+export const createNearConnectorService: CreateNearConnectorService = (args) => ({
+  serviceId,
+
+  createService: () => {
+    const connector = new NearConnector({ network: args.networkId });
+    return {
+      serviceId,
+      serviceBox: { connector },
+    };
+  },
+
+  createSigner: (args: { serviceBox: { connector: NearConnector } }) => {
+    return {
+      serviceId,
+      safeExecuteTransaction: createSafeExecuteTransaction(args.serviceBox.connector),
+    };
+  },
+});

package/src/store/NearStoreProvider.tsx

@@ -0,0 +1,25 @@
+import { createContext, useContext, type ReactNode } from 'react';
+import type { NearStore, NearState } from '../../types/store.ts';
+import { useStore } from 'zustand/react';
+
+const NearStoreContext = createContext<NearStore | null>(null);
+
+export const NearStoreProvider = (props: {
+  children: ReactNode;
+  nearStore: NearStore;
+}) => (
+  <NearStoreContext.Provider value={props.nearStore}>
+    {props.children}
+  </NearStoreContext.Provider>
+);
+
+export const useNearStore = <T extends unknown>(
+  selector: (s: NearState) => T,
+): T => {
+  const store = useContext(NearStoreContext);
+
+  if (!store)
+    throw new Error('useNearStore must be used within NearStoreProvider'); // TODO throw ReactNearTsError
+
+  return useStore(store, selector);
+};

package/src/store/nearStore.ts

@@ -0,0 +1,68 @@
+import { createStore } from 'zustand/vanilla';
+import { persist } from 'zustand/middleware';
+import type { AccountId } from 'near-api-ts';
+import type { CreateNearStore, StoreContext, NearState } from '../../types/store.ts';
+import type { ServiceId, Service } from '../../types/services/_common.ts';
+
+export const createNearStore: CreateNearStore = (args) => {
+  // TODO Validate args
+  const { storeName = 'react-near-ts', networkId, clientCreator, serviceCreator } = args;
+  // Temporary until we will support multiple services
+  const serviceCreators = [serviceCreator];
+
+  // TODO check if service already exists; If so - throw an error
+  const services = serviceCreators.reduce(
+    (acc, creator) => {
+      acc[creator.serviceId] = creator.createService();
+      return acc;
+    },
+    {} as Record<ServiceId, Service>,
+  );
+
+  // Create Context
+  const context: StoreContext = {
+    serviceCreators,
+    client: clientCreator(),
+    services,
+    signers: [],
+  };
+  const getContext = () => context;
+
+  const setSigners = (connectedAccountId: AccountId) => {
+    context.signers = context.serviceCreators.map((creator) =>
+      creator.createSigner({
+        signerAccountId: connectedAccountId,
+        client: context.client,
+        serviceBox: context.services[creator.serviceId].serviceBox,
+      }),
+    );
+  };
+
+  const clearSigners = () => {
+    context.signers = [];
+  };
+
+  // Create Store
+  return createStore<NearState>()(
+    persist(
+      (set) => ({
+        networkId,
+        connectedAccountId: undefined,
+        getContext,
+        setSigners,
+        clearSigners,
+        setConnectedAccountId: (connectedAccountId) => {
+          set(() => ({ connectedAccountId }));
+        },
+      }),
+      {
+        name: `${storeName}:${networkId}`,
+        version: 1,
+        partialize: (s) => ({ connectedAccountId: s.connectedAccountId }),
+        onRehydrateStorage: () => (state) => {
+          if (state?.connectedAccountId) state.setSigners(state.connectedAccountId);
+        },
+      },
+    ),
+  );
+};

package/types/_common.ts

@@ -0,0 +1,7 @@
+export type KeyIf<K extends PropertyKey, V> = [V] extends [undefined]
+  ? { [P in K]?: never }
+  : { [P in K]: V };
+
+export type ResultOk<V> = { ok: true; value: V };
+export type ResultErr<E> = { ok: false; error: E };
+export type Result<V, E> = ResultOk<V> | ResultErr<E>;