Bridge App

Technical Overview

While Most Bridge uses advanced technology under the hood, which you can read more about in the other pages, here's a high-level overview of how the bridge works:

Key Components

  1. Escrow Contract: Securely holds user funds on the source chain and coordinates proof verification and withdrawals.

  2. Hook Executor: An temporary contract deployed by Escrow to execute pre-bridge swaps (hooks) so MMs are not exposed to token volatility.

  3. Payment Registry: Records fulfillments and transfers funds to users on the destination chain.

  4. Market Makers: Facilitate fast delivery of assets to the destination chain.

  5. HDP Module: Verifies, in a cryptographically sound way, that destination-chain fulfillments occurred.

  6. Operator Service: The glue connecting the UI, smart contracts, backend, and HDP.

How It All Works Together

  1. You initiate a bridge transaction. Optionally, Escrow deploys a Hook Executor to swap your ERC20 into a target token before locking it.

  2. A Market Maker fulfills your intent by sending funds to your destination address on the destination chain.

  3. The Payment Registry records the fulfillment (emits FulfillmentReceipt) and marks it in the fulfillments mapping.

  4. On the source chain, Escrow verifies the fulfillments via the HDP Module (aggregated proof) and then releases funds.

  5. The Market Maker receives the locked funds on the source chain.

This process happens quickly and securely, allowing you to receive your assets on the destination chain in seconds.

Security Measures

Most Bridge prioritizes the security of your assets:

  • Funds are locked in Escrow until the Payment Registry fulfillment is proven via HDP.

  • Pre-bridge swaps are executed in a temporary Hook Executor with atomic execution, minimizing MM volatility exposure.

  • The design emphasizes simplicity, audited libraries (OpenZeppelin), and security checks.

What If Something Goes Wrong?

If your intent isn't fulfilled before its expiry window:

  • Your funds remain safely locked in the Escrow Contract.

  • After the expiry window you set, you can reclaim your funds from the Escrow Contract.

This ensures that your assets are either successfully bridged or returnable to you, at all times.

PreviousTutorialNextKey Components

Last updated