@secondlayer/stacks 4.3.2 → 5.0.0

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

@@ -311,6 +311,15 @@ type NonceManager = {
 		client: Client
 		address: string
 	}): void | Promise<void>
+	/**
+	* Give back a nonce from {@link NonceManager.consume} whose transaction
+	* was never accepted by the node. No-op unless it is the latest issued.
+	*/
+	release(params: {
+		client: Client
+		address: string
+		nonce: bigint
+	}): void | Promise<void>
 	/** Next nonce that {@link NonceManager.consume} would return without consuming it, or `undefined` if untracked. */
 	peek(params: {
 		client: Client
@@ -366,14 +375,32 @@ type RequestOptions = {
 	method?: "GET" | "POST" | "PUT" | "DELETE"
 	body?: unknown
 	headers?: Record<string, string>
+	/**
+	* Cancel the request from the caller's side. An aborted signal rejects
+	* with the signal's reason immediately and never retries; it is combined
+	* with the transport's own per-attempt timeout.
+	*/
+	signal?: AbortSignal
+	/**
+	* Override the transport's retry budget for this one request. Broadcasts
+	* pass `0`: re-sending a transaction the node may already hold trades a
+	* transient failure for a confusing nonce conflict.
+	*/
+	retryCount?: number
 };
 /** Shared configuration for all transport types. */
 type TransportConfig = {
 	url?: string
+	/**
+	* Per-attempt deadline in ms covering headers AND body. A stalled body
+	* rejects with `TimeoutError` instead of hanging. Default 30_000.
+	*/
 	timeout?: number
 	retryCount?: number
 	retryDelay?: number
 	fetchOptions?: RequestInit
+	/** Sent as `x-api-key`. Held in the request closure and stripped from
+	*  `Transport.config` so it never prints with the client. */
 	apiKey?: string
 };
 /** A resolved transport instance with a bound request function. */
@@ -420,6 +447,11 @@ type GetBlockParams = {
 	height?: number
 	hash?: string
 };
+/**
+* Fetch one block by hash or height, or the chain tip when both are omitted.
+* Every path resolves to a single block object: the tip read unwraps the
+* list envelope the extended API returns for `?limit=1`.
+*/
 declare function getBlock(client: Client, params?: GetBlockParams): Promise<any>;
 type GetRawBlockParams = {
 	height: number
@@ -510,6 +542,13 @@ type MulticallCall = {
 type MulticallParams<TAllowFailure extends boolean = true> = {
 	calls: readonly MulticallCall[]
 	allowFailure?: TAllowFailure
+	/**
+	* Reads in flight at once. Default 8. Each call is its own
+	* `/v2/contracts/call-read` request (Stacks nodes have no batch RPC), so
+	* an uncapped fan-out turns one multicall into a burst that trips rate
+	* limits and then retries in lockstep.
+	*/
+	concurrency?: number
 };
 type MulticallSuccessResult = {
 	status: "success"
@@ -522,15 +561,25 @@ type MulticallFailureResult = {
 type MulticallResult<T extends boolean> = T extends true ? (MulticallSuccessResult | MulticallFailureResult)[] : ClarityValue[];
 declare function multicall<TAllowFailure extends boolean = true>(client: Client, params: MulticallParams<TAllowFailure>): Promise<MulticallResult<TAllowFailure>>;
 declare class BaseError extends Error {
+	private;
 	name: string;
 	shortMessage: string;
 	details?: string;
 	constructor(shortMessage: string, options?: {
 		cause?: Error
 		details?: string
+		code?: string
 	});
+	/**
+	* Stable identifier for programmatic handling; survives message
+	* rewording and minification. An explicit `code` option wins, else it
+	* is derived from `name` (`TimeoutError` gives `TIMEOUT_ERROR`).
+	*/
+	get code(): string;
+	set code(value: string);
 	toJSON(): {
 		name: string
+		code: string
 		message: string
 		shortMessage: string
 		details: string | undefined
@@ -592,9 +641,9 @@ declare function simulateTransaction(client: Client, params: SimulateTransaction
 *
 *   - {@link extendedApiSource} — default; `/extended/v1/tx/{txid}` on the
 *     client's transport host (Hiro API or any extended-API-compatible host).
-*   - {@link indexTxSource} — Secondlayer's `/v1/index/transactions/{txid}`;
-*     returns the chain tip in the same response, so N-confirmation waits
-*     need no second request.
+*   - {@link indexTxSource}: a Secondlayer instance's
+*     `/v1/index/transactions/{txid}`; returns the chain tip in the same
+*     response, so N-confirmation waits need no second request.
 */
 type TransactionStatus = "pending" | "success" | "abort_by_response" | "abort_by_post_condition" | "dropped";
 type TransactionReceipt = {
@@ -621,8 +670,14 @@ type TransactionStatusSource = {
 		client: Client
 		txid: string
 	}): Promise<TransactionSnapshot>
+	/**
+	* True when the source only knows mined transactions and reports
+	* `receipt: null` for the whole mempool life of a tx. The wait action
+	* then stretches its dropped-grace window to the full timeout, since
+	* "unknown" cannot mean "dropped" until the deadline.
+	*/
+	canonicalOnly?: boolean
 };
-type FetchImpl = typeof globalThis.fetch;
 /**
 * Default source: `GET /extended/v1/tx/{txid}` via the client's transport.
 * Requires a host that serves Hiro's extended API (a bare stacks-node does
@@ -631,17 +686,25 @@ type FetchImpl = typeof globalThis.fetch;
 */
 declare function extendedApiSource(): TransactionStatusSource;
 type IndexTxSourceParams = {
-	/** Base URL of a Secondlayer-shaped index API. */
+	/**
+	* URL of your Secondlayer instance. Without it the client's transport
+	* URL is assumed to be the instance: a transport on a Hiro host throws
+	* up front, and a host that answers `/v1/index` with a non-JSON 404
+	* (a bare stacks-node) throws on the first read. Pass it whenever the
+	* transport is not the instance.
+	*/
 	baseUrl?: string
+	/** Instance token, sent as `Authorization: Bearer`. */
 	apiKey?: string
-	fetchImpl?: FetchImpl
 };
 /**
-* Source backed by Secondlayer's `/v1/index/transactions/{txid}`. The response
-* embeds the chain tip, so N-confirmation math needs no extra request. The
-* index only returns canonical (mined) transactions — while a tx is in the
-* mempool this source reports `receipt: null`, and the wait action's grace
-* window carries it until inclusion.
+* Source backed by a Secondlayer instance's `/v1/index/transactions/{txid}`.
+* The response embeds the chain tip, so N-confirmation math needs no extra
+* request. Requests go through the transport layer: same retries, timeout
+* and typed errors as every other read. The index only returns canonical
+* (mined) transactions; while a tx is in the mempool this source reports
+* `receipt: null`, and the wait action's grace window carries it until
+* inclusion.
 */
 declare function indexTxSource(params?: IndexTxSourceParams): TransactionStatusSource;
 type GetTransactionParams = {
@@ -691,8 +754,9 @@ type WaitForTransactionReceiptParams = {
 	pollingInterval?: number
 	/**
 	* How long a tx may be unknown to the source before it counts as dropped,
-	* ms. Covers broadcast propagation lag and canonical-only sources that
-	* can't see the mempool. Default 30_000.
+	* ms. Covers broadcast propagation lag. Default 30_000, or the full
+	* `timeout` for a canonical-only source (one that cannot see the
+	* mempool, so "unknown" means "not mined yet" until the deadline).
 	*/
 	droppedGracePeriod?: number
 	/** Where to read status from. Defaults to {@link extendedApiSource}. */
@@ -924,14 +988,35 @@ declare function isFeeTier(fee: FeeParam | undefined): fee is FeeTier;
 * stable regardless of the fee value later set on the spending condition.
 */
 declare function minimumFee(transaction: StacksTransaction): bigint;
+/** Outcome of {@link resolveFee}: the amount and which tier produced it. */
+type ResolvedFee = {
+	fee: bigint
+	/**
+	* Tier the amount came from. `'min'` when the estimator had no estimate
+	* and the relay floor was used instead. Absent when the caller passed an
+	* exact amount.
+	*/
+	tier?: FeeTier
+};
+/**
+* True when the node answered `POST /v2/fees/transaction` with 400
+* `NoEstimateAvailable`: it is healthy but has no fee history for this
+* payload (fresh devnet, quiet chain). Every other failure means the
+* estimate was never obtained and must surface to the caller.
+*/
+declare function isNoEstimateAvailable(error: unknown): boolean;
 /**
 * Resolve a fee param to a concrete amount. Numeric input passes through.
 * Tiers `'low' | 'mid' | 'high'` index the node's estimations (nearest
-* available when fewer than three are returned); `'min'` — and any estimation
-* failure (e.g. NoEstimateAvailable) — resolves to {@link minimumFee}, which
-* needs no network round-trip.
+* available when fewer than three are returned); `'min'` resolves to
+* {@link minimumFee}, which needs no network round-trip.
+*
+* The relay floor is the fallback ONLY when the node reports
+* `NoEstimateAvailable` or returns no estimations. A transport timeout, 5xx,
+* or auth failure rethrows: silently under-paying because the node was
+* unreachable would strand the transaction in the mempool.
 */
-declare function resolveFee(client: Client, transaction: StacksTransaction, fee: FeeParam | undefined): Promise<bigint>;
+declare function resolveFee(client: Client, transaction: StacksTransaction, fee: FeeParam | undefined): Promise<ResolvedFee>;
 type TransferStxParams = {
 	to: string
 	amount: IntegerType
@@ -1223,9 +1308,12 @@ type ContractCallOptions = {
 	postConditions?: PostConditionInput[]
 };
 /**
-* Options for `buildCall.*` — building an unsigned transaction for
+* Options for `buildCall.*`, building an unsigned transaction for
 * wallet-signs-later flows. `publicKey` defaults to the client account's
-* public key; `fee`/`nonce` are resolved from the network when omitted.
+* public key. When omitted, `nonce` is the confirmed on-chain nonce read
+* straight from the node (the client's nonce manager is never consumed for
+* a transaction that may never be sent) and `fee` is the mid estimate,
+* falling back to the relay floor only on `NoEstimateAvailable`.
 */
 type ContractBuildCallOptions = ContractCallOptions & {
 	publicKey?: string
@@ -1261,4 +1349,4 @@ declare class ContractResponseError extends Error {
 	name: string;
 	constructor(message: string, errorValue: unknown);
 }
-export { watchTransaction, watchNftEvent, watchMempool, watchBlocks, watchAddressBalance, watchAddress, waitForTransactionReceipt, transferStx, sponsorTransaction, simulateTransaction, simulateCall, signTransactionAction, signMessage2 as signMessage, sendTransaction, resolveFee, readContract, multicall, minimumFee, isResponseOutput, isProviderAccount, isFeeTier, indexTxSource, getTransaction, getRawBlock, getNonce, getNftHoldings, getMempoolStats, getMapEntry, getDataVar, getContractSource, getContractAbi, getContract, getBlockHeight, getBlock, getBalance, getAccountInfo, getAccountHistory, extendedApiSource, estimateFee, deployContract, callContract, buildFunctionArgs, WatchTransactionParams, WatchNftEventParams, WatchMempoolParams, WatchBlocksParams, WatchAddressParams, WatchAddressBalanceParams, WaitForTransactionReceiptParams, UnwrapResponse, TransferStxParams, TransactionStatusSource, TransactionStatus, TransactionSnapshot, TransactionReceipt, SponsorTransactionParams, SimulateTransferResult, SimulateTransactionResult, SimulateTransactionParams, SimulateDeployResult, SimulateContractCallResult, SimulateCallSuccess, SimulateCallResult, SimulateCallParams, SimulateCallFailure, SignTransactionParams, SignMessageParams, SendTransactionResult, SendTransactionParams, ReadContractParams, RawBlockResponse, NftHoldingsResponse, MulticallSuccessResult, MulticallResult, MulticallParams, MulticallFailureResult, MulticallCall, IndexTxSourceParams, GetTransactionParams, GetRawBlockParams, GetNonceParams, GetNftHoldingsParams, GetMapEntryParams, GetDataVarParams, GetContractSourceParams, GetContractParams, GetContractAbiParams, GetBlockParams, GetBalanceParams, GetAccountInfoParams, GetAccountHistoryParams, FeeTier, FeeParam, FeeEstimation, EstimateFeeParams, DeployContractParams, ContractSourceResponse, ContractResponseError, ContractInstance, ContractCallOptions, ContractBuildCallOptions, CallContractParams, AccountInfo, AccountHistoryResponse };
+export { watchTransaction, watchNftEvent, watchMempool, watchBlocks, watchAddressBalance, watchAddress, waitForTransactionReceipt, transferStx, sponsorTransaction, simulateTransaction, simulateCall, signTransactionAction, signMessage2 as signMessage, sendTransaction, resolveFee, readContract, multicall, minimumFee, isResponseOutput, isProviderAccount, isNoEstimateAvailable, isFeeTier, indexTxSource, getTransaction, getRawBlock, getNonce, getNftHoldings, getMempoolStats, getMapEntry, getDataVar, getContractSource, getContractAbi, getContract, getBlockHeight, getBlock, getBalance, getAccountInfo, getAccountHistory, extendedApiSource, estimateFee, deployContract, callContract, buildFunctionArgs, WatchTransactionParams, WatchNftEventParams, WatchMempoolParams, WatchBlocksParams, WatchAddressParams, WatchAddressBalanceParams, WaitForTransactionReceiptParams, UnwrapResponse, TransferStxParams, TransactionStatusSource, TransactionStatus, TransactionSnapshot, TransactionReceipt, SponsorTransactionParams, SimulateTransferResult, SimulateTransactionResult, SimulateTransactionParams, SimulateDeployResult, SimulateContractCallResult, SimulateCallSuccess, SimulateCallResult, SimulateCallParams, SimulateCallFailure, SignTransactionParams, SignMessageParams, SendTransactionResult, SendTransactionParams, ResolvedFee, ReadContractParams, RawBlockResponse, NftHoldingsResponse, MulticallSuccessResult, MulticallResult, MulticallParams, MulticallFailureResult, MulticallCall, IndexTxSourceParams, GetTransactionParams, GetRawBlockParams, GetNonceParams, GetNftHoldingsParams, GetMapEntryParams, GetDataVarParams, GetContractSourceParams, GetContractParams, GetContractAbiParams, GetBlockParams, GetBalanceParams, GetAccountInfoParams, GetAccountHistoryParams, FeeTier, FeeParam, FeeEstimation, EstimateFeeParams, DeployContractParams, ContractSourceResponse, ContractResponseError, ContractInstance, ContractCallOptions, ContractBuildCallOptions, CallContractParams, AccountInfo, AccountHistoryResponse };

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

@@ -311,6 +311,15 @@ type NonceManager = {
 		client: Client
 		address: string
 	}): void | Promise<void>
+	/**
+	* Give back a nonce from {@link NonceManager.consume} whose transaction
+	* was never accepted by the node. No-op unless it is the latest issued.
+	*/
+	release(params: {
+		client: Client
+		address: string
+		nonce: bigint
+	}): void | Promise<void>
 	/** Next nonce that {@link NonceManager.consume} would return without consuming it, or `undefined` if untracked. */
 	peek(params: {
 		client: Client
@@ -366,14 +375,32 @@ type RequestOptions = {
 	method?: "GET" | "POST" | "PUT" | "DELETE"
 	body?: unknown
 	headers?: Record<string, string>
+	/**
+	* Cancel the request from the caller's side. An aborted signal rejects
+	* with the signal's reason immediately and never retries; it is combined
+	* with the transport's own per-attempt timeout.
+	*/
+	signal?: AbortSignal
+	/**
+	* Override the transport's retry budget for this one request. Broadcasts
+	* pass `0`: re-sending a transaction the node may already hold trades a
+	* transient failure for a confusing nonce conflict.
+	*/
+	retryCount?: number
 };
 /** Shared configuration for all transport types. */
 type TransportConfig = {
 	url?: string
+	/**
+	* Per-attempt deadline in ms covering headers AND body. A stalled body
+	* rejects with `TimeoutError` instead of hanging. Default 30_000.
+	*/
 	timeout?: number
 	retryCount?: number
 	retryDelay?: number
 	fetchOptions?: RequestInit
+	/** Sent as `x-api-key`. Held in the request closure and stripped from
+	*  `Transport.config` so it never prints with the client. */
 	apiKey?: string
 };
 /** A resolved transport instance with a bound request function. */
@@ -420,6 +447,11 @@ type GetBlockParams = {
 	height?: number
 	hash?: string
 };
+/**
+* Fetch one block by hash or height, or the chain tip when both are omitted.
+* Every path resolves to a single block object: the tip read unwraps the
+* list envelope the extended API returns for `?limit=1`.
+*/
 declare function getBlock(client: Client, params?: GetBlockParams): Promise<any>;
 type GetRawBlockParams = {
 	height: number
@@ -510,6 +542,13 @@ type MulticallCall = {
 type MulticallParams<TAllowFailure extends boolean = true> = {
 	calls: readonly MulticallCall[]
 	allowFailure?: TAllowFailure
+	/**
+	* Reads in flight at once. Default 8. Each call is its own
+	* `/v2/contracts/call-read` request (Stacks nodes have no batch RPC), so
+	* an uncapped fan-out turns one multicall into a burst that trips rate
+	* limits and then retries in lockstep.
+	*/
+	concurrency?: number
 };
 type MulticallSuccessResult = {
 	status: "success"
@@ -522,15 +561,25 @@ type MulticallFailureResult = {
 type MulticallResult<T extends boolean> = T extends true ? (MulticallSuccessResult | MulticallFailureResult)[] : ClarityValue[];
 declare function multicall<TAllowFailure extends boolean = true>(client: Client, params: MulticallParams<TAllowFailure>): Promise<MulticallResult<TAllowFailure>>;
 declare class BaseError extends Error {
+	private;
 	name: string;
 	shortMessage: string;
 	details?: string;
 	constructor(shortMessage: string, options?: {
 		cause?: Error
 		details?: string
+		code?: string
 	});
+	/**
+	* Stable identifier for programmatic handling; survives message
+	* rewording and minification. An explicit `code` option wins, else it
+	* is derived from `name` (`TimeoutError` gives `TIMEOUT_ERROR`).
+	*/
+	get code(): string;
+	set code(value: string);
 	toJSON(): {
 		name: string
+		code: string
 		message: string
 		shortMessage: string
 		details: string | undefined
@@ -592,9 +641,9 @@ declare function simulateTransaction(client: Client, params: SimulateTransaction
 *
 *   - {@link extendedApiSource} — default; `/extended/v1/tx/{txid}` on the
 *     client's transport host (Hiro API or any extended-API-compatible host).
-*   - {@link indexTxSource} — Secondlayer's `/v1/index/transactions/{txid}`;
-*     returns the chain tip in the same response, so N-confirmation waits
-*     need no second request.
+*   - {@link indexTxSource}: a Secondlayer instance's
+*     `/v1/index/transactions/{txid}`; returns the chain tip in the same
+*     response, so N-confirmation waits need no second request.
 */
 type TransactionStatus = "pending" | "success" | "abort_by_response" | "abort_by_post_condition" | "dropped";
 type TransactionReceipt = {
@@ -621,8 +670,14 @@ type TransactionStatusSource = {
 		client: Client
 		txid: string
 	}): Promise<TransactionSnapshot>
+	/**
+	* True when the source only knows mined transactions and reports
+	* `receipt: null` for the whole mempool life of a tx. The wait action
+	* then stretches its dropped-grace window to the full timeout, since
+	* "unknown" cannot mean "dropped" until the deadline.
+	*/
+	canonicalOnly?: boolean
 };
-type FetchImpl = typeof globalThis.fetch;
 /**
 * Default source: `GET /extended/v1/tx/{txid}` via the client's transport.
 * Requires a host that serves Hiro's extended API (a bare stacks-node does
@@ -631,17 +686,25 @@ type FetchImpl = typeof globalThis.fetch;
 */
 declare function extendedApiSource(): TransactionStatusSource;
 type IndexTxSourceParams = {
-	/** Base URL of a Secondlayer-shaped index API. */
+	/**
+	* URL of your Secondlayer instance. Without it the client's transport
+	* URL is assumed to be the instance: a transport on a Hiro host throws
+	* up front, and a host that answers `/v1/index` with a non-JSON 404
+	* (a bare stacks-node) throws on the first read. Pass it whenever the
+	* transport is not the instance.
+	*/
 	baseUrl?: string
+	/** Instance token, sent as `Authorization: Bearer`. */
 	apiKey?: string
-	fetchImpl?: FetchImpl
 };
 /**
-* Source backed by Secondlayer's `/v1/index/transactions/{txid}`. The response
-* embeds the chain tip, so N-confirmation math needs no extra request. The
-* index only returns canonical (mined) transactions — while a tx is in the
-* mempool this source reports `receipt: null`, and the wait action's grace
-* window carries it until inclusion.
+* Source backed by a Secondlayer instance's `/v1/index/transactions/{txid}`.
+* The response embeds the chain tip, so N-confirmation math needs no extra
+* request. Requests go through the transport layer: same retries, timeout
+* and typed errors as every other read. The index only returns canonical
+* (mined) transactions; while a tx is in the mempool this source reports
+* `receipt: null`, and the wait action's grace window carries it until
+* inclusion.
 */
 declare function indexTxSource(params?: IndexTxSourceParams): TransactionStatusSource;
 type GetTransactionParams = {
@@ -691,8 +754,9 @@ type WaitForTransactionReceiptParams = {
 	pollingInterval?: number
 	/**
 	* How long a tx may be unknown to the source before it counts as dropped,
-	* ms. Covers broadcast propagation lag and canonical-only sources that
-	* can't see the mempool. Default 30_000.
+	* ms. Covers broadcast propagation lag. Default 30_000, or the full
+	* `timeout` for a canonical-only source (one that cannot see the
+	* mempool, so "unknown" means "not mined yet" until the deadline).
 	*/
 	droppedGracePeriod?: number
 	/** Where to read status from. Defaults to {@link extendedApiSource}. */
@@ -924,14 +988,35 @@ declare function isFeeTier(fee: FeeParam | undefined): fee is FeeTier;
 * stable regardless of the fee value later set on the spending condition.
 */
 declare function minimumFee(transaction: StacksTransaction): bigint;
+/** Outcome of {@link resolveFee}: the amount and which tier produced it. */
+type ResolvedFee = {
+	fee: bigint
+	/**
+	* Tier the amount came from. `'min'` when the estimator had no estimate
+	* and the relay floor was used instead. Absent when the caller passed an
+	* exact amount.
+	*/
+	tier?: FeeTier
+};
+/**
+* True when the node answered `POST /v2/fees/transaction` with 400
+* `NoEstimateAvailable`: it is healthy but has no fee history for this
+* payload (fresh devnet, quiet chain). Every other failure means the
+* estimate was never obtained and must surface to the caller.
+*/
+declare function isNoEstimateAvailable(error: unknown): boolean;
 /**
 * Resolve a fee param to a concrete amount. Numeric input passes through.
 * Tiers `'low' | 'mid' | 'high'` index the node's estimations (nearest
-* available when fewer than three are returned); `'min'` — and any estimation
-* failure (e.g. NoEstimateAvailable) — resolves to {@link minimumFee}, which
-* needs no network round-trip.
+* available when fewer than three are returned); `'min'` resolves to
+* {@link minimumFee}, which needs no network round-trip.
+*
+* The relay floor is the fallback ONLY when the node reports
+* `NoEstimateAvailable` or returns no estimations. A transport timeout, 5xx,
+* or auth failure rethrows: silently under-paying because the node was
+* unreachable would strand the transaction in the mempool.
 */
-declare function resolveFee(client: Client, transaction: StacksTransaction, fee: FeeParam | undefined): Promise<bigint>;
+declare function resolveFee(client: Client, transaction: StacksTransaction, fee: FeeParam | undefined): Promise<ResolvedFee>;
 type TransferStxParams = {
 	to: string
 	amount: IntegerType
@@ -1223,9 +1308,12 @@ type ContractCallOptions = {
 	postConditions?: PostConditionInput[]
 };
 /**
-* Options for `buildCall.*` — building an unsigned transaction for
+* Options for `buildCall.*`, building an unsigned transaction for
 * wallet-signs-later flows. `publicKey` defaults to the client account's
-* public key; `fee`/`nonce` are resolved from the network when omitted.
+* public key. When omitted, `nonce` is the confirmed on-chain nonce read
+* straight from the node (the client's nonce manager is never consumed for
+* a transaction that may never be sent) and `fee` is the mid estimate,
+* falling back to the relay floor only on `NoEstimateAvailable`.
 */
 type ContractBuildCallOptions = ContractCallOptions & {
 	publicKey?: string
@@ -1261,4 +1349,4 @@ declare class ContractResponseError extends Error {
 	name: string;
 	constructor(message: string, errorValue: unknown);
 }
-export { watchTransaction, watchNftEvent, watchMempool, watchBlocks, watchAddressBalance, watchAddress, waitForTransactionReceipt, transferStx, sponsorTransaction, simulateTransaction, simulateCall, signTransactionAction, signMessage2 as signMessage, sendTransaction, resolveFee, readContract, multicall, minimumFee, isResponseOutput, isProviderAccount, isFeeTier, indexTxSource, getTransaction, getRawBlock, getNonce, getNftHoldings, getMempoolStats, getMapEntry, getDataVar, getContractSource, getContractAbi, getContract, getBlockHeight, getBlock, getBalance, getAccountInfo, getAccountHistory, extendedApiSource, estimateFee, deployContract, callContract, buildFunctionArgs, WatchTransactionParams, WatchNftEventParams, WatchMempoolParams, WatchBlocksParams, WatchAddressParams, WatchAddressBalanceParams, WaitForTransactionReceiptParams, UnwrapResponse, TransferStxParams, TransactionStatusSource, TransactionStatus, TransactionSnapshot, TransactionReceipt, SponsorTransactionParams, SimulateTransferResult, SimulateTransactionResult, SimulateTransactionParams, SimulateDeployResult, SimulateContractCallResult, SimulateCallSuccess, SimulateCallResult, SimulateCallParams, SimulateCallFailure, SignTransactionParams, SignMessageParams, SendTransactionResult, SendTransactionParams, ReadContractParams, RawBlockResponse, NftHoldingsResponse, MulticallSuccessResult, MulticallResult, MulticallParams, MulticallFailureResult, MulticallCall, IndexTxSourceParams, GetTransactionParams, GetRawBlockParams, GetNonceParams, GetNftHoldingsParams, GetMapEntryParams, GetDataVarParams, GetContractSourceParams, GetContractParams, GetContractAbiParams, GetBlockParams, GetBalanceParams, GetAccountInfoParams, GetAccountHistoryParams, FeeTier, FeeParam, FeeEstimation, EstimateFeeParams, DeployContractParams, ContractSourceResponse, ContractResponseError, ContractInstance, ContractCallOptions, ContractBuildCallOptions, CallContractParams, AccountInfo, AccountHistoryResponse };
+export { watchTransaction, watchNftEvent, watchMempool, watchBlocks, watchAddressBalance, watchAddress, waitForTransactionReceipt, transferStx, sponsorTransaction, simulateTransaction, simulateCall, signTransactionAction, signMessage2 as signMessage, sendTransaction, resolveFee, readContract, multicall, minimumFee, isResponseOutput, isProviderAccount, isNoEstimateAvailable, isFeeTier, indexTxSource, getTransaction, getRawBlock, getNonce, getNftHoldings, getMempoolStats, getMapEntry, getDataVar, getContractSource, getContractAbi, getContract, getBlockHeight, getBlock, getBalance, getAccountInfo, getAccountHistory, extendedApiSource, estimateFee, deployContract, callContract, buildFunctionArgs, WatchTransactionParams, WatchNftEventParams, WatchMempoolParams, WatchBlocksParams, WatchAddressParams, WatchAddressBalanceParams, WaitForTransactionReceiptParams, UnwrapResponse, TransferStxParams, TransactionStatusSource, TransactionStatus, TransactionSnapshot, TransactionReceipt, SponsorTransactionParams, SimulateTransferResult, SimulateTransactionResult, SimulateTransactionParams, SimulateDeployResult, SimulateContractCallResult, SimulateCallSuccess, SimulateCallResult, SimulateCallParams, SimulateCallFailure, SignTransactionParams, SignMessageParams, SendTransactionResult, SendTransactionParams, ResolvedFee, ReadContractParams, RawBlockResponse, NftHoldingsResponse, MulticallSuccessResult, MulticallResult, MulticallParams, MulticallFailureResult, MulticallCall, IndexTxSourceParams, GetTransactionParams, GetRawBlockParams, GetNonceParams, GetNftHoldingsParams, GetMapEntryParams, GetDataVarParams, GetContractSourceParams, GetContractParams, GetContractAbiParams, GetBlockParams, GetBalanceParams, GetAccountInfoParams, GetAccountHistoryParams, FeeTier, FeeParam, FeeEstimation, EstimateFeeParams, DeployContractParams, ContractSourceResponse, ContractResponseError, ContractInstance, ContractCallOptions, ContractBuildCallOptions, CallContractParams, AccountInfo, AccountHistoryResponse };

package/dist/src/actions/index.js

@@ -3,7 +3,7 @@ import {
   buildFunctionArgs,
   getContract,
   isResponseOutput
-} from "../../shared/stacks-jpt52csy.js";
+} from "../../shared/stacks-e3nwm1dz.js";
 import {
   deployContract,
   getAccountHistory,
@@ -14,19 +14,18 @@ import {
   getMempoolStats,
   getNftHoldings,
   getRawBlock,
-  getTransaction,
   signMessage,
   signTransactionAction,
   simulateCall,
   simulateTransaction,
   sponsorTransaction,
   transferStx
-} from "../../shared/stacks-7wkf2rph.js";
+} from "../../shared/stacks-7bqkf3b0.js";
 import {
   getBalance,
   getDataVar,
   multicall
-} from "../../shared/stacks-8pfdscq6.js";
+} from "../../shared/stacks-6gavarmy.js";
 import {
   callContract,
   estimateFee,
@@ -34,17 +33,19 @@ import {
   getBlockHeight,
   getMapEntry,
   getNonce,
+  getTransaction,
   indexTxSource,
   isFeeTier,
+  isNoEstimateAvailable,
   isProviderAccount,
   minimumFee,
   resolveFee,
   sendTransaction,
   waitForTransactionReceipt
-} from "../../shared/stacks-fb75yew8.js";
+} from "../../shared/stacks-n4d8j8q3.js";
 import {
   readContract
-} from "../../shared/stacks-27fmgajb.js";
+} from "../../shared/stacks-ga026yxz.js";
 import {
   watchAddress,
   watchAddressBalance,
@@ -52,14 +53,14 @@ import {
   watchMempool,
   watchNftEvent,
   watchTransaction
-} from "../../shared/stacks-tjjnkt3r.js";
-import"../../shared/stacks-709tra19.js";
-import"../../shared/stacks-4z72akdf.js";
-import"../../shared/stacks-1arrcd11.js";
-import"../../shared/stacks-hnqt5rz4.js";
-import"../../shared/stacks-w23294am.js";
-import"../../shared/stacks-ttdk2g2f.js";
-import"../../shared/stacks-bfan7ex7.js";
+} from "../../shared/stacks-wxfd6r4b.js";
+import"../../shared/stacks-x0qqwrev.js";
+import"../../shared/stacks-v2rfr46a.js";
+import"../../shared/stacks-9c1yam8b.js";
+import"../../shared/stacks-51ybf135.js";
+import"../../shared/stacks-69nq48jp.js";
+import"../../shared/stacks-4hs8r4q2.js";
+import"../../shared/stacks-4d7c3x27.js";
 import"../../shared/stacks-qs5fzts5.js";
 export {
   watchTransaction,
@@ -82,6 +83,7 @@ export {
   minimumFee,
   isResponseOutput,
   isProviderAccount,
+  isNoEstimateAvailable,
   isFeeTier,
   indexTxSource,
   getTransaction,
@@ -107,5 +109,5 @@ export {
   ContractResponseError
 };
 
-//# debugId=30258F7ACEFDEE5C64756E2164756E21
+//# debugId=79C026A02850368C64756E2164756E21
 //# sourceMappingURL=index.js.map

package/dist/src/actions/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "30258F7ACEFDEE5C64756E2164756E21",
+  "debugId": "79C026A02850368C64756E2164756E21",
   "names": []
 }

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

@@ -524,6 +524,15 @@ type NonceManager = {
 		client: Client
 		address: string
 	}): void | Promise<void>
+	/**
+	* Give back a nonce from {@link NonceManager.consume} whose transaction
+	* was never accepted by the node. No-op unless it is the latest issued.
+	*/
+	release(params: {
+		client: Client
+		address: string
+		nonce: bigint
+	}): void | Promise<void>
 	/** Next nonce that {@link NonceManager.consume} would return without consuming it, or `undefined` if untracked. */
 	peek(params: {
 		client: Client
@@ -579,14 +588,32 @@ type RequestOptions = {
 	method?: "GET" | "POST" | "PUT" | "DELETE"
 	body?: unknown
 	headers?: Record<string, string>
+	/**
+	* Cancel the request from the caller's side. An aborted signal rejects
+	* with the signal's reason immediately and never retries; it is combined
+	* with the transport's own per-attempt timeout.
+	*/
+	signal?: AbortSignal
+	/**
+	* Override the transport's retry budget for this one request. Broadcasts
+	* pass `0`: re-sending a transaction the node may already hold trades a
+	* transient failure for a confusing nonce conflict.
+	*/
+	retryCount?: number
 };
 /** Shared configuration for all transport types. */
 type TransportConfig = {
 	url?: string
+	/**
+	* Per-attempt deadline in ms covering headers AND body. A stalled body
+	* rejects with `TimeoutError` instead of hanging. Default 30_000.
+	*/
 	timeout?: number
 	retryCount?: number
 	retryDelay?: number
 	fetchOptions?: RequestInit
+	/** Sent as `x-api-key`. Held in the request closure and stripped from
+	*  `Transport.config` so it never prints with the client. */
 	apiKey?: string
 };
 /** A resolved transport instance with a bound request function. */