Skip to content
LogoLogo

Withdrawal Lifecycle

The lifecycle of a withdrawal operation

SourceTxDiscovered

This is the initial state of an operation, created when a withdrawal transfer is discovered in a Hyperliquid block. A withdrawal is a Hyperliquid transfer to a Unit withdrawal address that meets the asset's minimum amount.

Once a sourceTx is discovered, the withdrawal operation goes through validation, which includes checks for sanctioned addresses.

WaitForSrcTxFinalization

The guardians wait for the Hyperliquid source transfer to meet the required confirmations before placing the withdrawal in the queue.

ReadyForWithdrawQueue

Destination transactions are staged in the withdraw queue and processed in batches. This adds a separate wait after source finalization and before the destination transfer is broadcast.

The operation's positionInWithdrawQueue may be used to inform the expected completion of this state.

QueuedForWithdraw

The operation has been included in a withdraw queue batch, the tx-hash of which corresponds to the tx-hash returned by the withdraw queue endpoint and can be inspected on any explorer for the destination network.

Done

The withdrawal is finalized on the destination network. The operation's state is officially "done" - this state is terminal.