跳转至主要内容
Change page

ERC-1363 可支付代币标准

页面最后更新: 2025年4月4日

简介

什么是 ERC-1363?

ERC-1363 是 ERC-20 代币的一种扩展接口,支持在转账后于接收方合约上执行自定义逻辑,或在批准后于支出方合约上执行自定义逻辑,所有操作都在单笔交易中完成。

与 ERC-20 的区别

标准的 ERC-20 操作(如 transfertransferFromapprove)不允许在没有单独交易的情况下,在接收方或支出方合约上执行代码。 这给 UI 开发带来了复杂性,也给应用推广带来了阻力,因为用户必须等待第一笔交易执行完毕,然后才能提交第二笔交易。 他们还必须支付两次燃料费用。

ERC-1363 使同质化代币能够更轻松地执行操作,并且无需使用任何链下侦听器即可工作。 它允许在单笔交易中,于转账或批准后,对接收方或支出方合约进行回调。

前提条件

为更好地理解本页面,我们建议你先阅读以下内容:

正文

ERC-1363 为 ERC-20 代币引入了一个标准应用程序接口 (API),用于在 transfertransferFromapprove 之后与智能合约交互。

该标准提供了转移代币的基本功能,并允许代币被批准,以便链上第三方可以使用它们,然后在接收方或支出方合约上进行回调。

有很多关于可接受 ERC-20 回调的智能合约的提议用例。

例如:

  • 众筹:发送代币会触发即时奖励分配。
  • 服务:付款一步即可激活服务访问权限。
  • 发票:代币自动结算发票。
  • 订阅:批准年费率会在支付第一个月费用时激活订阅。

因此,它最初被命名为**“可支付代币”**。

回调行为进一步扩展了其效用,实现了无缝交互,例如:

  • 质押:转移的代币会触发在质押合约中自动锁定。
  • 投票:收到的代币在治理系统中登记为投票。
  • 交换:代币批准一步即可激活交换逻辑。

在所有需要在收到转账或批准后执行回调的情况下,ERC-1363 代币都可用于特定效用。 通过验证接收方处理代币的能力,ERC-1363 还有助于避免智能合约中的代币丢失或代币锁定。

与其他 ERC-20 扩展提案不同,ERC-1363 不会覆盖 ERC-20 的 transfertransferFrom 方法,而是定义了要实现的接口 ID,从而保持与 ERC-20 的向后兼容性。

来自 EIP-1363opens in a new tab

方法

实现 ERC-1363 标准的智能合约必须实现 ERC1363 接口以及 ERC20ERC165 接口中的所有函数。

1pragma solidity ^0.8.0;
2
3/**
4 * @title ERC1363
5 * @dev ERC-20 代币的扩展接口,支持在单笔交易中,于 `transfer` 或 `transferFrom` 后在接收方合约上执行代码,或于 `approve` 后在支出方合约上执行代码。
6 */
7interface ERC1363 is ERC20, ERC165 {
8 /*
9 * 注意:此接口的 ERC-165 标识符是 0xb0202a11。
10 * 0xb0202a11 ===
11 * bytes4(keccak256('transferAndCall(address,uint256)')) ^
12 * bytes4(keccak256('transferAndCall(address,uint256,bytes)')) ^
13 * bytes4(keccak256('transferFromAndCall(address,address,uint256)')) ^
14 * bytes4(keccak256('transferFromAndCall(address,address,uint256,bytes)')) ^
15 * bytes4(keccak256('approveAndCall(address,uint256)')) ^
16 * bytes4(keccak256('approveAndCall(address,uint256,bytes)'))
17 */
18
19 /**
20 * @dev 从调用者的帐户向 `to` 转移 `value` 数量的代币,然后在 `to` 上调用 `ERC1363Receiver::onTransferReceived`。
21 * @param to 代币转入的地址。
22 * @param value 要转移的代币数量。
23 * @return 一个布尔值,表示操作成功,除非抛出错误。
24 */
25 function transferAndCall(address to, uint256 value) external returns (bool);
26
27 /**
28 * @dev 从调用者的帐户向 `to` 转移 `value` 数量的代币,然后在 `to` 上调用 `ERC1363Receiver::onTransferReceived`。
29 * @param to 代币转入的地址。
30 * @param value 要转移的代币数量。
31 * @param data 额外数据,无特定格式,在对 `to` 的调用中发送。
32 * @return 一个布尔值,表示操作成功,除非抛出错误。
33 */
34 function transferAndCall(address to, uint256 value, bytes calldata data) external returns (bool);
35
36 /**
37 * @dev 使用授权机制将 `value` 数量的代币从 `from` 转移到 `to`,然后在 `to` 上调用 `ERC1363Receiver::onTransferReceived`。
38 * @param from 发送代币的地址。
39 * @param to 代币转入的地址。
40 * @param value 要转移的代币数量。
41 * @return 一个布尔值,表示操作成功,除非抛出错误。
42 */
43 function transferFromAndCall(address from, address to, uint256 value) external returns (bool);
44
45 /**
46 * @dev 使用授权机制将 `value` 数量的代币从 `from` 转移到 `to`,然后在 `to` 上调用 `ERC1363Receiver::onTransferReceived`。
47 * @param from 发送代币的地址。
48 * @param to 代币转入的地址。
49 * @param value 要转移的代币数量。
50 * @param data 额外数据,无特定格式,在对 `to` 的调用中发送。
51 * @return 一个布尔值,表示操作成功,除非抛出错误。
52 */
53 function transferFromAndCall(address from, address to, uint256 value, bytes calldata data) external returns (bool);
54
55 /**
56 * @dev 将调用者代币的 `value` 数量设置为 `spender` 的授权额度,然后在 `spender` 上调用 `ERC1363Spender::onApprovalReceived`。
57 * @param spender 将使用资金的地址。
58 * @param value 要使用的代币数量。
59 * @return 一个布尔值,表示操作成功,除非抛出错误。
60 */
61 function approveAndCall(address spender, uint256 value) external returns (bool);
62
63 /**
64 * @dev 将调用者代币的 `value` 数量设置为 `spender` 的授权额度,然后在 `spender` 上调用 `ERC1363Spender::onApprovalReceived`。
65 * @param spender 将使用资金的地址。
66 * @param value 要使用的代币数量。
67 * @param data 额外数据,无特定格式,在对 `spender` 的调用中发送。
68 * @return 一个布尔值,表示操作成功,除非抛出错误。
69 */
70 function approveAndCall(address spender, uint256 value, bytes calldata data) external returns (bool);
71}
72
73interface ERC20 {
74 event Transfer(address indexed from, address indexed to, uint256 value);
75 event Approval(address indexed owner, address indexed spender, uint256 value);
76 function transfer(address to, uint256 value) external returns (bool);
77 function transferFrom(address from, address to, uint256 value) external returns (bool);
78 function approve(address spender, uint256 value) external returns (bool);
79 function totalSupply() external view returns (uint256);
80 function balanceOf(address account) external view returns (uint256);
81 function allowance(address owner, address spender) external view returns (uint256);
82}
83
84interface ERC165 {
85 function supportsInterface(bytes4 interfaceId) external view returns (bool);
86}
显示全部

想要通过 transferAndCalltransferFromAndCall 接受 ERC-1363 代币的智能合约必须实现 ERC1363Receiver 接口:

1/**
2 * @title ERC1363Receiver
3 * @dev 任何想要支持 ERC-1363 代币合约的 `transferAndCall` 或 `transferFromAndCall` 的合约接口。
4 */
5interface ERC1363Receiver {
6 /**
7 * @dev 每当 `operator` 从 `from` 通过 `ERC1363::transferAndCall` 或 `ERC1363::transferFromAndCall` 将 ERC-1363 代币转移到此合约时,都会调用此函数。
8 *
9 * 注意:要接受转账,此函数必须返回
10 * `bytes4(keccak256("onTransferReceived(address,address,uint256,bytes)"))`
11 * (即 0x88a7ca5c,或其自身的函数选择器)。
12 *
13 * @param operator 调用 `transferAndCall` 或 `transferFromAndCall` 函数的地址。
14 * @param from 代币转出的地址。
15 * @param value 转移的代币数量。
16 * @param data 额外数据,无特定格式。
17 * @return 如果允许转账,则返回 `bytes4(keccak256("onTransferReceived(address,address,uint256,bytes)"))`,除非抛出错误。
18 */
19 function onTransferReceived(address operator, address from, uint256 value, bytes calldata data) external returns (bytes4);
20}
显示全部

想要通过 approveAndCall 接受 ERC-1363 代币的智能合约必须实现 ERC1363Spender 接口:

1/**
2 * @title ERC1363Spender
3 * @dev 任何想要支持来自 ERC-1363 代币合约的 `approveAndCall` 的合约接口。
4 */
5interface ERC1363Spender {
6 /**
7 * @dev 每当 ERC-1363 代币的 `owner` 通过 `ERC1363::approveAndCall` 批准此合约使用其代币时,都会调用此函数。
8 *
9 * 注意:要接受批准,此函数必须返回
10 * `bytes4(keccak256("onApprovalReceived(address,uint256,bytes)"))`
11 * (即 0x7b04a2d0,或其自身的函数选择器)。
12 *
13 * @param owner 调用 `approveAndCall` 函数且之前拥有代币的地址。
14 * @param value 要使用的代币数量。
15 * @param data 额外数据,无特定格式。
16 * @return 如果允许批准,则返回 `bytes4(keccak256("onApprovalReceived(address,uint256,bytes)"))`,除非抛出错误。
17 */
18 function onApprovalReceived(address owner, uint256 value, bytes calldata data) external returns (bytes4);
19}
显示全部

扩展阅读{#further-reading}

本文对你有帮助吗?