Skip to content

docs(agglayer): add Section 6 - Faucet Registry to SPEC#2584

Draft
mmagician wants to merge 2 commits intommagician-claude/agglayer-metadata-hashfrom
mmagician-claude/agglayer-faucet-registry-spec
Draft

docs(agglayer): add Section 6 - Faucet Registry to SPEC#2584
mmagician wants to merge 2 commits intommagician-claude/agglayer-metadata-hashfrom
mmagician-claude/agglayer-faucet-registry-spec

Conversation

@mmagician
Copy link
Collaborator

Adds a new section to the AggLayer bridging spec covering faucet registration for both bridge-in (non-native ERC20 tokens) and bridge-out (Miden-native tokens), including metadata hash documentation and gaps.

Summary

  • Section 6.1: How non-native ERC20 faucets are created and registered on Miden via CONFIG_AGG_BRIDGE notes
  • Section 6.2: How Miden-native tokens would be registered on EVM chains (bridge-out path), including open design questions
  • Section 6.3: Metadata hash format, dual purpose (leaf verification + wrapped token deployment), and correctness argument

Highlights implementation gaps:

  • On-chain metadata hash verification during registration (needs token name storage + abi.encode in MASM)
  • Token name storage in faucet (separate PR in progress)
  • Miden-native faucet registration flow for outbound bridging (needs design)

@mmagician mmagician force-pushed the mmagician-claude/agglayer-faucet-registry-spec branch from 8e3e02a to d74cf1c Compare March 11, 2026 11:07
@mmagician mmagician force-pushed the mmagician-claude/agglayer-metadata-hash branch from 2affd1c to d6d9127 Compare March 11, 2026 11:12
@mmagician mmagician force-pushed the mmagician-claude/agglayer-faucet-registry-spec branch from d74cf1c to d819e24 Compare March 11, 2026 11:13
@mmagician mmagician added the no changelog This PR does not require an entry in the `CHANGELOG.md` file label Mar 11, 2026
@mmagician mmagician force-pushed the mmagician-claude/agglayer-faucet-registry-spec branch from d819e24 to 60eeafd Compare March 11, 2026 11:17
Link #2585 (token name storage) and #2586 (on-chain metadata hash
verification) in the implementation status notes.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@mmagician mmagician added agglayer PRs or issues related to AggLayer bridging integration pr-from-maintainers PRs that come from internal contributors or integration partners. They should be given priority labels Mar 12, 2026
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.

2 participants