代理合约代码示例

仅看理论与漏洞案例还不够，开发者最终需要的是可以直接动手的代码示例。本文围绕 代理合约代码示例 给出从最简到生产级别的几组范例，并结合 Binance 智能链上的真实部署经验，让示例既具备教学意义，又能直接套用。

一、最简示例：手写 Proxy

最简版本就是一个空合约，只在 fallback 中执行 delegatecall。它能帮助你彻底理解 delegatecall 与 fallback 的协作。但这种手写版本不适合生产，因为缺少升级、权限、初始化保护。在 币安 链上做教学演示时，可以从这一版本开始，让学员体验「最薄」的代理。

二、引入 EIP-1967 槽位

下一版引入 EIP-1967 规定的固定存储槽，把 implementation 与 admin 地址写到指定槽位。这样区块浏览器才能识别它为代理合约，并展示对应的 implementation。这一版本是后续所有生产模板的基础。在 B安 智能链浏览器上观察这种代理时，会自动显示「Proxy」标识。

三、OpenZeppelin TransparentUpgradeableProxy

第三版直接使用 OpenZeppelin 的 TransparentUpgradeableProxy。它处理了升级、权限、初始化等大多数边界情况，是生产环境最常用的选择之一。结合 OpenZeppelin Upgrades 插件，部署流程极其简洁。许多 BN 链上的项目都直接基于这一模板搭建。

四、UUPS 版本

第四版换成 UUPS。它把升级函数放到 implementation 中，proxy 更加轻量，但 implementation 必须自行实现升级权限校验。UUPS 适合对 Gas 极度敏感的协议。许多 BN交易所 链上的高频协议都采用 UUPS 来节省调用成本。

五、组合多模块：Diamond 雏形

最后一版给出一个简化的 Diamond（钻石）模式雏形。它把多个 facet 共享同一存储，并通过 selector 表分发调用。Diamond 模式适合超大型协议，但复杂度也最高。把这五种代码示例放在同一仓库中持续维护，并配套写完整的单元测试与升级演练，你就会拥有一份可信赖、可生产、可教学的代理合约样板，长期都能反复复用。