genlayer-js 0.27.6 → 0.27.8

package/README.md

@@ -168,6 +168,51 @@ console.log(trace.stderr);       // standard error output
 console.log(trace.genvm_log);    // detailed GenVM execution logs
 ```
 
+### Using with a wallet provider (MetaMask)
+
+When building a browser dApp, create two clients: one for reads (no wallet needed) and one for writes (signed by the wallet). This follows the standard viem pattern and keeps concerns separated.
+
+```typescript
+import { createClient } from "genlayer-js";
+import { testnetBradbury } from "genlayer-js/chains";
+import { TransactionStatus } from "genlayer-js/types";
+
+// Read client — talks directly to GenLayer RPC, no wallet needed
+const readClient = createClient({
+  chain: testnetBradbury,
+});
+
+// Write client — signs transactions through the wallet
+const writeClient = createClient({
+  chain: testnetBradbury,
+  account: address as `0x${string}`, // from wallet connection
+  provider: window.ethereum,          // or from a wallet SDK
+});
+
+// Use readClient for all reads
+const result = await readClient.readContract({
+  address: contractAddress,
+  functionName: "get_storage",
+  args: [],
+});
+
+const tx = await readClient.getTransaction({ hash: txHash });
+
+// Use writeClient for transactions (MetaMask popup)
+const txHash = await writeClient.writeContract({
+  address: contractAddress,
+  functionName: "update_storage",
+  args: ["new_value"],
+  value: BigInt(0),
+});
+
+// Either client can wait for receipts
+const receipt = await readClient.waitForTransactionReceipt({
+  hash: txHash,
+  status: TransactionStatus.ACCEPTED,
+});
+```
+
 ### Staking Operations
 
 The SDK provides staking functionality for validators and delegators on testnet-bradbury (and testnet-asimov).

package/dist/index.cjs

@@ -2107,11 +2107,19 @@ function chainActions(_client) {
 }
 
 // src/client/client.ts
+var PROVIDER_METHODS = /* @__PURE__ */ new Set([
+  "eth_accounts",
+  "eth_requestAccounts",
+  "eth_sendTransaction",
+  "eth_signTransaction",
+  "personal_sign",
+  "eth_signTypedData_v4"
+]);
 var getCustomTransportConfig = (config, chainConfig) => {
   const isAddress = typeof config.account !== "object";
   return {
     async request({ method, params = [] }) {
-      if (method.startsWith("eth_") && isAddress) {
+      if (PROVIDER_METHODS.has(method) && isAddress) {
         const provider = config.provider || (typeof window !== "undefined" ? window.ethereum : void 0);
         if (provider) {
           try {
@@ -2122,29 +2130,27 @@ var getCustomTransportConfig = (config, chainConfig) => {
           }
         }
       }
-      {
-        try {
-          const response = await fetch(chainConfig.rpcUrls.default.http[0], {
-            method: "POST",
-            headers: {
-              "Content-Type": "application/json"
-            },
-            body: JSON.stringify({
-              jsonrpc: "2.0",
-              id: Date.now(),
-              method,
-              params
-            })
-          });
-          const data = await response.json();
-          if (data.error) {
-            throw data.error;
-          }
-          return data.result;
-        } catch (err) {
-          console.error(`GenLayer RPC error (${method}):`, err.message || err);
-          throw err;
+      try {
+        const response = await fetch(chainConfig.rpcUrls.default.http[0], {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify({
+            jsonrpc: "2.0",
+            id: Date.now(),
+            method,
+            params
+          })
+        });
+        const data = await response.json();
+        if (data.error) {
+          throw data.error;
         }
+        return data.result;
+      } catch (err) {
+        console.error(`GenLayer RPC error (${method}):`, err.message || err);
+        throw err;
       }
     }
   };

package/dist/index.js

@@ -2107,11 +2107,19 @@ function chainActions(_client) {
 }
 
 // src/client/client.ts
+var PROVIDER_METHODS = /* @__PURE__ */ new Set([
+  "eth_accounts",
+  "eth_requestAccounts",
+  "eth_sendTransaction",
+  "eth_signTransaction",
+  "personal_sign",
+  "eth_signTypedData_v4"
+]);
 var getCustomTransportConfig = (config, chainConfig) => {
   const isAddress = typeof config.account !== "object";
   return {
     async request({ method, params = [] }) {
-      if (method.startsWith("eth_") && isAddress) {
+      if (PROVIDER_METHODS.has(method) && isAddress) {
         const provider = config.provider || (typeof window !== "undefined" ? window.ethereum : void 0);
         if (provider) {
           try {
@@ -2122,29 +2130,27 @@ var getCustomTransportConfig = (config, chainConfig) => {
           }
         }
       }
-      {
-        try {
-          const response = await fetch(chainConfig.rpcUrls.default.http[0], {
-            method: "POST",
-            headers: {
-              "Content-Type": "application/json"
-            },
-            body: JSON.stringify({
-              jsonrpc: "2.0",
-              id: Date.now(),
-              method,
-              params
-            })
-          });
-          const data = await response.json();
-          if (data.error) {
-            throw data.error;
-          }
-          return data.result;
-        } catch (err) {
-          console.error(`GenLayer RPC error (${method}):`, err.message || err);
-          throw err;
+      try {
+        const response = await fetch(chainConfig.rpcUrls.default.http[0], {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify({
+            jsonrpc: "2.0",
+            id: Date.now(),
+            method,
+            params
+          })
+        });
+        const data = await response.json();
+        if (data.error) {
+          throw data.error;
         }
+        return data.result;
+      } catch (err) {
+        console.error(`GenLayer RPC error (${method}):`, err.message || err);
+        throw err;
       }
     }
   };

package/package.json

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