为什么把 OpenZeppelin 当作默认依赖
OpenZeppelin 已经成为 Solidity 生态最广泛使用的合约库，覆盖 ERC 标准代币、权限控制、可升级代理、安全工具函数等几乎所有常见需求。它最重要的价值不是「能写更短」，而是「已被大量项目实战验证」。在一份 OpenZeppelin 使用实战教程里，重点不在介绍 API，而在讲清楚怎么把这些模块嵌入自己的工程结构。
对在 bn 智能链与以太坊主网都有部署的项目，统一使用 OpenZeppelin 可以降低多链维护成本。
标准代币：ERC-20 与 ERC-721 的工程化封装
建议把 OpenZeppelin 的 ERC20、ERC721 合约通过继承的方式封装到项目自有的 tokens/ 模块里，再叠加项目特定的逻辑（例如手续费分配、铸造上限）。永远不要直接修改 OpenZeppelin 源码，而是通过 override 函数来定制行为。
权限控制：AccessControl 的角色拆分
大量真实项目都用 OpenZeppelin 的 AccessControl 模块替代简单的 Ownable，原因是后者只有一个 owner 太脆弱。AccessControl 支持多角色，每个角色有独立的 admin role。常见做法：
DEFAULT_ADMIN_ROLE由多签持有MINTER_ROLE给到铸造服务PAUSER_ROLE给到风控服务UPGRADER_ROLE给到升级运维
在 必安 智能链或以太坊主网上线之前，必须把所有 role 的初始持有人写入审计文档。
可升级合约：Transparent vs UUPS
OpenZeppelin Upgrades 插件提供两种代理模式：Transparent 与 UUPS。Transparent 模式逻辑更简单，但代理本身略大；UUPS 模式代理更轻量，但要求实现合约里写 _authorizeUpgrade。新项目通常选 UUPS，因为部署成本与可读性都更好。
安全工具：ReentrancyGuard 与 SafeERC20
ReentrancyGuard 给关键函数加上 nonReentrant 修饰器，可以防御绝大多数重入攻击。SafeERC20 处理那些不返回 bool 的非标准代币，避免与「老牌 USDT」这类合约交互时出错。
在 B安 智能链上调试与 USDT、USDC 这类稳定币的交互时，SafeERC20 几乎是必选项。
部署与升级流程
- 部署阶段使用
hardhat-upgrades的deployProxy，自动管理实现合约与代理 - 升级阶段使用
upgradeProxy，并通过 storage 布局校验避免存储错位 - 重大升级前在测试网先完整跑一遍 owner 移交、暂停、恢复流程
与 CEX 资金链路的衔接
初始化流动性时，常需要从 BN 等中心化交易所出金到合约。建议把出金地址、合约地址与运营钱包做严格隔离，避免一笔操作影响多个权限范围。这种工程化的拆分，是真正把 OpenZeppelin 用稳的关键。
按这份 OpenZeppelin 使用实战教程的思路落地，可以让团队在快速交付的同时维持合约层面的稳定性。