@secondlayer/stacks 2.5.2 → 2.7.0

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

@@ -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,144 @@ 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>
+	/** 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) */
+	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.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,144 @@ 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>
+	/** 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) */
+	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-k96f5g1a.js";
 import {
   deployContract,
   getAccountInfo,
@@ -15,12 +15,12 @@ import {
   simulateCall,
   simulateTransaction,
   transferStx
-} from "../../shared/stacks-5th5dffx.js";
+} from "../../shared/stacks-a48qj7ss.js";
 import {
   callContract,
   getMapEntry,
   readContract
-} from "../../shared/stacks-yq5a5cda.js";
+} from "../../shared/stacks-txh6dadn.js";
 import {
   watchAddress,
   watchAddressBalance,
@@ -31,13 +31,13 @@ import {
 } from "../../shared/stacks-tjjnkt3r.js";
 import {
   sponsorTransaction
-} from "../../shared/stacks-4z1jhw6y.js";
+} from "../../shared/stacks-s6v8k4j5.js";
 import {
   estimateFee,
   getNonce,
   isProviderAccount,
   sendTransaction
-} from "../../shared/stacks-y8e3gx6w.js";
+} from "../../shared/stacks-r3mqgw2d.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,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) */
@@ -104,6 +120,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,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) */
@@ -104,6 +120,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-k96f5g1a.js";
+import"../../shared/stacks-txh6dadn.js";
+import"../../shared/stacks-r3mqgw2d.js";
 import"../../shared/stacks-709tra19.js";
 import"../../shared/stacks-g7ffp8aj.js";
 import"../../shared/stacks-z53fwfcm.js";