当前位置：首页 > news >正文

SolidityPy全课程：可升级合约代理模式终极指南

news 2026/5/15 10:16:59

SolidityPy全课程：可升级合约代理模式终极指南

【免费下载链接】full-blockchain-solidity-course-pyUltimate Solidity, Blockchain, and Smart Contract - Beginner to Expert Full Course | Python Edition项目地址: https://gitcode.com/gh_mirrors/fu/full-blockchain-solidity-course-py

SolidityPy全课程是一个从入门到专家的完整区块链开发教程，专注于Solidity智能合约与Python的结合应用。本文将深入探讨智能合约的可升级性，重点介绍代理模式的实现方法和最佳实践，帮助开发者构建灵活且可持续的区块链应用。

为什么智能合约需要可升级性？

智能合约一旦部署到区块链上，通常被认为是不可变的。然而，在实际开发中，合约可能需要修复漏洞、添加新功能或优化性能。可升级合约模式解决了这一矛盾，允许开发者在保持合约地址和状态不变的情况下更新合约逻辑。

可升级合约的核心挑战

实现可升级合约面临两大核心挑战：

状态保持：升级过程中不能丢失现有合约状态
逻辑更新：能够安全地替换合约逻辑

传统的合约迁移方法需要用户手动转移资产，不仅繁琐还可能导致资产损失。代理模式通过分离存储和逻辑，提供了更优雅的解决方案。

代理模式的工作原理

代理模式的核心思想是使用三个关键组件：

1. 代理合约（Proxy Contract）

代理合约是用户直接交互的合约，它维护所有的状态变量并将函数调用委托给实现合约。

2. 实现合约（Implementation Contract）

实现合约包含实际的业务逻辑。代理合约通过delegatecall操作码调用实现合约的函数，在代理合约的上下文中执行这些函数。

3. 管理合约（Admin Contract）

管理合约负责控制升级过程，决定何时以及如何更换实现合约。

常见的代理模式

透明代理模式（Transparent Proxy Pattern）

透明代理模式区分管理员和普通用户的调用：

管理员的调用直接由代理合约处理（如升级逻辑）
普通用户的调用则委托给实现合约

这种模式的优势是简单直观，但可能存在函数选择器冲突的风险。

通用升级代理标准（UUPS）

UUPS（EIP-1822）将升级逻辑放在实现合约中，而非代理合约。这种模式更节省gas，并且允许实现合约自定义升级逻辑。

钻石模式（Diamond Pattern）

钻石模式（EIP-2535）支持将合约逻辑分解为多个"切面"（facets），可以单独升级每个切面。这种模式提供了最大的灵活性，适合复杂合约系统。

实战：使用OpenZeppelin实现可升级合约

OpenZeppelin提供了安全可靠的代理合约库，大大简化了可升级合约的开发过程。

1. 安装必要的依赖

git clone https://gitcode.com/gh_mirrors/fu/full-blockchain-solidity-course-py cd full-blockchain-solidity-course-py

2. 创建基础合约

首先创建一个简单的Box合约，用于存储一个数值：

// contracts/Box.sol // SPDX-License-Identifier: MIT pragma solidity ^0.8.0; contract Box { uint256 private value; // Emitted when the stored value changes event ValueChanged(uint256 newValue); // Stores a new value in the contract function store(uint256 newValue) public { value = newValue; emit ValueChanged(newValue); } // Reads the last stored value function retrieve() public view returns (uint256) { return value; } }

3. 部署代理合约

使用OpenZeppelin的Upgradeable合约库部署代理：

# scripts/01_deploy_box.py from brownie import Box, ProxyAdmin, TransparentUpgradeableProxy, network, config from scripts.helpful_scripts import get_account def deploy_box(): account = get_account() print(f"Deploying to {network.show_active()}") box = Box.deploy( {"from": account}, publish_source=config["networks"][network.show_active()].get("verify", False), ) proxy_admin = ProxyAdmin.deploy({"from": account}) # Initializer function (no arguments in this case) initializer = box.store, 1 # This is a tuple with the function and arguments proxy = TransparentUpgradeableProxy.deploy( box.address, proxy_admin.address, initializer.encode_input(), {"from": account}, publish_source=config["networks"][network.show_active()].get("verify", False), ) print(f"Proxy deployed to {proxy}") # Interact with the proxy as if it were the Box contract proxy_box = Box.at(proxy.address) print(f"Initial value: {proxy_box.retrieve()}") return proxy_box

4. 创建升级合约

当需要添加新功能时，创建BoxV2合约：

// contracts/BoxV2.sol // SPDX-License-Identifier: MIT pragma solidity ^0.8.0; contract BoxV2 { uint256 private value; event ValueChanged(uint256 newValue); function store(uint256 newValue) public { value = newValue; emit ValueChanged(newValue); } function retrieve() public view returns (uint256) { return value; } // New function added in V2 function increment() public { value = value + 1; emit ValueChanged(value); } }

5. 执行升级

编写升级脚本，将代理指向新的实现合约：

# scripts/02_upgrade_box.py from brownie import Box, BoxV2, ProxyAdmin, TransparentUpgradeableProxy, network, config from scripts.helpful_scripts import get_account def upgrade_box(proxy): account = get_account() box_v2 = BoxV2.deploy( {"from": account}, publish_source=config["networks"][network.show_active()].get("verify", False), ) proxy_admin = ProxyAdmin[-1] proxy = TransparentUpgradeableProxy[-1] # Upgrade the proxy to BoxV2 proxy_admin.upgrade(proxy.address, box_v2.address, {"from": account}) print("Proxy upgraded to BoxV2!") # Interact with the upgraded proxy proxy_box = BoxV2.at(proxy.address) print(f"Testing increment: {proxy_box.retrieve()}") proxy_box.increment({"from": account}) print(f"After increment: {proxy_box.retrieve()}")