solidity 数学和密码学函数

数学和密码学函数为开发者提供了一系列强大的工具，用于执行各种数学运算和加密操作

addmod(uint x, uint y, uint k) returns (uint)

计算 (x + y) % k，加法会在任意精度下执行，并且加法的结果即使超过 2**256 也不会被截取。

从 0.5.0 版本的编译器开始会加入对 k != 0 的校验（assert）。

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

contract AddModExample {
  // 使用 addmod 函数计算 (x + y) % k
  // 20 % 3 = 2
  // 3 * 6 = 18 
  // 20 - 18 
  function safeModAdd(  uint256 x,  uint256 y,  uint256 k ) public pure returns (uint256) {
    // require(k != 0, "Modulus cannot be 0"); // 确保模数 k 不为 0
    return addmod(x, y, k);
  }
}

mulmod(uint x, uint y, uint k) returns (uint)

计算 (x * y) % k，乘法会在任意精度下执行，并且乘法的结果即使超过 2**256 也不会被截取。

从 0.5.0 版本的编译器开始会加入对 k != 0 的校验（assert）。

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

contract AddModExample {
    // 使用 addmod 函数计算 (x + y) % k
    // 20 % 3 = 2
    // 3 * 6 = 18 
    // 20 - 18 
    function safeModAdd(  uint256 x,  uint256 y,  uint256 k ) public pure returns (uint256) {
        // require(k != 0, "Modulus cannot be 0"); // 确保模数 k 不为 0
        return mulmod(x, y, k);
    }
}

keccak256(bytes memory) returns (bytes32)

计算输入的 Keccak-256 哈希值。

备注

以前 keccak256 的别名叫 sha3 ，在 0.5.0 版本中被删除。

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

contract AddModExample {
    function safeModAdd( string  calldata _a ) public pure  returns (bytes32 ) {
        return keccak256(bytes(_a));
    }
}

ripemd160(bytes memory) returns (bytes20)

计算输入的 RIPEMD-160 哈希值。

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

contract AddModExample {
    function safeModAdd( string  calldata _a ) public pure  returns (bytes20 ) {
        return ripemd160(bytes(_a));
    }
}