@secondlayer/stacks 2.5.2 → 2.7.0

package/dist/src/tools/index.d.cts

@@ -28,6 +28,22 @@ type ProviderAccount = {
 	publicKey: string
 	provider: StacksProvider
 };
+/** Allocates mempool-safe sequential nonces across rapid broadcasts from one account. */
+type NonceManager = {
+	consume(params: {
+		client: Client
+		address: string
+	}): Promise<bigint>
+	reset(params: {
+		client: Client
+		address: string
+	}): void | Promise<void>
+	/** Next nonce that {@link NonceManager.consume} would return without consuming it, or `undefined` if untracked. */
+	peek(params: {
+		client: Client
+		address: string
+	}): Promise<bigint | undefined>
+};
 /** Full chain descriptor used by clients and transports for network-aware operations. */
 type StacksChain = {
 	/** Chain ID (e.g. 0x00000001 for mainnet) */
@@ -105,6 +121,8 @@ type Client<TExtended extends Record<string, unknown> = Record<string, unknown>>
 	account?: Account
 	transport: Transport
 	request: RequestFn
+	/** Optional nonce manager for mempool-safe sequential nonces across rapid broadcasts. */
+	nonceManager?: NonceManager
 	extend: <const TNew extends Record<string, unknown>>(fn: (client: Client<TExtended>) => TNew) => Client<TExtended & TNew> & TNew
 } & TExtended;
 /**

package/dist/src/tools/index.d.ts

@@ -28,6 +28,22 @@ type ProviderAccount = {
 	publicKey: string
 	provider: StacksProvider
 };
+/** Allocates mempool-safe sequential nonces across rapid broadcasts from one account. */
+type NonceManager = {
+	consume(params: {
+		client: Client
+		address: string
+	}): Promise<bigint>
+	reset(params: {
+		client: Client
+		address: string
+	}): void | Promise<void>
+	/** Next nonce that {@link NonceManager.consume} would return without consuming it, or `undefined` if untracked. */
+	peek(params: {
+		client: Client
+		address: string
+	}): Promise<bigint | undefined>
+};
 /** Full chain descriptor used by clients and transports for network-aware operations. */
 type StacksChain = {
 	/** Chain ID (e.g. 0x00000001 for mainnet) */
@@ -105,6 +121,8 @@ type Client<TExtended extends Record<string, unknown> = Record<string, unknown>>
 	account?: Account
 	transport: Transport
 	request: RequestFn
+	/** Optional nonce manager for mempool-safe sequential nonces across rapid broadcasts. */
+	nonceManager?: NonceManager
 	extend: <const TNew extends Record<string, unknown>>(fn: (client: Client<TExtended>) => TNew) => Client<TExtended & TNew> & TNew
 } & TExtended;
 /**

package/dist/src/tools/index.js

@@ -1308,14 +1308,6 @@ function getTransactionId(tx) {
   return txid(tx);
 }
 
-// src/actions/public/getNonce.ts
-async function getNonce(client, params) {
-  const data = await client.request(`/v2/accounts/${params.address}`, {
-    method: "GET"
-  });
-  return BigInt(data.nonce);
-}
-
 // src/errors/base.ts
 class BaseError extends Error {
   name = "StacksError";
@@ -1354,6 +1346,14 @@ class BroadcastError extends BaseError {
   }
 }
 
+// src/actions/public/getNonce.ts
+async function getNonce(client, params) {
+  const data = await client.request(`/v2/accounts/${params.address}`, {
+    method: "GET"
+  });
+  return BigInt(data.nonce);
+}
+
 // src/actions/wallet/sendTransaction.ts
 async function sendTransaction(client, params) {
   const hex = bytesToHex(serializeTransaction(params.transaction));
@@ -1374,6 +1374,32 @@ async function sendTransaction(client, params) {
   return { txid: txid2 };
 }
 
+// src/actions/wallet/nonceManager.ts
+async function resolveNonce(client, address) {
+  if (client.nonceManager)
+    return client.nonceManager.consume({ client, address });
+  return getNonce(client, { address });
+}
+function isNonceConflictError(error) {
+  if (!(error instanceof BroadcastError))
+    return false;
+  const haystack = `${error.reason ?? ""} ${error.message}`.toLowerCase();
+  return haystack.includes("nonce");
+}
+async function broadcastWithNonceReset(client, params) {
+  try {
+    const result = await sendTransaction(client, {
+      transaction: params.transaction
+    });
+    return result.txid;
+  } catch (error) {
+    if (client.nonceManager && isNonceConflictError(error)) {
+      await client.nonceManager.reset({ client, address: params.address });
+    }
+    throw error;
+  }
+}
+
 // src/actions/wallet/utils.ts
 function isProviderAccount(account) {
   return account.type === "provider";
@@ -1385,15 +1411,15 @@ async function callContract(client, params) {
   if (!account)
     throw new Error("Account required");
   if (isProviderAccount(account)) {
-    const result2 = await account.provider.request("stx_callContract", {
+    const result = await account.provider.request("stx_callContract", {
       contract: params.contract,
       functionName: params.functionName,
       functionArgs: params.functionArgs ?? []
     });
-    return result2.txid;
+    return result.txid;
   }
   const [contractAddress, contractName] = parseContractId(params.contract);
-  const nonce = params.nonce ?? await getNonce(client, { address: account.address });
+  const nonce = params.nonce ?? await resolveNonce(client, account.address);
   const unsigned = buildContractCall({
     contractAddress,
     contractName,
@@ -1414,8 +1440,10 @@ async function callContract(client, params) {
     }
   }
   const signed = await signTransactionWithAccount(unsigned, account);
-  const result = await sendTransaction(client, { transaction: signed });
-  return result.txid;
+  return broadcastWithNonceReset(client, {
+    transaction: signed,
+    address: account.address
+  });
 }
 
 // src/actions/getContract.ts
@@ -2149,6 +2177,7 @@ var BASE_KEYS = new Set([
   "account",
   "transport",
   "request",
+  "nonceManager",
   "extend"
 ]);
 function bindExtend(base) {
@@ -2171,6 +2200,7 @@ function createClient(config) {
     account: config.account,
     transport,
     request: transport.request,
+    nonceManager: config.nonceManager,
     extend: null
   };
   client.extend = bindExtend(client);
@@ -2685,5 +2715,5 @@ export {
   bnsResolve
 };
 
-//# debugId=E290B0A365AB8FB964756E2164756E21
+//# debugId=0F3EC6E73449FBC864756E2164756E21
 //# sourceMappingURL=index.js.map