Files
linea-monorepo/contracts/docs/workflows/messaging/canonicalL2ToL1Messaging.md
The Dark Jester f48431ac5c [Chore] Document contract interaction (#926)
* placeholder docs

* adding more documentation

* documentation work in progress

* add main linking or index documents

* add a link images

* add messaging flows

* linking operator documentation and folder cleanup

* use correct pathing on tokenbridge.md

* link workflow documents

* add function signatures

* remove welcome to

* cross reference blob submission and finalization

* remove confusing text

* use better definition of shnarf

* fix broken link

* add charter, diagram and address book

* docs(LSC): Rename security-council-charter-v1.3.md to security-council-charter.md

Signed-off-by: Julien Marchand <julien-marchand@users.noreply.github.com>

* Update contracts/docs/mainnet-address-book.csv

Co-authored-by: Julien Marchand <julien-marchand@users.noreply.github.com>
Signed-off-by: The Dark Jester <thedarkjester@users.noreply.github.com>

---------

Signed-off-by: Julien Marchand <julien-marchand@users.noreply.github.com>
Signed-off-by: The Dark Jester <thedarkjester@users.noreply.github.com>
Co-authored-by: Julien Marchand <julien-marchand@users.noreply.github.com>
2025-05-19 13:36:09 +02:00

904 B

📩 Interaction Flow: Canonical Message Sending (L2 → L1)

This document describes the step-by-step flow of how a canonical message is sent from L2 to L1 in the Linea network.


🔄 Step-by-Step Flow

  1. L2 User calls sendMessage() on the L2MessageService.
  2. The contract:
    • Verifies non-empty data
    • Gets the next message number
    • Computes the message hash with all the message fields
    • Stores the message hash and emits events
  3. Coordinator captures the event and message hash.
  4. Coordinator:
    • Anchors the messaging Merkle root(s) on L1 during finalization
    • Emits events for the L2 user to construct a Merkle proof
  5. L1 User claims the message with proof on the LineaRollup / L1MessageService.
  6. The contract verifies and delivers the message to the recipient.

🖼️ Diagram