@caatinga/client 0.2.1 → 0.2.2

package/dist/freighter.d.cts

@@ -1,5 +1,5 @@
-import { C as CaatingaWalletAdapter } from './types-CiM5FkDn.cjs';
-import '@caatinga/core';
+import { C as CaatingaWalletAdapter } from './types-DUgMJXLA.cjs';
+import '@caatinga/core/browser';
 
 declare const freighterWalletAdapter: CaatingaWalletAdapter;
 

package/dist/freighter.d.ts

@@ -1,5 +1,5 @@
-import { C as CaatingaWalletAdapter } from './types-CiM5FkDn.js';
-import '@caatinga/core';
+import { C as CaatingaWalletAdapter } from './types-DUgMJXLA.js';
+import '@caatinga/core/browser';
 
 declare const freighterWalletAdapter: CaatingaWalletAdapter;
 

package/dist/index.cjs

@@ -29,7 +29,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/artifacts/resolve-contract-id.ts
-var import_core = require("@caatinga/core");
+var import_browser = require("@caatinga/core/browser");
 function resolveContractId(input) {
   if (input.explicitContractId) {
     return input.explicitContractId;
@@ -38,22 +38,22 @@ function resolveContractId(input) {
   if (contractId) {
     return contractId;
   }
-  throw new import_core.CaatingaError(
+  throw new import_browser.CaatingaError(
     `No contract artifact found for "${input.contract}" on "${input.network}".`,
-    import_core.CaatingaErrorCode.CONTRACT_ARTIFACT_NOT_FOUND,
+    import_browser.CaatingaErrorCode.CONTRACT_ARTIFACT_NOT_FOUND,
     "Deploy the contract first or pass contractId explicitly."
   );
 }
 
 // src/bindings/default-binding-adapter.ts
-var import_core2 = require("@caatinga/core");
+var import_browser2 = require("@caatinga/core/browser");
 function createDefaultBindingAdapter(binding) {
   return {
     createClient({ contractId, publicKey, rpcUrl, networkPassphrase }) {
       if (!binding.Client) {
-        throw new import_core2.CaatingaError(
+        throw new import_browser2.CaatingaError(
           "Generated binding does not export Client.",
-          import_core2.CaatingaErrorCode.BINDING_CLIENT_NOT_FOUND,
+          import_browser2.CaatingaErrorCode.BINDING_CLIENT_NOT_FOUND,
           "Regenerate bindings with Stellar CLI."
         );
       }
@@ -68,9 +68,9 @@ function createDefaultBindingAdapter(binding) {
       const candidate = client;
       const fn = candidate[method];
       if (typeof fn !== "function") {
-        throw new import_core2.CaatingaError(
+        throw new import_browser2.CaatingaError(
           `Binding method "${method}" was not found.`,
-          import_core2.CaatingaErrorCode.BINDING_METHOD_NOT_FOUND,
+          import_browser2.CaatingaErrorCode.BINDING_METHOD_NOT_FOUND,
           "Check the contract method name or regenerate bindings."
         );
       }
@@ -80,13 +80,13 @@ function createDefaultBindingAdapter(binding) {
 }
 
 // src/client/create-caatinga-client.ts
-var import_core5 = require("@caatinga/core");
+var import_browser5 = require("@caatinga/core/browser");
 
 // src/client/caatinga-contract-client.ts
-var import_core4 = require("@caatinga/core");
+var import_browser4 = require("@caatinga/core/browser");
 
 // src/xdr/build-xdr.ts
-var import_core3 = require("@caatinga/core");
+var import_browser3 = require("@caatinga/core/browser");
 async function buildXdr(input) {
   try {
     const transaction = input.transaction;
@@ -96,13 +96,13 @@ async function buildXdr(input) {
       try {
         preparedTransaction = await transaction.prepare();
       } catch (error) {
-        if (error instanceof import_core3.CaatingaError) {
+        if (error instanceof import_browser3.CaatingaError) {
           throw error;
         }
-        throw new import_core3.CaatingaError(
+        throw new import_browser3.CaatingaError(
           `Failed to prepare XDR for "${input.contractName}.${input.method}".`,
-          import_core3.CaatingaErrorCode.XDR_PREPARE_FAILED,
-          "Check RPC connectivity, simulation errors, and binding compatibility.",
+          import_browser3.CaatingaErrorCode.XDR_PREPARE_FAILED,
+          `RPC: ${input.rpcUrl}. Check connectivity, simulation errors, and binding compatibility.`,
           error
         );
       }
@@ -119,12 +119,12 @@ async function buildXdr(input) {
       ...input.debug ? { raw: preparedTransaction } : {}
     };
   } catch (error) {
-    if (error instanceof import_core3.CaatingaError) {
+    if (error instanceof import_browser3.CaatingaError) {
       throw error;
     }
-    throw new import_core3.CaatingaError(
+    throw new import_browser3.CaatingaError(
       `Failed to build XDR for "${input.contractName}.${input.method}".`,
-      import_core3.CaatingaErrorCode.XDR_BUILD_FAILED,
+      import_browser3.CaatingaErrorCode.XDR_BUILD_FAILED,
       "Check the generated binding transaction object.",
       error
     );
@@ -133,9 +133,9 @@ async function buildXdr(input) {
 function readXdr(transaction) {
   const candidate = transaction;
   if (typeof candidate.toXDR !== "function") {
-    throw new import_core3.CaatingaError(
+    throw new import_browser3.CaatingaError(
       "Binding transaction object does not expose toXDR().",
-      import_core3.CaatingaErrorCode.XDR_BUILD_FAILED,
+      import_browser3.CaatingaErrorCode.XDR_BUILD_FAILED,
       "Regenerate bindings or provide a compatible binding adapter."
     );
   }
@@ -164,6 +164,7 @@ var CaatingaContractClient = class {
       method,
       contractId,
       transaction,
+      rpcUrl: this.config.network.rpcUrl,
       debug: debugRaw
     });
   }
@@ -175,23 +176,44 @@ var CaatingaContractClient = class {
       method,
       contractId,
       transaction,
+      rpcUrl: this.config.network.rpcUrl,
       debug: debugRaw
     });
     let signedXdr;
     try {
-      signedXdr = await this.config.wallet.signTransaction({
-        xdr: xdr.preparedXdr,
-        networkPassphrase: this.config.network.networkPassphrase
-      });
+      signedXdr = await this.withWalletTimeout(
+        "signTransaction",
+        () => this.config.wallet.signTransaction({
+          xdr: xdr.preparedXdr,
+          networkPassphrase: this.config.network.networkPassphrase
+        })
+      );
     } catch (error) {
-      throw new import_core4.CaatingaError(
+      if (error instanceof import_browser4.CaatingaError) {
+        throw error;
+      }
+      throw new import_browser4.CaatingaError(
         `Failed to sign XDR for "${this.contractName}.${method}".`,
-        import_core4.CaatingaErrorCode.XDR_SIGN_FAILED,
+        import_browser4.CaatingaErrorCode.XDR_SIGN_FAILED,
         "Connect a wallet and approve the transaction.",
         error
       );
     }
-    const raw = await submitTransaction(transaction, signedXdr, this.contractName, method);
+    if (typeof signedXdr !== "string" || signedXdr.trim().length === 0) {
+      throw new import_browser4.CaatingaError(
+        `Failed to sign XDR for "${this.contractName}.${method}".`,
+        import_browser4.CaatingaErrorCode.XDR_SIGN_FAILED,
+        "Wallet returned an empty or invalid signed XDR. The user may have dismissed the signing prompt.",
+        signedXdr
+      );
+    }
+    const raw = await submitTransaction(
+      transaction,
+      signedXdr,
+      this.contractName,
+      method,
+      this.config.network.rpcUrl
+    );
     const normalized = normalizeSubmitResult(raw);
     return {
       status: "confirmed",
@@ -219,14 +241,17 @@ var CaatingaContractClient = class {
     });
     let publicKey;
     try {
-      publicKey = await this.config.wallet.getPublicKey();
+      publicKey = await this.withWalletTimeout(
+        "getPublicKey",
+        () => this.config.wallet.getPublicKey()
+      );
     } catch (error) {
-      if (error instanceof import_core4.CaatingaError) {
+      if (error instanceof import_browser4.CaatingaError) {
         throw error;
       }
-      throw new import_core4.CaatingaError(
+      throw new import_browser4.CaatingaError(
         `Wallet is not connected or the public key is unavailable for "${this.contractName}".`,
-        import_core4.CaatingaErrorCode.WALLET_NOT_CONNECTED,
+        import_browser4.CaatingaErrorCode.WALLET_NOT_CONNECTED,
         "Connect the wallet and grant account access, then retry.",
         error
       );
@@ -240,6 +265,41 @@ var CaatingaContractClient = class {
     const transaction = await this.bindingAdapter.callMethod({ client, method, args });
     return { contractId, transaction };
   }
+  withWalletTimeout(label, fn) {
+    const timeoutMs = this.config.walletTimeout;
+    if (timeoutMs === void 0 || timeoutMs <= 0) {
+      return fn();
+    }
+    let timedOut = false;
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        timedOut = true;
+        reject(
+          new import_browser4.CaatingaError(
+            `Wallet "${label}" timed out after ${timeoutMs}ms.`,
+            import_browser4.CaatingaErrorCode.WALLET_TIMEOUT,
+            "Ensure the wallet adapter rejects on user dismissal, or increase walletTimeout."
+          )
+        );
+      }, timeoutMs);
+      fn().then(
+        (value) => {
+          if (timedOut) {
+            return;
+          }
+          clearTimeout(timer);
+          resolve(value);
+        },
+        (error) => {
+          if (timedOut) {
+            return;
+          }
+          clearTimeout(timer);
+          reject(error);
+        }
+      );
+    });
+  }
 };
 function splitArgsAndOptions(argsOrOptions, maybeOptions) {
   return {
@@ -263,13 +323,13 @@ function splitInvokeArgsAndOptions(argsOrOptions, maybeOptions) {
     debugRaw: maybeOptions?.debugRaw ?? false
   };
 }
-async function submitTransaction(transaction, signedXdr, contractName, method) {
+async function submitTransaction(transaction, signedXdr, contractName, method, rpcUrl) {
   const candidate = transaction;
   const submit = candidate.signAndSend ?? candidate.send;
   if (typeof submit !== "function") {
-    throw new import_core4.CaatingaError(
+    throw new import_browser4.CaatingaError(
       `Binding transaction for "${contractName}.${method}" cannot be submitted.`,
-      import_core4.CaatingaErrorCode.XDR_SUBMIT_FAILED,
+      import_browser4.CaatingaErrorCode.XDR_SUBMIT_FAILED,
       "Regenerate bindings or provide a compatible binding adapter."
     );
   }
@@ -278,13 +338,13 @@ async function submitTransaction(transaction, signedXdr, contractName, method) {
     assertSubmitResultRecognized(raw, contractName, method);
     return raw;
   } catch (error) {
-    if (error instanceof import_core4.CaatingaError) {
+    if (error instanceof import_browser4.CaatingaError) {
       throw error;
     }
-    throw new import_core4.CaatingaError(
+    throw new import_browser4.CaatingaError(
       `Failed to submit XDR for "${contractName}.${method}".`,
-      import_core4.CaatingaErrorCode.XDR_SUBMIT_FAILED,
-      "Check wallet signature and RPC connectivity.",
+      import_browser4.CaatingaErrorCode.XDR_SUBMIT_FAILED,
+      `RPC: ${rpcUrl}. Check wallet signature and RPC connectivity.`,
       error
     );
   }
@@ -299,9 +359,9 @@ function assertSubmitResultRecognized(raw, contractName, method) {
   if (hasTransactionId || hasResult) {
     return;
   }
-  throw new import_core4.CaatingaError(
+  throw new import_browser4.CaatingaError(
     `Submit returned an unrecognized payload for "${contractName}.${method}".`,
-    import_core4.CaatingaErrorCode.XDR_RESULT_FAILED,
+    import_browser4.CaatingaErrorCode.XDR_RESULT_FAILED,
     "Expected txHash, transactionHash, hash, or result on the submit response. Use debugRaw to inspect the binding output."
   );
 }
@@ -319,9 +379,9 @@ function createCaatingaClient(config) {
     contract(contractName) {
       const registration = config.contracts[contractName];
       if (!registration) {
-        throw new import_core5.CaatingaError(
+        throw new import_browser5.CaatingaError(
           `Contract "${contractName}" is not registered.`,
-          import_core5.CaatingaErrorCode.CONTRACT_NOT_FOUND,
+          import_browser5.CaatingaErrorCode.CONTRACT_NOT_FOUND,
           "Add the contract binding to createCaatingaClient()."
         );
       }

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { a as CaatingaBindingAdapter, b as CaatingaClientConfig, c as CaatingaContractRegistration, d as CaatingaXdrBuildResult, e as CaatingaInvokeOptions, f as CaatingaInvokeResult } from './types-CiM5FkDn.cjs';
-export { g as CaatingaInvokeStatus, h as CaatingaNetwork, C as CaatingaWalletAdapter } from './types-CiM5FkDn.cjs';
-import { CaatingaArtifacts } from '@caatinga/core';
+import { a as CaatingaBindingAdapter, b as CaatingaClientConfig, c as CaatingaContractRegistration, d as CaatingaXdrBuildResult, e as CaatingaInvokeOptions, f as CaatingaInvokeResult } from './types-DUgMJXLA.cjs';
+export { g as CaatingaInvokeStatus, h as CaatingaNetwork, C as CaatingaWalletAdapter } from './types-DUgMJXLA.cjs';
+import { CaatingaArtifacts } from '@caatinga/core/browser';
 
 declare function resolveContractId(input: {
     artifacts: CaatingaArtifacts;
@@ -30,6 +30,7 @@ declare class CaatingaContractClient {
     }): Promise<CaatingaXdrBuildResult>;
     invoke<T = unknown>(method: string, argsOrOptions?: Record<string, unknown> | CaatingaInvokeOptions, maybeOptions?: CaatingaInvokeOptions): Promise<CaatingaInvokeResult<T>>;
     private createTransaction;
+    private withWalletTimeout;
 }
 
 declare function createCaatingaClient(config: CaatingaClientConfig): {
@@ -41,6 +42,7 @@ declare function buildXdr(input: {
     method: string;
     contractId: string;
     transaction: unknown;
+    rpcUrl: string;
     debug?: boolean;
 }): Promise<CaatingaXdrBuildResult>;
 

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { a as CaatingaBindingAdapter, b as CaatingaClientConfig, c as CaatingaContractRegistration, d as CaatingaXdrBuildResult, e as CaatingaInvokeOptions, f as CaatingaInvokeResult } from './types-CiM5FkDn.js';
-export { g as CaatingaInvokeStatus, h as CaatingaNetwork, C as CaatingaWalletAdapter } from './types-CiM5FkDn.js';
-import { CaatingaArtifacts } from '@caatinga/core';
+import { a as CaatingaBindingAdapter, b as CaatingaClientConfig, c as CaatingaContractRegistration, d as CaatingaXdrBuildResult, e as CaatingaInvokeOptions, f as CaatingaInvokeResult } from './types-DUgMJXLA.js';
+export { g as CaatingaInvokeStatus, h as CaatingaNetwork, C as CaatingaWalletAdapter } from './types-DUgMJXLA.js';
+import { CaatingaArtifacts } from '@caatinga/core/browser';
 
 declare function resolveContractId(input: {
     artifacts: CaatingaArtifacts;
@@ -30,6 +30,7 @@ declare class CaatingaContractClient {
     }): Promise<CaatingaXdrBuildResult>;
     invoke<T = unknown>(method: string, argsOrOptions?: Record<string, unknown> | CaatingaInvokeOptions, maybeOptions?: CaatingaInvokeOptions): Promise<CaatingaInvokeResult<T>>;
     private createTransaction;
+    private withWalletTimeout;
 }
 
 declare function createCaatingaClient(config: CaatingaClientConfig): {
@@ -41,6 +42,7 @@ declare function buildXdr(input: {
     method: string;
     contractId: string;
     transaction: unknown;
+    rpcUrl: string;
     debug?: boolean;
 }): Promise<CaatingaXdrBuildResult>;
 

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/artifacts/resolve-contract-id.ts
-import { CaatingaError, CaatingaErrorCode } from "@caatinga/core";
+import { CaatingaError, CaatingaErrorCode } from "@caatinga/core/browser";
 function resolveContractId(input) {
   if (input.explicitContractId) {
     return input.explicitContractId;
@@ -16,7 +16,7 @@ function resolveContractId(input) {
 }
 
 // src/bindings/default-binding-adapter.ts
-import { CaatingaError as CaatingaError2, CaatingaErrorCode as CaatingaErrorCode2 } from "@caatinga/core";
+import { CaatingaError as CaatingaError2, CaatingaErrorCode as CaatingaErrorCode2 } from "@caatinga/core/browser";
 function createDefaultBindingAdapter(binding) {
   return {
     createClient({ contractId, publicKey, rpcUrl, networkPassphrase }) {
@@ -50,13 +50,13 @@ function createDefaultBindingAdapter(binding) {
 }
 
 // src/client/create-caatinga-client.ts
-import { CaatingaError as CaatingaError5, CaatingaErrorCode as CaatingaErrorCode5 } from "@caatinga/core";
+import { CaatingaError as CaatingaError5, CaatingaErrorCode as CaatingaErrorCode5 } from "@caatinga/core/browser";
 
 // src/client/caatinga-contract-client.ts
-import { CaatingaError as CaatingaError4, CaatingaErrorCode as CaatingaErrorCode4 } from "@caatinga/core";
+import { CaatingaError as CaatingaError4, CaatingaErrorCode as CaatingaErrorCode4 } from "@caatinga/core/browser";
 
 // src/xdr/build-xdr.ts
-import { CaatingaError as CaatingaError3, CaatingaErrorCode as CaatingaErrorCode3 } from "@caatinga/core";
+import { CaatingaError as CaatingaError3, CaatingaErrorCode as CaatingaErrorCode3 } from "@caatinga/core/browser";
 async function buildXdr(input) {
   try {
     const transaction = input.transaction;
@@ -72,7 +72,7 @@ async function buildXdr(input) {
         throw new CaatingaError3(
           `Failed to prepare XDR for "${input.contractName}.${input.method}".`,
           CaatingaErrorCode3.XDR_PREPARE_FAILED,
-          "Check RPC connectivity, simulation errors, and binding compatibility.",
+          `RPC: ${input.rpcUrl}. Check connectivity, simulation errors, and binding compatibility.`,
           error
         );
       }
@@ -134,6 +134,7 @@ var CaatingaContractClient = class {
       method,
       contractId,
       transaction,
+      rpcUrl: this.config.network.rpcUrl,
       debug: debugRaw
     });
   }
@@ -145,15 +146,22 @@ var CaatingaContractClient = class {
       method,
       contractId,
       transaction,
+      rpcUrl: this.config.network.rpcUrl,
       debug: debugRaw
     });
     let signedXdr;
     try {
-      signedXdr = await this.config.wallet.signTransaction({
-        xdr: xdr.preparedXdr,
-        networkPassphrase: this.config.network.networkPassphrase
-      });
+      signedXdr = await this.withWalletTimeout(
+        "signTransaction",
+        () => this.config.wallet.signTransaction({
+          xdr: xdr.preparedXdr,
+          networkPassphrase: this.config.network.networkPassphrase
+        })
+      );
     } catch (error) {
+      if (error instanceof CaatingaError4) {
+        throw error;
+      }
       throw new CaatingaError4(
         `Failed to sign XDR for "${this.contractName}.${method}".`,
         CaatingaErrorCode4.XDR_SIGN_FAILED,
@@ -161,7 +169,21 @@ var CaatingaContractClient = class {
         error
       );
     }
-    const raw = await submitTransaction(transaction, signedXdr, this.contractName, method);
+    if (typeof signedXdr !== "string" || signedXdr.trim().length === 0) {
+      throw new CaatingaError4(
+        `Failed to sign XDR for "${this.contractName}.${method}".`,
+        CaatingaErrorCode4.XDR_SIGN_FAILED,
+        "Wallet returned an empty or invalid signed XDR. The user may have dismissed the signing prompt.",
+        signedXdr
+      );
+    }
+    const raw = await submitTransaction(
+      transaction,
+      signedXdr,
+      this.contractName,
+      method,
+      this.config.network.rpcUrl
+    );
     const normalized = normalizeSubmitResult(raw);
     return {
       status: "confirmed",
@@ -189,7 +211,10 @@ var CaatingaContractClient = class {
     });
     let publicKey;
     try {
-      publicKey = await this.config.wallet.getPublicKey();
+      publicKey = await this.withWalletTimeout(
+        "getPublicKey",
+        () => this.config.wallet.getPublicKey()
+      );
     } catch (error) {
       if (error instanceof CaatingaError4) {
         throw error;
@@ -210,6 +235,41 @@ var CaatingaContractClient = class {
     const transaction = await this.bindingAdapter.callMethod({ client, method, args });
     return { contractId, transaction };
   }
+  withWalletTimeout(label, fn) {
+    const timeoutMs = this.config.walletTimeout;
+    if (timeoutMs === void 0 || timeoutMs <= 0) {
+      return fn();
+    }
+    let timedOut = false;
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        timedOut = true;
+        reject(
+          new CaatingaError4(
+            `Wallet "${label}" timed out after ${timeoutMs}ms.`,
+            CaatingaErrorCode4.WALLET_TIMEOUT,
+            "Ensure the wallet adapter rejects on user dismissal, or increase walletTimeout."
+          )
+        );
+      }, timeoutMs);
+      fn().then(
+        (value) => {
+          if (timedOut) {
+            return;
+          }
+          clearTimeout(timer);
+          resolve(value);
+        },
+        (error) => {
+          if (timedOut) {
+            return;
+          }
+          clearTimeout(timer);
+          reject(error);
+        }
+      );
+    });
+  }
 };
 function splitArgsAndOptions(argsOrOptions, maybeOptions) {
   return {
@@ -233,7 +293,7 @@ function splitInvokeArgsAndOptions(argsOrOptions, maybeOptions) {
     debugRaw: maybeOptions?.debugRaw ?? false
   };
 }
-async function submitTransaction(transaction, signedXdr, contractName, method) {
+async function submitTransaction(transaction, signedXdr, contractName, method, rpcUrl) {
   const candidate = transaction;
   const submit = candidate.signAndSend ?? candidate.send;
   if (typeof submit !== "function") {
@@ -254,7 +314,7 @@ async function submitTransaction(transaction, signedXdr, contractName, method) {
     throw new CaatingaError4(
       `Failed to submit XDR for "${contractName}.${method}".`,
       CaatingaErrorCode4.XDR_SUBMIT_FAILED,
-      "Check wallet signature and RPC connectivity.",
+      `RPC: ${rpcUrl}. Check wallet signature and RPC connectivity.`,
       error
     );
   }

package/dist/{types-CiM5FkDn.d.cts → types-DUgMJXLA.d.cts}

@@ -1,10 +1,17 @@
-import { CaatingaArtifacts } from '@caatinga/core';
+import { CaatingaArtifacts } from '@caatinga/core/browser';
 
 interface CaatingaNetwork {
     name: string;
     rpcUrl: string;
     networkPassphrase: string;
 }
+/**
+ * Wallet integration for browser-side signing.
+ *
+ * Implementations must reject the returned promise when the user dismisses or
+ * cancels signing (do not leave the promise pending indefinitely). Adapters may
+ * apply their own timeout. Caatinga optionally enforces {@link CaatingaClientConfig.walletTimeout}.
+ */
 interface CaatingaWalletAdapter {
     getPublicKey(): Promise<string>;
     signTransaction(input: {
@@ -20,6 +27,8 @@ interface CaatingaClientConfig {
     network: CaatingaNetwork;
     artifacts: CaatingaArtifacts;
     wallet: CaatingaWalletAdapter;
+    /** Optional timeout (ms) for wallet `getPublicKey` and `signTransaction`. No default when omitted. */
+    walletTimeout?: number;
     contracts: Record<string, CaatingaContractRegistration>;
 }
 type CaatingaInvokeStatus = "built" | "prepared" | "signed" | "submitted" | "confirmed" | "failed";

package/dist/{types-CiM5FkDn.d.ts → types-DUgMJXLA.d.ts}

@@ -1,10 +1,17 @@
-import { CaatingaArtifacts } from '@caatinga/core';
+import { CaatingaArtifacts } from '@caatinga/core/browser';
 
 interface CaatingaNetwork {
     name: string;
     rpcUrl: string;
     networkPassphrase: string;
 }
+/**
+ * Wallet integration for browser-side signing.
+ *
+ * Implementations must reject the returned promise when the user dismisses or
+ * cancels signing (do not leave the promise pending indefinitely). Adapters may
+ * apply their own timeout. Caatinga optionally enforces {@link CaatingaClientConfig.walletTimeout}.
+ */
 interface CaatingaWalletAdapter {
     getPublicKey(): Promise<string>;
     signTransaction(input: {
@@ -20,6 +27,8 @@ interface CaatingaClientConfig {
     network: CaatingaNetwork;
     artifacts: CaatingaArtifacts;
     wallet: CaatingaWalletAdapter;
+    /** Optional timeout (ms) for wallet `getPublicKey` and `signTransaction`. No default when omitted. */
+    walletTimeout?: number;
     contracts: Record<string, CaatingaContractRegistration>;
 }
 type CaatingaInvokeStatus = "built" | "prepared" | "signed" | "submitted" | "confirmed" | "failed";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caatinga/client",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Browser and Node client for Soroban smart contracts — connects generated bindings, Caatinga artifacts, and wallet adapters",
   "keywords": [
     "stellar",
@@ -46,7 +46,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@caatinga/core": "^0.2.1"
+    "@caatinga/core": "^0.2.2"
   },
   "devDependencies": {
     "tsup": "^8.3.5",
@@ -64,6 +64,7 @@
   "scripts": {
     "build": "tsup src/index.ts src/freighter.ts --format esm,cjs --dts",
     "test": "vitest run --pool=threads",
+    "pretypecheck": "pnpm --filter @caatinga/core run build",
     "typecheck": "tsc --noEmit"
   }
 }