在构建 Web3 应用的过程中，链上数据的获取与管理是一项不可或缺的能力。本专题从前端开发者的视角出发，系统拆解链上数据的结构与来源，深入剖析如何通过 Viem、Wagmi 等工具读取合约状态与事件日志，并进一步探讨 The Graph、Subsquid 等主流索引机制的架构原理与使用实践。

本专题不仅关注「如何获取数据」，更重视数据可用性、查询效率、状态管理与前端架构的协同设计。你将掌握从原始链上调用到结构化索引服务、从事件监听到 UI 实时刷新、从单链读取到多链聚合的一整套前端工程化思路与最佳实践。

无论你是 Web3 初学者，还是希望提升项目数据架构质量的高级开发者，本专题都将为你提供值得反复参考的知识地图与实战指南。

第 1 章：链上数据从哪来？——读取入口全面梳理

• Call vs Storage vs Events：三类链上数据结构全解析
• 读取场景分类：状态查询 / 历史记录 / 日志分析
• 前端调用入口（Viem、Wagmi、Ethers）总览
• 示例：读取一个 ERC20 Token 的 balanceOf、name、转账记录

第 2 章：Log（事件） vs Call（存储）机制对比与应用场景

• call 读取的是合约当前状态；event 提供了历史轨迹
• 为什么 event 是不可变、但也不适合全量拉取？
• 使用 getLogs 或监听器 vs 扫链分析
• 示例：ERC721 的 Transfer 事件获取与分析

第 3 章：以太坊节点结构 & JSON-RPC 接口详解

• ETH 节点的工作原理（状态树、历史区块存储）