@caatinga/client 2.4.5 → 3.0.0

package/README.md

@@ -87,7 +87,7 @@ Primary flow:
 ```ts
 import { createCaatingaClient } from "@caatinga/client";
 import { createStellarWalletsKitAdapter } from "@caatinga/client/stellar-wallets-kit";
-import * as Counter from "./contracts/generated/counter/src/index.js";
+import * as Counter from "./contracts/generated/counter";
 import artifacts from "../caatinga.artifacts.json";
 
 const wallet = createStellarWalletsKitAdapter();

package/dist/index.cjs

@@ -253,7 +253,7 @@ function createDefaultBindingAdapter(binding) {
         throw new import_browser3.CaatingaError(
           "Generated binding does not export Client.",
           import_browser3.CaatingaErrorCode.BINDING_CLIENT_NOT_FOUND,
-          "Regenerate bindings with Stellar CLI."
+          "Run caatinga generate <contract> --network <network> (uses @stellar/stellar-sdk generate)."
         );
       }
       return new binding.Client({
@@ -481,6 +481,20 @@ ${hint}`;
 }
 
 // src/client/transaction-submit.ts
+function isMultiAuthRequired(error) {
+  if (typeof error !== "object" || error === null) return false;
+  const name = error.name;
+  const message = String(error.message ?? "");
+  return name === "NeedsMoreSignaturesError" || /requires signatures from/i.test(message);
+}
+function multiAuthError(contractName, method, cause) {
+  return new import_browser7.CaatingaError(
+    `"${contractName}.${method}" requires additional non-invoker signatures (delegated AddressV2 credentials).`,
+    import_browser7.CaatingaErrorCode.MULTI_AUTH_REQUIRED,
+    "The transaction has Soroban auth entries that must be signed by other accounts via signAuthEntry. Serialize, collect each signer's auth-entry signature, then re-submit.",
+    cause
+  );
+}
 async function submitTransaction(transaction, signTransaction, contractName, method, rpcUrl) {
   const candidate = transaction;
   if (typeof candidate.signAndSend === "function") {
@@ -492,6 +506,9 @@ async function submitTransaction(transaction, signTransaction, contractName, met
       if (error instanceof import_browser7.CaatingaError) {
         throw error;
       }
+      if (isMultiAuthRequired(error)) {
+        throw multiAuthError(contractName, method, error);
+      }
       const readCallError = enrichReadCallInvokeError(error, contractName, method);
       if (readCallError) {
         throw readCallError;
@@ -513,6 +530,9 @@ async function submitTransaction(transaction, signTransaction, contractName, met
       if (error instanceof import_browser7.CaatingaError) {
         throw error;
       }
+      if (isMultiAuthRequired(error)) {
+        throw multiAuthError(contractName, method, error);
+      }
       const readCallError = enrichReadCallInvokeError(error, contractName, method);
       if (readCallError) {
         throw readCallError;

package/dist/index.js

@@ -63,7 +63,7 @@ function createDefaultBindingAdapter(binding) {
         throw new CaatingaError2(
           "Generated binding does not export Client.",
           CaatingaErrorCode2.BINDING_CLIENT_NOT_FOUND,
-          "Regenerate bindings with Stellar CLI."
+          "Run caatinga generate <contract> --network <network> (uses @stellar/stellar-sdk generate)."
         );
       }
       return new binding.Client({
@@ -291,6 +291,20 @@ ${hint}`;
 }
 
 // src/client/transaction-submit.ts
+function isMultiAuthRequired(error) {
+  if (typeof error !== "object" || error === null) return false;
+  const name = error.name;
+  const message = String(error.message ?? "");
+  return name === "NeedsMoreSignaturesError" || /requires signatures from/i.test(message);
+}
+function multiAuthError(contractName, method, cause) {
+  return new CaatingaError6(
+    `"${contractName}.${method}" requires additional non-invoker signatures (delegated AddressV2 credentials).`,
+    CaatingaErrorCode6.MULTI_AUTH_REQUIRED,
+    "The transaction has Soroban auth entries that must be signed by other accounts via signAuthEntry. Serialize, collect each signer's auth-entry signature, then re-submit.",
+    cause
+  );
+}
 async function submitTransaction(transaction, signTransaction, contractName, method, rpcUrl) {
   const candidate = transaction;
   if (typeof candidate.signAndSend === "function") {
@@ -302,6 +316,9 @@ async function submitTransaction(transaction, signTransaction, contractName, met
       if (error instanceof CaatingaError6) {
         throw error;
       }
+      if (isMultiAuthRequired(error)) {
+        throw multiAuthError(contractName, method, error);
+      }
       const readCallError = enrichReadCallInvokeError(error, contractName, method);
       if (readCallError) {
         throw readCallError;
@@ -323,6 +340,9 @@ async function submitTransaction(transaction, signTransaction, contractName, met
       if (error instanceof CaatingaError6) {
         throw error;
       }
+      if (isMultiAuthRequired(error)) {
+        throw multiAuthError(contractName, method, error);
+      }
       const readCallError = enrichReadCallInvokeError(error, contractName, method);
       if (readCallError) {
         throw readCallError;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caatinga/client",
-  "version": "2.4.5",
+  "version": "3.0.0",
   "description": "Browser and Node client for Soroban smart contracts — connects generated bindings, Caatinga artifacts, and wallet adapters",
   "keywords": [
     "stellar",
@@ -22,7 +22,7 @@
   "author": "Caatinga contributors",
   "license": "MIT",
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "type": "module",
   "main": "./dist/index.cjs",
@@ -61,7 +61,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@caatinga/core": "^2.4.5"
+    "@caatinga/core": "^3.0.0"
   },
   "devDependencies": {
     "tsup": "^8.3.5",