Skip to content

Commit 6b039f3

Browse files
authored
Update README.md
1 parent 7560d99 commit 6b039f3

1 file changed

Lines changed: 3 additions & 9 deletions

File tree

examples/L2/README.md

Lines changed: 3 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,17 @@
11
# Integrating your application with Aligned Aggregation Mode
22

3-
This guide demonstrates how to build a minimal L2 application that integrates with Aligned Aggregation Mode. The L2 is private, that is: it does not post state diffs or any data to Ethereum, only commitments. This way, the prover has to prove that:
3+
This guide demonstrates how to build a toy L2 application that integrates with Aligned Aggregation Mode. The L2 does not post state diffs or any data to Ethereum, only commitments. The prover has to prove that:
44

55
1. The state database used in the proof must match the commitment stored in the on-chain contract. This is validated by computing the commitment of the received data in the zkvm and then exposing it as a public input.
66
2. The users performing the transfers have enough balance
77

88
After processing the transfers, the vm computes the commitment of the post state, which is exposed as a public input. The smart contract then updates the on-chain state root. If a user later wants to retrieve their state, the application must return it along with a Merkle proof, so they can verify it against the contract’s state root.
99

10-
## Further improvements
11-
12-
This is a very basic and minimal L2 design and can be extended. For example:
13-
14-
- Block Support: Add support for batching transactions into blocks and publishing those blocks.
15-
- Soft Finality: Use the Verification Layer or Fast Mode for faster confirmation of L2 blocks.
16-
- Hard Finality: Use Aggregation Mode to finalize state transitions with high security.
10+
Notice a lot of checks that a real L2 should have are missing, since the focus are on the integration of Aligned.
1711

1812
### How it works: Step by Step
1913

20-
1. Load or initialize the database state.
14+
1. Load or initialize the state.
2115
2. Load user transfers.
2216
3. Run the zkvm + transfers to perform.
2317
4. Generate and submit the proof to Aligned.

0 commit comments

Comments
 (0)