ERC-7878: 可继承合约

/// @title EIP-7878 可继承代币
/// @dev See https://eips.ethereum.org/EIPS/eip-7878

pragma solidity ^0.8.0;

/**
 * @notice Bequeathable interface
 */

interface Bequeathable {

   /**
    * @notice              宣布所有者的代币将被继承
    * @dev                 由 `announceObit` 发出
    * @param   owner       代币的原始所有者
    * @param   inheritor   一旦暂停期 moratoriumTTL 时间过去，将继承代币的钱包地址
    */
   event ObituaryStarted(address indexed owner, address indexed inheritor);

   /** 
    * @notice               宣布所有者的讣告（和暂停期）已被取消，以及取消者
    * @dev                  由 `cancelObit` 发出
    * @param   owner        代币的原始所有者
    * @param   cancelledBy  触发此取消的地址。这可以是所有者或任何继承人
    */
   event ObituaryCancelled(address indexed owner, address indexed cancelledBy);

   /** 
    * @notice                 代币所有者可以设置一份遗嘱，并指定一个或多个执行人，他们可以在所有者去世后转移其代币
    * @dev                    虽然可以设置多个执行人地址，但只需要一个来启动该过程，然后进行转移
    * @dev                    后续对此函数的调用应覆盖任何现有遗嘱
    * @param   executors      执行人数组，例如法律顾问、配偶、子女 1、子女 2 等。
    * @param   moratoriumTTL  从讣告宣布到可以进行继承转移必须经过的时间（以秒为单位）
    * @dev                    moratoriumTTL 是一个安全缓冲时间段，允许在代币转移之前进行任何干预
    */
   function setWill(address[] memory executors, uint256 moratoriumTTL) external;

   /**
    * @notice                  获取遗嘱的详细信息（如果已设置）
    * @dev                     这是所有者确认他们已正确设置遗嘱的一种方式
    * @param    owner          代币的当前所有者
    * @return   executors      此所有者遗嘱的所有执行人列表
    * @return   moratoriumTTL  在调用 announceObit 之后，实际转移发生之前必须经过的时间长度（以秒为单位）
    */
   function getWill(address owner) external view returns (address[] memory executors, uint256 moratoriumTTL);

   /**
    * @notice              启动讣告过程，通过宣布它并声明谁是预期的继承人
    * @param   owner       代币的当前所有者
    * @param   inheritor   将要成为所有者的地址
    */
   function announceObit(address owner, address inheritor) external;

   /**
    * @notice          取消先前宣布的讣告。可以由任何执行人（或仍然在世的所有者）调用
    * @param   owner   代币的原始所有者
    */
   function cancelObit(address owner) external;

   /**
    * @notice                   获取指定的继承人以及在 moratoriumTTL 满足之前剩余的时间
    * @param    owner           代币的当前所有者
    * @return   inheritor       宣布讣告时指定的继承人
    * @return   moratoriumTTL   在可以进行转移之前，moratoriumTTL 剩余的时间
    * @dev                      moratoriumTTL 的负数表示等待时间已过，可以继承代币
    */
   function getObit(address owner) external view returns (address inheritor, int256 moratoriumTTL);

   /**
    * @notice         遗赠，即将代币转移给先前声明的继承人
    * @param   owner  代币的原始所有者
    * @dev            转移应发生在调用 `announceObit` 时的继承人地址
    */
   function bequeath(address owner) external;

}