Skip to content

feat(AggLayer): bridging spec#2469

Merged
mmagician merged 15 commits intoagglayerfrom
mmagician-agglayer-spec
Mar 4, 2026
Merged

feat(AggLayer): bridging spec#2469
mmagician merged 15 commits intoagglayerfrom
mmagician-agglayer-spec

Conversation

@mmagician
Copy link
Copy Markdown
Collaborator

@mmagician mmagician commented Feb 19, 2026

No description provided.

@mmagician mmagician added the agglayer PRs or issues related to AggLayer bridging integration label Feb 19, 2026
@mmagician mmagician force-pushed the mmagician-agglayer-spec branch from cf11698 to c13d605 Compare February 25, 2026 09:38
@mmagician mmagician added the no changelog This PR does not require an entry in the `CHANGELOG.md` file label Feb 25, 2026
mmagician and others added 3 commits March 2, 2026 11:58
…2513)

* docs: add Section 5 — Ethereum ↔ Miden address conversion spec

Comprehensive specification of the address conversion encoding between
Ethereum 20-byte addresses and Miden AccountId (two field elements),
covering the embedded format, MASM limb representation, Rust and MASM
conversion procedures, endianness details, and roundtrip guarantees.

Addresses #2229

https://claude.ai/code/session_01YabAhXZeStAkKkYwBcXXFh

* Apply suggestions from code review

Update crates/miden-agglayer/SPEC.md

Update crates/miden-agglayer/SPEC.md

Update crates/miden-agglayer/SPEC.md

* fix: EthAddressFormat::from_account_id usage

* docs: clean up address conversion

---------

Co-authored-by: Claude <noreply@anthropic.com>
@mmagician mmagician marked this pull request as ready for review March 2, 2026 17:22
@mmagician mmagician requested a review from Copilot March 2, 2026 17:22
@mmagician mmagician changed the title (WIP) feat: AggLayer spec feat(AggLayer): bridging spec Mar 2, 2026
@mmagician mmagician added the pr-from-maintainers PRs that come from internal contributors or integration partners. They should be given priority label Mar 2, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds an implementation-oriented specification document for the miden-agglayer bridge integration, and updates MASM documentation to clarify address limb endianness.

Changes:

  • Introduces crates/miden-agglayer/SPEC.md describing contracts, note flows, storage layouts, and Ethereum↔Miden address encoding.
  • Clarifies build_felt endianness semantics in eth_address.masm doc comments.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File Description
crates/miden-agglayer/asm/agglayer/common/eth_address.masm Doc comment tweak to clarify limb/byte endianness for felt packing.
crates/miden-agglayer/SPEC.md New, detailed bridge integration specification covering interfaces, note types, and encoding semantics.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@mmagician mmagician requested a review from Fumuran March 3, 2026 14:34
@mmagician
Copy link
Copy Markdown
Collaborator Author

merging for now, we can revisit the docs in details during the internal audit, or as we go along

@mmagician mmagician merged commit 83ccb2f into agglayer Mar 4, 2026
17 checks passed
@mmagician mmagician deleted the mmagician-agglayer-spec branch March 4, 2026 14:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

agglayer PRs or issues related to AggLayer bridging integration no changelog This PR does not require an entry in the `CHANGELOG.md` file pr-from-maintainers PRs that come from internal contributors or integration partners. They should be given priority

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants