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.

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.

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.

Runs the computation f only if the component is not yet closing. If so, the component will delay releasing its resources until f has completed (as defined by the com.digitalasset.canton.util.Thereafter instance) or the synchronizeWithClosingPatience has elapsed.

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.

Convenience method for synchronizing on Futures instead of FutureUnlessShutdowns. Equivalent to

synchronizeWithClosing(name)(FutureUnlessShutdown.outcomeF(f))

Runs the computation f only if the component is not yet closing. If so, the component will delay releasing its resources until f has finished or the synchronizeWithClosingPatience has elapsed.

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.

Runs the computation f only if the component is not yet closing. If so, the component will delay releasing its resources until f has completed (as defined by the com.digitalasset.canton.util.Thereafter instance) or the synchronizeWithClosingPatience has elapsed.

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.

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.