Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: state bridge spec #20

Merged
merged 2 commits into from
Jul 23, 2024
Merged

docs: state bridge spec #20

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e6b89db
docs: state bridge spec
zintarh Jul 13, 2024
6571eff
lint: fix lint issues
zintarh Jul 17, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions docs/spec.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# State Bridge Spec

The diagram above demonstrates the process of propagating World ID Merkle tree roots from the `WorldIDIdentityManager`
contract (located in the world-id-contracts repository) on the Ethereum mainnet to the `LineaWorldID` contract

World ID Merkle tree roots are retrieved from the `WorldIDIdentityManager` contract by invoking the `latestRoot()`
public method. These roots are then sent to the LineaWorldID contract using its receiveRoot() method, facilitated by the
propagateRoot() method. This process ensures that the Merkle tree roots are accurately and efficiently propagated from
the `WorldIDIdentityManager` to the `LineaWorldID` contract.

## LineaStateBridge

The LineaStateBridge contract is an integral component in the architecture designed to facilitate secure and efficient
communication between Ethereum and Linea. it's primary purpose is to serve as a trusted intermediary that retrieves
Merkle tree roots from the `WorldIDIdentityManager` contract on Ethereum and delivers them to the `LineaWorldID`
contract on the Linea blockchain. This process ensures that state updates are accurately propagated across both
blockchains.

The propagation process incurs transaction fees on both the Ethereum and Linea blockchains. The `LineaStateBridge`
manages these fees, requiring periodic transactions to be initiated and paid for by users or designated operators. This
ensures the continued operation and data consistency of the system