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

/**
 * 一种与 `ERC20` 兼容的代币，该代币符合特拉华州参议院，
 * 第149届大会，参议院第69号法案：修订特拉华州法典第8章
 * 关于通用公司法的法案。
 *
 * 实施细节。
 *
 * 此代币标准的实现应提供以下内容：
 *
 * `name` - 供钱包和交易所使用。
 * `symbol` - 供钱包和交易所使用。
 *
 * 该实现必须注意不要允许未经授权访问
 * 股份转让功能。
 *
 * 除了上述内容外，还必须定义以下可选的 `ERC20` 函数。
 *
 * `decimals` - 必须返回 `0`，因为每个代币代表单股，并且股份不可分割。
 *
 * @dev 参考 https://github.com/ethereum/EIPs/pull/884
 */
contract ERC884 is ERC20 {

    /**
     * 当验证的地址和关联的身份哈希添加到合约时，会发出此事件。
     * @param addr 添加的地址。
     * @param hash 与该地址关联的身份哈希。
     * @param sender 导致添加该地址的地址。
     */
    event VerifiedAddressAdded(
        address indexed addr,
        bytes32 hash,
        address indexed sender
    );

    /**
     * 从合约中删除经过验证的地址和关联的身份哈希时，会发出此事件。
     * @param addr 删除的地址。
     * @param sender 导致删除该地址的地址。
     */
    event VerifiedAddressRemoved(address indexed addr, address indexed sender);

    /**
     * 当与经过验证的地址关联的身份哈希更新时，会发出此事件。
     * @param addr 其哈希已更新的地址。
     * @param oldHash 与该地址关联的身份哈希。
     * @param hash 现在与该地址关联的哈希。
     * @param sender 导致哈希更新的地址。
     */
    event VerifiedAddressUpdated(
        address indexed addr,
        bytes32 oldHash,
        bytes32 hash,
        address indexed sender
    );

    /**
     * 当地址被取消并替换为新地址时，会发出此事件。
     * 这种情况发生在股东丢失了对其原始地址的访问权限并且需要将其股份重新发行到新地址的情况下。
     * 这相当于发行替换股份证明。
     * @param original 被取代的地址。
     * @param replacement 新地址。
     * @param sender 导致地址被取代的地址。
     */
    event VerifiedAddressSuperseded(
        address indexed original,
        address indexed replacement,
        address indexed sender
    );

    /**
     * 向合约添加经过验证的地址以及关联的验证哈希。
     * 成功添加经过验证的地址后，合约必须发出`VerifiedAddressAdded(addr, hash, msg.sender)`。
     * 如果提供的地址或哈希为零，或者如果该地址已提供，则必须抛出错误。
     * @param addr 由提供的哈希表示的人员的地址。
     * @param hash 地址持有者经过验证的信息的加密哈希。
     */
    function addVerified(address addr, bytes32 hash) public;

    /**
     * 删除经过验证的地址和关联的验证哈希。 如果合约不知道该地址，则此操作不执行任何操作。
     * 如果成功删除该地址，则此函数必须发出`VerifiedAddressRemoved(addr, msg.sender)`。
     * 如果尝试删除拥有代币的 verifiedAddress，则必须抛出错误。
     * @param addr 要删除的经过验证的地址。
     */
    function removeVerified(address addr) public;

    /**
     * 更新合约已知的经过验证的地址的哈希。
     * 成功更新经过验证的地址后，合约必须发出
     * `VerifiedAddressUpdated(addr, oldHash, hash, msg.sender)`。
     * 如果哈希与已存储的值相同，则
     * 不会发出任何`VerifiedAddressUpdated`事件。
     * 如果哈希为零，或者地址未经验证，则必须抛出错误。
     * @param addr 由提供的哈希表示的人员的经过验证的地址。
     * @param hash 地址持有者更新后的经过验证的信息的新加密哈希。
     */
    function updateVerified(address addr, bytes32 hash) public;

    /**
     * 取消原始地址并将代币重新发行到替换地址。
     * 必须严格控制对此功能的访问。
     * 必须从经过验证的地址集中删除`original`地址。
     * 如果提供的`original`地址不是股东，则抛出错误。
     * 如果`replacement`地址不是经过验证的地址，则抛出错误。
     * 如果`replacement`地址已持有代币，则抛出错误。
     * 此函数必须发出`VerifiedAddressSuperseded`事件。
     * @param original 要被取代的地址。 此地址不得重复使用。
     */
    function cancelAndReissue(address original, address replacement) public;

    /**
     * `transfer`函数不得允许转移到未经验证并添加到合约的地址。
     * 如果`to`地址当前不是股东，则必须成为股东。
     * 如果转账会将`msg.sender`的余额减少到0，则必须从股东列表中删除该地址。
     */
    function transfer(address to, uint256 value) public returns (bool);

    /**
     * `transferFrom`函数不得允许转移到未经验证并添加到合约的地址。
     * 如果`to`地址当前不是股东，则必须成为股东。
     * 如果转账会将`from`的余额减少到0，则必须从股东列表中删除该地址。
     */
    function transferFrom(address from, address to, uint256 value) public returns (bool);

    /**
     * 测试提供的地址是否为合约所知。
     * @param addr 要测试的地址。
     * @return 如果合约知道该地址，则为true。
     */
    function isVerified(address addr) public view returns (bool);

    /**
     * 检查提供的地址是否为股东。
     * @param addr 要检查的地址。
     * @return 如果提供的地址拥有代币，则为true。
     */
    function isHolder(address addr) public view returns (bool);

    /**
     * 检查提供的哈希是否与给定的地址关联。
     * @param addr 要测试的地址。
     * @param hash 要测试的哈希。
     * @return 如果哈希与`addVerified`或`updateVerified`中提供的地址匹配，则为true。
     */
    function hasHash(address addr, bytes32 hash) public view returns (bool);

    /**
     * 持有代币的地址数。
     * @return 持有代币的唯一地址数。
     */
    function holderCount() public view returns (uint);

    /**
     * 通过使用`holderCount`计算代币持有者的数量
     * 您可以一次检索完整的代币持有者列表。
     * 如果`index >= holderCount()`，则必须抛出错误。
     * @param index 持有者的从零开始的索引。
     * @return 具有给定索引的代币持有者的地址。
     */
    function holderAt(uint256 index) public view returns (address);

    /**
     * 检查提供的地址是否被取代。
     * @param addr 要检查的地址。
     * @return 如果提供的地址被另一个地址取代，则为true。
     */
    function isSuperseded(address addr) public view returns (bool);

    /**
     * 获取给定被取代地址的最新地址。
     * 地址可能被多次取代，因此此函数需要
     * 跟踪地址链，直到到达最终的经过验证的地址。
     * @param addr 被取代的地址。
     * @return 最终持有股份且经过验证的地址。
     */
    function getCurrentFor(address addr) public view returns (address);
}

GET https://<host>/<pathPrefix>/:ethereumAddress -> [true|false]