TODO(#16601) Make this method private once PerformUnlessClosing doesn't need it any more

Add a new traffic purchased entry to the store and the cache. TrafficPurchased with a serial less or equal to the most recent one will be ignored. Together with tick, this method expects to be called sequentially with balances in increasing order of sequencingTimestamp. This method MUST NOT be called concurrently.

Blocks until all earlier tasks have completed and then prevents further tasks from being run.

Return the traffic purchased entry valid at the given timestamp for the given member. TrafficPurchased are cached in this class, according to the cache size defined in trafficConfig. Requesting balances for timestamps outside of the cache will trigger a lookup in the database. The balances in this class are updated after they've been processed and validated by the sequencer client, however they can be queried on the sequencer read path. To avoid providing incorrect balance values while balance updates are "in-flight" (as in being processed by the sequencer client), the parameter lastSeen0 can be provided. This parameter indicates to the function the youngest timestamp for which the caller thinks a balance update might have been sequenced. This allows this function to compare this timestamp with the internal state, and if necessary, wait for the potential update before providing the balance. Note that if requesting a traffic purchased entry at a timestamp that has already been pruned, the function will return an error.

Initializes the traffic manager lastUpdateAt with the initial timestamp from the store if it's not already set. Call before using the manager.

Check whether we're closing. Susceptible to race conditions; unless you're using this as a flag to the retry lib or you really know what you're doing, prefer performUnlessClosing and friends.

Set this to true to get detailed information about all futures that did not complete during shutdown.

How often to poll to check that all tasks have completed.

Use this method to create a PromiseUnlessShutdown that will automatically be cancelled when the close context is closed. This allows proper clean up of stray promises when the node is transitioning to a passive state.

Note: you should *not* invoke success on the returned promise but rather use trySuccess. The reason is that the call to success may fail in case of shutdown.

Blocks until all earlier tasks have completed and then prevents further tasks from being run.

Performs the task given by f unless a shutdown has been initiated. The shutdown will only begin after f completes, but other tasks may execute concurrently with f, if started using this function, or one of the other variants (performUnlessClosingF and performUnlessClosingEitherT). The tasks are assumed to take less than closingTimeout to complete.

DO NOT CALL this.close as part of f, because it will result in a deadlock. DO NOT PUT retries, especially indefinite ones, inside f.

Performs the EitherT[Future] given by etf unless a shutdown has been initiated, in which case the provided error is returned instead. Both etf and the error are lazy; etf is only evaluated if there is no shutdown, the error only if we're shutting down. The shutdown will only begin after etf completes, but other tasks may execute concurrently with etf, if started using this function, or one of the other variants (performUnlessClosing and performUnlessClosingF). The tasks are assumed to take less than closingTimeout to complete.

DO NOT CALL this.close as part of etf, because it will result in a deadlock. DO NOT PUT retries, especially indefinite ones, inside f.

Use this method if closing/shutdown of the object should wait for asynchronous computation to finish too.

Performs the Future given by f unless a shutdown has been initiated. The future is lazy and not evaluated during shutdown. The shutdown will only begin after f completes, but other tasks may execute concurrently with f, if started using this function, or one of the other variants (performUnlessClosing and performUnlessClosingEitherT). The tasks are assumed to take less than closingTimeout to complete.

DO NOT CALL this.close as part of f, because it will result in a deadlock. DO NOT PUT retries, especially indefinite ones, inside f.

Use this method if closing/shutdown of the object should wait for asynchronous computation to finish too.

TODO(#16601) Make this method private once PerformUnlessClosing doesn't need it any more

Schedules the given task to be run upon closing.

Register a task to run when closing is initiated, or run it immediately if closing is already ongoing. Unlike runOnClose, this method does not guarantee that this task will have run by the time the LifeCycleManager's closeAsync method completes or AutoCloseable's close returns. This is because the task is run immediately if the component has already been closed.

Variant of runOnOrAfterClose that does not return a com.digitalasset.canton.lifecycle.LifeCycleRegistrationHandle.

Notify this class that the provided timestamp has been observed by the sequencer client. Together with addTrafficPurchased, this method is expected to be called sequentially with increasing timestamps.

Runs the computation fa unless isClosing returns true.

This method does not delay the closing while fa is running, unlike the methods in HasSynchronizeWithClosing. Accordingly, this method is useful for intermittent checks whether the result of the computation is still relevant.