Update ERC-7786: Use interoperable binary addresses, improve attributes #1050

frangio · 2025-05-22T14:25:28Z

This PR includes the change to interoperable binary addresses from #1038, but preserves attributes with a small change, and does not add hooks.

To make clearer the fact that attributes are metadata strictly intended for the gateway, the attributes argument was removed from receiveMessage and metadata will not be forwarded to the receiver.

The rationale for preserving a structured form of metadata rather than opaque extraData is:

The use of opaque extraData would rely entirely on off-chain consensus and coordination on encoding and semantics between the sender and the gateway. This prevents on-chain constructions that are able to detect errors and adapt to gateway functionality.
- Tagging or versioning metadata facilitates on-chain coordination.
- This is the bytes4 selector that is prepended to the actual metadata values. The gateway can use this to safely detect that it supports the metadata that was passed in, which could otherwise successfully decode but be misinterpreted.
- A getter on the gateway to check for support allows senders to adapt their behavior to what the gateway supports. This is supportsMetadata(bytes4). For an example, consider a sender contract that supports multiple ways of specifying gas payment for the call and can choose which one to use.
The possibility of providing multiple pieces of metadata (bytes[]) as opposed to a single piece of metadata (bytes extraData) allows multiple extensions to be combined without disrupting the other metadata and requiring less coordination.

The rationale for not adding hooks is:

In order for hooks to be useful we need to design and specify the mechanism by which the gateway and a hook communicate. While there were advances in #1038 with 62ab9a3, I don't think the work is done, for example although there is a getTransientMessageContext() getter in the gateway, as currently specified the gateway address has to be provided by the sender in the hook data and the hook must trust it.
Structured metadata easily subsumes hooks: we can define an extension where metadata of the form hook(address,bytes,uint256) triggers a hook call.

eip-review-bot · 2025-05-22T14:26:00Z

✅ All reviewers have approved.

frangio · 2025-05-26T21:28:04Z

Update ready but will be blocked by #1002.

xinbenlv

Thanks for the improvements to ERC-7786! I have one specific question about event indexing.

ERCS/erc-7786.md

eip-review-bot

All Reviewers Have Approved; Performing Automatic Merge...

eip-review-bot

All Reviewers Have Approved; Performing Automatic Merge...

u59149403 · 2025-05-27T12:01:51Z

@frangio , CAIP-350/ERC‑7930 is too immature for building other standards upon it. Currently it doesn't specify binary encoding for any namespace, even for EVM-compatible chains.

So, to build other standards (such as ERC-7786) on top of CAIP-350/ERC‑7930 the following conditions should be met:

CAIP-350 and ERC‑7930 both should be merged
Table of namespaces ( https://namespaces.chainagnostic.org ) should get own column for CAIP-350
That column should get implementations for many namespaces, including EVM-compatible chains, i. e. EIP-155 . I. e. there should be "X" (pointing to real document) on intersection of EIP-155 row and CAIP-350 column
And ideally, CAIP-350 should be implemented for all namespaces, for which CAIP-10 is implemented (i. e. CAIP-350 column should have at least as many Xs as CAIP-10 has)

Otherwise there is no sense in migrating from CAIP-10 to less mature standard (CAIP-350/ERC‑7930)

frangio · 2025-05-28T01:49:45Z

Otherwise there is no sense in migrating from CAIP-10 to less mature standard

I disagree on this part. Parsing CAIP-10 ASCII strings on chain is so bad that it makes sense to migrate to a less mature standard.

ERCS/erc-7786.md

eip-review-bot

All Reviewers Have Approved; Performing Automatic Merge...

eip-review-bot

All Reviewers Have Approved; Performing Automatic Merge...

Co-authored-by: Hadrien Croubois <[email protected]>

eip-review-bot

All Reviewers Have Approved; Performing Automatic Merge...

frangio · 2025-06-26T15:44:26Z

Blocked on #1002.

eip-review-bot

All Reviewers Have Approved; Performing Automatic Merge...

eip-review-bot

All Reviewers Have Approved; Performing Automatic Merge...

eip-review-bot

All Reviewers Have Approved; Performing Automatic Merge...

github-actions · 2025-07-08T17:15:03Z

The commit cab9086 (as a parent of 87f4d8e) contains errors.
Please inspect the Run Summary for details.

0xValera · 2025-07-09T11:51:12Z

ERCS/erc-7786.md

+    function receiveMessage(
+        bytes32 receiveId,     // Unique identifier
+        bytes calldata sender, // Binary Interoperable Address
        bytes calldata payload,


The comma here is redundant.

eip-review-bot

All Reviewers Have Approved; Performing Automatic Merge...

eip-review-bot

All Reviewers Have Approved; Performing Automatic Merge...

github-actions bot added c-update s-draft t-erc labels May 22, 2025

github-actions bot added the w-ci label May 22, 2025

Joxess mentioned this pull request May 26, 2025

Update ERC-7786: Remove Attributes, Add ExtraData; Support Hooks and Interoperable Addresses #1038

Closed

frangio changed the title ~~Update ERC-7786: Use interoperable binary addresses, rename attributes to metadata~~ Update ERC-7786: Use interoperable binary addresses, improve attributes description May 26, 2025

frangio changed the title ~~Update ERC-7786: Use interoperable binary addresses, improve attributes description~~ Update ERC-7786: Use interoperable binary addresses and improve attributes spec May 26, 2025

frangio changed the title ~~Update ERC-7786: Use interoperable binary addresses and improve attributes spec~~ Update ERC-7786: Use interoperable binary addresses, improve attributes May 26, 2025

github-actions bot removed the w-ci label May 26, 2025

frangio marked this pull request as ready for review May 26, 2025 21:27

frangio requested a review from eip-review-bot as a code owner May 26, 2025 21:27

github-actions bot added the w-ci label May 26, 2025

xinbenlv reviewed May 26, 2025

View reviewed changes

ERCS/erc-7786.md Show resolved Hide resolved

eip-review-bot enabled auto-merge (squash) May 26, 2025 23:45

eip-review-bot approved these changes May 26, 2025

View reviewed changes

eip-review-bot approved these changes May 27, 2025

View reviewed changes

Amxx reviewed May 30, 2025

View reviewed changes

ERCS/erc-7786.md Outdated Show resolved Hide resolved

eip-review-bot previously approved these changes May 30, 2025

View reviewed changes

auto-merge was automatically disabled May 30, 2025 17:48
Head branch was pushed to by a user without write access

frangio dismissed eip-review-bot’s stale review via 4bce7c9 May 30, 2025 17:48

eip-review-bot enabled auto-merge (squash) May 30, 2025 17:49

eip-review-bot previously approved these changes May 30, 2025

View reviewed changes

Rafazzzz mentioned this pull request May 30, 2025

All Reviewers Have Approved; Performing Automatic Merge... Rafazzzz/blank-app-1#1

Open

poojaranjan mentioned this pull request Jun 6, 2025

ERC Blitz | June 10, 2025 ethcatherders/EIPIP#387

Closed

53 tasks

ernestognw mentioned this pull request Jun 11, 2025

Add ERC-7786 interface OpenZeppelin/openzeppelin-contracts#5737

Merged

3 tasks

auto-merge was automatically disabled June 22, 2025 22:35
Head branch was pushed to by a user without write access

frangio and others added 3 commits June 26, 2025 11:06

rename messageId -> receiveId

4c1e627

Update ERCS/erc-7786.md

519fca3

Co-authored-by: Hadrien Croubois <[email protected]>

typo

b9497fe

SamWilsn force-pushed the 7786-wg-updates branch from 33a8a05 to b9497fe Compare June 26, 2025 15:06

eip-review-bot previously approved these changes Jun 26, 2025

View reviewed changes

poojaranjan mentioned this pull request Jun 27, 2025

EIP Editing Office Hour Meeting 64 (EIP + ERC ) | July 08, 2025 ethereum/pm#1596

Closed

37 tasks

add protocol costs consideration to Liveness

1f44ee4

auto-merge was automatically disabled July 4, 2025 14:15
Head branch was pushed to by a user without write access

frangio dismissed eip-review-bot’s stale review via 1f44ee4 July 4, 2025 14:15

eip-review-bot enabled auto-merge (squash) July 4, 2025 14:16

eip-review-bot approved these changes Jul 4, 2025

View reviewed changes

github-actions bot added w-ci and removed w-ci labels Jul 4, 2025

SamWilsn closed this Jul 8, 2025

auto-merge was automatically disabled July 8, 2025 16:47
Pull request was closed

SamWilsn reopened this Jul 8, 2025

eip-review-bot enabled auto-merge (squash) July 8, 2025 16:48

eip-review-bot approved these changes Jul 8, 2025

View reviewed changes

Merge branch 'master' into 7786-wg-updates

cab9086

eip-review-bot approved these changes Jul 8, 2025

View reviewed changes

ernestognw mentioned this pull request Jul 8, 2025

Add ERC: Proof-based Broadcast in ERC-7786 Gateways #1072

Merged

0xValera reviewed Jul 9, 2025

View reviewed changes

eip-review-bot approved these changes Jul 9, 2025

View reviewed changes

Merge branch 'master' into 7786-wg-updates

bc21735

eip-review-bot approved these changes Jul 9, 2025

View reviewed changes

eip-review-bot merged commit d0a7eaf into ethereum:master Jul 9, 2025
9 of 10 checks passed

github-actions bot removed the w-ci label Jul 9, 2025

frangio deleted the 7786-wg-updates branch July 10, 2025 00:11

Update ERC-7786: Use interoperable binary addresses, improve attributes #1050

Update ERC-7786: Use interoperable binary addresses, improve attributes #1050

Uh oh!

Conversation

frangio commented May 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

eip-review-bot commented May 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

frangio commented May 26, 2025

Uh oh!

xinbenlv left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

eip-review-bot left a comment

Choose a reason for hiding this comment

Uh oh!

eip-review-bot left a comment

Choose a reason for hiding this comment

Uh oh!

u59149403 commented May 27, 2025

Uh oh!

frangio commented May 28, 2025

Uh oh!

Uh oh!

eip-review-bot left a comment

Choose a reason for hiding this comment

Uh oh!

eip-review-bot left a comment

Choose a reason for hiding this comment

Uh oh!

eip-review-bot left a comment

Choose a reason for hiding this comment

Uh oh!

frangio commented Jun 26, 2025

Uh oh!

eip-review-bot left a comment

Choose a reason for hiding this comment

Uh oh!

eip-review-bot left a comment

Choose a reason for hiding this comment

Uh oh!

eip-review-bot left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Jul 8, 2025

Uh oh!

0xValera Jul 9, 2025

Choose a reason for hiding this comment

Uh oh!

eip-review-bot left a comment

Choose a reason for hiding this comment

Uh oh!

eip-review-bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

frangio commented May 22, 2025 •

edited

Loading

eip-review-bot commented May 22, 2025 •

edited

Loading