从这一课开始，我们将会进入实战环节，通过编写测试来学习 Solidity 合约的各种高级用法。
Engineering Notes
孟斌的小站
技术博客与学习记录
在复杂的智能合约系统中，代码复用与模块化至关重要。Solidity 提供了 库（Library） 机制，用来组织可重用逻辑，避免重复开发与部署，提升合约的可维护性与安全性。
1、可升级的必要性与问题
1. 区块链合约不可变的特性
- 在区块链上部署的合约代码是永久存储的，不可直接更改或删除。
- 这种不可变性保障了去中心化和安全性，但也意味着：
- 一旦有 bug，无法直接修改。
- 一旦需要新增功能，只能重新部署一个新版本。
2. 部署新合约迁移 vs 升级逻辑合约
- 部署新合约迁移
- 需要将旧合约中的状态数据（余额、映射等）迁移到新合约。
- 迁移过程复杂、易出错、消耗大量 gas。
- 用户需要更新交互地址，容易引起混乱。
- 升级逻辑合约
- 通过代理模式保留原有存储，替换逻辑实现。
- 用户交互地址不变，数据原地保留。
- 只需在升级时注意存储布局一致性。
2、可升级合约的核心思想
- 问题：合约一旦部署，代码无法更改。
- 解决方案：将合约分为 代理合约（Proxy） 和 逻辑合约（Implementation）。
- 代理合约：存储状态变量，转发调用给逻辑合约。
- 逻辑合约：包含可执行代码。
- 关键技术：
delegatecall，在代理合约中使用delegatecall调用逻辑合约的函数，使得代码在代理的存储上下文中执行。
3、代理模式的工作原理
1. delegatecall 复习
(bool success, bytes memory data) = implementation.delegatecall(msg.data);
delegatecall会在当前合约的存储和上下文中执行目标合约的代码。- 状态变量读写会影响代理合约，而不是逻辑合约。
2. 存储布局一致性
- 代理合约和逻辑合约必须保持相同的状态变量声明顺序和类型，否则会出现数据错位。
4、常见可升级合约模式
1. 透明代理（Transparent Proxy）
- EIP-1967 标准。
- 普通用户调用逻辑合约函数；管理员调用代理的管理函数（升级逻辑合约地址）。
- 优点：简单、被广泛支持（OpenZeppelin Proxy）。
- 缺点：管理逻辑和业务逻辑混在同一个合约中，稍显冗余。
2. UUPS（Universal Upgradeable Proxy Standard）
- EIP-1822 标准。
- 升级逻辑放在逻辑合约自身，由
upgradeTo函数完成。 - 优点：代理合约更轻量，升级逻辑可定制。
- 缺点：升级安全完全依赖逻辑合约实现，容易被错误实现破坏。
3. Beacon Proxy
- 使用一个 Beacon 合约统一存储逻辑合约地址，多个代理共享升级源。
- 适合多实例共享逻辑的场景。
5、可升级合约的安全陷阱
| 风险点 | 说明 | 解决方案 |
|---|---|---|
| 存储布局冲突 | 升级后逻辑合约的变量顺序、类型不一致，导致数据错位 | 遵循固定的变量追加规则，避免删除或更改类型 |
| 初始化漏洞 | 新逻辑合约的构造函数不会被代理调用 | 使用 initializer 修饰的初始化函数，防止重复初始化 |
| delegatecall 风险 | 调用外部不可信合约可能破坏存储 | 严格控制升级权限，禁止不可信代码执行 delegatecall |
| 权限丢失 | 升级过程中可能被替换成恶意逻辑 | 使用多签或 Timelock 控制升级 |
6、Foundry 实现示例
在我们的测试用例中，实现思路如下：
1. 三种低级调用方式对比
| 调用方式 | 是否切换上下文（storage/msg.sender/msg.value） | 是否能改状态 | 特点与用途 |
|---|---|---|---|
call |
✅ 切换到被调用合约 | ✅ | 最通用的外部调用，可带 ETH，可调用任意函数 |
delegatecall |
❌ 保持当前合约上下文 | ✅ | 代理模式核心，让当前合约执行别人的代码 |
staticcall |
✅ 切换到被调用合约 | ❌ | 安全读取外部数据，不改状态 |
记忆口诀：
在以太坊的世界里，合约函数调用不是“直接调用函数”，而是发送一段经过 ABI 编码的二进制数据。这些数据不仅包含了调用哪个函数的信息，还包括函数参数的序列化内容。理解 ABI 编码与函数选择器，可以帮助我们：
在 Solidity 智能合约开发中，失败并不可怕，可怕的是失败后状态不明确、资金不安全、调用方摸不着头脑。EVM 的一个重要特性是：当合约执行中发生错误时，会回滚所有状态更改，并退还未使用的 Gas。因此，正确使用错误处理机制，能够让合约在异常情况下安全地停止，而不是留下一地鸡毛。
Go 语言以其并发编程能力著称，而 goroutine 是实现这一特性的核心。在日常开发中，我们很容易启动 goroutine，但如果不了解它的生命周期与回收机制，就可能引发性能问题甚至 goroutine 泄漏。
在 Solidity 的世界里，大多数函数都有明确的名字、参数和用途。但还有两个比较特别的“隐形入口”函数：receive() 和 fallback()。
它们不需要（也不能）显式调用，却能在特定场景下自动触发，决定了一个合约如何接收 ETH，以及如何应对未知调用。
在 Solidity 中，我们无法像 JavaScript 那样 console.log("...") 来查看运行状态。但我们有事件（Event）机制——既是合约的“日志打印工具”，也是链下交互的主要接口。
模块化开发是大型合约系统不可或缺的组成部分。本课简单剖析 Solidity 中的继承（Inheritance）、接口（Interface）、抽象合约（Abstract Contract）等关键机制，帮你在合约系统中正确地拆分职责、重用逻辑、规范合约交互，而不是简单复制粘贴。