starknet 7.5.0 → 7.5.1

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as RPCSPEC07 from '@starknet-io/starknet-types-07';
 import { STRUCT_EVENT, EVENT_FIELD, ENUM_EVENT, BlockHash, TransactionHash, StarknetDomain, StarknetEnumType, StarknetMerkleType, StarknetType, TypedData, TypedDataRevision, StarknetWindowObject, Address, Permission, WatchAssetParameters as WatchAssetParameters$1, AddStarknetChainParameters as AddStarknetChainParameters$1, ChainId, AccountDeploymentData, AddInvokeTransactionParameters, AddInvokeTransactionResult, AddDeclareTransactionParameters, AddDeclareTransactionResult, Signature as Signature$2, SpecVersion, AccountChangeEventHandler as AccountChangeEventHandler$1, NetworkChangeEventHandler as NetworkChangeEventHandler$1 } from '@starknet-io/starknet-types-07';
 export { StarknetDomain, StarknetEnumType, StarknetMerkleType, StarknetType, TypedData, TypedDataRevision } from '@starknet-io/starknet-types-07';
 import * as RPCSPEC08 from '@starknet-io/starknet-types-08';
-import { PAYMASTER_API, EDataAvailabilityMode as EDataAvailabilityMode$1, SUBSCRIPTION_BLOCK_TAG, BLOCK_WITH_TX_HASHES, PENDING_BLOCK_WITH_TX_HASHES, BlockWithTxHashes as BlockWithTxHashes$1, TransactionReceipt as TransactionReceipt$1, IsSucceeded, IsReverted, IsType, OutsideExecutionTypedData, ETransactionVersion as ETransactionVersion$1, ETransactionVersion2 as ETransactionVersion2$1, ETransactionVersion3 as ETransactionVersion3$1, SubscriptionReorgResponse, SubscriptionNewHeadsResponse, SubscriptionEventsResponse, SubscriptionTransactionsStatusResponse, SubscriptionPendingTransactionsResponse, SUBSCRIPTION_ID, WebSocketMethods, BLOCK_STATUS, BLOCK_HEADER, BLOCK_BODY_WITH_RECEIPTS, PENDING_BLOCK_HEADER, BlockTransactionsTraces, L1L2MessagesStatus, CONTRACT_STORAGE_KEYS, StorageProof, CASM_COMPILED_CONTRACT_CLASS, AccountChangeEventHandler, NetworkChangeEventHandler, WatchAssetParameters, AddStarknetChainParameters, Signature as Signature$1, EDAMode as EDAMode$1, PRICE_UNIT as PRICE_UNIT$1, OutsideCallV1, OutsideCallV2, EmittedEvent as EmittedEvent$1, Methods as Methods$1 } from '@starknet-io/starknet-types-08';
+import { PAYMASTER_API, EDataAvailabilityMode as EDataAvailabilityMode$1, SUBSCRIPTION_BLOCK_TAG, BLOCK_WITH_TX_HASHES, PENDING_BLOCK_WITH_TX_HASHES, BlockWithTxHashes as BlockWithTxHashes$1, TransactionReceipt as TransactionReceipt$1, IsSucceeded, IsReverted, IsType, OutsideExecutionTypedData, ETransactionVersion as ETransactionVersion$1, ETransactionVersion2 as ETransactionVersion2$1, ETransactionVersion3 as ETransactionVersion3$1, SUBSCRIPTION_ID, BLOCK_HEADER, EMITTED_EVENT, NEW_TXN_STATUS, TXN_HASH as TXN_HASH$1, TXN_WITH_HASH, BLOCK_STATUS, BLOCK_BODY_WITH_RECEIPTS, PENDING_BLOCK_HEADER, BlockTransactionsTraces, L1L2MessagesStatus, CONTRACT_STORAGE_KEYS, StorageProof, CASM_COMPILED_CONTRACT_CLASS, AccountChangeEventHandler, NetworkChangeEventHandler, WatchAssetParameters, AddStarknetChainParameters, Signature as Signature$1, EDAMode as EDAMode$1, PRICE_UNIT as PRICE_UNIT$1, OutsideCallV1, OutsideCallV2, EmittedEvent as EmittedEvent$1, Methods as Methods$1 } from '@starknet-io/starknet-types-08';
 import * as weierstrass from '@noble/curves/abstract/weierstrass';
 import { RecoveredSignatureType } from '@noble/curves/abstract/weierstrass';
 import { Abi as Abi$1, TypedContract } from 'abi-wan-kanabi';
@@ -1033,7 +1033,6 @@ interface UniversalDetails {
     blockIdentifier?: BlockIdentifier;
     maxFee?: BigNumberish;
     tip?: BigNumberish;
-    paymaster?: PaymasterDetails;
     paymasterData?: BigNumberish[];
     accountDeploymentData?: BigNumberish[];
     nonceDataAvailabilityMode?: EDataAvailabilityMode$1;
@@ -2243,252 +2242,385 @@ declare namespace rpc_0_8_1 {
   export { rpc_0_8_1_RpcChannel as RpcChannel };
 }
 
-declare const WSSubscriptions: {
-    readonly NEW_HEADS: "newHeads";
-    readonly EVENTS: "events";
-    readonly TRANSACTION_STATUS: "transactionStatus";
-    readonly PENDING_TRANSACTION: "pendingTransactions";
+declare const _default: {
+    new (url: string | URL, protocols?: string | string[]): WebSocket;
+    prototype: WebSocket;
+    readonly CONNECTING: 0;
+    readonly OPEN: 1;
+    readonly CLOSING: 2;
+    readonly CLOSED: 3;
 };
-type WebSocketOptions = {
+
+/**
+ * Represents an active WebSocket subscription.
+ *
+ * This class should not be instantiated directly. It is returned by the
+ * `subscribe` methods on the `WebSocketChannel`.
+ *
+ * @template T - The type of data expected from the subscription event.
+ * @example
+ * ```typescript
+ * const channel = new WebSocketChannel({ nodeUrl: 'YOUR_NODE_URL' });
+ * await channel.waitForConnection();
+ *
+ * // The 'sub' object is an instance of the Subscription class.
+ * const sub = await channel.subscribeNewHeads();
+ *
+ * sub.on((data) => {
+ *   console.log('Received new head:', data);
+ * });
+ *
+ * // ... later
+ * await sub.unsubscribe();
+ * ```
+ */
+declare class Subscription<T = any> {
     /**
-     * websocket node url address
-     * @example 'ws://www.host.com/path'
-     * @default public websocket enabled starknet node
+     * The containing `WebSocketChannel` instance.
+     * @internal
      */
-    nodeUrl?: string;
+    channel: WebSocketChannel;
     /**
-     * This parameter should be used when working in an environment without native WebSocket support by providing
-     * an equivalent WebSocket object that conforms to the protocol, e.g. from the 'isows' and/or 'ws' modules
-     * * https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/WebSocket#protocols .
-     * * https://www.rfc-editor.org/rfc/rfc6455.html#section-1 .
-     * @default WebSocket
+     * The JSON-RPC method used to create this subscription.
+     * @internal
      */
-    websocket?: WebSocket;
-};
-/**
- * WebSocket channel provides communication with Starknet node over long-lived socket connection
- */
-declare class WebSocketChannel {
+    method: string;
     /**
-     * WebSocket RPC Node URL
-     * @example 'wss://starknet-node.io/rpc/v0_8'
+     * The parameters used to create this subscription.
+     * @internal
      */
-    nodeUrl: string;
+    params: any;
     /**
-     * ws library object
+     * The unique identifier for this subscription.
+     * @internal
      */
-    websocket: WebSocket;
+    id: SUBSCRIPTION_ID;
+    private events;
+    private buffer;
+    private maxBufferSize;
+    private handler;
+    private _isClosed;
     /**
-     * Assign implementation method to get 'on reorg event data'
-     * @example
-     * ```typescript
-     * webSocketChannel.onReorg = async function (data) {
-     *  // ... do something when reorg happens
-     * }
-     * ```
+     * @internal
+     * @param {WebSocketChannel} channel - The WebSocketChannel instance.
+     * @param {string} method - The RPC method used for the subscription.
+     * @param {any} params - The parameters for the subscription.
+     * @param {SUBSCRIPTION_ID} id - The subscription ID.
+     * @param {number} maxBufferSize - The maximum number of events to buffer.
      */
-    onReorg: (this: WebSocketChannel, data: SubscriptionReorgResponse) => any;
+    constructor(channel: WebSocketChannel, method: string, params: object, id: SUBSCRIPTION_ID, maxBufferSize: number);
     /**
-     * Assign implementation method to get 'starknet block heads'
-     * @example
-     * ```typescript
-     * webSocketChannel.onNewHeads = async function (data) {
-     *  // ... do something with head data
-     * }
-     * ```
+     * Indicates if the subscription has been closed.
+     * @returns {boolean} `true` if unsubscribed, `false` otherwise.
      */
-    onNewHeads: (this: WebSocketChannel, data: SubscriptionNewHeadsResponse) => any;
+    get isClosed(): boolean;
     /**
-     * Assign implementation method to get 'starknet events'
-     * @example
-     * ```typescript
-     * webSocketChannel.onEvents = async function (data) {
-     *  // ... do something with event data
-     * }
-     * ```
+     * Internal method to handle incoming events from the WebSocket channel.
+     * If a handler is attached, it's invoked immediately. Otherwise, the event is buffered.
+     * @internal
+     * @param {T} data - The event data.
      */
-    onEvents: (this: WebSocketChannel, data: SubscriptionEventsResponse) => any;
+    _handleEvent(data: T): void;
     /**
-     * Assign method to get 'starknet transactions status'
-     * @example
-     * ```typescript
-     * webSocketChannel.onTransactionStatus = async function (data) {
-     *  // ... do something with tx status data
-     * }
-     * ```
+     * Attaches a handler function to be called for each event.
+     *
+     * When a handler is attached, any buffered events will be passed to it sequentially.
+     * Subsequent events will be passed directly as they arrive.
+     *
+     * @param {(data: T) => void} handler - The function to call with event data.
+     * @throws {Error} If a handler is already attached to this subscription.
      */
-    onTransactionStatus: (this: WebSocketChannel, data: SubscriptionTransactionsStatusResponse) => any;
+    on(handler: (data: T) => void): void;
     /**
-     * Assign implementation method to get 'starknet pending transactions (mempool)'
+     * Sends an unsubscribe request to the node and cleans up local resources.
+     * @returns {Promise<boolean>} A Promise that resolves to `true` if the unsubscription was successful.
+     */
+    unsubscribe(): Promise<boolean>;
+}
+
+/**
+ * Options for configuring the automatic reconnection behavior of the WebSocketChannel.
+ */
+type ReconnectOptions = {
+    /**
+     * The number of retries to attempt before giving up.
+     * @default 5
+     */
+    retries?: number;
+    /**
+     * The initial delay in milliseconds before the first retry.
+     * This delay will be doubled for each subsequent retry (exponential backoff).
+     * @default 2000
+     */
+    delay?: number;
+};
+/**
+ * Options for configuring the WebSocketChannel.
+ */
+type WebSocketOptions = {
+    /**
+     * The URL of the WebSocket endpoint of the Starknet node.
+     * @example 'ws://localhost:9545'
+     */
+    nodeUrl: string;
+    /**
+     * This parameter can be used to provide a custom WebSocket implementation.
+     * This is useful in environments where the global WebSocket object is not available (e.g., Node.js).
      * @example
      * ```typescript
-     * webSocketChannel.onPendingTransaction = async function (data) {
-     *  // ... do something with pending tx data
-     * }
+     * import WebSocket from 'ws';
+     * const channel = new WebSocketChannel({ nodeUrl: '...', websocket: WebSocket });
      * ```
      */
-    onPendingTransaction: (this: WebSocketChannel, data: SubscriptionPendingTransactionsResponse) => any;
+    websocket?: typeof _default;
     /**
-     * Assign implementation to this method to listen open Event
+     * The maximum number of events to buffer per subscription when no handler is attached.
+     * @default 1000
      */
-    onOpen: (this: WebSocketChannel, ev: Event) => any;
+    maxBufferSize?: number;
     /**
-     * Assign implementation to this method to listen close CloseEvent
+     * Whether to automatically reconnect when the connection is lost.
+     * @default true
      */
-    onClose: (this: WebSocketChannel, ev: CloseEvent) => any;
+    autoReconnect?: boolean;
     /**
-     * Assign implementation to this method to listen message MessageEvent
+     * Options for the automatic reconnection behavior.
      */
-    onMessage: (this: WebSocketChannel, ev: MessageEvent<any>) => any;
+    reconnectOptions?: ReconnectOptions;
     /**
-     * Assign implementation to this method to listen error Event
+     * The timeout in milliseconds for a `sendReceive` call.
+     * @default 60000
      */
-    onError: (this: WebSocketChannel, ev: Event) => any;
+    requestTimeout?: number;
+};
+type WebSocketChannelEvents = {
+    open: Event;
+    close: CloseEvent;
+    message: MessageEvent<any>;
+    error: Event;
+    unsubscribe: SUBSCRIPTION_ID;
+};
+/**
+ * Manages a WebSocket connection to a Starknet node for receiving real-time updates.
+ * This class handles subscriptions, automatic reconnection, and request queueing.
+ *
+ * @example
+ * ```typescript
+ * const channel = new WebSocketChannel({ nodeUrl: 'YOUR_NODE_URL' });
+ * await channel.waitForConnection();
+ *
+ * const sub = await channel.subscribeNewHeads();
+ * sub.on((data) => {
+ *   console.log('New Block:', data);
+ * });
+ *
+ * // ... later
+ * await sub.unsubscribe();
+ * channel.disconnect();
+ * ```
+ */
+declare class WebSocketChannel {
     /**
-     * Assign implementation to this method to listen unsubscription
+     * The URL of the WebSocket RPC Node.
+     * @example 'wss://starknet-sepolia.public.blastapi.io/rpc/v0_8'
      */
-    onUnsubscribe: (this: WebSocketChannel, _subscriptionId: SUBSCRIPTION_ID) => any;
-    private onUnsubscribeLocal;
+    nodeUrl: string;
     /**
-     * JSON RPC latest sent message id
-     * expecting receiving message to contain same id
+     * The underlying WebSocket instance.
+     */
+    websocket: _default;
+    private WsImplementation;
+    private activeSubscriptions;
+    private readonly maxBufferSize;
+    private readonly autoReconnect;
+    private readonly reconnectOptions;
+    private readonly requestTimeout;
+    private isReconnecting;
+    private reconnectAttempts;
+    private userInitiatedClose;
+    private reconnectTimeoutId;
+    private requestQueue;
+    private events;
+    private openListener;
+    private closeListener;
+    private messageListener;
+    private errorListener;
+    /**
+     * JSON RPC latest sent message ID.
+     * The receiving message is expected to contain the same ID.
      */
     private sendId;
     /**
-     * subscriptions ids
-     * mapped by keys WSSubscriptions
+     * Creates an instance of WebSocketChannel.
+     * @param {WebSocketOptions} options - The options for configuring the channel.
      */
-    readonly subscriptions: Map<string, SUBSCRIPTION_ID>;
-    /**
-     * Construct class and event listeners
-     * @param options WebSocketOptions
-     */
-    constructor(options?: WebSocketOptions);
+    constructor(options: WebSocketOptions);
     private idResolver;
     /**
-     * Send data over open ws connection
-     * * this would only send data on the line without awaiting 'response message'
-     * @example
-     * ```typescript
-     * const sentId = await this.send('starknet_method', params);
-     * ```
+     * Sends a JSON-RPC request over the WebSocket connection without waiting for a response.
+     * This is a low-level method. Prefer `sendReceive` for most use cases.
+     * @param {string} method - The RPC method name.
+     * @param {object} [params] - The parameters for the RPC method.
+     * @param {number} [id] - A specific request ID. If not provided, an auto-incrementing ID is used.
+     * @returns {number} The ID of the sent request.
+     * @throws {WebSocketNotConnectedError} If the WebSocket is not connected.
      */
     send(method: string, params?: object, id?: number): number;
     /**
-     * Any Starknet method not just websocket override
-     */
-    sendReceiveAny(method: any, params?: any): Promise<any>;
-    /**
-     * Send request and receive response over ws line
-     * This method abstract ws messages into request/response model
-     * @param method rpc method name
-     * @param params rpc method parameters
-     * @example
-     * ```typescript
-     * const response = await this.sendReceive('starknet_method', params);
-     * ```
+     * Sends a JSON-RPC request and returns a Promise that resolves with the result.
+     * This method abstracts the request/response cycle over WebSockets.
+     * If the connection is lost, it will queue the request and send it upon reconnection.
+     * @template T - The expected type of the result.
+     * @param {string} method - The RPC method name.
+     * @param {object} [params] - The parameters for the RPC method.
+     * @returns {Promise<T>} A Promise that resolves with the RPC response result.
+     * @throws {TimeoutError} If the request does not receive a response within the configured `requestTimeout`.
+     * @throws {WebSocketNotConnectedError} If the WebSocket is not connected and auto-reconnect is disabled.
      */
-    sendReceive<T extends keyof WebSocketMethods>(method: T, params?: WebSocketMethods[T]['params']): Promise<MessageEvent['data']['result'] | Error | Event>;
+    sendReceive<T = any>(method: string, params?: object): Promise<T>;
     /**
-     * Helper to check connection is open
+     * Checks if the WebSocket connection is currently open.
+     * @returns {boolean} `true` if the connection is open, `false` otherwise.
      */
     isConnected(): boolean;
     /**
-     * await while websocket is connected
-     * * could be used to block the flow until websocket is open
+     * Returns a Promise that resolves when the WebSocket connection is open.
+     * Can be used to block execution until the connection is established.
+     * @returns {Promise<number>} A Promise that resolves with the WebSocket's `readyState` when connected.
      * @example
      * ```typescript
-     * const readyState = await webSocketChannel.waitForConnection();
+     * const channel = new WebSocketChannel({ nodeUrl: '...' });
+     * await channel.waitForConnection();
+     * console.log('Connected!');
      * ```
      */
     waitForConnection(): Promise<typeof this$1.websocket.readyState>;
     /**
-     * Disconnect the WebSocket connection, optionally using code as the the WebSocket connection close code and reason as the the WebSocket connection close reason.
+     * Closes the WebSocket connection.
+     * This method is user-initiated and will prevent automatic reconnection for this closure.
+     * @param {number} [code] - The WebSocket connection close code.
+     * @param {string} [reason] - The WebSocket connection close reason.
      */
     disconnect(code?: number, reason?: string): void;
     /**
-     * await while websocket is disconnected
-     * @example
-     * ```typescript
-     * const readyState = await webSocketChannel.waitForDisconnection();
-     * ```
+     * Returns a Promise that resolves when the WebSocket connection is closed.
+     * @returns {Promise<number | Event>} A Promise that resolves with the WebSocket's `readyState` or a `CloseEvent` when disconnected.
      */
     waitForDisconnection(): Promise<typeof this$1.websocket.readyState | Event>;
     /**
-     * Unsubscribe from starknet subscription
-     * @param subscriptionId
-     * @param ref internal usage, only for managed subscriptions
+     * Unsubscribes from a Starknet subscription.
+     * It is recommended to use the `unsubscribe()` method on the `Subscription` object instead.
+     * @internal
+     * @param {SUBSCRIPTION_ID} subscriptionId - The ID of the subscription to unsubscribe from.
+     * @returns {Promise<boolean>} A Promise that resolves with `true` if the unsubscription was successful.
      */
-    unsubscribe(subscriptionId: SUBSCRIPTION_ID, ref?: string): Promise<boolean>;
+    unsubscribe(subscriptionId: SUBSCRIPTION_ID): Promise<boolean>;
     /**
-     * await while subscription is unsubscribed
-     * @param forSubscriptionId if defined trigger on subscriptionId else trigger on any
-     * @returns subscriptionId | onerror(Event)
+     * Returns a Promise that resolves when a specific subscription is successfully unsubscribed.
+     * @param {SUBSCRIPTION_ID} targetId - The ID of the subscription to wait for.
+     * @returns {Promise<void>}
      * @example
      * ```typescript
-     * const subscriptionId = await webSocketChannel.waitForUnsubscription();
+     * await channel.waitForUnsubscription(mySubscription.id);
+     * console.log('Successfully unsubscribed.');
      * ```
      */
-    waitForUnsubscription(forSubscriptionId?: SUBSCRIPTION_ID): Promise<unknown>;
+    waitForUnsubscription(targetId: SUBSCRIPTION_ID): Promise<void>;
     /**
-     * Reconnect re-create this.websocket instance
+     * Manually initiates a reconnection attempt.
+     * This creates a new WebSocket instance and re-establishes listeners.
      */
     reconnect(): void;
-    private reconnectAndUpdate;
+    private _processRequestQueue;
+    private _restoreSubscriptions;
+    private _startReconnect;
     private onCloseProxy;
     private onMessageProxy;
     /**
-     * subscribe to new block heads
-     * * you can subscribe to this event multiple times and you need to manage subscriptions manually
+     * Subscribes to new block headers.
+     * @param {SubscriptionBlockIdentifier} [blockIdentifier] - The block to start receiving notifications from. Defaults to 'latest'.
+     * @returns {Promise<Subscription<BLOCK_HEADER>>} A Promise that resolves with a `Subscription` object for new block headers.
      */
-    subscribeNewHeadsUnmanaged(blockIdentifier?: SubscriptionBlockIdentifier): Promise<SUBSCRIPTION_ID>;
+    subscribeNewHeads(blockIdentifier?: SubscriptionBlockIdentifier): Promise<Subscription<BLOCK_HEADER>>;
     /**
-     * subscribe to new block heads
+     * Subscribes to events matching a given filter.
+     * @param {BigNumberish} [fromAddress] - The contract address to filter by.
+     * @param {string[][]} [keys] - The event keys to filter by.
+     * @param {SubscriptionBlockIdentifier} [blockIdentifier] - The block to start receiving notifications from. Defaults to 'latest'.
+     * @returns {Promise<Subscription<EMITTED_EVENT>>} A Promise that resolves with a `Subscription` object for the specified events.
      */
-    subscribeNewHeads(blockIdentifier?: SubscriptionBlockIdentifier): Promise<string | false>;
+    subscribeEvents(fromAddress?: BigNumberish, keys?: string[][], blockIdentifier?: SubscriptionBlockIdentifier): Promise<Subscription<EMITTED_EVENT>>;
     /**
-     * Unsubscribe newHeads subscription
+     * Subscribes to status updates for a specific transaction.
+     * @param {BigNumberish} transactionHash - The hash of the transaction to monitor.
+     * @param {SubscriptionBlockIdentifier} [blockIdentifier] - The block context. Not typically required.
+     * @returns {Promise<Subscription<NEW_TXN_STATUS>>} A Promise that resolves with a `Subscription` object for the transaction's status.
      */
-    unsubscribeNewHeads(): Promise<boolean>;
+    subscribeTransactionStatus(transactionHash: BigNumberish, blockIdentifier?: SubscriptionBlockIdentifier): Promise<Subscription<NEW_TXN_STATUS>>;
     /**
-     * subscribe to 'starknet events'
-     * * you can subscribe to this event multiple times and you need to manage subscriptions manually
+     * Subscribes to pending transactions.
+     * @param {boolean} [transactionDetails] - If `true`, the full transaction details are included. Defaults to `false` (hash only).
+     * @param {BigNumberish[]} [senderAddress] - An array of sender addresses to filter by.
+     * @returns {Promise<Subscription<TXN_HASH | TXN_WITH_HASH>>} A Promise that resolves with a `Subscription` object for pending transactions.
      */
-    subscribeEventsUnmanaged(fromAddress?: BigNumberish, keys?: string[][], blockIdentifier?: SubscriptionBlockIdentifier): Promise<SUBSCRIPTION_ID>;
+    subscribePendingTransaction(transactionDetails?: boolean, senderAddress?: BigNumberish[]): Promise<Subscription<TXN_HASH$1 | TXN_WITH_HASH>>;
     /**
-     * subscribe to 'starknet events'
+     * Internal method to remove subscription from active map.
+     * @internal
      */
-    subscribeEvents(fromAddress?: BigNumberish, keys?: string[][], blockIdentifier?: SubscriptionBlockIdentifier): Promise<string | false>;
+    removeSubscription(id: SUBSCRIPTION_ID): void;
     /**
-     * Unsubscribe 'starknet events' subscription
+     * Adds a listener for a given event.
+     * @param event The event name.
+     * @param listener The listener function to add.
      */
-    unsubscribeEvents(): Promise<boolean>;
+    on<K extends keyof WebSocketChannelEvents>(event: K, listener: (data: WebSocketChannelEvents[K]) => void): void;
     /**
-     * subscribe to transaction status
-     * * you can subscribe to this event multiple times and you need to manage subscriptions manually
+     * Removes a listener for a given event.
+     * @param event The event name.
+     * @param listener The listener function to remove.
      */
-    subscribeTransactionStatusUnmanaged(transactionHash: BigNumberish, blockIdentifier?: SubscriptionBlockIdentifier): Promise<SUBSCRIPTION_ID>;
-    /**
-     * subscribe to transaction status
-     */
-    subscribeTransactionStatus(transactionHash: BigNumberish): Promise<string | false>;
-    /**
-     * unsubscribe 'transaction status' subscription
-     */
-    unsubscribeTransactionStatus(): Promise<boolean>;
-    /**
-     * subscribe to pending transactions (mempool)
-     * * you can subscribe to this event multiple times and you need to manage subscriptions manually
-     */
-    subscribePendingTransactionUnmanaged(transactionDetails?: boolean, senderAddress?: BigNumberish[]): Promise<SUBSCRIPTION_ID>;
-    /**
-     * subscribe to pending transactions (mempool)
-     */
-    subscribePendingTransaction(transactionDetails?: boolean, senderAddress?: BigNumberish[]): Promise<string | false>;
+    off<K extends keyof WebSocketChannelEvents>(event: K, listener: (data: WebSocketChannelEvents[K]) => void): void;
+}
+
+declare class CustomError extends Error {
+    name: string;
+    constructor(message?: string);
+}
+declare class LibraryError extends CustomError {
+}
+declare class RpcError<BaseErrorT extends RPC_ERROR = RPC_ERROR> extends LibraryError {
+    readonly baseError: BaseErrorT;
+    readonly request: {
+        method: string;
+        params: any;
+    };
+    constructor(baseError: BaseErrorT, method: string, params: any);
+    get code(): 1 | 31 | 10 | 66 | 20 | 32 | 21 | 24 | 27 | 28 | 29 | 33 | 34 | 40 | 41 | 42 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 67 | 68 | 100 | 150 | 151 | 153 | 154 | 155 | 156 | 157 | 158 | 159 | 160 | 163;
     /**
-     * unsubscribe 'pending transaction' subscription
+     * Verifies the underlying RPC error, also serves as a type guard for the _baseError_ property
+     * @example
+     * ```typescript
+     * SomeError.isType('UNEXPECTED_ERROR');
+     * ```
      */
-    unsubscribePendingTransaction(): Promise<boolean>;
+    isType<N extends keyof RPC_ERROR_SET, C extends RPC_ERROR_SET[N]['code']>(typeName: N): this is RpcError<RPC_ERROR_SET[N] & {
+        code: C;
+    }>;
+}
+/**
+ * Thrown when a WebSocket request does not receive a response within the configured timeout period.
+ * @property {string} name - The name of the error, always 'TimeoutError'.
+ */
+declare class TimeoutError extends LibraryError {
+    constructor(message: string);
+}
+/**
+ * Thrown when an operation is attempted on a WebSocket that is not connected.
+ * @property {string} name - The name of the error, always 'WebSocketNotConnectedError'.
+ */
+declare class WebSocketNotConnectedError extends LibraryError {
+    constructor(message: string);
 }
 
 declare abstract class ResponseParser {
@@ -2958,34 +3090,6 @@ declare const RpcProvider_base: ts_mixer_dist_types_types.Class<any[], RpcProvid
 declare class RpcProvider extends RpcProvider_base {
 }
 
-declare function fixStack(target: Error, fn?: Function): void;
-declare function fixProto(target: Error, prototype: {}): void;
-declare class CustomError extends Error {
-    name: string;
-    constructor(message?: string);
-}
-declare class LibraryError extends CustomError {
-}
-declare class RpcError<BaseErrorT extends RPC_ERROR = RPC_ERROR> extends LibraryError {
-    readonly baseError: BaseErrorT;
-    readonly request: {
-        method: string;
-        params: any;
-    };
-    constructor(baseError: BaseErrorT, method: string, params: any);
-    get code(): 1 | 31 | 10 | 66 | 20 | 32 | 21 | 24 | 27 | 28 | 29 | 33 | 34 | 40 | 41 | 42 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 67 | 68 | 100 | 150 | 151 | 153 | 154 | 155 | 156 | 157 | 158 | 159 | 160 | 163;
-    /**
-     * Verifies the underlying RPC error, also serves as a type guard for the _baseError_ property
-     * @example
-     * ```typescript
-     * SomeError.isType('UNEXPECTED_ERROR');
-     * ```
-     */
-    isType<N extends keyof RPC_ERROR_SET, C extends RPC_ERROR_SET[N]['code']>(typeName: N): this is RpcError<RPC_ERROR_SET[N] & {
-        code: C;
-    }>;
-}
-
 declare const defaultProvider: RpcProvider$1;
 
 declare abstract class SignerInterface {
@@ -8009,4 +8113,4 @@ declare class Logger {
  */
 declare const logger: Logger;
 
-export { type Abi, type AbiEntry, type AbiEnum, type AbiEnums, type AbiEvent, type AbiEvents, type AbiInterfaces, type AbiStruct, type AbiStructs, Account, AccountInterface, type AccountInvocationItem, type AccountInvocations, type AccountInvocationsFactoryDetails, type AllowArray, type Args, type ArgsOrCalldata, type ArgsOrCalldataWithOptions, type ArraySignatureType, type AsyncContractFunction, type BLOCK_HASH, type BLOCK_NUMBER, BatchClient, type BatchClientOptions, type BigNumberish, type Block$1 as Block, type BlockIdentifier, type BlockNumber, BlockStatus, BlockTag, type BlockWithTxHashes, type Builtins, type ByteArray, type ByteCode, type CairoAssembly, type CairoContract, CairoCustomEnum, type CairoEnum, type CairoEnumRaw, type CairoEvent, type CairoEventDefinition, type CairoEventVariant, CairoFixedArray, CairoOption, CairoOptionVariant, CairoResult, CairoResultVariant, CairoUint256, CairoUint512, type CairoVersion, type Call, type CallContractResponse, CallData, type CallDetails, type CallOptions, type Calldata, type CompiledContract, type CompiledSierra, type CompiledSierraCasm, type CompilerVersion, type CompleteDeclareContractPayload, type CompressedProgram, Contract, type ContractClass, type ContractClassIdentifier, type ContractClassPayload, type ContractClassResponse, type ContractEntryPointFields, ContractFactory, type ContractFactoryParams, type ContractFunction, ContractInterface, type ContractOptions, type ContractVersion, CustomError, type DeclareAndDeployContractPayload, type DeclareContractPayload, type DeclareContractResponse, type DeclareContractTransaction, type DeclareDeployUDCResponse, type DeclareSignerDetails, type DeclareTransactionReceiptResponse, type DeclaredTransaction, type DeployAccountContractPayload, type DeployAccountContractTransaction, type DeployAccountSignerDetails, type DeployAccountTransactionReceiptResponse, type DeployAndInvokeTransaction, type DeployContractResponse, type DeployContractUDCResponse, type DeployTransaction, type DeployTransactionReceiptResponse, type DeployedAccountTransaction, type Details, EDAMode, EDataAvailabilityMode, ETH_ADDRESS, ETransactionExecutionStatus, ETransactionStatus, ETransactionVersion, ETransactionVersion2, ETransactionVersion3, type EVENTS_CHUNK, type EmittedEvent, EntryPointType, type EntryPointsByType, type EstimateFee, type EstimateFeeAction, type EstimateFeeBulk, type EstimateFeeDetails, type EstimateFeeResponse, type EstimateFeeResponseBulk, EthSigner, type Event$1 as Event, type EventEntry, type EventFilter, type ExecutableDeployAndInvokeTransaction, type ExecutableDeployTransaction, type ExecutableInvokeTransaction, type ExecutableUserInvoke, type ExecutableUserTransaction, type ExecutionParameters, type FEE_ESTIMATE, type FELT, type FeeEstimate, type FeeMarginPercentage, type FeeMode, type FunctionAbi, type GetBlockResponse, type GetTransactionReceiptResponse, type GetTransactionResponse, type GetTxReceiptResponseWithoutHelper, type HexCalldata, type Hint, type InterfaceAbi, type Invocation, type Invocations, type InvocationsDetails, type InvocationsDetailsWithNonce, type InvocationsSignerDetails, type InvokeFunctionResponse, type InvokeOptions, type InvokeTransaction, type InvokeTransactionReceiptResponse, type InvokedTransaction, type L1HandlerTransactionReceiptResponse, type L1Message, type L1_HANDLER_TXN, type LedgerPathCalculation, LedgerSigner111 as LedgerSigner, LedgerSigner111, LedgerSigner221, LedgerSigner231, type LegacyCompiledContract, type LegacyContractClass, type LegacyEvent, LibraryError, Literal, type LogLevel, LogLevelIndex, type Methods, type MultiDeployContractResponse, type MultiType, NON_ZERO_PREFIX, type Nonce, type OptionalPayload, type OutsideCall, type OutsideExecution, type OutsideExecutionOptions, OutsideExecutionTypesV1, OutsideExecutionTypesV2, OutsideExecutionVersion, type OutsideTransaction, type PENDING_DECLARE_TXN_RECEIPT, type PENDING_DEPLOY_ACCOUNT_TXN_RECEIPT, type PENDING_INVOKE_TXN_RECEIPT, type PENDING_L1_HANDLER_TXN_RECEIPT, type PENDING_STATE_UPDATE, type PRICE_UNIT, type ParsedEvent, type ParsedEvents, type ParsedStruct, type PaymasterDetails, type PaymasterFeeEstimate, PaymasterInterface, type PaymasterOptions, PaymasterRpc, type PaymasterRpcOptions, type PaymasterTimeBounds, type PendingBlock, type PendingReceipt, type PendingStateUpdate, type PreparedDeployAndInvokeTransaction, type PreparedDeployTransaction, type PreparedInvokeTransaction, type PreparedTransaction, type Program, RpcProvider as Provider, ProviderInterface, type ProviderOptions, type PythonicHints, type RESOURCE_PRICE, index$4 as RPC, rpc_0_7_1 as RPC07, rpc_0_8_1 as RPC08, RPCResponseParser, type RPC_ERROR, type RPC_ERROR_SET, type RawArgs, type RawArgsArray, type RawArgsObject, type RawCalldata, type Receipt, ReceiptTx, type RequiredKeysOf, type ResourceBounds, type ResourceBoundsOverhead, type ResourceBoundsOverheadRPC07, type ResourceBoundsOverheadRPC08, ResponseParser, type Result, type RevertedTransactionReceiptResponse, RpcChannel, RpcError, RpcProvider, type RpcProviderOptions, type SIMULATION_FLAG, type STATE_UPDATE, type SierraContractClass, type SierraContractEntryPointFields, type SierraEntryPointsByType, type SierraProgramDebugInfo, type Signature, Signer, SignerInterface, type Simplify, type SimulateTransaction, type SimulateTransactionDetails, type SimulateTransactionResponse, type SimulatedTransaction, type SimulationFlags, type StarkProfile, type StateUpdate, type StateUpdateResponse, type Storage, type SubscriptionBlockIdentifier, type SuccessfulTransactionReceiptResponse, type TRANSACTION_TRACE, type TXN_EXECUTION_STATUS, type TXN_HASH, type TXN_STATUS, type TokenData, TransactionExecutionStatus, TransactionFinalityStatus, type TransactionReceipt, type TransactionReceiptCallbacks, type TransactionReceiptCallbacksDefault, type TransactionReceiptCallbacksDefined, type TransactionReceiptStatus, type TransactionReceiptValue, type TransactionStatus, type TransactionStatusReceiptSets, TransactionType, type TransactionWithHash, type Tupled, type TypedContractV2, UINT_128_MAX, UINT_128_MIN, UINT_256_HIGH_MAX, UINT_256_HIGH_MIN, UINT_256_LOW_MAX, UINT_256_LOW_MIN, UINT_256_MAX, UINT_256_MIN, UINT_512_MAX, UINT_512_MIN, Uint, type Uint256, type Uint512, type UniversalDeployerContractPayload, type UniversalDetails, type UniversalSuggestedFee, type UserInvoke, type UserTransaction, type V2DeclareSignerDetails, type V2DeployAccountSignerDetails, type V2InvocationsSignerDetails, type V3DeclareSignerDetails, type V3DeployAccountSignerDetails, type V3InvocationsSignerDetails, type V3TransactionDetails, ValidateType, WSSubscriptions, WalletAccount, WebSocketChannel, type WebSocketOptions, type WeierstrassSignatureType, addAddressPadding, byteArray, cairo, config, constants, contractClassResponseToLegacyCompiledContract, defaultPaymaster, defaultProvider, ec, encode, eth, index as events, extractContractHashes, fixProto, fixStack, getCalldata, getChecksumAddress, type getContractVersionOptions, type getEstimateFeeBulkOptions, getLedgerPathBuffer111 as getLedgerPathBuffer, getLedgerPathBuffer111, getLedgerPathBuffer221, type getSimulateTransactionOptions, index$2 as hash, isPendingBlock, isPendingStateUpdate, isPendingTransaction, isRPC08_FeeEstimate, isRPC08_ResourceBounds, isSierra, isSupportedSpecVersion, isV3Tx, isVersion, json, logger, merkle, num, outsideExecution, parseCalldataField, paymaster, provider, selector, shortString, src5, index$1 as stark, starknetId, toAnyPatchVersion, transaction, typedData, index$3 as types, uint256$1 as uint256, units, v2 as v2hash, v3 as v3hash, validateAndParseAddress, validateChecksumAddress, type waitForTransactionOptions, connect as wallet };
+export { type Abi, type AbiEntry, type AbiEnum, type AbiEnums, type AbiEvent, type AbiEvents, type AbiInterfaces, type AbiStruct, type AbiStructs, Account, AccountInterface, type AccountInvocationItem, type AccountInvocations, type AccountInvocationsFactoryDetails, type AllowArray, type Args, type ArgsOrCalldata, type ArgsOrCalldataWithOptions, type ArraySignatureType, type AsyncContractFunction, type BLOCK_HASH, type BLOCK_NUMBER, BatchClient, type BatchClientOptions, type BigNumberish, type Block$1 as Block, type BlockIdentifier, type BlockNumber, BlockStatus, BlockTag, type BlockWithTxHashes, type Builtins, type ByteArray, type ByteCode, type CairoAssembly, type CairoContract, CairoCustomEnum, type CairoEnum, type CairoEnumRaw, type CairoEvent, type CairoEventDefinition, type CairoEventVariant, CairoFixedArray, CairoOption, CairoOptionVariant, CairoResult, CairoResultVariant, CairoUint256, CairoUint512, type CairoVersion, type Call, type CallContractResponse, CallData, type CallDetails, type CallOptions, type Calldata, type CompiledContract, type CompiledSierra, type CompiledSierraCasm, type CompilerVersion, type CompleteDeclareContractPayload, type CompressedProgram, Contract, type ContractClass, type ContractClassIdentifier, type ContractClassPayload, type ContractClassResponse, type ContractEntryPointFields, ContractFactory, type ContractFactoryParams, type ContractFunction, ContractInterface, type ContractOptions, type ContractVersion, type DeclareAndDeployContractPayload, type DeclareContractPayload, type DeclareContractResponse, type DeclareContractTransaction, type DeclareDeployUDCResponse, type DeclareSignerDetails, type DeclareTransactionReceiptResponse, type DeclaredTransaction, type DeployAccountContractPayload, type DeployAccountContractTransaction, type DeployAccountSignerDetails, type DeployAccountTransactionReceiptResponse, type DeployAndInvokeTransaction, type DeployContractResponse, type DeployContractUDCResponse, type DeployTransaction, type DeployTransactionReceiptResponse, type DeployedAccountTransaction, type Details, EDAMode, EDataAvailabilityMode, ETH_ADDRESS, ETransactionExecutionStatus, ETransactionStatus, ETransactionVersion, ETransactionVersion2, ETransactionVersion3, type EVENTS_CHUNK, type EmittedEvent, EntryPointType, type EntryPointsByType, type EstimateFee, type EstimateFeeAction, type EstimateFeeBulk, type EstimateFeeDetails, type EstimateFeeResponse, type EstimateFeeResponseBulk, EthSigner, type Event$1 as Event, type EventEntry, type EventFilter, type ExecutableDeployAndInvokeTransaction, type ExecutableDeployTransaction, type ExecutableInvokeTransaction, type ExecutableUserInvoke, type ExecutableUserTransaction, type ExecutionParameters, type FEE_ESTIMATE, type FELT, type FeeEstimate, type FeeMarginPercentage, type FeeMode, type FunctionAbi, type GetBlockResponse, type GetTransactionReceiptResponse, type GetTransactionResponse, type GetTxReceiptResponseWithoutHelper, type HexCalldata, type Hint, type InterfaceAbi, type Invocation, type Invocations, type InvocationsDetails, type InvocationsDetailsWithNonce, type InvocationsSignerDetails, type InvokeFunctionResponse, type InvokeOptions, type InvokeTransaction, type InvokeTransactionReceiptResponse, type InvokedTransaction, type L1HandlerTransactionReceiptResponse, type L1Message, type L1_HANDLER_TXN, type LedgerPathCalculation, LedgerSigner111 as LedgerSigner, LedgerSigner111, LedgerSigner221, LedgerSigner231, type LegacyCompiledContract, type LegacyContractClass, type LegacyEvent, LibraryError, Literal, type LogLevel, LogLevelIndex, type Methods, type MultiDeployContractResponse, type MultiType, NON_ZERO_PREFIX, type Nonce, type OptionalPayload, type OutsideCall, type OutsideExecution, type OutsideExecutionOptions, OutsideExecutionTypesV1, OutsideExecutionTypesV2, OutsideExecutionVersion, type OutsideTransaction, type PENDING_DECLARE_TXN_RECEIPT, type PENDING_DEPLOY_ACCOUNT_TXN_RECEIPT, type PENDING_INVOKE_TXN_RECEIPT, type PENDING_L1_HANDLER_TXN_RECEIPT, type PENDING_STATE_UPDATE, type PRICE_UNIT, type ParsedEvent, type ParsedEvents, type ParsedStruct, type PaymasterDetails, type PaymasterFeeEstimate, PaymasterInterface, type PaymasterOptions, PaymasterRpc, type PaymasterRpcOptions, type PaymasterTimeBounds, type PendingBlock, type PendingReceipt, type PendingStateUpdate, type PreparedDeployAndInvokeTransaction, type PreparedDeployTransaction, type PreparedInvokeTransaction, type PreparedTransaction, type Program, RpcProvider as Provider, ProviderInterface, type ProviderOptions, type PythonicHints, type RESOURCE_PRICE, index$4 as RPC, rpc_0_7_1 as RPC07, rpc_0_8_1 as RPC08, RPCResponseParser, type RPC_ERROR, type RPC_ERROR_SET, type RawArgs, type RawArgsArray, type RawArgsObject, type RawCalldata, type Receipt, ReceiptTx, type RequiredKeysOf, type ResourceBounds, type ResourceBoundsOverhead, type ResourceBoundsOverheadRPC07, type ResourceBoundsOverheadRPC08, ResponseParser, type Result, type RevertedTransactionReceiptResponse, RpcChannel, RpcError, RpcProvider, type RpcProviderOptions, type SIMULATION_FLAG, type STATE_UPDATE, type SierraContractClass, type SierraContractEntryPointFields, type SierraEntryPointsByType, type SierraProgramDebugInfo, type Signature, Signer, SignerInterface, type Simplify, type SimulateTransaction, type SimulateTransactionDetails, type SimulateTransactionResponse, type SimulatedTransaction, type SimulationFlags, type StarkProfile, type StateUpdate, type StateUpdateResponse, type Storage, Subscription, type SubscriptionBlockIdentifier, type SuccessfulTransactionReceiptResponse, type TRANSACTION_TRACE, type TXN_EXECUTION_STATUS, type TXN_HASH, type TXN_STATUS, TimeoutError, type TokenData, TransactionExecutionStatus, TransactionFinalityStatus, type TransactionReceipt, type TransactionReceiptCallbacks, type TransactionReceiptCallbacksDefault, type TransactionReceiptCallbacksDefined, type TransactionReceiptStatus, type TransactionReceiptValue, type TransactionStatus, type TransactionStatusReceiptSets, TransactionType, type TransactionWithHash, type Tupled, type TypedContractV2, UINT_128_MAX, UINT_128_MIN, UINT_256_HIGH_MAX, UINT_256_HIGH_MIN, UINT_256_LOW_MAX, UINT_256_LOW_MIN, UINT_256_MAX, UINT_256_MIN, UINT_512_MAX, UINT_512_MIN, Uint, type Uint256, type Uint512, type UniversalDeployerContractPayload, type UniversalDetails, type UniversalSuggestedFee, type UserInvoke, type UserTransaction, type V2DeclareSignerDetails, type V2DeployAccountSignerDetails, type V2InvocationsSignerDetails, type V3DeclareSignerDetails, type V3DeployAccountSignerDetails, type V3InvocationsSignerDetails, type V3TransactionDetails, ValidateType, WalletAccount, WebSocketChannel, WebSocketNotConnectedError, type WebSocketOptions, type WeierstrassSignatureType, addAddressPadding, byteArray, cairo, config, constants, contractClassResponseToLegacyCompiledContract, defaultPaymaster, defaultProvider, ec, encode, eth, index as events, extractContractHashes, getCalldata, getChecksumAddress, type getContractVersionOptions, type getEstimateFeeBulkOptions, getLedgerPathBuffer111 as getLedgerPathBuffer, getLedgerPathBuffer111, getLedgerPathBuffer221, type getSimulateTransactionOptions, index$2 as hash, isPendingBlock, isPendingStateUpdate, isPendingTransaction, isRPC08_FeeEstimate, isRPC08_ResourceBounds, isSierra, isSupportedSpecVersion, isV3Tx, isVersion, json, logger, merkle, num, outsideExecution, parseCalldataField, paymaster, provider, selector, shortString, src5, index$1 as stark, starknetId, toAnyPatchVersion, transaction, typedData, index$3 as types, uint256$1 as uint256, units, v2 as v2hash, v3 as v3hash, validateAndParseAddress, validateChecksumAddress, type waitForTransactionOptions, connect as wallet };