Deposit Lifecycle
The lifecycle of a deposit operation
SourceTxDiscovered
This is the initial state of an operation, which is created when a deposit is discovered in a block. A deposit is identified as follows:
The transfer must meet the asset's minimum amount. The supported-asset table is the minimum-amount reference for this lifecycle.
- A Bitcoin deposit is a transaction output to a Unit deposit address.
- An Ethereum deposit is an ETH transfer from an EOA or contract to a Unit deposit address. Each deposit corresponds to a trace.
- A Solana deposit is a SOL or supported SPL-token transfer to a Unit deposit address.
Once a sourceTx is discovered, the deposit operation goes through validation, which includes checks for sanctioned addresses.
WaitForSrcTxFinalization
A transaction has one confirmation when it is included in a block on the source blockchain. Each additional block adds a confirmation. The guardians wait for the source network's required confirmations before building the Hyperliquid transfer.
Discovery and operation creation happen before this finalization stage. The Operations API reports the current state and confirmation progress.
BuildingDstTx
The guardians are constructing the Hyperliquid transaction payload to fulfill the deposit.
BroadcastTx
The guardian network is submitting the destination transaction to the Hyperliquid network.
WaitForDstTxFinalization
The guardians wait for the Hyperliquid destination transfer to meet the required confirmations. Follow the operation state to determine when finalization is complete.

