@secondlayer/stacks 2.10.0 → 2.12.0

package/dist/src/index.d.cts

@@ -581,6 +581,78 @@ type GetMapEntryParams = {
 type GetNonceParams = {
 	address: string
 };
+/**
+* Pluggable transaction-status sources for {@link getTransaction} /
+* `waitForTransactionReceipt`.
+*
+* A bare stacks-node has no confirmed-transaction endpoint, so status reads
+* need a host that indexes transactions. Where that data comes from is
+* pluggable, mirroring the nonce sources:
+*
+*   - {@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.
+*/
+type TransactionStatus = "pending" | "success" | "abort_by_response" | "abort_by_post_condition" | "dropped";
+type TransactionReceipt = {
+	txid: string
+	status: TransactionStatus
+	/** Anchor block height; absent while pending. */
+	blockHeight?: number
+	blockHash?: string
+	/** Decoded Clarity result; absent while pending or when the source omits it. */
+	result?: ClarityValue
+	resultHex?: string
+	events: unknown[]
+	/** The source's unnormalized response, for fields the receipt doesn't model. */
+	raw: unknown
+};
+type TransactionSnapshot = {
+	/** `null` when the source has no record of the tx (mempool + chain). */
+	receipt: TransactionReceipt | null
+	/** Chain tip height, when the source knows it (saves a round-trip). */
+	tip?: number
+};
+type TransactionStatusSource = {
+	get(args: {
+		client: Client
+		txid: string
+	}): Promise<TransactionSnapshot>
+};
+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
+* not). Does not report the chain tip — the wait action fetches it separately
+* when `confirmations > 1`.
+*/
+declare function extendedApiSource(): TransactionStatusSource;
+type IndexTxSourceParams = {
+	/** Base URL of a Secondlayer-shaped index API. */
+	baseUrl?: string
+	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.
+*/
+declare function indexTxSource(params?: IndexTxSourceParams): TransactionStatusSource;
+type GetTransactionParams = {
+	txid: string
+	/** Where to read status from. Defaults to {@link extendedApiSource}. */
+	source?: TransactionStatusSource
+};
+/**
+* Fetch a transaction's receipt (status, block info, decoded result).
+* Returns `null` when the source has no record of the transaction.
+*/
+declare function getTransaction2(client: Client, params: GetTransactionParams): Promise<TransactionReceipt | null>;
 type MulticallCall = {
 	contract: string
 	functionName: string
@@ -665,6 +737,37 @@ type SimulateDeployResult = {
 	fees: FeeEstimation[]
 };
 type SimulateTransactionResult = SimulateContractCallResult | SimulateTransferResult | SimulateDeployResult;
+type WaitForTransactionReceiptParams = {
+	txid: string
+	/** Anchor-block confirmations to wait for. Default 1 (mined). */
+	confirmations?: number
+	/** Give up after this many ms. Default 180_000 (3 min). */
+	timeout?: number
+	/** Delay between status polls, ms. Default 3_000. */
+	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.
+	*/
+	droppedGracePeriod?: number
+	/** Where to read status from. Defaults to {@link extendedApiSource}. */
+	source?: TransactionStatusSource
+};
+/**
+* Poll until a transaction is mined with N confirmations, then return its
+* receipt.
+*
+* Rejects with {@link TransactionAbortedError} when the tx mines but aborts
+* (`abort_by_response` / `abort_by_post_condition`) — the receipt is attached.
+* Rejects with {@link TransactionDroppedError} when the tx leaves the mempool
+* unmined or stays unknown past `droppedGracePeriod`, and
+* {@link WaitForTransactionTimeoutError} at `timeout`.
+*
+* Reorg-tolerant: every cycle re-reads the receipt (block height may change)
+* and recomputes confirmations from the current tip.
+*/
+declare function waitForTransactionReceipt2(client: Client, params: WaitForTransactionReceiptParams): Promise<TransactionReceipt>;
 /** Handle returned by WebSocket subscription methods; call `unsubscribe()` to stop. */
 type Subscription = {
 	unsubscribe: () => void
@@ -814,6 +917,8 @@ type PublicActions = {
 	multicall: <T extends boolean = true>(params: MulticallParams<T>) => Promise<MulticallResult<T>>
 	simulateCall: (params: SimulateCallParams) => Promise<SimulateCallResult>
 	simulateTransaction: (params: SimulateTransactionParams) => Promise<SimulateTransactionResult>
+	getTransaction: (params: GetTransactionParams) => Promise<TransactionReceipt | null>
+	waitForTransactionReceipt: (params: WaitForTransactionReceiptParams) => Promise<TransactionReceipt>
 	watchBlocks: (params: WatchBlocksParams) => Promise<Subscription>
 	watchMempool: (params: WatchMempoolParams) => Promise<Subscription>
 	watchTransaction: (params: WatchTransactionParams) => Promise<Subscription>
@@ -866,11 +971,19 @@ type PoxPostCondition = {
 };
 type PostCondition = StxPostCondition | FtPostCondition | NftPostCondition | StakingPostCondition | PoxPostCondition;
 type IntegerType = number | string | bigint | Uint8Array;
+/**
+* Named fee tiers. `'low' | 'mid' | 'high'` map to the node's three fee
+* estimations; `'min'` is the node's minimum relay fee — 1 uSTX per byte of
+* the serialized transaction, computable offline.
+*/
+type FeeTier = "min" | "low" | "mid" | "high";
+/** Fee input accepted by wallet actions: an explicit amount or a named tier. */
+type FeeParam = IntegerType | FeeTier;
 type CallContractParams = {
 	contract: string
 	functionName: string
 	functionArgs?: ClarityValue[]
-	fee?: IntegerType
+	fee?: FeeParam
 	nonce?: IntegerType
 	postConditionMode?: "allow" | "deny"
 	postConditions?: PostCondition[]
@@ -879,7 +992,7 @@ type DeployContractParams = {
 	contractName: string
 	codeBody: string
 	clarityVersion?: ClarityVersion
-	fee?: IntegerType
+	fee?: FeeParam
 	nonce?: IntegerType
 	postConditionMode?: "allow" | "deny"
 	postConditions?: PostCondition[]
@@ -887,9 +1000,17 @@ type DeployContractParams = {
 type SendTransactionParams = {
 	transaction: StacksTransaction
 	attachment?: Uint8Array | string
+	/**
+	* Wait for the transaction to be mined before returning. `true` waits for
+	* 1 confirmation; a number waits for that many. The receipt lands on the
+	* result. Rejects if the tx aborts, is dropped, or the wait times out.
+	*/
+	wait?: boolean | number
 };
 type SendTransactionResult = {
 	txid: string
+	/** Present when `wait` was requested. */
+	receipt?: TransactionReceipt
 };
 type SignMessageParams = {
 	message: string | ClarityValue
@@ -906,14 +1027,14 @@ type SignTransactionParams = {
 };
 type SponsorTransactionParams = {
 	transaction: StacksTransaction
-	fee?: IntegerType
+	fee?: FeeParam
 	nonce?: IntegerType
 };
 type TransferStxParams = {
 	to: string
 	amount: IntegerType
 	memo?: string
-	fee?: IntegerType
+	fee?: FeeParam
 	nonce?: IntegerType
 	postConditionMode?: "allow" | "deny"
 	postConditions?: PostCondition[]
@@ -1052,7 +1173,7 @@ declare function postgresStore(params: PostgresStoreParams): NonceStore;
 *   - {@link indexSource} — prebuilt over Secondlayer's `/v1/index/mempool`.
 *   - {@link hiroNonceSource} — prebuilt over Hiro's `/extended` nonces endpoint.
 */
-type FetchImpl = typeof globalThis.fetch;
+type FetchImpl2 = typeof globalThis.fetch;
 /**
 * The next free nonce ≥ `confirmed` not already taken by a pending tx.
 *
@@ -1088,7 +1209,7 @@ type IndexSourceParams = {
 	baseUrl?: string
 	/** Optional API key (keyless by default; supply to raise rate limits). */
 	apiKey?: string
-	fetchImpl?: FetchImpl
+	fetchImpl?: FetchImpl2
 	/** Max mempool pages to page through per address. Default 10 (×200 = 2000 txs). */
 	maxPages?: number
 	/** Override the confirmed floor (defaults to the node read). */
@@ -1108,7 +1229,7 @@ type HiroNonceSourceParams = {
 	/** Hiro API base URL, e.g. `https://api.hiro.so` or `https://api.testnet.hiro.so`. */
 	baseUrl: string
 	apiKey?: string
-	fetchImpl?: FetchImpl
+	fetchImpl?: FetchImpl2
 };
 /**
 * Off-the-shelf, non-Secondlayer mempool-aware source over Hiro's
@@ -1350,14 +1471,51 @@ declare function getContractAddress(deployer: string, contractName: string): str
 declare class TransactionError extends BaseError {
 	name: string;
 }
+/**
+* Rejection reasons a stacks-node returns from `POST /v2/transactions`.
+* Wire strings from stacks-core `MemPoolRejection::into_json`
+* (`stackslib/src/chainstate/stacks/db/blocks.rs`).
+*/
+type TxRejectionReason = "Serialization" | "Deserialization" | "SignatureValidation" | "BadNonce" | "ConflictingNonceInMempool" | "TooMuchChaining" | "FeeTooLow" | "NotEnoughFunds" | "NoSuchContract" | "NoSuchPublicFunction" | "BadFunctionArgument" | "ContractAlreadyExists" | "BadTransactionVersion" | "TransferRecipientCannotEqualSender" | "TransferAmountMustBePositive" | "PoisonMicroblocksDoNotConflict" | "PoisonMicroblockHasUnknownPubKeyHash" | "PoisonMicroblockIsInvalid" | "BadAddressVersionByte" | "NoCoinbaseViaMempool" | "NoTenureChangeViaMempool" | "EstimatorError" | "TemporarilyBlacklisted" | "ServerFailureNoSuchChainTip" | "ServerFailureDatabase" | "ServerFailureOther";
 declare class BroadcastError extends BaseError {
 	name: string;
 	txid?: string;
-	reason?: string;
+	reason?: TxRejectionReason | (string & {});
+	/** Node-provided detail; shape varies per reason (see stacks-core RPC docs). */
+	reasonData?: unknown;
 	constructor(message: string, options?: {
 		cause?: Error
 		txid?: string
 		reason?: string
+		reasonData?: unknown
+	});
+}
+/** The transaction was mined but its execution aborted (runtime error or failed post-condition). */
+declare class TransactionAbortedError extends BaseError {
+	name: string;
+	/** The abort receipt (status, block info, raw source response). */
+	receipt: unknown;
+	constructor(message: string, options: {
+		receipt: unknown
+		cause?: Error
+	});
+}
+/** The transaction left the mempool without being mined (dropped/replaced). */
+declare class TransactionDroppedError extends BaseError {
+	name: string;
+	txid: string;
+	constructor(message: string, options: {
+		txid: string
+		cause?: Error
+	});
+}
+/** waitForTransactionReceipt gave up before the tx reached the requested state. */
+declare class WaitForTransactionTimeoutError extends BaseError {
+	name: string;
+	txid: string;
+	constructor(message: string, options: {
+		txid: string
+		cause?: Error
 	});
 }
 declare class SerializationError extends BaseError {
@@ -1375,4 +1533,4 @@ declare class ReadOnlyCallError extends BaseError {
 declare class WebSocketError extends BaseError {
 	name: string;
 }
-export { webSocket, walletActions, testnet, startNonceReconciler, resolveNonce, redisStore, reconcileNonce, publicActions, providerToAccount, postgresStore, parseStx, exports_on as on, nextFreeNonce, multisigActions, mocknet, mempoolAwareSource, memoryStore, mainnet, jsonRpcSource, isValidAddress, isNonceConflictError, isAddressEqual, indexSource, http, hiroNonceSource, getContractAddress, formatStx, fallback, devnet, defineChain, custom, createWalletClient, createPublicClient, createNonceManager, createMultiSigClient, createClient, broadcastWithNonceReset, ZERO_ADDRESS, WebSocketTransportConfig, WebSocketTransport, WebSocketError, WalletClientConfig, WalletClient, WalletActions, TransportFactory, TransportConfig, Transport, TransactionError, TESTNET_ZERO_ADDRESS, SubscriptionFilterSpec, Subscription, StartNonceReconcilerParams, StacksProvider, StacksChain, SqlLike, SimulationError, SigningError, SerializationError, RequestOptions, RequestFn, RedisStoreParams, RedisLike, ReconcileNonceResult, ReconcileNonceParams, ReadOnlyCallError, PublicClientConfig, PublicClient, PublicActions, ProviderAccount, PoxFunction, PostgresStoreParams, NonceStore, NonceManagerSource, NonceManager, MultiSigClientConfig, MultiSigClient, MultiSigActions, MempoolAwareSourceParams, MICROSTX_PER_STX, LocalAccount, IndexSourceParams, HiroNonceSourceParams, FilterPrimitive, FilterOperator, FilterClause, Filter, FactoryTarget, CustomAccount, CreateNonceManagerParams, ContractCallError, ClientConfig, Client, BroadcastError, BnsAction, BaseError, AddressVersion, Account };
+export { webSocket, walletActions, waitForTransactionReceipt2 as waitForTransactionReceipt, testnet, startNonceReconciler, resolveNonce, redisStore, reconcileNonce, publicActions, providerToAccount, postgresStore, parseStx, exports_on as on, nextFreeNonce, multisigActions, mocknet, mempoolAwareSource, memoryStore, mainnet, jsonRpcSource, isValidAddress, isNonceConflictError, isAddressEqual, indexTxSource, indexSource, http, hiroNonceSource, getTransaction2 as getTransaction, getContractAddress, formatStx, fallback, extendedApiSource, devnet, defineChain, custom, createWalletClient, createPublicClient, createNonceManager, createMultiSigClient, createClient, broadcastWithNonceReset, ZERO_ADDRESS, WebSocketTransportConfig, WebSocketTransport, WebSocketError, WalletClientConfig, WalletClient, WalletActions, WaitForTransactionTimeoutError, WaitForTransactionReceiptParams, TxRejectionReason, TransportFactory, TransportConfig, Transport, TransactionStatusSource, TransactionStatus, TransactionSnapshot, TransactionReceipt, TransactionError, TransactionDroppedError, TransactionAbortedError, TESTNET_ZERO_ADDRESS, SubscriptionFilterSpec, Subscription, StartNonceReconcilerParams, StacksProvider, StacksChain, SqlLike, SimulationError, SigningError, SerializationError, RequestOptions, RequestFn, RedisStoreParams, RedisLike, ReconcileNonceResult, ReconcileNonceParams, ReadOnlyCallError, PublicClientConfig, PublicClient, PublicActions, ProviderAccount, PoxFunction, PostgresStoreParams, NonceStore, NonceManagerSource, NonceManager, MultiSigClientConfig, MultiSigClient, MultiSigActions, MempoolAwareSourceParams, MICROSTX_PER_STX, LocalAccount, IndexTxSourceParams, IndexSourceParams, HiroNonceSourceParams, GetTransactionParams, FilterPrimitive, FilterOperator, FilterClause, Filter, FactoryTarget, CustomAccount, CreateNonceManagerParams, ContractCallError, ClientConfig, Client, BroadcastError, BnsAction, BaseError, AddressVersion, Account };

package/dist/src/index.d.ts

@@ -581,6 +581,78 @@ type GetMapEntryParams = {
 type GetNonceParams = {
 	address: string
 };
+/**
+* Pluggable transaction-status sources for {@link getTransaction} /
+* `waitForTransactionReceipt`.
+*
+* A bare stacks-node has no confirmed-transaction endpoint, so status reads
+* need a host that indexes transactions. Where that data comes from is
+* pluggable, mirroring the nonce sources:
+*
+*   - {@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.
+*/
+type TransactionStatus = "pending" | "success" | "abort_by_response" | "abort_by_post_condition" | "dropped";
+type TransactionReceipt = {
+	txid: string
+	status: TransactionStatus
+	/** Anchor block height; absent while pending. */
+	blockHeight?: number
+	blockHash?: string
+	/** Decoded Clarity result; absent while pending or when the source omits it. */
+	result?: ClarityValue
+	resultHex?: string
+	events: unknown[]
+	/** The source's unnormalized response, for fields the receipt doesn't model. */
+	raw: unknown
+};
+type TransactionSnapshot = {
+	/** `null` when the source has no record of the tx (mempool + chain). */
+	receipt: TransactionReceipt | null
+	/** Chain tip height, when the source knows it (saves a round-trip). */
+	tip?: number
+};
+type TransactionStatusSource = {
+	get(args: {
+		client: Client
+		txid: string
+	}): Promise<TransactionSnapshot>
+};
+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
+* not). Does not report the chain tip — the wait action fetches it separately
+* when `confirmations > 1`.
+*/
+declare function extendedApiSource(): TransactionStatusSource;
+type IndexTxSourceParams = {
+	/** Base URL of a Secondlayer-shaped index API. */
+	baseUrl?: string
+	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.
+*/
+declare function indexTxSource(params?: IndexTxSourceParams): TransactionStatusSource;
+type GetTransactionParams = {
+	txid: string
+	/** Where to read status from. Defaults to {@link extendedApiSource}. */
+	source?: TransactionStatusSource
+};
+/**
+* Fetch a transaction's receipt (status, block info, decoded result).
+* Returns `null` when the source has no record of the transaction.
+*/
+declare function getTransaction2(client: Client, params: GetTransactionParams): Promise<TransactionReceipt | null>;
 type MulticallCall = {
 	contract: string
 	functionName: string
@@ -665,6 +737,37 @@ type SimulateDeployResult = {
 	fees: FeeEstimation[]
 };
 type SimulateTransactionResult = SimulateContractCallResult | SimulateTransferResult | SimulateDeployResult;
+type WaitForTransactionReceiptParams = {
+	txid: string
+	/** Anchor-block confirmations to wait for. Default 1 (mined). */
+	confirmations?: number
+	/** Give up after this many ms. Default 180_000 (3 min). */
+	timeout?: number
+	/** Delay between status polls, ms. Default 3_000. */
+	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.
+	*/
+	droppedGracePeriod?: number
+	/** Where to read status from. Defaults to {@link extendedApiSource}. */
+	source?: TransactionStatusSource
+};
+/**
+* Poll until a transaction is mined with N confirmations, then return its
+* receipt.
+*
+* Rejects with {@link TransactionAbortedError} when the tx mines but aborts
+* (`abort_by_response` / `abort_by_post_condition`) — the receipt is attached.
+* Rejects with {@link TransactionDroppedError} when the tx leaves the mempool
+* unmined or stays unknown past `droppedGracePeriod`, and
+* {@link WaitForTransactionTimeoutError} at `timeout`.
+*
+* Reorg-tolerant: every cycle re-reads the receipt (block height may change)
+* and recomputes confirmations from the current tip.
+*/
+declare function waitForTransactionReceipt2(client: Client, params: WaitForTransactionReceiptParams): Promise<TransactionReceipt>;
 /** Handle returned by WebSocket subscription methods; call `unsubscribe()` to stop. */
 type Subscription = {
 	unsubscribe: () => void
@@ -814,6 +917,8 @@ type PublicActions = {
 	multicall: <T extends boolean = true>(params: MulticallParams<T>) => Promise<MulticallResult<T>>
 	simulateCall: (params: SimulateCallParams) => Promise<SimulateCallResult>
 	simulateTransaction: (params: SimulateTransactionParams) => Promise<SimulateTransactionResult>
+	getTransaction: (params: GetTransactionParams) => Promise<TransactionReceipt | null>
+	waitForTransactionReceipt: (params: WaitForTransactionReceiptParams) => Promise<TransactionReceipt>
 	watchBlocks: (params: WatchBlocksParams) => Promise<Subscription>
 	watchMempool: (params: WatchMempoolParams) => Promise<Subscription>
 	watchTransaction: (params: WatchTransactionParams) => Promise<Subscription>
@@ -866,11 +971,19 @@ type PoxPostCondition = {
 };
 type PostCondition = StxPostCondition | FtPostCondition | NftPostCondition | StakingPostCondition | PoxPostCondition;
 type IntegerType = number | string | bigint | Uint8Array;
+/**
+* Named fee tiers. `'low' | 'mid' | 'high'` map to the node's three fee
+* estimations; `'min'` is the node's minimum relay fee — 1 uSTX per byte of
+* the serialized transaction, computable offline.
+*/
+type FeeTier = "min" | "low" | "mid" | "high";
+/** Fee input accepted by wallet actions: an explicit amount or a named tier. */
+type FeeParam = IntegerType | FeeTier;
 type CallContractParams = {
 	contract: string
 	functionName: string
 	functionArgs?: ClarityValue[]
-	fee?: IntegerType
+	fee?: FeeParam
 	nonce?: IntegerType
 	postConditionMode?: "allow" | "deny"
 	postConditions?: PostCondition[]
@@ -879,7 +992,7 @@ type DeployContractParams = {
 	contractName: string
 	codeBody: string
 	clarityVersion?: ClarityVersion
-	fee?: IntegerType
+	fee?: FeeParam
 	nonce?: IntegerType
 	postConditionMode?: "allow" | "deny"
 	postConditions?: PostCondition[]
@@ -887,9 +1000,17 @@ type DeployContractParams = {
 type SendTransactionParams = {
 	transaction: StacksTransaction
 	attachment?: Uint8Array | string
+	/**
+	* Wait for the transaction to be mined before returning. `true` waits for
+	* 1 confirmation; a number waits for that many. The receipt lands on the
+	* result. Rejects if the tx aborts, is dropped, or the wait times out.
+	*/
+	wait?: boolean | number
 };
 type SendTransactionResult = {
 	txid: string
+	/** Present when `wait` was requested. */
+	receipt?: TransactionReceipt
 };
 type SignMessageParams = {
 	message: string | ClarityValue
@@ -906,14 +1027,14 @@ type SignTransactionParams = {
 };
 type SponsorTransactionParams = {
 	transaction: StacksTransaction
-	fee?: IntegerType
+	fee?: FeeParam
 	nonce?: IntegerType
 };
 type TransferStxParams = {
 	to: string
 	amount: IntegerType
 	memo?: string
-	fee?: IntegerType
+	fee?: FeeParam
 	nonce?: IntegerType
 	postConditionMode?: "allow" | "deny"
 	postConditions?: PostCondition[]
@@ -1052,7 +1173,7 @@ declare function postgresStore(params: PostgresStoreParams): NonceStore;
 *   - {@link indexSource} — prebuilt over Secondlayer's `/v1/index/mempool`.
 *   - {@link hiroNonceSource} — prebuilt over Hiro's `/extended` nonces endpoint.
 */
-type FetchImpl = typeof globalThis.fetch;
+type FetchImpl2 = typeof globalThis.fetch;
 /**
 * The next free nonce ≥ `confirmed` not already taken by a pending tx.
 *
@@ -1088,7 +1209,7 @@ type IndexSourceParams = {
 	baseUrl?: string
 	/** Optional API key (keyless by default; supply to raise rate limits). */
 	apiKey?: string
-	fetchImpl?: FetchImpl
+	fetchImpl?: FetchImpl2
 	/** Max mempool pages to page through per address. Default 10 (×200 = 2000 txs). */
 	maxPages?: number
 	/** Override the confirmed floor (defaults to the node read). */
@@ -1108,7 +1229,7 @@ type HiroNonceSourceParams = {
 	/** Hiro API base URL, e.g. `https://api.hiro.so` or `https://api.testnet.hiro.so`. */
 	baseUrl: string
 	apiKey?: string
-	fetchImpl?: FetchImpl
+	fetchImpl?: FetchImpl2
 };
 /**
 * Off-the-shelf, non-Secondlayer mempool-aware source over Hiro's
@@ -1350,14 +1471,51 @@ declare function getContractAddress(deployer: string, contractName: string): str
 declare class TransactionError extends BaseError {
 	name: string;
 }
+/**
+* Rejection reasons a stacks-node returns from `POST /v2/transactions`.
+* Wire strings from stacks-core `MemPoolRejection::into_json`
+* (`stackslib/src/chainstate/stacks/db/blocks.rs`).
+*/
+type TxRejectionReason = "Serialization" | "Deserialization" | "SignatureValidation" | "BadNonce" | "ConflictingNonceInMempool" | "TooMuchChaining" | "FeeTooLow" | "NotEnoughFunds" | "NoSuchContract" | "NoSuchPublicFunction" | "BadFunctionArgument" | "ContractAlreadyExists" | "BadTransactionVersion" | "TransferRecipientCannotEqualSender" | "TransferAmountMustBePositive" | "PoisonMicroblocksDoNotConflict" | "PoisonMicroblockHasUnknownPubKeyHash" | "PoisonMicroblockIsInvalid" | "BadAddressVersionByte" | "NoCoinbaseViaMempool" | "NoTenureChangeViaMempool" | "EstimatorError" | "TemporarilyBlacklisted" | "ServerFailureNoSuchChainTip" | "ServerFailureDatabase" | "ServerFailureOther";
 declare class BroadcastError extends BaseError {
 	name: string;
 	txid?: string;
-	reason?: string;
+	reason?: TxRejectionReason | (string & {});
+	/** Node-provided detail; shape varies per reason (see stacks-core RPC docs). */
+	reasonData?: unknown;
 	constructor(message: string, options?: {
 		cause?: Error
 		txid?: string
 		reason?: string
+		reasonData?: unknown
+	});
+}
+/** The transaction was mined but its execution aborted (runtime error or failed post-condition). */
+declare class TransactionAbortedError extends BaseError {
+	name: string;
+	/** The abort receipt (status, block info, raw source response). */
+	receipt: unknown;
+	constructor(message: string, options: {
+		receipt: unknown
+		cause?: Error
+	});
+}
+/** The transaction left the mempool without being mined (dropped/replaced). */
+declare class TransactionDroppedError extends BaseError {
+	name: string;
+	txid: string;
+	constructor(message: string, options: {
+		txid: string
+		cause?: Error
+	});
+}
+/** waitForTransactionReceipt gave up before the tx reached the requested state. */
+declare class WaitForTransactionTimeoutError extends BaseError {
+	name: string;
+	txid: string;
+	constructor(message: string, options: {
+		txid: string
+		cause?: Error
 	});
 }
 declare class SerializationError extends BaseError {
@@ -1375,4 +1533,4 @@ declare class ReadOnlyCallError extends BaseError {
 declare class WebSocketError extends BaseError {
 	name: string;
 }
-export { webSocket, walletActions, testnet, startNonceReconciler, resolveNonce, redisStore, reconcileNonce, publicActions, providerToAccount, postgresStore, parseStx, exports_on as on, nextFreeNonce, multisigActions, mocknet, mempoolAwareSource, memoryStore, mainnet, jsonRpcSource, isValidAddress, isNonceConflictError, isAddressEqual, indexSource, http, hiroNonceSource, getContractAddress, formatStx, fallback, devnet, defineChain, custom, createWalletClient, createPublicClient, createNonceManager, createMultiSigClient, createClient, broadcastWithNonceReset, ZERO_ADDRESS, WebSocketTransportConfig, WebSocketTransport, WebSocketError, WalletClientConfig, WalletClient, WalletActions, TransportFactory, TransportConfig, Transport, TransactionError, TESTNET_ZERO_ADDRESS, SubscriptionFilterSpec, Subscription, StartNonceReconcilerParams, StacksProvider, StacksChain, SqlLike, SimulationError, SigningError, SerializationError, RequestOptions, RequestFn, RedisStoreParams, RedisLike, ReconcileNonceResult, ReconcileNonceParams, ReadOnlyCallError, PublicClientConfig, PublicClient, PublicActions, ProviderAccount, PoxFunction, PostgresStoreParams, NonceStore, NonceManagerSource, NonceManager, MultiSigClientConfig, MultiSigClient, MultiSigActions, MempoolAwareSourceParams, MICROSTX_PER_STX, LocalAccount, IndexSourceParams, HiroNonceSourceParams, FilterPrimitive, FilterOperator, FilterClause, Filter, FactoryTarget, CustomAccount, CreateNonceManagerParams, ContractCallError, ClientConfig, Client, BroadcastError, BnsAction, BaseError, AddressVersion, Account };
+export { webSocket, walletActions, waitForTransactionReceipt2 as waitForTransactionReceipt, testnet, startNonceReconciler, resolveNonce, redisStore, reconcileNonce, publicActions, providerToAccount, postgresStore, parseStx, exports_on as on, nextFreeNonce, multisigActions, mocknet, mempoolAwareSource, memoryStore, mainnet, jsonRpcSource, isValidAddress, isNonceConflictError, isAddressEqual, indexTxSource, indexSource, http, hiroNonceSource, getTransaction2 as getTransaction, getContractAddress, formatStx, fallback, extendedApiSource, devnet, defineChain, custom, createWalletClient, createPublicClient, createNonceManager, createMultiSigClient, createClient, broadcastWithNonceReset, ZERO_ADDRESS, WebSocketTransportConfig, WebSocketTransport, WebSocketError, WalletClientConfig, WalletClient, WalletActions, WaitForTransactionTimeoutError, WaitForTransactionReceiptParams, TxRejectionReason, TransportFactory, TransportConfig, Transport, TransactionStatusSource, TransactionStatus, TransactionSnapshot, TransactionReceipt, TransactionError, TransactionDroppedError, TransactionAbortedError, TESTNET_ZERO_ADDRESS, SubscriptionFilterSpec, Subscription, StartNonceReconcilerParams, StacksProvider, StacksChain, SqlLike, SimulationError, SigningError, SerializationError, RequestOptions, RequestFn, RedisStoreParams, RedisLike, ReconcileNonceResult, ReconcileNonceParams, ReadOnlyCallError, PublicClientConfig, PublicClient, PublicActions, ProviderAccount, PoxFunction, PostgresStoreParams, NonceStore, NonceManagerSource, NonceManager, MultiSigClientConfig, MultiSigClient, MultiSigActions, MempoolAwareSourceParams, MICROSTX_PER_STX, LocalAccount, IndexTxSourceParams, IndexSourceParams, HiroNonceSourceParams, GetTransactionParams, FilterPrimitive, FilterOperator, FilterClause, Filter, FactoryTarget, CustomAccount, CreateNonceManagerParams, ContractCallError, ClientConfig, Client, BroadcastError, BnsAction, BaseError, AddressVersion, Account };