以太坊，作为全球领先的智能合约平台，其核心魅力在于允许开发者部署去中心化应用（DApps），而智能合约，这些运行在以太坊虚拟机（EVM）上的自动执行程序，其功能实现离不开各种函数，本文将为您梳理以太坊智能合约中常用的函数类型、核心函数库以及实践中的注意事项，助您构建更强大、更安全的智能合约。

智能合约函数的基础：理解分类

在深入具体函数之前，我们先了解智能合约函数的基本分类,这对于理解函数行为至关重要：

  1. 按可见性（Visibility）分类：

    • public：公有函数，可以在合约内部和外部调用，编译器会自动为 public 状态变量生成一个 getter 函数。
    • private：私有函数，只能在当前合约内部调用,不能被继承的合约访问。
    • internal：内部函数，可以在当前合约及其子合约中调用，类似于 private,但可继承。
    • external：外部函数，只能从合约外部调用（通过消息调用），不能在合约内部直接调用（除非使用 this）。external 函数在接收大量数据时更高效。

  2. 按状态修改（State Mutability）分类：

    • pure：纯函数，不读取也不修改合约的状态变量,保证函数执行不会产生任何副作用。
    • view：视图函数，只读取合约状态变量，不修改,保证函数执行不会改变区块链状态。
    • nonpayable：非 payable 函数,不能接收以太币。
    • payable：payable 函数,可以接收以太币。

  3. 按功能性质分类：

    • 构造函数（Constructor）：在合约部署时执行一次,用于初始化合约状态。
    • Fallback/Receive 函数：特殊函数，用于接收没有指定函数调用的数据（fallback）或直接接收以太币（receive，Solidity 0.6.0+ 引入）。
    • 普通函数：实现合约核心逻辑的函数。

核心 Solidity 函数库与常用函数

Solidity 作为以太坊最主流的智能合约开发语言，内置了许多标准库和常用函数,以下是一些最核心和常用的：

  1. 地址（Address）相关函数：

    • address.balance：获取地址（可以是合约地址或普通账户）的以太币余额（单位：wei）。
    • address.transfer(value)：向指定地址发送以太币（单位：wei），发送失败会回滚，只发送 2300 gas,适合简单转账。
    • address.send(value)：与 transfer 类似，但返回 bool 表示是否成功，不推荐使用,因为可能被恶意合约重入攻击。
    • address.call.value(value)("")：最灵活的发送方式，可以发送 gas 和数据，返回 (bool, bytes memory),需谨慎处理重入风险。
    • address.delegatecall(payload)：在当前合约上下文中执行目标合约的代码,保持当前合约的存储和状态。
    • address.staticcall(payload)：与 delegatecall 类似，但保证不会修改状态（纯查询）。

  2. 数学运算（Math）相关函数：

    • 标准库 Math：
      • Math.min(a, b) / Math.max(a, b)：返回两数的最小值/最大值。
    • 标准库 SafeMath（已废弃，Solidity 0.8.0+ 内置溢出检查）：
      • a.add(b) / a.sub(b) / a.mul(b) / a.div(b)：安全的加、减、乘、除，在旧版本中防止溢出/下溢。
    • 位运算：
      • a & b（按位与）、a | b（按位或）、a ^ b（按位异或）、~a（按位取反）
      • a << b（左移）、a >> b（右移）
      • a ** b（幂运算）
    • 其他：
      • uint256(a)：类型转换。
      • assert(condition)：用于内部错误检查，失败时回滚（0.8.0+ 用于不应发生的错误）。
      • require(condition, message)：用于输入验证和条件检查，失败时回滚并返回错误信息（最常用）。
      • revert(message)：无条件回滚,并返回错误信息。

  3. 字符串（String）相关函数：

    • string.concat(s1, s2, ...)：连接字符串（Solidity 0.8.0+）。
    • string.toBytes(string memory)：字符串转字节数组。
    • string.toString(bytes32 memory) / string.toString(bytes memory)：字节数组转字符串。
    • abi.encodePacked(...) / abi.encode(...) / abi.encodeWithSelector(...) / abi.encodeWithSignature(...)：ABI 编码函数,常用于参数打包或与外部合约交互。

  4. 数组（Array）相关函数：

    • array.length：获取数组长度。
    • array.push(value)：向数组末尾添加元素。
    • array.pop()：移除数组末尾元素并返回。
    • array[i] = value：修改指定索引元素。
    • delete array[i]：将指定索引元素置为默认值（对于 uint 是 0，address 是 address(0) 等）,不会缩短数组长度。
    • array.slice(start, length)：切片（Solidity 0.8.0+）。
    • array.find(bool function(bytes memory) pure returns (bool) memory)：查找元素（Solidity 0.8.0+）。

  5. 映射（Mapping）相关操作：

    • mapping[keyType] => valueType：定义映射。
    • mapping[key] = value：设置键值对。
    • mapping[key]：获取键对应的值（如果不存在，对于值类型会返回默认值）。
    • delete mapping[key]：删除键值对（将值重置为默认值）。

  6. 结构体（Struct）和枚举（Enum）：

    • 定义结构体和枚举后，可以通过点号 访问其成员变量。
    • myStruct.name = "Alice";，enumStatus = enumStatus.Value2;

  7. 事件（Event）与日志：

    • event EventName(parameter1 type1, parameter2 type2, ...);：定义事件。
    • emit EventName(value1, value2, ...);：触发事件，用于记录链上日志,方便前端监听和合约间通信。

  8. 修饰符（Modifier）：

    • 虽然不是函数，但修饰符常用于函数，以改变函数的行为，例如进行权限检查、状态前置条件等。
    • modifier onlyOwner() { require(msg.sender == owner); _; }，_ 表示函数体的剩余部分。

  9. 合约交互相关函数：

    • OtherContract.functionName(value)：调用同一项目中或其他已部署合约的 public/external 函数。
    • OtherContract(payable).value(amount)()：向 payable 合约构造
      随机配图
      函数或 payable 函数发送以太币并调用（需谨慎）。

实践中的注意事项

  1. 安全性第一：

    • 始终使用 require 进行输入验证和条件检查。
    • 警惕重入攻击（使用 Checks-Effects-Interactions 模式）。
    • 注意整数溢出/下溢（Solidity 0.8.0+ 已内置保护，但仍需了解原理）。
    • 谨慎使用 call、delegatecall、staticcall，理解其 gas 传递和上下文影响。

  2. Gas 优化：

    • 避免在循环中进行昂贵的操作（如存储写入、外部调用）。
    • 尽量使用 calldata 传递大参数给 external 函数。
    • 合理使用 memory 和 storage 变量，memory 读取和写入成本较低。
    • 考虑使用更小的数据类型（如 uint16 代替 uint256）如果数值范围允许。

  3. 可升级性与可维护性：

    如果合约需要升级，考虑使用代理模式（如 Transparent Proxy, UUPS Proxy）。