@secondlayer/stacks 2.5.2 → 2.6.0

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

@@ -27,109 +27,6 @@ type ProviderAccount = {
 	publicKey: string
 	provider: StacksProvider
 };
-/** Full chain descriptor used by clients and transports for network-aware operations. */
-type StacksChain = {
-	/** Chain ID (e.g. 0x00000001 for mainnet) */
-	id: number
-	/** Human-readable name */
-	name: string
-	/** Network type */
-	network: "mainnet" | "testnet"
-	/** Transaction version byte for serialization */
-	transactionVersion: number
-	/** Peer network ID for P2P broadcasting */
-	peerNetworkId: number
-	/** Address version bytes */
-	addressVersion: {
-		singleSig: number
-		multiSig: number
-	}
-	/** Magic bytes for network identification */
-	magicBytes: string
-	/** Boot address (system contracts deployer) */
-	bootAddress: string
-	/** Native currency info */
-	nativeCurrency: {
-		name: string
-		symbol: string
-		decimals: number
-	}
-	/** Default RPC URLs */
-	rpcUrls: {
-		default: {
-			http: string[]
-			ws?: string[]
-		}
-	}
-	/** Block explorer URLs */
-	blockExplorers?: {
-		default: {
-			name: string
-			url: string
-		}
-	}
-};
-/** Function that sends an HTTP request to a Stacks node API path. */
-type RequestFn = (path: string, options?: RequestOptions) => Promise<any>;
-/** Options for a transport-level HTTP request. */
-type RequestOptions = {
-	method?: "GET" | "POST" | "PUT" | "DELETE"
-	body?: unknown
-	headers?: Record<string, string>
-};
-/** Shared configuration for all transport types. */
-type TransportConfig = {
-	url?: string
-	timeout?: number
-	retryCount?: number
-	retryDelay?: number
-	fetchOptions?: RequestInit
-	apiKey?: string
-};
-/** A resolved transport instance with a bound request function. */
-type Transport = {
-	type: string
-	request: RequestFn
-	config: TransportConfig
-	destroy?: () => void
-};
-/** Union of all supported account types (local key, custom signer, or browser provider). */
-type Account = LocalAccount | CustomAccount | ProviderAccount;
-/**
-* Core client instance that holds chain context, transport, and extensible actions.
-* Created via {@link createClient}, {@link createPublicClient}, or {@link createWalletClient}.
-*/
-type Client<TExtended extends Record<string, unknown> = Record<string, unknown>> = {
-	chain?: StacksChain
-	account?: Account
-	transport: Transport
-	request: RequestFn
-	extend: <const TNew extends Record<string, unknown>>(fn: (client: Client<TExtended>) => TNew) => Client<TExtended & TNew> & TNew
-} & TExtended;
-type GetNonceParams = {
-	address: string
-};
-declare function getNonce(client: Client, params: GetNonceParams): Promise<bigint>;
-type GetBalanceParams = {
-	address: string
-};
-declare function getBalance(client: Client, params: GetBalanceParams): Promise<bigint>;
-type GetAccountInfoParams = {
-	address: string
-};
-type AccountInfo = {
-	balance: bigint
-	nonce: bigint
-	balanceProof: string
-	nonceProof: string
-};
-declare function getAccountInfo(client: Client, params: GetAccountInfoParams): Promise<AccountInfo>;
-type GetBlockParams = {
-	height?: number
-	hash?: string
-};
-declare function getBlock(client: Client, params?: GetBlockParams): Promise<any>;
-declare function getBlockHeight(client: Client): Promise<number>;
 type IntCV = {
 	readonly type: "int"
 	readonly value: bigint
@@ -192,23 +89,6 @@ type StringUtf8CV = {
 	readonly value: string
 };
 type ClarityValue = IntCV | UIntCV | BooleanCV | BufferCV | NoneCV | SomeCV | ResponseOkCV | ResponseErrorCV | StandardPrincipalCV | ContractPrincipalCV | ListCV | TupleCV | StringAsciiCV | StringUtf8CV;
-type ReadContractParams = {
-	contract: string
-	functionName: string
-	args?: ClarityValue[]
-	sender?: string
-};
-declare function readContract<T extends ClarityValue = ClarityValue>(client: Client, params: ReadContractParams): Promise<T>;
-type GetContractAbiParams = {
-	contract: string
-};
-declare function getContractAbi(client: Client, params: GetContractAbiParams): Promise<any>;
-type GetMapEntryParams = {
-	contract: string
-	mapName: string
-	key: ClarityValue
-};
-declare function getMapEntry<T extends ClarityValue = ClarityValue>(client: Client, params: GetMapEntryParams): Promise<T>;
 declare const AuthType: {
 	readonly Standard: 0x04
 	readonly Sponsored: 0x05
@@ -397,6 +277,139 @@ type AssetInfoWire = {
 	contractName: string
 	assetName: string
 };
+/** 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>
+};
+/** Full chain descriptor used by clients and transports for network-aware operations. */
+type StacksChain = {
+	/** Chain ID (e.g. 0x00000001 for mainnet) */
+	id: number
+	/** Human-readable name */
+	name: string
+	/** Network type */
+	network: "mainnet" | "testnet"
+	/** Transaction version byte for serialization */
+	transactionVersion: number
+	/** Peer network ID for P2P broadcasting */
+	peerNetworkId: number
+	/** Address version bytes */
+	addressVersion: {
+		singleSig: number
+		multiSig: number
+	}
+	/** Magic bytes for network identification */
+	magicBytes: string
+	/** Boot address (system contracts deployer) */
+	bootAddress: string
+	/** Native currency info */
+	nativeCurrency: {
+		name: string
+		symbol: string
+		decimals: number
+	}
+	/** Default RPC URLs */
+	rpcUrls: {
+		default: {
+			http: string[]
+			ws?: string[]
+		}
+	}
+	/** Block explorer URLs */
+	blockExplorers?: {
+		default: {
+			name: string
+			url: string
+		}
+	}
+};
+/** Function that sends an HTTP request to a Stacks node API path. */
+type RequestFn = (path: string, options?: RequestOptions) => Promise<any>;
+/** Options for a transport-level HTTP request. */
+type RequestOptions = {
+	method?: "GET" | "POST" | "PUT" | "DELETE"
+	body?: unknown
+	headers?: Record<string, string>
+};
+/** Shared configuration for all transport types. */
+type TransportConfig = {
+	url?: string
+	timeout?: number
+	retryCount?: number
+	retryDelay?: number
+	fetchOptions?: RequestInit
+	apiKey?: string
+};
+/** A resolved transport instance with a bound request function. */
+type Transport = {
+	type: string
+	request: RequestFn
+	config: TransportConfig
+	destroy?: () => void
+};
+/** Union of all supported account types (local key, custom signer, or browser provider). */
+type Account = LocalAccount | CustomAccount | ProviderAccount;
+/**
+* Core client instance that holds chain context, transport, and extensible actions.
+* Created via {@link createClient}, {@link createPublicClient}, or {@link createWalletClient}.
+*/
+type Client<TExtended extends Record<string, unknown> = Record<string, unknown>> = {
+	chain?: StacksChain
+	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;
+type GetNonceParams = {
+	address: string
+};
+declare function getNonce(client: Client, params: GetNonceParams): Promise<bigint>;
+type GetBalanceParams = {
+	address: string
+};
+declare function getBalance(client: Client, params: GetBalanceParams): Promise<bigint>;
+type GetAccountInfoParams = {
+	address: string
+};
+type AccountInfo = {
+	balance: bigint
+	nonce: bigint
+	balanceProof: string
+	nonceProof: string
+};
+declare function getAccountInfo(client: Client, params: GetAccountInfoParams): Promise<AccountInfo>;
+type GetBlockParams = {
+	height?: number
+	hash?: string
+};
+declare function getBlock(client: Client, params?: GetBlockParams): Promise<any>;
+declare function getBlockHeight(client: Client): Promise<number>;
+type ReadContractParams = {
+	contract: string
+	functionName: string
+	args?: ClarityValue[]
+	sender?: string
+};
+declare function readContract<T extends ClarityValue = ClarityValue>(client: Client, params: ReadContractParams): Promise<T>;
+type GetContractAbiParams = {
+	contract: string
+};
+declare function getContractAbi(client: Client, params: GetContractAbiParams): Promise<any>;
+type GetMapEntryParams = {
+	contract: string
+	mapName: string
+	key: ClarityValue
+};
+declare function getMapEntry<T extends ClarityValue = ClarityValue>(client: Client, params: GetMapEntryParams): Promise<T>;
 type EstimateFeeParams = {
 	transaction: StacksTransaction
 };

package/dist/src/actions/index.js

@@ -1,7 +1,7 @@
 import {
   ContractResponseError,
   getContract
-} from "../../shared/stacks-hyz7zgdk.js";
+} from "../../shared/stacks-hr5rg2et.js";
 import {
   deployContract,
   getAccountInfo,
@@ -15,12 +15,12 @@ import {
   simulateCall,
   simulateTransaction,
   transferStx
-} from "../../shared/stacks-5th5dffx.js";
+} from "../../shared/stacks-yb8xesdm.js";
 import {
   callContract,
   getMapEntry,
   readContract
-} from "../../shared/stacks-yq5a5cda.js";
+} from "../../shared/stacks-a9cn5ehj.js";
 import {
   watchAddress,
   watchAddressBalance,
@@ -31,13 +31,13 @@ import {
 } from "../../shared/stacks-tjjnkt3r.js";
 import {
   sponsorTransaction
-} from "../../shared/stacks-4z1jhw6y.js";
+} from "../../shared/stacks-ffsv2t3t.js";
 import {
   estimateFee,
   getNonce,
   isProviderAccount,
   sendTransaction
-} from "../../shared/stacks-y8e3gx6w.js";
+} from "../../shared/stacks-gxhznn3h.js";
 import"../../shared/stacks-709tra19.js";
 import"../../shared/stacks-g7ffp8aj.js";
 import"../../shared/stacks-wqgepfab.js";

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

@@ -27,6 +27,17 @@ 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>
+};
 /** Full chain descriptor used by clients and transports for network-aware operations. */
 type StacksChain = {
 	/** Chain ID (e.g. 0x00000001 for mainnet) */
@@ -104,6 +115,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;
 interface FullyQualifiedName {

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

@@ -27,6 +27,17 @@ 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>
+};
 /** Full chain descriptor used by clients and transports for network-aware operations. */
 type StacksChain = {
 	/** Chain ID (e.g. 0x00000001 for mainnet) */
@@ -104,6 +115,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;
 interface FullyQualifiedName {

package/dist/src/bns/index.js

@@ -3,9 +3,9 @@ import"../../shared/stacks-kg1npstf.js";
 import {
   ContractResponseError,
   getContract
-} from "../../shared/stacks-hyz7zgdk.js";
-import"../../shared/stacks-yq5a5cda.js";
-import"../../shared/stacks-y8e3gx6w.js";
+} from "../../shared/stacks-hr5rg2et.js";
+import"../../shared/stacks-a9cn5ehj.js";
+import"../../shared/stacks-gxhznn3h.js";
 import"../../shared/stacks-709tra19.js";
 import"../../shared/stacks-g7ffp8aj.js";
 import"../../shared/stacks-z53fwfcm.js";

package/dist/src/index.cjs

@@ -4,14 +4,20 @@ __export(exports_src, {
   webSocket: () => webSocket,
   walletActions: () => walletActions,
   testnet: () => testnet,
+  resolveNonce: () => resolveNonce,
+  redisStore: () => redisStore,
   publicActions: () => publicActions,
   providerToAccount: () => providerToAccount,
+  postgresStore: () => postgresStore,
   parseStx: () => parseStx,
   on: () => exports_on,
   multisigActions: () => multisigActions,
   mocknet: () => mocknet,
+  memoryStore: () => memoryStore,
   mainnet: () => mainnet,
+  jsonRpcSource: () => jsonRpcSource,
   isValidAddress: () => isValidAddress,
+  isNonceConflictError: () => isNonceConflictError,
   isAddressEqual: () => isAddressEqual,
   http: () => http,
   getContractAddress: () => getContractAddress,
@@ -22,8 +28,10 @@ __export(exports_src, {
   custom: () => custom,
   createWalletClient: () => createWalletClient,
   createPublicClient: () => createPublicClient,
+  createNonceManager: () => createNonceManager,
   createMultiSigClient: () => createMultiSigClient,
   createClient: () => createClient,
+  broadcastWithNonceReset: () => broadcastWithNonceReset,
   ZERO_ADDRESS: () => ZERO_ADDRESS,
   WebSocketError: () => WebSocketError,
   TransactionError: () => TransactionError,
@@ -46,6 +54,7 @@ var BASE_KEYS = new Set([
   "account",
   "transport",
   "request",
+  "nonceManager",
   "extend"
 ]);
 function bindExtend(base) {
@@ -68,6 +77,7 @@ function createClient(config) {
     account: config.account,
     transport,
     request: transport.request,
+    nonceManager: config.nonceManager,
     extend: null
   };
   client.extend = bindExtend(client);
@@ -124,15 +134,17 @@ function multisigActions(client) {
   if (!msConfig)
     throw new Error("multisigActions requires a multi-sig client");
   const { signers, requiredSignatures, hashMode } = msConfig;
-  async function resolveNonce(nonce) {
+  async function resolveNonce2(nonce) {
     if (nonce !== undefined)
       return nonce;
     const address = makeMultiSigAddress(signers, requiredSignatures, client.chain);
+    if (client.nonceManager)
+      return client.nonceManager.consume({ client, address });
     return getNonce(client, { address });
   }
   return {
     async transferStx(params) {
-      const nonce = await resolveNonce(params.nonce);
+      const nonce = await resolveNonce2(params.nonce);
       const unsigned = buildTokenTransfer({
         recipient: params.to,
         amount: params.amount,
@@ -157,7 +169,7 @@ function multisigActions(client) {
     },
     async callContract(params) {
       const [contractAddress, contractName] = parseContractId(params.contract);
-      const nonce = await resolveNonce(params.nonce);
+      const nonce = await resolveNonce2(params.nonce);
       const unsigned = buildContractCall({
         contractAddress,
         contractName,
@@ -182,7 +194,7 @@ function multisigActions(client) {
       return unsigned;
     },
     async deployContract(params) {
-      const nonce = await resolveNonce(params.nonce);
+      const nonce = await resolveNonce2(params.nonce);
       const unsigned = buildContractDeploy({
         contractName: params.contractName,
         codeBody: params.codeBody,
@@ -225,6 +237,68 @@ function createMultiSigClient(config) {
   };
   return client.extend(multisigActions);
 }
+// src/actions/wallet/nonceStores.ts
+var TAKE_IF_PRESENT = `local v = redis.call('GET', KEYS[1])
+if v == false then return false end
+redis.call('INCR', KEYS[1])
+return v`;
+var SEED_OR_TAKE = `local v = redis.call('GET', KEYS[1])
+if v == false then redis.call('SET', KEYS[1], ARGV[1]); v = ARGV[1] end
+redis.call('INCR', KEYS[1])
+return v`;
+function redisStore(params) {
+  const { redis } = params;
+  const prefix = params.prefix ?? "stacks:nonce:";
+  return {
+    async reserve(key, getFloor) {
+      const k = prefix + key;
+      const present = await redis.send("EVAL", [TAKE_IF_PRESENT, "1", k]);
+      if (present != null)
+        return BigInt(present);
+      const floor = await getFloor();
+      const seeded = await redis.send("EVAL", [
+        SEED_OR_TAKE,
+        "1",
+        k,
+        floor.toString()
+      ]);
+      return BigInt(seeded);
+    },
+    async reset(key) {
+      await redis.send("DEL", [prefix + key]);
+    }
+  };
+}
+function postgresStore(params) {
+  const { sql } = params;
+  const shouldEnsure = params.ensureTable ?? true;
+  let ensured = false;
+  async function ensureTable() {
+    if (!shouldEnsure || ensured)
+      return;
+    await sql`CREATE TABLE IF NOT EXISTS stacks_nonce_state (key text PRIMARY KEY, next numeric NOT NULL)`;
+    ensured = true;
+  }
+  return {
+    async reserve(key, getFloor) {
+      await ensureTable();
+      const updated = await sql`UPDATE stacks_nonce_state SET next = next + 1 WHERE key = ${key} RETURNING next - 1 AS nonce`;
+      const warm = updated[0];
+      if (warm)
+        return BigInt(String(warm.nonce));
+      const floor = await getFloor();
+      const seeded = await sql`INSERT INTO stacks_nonce_state (key, next) VALUES (${key}, ${(floor + 1n).toString()}) ON CONFLICT (key) DO UPDATE SET next = stacks_nonce_state.next + 1 RETURNING next - 1 AS nonce`;
+      const cold = seeded[0];
+      if (!cold)
+        throw new Error("postgresStore: insert returned no row");
+      return BigInt(String(cold.nonce));
+    },
+    async reset(key) {
+      await ensureTable();
+      await sql`DELETE FROM stacks_nonce_state WHERE key = ${key}`;
+    }
+  };
+}
 // src/transports/createTransport.ts
 function createTransport(type, config) {
   return {
@@ -643,5 +717,5 @@ class ReadOnlyCallError extends BaseError {
   name = "ReadOnlyCallError";
 }
 
-//# debugId=53C2882DD528F5DF64756E2164756E21
+//# debugId=6ED05F818443D6E764756E2164756E21
 //# sourceMappingURL=index.cjs.map