ERC-1363 可支付代币标准

简介

什么是 ERC-1363？

ERC-1363 是 ERC-20 代币的扩展接口，支持在单笔交易中，在转账后对接收方合约或在授权后对花费方合约执行自定义逻辑。

与 ERC-20 的区别

标准的 ERC-20 操作（如 transfer、transferFrom 和 approve）不允许在没有单独交易的情况下在接收方或花费方合约上执行代码。这增加了用户界面开发的复杂性并阻碍了采用，因为用户必须等待第一笔交易执行完毕，然后再提交第二笔交易。他们还必须支付两次 Gas。

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

前提条件

为了更好地理解本页面，我们建议您先阅读以下内容：

正文

ERC-1363 为 ERC-20 代币引入了标准 API，以便在 transfer、transferFrom 或 approve 之后与智能合约进行交互。

该标准提供了转账代币的基本功能，并允许代币被授权以便由另一个链上第三方花费，然后对接收方或花费方合约进行回调。

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

例如：

众筹：发送代币会触发即时奖励分配。
服务：支付可一步激活服务访问权限。
发票：代币自动结算发票。
订阅：授权年费可在首月付款时激活订阅。

由于这些原因，它最初被命名为 “可支付代币 (Payable Token)”。

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

质押：转账代币会触发质押合约中的自动锁定。
投票：收到代币会在治理系统中登记投票。
兑换：代币授权可一步激活兑换逻辑。

在所有需要在收到转账或授权后执行回调的情况下，ERC-1363 代币均可用于特定用途。 ERC-1363 还可以通过验证接收方处理代币的能力，来避免智能合约中的代币丢失或代币锁定。

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

摘自 EIP-1363 (opens in a new tab)：

方法

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

pragma solidity ^0.8.0;

/**
 * @title ERC1363
 * @dev ERC-20 代币的扩展接口，支持在单笔交易中，在 `transfer` 或 `transferFrom` 之后在接收方合约上执行代码，或者在 `approve` 之后在花费方合约上执行代码。
 */
interface ERC1363 is ERC20, ERC165 {
  /*
   * NOTE: 此接口的 ERC-165 标识符为 0xb0202a11。
   * 0xb0202a11 ===
   *   bytes4(keccak256('transferAndCall(address,uint256)')) ^
   *   bytes4(keccak256('transferAndCall(address,uint256,bytes)')) ^
   *   bytes4(keccak256('transferFromAndCall(address,address,uint256)')) ^
   *   bytes4(keccak256('transferFromAndCall(address,address,uint256,bytes)')) ^
   *   bytes4(keccak256('approveAndCall(address,uint256)')) ^
   *   bytes4(keccak256('approveAndCall(address,uint256,bytes)'))
   */

  /**
   * @dev 将 `value` 数量的代币从调用者账户转账到 `to`
   * 然后在 `to` 上调用 `ERC1363Receiver::onTransferReceived`。
   * @param to 代币被转账到的地址。
   * @param value 要转账的代币数量。
   * @return 一个布尔值，指示操作是否成功（除非抛出异常）。
   */
  function transferAndCall(address to, uint256 value) external returns (bool);

  /**
   * @dev 将 `value` 数量的代币从调用者账户转账到 `to`
   * 然后在 `to` 上调用 `ERC1363Receiver::onTransferReceived`。
   * @param to 代币被转账到的地址。
   * @param value 要转账的代币数量。
   * @param data 没有指定格式的附加数据，在调用 `to` 时发送。
   * @return 一个布尔值，指示操作是否成功（除非抛出异常）。
   */
  function transferAndCall(address to, uint256 value, bytes calldata data) external returns (bool);

  /**
   * @dev 使用授权机制将 `value` 数量的代币从 `from` 转账到 `to`
   * 然后在 `to` 上调用 `ERC1363Receiver::onTransferReceived`。
   * @param from 发送代币的地址。
   * @param to 代币被转账到的地址。
   * @param value 要转账的代币数量。
   * @return 一个布尔值，指示操作是否成功（除非抛出异常）。
   */
  function transferFromAndCall(address from, address to, uint256 value) external returns (bool);

  /**
   * @dev 使用授权机制将 `value` 数量的代币从 `from` 转账到 `to`
   * 然后在 `to` 上调用 `ERC1363Receiver::onTransferReceived`。
   * @param from 发送代币的地址。
   * @param to 代币被转账到的地址。
   * @param value 要转账的代币数量。
   * @param data 没有指定格式的附加数据，在调用 `to` 时发送。
   * @return 一个布尔值，指示操作是否成功（除非抛出异常）。
   */
  function transferFromAndCall(address from, address to, uint256 value, bytes calldata data) external returns (bool);

  /**
   * @dev 将 `value` 数量的代币设置为 `spender` 对调用者代币的授权额度
   * 然后在 `spender` 上调用 `ERC1363Spender::onApprovalReceived`。
   * @param spender 将花费资金的地址。
   * @param value 要花费的代币数量。
   * @return 一个布尔值，指示操作是否成功（除非抛出异常）。
   */
  function approveAndCall(address spender, uint256 value) external returns (bool);

  /**
   * @dev 将 `value` 数量的代币设置为 `spender` 对调用者代币的授权额度
   * 然后在 `spender` 上调用 `ERC1363Spender::onApprovalReceived`。
   * @param spender 将花费资金的地址。
   * @param value 要花费的代币数量。
   * @param data 没有指定格式的附加数据，在调用 `spender` 时发送。
   * @return 一个布尔值，指示操作是否成功（除非抛出异常）。
   */
  function approveAndCall(address spender, uint256 value, bytes calldata data) external returns (bool);
}

interface ERC20 {
  event Transfer(address indexed from, address indexed to, uint256 value);
  event Approval(address indexed owner, address indexed spender, uint256 value);
  function transfer(address to, uint256 value) external returns (bool);
  function transferFrom(address from, address to, uint256 value) external returns (bool);
  function approve(address spender, uint256 value) external returns (bool);
  function totalSupply() external view returns (uint256);
  function balanceOf(address account) external view returns (uint256);
  function allowance(address owner, address spender) external view returns (uint256);
}

interface ERC165 {
  function supportsInterface(bytes4 interfaceId) external view returns (bool);
}

想要通过 transferAndCall 或 transferFromAndCall 接受 ERC-1363 代币的智能合约必须实现 ERC1363Receiver 接口：

/**
 * @title ERC1363Receiver
 * @dev 任何希望支持来自 ERC-1363 代币合约的 `transferAndCall` 或 `transferFromAndCall` 的合约的接口。
 */
interface ERC1363Receiver {
  /**
   * @dev 每当 `operator` 通过 `ERC1363::transferAndCall` 或 `ERC1363::transferFromAndCall` 将 ERC-1363 代币从 `from` 转账到此合约时，都会调用此函数。
   *
   * NOTE: 要接受转账，此函数必须返回
   * `bytes4(keccak256("onTransferReceived(address,address,uint256,bytes)"))`
   * （即 0x88a7ca5c，或其自身的函数选择器）。
   *
   * @param operator 调用 `transferAndCall` 或 `transferFromAndCall` 函数的地址。
   * @param from 代币转账的来源地址。
   * @param value 转账的代币数量。
   * @param data 没有指定格式的附加数据。
   * @return 如果允许转账，则返回 `bytes4(keccak256("onTransferReceived(address,address,uint256,bytes)"))`（除非抛出异常）。
   */
  function onTransferReceived(address operator, address from, uint256 value, bytes calldata data) external returns (bytes4);
}

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

/**
 * @title ERC1363Spender
 * @dev 任何希望支持来自 ERC-1363 代币合约的 `approveAndCall` 的合约的接口。
 */
interface ERC1363Spender {
  /**
   * @dev 每当 ERC-1363 代币的 `owner` 通过 `ERC1363::approveAndCall` 授权此合约
   * 花费其代币时，都会调用此函数。
   *
   * NOTE: 要接受授权，此函数必须返回
   * `bytes4(keccak256("onApprovalReceived(address,uint256,bytes)"))`
   * （即 0x7b04a2d0，或其自身的函数选择器）。
   *
   * @param owner 调用 `approveAndCall` 函数并先前拥有代币的地址。
   * @param value 要花费的代币数量。
   * @param data 没有指定格式的附加数据。
   * @return 如果允许授权，则返回 `bytes4(keccak256("onApprovalReceived(address,uint256,bytes)"))`（除非抛出异常）。
   */
  function onApprovalReceived(address owner, uint256 value, bytes calldata data) external returns (bytes4);
}

延伸阅读

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

返回顶部 ↑