@caatinga/client 2.3.0 → 2.3.1

package/dist/index.cjs

@@ -383,28 +383,62 @@ function splitReadArgsAndOptions(argsOrOptions, maybeOptions) {
 var import_browser5 = require("@caatinga/core/browser");
 async function prepareReadTransaction(transaction, contractName, method, rpcUrl) {
   const candidate = transaction;
-  if (typeof candidate.prepare !== "function") {
-    return transaction;
+  if (typeof candidate.prepare === "function") {
+    try {
+      return await candidate.prepare.call(transaction);
+    } catch (error) {
+      if (error instanceof import_browser5.CaatingaError) {
+        throw error;
+      }
+      throw new import_browser5.CaatingaError(
+        `Failed to prepare XDR for "${contractName}.${method}".`,
+        import_browser5.CaatingaErrorCode.XDR_PREPARE_FAILED,
+        `RPC: ${rpcUrl}. Check connectivity, simulation errors, and binding compatibility.`,
+        error
+      );
+    }
   }
-  try {
-    return await candidate.prepare.call(transaction);
-  } catch (error) {
-    if (error instanceof import_browser5.CaatingaError) {
-      throw error;
+  if (typeof candidate.simulate === "function") {
+    try {
+      return await candidate.simulate.call(transaction);
+    } catch (error) {
+      if (error instanceof import_browser5.CaatingaError) {
+        throw error;
+      }
+      throw new import_browser5.CaatingaError(
+        `Failed to simulate "${contractName}.${method}".`,
+        import_browser5.CaatingaErrorCode.XDR_PREPARE_FAILED,
+        `RPC: ${rpcUrl}. Check connectivity, simulation errors, and binding compatibility.`,
+        error
+      );
     }
+  }
+  return transaction;
+}
+function isStellarContractResult(value) {
+  return value !== null && typeof value === "object" && typeof value.isOk === "function" && typeof value.unwrap === "function";
+}
+function normalizeSimulationValue(value, contractName, method) {
+  if (!isStellarContractResult(value)) {
+    return value;
+  }
+  if (value.isErr()) {
+    const err = value.unwrapErr();
+    const message = err !== null && typeof err === "object" && "message" in err ? String(err.message) : String(err);
     throw new import_browser5.CaatingaError(
-      `Failed to prepare XDR for "${contractName}.${method}".`,
-      import_browser5.CaatingaErrorCode.XDR_PREPARE_FAILED,
-      `RPC: ${rpcUrl}. Check connectivity, simulation errors, and binding compatibility.`,
-      error
+      `Simulation for "${contractName}.${method}" returned a contract error: ${message}.`,
+      import_browser5.CaatingaErrorCode.XDR_RESULT_FAILED,
+      "Check contract inputs and binding argument encoding.",
+      err
     );
   }
+  return value.unwrap();
 }
 function readSimulationResult(raw, contractName, method) {
   if (raw !== null && typeof raw === "object" && "result" in raw) {
     const result = raw.result;
     if (result !== void 0) {
-      return result;
+      return normalizeSimulationValue(result, contractName, method);
     }
   }
   throw new import_browser5.CaatingaError(

package/dist/index.js

@@ -193,28 +193,62 @@ function splitReadArgsAndOptions(argsOrOptions, maybeOptions) {
 import { CaatingaError as CaatingaError4, CaatingaErrorCode as CaatingaErrorCode4 } from "@caatinga/core/browser";
 async function prepareReadTransaction(transaction, contractName, method, rpcUrl) {
   const candidate = transaction;
-  if (typeof candidate.prepare !== "function") {
-    return transaction;
+  if (typeof candidate.prepare === "function") {
+    try {
+      return await candidate.prepare.call(transaction);
+    } catch (error) {
+      if (error instanceof CaatingaError4) {
+        throw error;
+      }
+      throw new CaatingaError4(
+        `Failed to prepare XDR for "${contractName}.${method}".`,
+        CaatingaErrorCode4.XDR_PREPARE_FAILED,
+        `RPC: ${rpcUrl}. Check connectivity, simulation errors, and binding compatibility.`,
+        error
+      );
+    }
   }
-  try {
-    return await candidate.prepare.call(transaction);
-  } catch (error) {
-    if (error instanceof CaatingaError4) {
-      throw error;
+  if (typeof candidate.simulate === "function") {
+    try {
+      return await candidate.simulate.call(transaction);
+    } catch (error) {
+      if (error instanceof CaatingaError4) {
+        throw error;
+      }
+      throw new CaatingaError4(
+        `Failed to simulate "${contractName}.${method}".`,
+        CaatingaErrorCode4.XDR_PREPARE_FAILED,
+        `RPC: ${rpcUrl}. Check connectivity, simulation errors, and binding compatibility.`,
+        error
+      );
     }
+  }
+  return transaction;
+}
+function isStellarContractResult(value) {
+  return value !== null && typeof value === "object" && typeof value.isOk === "function" && typeof value.unwrap === "function";
+}
+function normalizeSimulationValue(value, contractName, method) {
+  if (!isStellarContractResult(value)) {
+    return value;
+  }
+  if (value.isErr()) {
+    const err = value.unwrapErr();
+    const message = err !== null && typeof err === "object" && "message" in err ? String(err.message) : String(err);
     throw new CaatingaError4(
-      `Failed to prepare XDR for "${contractName}.${method}".`,
-      CaatingaErrorCode4.XDR_PREPARE_FAILED,
-      `RPC: ${rpcUrl}. Check connectivity, simulation errors, and binding compatibility.`,
-      error
+      `Simulation for "${contractName}.${method}" returned a contract error: ${message}.`,
+      CaatingaErrorCode4.XDR_RESULT_FAILED,
+      "Check contract inputs and binding argument encoding.",
+      err
     );
   }
+  return value.unwrap();
 }
 function readSimulationResult(raw, contractName, method) {
   if (raw !== null && typeof raw === "object" && "result" in raw) {
     const result = raw.result;
     if (result !== void 0) {
-      return result;
+      return normalizeSimulationValue(result, contractName, method);
     }
   }
   throw new CaatingaError4(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caatinga/client",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "Browser and Node client for Soroban smart contracts — connects generated bindings, Caatinga artifacts, and wallet adapters",
   "keywords": [
     "stellar",
@@ -56,7 +56,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@caatinga/core": "^2.3.0"
+    "@caatinga/core": "^2.3.1"
   },
   "devDependencies": {
     "tsup": "^8.3.5",