📚 课程目录第1章课程导入

课程导入：学习目标、适用人群、课程整体框架与项目预览

去中心化永续合约（Decentralized Perpetual Futures）是当前链上衍生品赛道中发展最迅猛、技术复杂度最高、资金规模增长最快的方向之一。与传统中心化交易所（CEX）的永续合约不同，去中心化永续合约将订单簿、资金费率、清算引擎、保证金管理、预言机价格喂送等核心模块全部或部分迁移到区块链上，通过智能合约实现资产的非托管、交易的透明可验证以及清算的自动化执行。本课程不满足于概念层面的科普，而是以“从零搭建一套可运行的链上永续合约交易系统”为最终交付目标，带领学员完整走一遍从需求分析、架构设计、合约开发、安全审计到前端交互、部署运维的全流程。

1.1 学习目标：学完本课程你将具备什么能力

本课程的学习目标不是“了解”或“知道”，而是“能独立搭建并交付一套可运行的链上永续合约交易系统”。具体拆解为以下五个层级的能力目标：

能力层级	具体目标	对应模块
原理认知	透彻理解永续合约的定价模型、资金费率机制、清算逻辑与保证金模型	模块一（第1-6章）
合约开发	使用 Solidity 编写 Vault、保证金账户、仓位管理、清算引擎等核心合约	模块二（第7-14章）
安全防护	识别并防御重入攻击、闪电贷操纵、预言机延迟、清算竞态等典型漏洞	模块三（第15-20章）
前端集成	基于 React + wagmi 构建交易界面，实现下单、持仓、盈亏实时展示	模块四（第21-25章）
部署运维	完成测试网部署、合约升级、监控告警与清算机器人搭建	模块五（第26-30章）

除了技术能力，本课程还注重培养学员的工程思维。在每一章的实战环节中，你都会面对真实的设计取舍：例如在“全仓保证金 vs 逐仓保证金”的选择中，你需要理解两种模式对资金利用率和清算风险的不同影响；在“链上订单簿 vs AMM”的架构决策中，你需要权衡交易深度、Gas 成本和用户体验。这些决策能力是高级 DeFi 开发者的核心竞争力。

  课程承诺：完成本课程后，你将拥有一个部署在 Arbitrum Sepolia 测试网上的完整永续合约交易平台（DePerpX），包含前端界面、后端监控脚本、自动化清算机器人和完整的测试用例。该项目的代码结构可以直接作为你求职作品集或创业项目的起点。

1.2 适用人群：这门课适合谁？需要什么基础？

本课程的定位是“实战进阶”，而非“零基础入门”。为了保证学习效果，建议学员具备以下基础条件：

Solidity 基础：了解合约的基本结构、函数修饰符、事件定义，能编写简单的 ERC-20 代币合约。如果你还不太熟悉，建议先花一周时间完成 CryptoZombies 或 WTF Academy 的 Solidity 入门教程。
DeFi 基本概念：理解 AMM（如 Uniswap）、借贷协议（如 Aave）的基本运作逻辑，知道什么是流动性池、什么是无常损失。
JavaScript/TypeScript 基础：前端部分使用 React + wagmi，需要你具备基本的 React 组件开发能力和异步编程概念。
区块链交互经验：会使用 MetaMask 连接测试网，了解 Gas 费、交易哈希、区块确认等基本概念。

如果你满足以上条件，那么无论你是以下哪种身份，本课程都能为你提供显著的价值：

人群类型	当前痛点	课程收益
DeFi 开发者	做过简单的 ERC-20 或 NFT 项目，想挑战高复杂度金融协议	掌握衍生品合约的核心逻辑，简历上增加一个高含金量项目
量化交易工程师	熟悉 CEX 的永续合约接口，但不懂链上实现原理	理解去中心化衍生品的清算机制和资金费率套利空间
安全审计初学者	想进入智能合约审计行业，但缺乏复杂金融合约的分析经验	通过本课程掌握 DeFi 衍生品的高风险点，为审计打基础
创业者/产品经理	想搭建衍生品 DEX，但技术团队评估成本过高	理解技术实现路径，能更准确地评估开发周期和资源需求

注意：本课程不包含 Solidity 语法的基础教学。如果你完全没写过合约，建议先补充基础语法知识再开始本课程。否则在第 7 章开始编写 Vault 合约时可能会感到吃力。

1.3 课程整体框架：五大模块、三十章递进式学习

课程按照“原理 → 合约 → 安全 → 前端 → 运维”的逻辑递进，每一章都建立在前一章的基础上。下面用一张框架表来展示完整的课程结构：

模块	章节范围	核心内容	实战产出
模块一基础与原理	第1-3章	永续合约机制、资金费率、保证金模型	设计文档：DePerpX 需求规格说明书
模块一基础与原理	第4-6章	AMM/订单簿/混合模型、预言机安全、清算机制	架构选型报告：确定采用 Vault + 链上订单簿方案
模块二合约开发	第7-10章	Vault 合约、保证金账户、仓位管理、交易对	核心合约 v1：支持开仓/平仓/加仓/减仓
模块二合约开发	第11-14章	指数价格聚合、资金费率结算、清算执行、Gas 优化	核心合约 v2：完整交易生命周期 + 清算
模块三安全与风控	第15-17章	重入/闪电贷/预言机攻击、清算竞态与 MEV	安全加固：引入重入锁、TWAP 喂价、最小清算阈值
模块三安全与风控	第18-20章	权限管理、多签方案、测试网压力测试	审计报告 + 修复记录 + 测试覆盖率报告
模块四前端与集成	第21-23章	React + wagmi 环境搭建、K线图与深度图	交易面板 UI：下单表单、持仓列表、盈亏图表
模块四前端与集成	第24-25章	事件监听、实时仓位更新、多链部署	前端与合约全链路打通，支持 Arbitrum Sepolia
模块五部署与运维	第26-28章	Hardhat 部署脚本、合约升级（UUPS）、监控告警	自动化部署脚本 + 监控面板（Grafana + Prometheus）
模块五部署与运维	第29-30章	清算机器人、链上数据索引（The Graph）	完整 DePerpX 系统上线测试网，附操作手册

这种递进式设计保证了每个阶段的学习都有明确的产出物。你不需要等到课程结束才能看到成果——从第 7 章开始，你就能在测试网上部署自己的第一个 Vault 合约；到第 14 章，你的合约已经支持完整的交易生命周期；到第 25 章，你已经拥有一个可以交互的网页应用。这种“边学边建”的方式能极大提升学习动力和知识留存率。

1.4 项目预览：DePerpX 系统架构与核心功能

整个课程将围绕一个名为 DePerpX 的去中心化永续合约交易平台展开。在正式开发之前，我们先预览这个系统的整体架构和核心功能，让你对最终目标有一个清晰的认知。

DePerpX 的核心设计决策：

交易模型：采用 Vault + 链上订单簿的混合模式。Vault 作为所有用户的统一对手方，订单簿负责价格发现和撮合。这种设计比纯 AMM 模式有更好的价格精度，比全链上订单簿模式有更低的 Gas 消耗。
保证金模式：同时支持全仓（Cross Margin）和逐仓（Isolated Margin）。全仓模式下，用户的账户余额在所有仓位间共享；逐仓模式下，每个仓位有独立的保证金，风险隔离。
预言机方案：使用 Chainlink 价格源 + 链上 TWAP（时间加权平均价格）作为双重保障。当 Chainlink 价格与 TWAP 价格偏差超过 1% 时，触发价格保护机制，暂停开仓。
清算机制：采用“部分清算”策略，当保证金率低于维持保证金率时，清算人可触发清算，但只清算掉使保证金率恢复到安全水平所需的仓位比例，避免“一刀切”式清算对用户造成过大损失。
资金费率：每 8 小时结算一次，资金费率根据合约价格与现货价格的溢价/折价动态调整，范围在 -0.1% 到 +0.1% 之间。

DePerpX 的系统架构包含以下核心组件：

组件	职责	技术选型
Vault 合约	管理所有用户的保证金存款、记录仓位、执行清算	Solidity 0.8.20 + OpenZeppelin
交易对合约	维护每个交易对的指数价格、资金费率、持仓上限	可升级合约（UUPS 模式）
订单簿合约	存储限价单、吃单/挂单匹配逻辑	链上订单簿 + 事件驱动
清算机器人	监控所有账户的保证金率，自动触发清算	Node.js + ethers.js + cron job
前端交易面板	K线图、下单、持仓管理、历史成交	React + wagmi + Lightweight Charts
数据索引服务	从链上事件中提取交易数据，提供 API 查询	The Graph + Subgraph

下面我们用一个具体的交易场景来演示 DePerpX 的工作流程，帮助你理解各组件如何协同工作：

  场景演示：用户 Alice 在 DePerpX 上开 2 ETH 的多头仓位，杠杆 10 倍。

  步骤 1：Alice 存入 0.2 ETH（价值约 400 美元）作为保证金，调用 Vault 合约的 deposit() 函数。

  步骤 2：Alice 提交市价买单，订单簿合约匹配到 Bob 的限价卖单，成交价 2000 美元/ETH。

  步骤 3：Vault 合约记录 Alice 的仓位：名义价值 4000 美元，保证金 400 美元，杠杆 10 倍。

  步骤 4：8 小时后资金费率结算，若资金费率为正（多头支付空头），Alice 支付 4000 × 0.01% = 0.4 美元给空头方。

  步骤 5：ETH 价格跌至 1900 美元，Alice 的仓位浮亏 200 美元，保证金率降至 (400-200)/4000 = 5%，低于维持保证金率 6.25%。

  步骤 6：清算机器人检测到 Alice 的保证金率低于阈值，调用 liquidate() 函数，部分清算 50% 仓位（1 ETH），Alice 的保证金率恢复到安全水平。

  步骤 7：Alice 在价格回升后手动平掉剩余仓位，完成整个交易周期。

这个场景展示了 DePerpX 的核心功能：保证金管理、订单撮合、资金费率结算、清算保护。在后续章节中，我们将逐一实现这些功能模块，每一步都有对应的代码和测试。

1.5 学习方法与常见误区

最后，针对本课程的学习方法，给出几点建议和常见误区提醒：

推荐的学习路径：

先跑通，再深入：每一章的代码示例，先照着敲一遍、跑通测试，再回头研究每一行的含义。不要一开始就试图理解所有细节。
善用测试网：所有合约部署和交互都在测试网进行。测试网的 ETH 可以从水龙头免费获取，不要在主网尝试。
记录问题日志：遇到报错时，记录下错误信息、当时的操作步骤和最终解决方案。这些日志是你面试时最好的项目复盘素材。
参与社区讨论：课程中的难点（如清算竞态、预言机安全）建议在 DeFi 开发者社区（如 Ethereum Magicians、Discord 群组）中讨论，往往能获得不同的视角。

常见误区一：认为“合约能跑通就万事大吉”。在 DeFi 中，合约的安全性和边界条件处理远比功能实现重要。一个没有处理极端情况的合约，在真实资金面前就是一颗定时炸弹。

常见误区二：忽视 Gas 优化。链上永续合约的每次操作都涉及多个合约调用，Gas 消耗直接影响用户体验。本课程在第 14 章会专门讲解 Gas 优化技巧，但你在编写每一行代码时都应该有 Gas 意识。

常见误区三：跳过安全章节。很多学员觉得安全是审计公司的事，自己只需要写功能代码。但事实上，理解攻击原理能帮助你写出更健壮的代码，也能让你在团队中承担更重要的角色。

本课程的设计理念是“在实战中学习，在复盘中成长”。每一章都包含理论讲解、代码实现、测试验证和常见问题总结。建议你准备一个专门的 GitHub 仓库来管理课程代码，每完成一章就提交一次 commit，这样你最终会拥有一份完整的项目开发历史，这也是你技术成长的最好见证。