Recover a Transfer
A delayed transfer is not cancelled. The asset stays locked or burned on the source chain, and the transfer waits until someone delivers it. If a transfer stays at Transfer Initiated for longer than expected, find out why, and deliver it yourself if no relayer does. Relaying is permissionless, and the account that delivers a transfer receives its relayer reward.
Check that the transfer is not delivered
Follow the transfer on both chains, as described in Track a Transfer. If the destination chain already records the message as processed, the transfer is complete.
Find the cause
| Cause | How to check | What to do |
|---|---|---|
| The block is not yet verifiable | For a transfer from Ethereum, compare the time since the transfer with the Token Bridge’s verification strategy. See Finality. | Wait. A relayer can deliver a transfer from SupraMVM as soon as its block is certified. |
| The destination verifier’s committee is out of date | On an EVM chain, compare latestSupraCommitteeEpoch() on Hypernova with the current Supra epoch. On SupraMVM, compare the Sync Committee period of get_update_slot on hypernova_core (the slot divided by 8,192) with Ethereum’s current period. See Committee Updaters. | Wait for a committee update, or submit one. Committee updates are permissionless. |
| A contract or module is paused | Delivery reverts with a pause error. See Troubleshooting. | Wait until the admin resumes it. |
| No relayer has delivered the transfer | None of the above applies, and the transfer is still not delivered. | Deliver the transfer yourself, as described in the next step. |
Deliver the transfer
Build the proof bundle and submit it to the Token Bridge on the destination chain, as described in Relay a Message:
| Direction | Submit to | Fee |
|---|---|---|
| SupraMVM → EVM chain | receiveTokensFromSupra on the TokenBridge proxy. See From SupraMVM to an EVM chain. | sourceEnabledChainVerificationFee of Hypernova, as the transaction value |
| Ethereum → SupraMVM | execute_optimistic_or_safe or execute_finality on token_bridge_service, whichever matches the stored strategy, or their _v2 versions on Testnet. See From Ethereum to SupraMVM. | get_fee_per_verification of hypernova_core, charged in SUPRA to the signing account |
The recipient receives the transfer as if a SupraNova relayer had delivered it. Your account receives the relayer reward in the same transaction.
Delivering a transfer from SupraEVM to SupraMVM yourself, through receive_tokens_from_sevm, is not yet covered in these docs.
If a transfer cannot be delivered after these steps, contact Supra through the Support Portal with the source transaction hash and the message ID.
Related
- Track a Transfer
- Relayers — the Token Bridge’s entry points and relayer rewards
- Troubleshooting