@3test/ethereum-utils-contracts 中文文档教程

Question

带有辅助智能合约的通用实用模块。

0xcert Framework 是一个免费的开源 JavaScript 库，它提供用于构建强大的去中心化应用程序的工具。 请参阅官方文档了解更多详情。

该模块是 0xcert Framework 的组成部分之一。 它是用 TypeScript 编写的，并且得到积极维护。 源代码可在 GitHub 上找到，您还可以在其中找到我们的 问题跟踪器。

Ethereum Utility Contracts

该模块包括 Solidity 合约，它应该对任何智能合约项目都有用。

Safe math -- safe-math.sol

该库包括无符号 256 位整数的基本算术运算。 这是一个现代的、省油的实现，其中还包括错误报告。

此实现基于 openzeppelin-solidity 但是文档和可读性代码有很大改进。 我们希望这将帮助您编写更多无错误的代码。

Exampe usage：

pragma solidity ^0.5.5;
import "https://github.com/0xcert/framework/packages/0xcert-ethereum-utils-contracts/src/contracts/math/safe-math.sol";

contract MilitaryStrengthAdder
{
  using SafeMath for uint256;

  function add(
    uint256 _addend1,
    uint256 _addend2
  )
    external
    pure
    returns (uint256 sum)
  {
    return _addend1.add(_addend2);
  }
}

Abilities -- abilitable.sol

这是一个权限模型，您可以在您的合同中将不同形式的权限分配给任何地址。 通常，这些权限将用于允许智能合约上的管理任务。

Ownership -- ownable.sol and claimable.sol

这是您可以用于任何智能合约的两种所有权模型。 Ownable 使用单一所有者模型，可以单方面转让给新所有者。 Claimable 将此模型扩展为两步转移过程，首先是现有的必须发送，新的所有者必须接收所有权特权。

Address utilities -- address-utils.sol

这使您可以检查任何地址是普通帐户还是智能合约。 请注意，普通账户可以成为智能合约（CREATE），智能合约也可以成为普通账户（SELFDESTRUCT）。

ERC-165 -- erc165.sol and supports-interface.sol

ERC-165 是您的智能合约支持的发布接口的标准。 如果您正在实施标准接口，那么您的合约最好使用 ERC-165 来识别它。 这使得其他合约可以很容易地检测到它是如何工作的，这样它们就可以按预期进行合作。