@bigmi/core 0.8.1 → 0.9.1

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @bigmi/core
 
+## 0.9.1
+
+### Patch Changes
+
+- [#75](https://github.com/lifinance/bigmi/pull/75) [`c9f3cd2`](https://github.com/lifinance/bigmi/commit/c9f3cd28fb5010277744c09857a4f4e1eaac6551) Thanks [@chybisov](https://github.com/chybisov)! - Bump runtime dependencies: `bitcoinjs-lib` 7.0.1 → 7.0.2 and `zustand` 5.0.14 → 5.0.15.
+  
+  `@noble/hashes` stays on `^1.8.0` on purpose. `bitcoinjs-lib@7.0.2` and `bs58check@4.0.0`
+  both declare `@noble/hashes: ^1.2.0`, so moving `@bigmi/core` to v2 would put two copies of
+  the library in every consumer's tree. v2 is also ESM-only and drops the `./sha256`,
+  `./sha1` and `./ripemd160` subpaths that `bitcoinjs-lib` imports, so an `overrides` pin to
+  v2 would break it at runtime. Revisit once `bitcoinjs-lib` widens its range.
+
+## 0.9.0
+
+### Minor Changes
+
+- [#62](https://github.com/lifinance/bigmi/pull/62) [`3569fc2`](https://github.com/lifinance/bigmi/commit/3569fc295a7877daf5b47989edecde85b2c38ea8) Thanks [@chybisov](https://github.com/chybisov)! - chore: migrate the toolchain to TypeScript 7
+
+  Bump the `typescript` devDependency from `6.x` to `7.x` (the native compiler) across the workspace, and bump `tsdown` `0.22.3` → `0.22.7` so its peer range accepts `typescript@^7`.
+
+  This is a build-time-only change with **no integration impact**: `typescript` is a devDependency (never a peer/runtime dependency), so consumers' own TypeScript version is untouched, and `.d.ts`/`.js` emit is handled by tsdown (Rolldown + OXC isolated declarations), not `tsc`. `tsc --noEmit` type-checks cleanly on TS 7 with zero source changes, and the public type surface is semantically identical (a rebuild only reformats declaration whitespace/comments via the newer `rolldown-plugin-dts` printer). Safe to ship as a minor.
+
 ## 0.8.1
 
 ### Patch Changes

package/README.md

@@ -110,12 +110,12 @@ Simple bigmi setup with a react app:
 
 import { bitcoin, http, createClient } from '@bigmi/core'
 import { BigmiProvider, createConfig } from '@bigmi/react'
-import { binance, xverse, phantom } from '@bigmi/client'
+import { binance, xverse } from '@bigmi/client'
 
 // Create bigmi config object
 const config = createConfig({
     chains: [bitcoin],
-    connectors: [binance(), xverse(), phantom()],
+    connectors: [binance(), xverse()],
     client: ({ chain }) => createClient({ chain, transport: http() }),
     ssr: true // If using Next.js or SSR
 })

package/dist/cjs/_virtual/_rolldown/runtime.js

@@ -15,7 +15,7 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));

package/dist/cjs/actions/getBalance.d.ts

@@ -3,13 +3,12 @@ import { UTXOSchema } from "../transports/types.js";
 import { Account } from "../types/account.js";
 import { Transport } from "../types/transport.js";
 import { Client } from "../types/client.js";
-
 //#region src/actions/getBalance.d.ts
-type GetBalanceParameters = {
-  /** The address of the account. */address: string;
+export type GetBalanceParameters = {
+  /** The address of the account. */
+  address: string;
 };
-type GetBalanceReturnType = bigint;
-declare function getBalance<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>, params: GetBalanceParameters): Promise<GetBalanceReturnType>;
+export type GetBalanceReturnType = bigint;
+export declare function getBalance<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>, params: GetBalanceParameters): Promise<GetBalanceReturnType>;
 //#endregion
-export { GetBalanceParameters, GetBalanceReturnType, getBalance };
 //# sourceMappingURL=getBalance.d.ts.map

package/dist/cjs/actions/getBlock.d.ts

@@ -4,20 +4,15 @@ import { Account } from "../types/account.js";
 import { Transport } from "../types/transport.js";
 import { Client } from "../types/client.js";
 import { Block } from "bitcoinjs-lib";
-
 //#region src/actions/getBlock.d.ts
-type GetBlockParameters = {
+export type GetBlockParameters = {
   blockHash: string;
   blockNumber?: never;
 } | {
   blockHash?: never;
   blockNumber: number;
 };
-type GetBlockReturnType = Block;
-declare function getBlock<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>, {
-  blockHash,
-  blockNumber
-}: GetBlockParameters): Promise<GetBlockReturnType>;
+export type GetBlockReturnType = Block;
+export declare function getBlock<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>, { blockHash, blockNumber }: GetBlockParameters): Promise<GetBlockReturnType>;
 //#endregion
-export { GetBlockParameters, GetBlockReturnType, getBlock };
 //# sourceMappingURL=getBlock.d.ts.map

package/dist/cjs/actions/getBlockCount.d.ts

@@ -3,10 +3,8 @@ import { UTXOSchema } from "../transports/types.js";
 import { Account } from "../types/account.js";
 import { Transport } from "../types/transport.js";
 import { Client } from "../types/client.js";
-
 //#region src/actions/getBlockCount.d.ts
-type GetBlockCountReturnType = number;
-declare function getBlockCount<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>): Promise<GetBlockCountReturnType>;
+export type GetBlockCountReturnType = number;
+export declare function getBlockCount<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>): Promise<GetBlockCountReturnType>;
 //#endregion
-export { GetBlockCountReturnType, getBlockCount };
 //# sourceMappingURL=getBlockCount.d.ts.map

package/dist/cjs/actions/getBlockStats.d.ts

@@ -4,9 +4,8 @@ import { UTXOSchema } from "../transports/types.js";
 import { Account } from "../types/account.js";
 import { Transport } from "../types/transport.js";
 import { Client } from "../types/client.js";
-
 //#region src/actions/getBlockStats.d.ts
-type GetBlockStatsParameters = ({
+export type GetBlockStatsParameters = ({
   blockHash: string;
   blockNumber?: never;
 } | {
@@ -15,12 +14,7 @@ type GetBlockStatsParameters = ({
 }) & {
   stats?: Array<BlockStatsKeys>;
 };
-type GetBlockStatsReturnType = BlockStats;
-declare function getBlockStats<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>, {
-  blockHash,
-  blockNumber,
-  stats
-}: GetBlockStatsParameters): Promise<GetBlockStatsReturnType>;
+export type GetBlockStatsReturnType = BlockStats;
+export declare function getBlockStats<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>, { blockHash, blockNumber, stats }: GetBlockStatsParameters): Promise<GetBlockStatsReturnType>;
 //#endregion
-export { GetBlockStatsParameters, GetBlockStatsReturnType, getBlockStats };
 //# sourceMappingURL=getBlockStats.d.ts.map

package/dist/cjs/actions/getTransactionFee.d.ts

@@ -3,15 +3,11 @@ import { UTXOSchema } from "../transports/types.js";
 import { Account } from "../types/account.js";
 import { Transport } from "../types/transport.js";
 import { Client } from "../types/client.js";
-
 //#region src/actions/getTransactionFee.d.ts
-type GetTransactionFeeParameters = {
+export type GetTransactionFeeParameters = {
   txId: string;
 };
-type GetTransactionFeeReturnType = bigint;
-declare function getTransactionFee<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>, {
-  txId
-}: GetTransactionFeeParameters): Promise<GetTransactionFeeReturnType>;
+export type GetTransactionFeeReturnType = bigint;
+export declare function getTransactionFee<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>, { txId }: GetTransactionFeeParameters): Promise<GetTransactionFeeReturnType>;
 //#endregion
-export { GetTransactionFeeParameters, GetTransactionFeeReturnType, getTransactionFee };
 //# sourceMappingURL=getTransactionFee.d.ts.map

package/dist/cjs/actions/getTransactions.d.ts

@@ -4,26 +4,19 @@ import { UTXOSchema } from "../transports/types.js";
 import { Account } from "../types/account.js";
 import { Transport } from "../types/transport.js";
 import { Client } from "../types/client.js";
-
 //#region src/actions/getTransactions.d.ts
-type GetTransactionsParameters = {
+export type GetTransactionsParameters = {
   address: string;
   offset?: number;
   limit?: number;
   lastBlock?: string;
   afterTxId?: string;
 };
-type GetTransactionsReturnType = {
+export type GetTransactionsReturnType = {
   transactions: Array<Partial<UTXOTransaction>>;
   total: number;
   hasMore?: boolean;
 };
-declare function getTransactions<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>, {
-  address,
-  offset,
-  limit,
-  lastBlock
-}: GetTransactionsParameters): Promise<GetTransactionsReturnType>;
+export declare function getTransactions<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>, { address, offset, limit, lastBlock }: GetTransactionsParameters): Promise<GetTransactionsReturnType>;
 //#endregion
-export { GetTransactionsParameters, GetTransactionsReturnType, getTransactions };
 //# sourceMappingURL=getTransactions.d.ts.map

package/dist/cjs/actions/getUTXOTransaction.d.ts

@@ -4,17 +4,14 @@ import { UTXOSchema } from "../transports/types.js";
 import { Account } from "../types/account.js";
 import { Transport } from "../types/transport.js";
 import { Client } from "../types/client.js";
-
 //#region src/actions/getUTXOTransaction.d.ts
-type GetUTXOTransactionParameters = {
-  /** The Id of the transaction */txId: string; /** The block in which to look for the transaction */
+export type GetUTXOTransactionParameters = {
+  /** The Id of the transaction */
+  txId: string;
+  /** The block in which to look for the transaction */
   blockHash?: string;
 };
-type GetUTXOTransactionReturnType = UTXOTransaction;
-declare function getUTXOTransaction<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>, {
-  txId,
-  blockHash
-}: GetUTXOTransactionParameters): Promise<GetUTXOTransactionReturnType>;
+export type GetUTXOTransactionReturnType = UTXOTransaction;
+export declare function getUTXOTransaction<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>, { txId, blockHash }: GetUTXOTransactionParameters): Promise<GetUTXOTransactionReturnType>;
 //#endregion
-export { GetUTXOTransactionParameters, GetUTXOTransactionReturnType, getUTXOTransaction };
 //# sourceMappingURL=getUTXOTransaction.d.ts.map

package/dist/cjs/actions/getUTXOs.d.ts

@@ -4,17 +4,12 @@ import { UTXOSchema } from "../transports/types.js";
 import { Account } from "../types/account.js";
 import { Transport } from "../types/transport.js";
 import { Client } from "../types/client.js";
-
 //#region src/actions/getUTXOs.d.ts
-type GetUTXOsParameters = {
+export type GetUTXOsParameters = {
   address: string;
   minValue?: number;
 };
-type GetUTXOsReturnType = Array<UTXO>;
-declare function getUTXOs<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>, {
-  address,
-  minValue
-}: GetUTXOsParameters): Promise<GetUTXOsReturnType>;
+export type GetUTXOsReturnType = Array<UTXO>;
+export declare function getUTXOs<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>, { address, minValue }: GetUTXOsParameters): Promise<GetUTXOsReturnType>;
 //#endregion
-export { GetUTXOsParameters, GetUTXOsReturnType, getUTXOs };
 //# sourceMappingURL=getUTXOs.d.ts.map

package/dist/cjs/actions/getXPubAddresses.d.ts

@@ -4,34 +4,33 @@ import { UTXOSchema } from "../transports/types.js";
 import { Account } from "../types/account.js";
 import { Transport } from "../types/transport.js";
 import { Client } from "../types/client.js";
-
 //#region src/actions/getXPubAddresses.d.ts
-type GetXPubAddressesParameters = {
-  /** The public key you're trying to get addresses of. */xPubKey: string;
+export type GetXPubAddressesParameters = {
+  /** The public key you're trying to get addresses of. */
+  xPubKey: string;
 };
-type GetXPubAddressesReturnType = xPubAccount;
+export type GetXPubAddressesReturnType = xPubAccount;
 /**
-* Retrieves all addresses and their balances associated with an extended public key (xPub).
-*
-* An extended public key (xPub) is a Bitcoin public key that can be used to derive multiple
-* child addresses. This action fetches all derived addresses along with their individual balances
-* and the total balance across all addresses.
-*
-* @param client - Client instance configured with UTXO transport
-* @param params - {@link GetXPubAddressesParameters}
-* @returns The xPub account data including total balance and all derived addresses. {@link GetXPubAddressesReturnType}
-*
-* @example
-* ```typescript
-* const result = await getXPubAddresses(client, {
-*   xPubKey: 'xpub6CcGTthbwnbxsMRuEF3sb...'
-* })
-*
-* console.log(result.balance) // Total balance across all addresses
-* console.log(result.addresses) // Array of derived addresses with individual balances
-* ```
-*/
-declare function getXPubAddresses<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>, params: GetXPubAddressesParameters): Promise<GetXPubAddressesReturnType>;
+ * Retrieves all addresses and their balances associated with an extended public key (xPub).
+ *
+ * An extended public key (xPub) is a Bitcoin public key that can be used to derive multiple
+ * child addresses. This action fetches all derived addresses along with their individual balances
+ * and the total balance across all addresses.
+ *
+ * @param client - Client instance configured with UTXO transport
+ * @param params - {@link GetXPubAddressesParameters}
+ * @returns The xPub account data including total balance and all derived addresses. {@link GetXPubAddressesReturnType}
+ *
+ * @example
+ * ```typescript
+ * const result = await getXPubAddresses(client, {
+ *   xPubKey: 'xpub6CcGTthbwnbxsMRuEF3sb...'
+ * })
+ *
+ * console.log(result.balance) // Total balance across all addresses
+ * console.log(result.addresses) // Array of derived addresses with individual balances
+ * ```
+ */
+export declare function getXPubAddresses<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>, params: GetXPubAddressesParameters): Promise<GetXPubAddressesReturnType>;
 //#endregion
-export { GetXPubAddressesParameters, GetXPubAddressesReturnType, getXPubAddresses };
 //# sourceMappingURL=getXPubAddresses.d.ts.map

package/dist/cjs/actions/sendUTXOTransaction.d.ts

@@ -3,17 +3,14 @@ import { UTXOSchema } from "../transports/types.js";
 import { Account } from "../types/account.js";
 import { Transport } from "../types/transport.js";
 import { Client } from "../types/client.js";
-
 //#region src/actions/sendUTXOTransaction.d.ts
-type SendUTXOTransactionParameters = {
-  /** The hex string of the raw transaction. */hex: string; /** Rejects transactions whose fee rate is higher than the specified value, expressed in BTC/kB. Set to 0 to accept any fee rate. Default = 0.10 */
+export type SendUTXOTransactionParameters = {
+  /** The hex string of the raw transaction. */
+  hex: string;
+  /** Rejects transactions whose fee rate is higher than the specified value, expressed in BTC/kB. Set to 0 to accept any fee rate. Default = 0.10 */
   maxFeeRate?: number;
 };
-type SendUTXOTransactionReturnType = string;
-declare function sendUTXOTransaction<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>, {
-  hex,
-  maxFeeRate
-}: SendUTXOTransactionParameters): Promise<SendUTXOTransactionReturnType>;
+export type SendUTXOTransactionReturnType = string;
+export declare function sendUTXOTransaction<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOSchema>, { hex, maxFeeRate }: SendUTXOTransactionParameters): Promise<SendUTXOTransactionReturnType>;
 //#endregion
-export { SendUTXOTransactionParameters, SendUTXOTransactionReturnType, sendUTXOTransaction };
 //# sourceMappingURL=sendUTXOTransaction.d.ts.map

package/dist/cjs/actions/signPsbt.d.ts

@@ -3,9 +3,7 @@ import { SignPsbtParameters, SignPsbtReturnType, UTXOWalletSchema } from "../tra
 import { Account } from "../types/account.js";
 import { Transport } from "../types/transport.js";
 import { Client } from "../types/client.js";
-
 //#region src/actions/signPsbt.d.ts
-declare function signPsbt<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOWalletSchema>, params: SignPsbtParameters): Promise<SignPsbtReturnType>;
+export declare function signPsbt<C extends Chain | undefined, A extends Account | undefined = Account | undefined>(client: Client<Transport, C, A, UTXOWalletSchema>, params: SignPsbtParameters): Promise<SignPsbtReturnType>;
 //#endregion
-export { signPsbt };
 //# sourceMappingURL=signPsbt.d.ts.map

package/dist/cjs/actions/waitForTransaction.d.ts

@@ -3,85 +3,78 @@ import { Chain } from "../types/chain.js";
 import { Transport } from "../types/transport.js";
 import { Client } from "../types/client.js";
 import { Transaction } from "bitcoinjs-lib";
-
 //#region src/actions/waitForTransaction.d.ts
-type ReplacementReason = "cancelled" | "replaced" | "repriced";
-type ReplacementReturnType = {
+export type ReplacementReason = "cancelled" | "replaced" | "repriced";
+export type ReplacementReturnType = {
   reason: ReplacementReason;
   replacedTransaction: Transaction;
   transaction: UTXOTransaction;
 };
-type WaitForTransactionReceiptReturnType = UTXOTransaction;
-type WithRetryParameters = {
+export type WaitForTransactionReceiptReturnType = UTXOTransaction;
+export type WithRetryParameters = {
   delay?: ((config: {
     count: number;
     error: Error;
   }) => number) | number | undefined;
   retryCount?: number | undefined;
 };
-type WaitForTransactionReceiptParameters = {
-  /** The Id of the transaction. */txId: string; /** The hex string of the raw transaction. */
-  txHex: string; /** The sender address of the transaction. */
+export type WaitForTransactionReceiptParameters = {
+  /** The Id of the transaction. */
+  txId: string;
+  /** The hex string of the raw transaction. */
+  txHex: string;
+  /** The sender address of the transaction. */
   senderAddress?: string;
   /**
-  * The number of confirmations (blocks that have passed) to wait before resolving.
-  * @default 1
-  */
-  confirmations?: number | undefined; /** Optional callback to emit if the transaction has been replaced. */
+   * The number of confirmations (blocks that have passed) to wait before resolving.
+   * @default 1
+   */
+  confirmations?: number | undefined;
+  /** Optional callback to emit if the transaction has been replaced. */
   onReplaced?: ((response: ReplacementReturnType) => void) | undefined;
   /**
-  * Polling frequency (in ms). Defaults to the client's pollingInterval config.
-  * @default client.pollingInterval
-  */
+   * Polling frequency (in ms). Defaults to the client's pollingInterval config.
+   * @default client.pollingInterval
+   */
   pollingInterval?: number | undefined;
   /**
-  * Number of times to retry if the transaction or block is not found.
-  * @default 6 (exponential backoff)
-  */
+   * Number of times to retry if the transaction or block is not found.
+   * @default 6 (exponential backoff)
+   */
   retryCount?: number;
   /**
-  * Time to wait (in ms) between retries.
-  */
+   * Time to wait (in ms) between retries.
+   */
   retryDelay?: ((config: {
     count: number;
     error: Error;
-  }) => number) | number; /** Optional timeout (in milliseconds) to wait before stopping polling. */
+  }) => number) | number;
+  /** Optional timeout (in milliseconds) to wait before stopping polling. */
   timeout?: number | undefined;
 };
 /**
-* Waits for the transaction to be included on a block (one confirmation), and then returns the transaction.
-* - JSON-RPC Methods:
-* - Polls getrawtransaction on each block until it has been processed.
-* - If a transaction has been replaced:
-* - Calls getblock and extracts the transactions
-* - Checks if one of the transactions is a replacement
-* - If so, calls getrawtransaction.
-*
-* The `waitForTransaction` action additionally supports replacement detection (e.g. RBF - transactions replaced-by-fee ).
-*
-* Transactions can be replaced when a user modifies their transaction in their wallet (to speed up or cancel).
-* https://bitcoinops.org/en/topics/replace-by-fee/
-*
-* There are 3 types of Transaction Replacement reasons:
-*
-* - `repriced`: The fee has been modified (e.g. same outputs, different amounts)
-* - `cancelled`: The Transaction has been cancelled (e.g. output is sender address)
-* - `replaced`: The Transaction has been replaced (e.g. different outputs)
-* @param client - Client to use
-* @param parameters - {@link WaitForTransactionReceiptParameters}
-* @returns The UTXO transaction. {@link WaitForTransactionReceiptReturnType}
-*/
-declare function waitForTransaction<chain extends Chain | undefined>(client: Client<Transport, chain>, {
-  confirmations,
-  txId,
-  txHex,
-  senderAddress,
-  onReplaced,
-  pollingInterval,
-  retryCount,
-  retryDelay,
-  timeout
-}: WaitForTransactionReceiptParameters): Promise<WaitForTransactionReceiptReturnType>;
+ * Waits for the transaction to be included on a block (one confirmation), and then returns the transaction.
+ * - JSON-RPC Methods:
+ * - Polls getrawtransaction on each block until it has been processed.
+ * - If a transaction has been replaced:
+ * - Calls getblock and extracts the transactions
+ * - Checks if one of the transactions is a replacement
+ * - If so, calls getrawtransaction.
+ *
+ * The `waitForTransaction` action additionally supports replacement detection (e.g. RBF - transactions replaced-by-fee ).
+ *
+ * Transactions can be replaced when a user modifies their transaction in their wallet (to speed up or cancel).
+ * https://bitcoinops.org/en/topics/replace-by-fee/
+ *
+ * There are 3 types of Transaction Replacement reasons:
+ *
+ * - `repriced`: The fee has been modified (e.g. same outputs, different amounts)
+ * - `cancelled`: The Transaction has been cancelled (e.g. output is sender address)
+ * - `replaced`: The Transaction has been replaced (e.g. different outputs)
+ * @param client - Client to use
+ * @param parameters - {@link WaitForTransactionReceiptParameters}
+ * @returns The UTXO transaction. {@link WaitForTransactionReceiptReturnType}
+ */
+export declare function waitForTransaction<chain extends Chain | undefined>(client: Client<Transport, chain>, { confirmations, txId, txHex, senderAddress, onReplaced, pollingInterval, retryCount, retryDelay, timeout }: WaitForTransactionReceiptParameters): Promise<WaitForTransactionReceiptReturnType>;
 //#endregion
-export { ReplacementReason, ReplacementReturnType, WaitForTransactionReceiptParameters, WaitForTransactionReceiptReturnType, WithRetryParameters, waitForTransaction };
 //# sourceMappingURL=waitForTransaction.d.ts.map

package/dist/cjs/actions/waitForTransaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"waitForTransaction.js","names":["stringify","WaitForTransactionReceiptTimeoutError","observe","getAction","watchBlockNumber","getBlockStats","withRetry","getUTXOTransaction","TransactionReceiptNotFoundError","TransactionNotFoundError","Transaction","getBlock","address"],"sources":["../../../src/actions/waitForTransaction.ts"],"sourcesContent":["import { address, Transaction } from 'bitcoinjs-lib'\nimport {\n  TransactionNotFoundError,\n  TransactionReceiptNotFoundError,\n  WaitForTransactionReceiptTimeoutError,\n} from '../errors/transaction.js'\nimport type { Chain } from '../types/chain.js'\nimport type { Client } from '../types/client.js'\nimport type { UTXOTransaction } from '../types/transaction.js'\nimport type { Transport } from '../types/transport.js'\nimport { getAction } from '../utils/getAction.js'\nimport { observe } from '../utils/observe.js'\nimport { stringify } from '../utils/stringify.js'\nimport { withRetry } from '../utils/withRetry.js'\nimport { getBlock } from './getBlock.js'\nimport { getBlockStats } from './getBlockStats.js'\nimport { getUTXOTransaction } from './getUTXOTransaction.js'\nimport { watchBlockNumber } from './watchBlockNumber.js'\n\nexport type ReplacementReason = 'cancelled' | 'replaced' | 'repriced'\nexport type ReplacementReturnType = {\n  reason: ReplacementReason\n  replacedTransaction: Transaction\n  transaction: UTXOTransaction\n}\n\nexport type WaitForTransactionReceiptReturnType = UTXOTransaction\n\nexport type WithRetryParameters = {\n  // The delay (in ms) between retries.\n  delay?:\n    | ((config: { count: number; error: Error }) => number)\n    | number\n    | undefined\n  // The max number of times to retry.\n  retryCount?: number | undefined\n}\n\nexport type WaitForTransactionReceiptParameters = {\n  /** The Id of the transaction. */\n  txId: string\n  /** The hex string of the raw transaction. */\n  txHex: string\n  /** The sender address of the transaction. */\n  senderAddress?: string\n  /**\n   * The number of confirmations (blocks that have passed) to wait before resolving.\n   * @default 1\n   */\n  confirmations?: number | undefined\n  /** Optional callback to emit if the transaction has been replaced. */\n  onReplaced?: ((response: ReplacementReturnType) => void) | undefined\n  /**\n   * Polling frequency (in ms). Defaults to the client's pollingInterval config.\n   * @default client.pollingInterval\n   */\n  pollingInterval?: number | undefined\n  /**\n   * Number of times to retry if the transaction or block is not found.\n   * @default 6 (exponential backoff)\n   */\n  retryCount?: number\n  /**\n   * Time to wait (in ms) between retries.\n   */\n  retryDelay?: ((config: { count: number; error: Error }) => number) | number\n  /** Optional timeout (in milliseconds) to wait before stopping polling. */\n  timeout?: number | undefined\n}\n\n/**\n * Waits for the transaction to be included on a block (one confirmation), and then returns the transaction.\n * - JSON-RPC Methods:\n * - Polls getrawtransaction on each block until it has been processed.\n * - If a transaction has been replaced:\n * - Calls getblock and extracts the transactions\n * - Checks if one of the transactions is a replacement\n * - If so, calls getrawtransaction.\n *\n * The `waitForTransaction` action additionally supports replacement detection (e.g. RBF - transactions replaced-by-fee ).\n *\n * Transactions can be replaced when a user modifies their transaction in their wallet (to speed up or cancel).\n * https://bitcoinops.org/en/topics/replace-by-fee/\n *\n * There are 3 types of Transaction Replacement reasons:\n *\n * - `repriced`: The fee has been modified (e.g. same outputs, different amounts)\n * - `cancelled`: The Transaction has been cancelled (e.g. output is sender address)\n * - `replaced`: The Transaction has been replaced (e.g. different outputs)\n * @param client - Client to use\n * @param parameters - {@link WaitForTransactionReceiptParameters}\n * @returns The UTXO transaction. {@link WaitForTransactionReceiptReturnType}\n */\nexport async function waitForTransaction<chain extends Chain | undefined>(\n  client: Client<Transport, chain>,\n  {\n    confirmations = 1,\n    txId,\n    txHex,\n    senderAddress,\n    onReplaced,\n    pollingInterval = client.pollingInterval,\n    retryCount = 10,\n    retryDelay = 3_000,\n    timeout,\n  }: WaitForTransactionReceiptParameters\n): Promise<WaitForTransactionReceiptReturnType> {\n  const observerId = stringify(['waitForTransaction', client.uid, txId])\n\n  let count = 0\n  let transaction: UTXOTransaction | undefined\n  let replacedTransaction: Transaction | undefined\n  let retrying = false\n\n  return new Promise((resolve, reject) => {\n    if (timeout) {\n      setTimeout(\n        () =>\n          reject(\n            new WaitForTransactionReceiptTimeoutError({ hash: txId as never })\n          ),\n        timeout\n      )\n    }\n\n    const _unobserve = observe(\n      observerId,\n      { onReplaced, resolve, reject },\n      (emit) => {\n        const _unwatch = getAction(\n          client,\n          watchBlockNumber,\n          'watchBlockNumber'\n        )({\n          emitMissed: true,\n          emitOnBegin: true,\n          pollingInterval,\n          async onBlockNumber(blockNumber_) {\n            const done = (fn: () => void) => {\n              _unwatch()\n              fn()\n              _unobserve()\n            }\n\n            let blockNumber = blockNumber_\n\n            if (retrying) {\n              return\n            }\n            if (count > retryCount) {\n              done(() =>\n                emit.reject(\n                  new WaitForTransactionReceiptTimeoutError({\n                    hash: txId as never,\n                  })\n                )\n              )\n            }\n\n            try {\n              // If we already have a valid receipt, let's check if we have enough\n              // confirmations. If we do, then we can resolve.\n              if (transaction?.blockhash) {\n                const blockStats = await getAction(\n                  client,\n                  getBlockStats,\n                  'getBlockStats'\n                )({\n                  blockHash: transaction.blockhash,\n                  stats: ['height'],\n                })\n                if (\n                  confirmations > 1 &&\n                  (!blockStats.height ||\n                    blockNumber - blockStats.height + 1 < confirmations)\n                ) {\n                  return\n                }\n                done(() => emit.resolve(transaction!))\n                return\n              }\n\n              // Get the transaction to check if it's been replaced.\n              // We need to retry as some RPC Providers may be slow to sync\n              // up mined transactions.\n              retrying = true\n              transaction = await withRetry(\n                () =>\n                  getAction(\n                    client,\n                    getUTXOTransaction,\n                    'getUTXOTransaction'\n                    // If transaction exists it might be the replaced one with different txId\n                  )({ txId: transaction?.txid || txId }),\n                {\n                  delay: retryDelay,\n                  retryCount,\n                }\n              )\n              if (transaction.blockhash) {\n                const blockStats = await getAction(\n                  client,\n                  getBlockStats,\n                  'getBlockStats'\n                )({\n                  blockHash: transaction.blockhash,\n                  stats: ['height'],\n                })\n                if (blockStats.height) {\n                  blockNumber = blockStats.height\n                }\n              }\n              retrying = false\n\n              // Check if transaction has been processed.\n              if (!transaction?.confirmations) {\n                throw new TransactionReceiptNotFoundError({\n                  hash: txId as never,\n                })\n              }\n\n              // Check if we have enough confirmations. If not, continue polling.\n              if (transaction.confirmations < confirmations) {\n                return\n              }\n\n              done(() => emit.resolve(transaction!))\n            } catch (err) {\n              // If the receipt is not found, the transaction will be pending.\n              // We need to check if it has potentially been replaced.\n              if (\n                err instanceof TransactionNotFoundError ||\n                err instanceof TransactionReceiptNotFoundError\n              ) {\n                try {\n                  replacedTransaction = Transaction.fromHex(\n                    transaction?.hex || txHex\n                  )\n\n                  // Let's retrieve the transactions from the current block.\n                  // We need to retry as some RPC Providers may be slow to sync\n                  // up mined blocks.\n                  retrying = true\n                  const block = await withRetry(\n                    () =>\n                      getAction(\n                        client,\n                        getBlock,\n                        'getBlock'\n                      )({\n                        blockNumber,\n                      }),\n                    {\n                      delay: retryDelay,\n                      retryCount,\n                      // shouldRetry: ({ error }) =>\n                      //   error instanceof BlockNotFoundError,\n                    }\n                  )\n                  retrying = false\n\n                  // Create a set of input identifiers for mempool transaction\n                  const replacedTransactionInputs = new Set<string>()\n\n                  for (const input of replacedTransaction.ins) {\n                    const txid = Array.from(input.hash)\n                      .reverse()\n                      .map((byte) => `00${byte.toString(16)}`.slice(-2))\n                      .join('')\n                    const vout = input.index\n                    const inputId = `${txid}:${vout}`\n                    replacedTransactionInputs.add(inputId)\n                  }\n\n                  let replacementTransaction: Transaction | undefined\n\n                  for (const tx of block.transactions!) {\n                    if (tx.isCoinbase()) {\n                      continue\n                    }\n\n                    // Check if any input of this transaction matches an input of mempool transaction\n                    for (const input of tx.ins) {\n                      const txid = Array.from(input.hash)\n                        .reverse()\n                        .map((byte) => `00${byte.toString(16)}`.slice(-2))\n                        .join('')\n                      const vout = input.index\n                      const inputId = `${txid}:${vout}`\n                      if (replacedTransactionInputs.has(inputId)) {\n                        replacementTransaction = tx\n                        break\n                      }\n                    }\n                    if (replacementTransaction) {\n                      break\n                    }\n                  }\n\n                  // If we couldn't find a replacement transaction, continue polling.\n                  if (!replacementTransaction) {\n                    return\n                  }\n\n                  // If we found a replacement transaction, return it's receipt.\n                  transaction = await getAction(\n                    client,\n                    getUTXOTransaction,\n                    'getUTXOTransaction'\n                  )({\n                    txId: replacementTransaction.getId(),\n                  })\n\n                  // Check if we have enough confirmations. If not, continue polling.\n                  if (\n                    transaction.confirmations &&\n                    transaction.confirmations < confirmations\n                  ) {\n                    return\n                  }\n\n                  let reason: ReplacementReason = 'replaced'\n\n                  // Function to get output addresses\n                  function getOutputAddresses(tx: Transaction): string[] {\n                    const addresses: string[] = []\n                    for (const output of tx.outs) {\n                      try {\n                        const outputAddress = address.fromOutputScript(\n                          output.script\n                        )\n                        addresses.push(outputAddress)\n                      } catch (_e) {\n                        // Handle non-standard scripts (e.g., OP_RETURN)\n                      }\n                    }\n                    return addresses\n                  }\n\n                  // Get the recipient addresses from the original transaction\n                  const originalOutputAddresses =\n                    getOutputAddresses(replacedTransaction)\n\n                  // Get the recipient addresses from the replacement transaction\n                  const replacementOutputAddresses = getOutputAddresses(\n                    replacementTransaction\n                  )\n\n                  if (\n                    originalOutputAddresses.length ===\n                      replacementOutputAddresses.length &&\n                    originalOutputAddresses.every((address) =>\n                      replacementOutputAddresses.includes(address)\n                    )\n                  ) {\n                    reason = 'repriced'\n                  } else if (\n                    senderAddress &&\n                    replacementOutputAddresses.length === 1 &&\n                    replacementOutputAddresses.includes(senderAddress)\n                  ) {\n                    reason = 'cancelled'\n                  }\n\n                  done(() => {\n                    emit.onReplaced?.({\n                      reason,\n                      replacedTransaction: replacedTransaction!,\n                      transaction: transaction!,\n                    })\n                    emit.resolve(transaction!)\n                  })\n                } catch (err_) {\n                  done(() => emit.reject(err_))\n                }\n              } else {\n                done(() => emit.reject(err))\n              }\n            } finally {\n              count++\n            }\n          },\n        })\n      }\n    )\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"waitForTransaction.js","names":["stringify","WaitForTransactionReceiptTimeoutError","observe","getAction","watchBlockNumber","getBlockStats","withRetry","getUTXOTransaction","TransactionReceiptNotFoundError","TransactionNotFoundError","Transaction","getBlock","address"],"sources":["../../../src/actions/waitForTransaction.ts"],"sourcesContent":["import { address, Transaction } from 'bitcoinjs-lib'\nimport {\n  TransactionNotFoundError,\n  TransactionReceiptNotFoundError,\n  WaitForTransactionReceiptTimeoutError,\n} from '../errors/transaction.js'\nimport type { Chain } from '../types/chain.js'\nimport type { Client } from '../types/client.js'\nimport type { UTXOTransaction } from '../types/transaction.js'\nimport type { Transport } from '../types/transport.js'\nimport { getAction } from '../utils/getAction.js'\nimport { observe } from '../utils/observe.js'\nimport { stringify } from '../utils/stringify.js'\nimport { withRetry } from '../utils/withRetry.js'\nimport { getBlock } from './getBlock.js'\nimport { getBlockStats } from './getBlockStats.js'\nimport { getUTXOTransaction } from './getUTXOTransaction.js'\nimport { watchBlockNumber } from './watchBlockNumber.js'\n\nexport type ReplacementReason = 'cancelled' | 'replaced' | 'repriced'\nexport type ReplacementReturnType = {\n  reason: ReplacementReason\n  replacedTransaction: Transaction\n  transaction: UTXOTransaction\n}\n\nexport type WaitForTransactionReceiptReturnType = UTXOTransaction\n\nexport type WithRetryParameters = {\n  // The delay (in ms) between retries.\n  delay?:\n    | ((config: { count: number; error: Error }) => number)\n    | number\n    | undefined\n  // The max number of times to retry.\n  retryCount?: number | undefined\n}\n\nexport type WaitForTransactionReceiptParameters = {\n  /** The Id of the transaction. */\n  txId: string\n  /** The hex string of the raw transaction. */\n  txHex: string\n  /** The sender address of the transaction. */\n  senderAddress?: string\n  /**\n   * The number of confirmations (blocks that have passed) to wait before resolving.\n   * @default 1\n   */\n  confirmations?: number | undefined\n  /** Optional callback to emit if the transaction has been replaced. */\n  onReplaced?: ((response: ReplacementReturnType) => void) | undefined\n  /**\n   * Polling frequency (in ms). Defaults to the client's pollingInterval config.\n   * @default client.pollingInterval\n   */\n  pollingInterval?: number | undefined\n  /**\n   * Number of times to retry if the transaction or block is not found.\n   * @default 6 (exponential backoff)\n   */\n  retryCount?: number\n  /**\n   * Time to wait (in ms) between retries.\n   */\n  retryDelay?: ((config: { count: number; error: Error }) => number) | number\n  /** Optional timeout (in milliseconds) to wait before stopping polling. */\n  timeout?: number | undefined\n}\n\n/**\n * Waits for the transaction to be included on a block (one confirmation), and then returns the transaction.\n * - JSON-RPC Methods:\n * - Polls getrawtransaction on each block until it has been processed.\n * - If a transaction has been replaced:\n * - Calls getblock and extracts the transactions\n * - Checks if one of the transactions is a replacement\n * - If so, calls getrawtransaction.\n *\n * The `waitForTransaction` action additionally supports replacement detection (e.g. RBF - transactions replaced-by-fee ).\n *\n * Transactions can be replaced when a user modifies their transaction in their wallet (to speed up or cancel).\n * https://bitcoinops.org/en/topics/replace-by-fee/\n *\n * There are 3 types of Transaction Replacement reasons:\n *\n * - `repriced`: The fee has been modified (e.g. same outputs, different amounts)\n * - `cancelled`: The Transaction has been cancelled (e.g. output is sender address)\n * - `replaced`: The Transaction has been replaced (e.g. different outputs)\n * @param client - Client to use\n * @param parameters - {@link WaitForTransactionReceiptParameters}\n * @returns The UTXO transaction. {@link WaitForTransactionReceiptReturnType}\n */\nexport async function waitForTransaction<chain extends Chain | undefined>(\n  client: Client<Transport, chain>,\n  {\n    confirmations = 1,\n    txId,\n    txHex,\n    senderAddress,\n    onReplaced,\n    pollingInterval = client.pollingInterval,\n    retryCount = 10,\n    retryDelay = 3_000,\n    timeout,\n  }: WaitForTransactionReceiptParameters\n): Promise<WaitForTransactionReceiptReturnType> {\n  const observerId = stringify(['waitForTransaction', client.uid, txId])\n\n  let count = 0\n  let transaction: UTXOTransaction | undefined\n  let replacedTransaction: Transaction | undefined\n  let retrying = false\n\n  return new Promise((resolve, reject) => {\n    if (timeout) {\n      setTimeout(\n        () =>\n          reject(\n            new WaitForTransactionReceiptTimeoutError({ hash: txId as never })\n          ),\n        timeout\n      )\n    }\n\n    const _unobserve = observe(\n      observerId,\n      { onReplaced, resolve, reject },\n      (emit) => {\n        const _unwatch = getAction(\n          client,\n          watchBlockNumber,\n          'watchBlockNumber'\n        )({\n          emitMissed: true,\n          emitOnBegin: true,\n          pollingInterval,\n          async onBlockNumber(blockNumber_) {\n            const done = (fn: () => void) => {\n              _unwatch()\n              fn()\n              _unobserve()\n            }\n\n            let blockNumber = blockNumber_\n\n            if (retrying) {\n              return\n            }\n            if (count > retryCount) {\n              done(() =>\n                emit.reject(\n                  new WaitForTransactionReceiptTimeoutError({\n                    hash: txId as never,\n                  })\n                )\n              )\n            }\n\n            try {\n              // If we already have a valid receipt, let's check if we have enough\n              // confirmations. If we do, then we can resolve.\n              if (transaction?.blockhash) {\n                const blockStats = await getAction(\n                  client,\n                  getBlockStats,\n                  'getBlockStats'\n                )({\n                  blockHash: transaction.blockhash,\n                  stats: ['height'],\n                })\n                if (\n                  confirmations > 1 &&\n                  (!blockStats.height ||\n                    blockNumber - blockStats.height + 1 < confirmations)\n                ) {\n                  return\n                }\n                done(() => emit.resolve(transaction!))\n                return\n              }\n\n              // Get the transaction to check if it's been replaced.\n              // We need to retry as some RPC Providers may be slow to sync\n              // up mined transactions.\n              retrying = true\n              transaction = await withRetry(\n                () =>\n                  getAction(\n                    client,\n                    getUTXOTransaction,\n                    'getUTXOTransaction'\n                    // If transaction exists it might be the replaced one with different txId\n                  )({ txId: transaction?.txid || txId }),\n                {\n                  delay: retryDelay,\n                  retryCount,\n                }\n              )\n              if (transaction.blockhash) {\n                const blockStats = await getAction(\n                  client,\n                  getBlockStats,\n                  'getBlockStats'\n                )({\n                  blockHash: transaction.blockhash,\n                  stats: ['height'],\n                })\n                if (blockStats.height) {\n                  blockNumber = blockStats.height\n                }\n              }\n              retrying = false\n\n              // Check if transaction has been processed.\n              if (!transaction?.confirmations) {\n                throw new TransactionReceiptNotFoundError({\n                  hash: txId as never,\n                })\n              }\n\n              // Check if we have enough confirmations. If not, continue polling.\n              if (transaction.confirmations < confirmations) {\n                return\n              }\n\n              done(() => emit.resolve(transaction!))\n            } catch (err) {\n              // If the receipt is not found, the transaction will be pending.\n              // We need to check if it has potentially been replaced.\n              if (\n                err instanceof TransactionNotFoundError ||\n                err instanceof TransactionReceiptNotFoundError\n              ) {\n                try {\n                  replacedTransaction = Transaction.fromHex(\n                    transaction?.hex || txHex\n                  )\n\n                  // Let's retrieve the transactions from the current block.\n                  // We need to retry as some RPC Providers may be slow to sync\n                  // up mined blocks.\n                  retrying = true\n                  const block = await withRetry(\n                    () =>\n                      getAction(\n                        client,\n                        getBlock,\n                        'getBlock'\n                      )({\n                        blockNumber,\n                      }),\n                    {\n                      delay: retryDelay,\n                      retryCount,\n                      // shouldRetry: ({ error }) =>\n                      //   error instanceof BlockNotFoundError,\n                    }\n                  )\n                  retrying = false\n\n                  // Create a set of input identifiers for mempool transaction\n                  const replacedTransactionInputs = new Set<string>()\n\n                  for (const input of replacedTransaction.ins) {\n                    const txid = Array.from(input.hash)\n                      .reverse()\n                      .map((byte) => `00${byte.toString(16)}`.slice(-2))\n                      .join('')\n                    const vout = input.index\n                    const inputId = `${txid}:${vout}`\n                    replacedTransactionInputs.add(inputId)\n                  }\n\n                  let replacementTransaction: Transaction | undefined\n\n                  for (const tx of block.transactions!) {\n                    if (tx.isCoinbase()) {\n                      continue\n                    }\n\n                    // Check if any input of this transaction matches an input of mempool transaction\n                    for (const input of tx.ins) {\n                      const txid = Array.from(input.hash)\n                        .reverse()\n                        .map((byte) => `00${byte.toString(16)}`.slice(-2))\n                        .join('')\n                      const vout = input.index\n                      const inputId = `${txid}:${vout}`\n                      if (replacedTransactionInputs.has(inputId)) {\n                        replacementTransaction = tx\n                        break\n                      }\n                    }\n                    if (replacementTransaction) {\n                      break\n                    }\n                  }\n\n                  // If we couldn't find a replacement transaction, continue polling.\n                  if (!replacementTransaction) {\n                    return\n                  }\n\n                  // If we found a replacement transaction, return it's receipt.\n                  transaction = await getAction(\n                    client,\n                    getUTXOTransaction,\n                    'getUTXOTransaction'\n                  )({\n                    txId: replacementTransaction.getId(),\n                  })\n\n                  // Check if we have enough confirmations. If not, continue polling.\n                  if (\n                    transaction.confirmations &&\n                    transaction.confirmations < confirmations\n                  ) {\n                    return\n                  }\n\n                  let reason: ReplacementReason = 'replaced'\n\n                  // Function to get output addresses\n                  function getOutputAddresses(tx: Transaction): string[] {\n                    const addresses: string[] = []\n                    for (const output of tx.outs) {\n                      try {\n                        const outputAddress = address.fromOutputScript(\n                          output.script\n                        )\n                        addresses.push(outputAddress)\n                      } catch (_e) {\n                        // Handle non-standard scripts (e.g., OP_RETURN)\n                      }\n                    }\n                    return addresses\n                  }\n\n                  // Get the recipient addresses from the original transaction\n                  const originalOutputAddresses =\n                    getOutputAddresses(replacedTransaction)\n\n                  // Get the recipient addresses from the replacement transaction\n                  const replacementOutputAddresses = getOutputAddresses(\n                    replacementTransaction\n                  )\n\n                  if (\n                    originalOutputAddresses.length ===\n                      replacementOutputAddresses.length &&\n                    originalOutputAddresses.every((address) =>\n                      replacementOutputAddresses.includes(address)\n                    )\n                  ) {\n                    reason = 'repriced'\n                  } else if (\n                    senderAddress &&\n                    replacementOutputAddresses.length === 1 &&\n                    replacementOutputAddresses.includes(senderAddress)\n                  ) {\n                    reason = 'cancelled'\n                  }\n\n                  done(() => {\n                    emit.onReplaced?.({\n                      reason,\n                      replacedTransaction: replacedTransaction!,\n                      transaction: transaction!,\n                    })\n                    emit.resolve(transaction!)\n                  })\n                } catch (err_) {\n                  done(() => emit.reject(err_))\n                }\n              } else {\n                done(() => emit.reject(err))\n              }\n            } finally {\n              count++\n            }\n          },\n        })\n      }\n    )\n  })\n}\n"],"mappings":"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"}

package/dist/cjs/actions/watchBlockNumber.d.ts

@@ -2,32 +2,29 @@ import { Chain } from "../types/chain.js";
 import { Transport } from "../types/transport.js";
 import { Client } from "../types/client.js";
 import { GetBlockCountReturnType } from "./getBlockCount.js";
-
 //#region src/actions/watchBlockNumber.d.ts
-type OnBlockNumberParameter = GetBlockCountReturnType;
-type OnBlockNumberFn = (blockNumber: OnBlockNumberParameter, prevBlockNumber: OnBlockNumberParameter | undefined) => Promise<void>;
-type WatchBlockNumberParameters = {
-  /** The callback to call when a new block number is received. */onBlockNumber: OnBlockNumberFn; /** The callback to call when an error occurred when trying to get for a new block. */
+export type OnBlockNumberParameter = GetBlockCountReturnType;
+export type OnBlockNumberFn = (blockNumber: OnBlockNumberParameter, prevBlockNumber: OnBlockNumberParameter | undefined) => Promise<void>;
+export type WatchBlockNumberParameters = {
+  /** The callback to call when a new block number is received. */
+  onBlockNumber: OnBlockNumberFn;
+  /** The callback to call when an error occurred when trying to get for a new block. */
   onError?: ((error: Error) => void) | undefined;
 } & {
-  /** Whether or not to emit the missed block numbers to the callback. */emitMissed?: boolean | undefined; /** Whether or not to emit the latest block number to the callback when the subscription opens. */
-  emitOnBegin?: boolean | undefined; /** Polling frequency (in ms). Defaults to Client's pollingInterval config. */
+  /** Whether or not to emit the missed block numbers to the callback. */
+  emitMissed?: boolean | undefined;
+  /** Whether or not to emit the latest block number to the callback when the subscription opens. */
+  emitOnBegin?: boolean | undefined;
+  /** Polling frequency (in ms). Defaults to Client's pollingInterval config. */
   pollingInterval?: number | undefined;
 };
-type WatchBlockNumberReturnType = () => void;
+export type WatchBlockNumberReturnType = () => void;
 /**
-* Watches and returns incoming block numbers.
-* @param client - Client to use
-* @param parameters - {@link WatchBlockNumberParameters}
-* @returns A function that can be invoked to stop watching for new block numbers. {@link WatchBlockNumberReturnType}
-*/
-declare function watchBlockNumber<chain extends Chain | undefined, transport extends Transport>(client: Client<transport, chain>, {
-  emitOnBegin,
-  emitMissed,
-  onBlockNumber,
-  onError,
-  pollingInterval
-}: WatchBlockNumberParameters): WatchBlockNumberReturnType;
+ * Watches and returns incoming block numbers.
+ * @param client - Client to use
+ * @param parameters - {@link WatchBlockNumberParameters}
+ * @returns A function that can be invoked to stop watching for new block numbers. {@link WatchBlockNumberReturnType}
+ */
+export declare function watchBlockNumber<chain extends Chain | undefined, transport extends Transport>(client: Client<transport, chain>, { emitOnBegin, emitMissed, onBlockNumber, onError, pollingInterval }: WatchBlockNumberParameters): WatchBlockNumberReturnType;
 //#endregion
-export { OnBlockNumberFn, OnBlockNumberParameter, WatchBlockNumberParameters, WatchBlockNumberReturnType, watchBlockNumber };
 //# sourceMappingURL=watchBlockNumber.d.ts.map