Add EIP: Sovereign Bridged Token #7281

ArjunBhuptani · 2023-07-05T17:17:55Z

When opening a pull request to submit a new EIP, please use the suggested template: https://github.com/ethereum/EIPs/blob/master/eip-template.md

We have a GitHub bot that automatically merges some PRs. It will merge yours immediately if certain criteria are met:

The PR edits only existing draft PRs.
The build passes.
Your GitHub username or email address is listed in the 'author' header of all affected PRs, inside .
If matching on email address, the email address is the one publicly listed on your GitHub profile.

(Will update PR + this comment once posted to EthMagicians!)

eth-bot · 2023-07-05T17:18:25Z

File `EIPS/eip-draft_bridged_tokens.md`

Requires 1 more reviewers from @axic, @gcolvin, @lightclient, @Pandapip1, @SamWilsn

File `EIPS/eip-7281.md`

Requires 1 more reviewers from @axic, @Pandapip1, @SamWilsn, @xinbenlv

abcoathup · 2023-07-06T02:27:27Z

EIPS/eip-draft_bridged_tokens.md

@@ -0,0 +1,344 @@
+---


Suggested change

---

---

eip: 7281

Assigning EIP number as PR number. Please also update the file name.

abcoathup · 2023-07-06T02:29:15Z

EIPS/eip-draft_bridged_tokens.md

@@ -0,0 +1,344 @@
+---
+title: Bridged Token Standard


Suggested change

title: Bridged Token Standard

title: Bridged Token

The title field in the preamble: Should not include the word “standard” or any variation thereof;
https://eips.ethereum.org/EIPS/eip-1

abcoathup · 2023-07-07T20:52:03Z

EIPS/eip-7281.md

+title: Sovereign Bridged Token
+description: An interface for creating fungible representations of tokens bridged across domains.
+author: Shaito (@0xShaito), Excalibor (@excaliborr), Arjun Bhuptani (@arjunbhuptani)
+discussions-to: <URL> (TODO)


Suggested change

discussions-to: <URL> (TODO)

discussions-to: https://ethereum-magicians.org/t/erc-7281-sovereign-bridged-tokens/14979

seunlanlege · 2023-07-08T17:00:56Z

Duplicate #6403

apbendi · 2023-07-17T14:58:38Z

EIPS/eip-7281.md

+
+- Celer’s Open Canonical Token Standard proposed a lock-in free standard for bridging tokens to new domains. However, it largely targeted alternative L1s (that don’t already have a canonical bridge) and did not fully solve the fungibility problem. Regardless, Celer’s approach inspired some of the key thinking behind this standard.
+- Maker’s Teleport facility allows for minting and burning canonical DAI between domains. While the approach solves for the desirable properties above, it is highly custom to Maker’s architecture and relies on Maker’s own economic security to function. Circle CCTP similarly solves this problem, but using a mechanism that only centralized token issuers can implement.
+- Token issuer multi-bridge implementations, e.g. Angle protocol, Frax Ferry, and Threshold Network’s tBTC. These examples solve for some or all of the above desiderata and can be applied more broadly to all tokens if coupled with minor additions for compatibility with existing deployed tokens.


desiderata

Is this a typo, or a word I'm not smart enough to know?

de·sid·er·a·tum (noun) - plural noun: desiderata
something that is needed or wanted.

"integrity was a desideratum"

github-actions · 2023-07-18T16:29:23Z

The commit bfc2041 (as a parent of 8ee1407) contains errors.
Please inspect the Run Summary for details.

dmuhs · 2023-08-08T09:37:32Z

EIPS/eip-7281.md

+
+### Token Interface
+
+All xERC-20 tokens MUST implement the standard ERC-20 interface.  Note that while many of the below functions are inspired by ERC777, implementers are NOT REQUIRED to adhere to the full ERC777 specification.


Suggested change

All xERC-20 tokens MUST implement the standard ERC-20 interface. Note that while many of the below functions are inspired by ERC777, implementers are NOT REQUIRED to adhere to the full ERC777 specification.

All xERC-20 tokens MUST implement the standard ERC-20 interface. Note that while many of the below functions are inspired by ERC-777, implementers are NOT REQUIRED to adhere to the full ERC-777 specification.

ERC format fix to make the validator check happy.

dmuhs · 2023-08-08T09:39:23Z

EIPS/eip-7281.md

+   * @notice Reverts when a user with too low of a limit tries to call mint/burn
+   */
+
+  error IXERC-20_NotHighEnoughLimits();


Suggested change

error IXERC-20_NotHighEnoughLimits();

error IXERC20_NotHighEnoughLimits();

Remove invalid syntax.

dmuhs · 2023-08-08T09:40:18Z

EIPS/eip-7281.md

+```
+
+Implementations MUST additionally satisfy the following requirements:
+- `mint` MUST check that the caller's current available `limit` is greater than or equal to `_amount`


Suggested change

- `mint` MUST check that the caller's current available `limit` is greater than or equal to `_amount`

- `mint` MUST check that the caller's current available `limit` is greater than or equal to `_amount`

Insert blank line around list as required by validator

dmuhs · 2023-08-08T09:40:56Z

EIPS/eip-7281.md

+The lockbox tries to emulate the WETH contract interface as much as possible. Lockboxes MUST implement the following interface:
+
+```ts
+interface IXERC-20Lockbox {


Suggested change

interface IXERC-20Lockbox {

interface IXERC20Lockbox {

Fix invalid interface definition syntax.

dmuhs · 2023-08-08T09:41:39Z

EIPS/eip-7281.md

+   * @notice Reverts when a user tries to deposit native tokens on a non-native lockbox
+   */
+
+  error IXERC-20Lockbox_NotNative();


Suggested change

error IXERC-20Lockbox_NotNative();

error IXERC20Lockbox_NotNative();

Fix invalid interface definition syntax.

dmuhs · 2023-08-08T09:41:53Z

EIPS/eip-7281.md

+   * @notice Reverts when a user tries to withdraw and the call fails
+   */
+
+  error IXERC-20Lockbox_WithdrawFailed();


Suggested change

error IXERC-20Lockbox_WithdrawFailed();

error IXERC20Lockbox_WithdrawFailed();

Fix invalid interface definition syntax.

dmuhs · 2023-08-08T09:42:18Z

EIPS/eip-7281.md

+```
+
+Lockboxes SHOULD additionally implement the following alternative `deposit` function for native (non-ERC-20) assets.
+```ts


Suggested change

```ts

```ts

Insert newline to make validator happy

dmuhs · 2023-08-08T09:47:02Z

EIPS/eip-7281.md

+### Aggregation
+EIP-7281 introduces new dynamics for aggregators that massively improve user safety and experience across chains.
+
+There are two unsolved mechanism design problems that currently exist around bridge aggregation:


Suggested change

There are two unsolved mechanism design problems that currently exist around bridge aggregation:

There are two unsolved mechanism design problems that currently exist around bridge aggregation:

Add blank line around list.

emapeire

It's looking very good 🚀

barnjamin · 2023-10-25T12:03:08Z

EIPS/eip-7281.md

+
+## Reference Implementation
+
+You can find a reference implementation and associated test cases [here](https://github.com/defi-wonderland/xTokens/blob/dev/solidity/contracts/XERC-20.sol).


This link appears broken

Suggested change

You can find a reference implementation and associated test cases [here](https://github.com/defi-wonderland/xTokens/blob/dev/solidity/contracts/XERC-20.sol).

You can find a reference implementation and associated test cases [here](https://github.com/defi-wonderland/xERC20/blob/dev/solidity/contracts/XERC20.sol).

SamWilsn · 2023-10-25T22:53:37Z

I am closing this pull request because we are in the process of separating EIPs and ERCs into distinct repositories. Unfortunately, as far as we are aware, GitHub does not provide any tools to ease this migration, so every pull request will need to be re-opened manually.

As this is a PR to create / modify an ERC, I will kindly ask you to redirect this to the new repository at ethereum/ERCs. We have prepared a guide to help with the process.

If there is relevant history here, please link to this PR from the new pull request.

On behalf of the EIP Editors, I apologize for this inconvenience.

radeksvarz · 2024-04-16T16:52:09Z

For all of us landing here: this ERC was migrated to ethereum/ERCs#89

ArjunBhuptani added 3 commits July 5, 2023 17:59

Add draft EIP

73f7176

Add image assets

9dcecee

Merge branch 'ethereum:master' into master

13e0485

github-actions bot added c-new Creates a brand new proposal s-draft This EIP is a Draft t-erc labels Jul 5, 2023

eth-bot changed the title ~~Add EIP: Bridged Token Standard~~ Add EIP: Bridged Token Standard (xERC20) Jul 5, 2023

eth-bot added e-consensus Waiting on editor consensus e-review Waiting on editor to review labels Jul 5, 2023

github-actions bot added the w-ci Waiting on CI to pass label Jul 5, 2023

ArjunBhuptani changed the title ~~Add EIP: Bridged Token Standard (xERC20)~~ Add EIP: Bridged Token Standard Jul 5, 2023

Minor spec fixes

e6250cf

eth-bot changed the title ~~Add EIP: Bridged Token Standard~~ Add EIP: Bridged Token Standard (xERC20) Jul 5, 2023

github-actions bot removed the w-ci Waiting on CI to pass label Jul 5, 2023

ArjunBhuptani changed the title ~~Add EIP: Bridged Token Standard (xERC20)~~ Add EIP: Bridged Token Standard Jul 5, 2023

Fix title

015eda9

github-actions bot added the w-ci Waiting on CI to pass label Jul 5, 2023

abcoathup reviewed Jul 6, 2023

View reviewed changes

ArjunBhuptani added 2 commits July 7, 2023 12:27

Merge branch 'ethereum:master' into master

46a36aa

Fix build + add aggregator section

65d20eb

ArjunBhuptani changed the title ~~Add EIP: Bridged Token Standard~~ Add EIP: Sovereign Bridged Tokens Jul 7, 2023

eth-bot changed the title ~~Add EIP: Sovereign Bridged Tokens~~ Add EIP: Sovereign Bridged Token Jul 7, 2023

github-actions bot added w-ci Waiting on CI to pass and removed w-ci Waiting on CI to pass labels Jul 7, 2023

abcoathup reviewed Jul 7, 2023

View reviewed changes

apbendi reviewed Jul 17, 2023

View reviewed changes

improve migration path spec

bfc2041

dmuhs reviewed Aug 8, 2023

View reviewed changes

emapeire reviewed Aug 16, 2023

View reviewed changes

tann9949 mentioned this pull request Oct 1, 2023

Solve xERC20.png image path and some new line issues connext/EIPs#1

Open

barnjamin reviewed Oct 25, 2023

View reviewed changes

SamWilsn closed this Oct 25, 2023

just-a-node mentioned this pull request Oct 26, 2023

Migrate EIP connext/monorepo#5061

Open

just-a-node mentioned this pull request Nov 3, 2023

Add ERC: Sovereign Bridged Token ethereum/ERCs#89

Open

github-actions bot mentioned this pull request Apr 22, 2024

Kirkeelee - AlchemicTokenV2Base.sol deviates from xERC20 (EIP-7281) standard in the implementation of the burn() function. sherlock-audit/2024-04-alchemix-judging#59

Closed

gjermundgaraba mentioned this pull request Feb 19, 2025

ERC-7281 support cosmos/solidity-ibc-eureka#302

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add EIP: Sovereign Bridged Token #7281

Add EIP: Sovereign Bridged Token #7281

ArjunBhuptani commented Jul 5, 2023 •

edited

Loading

eth-bot commented Jul 5, 2023 •

edited

Loading

abcoathup Jul 6, 2023

abcoathup Jul 6, 2023

abcoathup Jul 7, 2023

seunlanlege commented Jul 8, 2023

apbendi Jul 17, 2023

shayanb Aug 4, 2023

github-actions bot commented Jul 18, 2023

dmuhs Aug 8, 2023 •

edited

Loading

dmuhs Aug 8, 2023

dmuhs Aug 8, 2023

dmuhs Aug 8, 2023

dmuhs Aug 8, 2023

dmuhs Aug 8, 2023

dmuhs Aug 8, 2023

dmuhs Aug 8, 2023 •

edited

Loading

emapeire left a comment

barnjamin Oct 25, 2023

SamWilsn commented Oct 25, 2023

radeksvarz commented Apr 16, 2024

	discussions-to: <URL> (TODO)
	discussions-to: https://ethereum-magicians.org/t/erc-7281-sovereign-bridged-tokens/14979


		### Token Interface

		All xERC-20 tokens MUST implement the standard ERC-20 interface. Note that while many of the below functions are inspired by ERC777, implementers are NOT REQUIRED to adhere to the full ERC777 specification.

	error IXERC-20_NotHighEnoughLimits();
	error IXERC20_NotHighEnoughLimits();

	- `mint` MUST check that the caller's current available `limit` is greater than or equal to `_amount`

	- `mint` MUST check that the caller's current available `limit` is greater than or equal to `_amount`

	error IXERC-20Lockbox_NotNative();
	error IXERC20Lockbox_NotNative();

	error IXERC-20Lockbox_WithdrawFailed();
	error IXERC20Lockbox_WithdrawFailed();

	There are two unsolved mechanism design problems that currently exist around bridge aggregation:
	There are two unsolved mechanism design problems that currently exist around bridge aggregation:


		## Reference Implementation

		You can find a reference implementation and associated test cases [here](https://github.com/defi-wonderland/xTokens/blob/dev/solidity/contracts/XERC-20.sol).

Add EIP: Sovereign Bridged Token #7281

Add EIP: Sovereign Bridged Token #7281

Conversation

ArjunBhuptani commented Jul 5, 2023 • edited Loading

eth-bot commented Jul 5, 2023 • edited Loading

File EIPS/eip-draft_bridged_tokens.md

File EIPS/eip-7281.md

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

seunlanlege commented Jul 8, 2023

Choose a reason for hiding this comment

Choose a reason for hiding this comment

github-actions bot commented Jul 18, 2023

dmuhs Aug 8, 2023 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

dmuhs Aug 8, 2023 • edited Loading

Choose a reason for hiding this comment

emapeire left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

SamWilsn commented Oct 25, 2023

radeksvarz commented Apr 16, 2024

ArjunBhuptani commented Jul 5, 2023 •

edited

Loading

eth-bot commented Jul 5, 2023 •

edited

Loading

File `EIPS/eip-draft_bridged_tokens.md`

File `EIPS/eip-7281.md`

dmuhs Aug 8, 2023 •

edited

Loading

dmuhs Aug 8, 2023 •

edited

Loading