简介这套基于以太坊区块链的去中心化微博系统设计与实现方案面向计算机、软件工程、信息工程等专业学生与开发者主要解决区块链社交平台从合约设计到前端落地的问题适用于毕业设计、课程实践及进阶学习。压缩包共38个文件、约2.68MB包含Solidity智能合约、Truffle迁移部署脚本、JSON配置、前端页面与界面截图、设计报告PDF及LaTeX源文件还有备份文件与Git配置工程结构完整、目录清晰便于按模块检索和二次开发。项目包含完整的设计报告、系统架构图、用户端与管理端页面、系统流程图和Ganache迁移演示覆盖从智能合约编写、部署到前端交互的完整链路核心代码经过充分验证在毕业设计评审中获优。目前已有69人学习下载适合具备一定基础的开发者基于现有架构做扩展与定制也可作为初学者研读区块链应用的进阶案例。1. 基于以太坊的去中心化微博系统它解决什么、源码能拿来做什么看到基于以太坊的去中心化微博系统设计与实现含完整源码与文档第一反应往往是微博本来就是免费的为什么要上链这个问题的实际答案是省不掉的三项权利内容发布权、账号所有权和内容存续权。链上微博没有运营方审核不会因为一条投诉就删帖只要以太坊网络还在你发过的内容和关注关系就能被任何人查证。它适合三类人想理解 DApp 前后端如何协作的区块链开发初学者需要一套可运行源码做课程设计或技术验证的在校生以及做社交协议产品调研的工程师。整套路线的常见组成是一份 Solidity 智能合约、一个与钱包交互的前端、一套事件索引方案以及配套的部署与接口文档。下面按设计选型 → 合约实现 → 前端接入 → 索引排错的顺序展开。2. 设计与选型从微博模型到以太坊可落地结构2.1 微博的核心数据模型与链上存储取舍微博系统的实体一共四类用户、帖子、关系、互动。用户需要地址、昵称、头像、简介帖子需要作者、内容、时间戳、引用来源关系包含关注与拉黑互动包含点赞、转发和评论。去中心化微博与传统微博的差别不在模型本身而在存放位置。常见工程做法是分层存储短文本直接写入合约状态图片与大段内容放到 IPFS链上只保存内容寻址的 CIDContent Identifier。这个取舍的根本原因是 gas 成本。以太坊写一个新存储槽的基准开销是 20000 gas字符串按字节继续累加长文本在链上分摊下来非常贵。一个 80 字符的帖子在测试网写入要消耗十万级 gas图片动辄几百 KB塞进 calldata 既不现实也没有必要。我一般建议的混合模式是帖子正文在 280 字节以内直接上链保证内容可校验、可审计图片和视频先上传 IPFS帖子内容里存 CID用户头像与封面存 IPFS CID合约里只维护 CID 的更新记录。这样内容存续由 IPFS 网络保证发布记录不可篡改由以太坊保证两件事各归其位。文档里如果写了 storage 和 memory 的 gas 对比那才是真正考虑过生产成本的源码而不是把传统 CRUD 搬到合约上。2.2 事件驱动的消息流为什么不在链上建关系表第二个容易踩坑的设计点是时间线。传统微博需要一张 follow 表和一张 post 表做连接查询链上合约也可以这么写维护一个 mapping(address address[]) 保存关系再遍历关注者查帖子。问题在于遍历落在链下读取阶段合约本身没有查询所有关注者最新帖子的原语最终还是需要一套索引服务。更贴合以太坊的做法是事件即数据。把发帖、点赞、关注定义成事件事件参数携带作者地址、微博 UID、内容哈希和时间戳链下服务订阅事件后写入数据库再用 SQL 或内存索引重建时间线。这样合约状态量小写入成本低索引端反而能拿到完整行为流。注意与很多开发者的直觉相反事件不会消耗大量 gas事件日志是 EVM 的原生特性写入成本比状态写入低得多。2.3 存储成本估算一次发帖到底花多少钱下面这张表按 Solidity 0.8.20 与 Hardhat 本地网络估算实际数值以部署时的 gas 价格为准操作涉及存储预估 gas说明注册用户地址→UID、昵称、头像 CID约 12 万首次写入多个存储槽发帖80 字节正文、时间戳、作者约 10 万字符串每 32 字节一个槽转发原帖 ID、附加评论约 8 万不复制原帖正文点赞帖子 ID→地址集合约 6 万先查重再写入注意gas 数值受编译器优化开关影响。开启 --optimize 与 --optimize-runs 200 之后同一段合约代码的 gas 最多能差出 15% 左右对比成本时要在同一份配置下比较。gas 大头在 SSTORE 的冷写入一个可选优化是把正文先取 keccak256链上存 32 字节哈希正文存 IPFS代价是链上读不到明文必须由索引服务拼接。这个取舍在成本上大约能降 30%但可验证性变弱教学向源码一般不推荐。2.4 源码目录规划拿到源码后先读哪几个文件一份能跑的以太坊微博源码目录结构通常长这样weibo-dapp/ ├── contracts/ │ └── Weibo.sol # 主合约用户、帖子与互动 ├── scripts/ │ ├── deploy.js # 部署脚本 │ └── seed.js # 测试数据写入脚本 ├── test/ │ └── weibo.test.js # 合约行为测试 ├── frontend/ │ ├── src/ │ │ ├── api/ethers.js # 钱包与合约封装 │ │ ├── components/ # 发帖、时间线、关注按钮 │ │ └── store/ # 本地状态管理 │ └── package.json ├── indexer/ │ ├── listen.js # 事件监听与入库 │ └── schema.sql # 时间线重建表结构 └── docs/ ├── 部署文档.md └── 接口文档.md拿到源码先读 contracts/Weibo.sol 的数据结构定义再看 test 目录覆盖了哪些用户行为最后启动 indexer/listen.js 确认事件字段完整。很多号称完整源码的项目合约能编译但缺事件前端只能显示自己刚发的帖子历史数据一片空白这类代码在选型阶段就要直接排除。3. 核心合约实现身份、发帖与互动的 Solidity 代码3.1 用户注册与微博 UID 的映射去中心化微博的账号体系比传统微博多一层映射每个用户有一个自增的微博 UID同时又与一个以太坊地址绑定。这样前端可以像微博那样展示UID #10086合约层则只用 address 作为权限依据。注册、查询、反向查询都需要这一层。// SPDX-License-Identifier: MIT pragma solidity ^0.8.20; contract Weibo { struct User { string nickname; // 昵称直接存链上 string avatarCid; // 头像的 IPFS CID uint256 uid; // 微博 UID等于注册顺序 bool registered; } mapping(address User) public users; mapping(uint256 address) public uidToAddress; uint256 public nextUid 1; event UserRegistered(address indexed user, uint256 indexed uid, string nickname); function register(string calldata nickname, string calldata avatarCid) external { require(!users[msg.sender].registered, already registered); require(bytes(nickname).length 0 bytes(nickname).length 32, bad nickname); users[msg.sender] User(nickname, avatarCid, nextUid, true); uidToAddress[nextUid] msg.sender; emit UserRegistered(msg.sender, nextUid, nickname); nextUid; } }逻辑说明register 用 msg.sender 作为唯一键UID 由合约自增同时维护 uidToAddress 反向映射。前端既可以用地址查 UID也可以用微博 UID 反查地址正好覆盖我的主页和搜索用户 UID两个入口。参数 nickname 走 calldata 比 memory 省 gas昵称长度限制 32 字节是为了把字符串压缩到一个存储槽以内降低成本。注意这里没有做昵称唯一性校验。若要保证一个昵称全网唯一就再维护一个 mapping(bytes32 bool) 记录昵称的 keccak256注册前 require 不重复。Solidity 里 string 不能直接作为 mapping 的 key必须先用 keccak256 转成 bytes32这是新手最常踩的编译错误。3.2 发帖、转发与事件字段设计帖子核心是一个自增 postId外加作者、内容、引用来源。关键设计是让转发帖与原帖共用同一个 PostCreated 事件索引端只需要订阅一个事件就能重建完整的微博时间线。event PostCreated( uint256 indexed postId, address indexed author, uint256 indexed uid, string content, // 正文最多约 93 个中文字 string contentCid, // 图片或长文的 IPFS CID uint256 repostOf, // 0 表示原创非 0 表示转发原帖 ID uint256 timestamp ); mapping(uint256 Post) private posts; uint256 public postId 1; function createPost(string calldata content, string calldata contentCid) external { require(users[msg.sender].registered, not registered); require(bytes(content).length 0, empty content); require(bytes(content).length 280, too long); posts[postId] Post(msg.sender, users[msg.sender].uid, content, contentCid, 0, block.timestamp); emit PostCreated(postId, msg.sender, users[msg.sender].uid, content, contentCid, 0, block.timestamp); postId; } function repost(uint256 originalId, string calldata comment) external { require(users[msg.sender].registered, not registered); require(originalId 0 originalId postId, post not exists); posts[postId] Post(msg.sender, users[msg.sender].uid, comment, , originalId, block.timestamp); emit PostCreated(postId, msg.sender, users[msg.sender].uid, comment, , originalId, block.timestamp); postId; }逻辑说明两个写函数共用同一个事件转发帖靠 repostOf 区分索引端重建谁转发了谁时对 repostOf 做一次关联即可。这里的上限 280 是字节而不是字符中文在 UTF-8 下每字占 3 字节280 字节约等于 93 个汉字如果产品要求发 140 汉字就要把上限调到 500。参数说明contentCid 允许为空字符串前端据此区分纯文本帖和图文帖。一个容易被忽略的点是转发套娃。上面的实现允许 A 转发 B、B 又转发 A会形成环路。完整源码一般会给 Post 增加 repostDepth 字段限制最多嵌套 3 层文档里如果没提这个边界说明是教学简化版。3.3 用 Hardhat 部署到本地链与测试网拿到源码后的第一步不是打开前端而是把合约部署到本地网络验证编译和部署链路通畅。npm install --save-dev hardhat nomicfoundation/hardhat-toolbox npx hardhat init # 把 contracts/Weibo.sol 放进 contracts 目录后执行 npx hardhat run scripts/deploy.js --network localhostconst hre require(hardhat); async function main() { const Weibo await hre.ethers.getContractFactory(Weibo); const weibo await Weibo.deploy(); await weibo.waitForDeployment(); const address await weibo.getAddress(); const [owner] await hre.ethers.getSigners(); const tx await weibo.register(alice, QmTestAvatarCid); const receipt await tx.wait(); console.log(Weibo deployed to:, address); console.log(register block:, receipt.blockNumber, gasUsed:, receipt.gasUsed.toString()); } main().catch(console.error);逻辑说明deploy() 不接收构造参数部署地址由 getAddress() 读取。register 返回 TransactionResponse必须 wait() 之后才能拿到 receiptgasUsed 和 blockNumber 都在 receipt 上。参数说明--network localhost 对应 npx hardhat node 启动的本地节点RPC 默认在 8545 端口MetaMask 切到这个网络后前端才能连到同一份合约。提示在公共测试网上部署前把 hardhat.config.js 里的 defaultNetwork 改为目标网络并确认 .env 中的私钥不会提交到仓库。多签、时间锁这些安全设施在教学版源码里可以不装但私钥泄露是另外一回事。3.4 合约测试用断言锁住关键用户行为没有测试的源码不建议直接用。下面是最小测试集覆盖注册后才能发帖和未注册用户发帖应回退两条核心规则const { expect } require(chai); describe(Weibo, function () { it(should allow registered user to post, async function () { const [user] await ethers.getSigners(); const weibo await ethers.deployContract(Weibo); await weibo.register(alice, QmAvatar); await expect(weibo.createPost(hello dapp, QmCid)) .to.emit(weibo, PostCreated); }); it(should reject post from unregistered user, async function () { const [, stranger] await ethers.getSigners(); const weibo await ethers.deployContract(Weibo); await expect(weibo.connect(stranger).createPost(hello, QmCid)) .to.be.reverted; }); });逻辑说明第一个用例用 Chai matcher 检查事件是否发出第二个用例用陌生地址调用 createPost验证 require(users[msg.sender].registered) 是否生效。如果不加这行 require第二个用例就会失败说明合约权限模型是破洞的。参数说明deployContract 是 Hardhat 提供的便捷封装等价于 getContractFactory 加 deployconnect 用来切换调用者身份这是测试多用户行为的前提。4. 前端与去中心化交互ethers 接入、发帖与时间线呈现4.1 连接钱包与查询微博 UID 和用户信息前端推荐直接用 ethers v6。连接钱包的本质是拿到 MetaMask 注入的 window.ethereum然后创建 provider 和 signer。import { BrowserProvider, Contract } from ethers; const ABI [ /* 从 hardhat artifacts 里复制 Weibo.json 的 abi 数组 */ ]; const CONTRACT_ADDR 0x...; // 替换为 deploy.js 输出的地址 async function connect() { const provider new BrowserProvider(window.ethereum); const accounts await provider.send(eth_requestAccounts, []); return { provider, signer: await provider.getSigner(), account: accounts[0] }; } async function loadUser(account) { const provider new BrowserProvider(window.ethereum); const contract new Contract(CONTRACT_ADDR, ABI, provider); const user await contract.users(account); return { nickname: user.nickname, avatarCid: user.avatarCid, uid: Number(user.uid), // 注意 BigInt 转 Number }; }逻辑说明eth_requestAccounts 必须由用户点击按钮触发应用启动时不能自动弹窗这是浏览器的安全限制。loadUser 调用只读方法不产生 gas也不需要 signer。参数说明ethers v6 里合约结构体返回值已经展开了字段可以直接取 nicknameuid 是 uint256ethers 默认返回 BigInt前端展示前要 Number() 或 toString()否则 React 渲染会报对象错误。4.2 发帖流程签名、等待确认、读回执发帖是写操作必须由用户签名。完整流程分四步检查注册状态、若有未注册先注册、发送 createPost 交易、等待确认后刷新时间线。pending 状态下按钮要禁用避免用户手抖双击送出两笔一模一样的交易。async function post(content, contentCid) { const { signer, account } await connect(); const contract new Contract(CONTRACT_ADDR, ABI, signer); const me await contract.users(account); if (Number(me.uid) 0) { const name document.querySelector(#nickname).value; await (await contract.register(name, QmAvatar)).wait(); } const tx await contract.createPost(content, contentCid); const receipt await tx.wait(); return receipt.transactionHash; }逻辑说明contract.register 返回的 TransactionResponse 同样要 wait()拿到确认后再发帖否则两个写交易之间没有先后关系前端时序会乱。参数说明contentCid 可为空字符串写入空字符串不会被 require 拦截但前端要在 UI 层判断有图片才显示图片容器。gas 参数建议交给 ethers 自动估算。手动指定 gasLimit 在这个场景风险很高合约代码只要和你本地 artifact 略有差异估算值就会偏差最终交易回退而用户钱包已经扣了手续费。若想省 gas应调整业务逻辑而不是压 gasLimit。注意MetaMask 里显示 execution reverted 时第一件事是去 Hardhat 终端看回退栈而不是改前端重试。前端错误信息在大多数情况下不会包含 Solidity 的 require 原因。4.3 图片上传 IPFS 与 CID 提取图片不能作为合约参数常见做法是先传 IPFS 拿到 CID再把这个字符串带进 createPost。开发环境用 ipfs-http-client 连接本地节点最简写法如下import { create } from ipfs-http-client; const ipfs create({ url: http://127.0.0.1:5001 }); async function uploadImage(file) { const added await ipfs.add(file, { pin: false }); return added.path; // QmX8... 这类 CID 字符串 }逻辑说明add 返回的 path 就是 CID。pin 设为 false 表示不上固定服务适合本地联调正式发布必须换成 Pinata 或其他固定服务否则节点回收垃圾数据后图片就找不回来了。参数说明file 是浏览器 File 对象ipfs-http-client 会自动处理 Blob 分片拿到的 CID 可以拼成 ipfs://QmX8... 再存入 contentCid前端展示时再替换为公共网关 URL。4.4 用事件监听聚合微博 UID 时间线小规模应用可以直接在前端订阅事件并按 UID 过滤。把关注列表放进一个 Set收到 PostCreated 回调时检查作者是否在集合中命中就插入时间线并重排。contract.on( PostCreated, (postId, author, uid, content, contentCid, repostOf, timestamp) { if (followings.has(author.toLowerCase())) { timeline.push({ postId: Number(postId), uid: Number(uid), // 微博 UID用于跳转个人主页 content, cid: contentCid, repostOf: Number(repostOf), ts: new Date(Number(timestamp) * 1000), }); renderTimeline([...timeline].sort((a, b) b.ts - a.ts)); } } );逻辑说明ethers 的事件回调参数顺序与合约事件定义完全一致indexed 参数会被单独解码未索引参数也在同一回调里。地址用 toLowerCase() 归一化是因为 checksum 地址和全小写地址在 JS 判断时可能不相同。参数说明followings 是从合约 FollowEvent 事件同步来的 Set真实项目里这个集合应该由索引服务维护前端只消费它。这个方案的边界很明确前端过滤只适用于单用户、小数据量场景。帖子量一旦上来就需要第 5 章的索引服务由它订阅合约、写入数据库、再提供查询接口否则首次加载要把账本整个拉一遍体验不可接受。5. 索引、排错与验收从本地网络到可用发布5.1 用事件日志重建微博时间线索引服务的任务是从指定区块开始重放 PostCreated 日志把字段解析后写入数据库。拉取时按 1000 个区块分批避免单次 getLogs 请求超时。node indexer/listen.js --start-block 123456 --rpc http://127.0.0.1:8545const { ethers } require(ethers); const provider new ethers.JsonRpcProvider(process.env.RPC_URL); const contract new ethers.Contract(process.env.CONTRACT_ADDR, ABI, provider); async function scanFrom(startBlock) { const latest await provider.getBlockNumber(); for (let b startBlock; b latest; b 1000) { const logs await provider.getLogs({ address: process.env.CONTRACT_ADDR, topics: [ethers.id(PostCreated(uint256,address,uint256,string,string,uint256,uint256))], fromBlock: b, toBlock: Math.min(b 999, latest), }); // 每个 log 解析后写入 posts 表 } }逻辑说明getLogs 的第一位 topics 必须是事件签名的 keccak256 哈希ethers.id 就是算哈希的快捷方法如果事件签名写错一个空格查询结果会一直为空这是最常见的为什么收不到日志原因。参数说明start-block 应取合约部署交易所在区块否则初期帖子永远缺席rpc 指向本地节点或公共 RPC 都可以但链上数据一致的前提是同一份合约地址。解析事件参数时string 类型的 content 和 contentCid 在日志的 data 区需要 ABI 解码ethers 的 Interface.parseLog 可以直接按事件定义解析比自己手工切字节安全得多。5.2 常见报错与排查对策现象可能原因处理手段交易回退且无提示createPost 未注册检查拦截在 Hardhat 终端看 require 栈或给 require 补自定义错误register 后 UID 仍为 0前端用错地址查询检查 contract.users(signer.getAddress()) 的调用者事件监听收不到历史帖只 on() 没 getLogs 重放启动时先 scanFrom再进入 live 监听图片裂开本地 IPFS 节点的 pin 未配置换公共固定服务或回退到本地文件预览双击按钮发出两笔帖子pending 状态未锁定交易确认前禁用按钮并记录 pendingTx 哈希第一行最容易被忽略。Solidity 0.8 的 require 默认只回退不带原因MetaMask 里永远只显示一行 execution reverted。排查顺序是先在 Hardhat 测试网复现再用 hardhat_traceTransaction 看是哪一行 require 失败最后才轮到优化前端提示文案。5.3 验收清单如何证明去中心化不含水验收一套去中心化微博有四项实验必须做。第一关闭后端服务纯静态页面加 MetaMask 仍能发帖点赞验证方式是页面只连 RPC不起任何自有 Web 服务。第二换一个 RPC 节点连接同一合约地址数据完全一致这证明不依赖特定节点。第三停掉索引服务后合约仍能写入帖子不丢因为索引服务只负责读绝不参与写路径。第四审查合约代码中不存在带 onlyOwner 修饰的 deletePost、replacePost 函数否则管理员仍然拥有删帖权限。如果源码里出现上述删除函数那它只是披着去中心化外衣的中心化系统。最终验收标准只有一句话关闭全部自有服务之后只有以太坊网络本身在维护数据可用性与顺序性。本文还有配套的精品资源点击获取
简介这套基于以太坊区块链的去中心化微博系统设计与实现方案面向计算机、软件工程、信息工程等专业学生与开发者主要解决区块链社交平台从合约设计到前端落地的问题适用于毕业设计、课程实践及进阶学习。压缩包共38个文件、约2.68MB包含Solidity智能合约、Truffle迁移部署脚本、JSON配置、前端页面与界面截图、设计报告PDF及LaTeX源文件还有备份文件与Git配置工程结构完整、目录清晰便于按模块检索和二次开发。项目包含完整的设计报告、系统架构图、用户端与管理端页面、系统流程图和Ganache迁移演示覆盖从智能合约编写、部署到前端交互的完整链路核心代码经过充分验证在毕业设计评审中获优。目前已有69人学习下载适合具备一定基础的开发者基于现有架构做扩展与定制也可作为初学者研读区块链应用的进阶案例。1. 基于以太坊的去中心化微博系统它解决什么、源码能拿来做什么看到基于以太坊的去中心化微博系统设计与实现含完整源码与文档第一反应往往是微博本来就是免费的为什么要上链这个问题的实际答案是省不掉的三项权利内容发布权、账号所有权和内容存续权。链上微博没有运营方审核不会因为一条投诉就删帖只要以太坊网络还在你发过的内容和关注关系就能被任何人查证。它适合三类人想理解 DApp 前后端如何协作的区块链开发初学者需要一套可运行源码做课程设计或技术验证的在校生以及做社交协议产品调研的工程师。整套路线的常见组成是一份 Solidity 智能合约、一个与钱包交互的前端、一套事件索引方案以及配套的部署与接口文档。下面按设计选型 → 合约实现 → 前端接入 → 索引排错的顺序展开。2. 设计与选型从微博模型到以太坊可落地结构2.1 微博的核心数据模型与链上存储取舍微博系统的实体一共四类用户、帖子、关系、互动。用户需要地址、昵称、头像、简介帖子需要作者、内容、时间戳、引用来源关系包含关注与拉黑互动包含点赞、转发和评论。去中心化微博与传统微博的差别不在模型本身而在存放位置。常见工程做法是分层存储短文本直接写入合约状态图片与大段内容放到 IPFS链上只保存内容寻址的 CIDContent Identifier。这个取舍的根本原因是 gas 成本。以太坊写一个新存储槽的基准开销是 20000 gas字符串按字节继续累加长文本在链上分摊下来非常贵。一个 80 字符的帖子在测试网写入要消耗十万级 gas图片动辄几百 KB塞进 calldata 既不现实也没有必要。我一般建议的混合模式是帖子正文在 280 字节以内直接上链保证内容可校验、可审计图片和视频先上传 IPFS帖子内容里存 CID用户头像与封面存 IPFS CID合约里只维护 CID 的更新记录。这样内容存续由 IPFS 网络保证发布记录不可篡改由以太坊保证两件事各归其位。文档里如果写了 storage 和 memory 的 gas 对比那才是真正考虑过生产成本的源码而不是把传统 CRUD 搬到合约上。2.2 事件驱动的消息流为什么不在链上建关系表第二个容易踩坑的设计点是时间线。传统微博需要一张 follow 表和一张 post 表做连接查询链上合约也可以这么写维护一个 mapping(address address[]) 保存关系再遍历关注者查帖子。问题在于遍历落在链下读取阶段合约本身没有查询所有关注者最新帖子的原语最终还是需要一套索引服务。更贴合以太坊的做法是事件即数据。把发帖、点赞、关注定义成事件事件参数携带作者地址、微博 UID、内容哈希和时间戳链下服务订阅事件后写入数据库再用 SQL 或内存索引重建时间线。这样合约状态量小写入成本低索引端反而能拿到完整行为流。注意与很多开发者的直觉相反事件不会消耗大量 gas事件日志是 EVM 的原生特性写入成本比状态写入低得多。2.3 存储成本估算一次发帖到底花多少钱下面这张表按 Solidity 0.8.20 与 Hardhat 本地网络估算实际数值以部署时的 gas 价格为准操作涉及存储预估 gas说明注册用户地址→UID、昵称、头像 CID约 12 万首次写入多个存储槽发帖80 字节正文、时间戳、作者约 10 万字符串每 32 字节一个槽转发原帖 ID、附加评论约 8 万不复制原帖正文点赞帖子 ID→地址集合约 6 万先查重再写入注意gas 数值受编译器优化开关影响。开启 --optimize 与 --optimize-runs 200 之后同一段合约代码的 gas 最多能差出 15% 左右对比成本时要在同一份配置下比较。gas 大头在 SSTORE 的冷写入一个可选优化是把正文先取 keccak256链上存 32 字节哈希正文存 IPFS代价是链上读不到明文必须由索引服务拼接。这个取舍在成本上大约能降 30%但可验证性变弱教学向源码一般不推荐。2.4 源码目录规划拿到源码后先读哪几个文件一份能跑的以太坊微博源码目录结构通常长这样weibo-dapp/ ├── contracts/ │ └── Weibo.sol # 主合约用户、帖子与互动 ├── scripts/ │ ├── deploy.js # 部署脚本 │ └── seed.js # 测试数据写入脚本 ├── test/ │ └── weibo.test.js # 合约行为测试 ├── frontend/ │ ├── src/ │ │ ├── api/ethers.js # 钱包与合约封装 │ │ ├── components/ # 发帖、时间线、关注按钮 │ │ └── store/ # 本地状态管理 │ └── package.json ├── indexer/ │ ├── listen.js # 事件监听与入库 │ └── schema.sql # 时间线重建表结构 └── docs/ ├── 部署文档.md └── 接口文档.md拿到源码先读 contracts/Weibo.sol 的数据结构定义再看 test 目录覆盖了哪些用户行为最后启动 indexer/listen.js 确认事件字段完整。很多号称完整源码的项目合约能编译但缺事件前端只能显示自己刚发的帖子历史数据一片空白这类代码在选型阶段就要直接排除。3. 核心合约实现身份、发帖与互动的 Solidity 代码3.1 用户注册与微博 UID 的映射去中心化微博的账号体系比传统微博多一层映射每个用户有一个自增的微博 UID同时又与一个以太坊地址绑定。这样前端可以像微博那样展示UID #10086合约层则只用 address 作为权限依据。注册、查询、反向查询都需要这一层。// SPDX-License-Identifier: MIT pragma solidity ^0.8.20; contract Weibo { struct User { string nickname; // 昵称直接存链上 string avatarCid; // 头像的 IPFS CID uint256 uid; // 微博 UID等于注册顺序 bool registered; } mapping(address User) public users; mapping(uint256 address) public uidToAddress; uint256 public nextUid 1; event UserRegistered(address indexed user, uint256 indexed uid, string nickname); function register(string calldata nickname, string calldata avatarCid) external { require(!users[msg.sender].registered, already registered); require(bytes(nickname).length 0 bytes(nickname).length 32, bad nickname); users[msg.sender] User(nickname, avatarCid, nextUid, true); uidToAddress[nextUid] msg.sender; emit UserRegistered(msg.sender, nextUid, nickname); nextUid; } }逻辑说明register 用 msg.sender 作为唯一键UID 由合约自增同时维护 uidToAddress 反向映射。前端既可以用地址查 UID也可以用微博 UID 反查地址正好覆盖我的主页和搜索用户 UID两个入口。参数 nickname 走 calldata 比 memory 省 gas昵称长度限制 32 字节是为了把字符串压缩到一个存储槽以内降低成本。注意这里没有做昵称唯一性校验。若要保证一个昵称全网唯一就再维护一个 mapping(bytes32 bool) 记录昵称的 keccak256注册前 require 不重复。Solidity 里 string 不能直接作为 mapping 的 key必须先用 keccak256 转成 bytes32这是新手最常踩的编译错误。3.2 发帖、转发与事件字段设计帖子核心是一个自增 postId外加作者、内容、引用来源。关键设计是让转发帖与原帖共用同一个 PostCreated 事件索引端只需要订阅一个事件就能重建完整的微博时间线。event PostCreated( uint256 indexed postId, address indexed author, uint256 indexed uid, string content, // 正文最多约 93 个中文字 string contentCid, // 图片或长文的 IPFS CID uint256 repostOf, // 0 表示原创非 0 表示转发原帖 ID uint256 timestamp ); mapping(uint256 Post) private posts; uint256 public postId 1; function createPost(string calldata content, string calldata contentCid) external { require(users[msg.sender].registered, not registered); require(bytes(content).length 0, empty content); require(bytes(content).length 280, too long); posts[postId] Post(msg.sender, users[msg.sender].uid, content, contentCid, 0, block.timestamp); emit PostCreated(postId, msg.sender, users[msg.sender].uid, content, contentCid, 0, block.timestamp); postId; } function repost(uint256 originalId, string calldata comment) external { require(users[msg.sender].registered, not registered); require(originalId 0 originalId postId, post not exists); posts[postId] Post(msg.sender, users[msg.sender].uid, comment, , originalId, block.timestamp); emit PostCreated(postId, msg.sender, users[msg.sender].uid, comment, , originalId, block.timestamp); postId; }逻辑说明两个写函数共用同一个事件转发帖靠 repostOf 区分索引端重建谁转发了谁时对 repostOf 做一次关联即可。这里的上限 280 是字节而不是字符中文在 UTF-8 下每字占 3 字节280 字节约等于 93 个汉字如果产品要求发 140 汉字就要把上限调到 500。参数说明contentCid 允许为空字符串前端据此区分纯文本帖和图文帖。一个容易被忽略的点是转发套娃。上面的实现允许 A 转发 B、B 又转发 A会形成环路。完整源码一般会给 Post 增加 repostDepth 字段限制最多嵌套 3 层文档里如果没提这个边界说明是教学简化版。3.3 用 Hardhat 部署到本地链与测试网拿到源码后的第一步不是打开前端而是把合约部署到本地网络验证编译和部署链路通畅。npm install --save-dev hardhat nomicfoundation/hardhat-toolbox npx hardhat init # 把 contracts/Weibo.sol 放进 contracts 目录后执行 npx hardhat run scripts/deploy.js --network localhostconst hre require(hardhat); async function main() { const Weibo await hre.ethers.getContractFactory(Weibo); const weibo await Weibo.deploy(); await weibo.waitForDeployment(); const address await weibo.getAddress(); const [owner] await hre.ethers.getSigners(); const tx await weibo.register(alice, QmTestAvatarCid); const receipt await tx.wait(); console.log(Weibo deployed to:, address); console.log(register block:, receipt.blockNumber, gasUsed:, receipt.gasUsed.toString()); } main().catch(console.error);逻辑说明deploy() 不接收构造参数部署地址由 getAddress() 读取。register 返回 TransactionResponse必须 wait() 之后才能拿到 receiptgasUsed 和 blockNumber 都在 receipt 上。参数说明--network localhost 对应 npx hardhat node 启动的本地节点RPC 默认在 8545 端口MetaMask 切到这个网络后前端才能连到同一份合约。提示在公共测试网上部署前把 hardhat.config.js 里的 defaultNetwork 改为目标网络并确认 .env 中的私钥不会提交到仓库。多签、时间锁这些安全设施在教学版源码里可以不装但私钥泄露是另外一回事。3.4 合约测试用断言锁住关键用户行为没有测试的源码不建议直接用。下面是最小测试集覆盖注册后才能发帖和未注册用户发帖应回退两条核心规则const { expect } require(chai); describe(Weibo, function () { it(should allow registered user to post, async function () { const [user] await ethers.getSigners(); const weibo await ethers.deployContract(Weibo); await weibo.register(alice, QmAvatar); await expect(weibo.createPost(hello dapp, QmCid)) .to.emit(weibo, PostCreated); }); it(should reject post from unregistered user, async function () { const [, stranger] await ethers.getSigners(); const weibo await ethers.deployContract(Weibo); await expect(weibo.connect(stranger).createPost(hello, QmCid)) .to.be.reverted; }); });逻辑说明第一个用例用 Chai matcher 检查事件是否发出第二个用例用陌生地址调用 createPost验证 require(users[msg.sender].registered) 是否生效。如果不加这行 require第二个用例就会失败说明合约权限模型是破洞的。参数说明deployContract 是 Hardhat 提供的便捷封装等价于 getContractFactory 加 deployconnect 用来切换调用者身份这是测试多用户行为的前提。4. 前端与去中心化交互ethers 接入、发帖与时间线呈现4.1 连接钱包与查询微博 UID 和用户信息前端推荐直接用 ethers v6。连接钱包的本质是拿到 MetaMask 注入的 window.ethereum然后创建 provider 和 signer。import { BrowserProvider, Contract } from ethers; const ABI [ /* 从 hardhat artifacts 里复制 Weibo.json 的 abi 数组 */ ]; const CONTRACT_ADDR 0x...; // 替换为 deploy.js 输出的地址 async function connect() { const provider new BrowserProvider(window.ethereum); const accounts await provider.send(eth_requestAccounts, []); return { provider, signer: await provider.getSigner(), account: accounts[0] }; } async function loadUser(account) { const provider new BrowserProvider(window.ethereum); const contract new Contract(CONTRACT_ADDR, ABI, provider); const user await contract.users(account); return { nickname: user.nickname, avatarCid: user.avatarCid, uid: Number(user.uid), // 注意 BigInt 转 Number }; }逻辑说明eth_requestAccounts 必须由用户点击按钮触发应用启动时不能自动弹窗这是浏览器的安全限制。loadUser 调用只读方法不产生 gas也不需要 signer。参数说明ethers v6 里合约结构体返回值已经展开了字段可以直接取 nicknameuid 是 uint256ethers 默认返回 BigInt前端展示前要 Number() 或 toString()否则 React 渲染会报对象错误。4.2 发帖流程签名、等待确认、读回执发帖是写操作必须由用户签名。完整流程分四步检查注册状态、若有未注册先注册、发送 createPost 交易、等待确认后刷新时间线。pending 状态下按钮要禁用避免用户手抖双击送出两笔一模一样的交易。async function post(content, contentCid) { const { signer, account } await connect(); const contract new Contract(CONTRACT_ADDR, ABI, signer); const me await contract.users(account); if (Number(me.uid) 0) { const name document.querySelector(#nickname).value; await (await contract.register(name, QmAvatar)).wait(); } const tx await contract.createPost(content, contentCid); const receipt await tx.wait(); return receipt.transactionHash; }逻辑说明contract.register 返回的 TransactionResponse 同样要 wait()拿到确认后再发帖否则两个写交易之间没有先后关系前端时序会乱。参数说明contentCid 可为空字符串写入空字符串不会被 require 拦截但前端要在 UI 层判断有图片才显示图片容器。gas 参数建议交给 ethers 自动估算。手动指定 gasLimit 在这个场景风险很高合约代码只要和你本地 artifact 略有差异估算值就会偏差最终交易回退而用户钱包已经扣了手续费。若想省 gas应调整业务逻辑而不是压 gasLimit。注意MetaMask 里显示 execution reverted 时第一件事是去 Hardhat 终端看回退栈而不是改前端重试。前端错误信息在大多数情况下不会包含 Solidity 的 require 原因。4.3 图片上传 IPFS 与 CID 提取图片不能作为合约参数常见做法是先传 IPFS 拿到 CID再把这个字符串带进 createPost。开发环境用 ipfs-http-client 连接本地节点最简写法如下import { create } from ipfs-http-client; const ipfs create({ url: http://127.0.0.1:5001 }); async function uploadImage(file) { const added await ipfs.add(file, { pin: false }); return added.path; // QmX8... 这类 CID 字符串 }逻辑说明add 返回的 path 就是 CID。pin 设为 false 表示不上固定服务适合本地联调正式发布必须换成 Pinata 或其他固定服务否则节点回收垃圾数据后图片就找不回来了。参数说明file 是浏览器 File 对象ipfs-http-client 会自动处理 Blob 分片拿到的 CID 可以拼成 ipfs://QmX8... 再存入 contentCid前端展示时再替换为公共网关 URL。4.4 用事件监听聚合微博 UID 时间线小规模应用可以直接在前端订阅事件并按 UID 过滤。把关注列表放进一个 Set收到 PostCreated 回调时检查作者是否在集合中命中就插入时间线并重排。contract.on( PostCreated, (postId, author, uid, content, contentCid, repostOf, timestamp) { if (followings.has(author.toLowerCase())) { timeline.push({ postId: Number(postId), uid: Number(uid), // 微博 UID用于跳转个人主页 content, cid: contentCid, repostOf: Number(repostOf), ts: new Date(Number(timestamp) * 1000), }); renderTimeline([...timeline].sort((a, b) b.ts - a.ts)); } } );逻辑说明ethers 的事件回调参数顺序与合约事件定义完全一致indexed 参数会被单独解码未索引参数也在同一回调里。地址用 toLowerCase() 归一化是因为 checksum 地址和全小写地址在 JS 判断时可能不相同。参数说明followings 是从合约 FollowEvent 事件同步来的 Set真实项目里这个集合应该由索引服务维护前端只消费它。这个方案的边界很明确前端过滤只适用于单用户、小数据量场景。帖子量一旦上来就需要第 5 章的索引服务由它订阅合约、写入数据库、再提供查询接口否则首次加载要把账本整个拉一遍体验不可接受。5. 索引、排错与验收从本地网络到可用发布5.1 用事件日志重建微博时间线索引服务的任务是从指定区块开始重放 PostCreated 日志把字段解析后写入数据库。拉取时按 1000 个区块分批避免单次 getLogs 请求超时。node indexer/listen.js --start-block 123456 --rpc http://127.0.0.1:8545const { ethers } require(ethers); const provider new ethers.JsonRpcProvider(process.env.RPC_URL); const contract new ethers.Contract(process.env.CONTRACT_ADDR, ABI, provider); async function scanFrom(startBlock) { const latest await provider.getBlockNumber(); for (let b startBlock; b latest; b 1000) { const logs await provider.getLogs({ address: process.env.CONTRACT_ADDR, topics: [ethers.id(PostCreated(uint256,address,uint256,string,string,uint256,uint256))], fromBlock: b, toBlock: Math.min(b 999, latest), }); // 每个 log 解析后写入 posts 表 } }逻辑说明getLogs 的第一位 topics 必须是事件签名的 keccak256 哈希ethers.id 就是算哈希的快捷方法如果事件签名写错一个空格查询结果会一直为空这是最常见的为什么收不到日志原因。参数说明start-block 应取合约部署交易所在区块否则初期帖子永远缺席rpc 指向本地节点或公共 RPC 都可以但链上数据一致的前提是同一份合约地址。解析事件参数时string 类型的 content 和 contentCid 在日志的 data 区需要 ABI 解码ethers 的 Interface.parseLog 可以直接按事件定义解析比自己手工切字节安全得多。5.2 常见报错与排查对策现象可能原因处理手段交易回退且无提示createPost 未注册检查拦截在 Hardhat 终端看 require 栈或给 require 补自定义错误register 后 UID 仍为 0前端用错地址查询检查 contract.users(signer.getAddress()) 的调用者事件监听收不到历史帖只 on() 没 getLogs 重放启动时先 scanFrom再进入 live 监听图片裂开本地 IPFS 节点的 pin 未配置换公共固定服务或回退到本地文件预览双击按钮发出两笔帖子pending 状态未锁定交易确认前禁用按钮并记录 pendingTx 哈希第一行最容易被忽略。Solidity 0.8 的 require 默认只回退不带原因MetaMask 里永远只显示一行 execution reverted。排查顺序是先在 Hardhat 测试网复现再用 hardhat_traceTransaction 看是哪一行 require 失败最后才轮到优化前端提示文案。5.3 验收清单如何证明去中心化不含水验收一套去中心化微博有四项实验必须做。第一关闭后端服务纯静态页面加 MetaMask 仍能发帖点赞验证方式是页面只连 RPC不起任何自有 Web 服务。第二换一个 RPC 节点连接同一合约地址数据完全一致这证明不依赖特定节点。第三停掉索引服务后合约仍能写入帖子不丢因为索引服务只负责读绝不参与写路径。第四审查合约代码中不存在带 onlyOwner 修饰的 deletePost、replacePost 函数否则管理员仍然拥有删帖权限。如果源码里出现上述删除函数那它只是披着去中心化外衣的中心化系统。最终验收标准只有一句话关闭全部自有服务之后只有以太坊网络本身在维护数据可用性与顺序性。本文还有配套的精品资源点击获取
