@caatinga/client 2.4.5 → 3.0.1

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();
@@ -96,20 +96,20 @@ const client = createCaatingaClient({
   network: {
     name: "testnet",
     rpcUrl: "https://soroban-testnet.stellar.org",
-    networkPassphrase: "Test SDF Network ; September 2015"
+    networkPassphrase: "Test SDF Network ; September 2015",
   },
   artifacts,
   wallet,
   contracts: {
     counter: {
-      binding: Counter
-    }
-  }
+      binding: Counter,
+    },
+  },
 });
 
 const before = await client.contract("counter").read<number>("get");
 const increment = await client.contract("counter").invoke<number>("increment");
-const after = increment.result ?? await client.contract("counter").read<number>("get");
+const after = increment.result ?? (await client.contract("counter").read<number>("get"));
 ```
 
 ## Wallet Adapter Contract
@@ -118,10 +118,7 @@ const after = increment.result ?? await client.contract("counter").read<number>(
 export interface CaatingaWalletAdapter {
   getPublicKey(): Promise<string>;
 
-  signTransaction(input: {
-    xdr: string;
-    networkPassphrase: string;
-  }): Promise<string>;
+  signTransaction(input: { xdr: string; networkPassphrase: string }): Promise<string>;
 }
 ```
 
@@ -135,8 +132,8 @@ Wrap any adapter with connection state, persistence, and silent restore:
 import { createWalletSession } from "@caatinga/client";
 
 const session = createWalletSession(wallet, { persist: true });
-await session.connect();   // modal when available, else getPublicKey()
-await session.restore();   // silent reconnect on page load — never throws
+await session.connect(); // modal when available, else getPublicKey()
+await session.restore(); // silent reconnect on page load — never throws
 session.subscribe(() => console.log(session.getState()));
 ```
 

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.1",
   "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.1"
   },
   "devDependencies": {
     "tsup": "^8.3.5",