Bridging Flow
Last updated
This section explains how to use the SupraNova Bridge dApp to bridge ETH from Ethereum to wETH on Supra network, with each technical stage explained clearly.
Before initiating a bridge transaction, you must connect two wallets:
Wallet
Purpose
MetaMask (Ethereum) or any source wallet
To send the ETH and sign the bridge transaction
Supra Wallet
To receive the wrappedETH (wETH) minted on Supra
Open the SupraNova Bridge dApp.
Click “Connect Wallet” on the top right corner.
Approve the MetaMask pop-up to connect your Ethereum wallet.
Choose your Supra Wallet (StarKey Wallet) or manually enter a recipient address using the “Type Recipient Address” toggle.
The Supra Wallet is where your minted wETH will arrive after successful bridging.
Make sure the address is correct before proceeding.
After wallets are connected, follow these steps.
Under the Bridge tab, select:
Source Chain: Ethereum
Destination Chain: Supra
Token: ETH –> wETH
Enter the amount of ETH you wish to bridge.
Review:
Estimated bridge time
Bridge fee breakdown (in ETH and $SUPRA)
Click “Confirm” to proceed.
After the bridge event is emitted, The Event Listener captures the bridge event from the ethereum chain and stores it in a message queue. The Relayer Driver then consumes the event. detects the bridge event from the Ethereum chain.
It generates the following proofs:
Sync Committee Proof – Block signed by the Sync Committee
Receipt Proof – Proof that the transaction succeeded
Ancestry Proof (if the block lacks enough signatures)
Ethereum Event → Relayer captures → Builds Proof Bundle → Prepares Submission to Supra
Once proofs are generated:
The Relayer submits the proof bundle to Supra’s HyperNovaCore verifier smart contract.
The verifier checks:
Validity of the block header signatures
Correctness of transaction existence and execution
Authenticity of the event data (right source, token, amount, recipient) If all checks pass, the verifier marks the bridge request as valid.
Upon successful verification:
The Token Bridge Service Contract is triggered.
Wrapped ETH (wETH) is minted on Supra in a 1:1 ratio to the locked ETH.
The minted wETH is sent to your connected (or specified) Supra Wallet address.
You can now:
View transaction history under Explorer > My Transactions.
Stage
System Action
User Action
Wallet Connection
Connect MetaMask and Supra Wallet
Click Connect Wallet
Initiate Bridge
Lock ETH on Ethereum
Enter Amount, Confirm
Event Emission
Emit bridge request log
Wait
Relayer Proofs
Generate, Sync , Receipt, Ancestry proofs
Wait
Supra Verification
Validate proofs on-chain
Monitor Explore
Token Min
Mint wETH to recipient wallet
Receive tokens
During Bridging these are the in-built safeguards:
Incomplete Proofs: Bridge request remains pending until sufficient proofs arrive.
Relayer Failure: Another permissionless relayer can submit the proof.
Committee Key Rotation: If Sync Committee public keys expire, Committee Updater submits fresh keys to Supra automatically.