genlayer-js 0.17.0 → 0.18.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 
 
+## 0.18.0 (2025-09-04)
+
+
+### Features
+
+* format in genlayer js to convert to an object ([#107](https://github.com/genlayerlabs/genlayer-js/issues/107)) ([3ca4076](https://github.com/genlayerlabs/genlayer-js/commit/3ca40765bc03e8d7174c8e337e6104ccea455e5a))
+
+## 0.17.1 (2025-09-03)
+
+
+### Bug Fixes
+
+* returning the whole data when an error occurs ([#111](https://github.com/genlayerlabs/genlayer-js/issues/111)) ([bebb025](https://github.com/genlayerlabs/genlayer-js/commit/bebb025a0f07d4ed05783e1a77abe76979fc4ac0))
+
 ## 0.17.0 (2025-09-03)
 
 

package/dist/{index-BIyk5Fv7.d.ts → index-BnFbqUhu.d.ts}

@@ -332,6 +332,7 @@ type GenLayerClient<TGenLayerChain extends GenLayerChain> = Omit<Client<Transpor
             [key: string]: CalldataEncodable;
         };
         rawReturn?: RawReturn;
+        jsonSafeReturn?: boolean;
         transactionHashVariant?: TransactionHashVariant;
     }) => Promise<RawReturn extends true ? `0x${string}` : CalldataEncodable>;
     writeContract: (args: {

package/dist/{index-DrEvzYFA.d.cts → index-CxNl4CK5.d.cts}

@@ -332,6 +332,7 @@ type GenLayerClient<TGenLayerChain extends GenLayerChain> = Omit<Client<Transpor
             [key: string]: CalldataEncodable;
         };
         rawReturn?: RawReturn;
+        jsonSafeReturn?: boolean;
         transactionHashVariant?: TransactionHashVariant;
     }) => Promise<RawReturn extends true ? `0x${string}` : CalldataEncodable>;
     writeContract: (args: {

package/dist/index.cjs

@@ -419,6 +419,7 @@ var calldata = calldata_exports;
 var transactions = transactions_exports;
 
 // src/utils/jsonifier.ts
+
 function b64ToArray(b64) {
   return Uint8Array.from(atob(b64), (c) => c.charCodeAt(0));
 }
@@ -457,6 +458,54 @@ function resultToUserFriendlyJson(cd64) {
     payload
   };
 }
+function toJsonSafeDeep(value) {
+  return _toJsonSafeDeep(value, /* @__PURE__ */ new WeakSet());
+}
+function _toJsonSafeDeep(value, seen) {
+  if (value === null || value === void 0) {
+    return null;
+  }
+  const primitiveType = typeof value;
+  if (primitiveType === "string" || primitiveType === "boolean" || primitiveType === "number") {
+    return value;
+  }
+  if (primitiveType === "bigint") {
+    const big = value;
+    const abs = big < 0n ? -big : big;
+    const maxSafe = 9007199254740991n;
+    return abs <= maxSafe ? Number(big) : big.toString();
+  }
+  if (typeof value === "object") {
+    if (seen.has(value)) {
+      return null;
+    }
+    seen.add(value);
+    if (value instanceof Uint8Array) {
+      return _viem.toHex.call(void 0, value);
+    }
+    if (value instanceof Array) {
+      return value.map((v) => _toJsonSafeDeep(v, seen));
+    }
+    if (value instanceof Map) {
+      const obj = {};
+      for (const [k, v] of value.entries()) {
+        obj[k] = _toJsonSafeDeep(v, seen);
+      }
+      return obj;
+    }
+    if (value instanceof _chunkH4ZYXVV2cjs.CalldataAddress) {
+      return _viem.toHex.call(void 0, value.bytes);
+    }
+    if (Object.getPrototypeOf(value) === Object.prototype) {
+      const obj = {};
+      for (const [k, v] of Object.entries(value)) {
+        obj[k] = _toJsonSafeDeep(v, seen);
+      }
+      return obj;
+    }
+  }
+  return value;
+}
 
 // src/contracts/actions.ts
 var contractActions = (client, publicClient) => {
@@ -499,6 +548,7 @@ var contractActions = (client, publicClient) => {
         functionName,
         args: callArgs,
         kwargs,
+        jsonSafeReturn = false,
         leaderOnly = false,
         transactionHashVariant = "latest-nonfinal" /* LATEST_NONFINAL */
       } = args;
@@ -521,7 +571,11 @@ var contractActions = (client, publicClient) => {
         return prefixedResult;
       }
       const resultBinary = _viem.fromHex.call(void 0, prefixedResult, "bytes");
-      return decode(resultBinary);
+      const decoded = decode(resultBinary);
+      if (!jsonSafeReturn) {
+        return decoded;
+      }
+      return toJsonSafeDeep(decoded);
     },
     simulateWriteContract: async (args) => {
       const {
@@ -1199,11 +1253,11 @@ var getCustomTransportConfig = (config) => {
           });
           const data = await response.json();
           if (data.error) {
-            throw new Error(data.error.message);
+            throw data.error;
           }
           return data.result;
         } catch (err) {
-          console.error(`Error fetching ${method} from GenLayer RPC:`, err);
+          console.error(`Error fetching ${method} from GenLayer RPC`);
           throw err;
         }
       }

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as viem from 'viem';
 import { Account, Address, Hex } from 'viem';
 import { G as GenLayerChain } from './chains-BYSCF33g.cjs';
-import { G as GenLayerClient, D as DecodedDeployData, a as DecodedCallData, b as GenLayerRawTransaction, c as GenLayerTransaction, C as CalldataEncodable, T as TransactionDataElement } from './index-DrEvzYFA.cjs';
+import { G as GenLayerClient, D as DecodedDeployData, a as DecodedCallData, b as GenLayerRawTransaction, c as GenLayerTransaction, C as CalldataEncodable, T as TransactionDataElement } from './index-CxNl4CK5.cjs';
 import * as abitype from 'abitype';
 import * as viem__types_types_authorization from 'viem/_types/types/authorization';
 import * as viem_accounts from 'viem/accounts';

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as viem from 'viem';
 import { Account, Address, Hex } from 'viem';
 import { G as GenLayerChain } from './chains-BYSCF33g.js';
-import { G as GenLayerClient, D as DecodedDeployData, a as DecodedCallData, b as GenLayerRawTransaction, c as GenLayerTransaction, C as CalldataEncodable, T as TransactionDataElement } from './index-BIyk5Fv7.js';
+import { G as GenLayerClient, D as DecodedDeployData, a as DecodedCallData, b as GenLayerRawTransaction, c as GenLayerTransaction, C as CalldataEncodable, T as TransactionDataElement } from './index-BnFbqUhu.js';
 import * as abitype from 'abitype';
 import * as viem__types_types_authorization from 'viem/_types/types/authorization';
 import * as viem_accounts from 'viem/accounts';

package/dist/index.js

@@ -407,7 +407,7 @@ function serialize(data) {
 }
 
 // src/contracts/actions.ts
-import { fromHex, toHex as toHex2, zeroAddress, encodeFunctionData, parseEventLogs } from "viem";
+import { fromHex, toHex as toHex3, zeroAddress, encodeFunctionData, parseEventLogs } from "viem";
 
 // src/abi/index.ts
 var abi_exports = {};
@@ -419,6 +419,7 @@ var calldata = calldata_exports;
 var transactions = transactions_exports;
 
 // src/utils/jsonifier.ts
+import { toHex as toHex2 } from "viem";
 function b64ToArray(b64) {
   return Uint8Array.from(atob(b64), (c) => c.charCodeAt(0));
 }
@@ -457,6 +458,54 @@ function resultToUserFriendlyJson(cd64) {
     payload
   };
 }
+function toJsonSafeDeep(value) {
+  return _toJsonSafeDeep(value, /* @__PURE__ */ new WeakSet());
+}
+function _toJsonSafeDeep(value, seen) {
+  if (value === null || value === void 0) {
+    return null;
+  }
+  const primitiveType = typeof value;
+  if (primitiveType === "string" || primitiveType === "boolean" || primitiveType === "number") {
+    return value;
+  }
+  if (primitiveType === "bigint") {
+    const big = value;
+    const abs = big < 0n ? -big : big;
+    const maxSafe = 9007199254740991n;
+    return abs <= maxSafe ? Number(big) : big.toString();
+  }
+  if (typeof value === "object") {
+    if (seen.has(value)) {
+      return null;
+    }
+    seen.add(value);
+    if (value instanceof Uint8Array) {
+      return toHex2(value);
+    }
+    if (value instanceof Array) {
+      return value.map((v) => _toJsonSafeDeep(v, seen));
+    }
+    if (value instanceof Map) {
+      const obj = {};
+      for (const [k, v] of value.entries()) {
+        obj[k] = _toJsonSafeDeep(v, seen);
+      }
+      return obj;
+    }
+    if (value instanceof CalldataAddress) {
+      return toHex2(value.bytes);
+    }
+    if (Object.getPrototypeOf(value) === Object.prototype) {
+      const obj = {};
+      for (const [k, v] of Object.entries(value)) {
+        obj[k] = _toJsonSafeDeep(v, seen);
+      }
+      return obj;
+    }
+  }
+  return value;
+}
 
 // src/contracts/actions.ts
 var contractActions = (client, publicClient) => {
@@ -488,7 +537,7 @@ var contractActions = (client, publicClient) => {
       }
       const schema = await client.request({
         method: "gen_getContractSchemaForCode",
-        params: [toHex2(contractCode)]
+        params: [toHex3(contractCode)]
       });
       return schema;
     },
@@ -499,6 +548,7 @@ var contractActions = (client, publicClient) => {
         functionName,
         args: callArgs,
         kwargs,
+        jsonSafeReturn = false,
         leaderOnly = false,
         transactionHashVariant = "latest-nonfinal" /* LATEST_NONFINAL */
       } = args;
@@ -521,7 +571,11 @@ var contractActions = (client, publicClient) => {
         return prefixedResult;
       }
       const resultBinary = fromHex(prefixedResult, "bytes");
-      return decode(resultBinary);
+      const decoded = decode(resultBinary);
+      if (!jsonSafeReturn) {
+        return decoded;
+      }
+      return toJsonSafeDeep(decoded);
     },
     simulateWriteContract: async (args) => {
       const {
@@ -1199,11 +1253,11 @@ var getCustomTransportConfig = (config) => {
           });
           const data = await response.json();
           if (data.error) {
-            throw new Error(data.error.message);
+            throw data.error;
           }
           return data.result;
         } catch (err) {
-          console.error(`Error fetching ${method} from GenLayer RPC:`, err);
+          console.error(`Error fetching ${method} from GenLayer RPC`);
           throw err;
         }
       }

package/dist/types/index.d.cts

@@ -1,3 +1,3 @@
 export { Account, Address } from 'viem';
-export { d as CalldataAddress, C as CalldataEncodable, i as ContractMethod, h as ContractMethodBase, f as ContractParamsArraySchemaElement, g as ContractParamsSchema, j as ContractSchema, a as DecodedCallData, D as DecodedDeployData, G as GenLayerClient, e as GenLayerMethod, b as GenLayerRawTransaction, c as GenLayerTransaction, H as Hash, M as MethodDescription, N as Network, S as SnapSource, k as TransactionHash, s as TransactionHashVariant, m as TransactionResult, p as TransactionResultNameToNumber, l as TransactionStatus, r as TransactionType, V as VoteType, o as transactionResultNumberToName, n as transactionsStatusNameToNumber, t as transactionsStatusNumberToName, q as voteTypeNameToNumber, v as voteTypeNumberToName } from '../index-DrEvzYFA.cjs';
+export { d as CalldataAddress, C as CalldataEncodable, i as ContractMethod, h as ContractMethodBase, f as ContractParamsArraySchemaElement, g as ContractParamsSchema, j as ContractSchema, a as DecodedCallData, D as DecodedDeployData, G as GenLayerClient, e as GenLayerMethod, b as GenLayerRawTransaction, c as GenLayerTransaction, H as Hash, M as MethodDescription, N as Network, S as SnapSource, k as TransactionHash, s as TransactionHashVariant, m as TransactionResult, p as TransactionResultNameToNumber, l as TransactionStatus, r as TransactionType, V as VoteType, o as transactionResultNumberToName, n as transactionsStatusNameToNumber, t as transactionsStatusNumberToName, q as voteTypeNameToNumber, v as voteTypeNumberToName } from '../index-CxNl4CK5.cjs';
 export { G as GenLayerChain } from '../chains-BYSCF33g.cjs';

package/dist/types/index.d.ts

@@ -1,3 +1,3 @@
 export { Account, Address } from 'viem';
-export { d as CalldataAddress, C as CalldataEncodable, i as ContractMethod, h as ContractMethodBase, f as ContractParamsArraySchemaElement, g as ContractParamsSchema, j as ContractSchema, a as DecodedCallData, D as DecodedDeployData, G as GenLayerClient, e as GenLayerMethod, b as GenLayerRawTransaction, c as GenLayerTransaction, H as Hash, M as MethodDescription, N as Network, S as SnapSource, k as TransactionHash, s as TransactionHashVariant, m as TransactionResult, p as TransactionResultNameToNumber, l as TransactionStatus, r as TransactionType, V as VoteType, o as transactionResultNumberToName, n as transactionsStatusNameToNumber, t as transactionsStatusNumberToName, q as voteTypeNameToNumber, v as voteTypeNumberToName } from '../index-BIyk5Fv7.js';
+export { d as CalldataAddress, C as CalldataEncodable, i as ContractMethod, h as ContractMethodBase, f as ContractParamsArraySchemaElement, g as ContractParamsSchema, j as ContractSchema, a as DecodedCallData, D as DecodedDeployData, G as GenLayerClient, e as GenLayerMethod, b as GenLayerRawTransaction, c as GenLayerTransaction, H as Hash, M as MethodDescription, N as Network, S as SnapSource, k as TransactionHash, s as TransactionHashVariant, m as TransactionResult, p as TransactionResultNameToNumber, l as TransactionStatus, r as TransactionType, V as VoteType, o as transactionResultNumberToName, n as transactionsStatusNameToNumber, t as transactionsStatusNumberToName, q as voteTypeNameToNumber, v as voteTypeNumberToName } from '../index-BnFbqUhu.js';
 export { G as GenLayerChain } from '../chains-BYSCF33g.js';

package/package.json

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

package/src/client/client.ts

@@ -70,12 +70,12 @@ const getCustomTransportConfig = (config: ClientConfig) => {
           const data = await response.json();
 
           if (data.error) {
-            throw new Error(data.error.message);
+            throw data.error
           }
 
           return data.result;
         } catch (err) {
-          console.error(`Error fetching ${method} from GenLayer RPC:`, err);
+          console.error(`Error fetching ${method} from GenLayer RPC`);
           throw err;
         }
       }

package/src/contracts/actions.ts

@@ -11,7 +11,7 @@ import {
   TransactionHashVariant,
 } from "@/types";
 import {fromHex, toHex, zeroAddress, encodeFunctionData, PublicClient, parseEventLogs} from "viem";
-import {b64ToArray} from "@/utils/jsonifier";
+import {toJsonSafeDeep, b64ToArray} from "@/utils/jsonifier";
 
 export const contractActions = (client: GenLayerClient<GenLayerChain>, publicClient: PublicClient) => {
   return {
@@ -53,6 +53,7 @@ export const contractActions = (client: GenLayerClient<GenLayerChain>, publicCli
       args?: CalldataEncodable[];
       kwargs?: Map<string, CalldataEncodable> | {[key: string]: CalldataEncodable};
       rawReturn?: RawReturn;
+      jsonSafeReturn?: boolean;
       leaderOnly?: boolean;
       transactionHashVariant?: TransactionHashVariant;
     }): Promise<RawReturn extends true ? `0x${string}` : CalldataEncodable> => {
@@ -62,6 +63,7 @@ export const contractActions = (client: GenLayerClient<GenLayerChain>, publicCli
         functionName,
         args: callArgs,
         kwargs,
+        jsonSafeReturn = false,
         leaderOnly = false,
         transactionHashVariant = TransactionHashVariant.LATEST_NONFINAL,
       } = args;
@@ -88,7 +90,12 @@ export const contractActions = (client: GenLayerClient<GenLayerChain>, publicCli
         return prefixedResult;
       }
       const resultBinary = fromHex(prefixedResult, "bytes");
-      return calldata.decode(resultBinary) as any;
+      const decoded = calldata.decode(resultBinary) as any;
+      if (!jsonSafeReturn) {
+        return decoded;
+      }
+      // If jsonSafeReturn is requested, convert to JSON-safe recursively
+      return toJsonSafeDeep(decoded) as any;
     },
     simulateWriteContract: async <RawReturn extends boolean | undefined>(args: {
       account?: Account;

package/src/types/clients.ts

@@ -47,6 +47,7 @@ export type GenLayerClient<TGenLayerChain extends GenLayerChain> = Omit<
       args?: CalldataEncodable[];
       kwargs?: Map<string, CalldataEncodable> | {[key: string]: CalldataEncodable};
       rawReturn?: RawReturn;
+      jsonSafeReturn?: boolean;
       transactionHashVariant?: TransactionHashVariant;
     }) => Promise<RawReturn extends true ? `0x${string}` : CalldataEncodable>;
     writeContract: (args: {

package/src/utils/jsonifier.ts

@@ -1,4 +1,7 @@
 import {calldata} from "@/abi";
+import type {CalldataEncodable} from "@/types/calldata";
+import {CalldataAddress} from "@/types/calldata";
+import {toHex} from "viem";
 
 
 export function b64ToArray(b64: string): Uint8Array {
@@ -44,4 +47,73 @@ export function resultToUserFriendlyJson(cd64: string): any {
     status,
     payload,
   };
+}
+
+// Deeply converts CalldataEncodable values into JSON-serializable structures.
+// Rules:
+// - bigint: to number if safe, otherwise to decimal string
+// - Uint8Array: to 0x-prefixed hex string
+// - CalldataAddress: to 0x-prefixed hex string
+// - Map: to Array<[key, value]> preserving order
+// - Arrays and plain objects: converted recursively
+export function toJsonSafeDeep<T extends CalldataEncodable>(value: T): any {
+  return _toJsonSafeDeep(value, new WeakSet());
+}
+
+function _toJsonSafeDeep(value: CalldataEncodable, seen: WeakSet<object>): any {
+  if (value === null || value === undefined) {
+    return null;
+  }
+
+  const primitiveType = typeof value;
+  if (primitiveType === "string" || primitiveType === "boolean" || primitiveType === "number") {
+    return value;
+  }
+
+  if (primitiveType === "bigint") {
+    const big = value as bigint;
+    const abs = big < 0n ? -big : big;
+    const maxSafe = 9007199254740991n; // Number.MAX_SAFE_INTEGER
+    return abs <= maxSafe ? Number(big) : big.toString();
+  }
+
+  // Objects and structured values
+  if (typeof value === "object") {
+    if (seen.has(value as object)) {
+      // Prevent potential cycles; represent as null
+      return null;
+    }
+    seen.add(value as object);
+
+    if (value instanceof Uint8Array) {
+      return toHex(value);
+    }
+
+    if (value instanceof Array) {
+      return value.map((v) => _toJsonSafeDeep(v as CalldataEncodable, seen));
+    }
+
+    if (value instanceof Map) {
+      const obj: Record<string, any> = {};
+      for (const [k, v] of value.entries()) {
+        obj[k] = _toJsonSafeDeep(v as CalldataEncodable, seen);
+      }
+      return obj;
+    }
+
+    if (value instanceof CalldataAddress) {
+      return toHex(value.bytes);
+    }
+
+    if (Object.getPrototypeOf(value) === Object.prototype) {
+      const obj: Record<string, any> = {};
+      for (const [k, v] of Object.entries(value)) {
+        obj[k] = _toJsonSafeDeep(v as CalldataEncodable, seen);
+      }
+      return obj;
+    }
+  }
+
+  // Fallback: return as-is (shouldn't normally reach here)
+  return value as any;
 }