genlayer-js 0.6.3 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 
 
+## 0.7.0 (2025-03-05)
+
+
+### Features
+
+* connect ([#58](https://github.com/yeagerai/genlayer-js/issues/58)) ([7e396c7](https://github.com/yeagerai/genlayer-js/commit/7e396c765536ef0ec1a81c259c113587dc6de8ee))
+
+## 0.6.4 (2025-02-04)
+
+
+### Bug Fixes
+
+* override chain endpoint if extra config provided ([#68](https://github.com/yeagerai/genlayer-js/issues/68)) ([215185a](https://github.com/yeagerai/genlayer-js/commit/215185a4f96d44a60ea1ad4b55c71bd0bdc489f6))
+
 ## 0.6.3 (2025-01-28)
 
 ## 0.6.2 (2025-01-20)

package/README.md

@@ -26,11 +26,11 @@ Here’s how to initialize the client and connect to the GenLayer Simulator:
 
 ### Reading a Transaction
 ```typescript
-import { simulator } from 'genlayer-js/chains';
+import { localnet } from 'genlayer-js/chains';
 import { createClient } from "genlayer-js";
 
 const client = createClient({
-  chain: simulator,
+  chain: localnet,
 });
 
 const transactionHash = "0x...";
@@ -40,11 +40,11 @@ const transaction = await client.getTransaction({ hash: transactionHash })
 
 ### Reading a contract
 ```typescript
-import { simulator } from 'genlayer-js/chains';
+import { localnet } from 'genlayer-js/chains';
 import { createClient } from "genlayer-js";
 
 const client = createClient({
-  chain: simulator,
+  chain: localnet,
 });
 
 const result = await client.readContract({
@@ -58,11 +58,11 @@ const result = await client.readContract({
 
 ### Writing a transaction
 ```typescript
-import { simulator } from 'genlayer-js/chains';
+import { localnet } from 'genlayer-js/chains';
 import { createClient, createAccount } from "genlayer-js";
 
 const client = createClient({
-  network: simulator,
+  network: localnet,
 });
 
 const account = createAccount();

package/dist/chains/index.cjs

@@ -1,7 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkXAQMWSP4cjs = require('../chunk-XAQMWSP4.cjs');
+
+var _chunkI6HC44KDcjs = require('../chunk-I6HC44KD.cjs');
 require('../chunk-75ZPJI57.cjs');
 
 
-exports.simulator = _chunkXAQMWSP4cjs.simulator;
+
+exports.localnet = _chunkI6HC44KDcjs.localnet; exports.simulator = _chunkI6HC44KDcjs.simulator;

package/dist/chains/index.d.cts

@@ -1,3 +1,3 @@
-export { s as simulator } from '../index-CHQn8ZME.cjs';
+export { l as localnet, s as simulator } from '../index-B8E0qiOq.cjs';
 import '../chains-C5PI_Nr_.cjs';
 import 'viem';

package/dist/chains/index.d.ts

@@ -1,3 +1,3 @@
-export { s as simulator } from '../index-CioK5j0r.js';
+export { l as localnet, s as simulator } from '../index-ZoW0HQ_m.js';
 import '../chains-C5PI_Nr_.js';
 import 'viem';

package/dist/chains/index.js

@@ -1,7 +1,9 @@
 import {
+  localnet,
   simulator
-} from "../chunk-O3T2C57T.js";
+} from "../chunk-WEXFFND6.js";
 import "../chunk-MLKGABMK.js";
 export {
+  localnet,
   simulator
 };

package/dist/{chunk-XAQMWSP4.cjs → chunk-I6HC44KD.cjs}

@@ -5,15 +5,16 @@ var _chunk75ZPJI57cjs = require('./chunk-75ZPJI57.cjs');
 // src/chains/index.ts
 var chains_exports = {};
 _chunk75ZPJI57cjs.__export.call(void 0, chains_exports, {
+  localnet: () => localnet,
   simulator: () => simulator
 });
 
-// src/chains/simulator.ts
+// src/chains/localnet.ts
 var _viem = require('viem');
 var SIMULATOR_JSON_RPC_URL = "http://127.0.0.1:4000/api";
-var simulator = _viem.defineChain.call(void 0, {
+var localnet = _viem.defineChain.call(void 0, {
   id: 61999,
-  name: "GenLayer Simulator",
+  name: "Genlayer Localnet",
   rpcUrls: {
     default: {
       http: [SIMULATOR_JSON_RPC_URL]
@@ -36,7 +37,36 @@ var simulator = _viem.defineChain.call(void 0, {
   defaultConsensusMaxRotations: 3
 });
 
+// src/chains/simulator.ts
+
+var SIMULATOR_JSON_RPC_URL2 = "http://127.0.0.1:4000/api";
+var simulator = _viem.defineChain.call(void 0, {
+  id: 61999,
+  name: "GenLayer Simulator",
+  rpcUrls: {
+    default: {
+      http: [SIMULATOR_JSON_RPC_URL2]
+    }
+  },
+  nativeCurrency: {
+    name: "GEN Token",
+    symbol: "GEN",
+    decimals: 18
+  },
+  blockExplorers: {
+    default: {
+      name: "GenLayer Explorer",
+      url: SIMULATOR_JSON_RPC_URL2
+    }
+  },
+  testnet: true,
+  consensusMainContract: null,
+  defaultNumberOfInitialValidators: 5,
+  defaultConsensusMaxRotations: 3
+});
+
+
 
 
 
-exports.simulator = simulator; exports.chains_exports = chains_exports;
+exports.localnet = localnet; exports.simulator = simulator; exports.chains_exports = chains_exports;

package/dist/{chunk-O3T2C57T.js → chunk-WEXFFND6.js}

@@ -5,15 +5,16 @@ import {
 // src/chains/index.ts
 var chains_exports = {};
 __export(chains_exports, {
+  localnet: () => localnet,
   simulator: () => simulator
 });
 
-// src/chains/simulator.ts
+// src/chains/localnet.ts
 import { defineChain } from "viem";
 var SIMULATOR_JSON_RPC_URL = "http://127.0.0.1:4000/api";
-var simulator = defineChain({
+var localnet = defineChain({
   id: 61999,
-  name: "GenLayer Simulator",
+  name: "Genlayer Localnet",
   rpcUrls: {
     default: {
       http: [SIMULATOR_JSON_RPC_URL]
@@ -36,7 +37,36 @@ var simulator = defineChain({
   defaultConsensusMaxRotations: 3
 });
 
+// src/chains/simulator.ts
+import { defineChain as defineChain2 } from "viem";
+var SIMULATOR_JSON_RPC_URL2 = "http://127.0.0.1:4000/api";
+var simulator = defineChain2({
+  id: 61999,
+  name: "GenLayer Simulator",
+  rpcUrls: {
+    default: {
+      http: [SIMULATOR_JSON_RPC_URL2]
+    }
+  },
+  nativeCurrency: {
+    name: "GEN Token",
+    symbol: "GEN",
+    decimals: 18
+  },
+  blockExplorers: {
+    default: {
+      name: "GenLayer Explorer",
+      url: SIMULATOR_JSON_RPC_URL2
+    }
+  },
+  testnet: true,
+  consensusMainContract: null,
+  defaultNumberOfInitialValidators: 5,
+  defaultConsensusMaxRotations: 3
+});
+
 export {
+  localnet,
   simulator,
   chains_exports
 };

package/dist/index-B8E0qiOq.d.cts

@@ -0,0 +1,13 @@
+import { S as SimulatorChain } from './chains-C5PI_Nr_.cjs';
+
+declare const localnet: SimulatorChain;
+
+declare const simulator: SimulatorChain;
+
+declare const index_localnet: typeof localnet;
+declare const index_simulator: typeof simulator;
+declare namespace index {
+  export { index_localnet as localnet, index_simulator as simulator };
+}
+
+export { index as i, localnet as l, simulator as s };

package/dist/{index-vnyqXaRU.d.ts → index-CpcNUbXb.d.ts}

@@ -91,6 +91,16 @@ type ContractSchema = {
     methods: ContractMethod[];
 };
 
+type Network = 'localnet' | 'testnet' | 'mainnet';
+
+type SnapSource = 'npm' | 'local';
+
+type MetaMaskClientResult = {
+    isFlask: boolean;
+    installedSnaps: Record<string, any>;
+    isGenLayerSnapInstalled: boolean;
+};
+
 type GenLayerMethod = {
     method: "sim_fundAccount";
     params: [address: string, amount: number];
@@ -168,6 +178,8 @@ type GenLayerClient<TSimulatorChain extends SimulatorChain> = Omit<Client<Transp
     getContractSchema: (address: string) => Promise<ContractSchema>;
     getContractSchemaForCode: (contractCode: string | Uint8Array) => Promise<ContractSchema>;
     initializeConsensusSmartContract: (forceReset?: boolean) => Promise<void>;
+    connect: (network?: Network, snapSource?: SnapSource) => Promise<void>;
+    metamaskClient: (snapSource?: SnapSource) => Promise<MetaMaskClientResult>;
 };
 
-export { type Address as A, type CalldataEncodable as C, type GenLayerClient as G, type MethodDescription as M, type TransactionDataElement$1 as T, CalldataAddress as a, type GenLayerMethod as b, type ContractParamsArraySchemaElement as c, type ContractParamsSchema as d, type ContractMethodBase as e, type ContractMethod as f, type ContractSchema as g, type TransactionHash as h, TransactionStatus as i, type GenLayerTransaction as j, type TransactionDataElement as k };
+export { type Address as A, type CalldataEncodable as C, type GenLayerClient as G, type MethodDescription as M, type Network as N, type SnapSource as S, type TransactionDataElement$1 as T, CalldataAddress as a, type GenLayerMethod as b, type ContractParamsArraySchemaElement as c, type ContractParamsSchema as d, type ContractMethodBase as e, type ContractMethod as f, type ContractSchema as g, type TransactionHash as h, TransactionStatus as i, type GenLayerTransaction as j, type TransactionDataElement as k };

package/dist/{index-FMf4Unm0.d.cts → index-DJTO3-o3.d.cts}

@@ -91,6 +91,16 @@ type ContractSchema = {
     methods: ContractMethod[];
 };
 
+type Network = 'localnet' | 'testnet' | 'mainnet';
+
+type SnapSource = 'npm' | 'local';
+
+type MetaMaskClientResult = {
+    isFlask: boolean;
+    installedSnaps: Record<string, any>;
+    isGenLayerSnapInstalled: boolean;
+};
+
 type GenLayerMethod = {
     method: "sim_fundAccount";
     params: [address: string, amount: number];
@@ -168,6 +178,8 @@ type GenLayerClient<TSimulatorChain extends SimulatorChain> = Omit<Client<Transp
     getContractSchema: (address: string) => Promise<ContractSchema>;
     getContractSchemaForCode: (contractCode: string | Uint8Array) => Promise<ContractSchema>;
     initializeConsensusSmartContract: (forceReset?: boolean) => Promise<void>;
+    connect: (network?: Network, snapSource?: SnapSource) => Promise<void>;
+    metamaskClient: (snapSource?: SnapSource) => Promise<MetaMaskClientResult>;
 };
 
-export { type Address as A, type CalldataEncodable as C, type GenLayerClient as G, type MethodDescription as M, type TransactionDataElement$1 as T, CalldataAddress as a, type GenLayerMethod as b, type ContractParamsArraySchemaElement as c, type ContractParamsSchema as d, type ContractMethodBase as e, type ContractMethod as f, type ContractSchema as g, type TransactionHash as h, TransactionStatus as i, type GenLayerTransaction as j, type TransactionDataElement as k };
+export { type Address as A, type CalldataEncodable as C, type GenLayerClient as G, type MethodDescription as M, type Network as N, type SnapSource as S, type TransactionDataElement$1 as T, CalldataAddress as a, type GenLayerMethod as b, type ContractParamsArraySchemaElement as c, type ContractParamsSchema as d, type ContractMethodBase as e, type ContractMethod as f, type ContractSchema as g, type TransactionHash as h, TransactionStatus as i, type GenLayerTransaction as j, type TransactionDataElement as k };

package/dist/index-ZoW0HQ_m.d.ts

@@ -0,0 +1,13 @@
+import { S as SimulatorChain } from './chains-C5PI_Nr_.js';
+
+declare const localnet: SimulatorChain;
+
+declare const simulator: SimulatorChain;
+
+declare const index_localnet: typeof localnet;
+declare const index_simulator: typeof simulator;
+declare namespace index {
+  export { index_localnet as localnet, index_simulator as simulator };
+}
+
+export { index as i, localnet as l, simulator as s };

package/dist/index.cjs

@@ -1,10 +1,11 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
 
-var _chunkXAQMWSP4cjs = require('./chunk-XAQMWSP4.cjs');
 
+var _chunkI6HC44KDcjs = require('./chunk-I6HC44KD.cjs');
 
-var _chunk52HYC24Lcjs = require('./chunk-52HYC24L.cjs');
+
+var _chunkYDFRDDP5cjs = require('./chunk-YDFRDDP5.cjs');
 
 
 var _chunk75ZPJI57cjs = require('./chunk-75ZPJI57.cjs');
@@ -16,8 +17,8 @@ var _viem = require('viem');
 function accountActions(client) {
   return {
     fundAccount: async ({ address, amount }) => {
-      if (_optionalChain([client, 'access', _ => _.chain, 'optionalAccess', _2 => _2.id]) !== _chunkXAQMWSP4cjs.simulator.id) {
-        throw new Error("Client is not connected to the simulator");
+      if (_optionalChain([client, 'access', _ => _.chain, 'optionalAccess', _2 => _2.id]) !== _chunkI6HC44KDcjs.localnet.id) {
+        throw new Error("Client is not connected to the localnet");
       }
       return client.request({
         method: "sim_fundAccount",
@@ -167,7 +168,7 @@ function encodeImpl(to, data) {
         }
       } else if (data instanceof Map) {
         encodeMap(to, data);
-      } else if (data instanceof _chunk52HYC24Lcjs.CalldataAddress) {
+      } else if (data instanceof _chunkYDFRDDP5cjs.CalldataAddress) {
         to.push(SPECIAL_ADDR);
         for (const c of data.bytes) {
           to.push(c);
@@ -216,7 +217,7 @@ function decodeImpl(data, index) {
     case BigInt(SPECIAL_ADDR): {
       const res = data.slice(index.i, index.i + 20);
       index.i += 20;
-      return new (0, _chunk52HYC24Lcjs.CalldataAddress)(res);
+      return new (0, _chunkYDFRDDP5cjs.CalldataAddress)(res);
     }
   }
   const type = Number(cur & 0xffn) & (1 << BITS_IN_TYPE) - 1;
@@ -328,7 +329,7 @@ function toStringImpl(data, to) {
         to.push("]");
       } else if (data instanceof Map) {
         toStringImplMap(data.entries(), to);
-      } else if (data instanceof _chunk52HYC24Lcjs.CalldataAddress) {
+      } else if (data instanceof _chunkYDFRDDP5cjs.CalldataAddress) {
         to.push("addr#");
         for (const c of data.bytes) {
           to.push(c.toString(16));
@@ -541,14 +542,119 @@ var transactionActions = (client) => ({
   }
 });
 
+// src/config/snapID.ts
+var snapID = {
+  local: "local:http://localhost:8081",
+  npm: "npm:genlayer-wallet-plugin"
+};
+
+// src/wallet/connect.ts
+var networks = {
+  localnet: _chunkI6HC44KDcjs.localnet
+};
+var connect = async (client, network = "localnet", snapSource = "npm") => {
+  if (!window.ethereum) {
+    throw new Error("MetaMask is not installed.");
+  }
+  if (network === "testnet" || network === "mainnet") {
+    throw new Error(`${network} is not available yet. Please use localnet.`);
+  }
+  const selectedNetwork = networks[network];
+  if (!selectedNetwork) {
+    throw new Error(`Network configuration for '${network}' is not available.`);
+  }
+  const chainIdHex = `0x${selectedNetwork.id.toString(16)}`;
+  const chainParams = {
+    chainId: chainIdHex,
+    chainName: selectedNetwork.name,
+    rpcUrls: selectedNetwork.rpcUrls.default.http,
+    nativeCurrency: selectedNetwork.nativeCurrency,
+    blockExplorerUrls: [_optionalChain([selectedNetwork, 'access', _19 => _19.blockExplorers, 'optionalAccess', _20 => _20.default, 'access', _21 => _21.url])]
+  };
+  const currentChainId = await window.ethereum.request({ method: "eth_chainId" });
+  if (currentChainId !== chainIdHex) {
+    await window.ethereum.request({
+      method: "wallet_addEthereumChain",
+      params: [chainParams]
+    });
+    await window.ethereum.request({
+      method: "wallet_switchEthereumChain",
+      params: [{ chainId: chainIdHex }]
+    });
+  }
+  const id = snapSource === "local" ? snapID.local : snapID.npm;
+  const installedSnaps = await window.ethereum.request({ method: "wallet_getSnaps" });
+  const isGenLayerSnapInstalled = Object.values(installedSnaps).some(
+    (snap) => snap.id === id
+  );
+  if (!isGenLayerSnapInstalled) {
+    await window.ethereum.request({
+      method: "wallet_requestSnaps",
+      params: {
+        [id]: {}
+      }
+    });
+  }
+  client.chain = selectedNetwork;
+};
+
+// src/wallet/metamaskClient.ts
+var metamaskClient = async (snapSource = "npm") => {
+  if (typeof window === "undefined" || !window.ethereum) {
+    throw new Error("MetaMask is not installed.");
+  }
+  const isFlask = async () => {
+    try {
+      const clientVersion = await _optionalChain([window, 'access', _22 => _22.ethereum, 'optionalAccess', _23 => _23.request, 'call', _24 => _24({
+        method: "web3_clientVersion"
+      })]);
+      return _optionalChain([clientVersion, 'optionalAccess', _25 => _25.includes, 'call', _26 => _26("flask")]);
+    } catch (error) {
+      console.error("Error detecting Flask:", error);
+      return false;
+    }
+  };
+  const installedSnaps = async () => {
+    try {
+      return await _optionalChain([window, 'access', _27 => _27.ethereum, 'optionalAccess', _28 => _28.request, 'call', _29 => _29({
+        method: "wallet_getSnaps"
+      })]);
+    } catch (error) {
+      console.error("Error getting installed snaps:", error);
+      return {};
+    }
+  };
+  const isGenLayerSnapInstalled = async () => {
+    const id = snapSource === "local" ? snapID.local : snapID.npm;
+    const snaps = await installedSnaps();
+    return Object.values(snaps).some((snap) => snap.id === id);
+  };
+  const flaskDetected = await isFlask();
+  const snapsList = await installedSnaps();
+  const genLayerSnapInstalled = await isGenLayerSnapInstalled();
+  return {
+    isFlask: flaskDetected,
+    installedSnaps: snapsList,
+    isGenLayerSnapInstalled: genLayerSnapInstalled
+  };
+};
+
+// src/wallet/actions.ts
+function walletActions(client) {
+  return {
+    connect: (network, snapSource) => connect(client, network, snapSource),
+    metamaskClient: (snapSource = "npm") => metamaskClient(snapSource)
+  };
+}
+
 // src/chains/actions.ts
 function chainActions(client) {
   return {
     initializeConsensusSmartContract: async (forceReset = false) => {
-      if (_optionalChain([client, 'access', _19 => _19.chain, 'optionalAccess', _20 => _20.id]) !== _chunkXAQMWSP4cjs.simulator.id) {
+      if (_optionalChain([client, 'access', _30 => _30.chain, 'optionalAccess', _31 => _31.id]) !== _chunkI6HC44KDcjs.simulator.id) {
         throw new Error("Client is not connected to the simulator");
       }
-      if (!forceReset && _optionalChain([client, 'access', _21 => _21.chain, 'access', _22 => _22.consensusMainContract, 'optionalAccess', _23 => _23.address]) && _optionalChain([client, 'access', _24 => _24.chain, 'access', _25 => _25.consensusMainContract, 'optionalAccess', _26 => _26.abi])) {
+      if (!forceReset && _optionalChain([client, 'access', _32 => _32.chain, 'access', _33 => _33.consensusMainContract, 'optionalAccess', _34 => _34.address]) && _optionalChain([client, 'access', _35 => _35.chain, 'access', _36 => _36.consensusMainContract, 'optionalAccess', _37 => _37.abi])) {
         return;
       }
       const contractsResponse = await fetch(client.chain.rpcUrls.default.http[0], {
@@ -573,22 +679,24 @@ function chainActions(client) {
 }
 
 // src/client/client.ts
-var createClient = (config = { chain: _chunkXAQMWSP4cjs.simulator }) => {
-  const chainConfig = config.chain || _chunkXAQMWSP4cjs.simulator;
-  const rpcUrl = config.endpoint || chainConfig.rpcUrls.default.http[0];
+var createClient = (config = { chain: _chunkI6HC44KDcjs.localnet }) => {
+  const chainConfig = config.chain || _chunkI6HC44KDcjs.localnet;
+  if (config.endpoint) {
+    chainConfig.rpcUrls.default.http = [config.endpoint];
+  }
   const isAddress = typeof config.account !== "object";
   const customTransport = {
     async request({ method, params }) {
       if (method.startsWith("eth_") && isAddress) {
         try {
-          return await _optionalChain([window, 'access', _27 => _27.ethereum, 'optionalAccess', _28 => _28.request, 'call', _29 => _29({ method, params })]);
+          return await _optionalChain([window, 'access', _38 => _38.ethereum, 'optionalAccess', _39 => _39.request, 'call', _40 => _40({ method, params })]);
         } catch (err) {
           console.warn(`Error using window.ethereum for method ${method}:`, err);
           throw err;
         }
       } else {
         try {
-          const response = await fetch(rpcUrl, {
+          const response = await fetch(chainConfig.rpcUrls.default.http[0], {
             method: "POST",
             headers: {
               "Content-Type": "application/json"
@@ -616,7 +724,7 @@ var createClient = (config = { chain: _chunkXAQMWSP4cjs.simulator }) => {
     chain: chainConfig,
     transport: _viem.custom.call(void 0, customTransport),
     ...config.account ? { account: config.account } : {}
-  }).extend(_viem.publicActions).extend(_viem.walletActions).extend((client) => accountActions(client)).extend((client) => transactionActions(client)).extend((client) => contractActions(client)).extend((client) => chainActions(client));
+  }).extend(_viem.publicActions).extend(_viem.walletActions).extend((client) => accountActions(client)).extend((client) => transactionActions(client)).extend((client) => contractActions(client)).extend((client) => chainActions(client)).extend((client) => walletActions(client));
   baseClient.initializeConsensusSmartContract().catch((error) => {
     console.error("Failed to initialize consensus smart contract:", error);
   });
@@ -646,4 +754,4 @@ var transactions = transactions_exports;
 
 
 
-exports.abi = abi_exports; exports.chains = _chunkXAQMWSP4cjs.chains_exports; exports.createAccount = createAccount; exports.createClient = createClient; exports.generatePrivateKey = generatePrivateKey;
+exports.abi = abi_exports; exports.chains = _chunkI6HC44KDcjs.chains_exports; exports.createAccount = createAccount; exports.createClient = createClient; exports.generatePrivateKey = generatePrivateKey;

package/dist/index.d.cts

@@ -1,11 +1,11 @@
 import * as viem from 'viem';
 import { Account, Address } from 'viem';
 import { S as SimulatorChain } from './chains-C5PI_Nr_.cjs';
-import { G as GenLayerClient, C as CalldataEncodable, T as TransactionDataElement } from './index-FMf4Unm0.cjs';
+import { G as GenLayerClient, C as CalldataEncodable, T as TransactionDataElement } from './index-DJTO3-o3.cjs';
 import * as abitype from 'abitype';
 import * as viem__types_experimental_eip7702_types_authorization from 'viem/_types/experimental/eip7702/types/authorization';
 import * as viem_accounts from 'viem/accounts';
-export { i as chains } from './index-CHQn8ZME.cjs';
+export { i as chains } from './index-B8E0qiOq.cjs';
 
 interface ClientConfig {
     chain?: {

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 import * as viem from 'viem';
 import { Account, Address } from 'viem';
 import { S as SimulatorChain } from './chains-C5PI_Nr_.js';
-import { G as GenLayerClient, C as CalldataEncodable, T as TransactionDataElement } from './index-vnyqXaRU.js';
+import { G as GenLayerClient, C as CalldataEncodable, T as TransactionDataElement } from './index-CpcNUbXb.js';
 import * as abitype from 'abitype';
 import * as viem__types_experimental_eip7702_types_authorization from 'viem/_types/experimental/eip7702/types/authorization';
 import * as viem_accounts from 'viem/accounts';
-export { i as chains } from './index-CioK5j0r.js';
+export { i as chains } from './index-ZoW0HQ_m.js';
 
 interface ClientConfig {
     chain?: {

package/dist/index.js

@@ -1,23 +1,24 @@
 import {
   chains_exports,
+  localnet,
   simulator
-} from "./chunk-O3T2C57T.js";
+} from "./chunk-WEXFFND6.js";
 import {
   CalldataAddress
-} from "./chunk-2EJVFGKU.js";
+} from "./chunk-K72OSU5N.js";
 import {
   __export
 } from "./chunk-MLKGABMK.js";
 
 // src/client/client.ts
-import { createClient as createViemClient, publicActions, custom, walletActions } from "viem";
+import { createClient as createViemClient, publicActions, custom, walletActions as walletActions2 } from "viem";
 
 // src/accounts/actions.ts
 function accountActions(client) {
   return {
     fundAccount: async ({ address, amount }) => {
-      if (client.chain?.id !== simulator.id) {
-        throw new Error("Client is not connected to the simulator");
+      if (client.chain?.id !== localnet.id) {
+        throw new Error("Client is not connected to the localnet");
       }
       return client.request({
         method: "sim_fundAccount",
@@ -541,6 +542,111 @@ var transactionActions = (client) => ({
   }
 });
 
+// src/config/snapID.ts
+var snapID = {
+  local: "local:http://localhost:8081",
+  npm: "npm:genlayer-wallet-plugin"
+};
+
+// src/wallet/connect.ts
+var networks = {
+  localnet
+};
+var connect = async (client, network = "localnet", snapSource = "npm") => {
+  if (!window.ethereum) {
+    throw new Error("MetaMask is not installed.");
+  }
+  if (network === "testnet" || network === "mainnet") {
+    throw new Error(`${network} is not available yet. Please use localnet.`);
+  }
+  const selectedNetwork = networks[network];
+  if (!selectedNetwork) {
+    throw new Error(`Network configuration for '${network}' is not available.`);
+  }
+  const chainIdHex = `0x${selectedNetwork.id.toString(16)}`;
+  const chainParams = {
+    chainId: chainIdHex,
+    chainName: selectedNetwork.name,
+    rpcUrls: selectedNetwork.rpcUrls.default.http,
+    nativeCurrency: selectedNetwork.nativeCurrency,
+    blockExplorerUrls: [selectedNetwork.blockExplorers?.default.url]
+  };
+  const currentChainId = await window.ethereum.request({ method: "eth_chainId" });
+  if (currentChainId !== chainIdHex) {
+    await window.ethereum.request({
+      method: "wallet_addEthereumChain",
+      params: [chainParams]
+    });
+    await window.ethereum.request({
+      method: "wallet_switchEthereumChain",
+      params: [{ chainId: chainIdHex }]
+    });
+  }
+  const id = snapSource === "local" ? snapID.local : snapID.npm;
+  const installedSnaps = await window.ethereum.request({ method: "wallet_getSnaps" });
+  const isGenLayerSnapInstalled = Object.values(installedSnaps).some(
+    (snap) => snap.id === id
+  );
+  if (!isGenLayerSnapInstalled) {
+    await window.ethereum.request({
+      method: "wallet_requestSnaps",
+      params: {
+        [id]: {}
+      }
+    });
+  }
+  client.chain = selectedNetwork;
+};
+
+// src/wallet/metamaskClient.ts
+var metamaskClient = async (snapSource = "npm") => {
+  if (typeof window === "undefined" || !window.ethereum) {
+    throw new Error("MetaMask is not installed.");
+  }
+  const isFlask = async () => {
+    try {
+      const clientVersion = await window.ethereum?.request({
+        method: "web3_clientVersion"
+      });
+      return clientVersion?.includes("flask");
+    } catch (error) {
+      console.error("Error detecting Flask:", error);
+      return false;
+    }
+  };
+  const installedSnaps = async () => {
+    try {
+      return await window.ethereum?.request({
+        method: "wallet_getSnaps"
+      });
+    } catch (error) {
+      console.error("Error getting installed snaps:", error);
+      return {};
+    }
+  };
+  const isGenLayerSnapInstalled = async () => {
+    const id = snapSource === "local" ? snapID.local : snapID.npm;
+    const snaps = await installedSnaps();
+    return Object.values(snaps).some((snap) => snap.id === id);
+  };
+  const flaskDetected = await isFlask();
+  const snapsList = await installedSnaps();
+  const genLayerSnapInstalled = await isGenLayerSnapInstalled();
+  return {
+    isFlask: flaskDetected,
+    installedSnaps: snapsList,
+    isGenLayerSnapInstalled: genLayerSnapInstalled
+  };
+};
+
+// src/wallet/actions.ts
+function walletActions(client) {
+  return {
+    connect: (network, snapSource) => connect(client, network, snapSource),
+    metamaskClient: (snapSource = "npm") => metamaskClient(snapSource)
+  };
+}
+
 // src/chains/actions.ts
 function chainActions(client) {
   return {
@@ -573,9 +679,11 @@ function chainActions(client) {
 }
 
 // src/client/client.ts
-var createClient = (config = { chain: simulator }) => {
-  const chainConfig = config.chain || simulator;
-  const rpcUrl = config.endpoint || chainConfig.rpcUrls.default.http[0];
+var createClient = (config = { chain: localnet }) => {
+  const chainConfig = config.chain || localnet;
+  if (config.endpoint) {
+    chainConfig.rpcUrls.default.http = [config.endpoint];
+  }
   const isAddress = typeof config.account !== "object";
   const customTransport = {
     async request({ method, params }) {
@@ -588,7 +696,7 @@ var createClient = (config = { chain: simulator }) => {
         }
       } else {
         try {
-          const response = await fetch(rpcUrl, {
+          const response = await fetch(chainConfig.rpcUrls.default.http[0], {
             method: "POST",
             headers: {
               "Content-Type": "application/json"
@@ -616,7 +724,7 @@ var createClient = (config = { chain: simulator }) => {
     chain: chainConfig,
     transport: custom(customTransport),
     ...config.account ? { account: config.account } : {}
-  }).extend(publicActions).extend(walletActions).extend((client) => accountActions(client)).extend((client) => transactionActions(client)).extend((client) => contractActions(client)).extend((client) => chainActions(client));
+  }).extend(publicActions).extend(walletActions2).extend((client) => accountActions(client)).extend((client) => transactionActions(client)).extend((client) => contractActions(client)).extend((client) => chainActions(client)).extend((client) => walletActions(client));
   baseClient.initializeConsensusSmartContract().catch((error) => {
     console.error("Failed to initialize consensus smart contract:", error);
   });

package/dist/types/index.cjs

@@ -1,9 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunk52HYC24Lcjs = require('../chunk-52HYC24L.cjs');
+var _chunkYDFRDDP5cjs = require('../chunk-YDFRDDP5.cjs');
 require('../chunk-75ZPJI57.cjs');
 
 
 
-exports.CalldataAddress = _chunk52HYC24Lcjs.CalldataAddress; exports.TransactionStatus = _chunk52HYC24Lcjs.TransactionStatus;
+exports.CalldataAddress = _chunkYDFRDDP5cjs.CalldataAddress; exports.TransactionStatus = _chunkYDFRDDP5cjs.TransactionStatus;

package/dist/types/index.d.cts

@@ -1,3 +1,3 @@
-export { A as Address, a as CalldataAddress, C as CalldataEncodable, f as ContractMethod, e as ContractMethodBase, c as ContractParamsArraySchemaElement, d as ContractParamsSchema, g as ContractSchema, G as GenLayerClient, b as GenLayerMethod, j as GenLayerTransaction, M as MethodDescription, k as TransactionDataElement, h as TransactionHash, i as TransactionStatus } from '../index-FMf4Unm0.cjs';
+export { A as Address, a as CalldataAddress, C as CalldataEncodable, f as ContractMethod, e as ContractMethodBase, c as ContractParamsArraySchemaElement, d as ContractParamsSchema, g as ContractSchema, G as GenLayerClient, b as GenLayerMethod, j as GenLayerTransaction, M as MethodDescription, N as Network, S as SnapSource, k as TransactionDataElement, h as TransactionHash, i as TransactionStatus } from '../index-DJTO3-o3.cjs';
 export { S as SimulatorChain } from '../chains-C5PI_Nr_.cjs';
 export { Account } from 'viem';

package/dist/types/index.d.ts

@@ -1,3 +1,3 @@
-export { A as Address, a as CalldataAddress, C as CalldataEncodable, f as ContractMethod, e as ContractMethodBase, c as ContractParamsArraySchemaElement, d as ContractParamsSchema, g as ContractSchema, G as GenLayerClient, b as GenLayerMethod, j as GenLayerTransaction, M as MethodDescription, k as TransactionDataElement, h as TransactionHash, i as TransactionStatus } from '../index-vnyqXaRU.js';
+export { A as Address, a as CalldataAddress, C as CalldataEncodable, f as ContractMethod, e as ContractMethodBase, c as ContractParamsArraySchemaElement, d as ContractParamsSchema, g as ContractSchema, G as GenLayerClient, b as GenLayerMethod, j as GenLayerTransaction, M as MethodDescription, N as Network, S as SnapSource, k as TransactionDataElement, h as TransactionHash, i as TransactionStatus } from '../index-CpcNUbXb.js';
 export { S as SimulatorChain } from '../chains-C5PI_Nr_.js';
 export { Account } from 'viem';

package/dist/types/index.js

@@ -1,7 +1,7 @@
 import {
   CalldataAddress,
   TransactionStatus
-} from "../chunk-2EJVFGKU.js";
+} from "../chunk-K72OSU5N.js";
 import "../chunk-MLKGABMK.js";
 export {
   CalldataAddress,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "genlayer-js",
   "type": "module",
-  "version": "0.6.3",
+  "version": "0.7.0",
   "description": "GenLayer JavaScript SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/accounts/actions.ts

@@ -1,11 +1,11 @@
 import {GenLayerClient, TransactionHash, SimulatorChain} from "../types";
-import {simulator} from "../chains";
+import {localnet} from "../chains";
 
 export function accountActions(client: GenLayerClient<SimulatorChain>) {
   return {
     fundAccount: async ({address, amount}: {address: string; amount: number}): Promise<TransactionHash> => {
-      if (client.chain?.id !== simulator.id) {
-        throw new Error("Client is not connected to the simulator");
+      if (client.chain?.id !== localnet.id) {
+        throw new Error("Client is not connected to the localnet");
       }
 
       return client.request({

package/src/chains/index.ts

@@ -1,2 +1,3 @@
 // src/chains/index.ts
+export {localnet} from "./localnet";
 export {simulator} from "./simulator";

package/src/chains/localnet.ts

@@ -0,0 +1,30 @@
+import {defineChain} from "viem";
+import {SimulatorChain} from "@/types";
+
+// chains/localnet.ts
+const SIMULATOR_JSON_RPC_URL = "http://127.0.0.1:4000/api";
+
+export const localnet: SimulatorChain = defineChain({
+  id: 61_999,
+  name: "Genlayer Localnet",
+  rpcUrls: {
+    default: {
+      http: [SIMULATOR_JSON_RPC_URL],
+    },
+  },
+  nativeCurrency: {
+    name: "GEN Token",
+    symbol: "GEN",
+    decimals: 18,
+  },
+  blockExplorers: {
+    default: {
+      name: "GenLayer Explorer",
+      url: SIMULATOR_JSON_RPC_URL,
+    },
+  },
+  testnet: true,
+  consensusMainContract: null,
+  defaultNumberOfInitialValidators: 5,
+  defaultConsensusMaxRotations: 3,
+});

package/src/client/client.ts

@@ -1,10 +1,11 @@
 import {Account, createClient as createViemClient, publicActions, custom, Address, walletActions} from "viem";
-import {simulator} from "../chains/simulator";
 import {accountActions} from "../accounts/actions";
 import {contractActions, overrideContractActions} from "../contracts/actions";
 import {transactionActions} from "../transactions/actions";
+import {walletActions as genlayerWalletActions} from "../wallet/actions";
 import {GenLayerClient, SimulatorChain} from "@/types";
 import {chainActions} from "@/chains/actions";
+import {localnet} from "@/chains";
 
 // Define the configuration interface for the client
 interface ClientConfig {
@@ -19,9 +20,11 @@ interface ClientConfig {
   account?: Account | Address;
 }
 
-export const createClient = (config: ClientConfig = {chain: simulator}) => {
-  const chainConfig = config.chain || simulator;
-  const rpcUrl = config.endpoint || chainConfig.rpcUrls.default.http[0];
+export const createClient = (config: ClientConfig = {chain: localnet}) => {
+  const chainConfig = config.chain || localnet;
+  if (config.endpoint) {
+    chainConfig.rpcUrls.default.http = [config.endpoint];
+  }
   const isAddress = typeof config.account !== "object";
 
   const customTransport = {
@@ -35,7 +38,7 @@ export const createClient = (config: ClientConfig = {chain: simulator}) => {
         }
       } else {
         try {
-          const response = await fetch(rpcUrl, {
+          const response = await fetch(chainConfig.rpcUrls.default.http[0], {
             method: "POST",
             headers: {
               "Content-Type": "application/json",
@@ -73,7 +76,8 @@ export const createClient = (config: ClientConfig = {chain: simulator}) => {
     .extend(client => accountActions(client as unknown as GenLayerClient<SimulatorChain>))
     .extend(client => transactionActions(client as unknown as GenLayerClient<SimulatorChain>))
     .extend(client => contractActions(client as unknown as GenLayerClient<SimulatorChain>))
-    .extend(client => chainActions(client as unknown as GenLayerClient<SimulatorChain>));
+    .extend(client => chainActions(client as unknown as GenLayerClient<SimulatorChain>))
+    .extend((client) => genlayerWalletActions(client as unknown as GenLayerClient<SimulatorChain>));
 
   // Initialize in the background
   baseClient.initializeConsensusSmartContract().catch(error => {

package/src/config/snapID.ts

@@ -0,0 +1,4 @@
+export const snapID = {
+  local: 'local:http://localhost:8081',
+  npm: 'npm:genlayer-wallet-plugin'
+}

package/src/global.d.ts

@@ -2,6 +2,6 @@
 interface Window {
   ethereum?: {
     isMetaMask?: boolean;
-    request: (args: { method: string; params?: unknown[] }) => Promise<unknown>;
+    request: any
   };
 }

package/src/types/clients.ts

@@ -4,6 +4,9 @@ import {SimulatorChain} from "./chains";
 import {Address, Account} from "./accounts";
 import {CalldataEncodable} from "./calldata";
 import {ContractSchema} from "./contracts";
+import {Network} from "./network";
+import {SnapSource} from "@/types/snapSource";
+import {MetaMaskClientResult} from "@/types/metamaskClientResult";
 
 export type GenLayerMethod =
   | {method: "sim_fundAccount"; params: [address: string, amount: number]}
@@ -71,4 +74,6 @@ export type GenLayerClient<TSimulatorChain extends SimulatorChain> = Omit<
     getContractSchema: (address: string) => Promise<ContractSchema>;
     getContractSchemaForCode: (contractCode: string | Uint8Array) => Promise<ContractSchema>;
     initializeConsensusSmartContract: (forceReset?: boolean) => Promise<void>;
+    connect: (network?: Network, snapSource?: SnapSource) => Promise<void>;
+    metamaskClient: (snapSource?: SnapSource) => Promise<MetaMaskClientResult>;
   };

package/src/types/index.ts

@@ -4,3 +4,5 @@ export * from "./chains";
 export * from "./clients";
 export * from "./contracts";
 export * from "./transactions";
+export * from "./network";
+export * from "./snapSource";

package/src/types/metamaskClientResult.ts

@@ -0,0 +1,5 @@
+export type MetaMaskClientResult = {
+  isFlask: boolean;
+  installedSnaps: Record<string, any>;
+  isGenLayerSnapInstalled: boolean;
+};

package/src/types/network.ts

@@ -0,0 +1 @@
+export type Network = 'localnet' | 'testnet' | 'mainnet';

package/src/types/snapSource.ts

@@ -0,0 +1 @@
+export type SnapSource = 'npm' | 'local';

package/src/wallet/actions.ts

@@ -0,0 +1,10 @@
+import { connect } from "./connect";
+import {GenLayerClient, SimulatorChain, Network, SnapSource} from "@/types";
+import { metamaskClient } from "@/wallet/metamaskClient";
+
+export function walletActions(client: GenLayerClient<SimulatorChain>) {
+  return {
+    connect: (network: Network, snapSource: SnapSource) => connect(client, network, snapSource),
+    metamaskClient: (snapSource: SnapSource = "npm") => metamaskClient(snapSource),
+  };
+}

package/src/wallet/connect.ts

@@ -0,0 +1,65 @@
+import { localnet } from "@/chains/localnet";
+import { GenLayerClient, SimulatorChain } from "@/types";
+import { Network } from "@/types/network";
+import { SnapSource } from "@/types/snapSource";
+import { snapID } from "@/config/snapID";
+
+const networks = {
+  localnet,
+};
+
+export const connect = async (
+  client: GenLayerClient<SimulatorChain>,
+  network: Network = "localnet",
+  snapSource: SnapSource = 'npm'
+): Promise<void> => {
+  if (!window.ethereum) {
+    throw new Error("MetaMask is not installed.");
+  }
+  if (network === "testnet" || network === "mainnet") {
+    throw new Error(`${network} is not available yet. Please use localnet.`);
+  }
+
+  const selectedNetwork = networks[network];
+  if (!selectedNetwork) {
+    throw new Error(`Network configuration for '${network}' is not available.`);
+  }
+
+  const chainIdHex = `0x${selectedNetwork.id.toString(16)}`;
+  const chainParams = {
+    chainId: chainIdHex,
+    chainName: selectedNetwork.name,
+    rpcUrls: selectedNetwork.rpcUrls.default.http,
+    nativeCurrency: selectedNetwork.nativeCurrency,
+    blockExplorerUrls: [selectedNetwork.blockExplorers?.default.url],
+  };
+
+  const currentChainId = await window.ethereum.request({ method: "eth_chainId" });
+  if (currentChainId !== chainIdHex) {
+    await window.ethereum.request({
+      method: "wallet_addEthereumChain",
+      params: [chainParams],
+    });
+    await window.ethereum.request({
+      method: "wallet_switchEthereumChain",
+      params: [{ chainId: chainIdHex }],
+    });
+  }
+
+  const id = snapSource === 'local' ? snapID.local : snapID.npm;
+  const installedSnaps: any = await window.ethereum.request({ method: "wallet_getSnaps" });
+  const isGenLayerSnapInstalled = Object.values(installedSnaps).some(
+    (snap: any) => snap.id === id
+  );
+
+  if (!isGenLayerSnapInstalled) {
+    await window.ethereum.request({
+      method: "wallet_requestSnaps",
+      params: {
+        [id]: {},
+      },
+    });
+  }
+
+  client.chain = selectedNetwork;
+};

package/src/wallet/metamaskClient.ts

@@ -0,0 +1,50 @@
+import { snapID } from "@/config/snapID";
+import { SnapSource } from "@/types/snapSource";
+import { MetaMaskClientResult } from "@/types/metamaskClientResult";
+
+export const metamaskClient = async (snapSource: SnapSource = "npm") => {
+  if (typeof window === "undefined" || !window.ethereum) {
+    throw new Error("MetaMask is not installed.");
+  }
+
+  const isFlask = async (): Promise<boolean> => {
+    try {
+      const clientVersion = await window.ethereum?.request({
+        method: "web3_clientVersion",
+      });
+
+      return (clientVersion as string)?.includes("flask");
+    } catch (error) {
+      console.error("Error detecting Flask:", error);
+      return false;
+    }
+  };
+
+  const installedSnaps = async (): Promise<Record<string, any>> => {
+    try {
+      return (await window.ethereum?.request({
+        method: "wallet_getSnaps",
+      })) as Record<string, any>;
+    } catch (error) {
+      console.error("Error getting installed snaps:", error);
+      return {};
+    }
+  };
+
+  const isGenLayerSnapInstalled = async (): Promise<boolean> => {
+    const id = snapSource === "local" ? snapID.local : snapID.npm;
+    const snaps = await installedSnaps();
+
+    return Object.values(snaps).some((snap: any) => snap.id === id);
+  };
+
+  const flaskDetected = await isFlask();
+  const snapsList = await installedSnaps();
+  const genLayerSnapInstalled = await isGenLayerSnapInstalled();
+
+  return {
+    isFlask: flaskDetected,
+    installedSnaps: snapsList,
+    isGenLayerSnapInstalled: genLayerSnapInstalled,
+  } as MetaMaskClientResult;
+};

package/tests/client.test-d.ts

@@ -1,11 +1,11 @@
 import {createClient} from "../src/client/client";
-import {simulator} from "../src/chains/simulator";
+import {localnet} from "@/chains/localnet";
 import {createAccount, generatePrivateKey} from "../src/accounts/account";
 import {TransactionHash, TransactionStatus} from "../src/types/transactions";
 
 test("type checks", () => {
   const client = createClient({
-    chain: simulator,
+    chain: localnet,
     account: createAccount(generatePrivateKey()),
   });
 

package/tests/client.test.ts

@@ -1,16 +1,16 @@
 // tests/client.test.ts
 import {createClient} from "../src/client/client";
-import {simulator} from "../src/chains/simulator";
+import {localnet} from "@/chains/localnet";
 import {Address} from "../src/types/accounts";
 import {createAccount, generatePrivateKey} from "../src/accounts/account";
 import {vi} from "vitest";
 import {TransactionStatus} from "../src/types/transactions";
 
 describe("Client Creation", () => {
-  it("should create a client for the simulator", () => {
-    const client = createClient({chain: simulator});
+  it("should create a client for the localnet", () => {
+    const client = createClient({chain: localnet});
     expect(client).toBeDefined();
-    expect(client.chain).toBe(simulator);
+    expect(client.chain).toBe(localnet);
   });
 });
 
@@ -18,7 +18,7 @@ describe("Client Overrides", () => {
   it("should default to client account if no account is provided", async () => {
     const account = createAccount(generatePrivateKey());
     const client = createClient({
-      chain: simulator,
+      chain: localnet,
       account: account,
     });
 
@@ -49,7 +49,7 @@ describe("Client Overrides", () => {
   it("should override client account if account is provided", async () => {
     const account = createAccount(generatePrivateKey());
     const client = createClient({
-      chain: simulator,
+      chain: localnet,
       account,
     });
 
@@ -82,7 +82,7 @@ describe("Client Overrides", () => {
   it("should override client account if address is provided", async () => {
     const account = "0x65e03a3e916CF1dC92d3C8E8186a89CfAB0D2bc2";
     const client = createClient({
-      chain: simulator,
+      chain: localnet,
       account,
     });
 

package/dist/index-CHQn8ZME.d.cts

@@ -1,10 +0,0 @@
-import { S as SimulatorChain } from './chains-C5PI_Nr_.cjs';
-
-declare const simulator: SimulatorChain;
-
-declare const index_simulator: typeof simulator;
-declare namespace index {
-  export { index_simulator as simulator };
-}
-
-export { index as i, simulator as s };

package/dist/index-CioK5j0r.d.ts

@@ -1,10 +0,0 @@
-import { S as SimulatorChain } from './chains-C5PI_Nr_.js';
-
-declare const simulator: SimulatorChain;
-
-declare const index_simulator: typeof simulator;
-declare namespace index {
-  export { index_simulator as simulator };
-}
-
-export { index as i, simulator as s };