Messaging Overview
HyperNova’s message-passing layer is open to any application, not only the Token Bridge. An application posts a message on the source chain. A contract or module of the same application verifies the message on the destination chain and acts on it. HyperNova establishes that the message was posted, and the application defines what the message means.
Use Messaging to build cross-chain applications such as governance relays, cross-chain calls or state synchronization. The Token Bridge and iAssets are both built this way. See Architecture.
How a message travels
- Post. The application calls the message-passing layer on the source chain with an opaque payload and a destination chain ID. Posting is free. The layer emits a message event that records the caller, a message identifier, the destination and the payload.
- Relay. A relayer submits the message event and its proof bundle to the application’s own entry point on the destination chain.
- Verify. The application passes the proof to the verifier on the destination chain and pays the verification fee. The verifier checks the source chain’s consensus and that the message-passing layer emitted the event.
- Consume. The application checks who posted the message, makes sure it has not processed it before, decodes the payload and acts on it.
SupraNova’s relayers deliver Token Bridge transfers only. Your application must run its own relayer, or arrange for one, to deliver its messages. Relaying is permissionless. See Relay a Message.
Directions and functions
Messages travel only in registered directions. See Supported Networks.
| Direction | Post on the source chain | Verify on the destination chain |
|---|---|---|
| Ethereum → SupraMVM | Hypernova.postMessage on Ethereum | proof_verifier::process_data_optimistic_or_safe or process_data_finality in hypernova_core |
| SupraMVM → EVM chain (Ethereum, SupraEVM) | hypernova_core_from_supra::post_message | Hypernova.verifyMessagePostedOnSupra on the EVM chain |
| SupraEVM → SupraMVM | Hypernova.postMessage on SupraEVM | supra_hypernova_core on SupraMVM |
On Testnet, use the _v2 functions in hypernova_core for messages from Ethereum. The _v2 functions accept the Gloas proof format.
What your application must check
The verifier proves that a message was posted on the source chain. Your application decides whether to act on it.
On EVM chains, Hypernova also checks the destination, the sender and replay. On SupraMVM, hypernova_core checks none of the three, so a module that receives messages from Ethereum must check them itself. Security Best Practices lists every check and who performs it.
Fees
Posting a message is free. Verifying it costs the verification fee of the destination chain’s verifier. Whoever calls the verifier pays the fee.
On EVM chains, the caller pays it in native currency as the transaction value. On SupraMVM, the calling account pays it in SUPRA. See Fees.