genlayer-js 0.28.0 → 0.28.1

package/README.md

@@ -213,6 +213,35 @@ const receipt = await readClient.waitForTransactionReceipt({
 });
 ```
 
+### Switching the wallet to the correct network
+
+When using MetaMask or another browser wallet, the wallet may be connected to a different chain than what your client is configured for. Use `client.connect()` to switch the wallet to the correct GenLayer network before sending transactions:
+
+```typescript
+import { createClient } from "genlayer-js";
+import { studionet } from "genlayer-js/chains";
+
+const client = createClient({
+  chain: studionet,
+  account: address as `0x${string}`,
+});
+
+// Switch MetaMask to the correct chain (adds the network if not present)
+await client.connect("studionet");
+
+// Now transactions will go to the right network
+const txHash = await client.writeContract({
+  address: contractAddress,
+  functionName: "create_profile",
+  args: ["alice", "Hello world"],
+  value: BigInt(0),
+});
+```
+
+Available networks: `"localnet"`, `"studionet"`, `"testnetAsimov"`, `"testnetBradbury"`.
+
+> **Note:** If the wallet is on the wrong chain when you call `writeContract`, the SDK will throw a clear error telling you which chain the wallet is on vs. which chain the client expects. Call `client.connect()` to resolve this.
+
 ### Staking Operations
 
 The SDK provides staking functionality for validators and delegators on testnet-bradbury (and testnet-asimov).

package/dist/index.cjs

@@ -2263,6 +2263,20 @@ var PROVIDER_METHODS = /* @__PURE__ */ new Set([
   "personal_sign",
   "eth_signTypedData_v4"
 ]);
+var assertChainMatch = async (provider, chainConfig) => {
+  const expectedChainIdHex = `0x${chainConfig.id.toString(16)}`;
+  try {
+    const currentChainId = await provider.request({ method: "eth_chainId" });
+    if (currentChainId !== expectedChainIdHex) {
+      const currentId = parseInt(currentChainId, 16);
+      throw new Error(
+        `Wallet is on chain ${currentId} but client is configured for chain ${chainConfig.id} (${chainConfig.name}). Call client.connect("${chainConfig.name}") or switch your wallet to the correct network before sending transactions.`
+      );
+    }
+  } catch (err) {
+    if (err instanceof Error && err.message.startsWith("Wallet is on chain")) throw err;
+  }
+};
 var getCustomTransportConfig = (config, chainConfig) => {
   const isAddress = typeof config.account !== "object";
   return {
@@ -2271,6 +2285,9 @@ var getCustomTransportConfig = (config, chainConfig) => {
         const provider = config.provider || (typeof window !== "undefined" ? window.ethereum : void 0);
         if (provider) {
           try {
+            if (method === "eth_sendTransaction" || method === "eth_signTransaction") {
+              await assertChainMatch(provider, chainConfig);
+            }
             return await provider.request({ method, params });
           } catch (err) {
             console.warn(`Error using provider for method ${method}:`, err);

package/dist/index.js

@@ -2263,6 +2263,20 @@ var PROVIDER_METHODS = /* @__PURE__ */ new Set([
   "personal_sign",
   "eth_signTypedData_v4"
 ]);
+var assertChainMatch = async (provider, chainConfig) => {
+  const expectedChainIdHex = `0x${chainConfig.id.toString(16)}`;
+  try {
+    const currentChainId = await provider.request({ method: "eth_chainId" });
+    if (currentChainId !== expectedChainIdHex) {
+      const currentId = parseInt(currentChainId, 16);
+      throw new Error(
+        `Wallet is on chain ${currentId} but client is configured for chain ${chainConfig.id} (${chainConfig.name}). Call client.connect("${chainConfig.name}") or switch your wallet to the correct network before sending transactions.`
+      );
+    }
+  } catch (err) {
+    if (err instanceof Error && err.message.startsWith("Wallet is on chain")) throw err;
+  }
+};
 var getCustomTransportConfig = (config, chainConfig) => {
   const isAddress = typeof config.account !== "object";
   return {
@@ -2271,6 +2285,9 @@ var getCustomTransportConfig = (config, chainConfig) => {
         const provider = config.provider || (typeof window !== "undefined" ? window.ethereum : void 0);
         if (provider) {
           try {
+            if (method === "eth_sendTransaction" || method === "eth_signTransaction") {
+              await assertChainMatch(provider, chainConfig);
+            }
             return await provider.request({ method, params });
           } catch (err) {
             console.warn(`Error using provider for method ${method}:`, err);

package/package.json

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