以太坊开发从入门到精通,详细攻略与实践指南

以太坊开发基础认知

在开始编码之前,理解一些核心概念至关重要：

1. 区块链与以太坊：区块链是一种分布式账本技术，以太坊则是支持智能合约的区块链平台,每个以太坊节点都维护着一份完整的区块链副本。
2. 智能合约：运行在以太坊虚拟机（EVM）上的自执行代码，是DApp的后端逻辑，一旦部署就无法修改（除非包含升级机制）。
3. 账户（Accounts）：
   • 外部账户（EOA, Externally Owned Account）：由用户私钥控制的账户，用于发起交易、转移以太币等。
   • 合约账户（Contract Account）：由智能代码控制，不能主动发起交易,只能响应接收到的交易。
4. Gas：为了防止网络滥用和计算资源浪费，以太坊网络要求每笔交易和智能合约执行都支付Gas费用，Gas以“以太坊”（ETH）的 subdivisions（如Gwei）支付。
5. Solidity：以太坊最主流的智能合约编程语言，语法类似JavaScript,但针对EVM进行了优化。
6. Web3.js / Ethers.js：用于与以太坊节点交互的JavaScript库，使前端DApp能够读取链上数据、发送交易、调用智能合约。

开发环境搭建

1. 安装Node.js 和 npm/yarn：

   • 访问 Node.js官网 下载并安装LTS版本。
   • npm（Node Package Manager）会随Node.js一起安装，或可选择安装yarn（npm install -g yarn）。

2. 安装代码编辑器：

   • Visual Studio Code (VS Code) 是最推荐的选择,拥有丰富的插件生态。
   • 推荐插件：
     • Solidity by Juan Blanco：Solidity语言支持、语法高亮、编译错误提示。
     • Prettier - Code formatter：代码格式化。
     • ESLint：JavaScript代码检查。
     • Hardhat for VS Code：Hardhat集成（如果使用Hardhat）。

3. 安装以太坊客户端/开发环境：

   • Hardhat (推荐)：
     • Hardhat是一个强大的以太坊开发环境，编译、测试、调试、部署一体化。
     • 安装：npx hardhat,然后按照提示初始化项目。
   • Truffle：
     • Truffle是另一个流行的开发框架,尤其适合开发复杂的DApp。
     • 安装：npm install -g truffle，然后truffle init初始化项目。
   • Ganache / Hardhat Network：
     • Ganache：个人区块链，可以快速启动本地私有链，方便测试和调试,提供预设的测试账户和ETH。
     • Hardhat Network：Hardhat内置的开发网络，功能强大,支持Solidity调试。

4. 安装MetaMask：

   • 浏览器扩展钱包，用于与以太坊网络交互（连接DApp、管理账户、签名交易）。
   • 从 MetaMask官网 下载并安装,创建钱包并备份好助记词。

智能合约开发 (以Solidity + Hardhat为例)

1. 创建智能合约项目：

   mkdir my-ethereum-dapp
   cd my-ethereum-dapp
   npx hardhat init
   # 选择 "Create a basic sample project"，选择JavaScript/TypeScript，安装依赖

2. 编写智能合约：

   • 在 contracts/ 目录下创建新的Solidity文件，SimpleStorage.sol。

   • Solidity合约结构：

     // SPDX-License-Identifier: MIT
     pragma solidity ^0.8.20;
     contract SimpleStorage {
         uint256 private storedData;
         function set(uint256 x) public {
             storedData = x;
         }
         function get() public view returns (uint256) {
             return storedData;
         }
     }

   • 关键字说明：

     • pragma solidity ^0.8.20;：指定Solidity编译器版本。
     • contract：定义合约。
     • uint256：无符号256位整数。
     • public：修饰函数,表示外部可调用。
     • view：表示函数只读取状态，不修改，执行不消耗Gas（由调用方支付）。
     • returns：指定函数返回类型。

3. 编译智能合约：

   • Hardhat会自动在 scripts/ 目录下生成编译脚本。
   • 运行 npx hardhat compile，编译成功后，合约的ABI（Application Binary Interface）和字节码会生成在 artifacts/ 目录下,ABI是前端与合约交互的接口。

4. 编写测试脚本：

   • 在 test/ 目录下编写测试脚本，使用JavaScript/TypeScript和Mocha/Chai等测试框架。

   • 示例 (simpleStorage.test.js)：

     const { expect } = require("chai");
     const { ethers } = require("hardhat");
     describe("SimpleStorage", function () {
         it("Should store the value 89.", async function () {
             const SimpleStorage = await ethers.getContractFactory("SimpleStorage");
             const simpleStorage = await SimpleStorage.deploy();
             await simpleStorage.deployed();
             await simpleStorage.set(89);
             const value = await simpleStorage.get();
             expect(value).to.equal(89);
         });
     });

   • 运行测试：npx hardhat test。

智能合约部署

1. 配置部署脚本：

   • 在 scripts/ 目录下修改或创建部署脚本，deploy.js。

   • 示例：

     async function main() {
         const SimpleStorage = await ethers.getContractFactory("SimpleStorage");
         const simpleStorage = await SimpleStorage.deploy();
         await simpleStorage.deployed();
         console.log("SimpleStorage deployed to:", simpleStorage.address);
     }
     main()
         .then(() => process.exit(0))
         .catch((error) => {
             console.error(error);
             process.exit(1);
         });

2. 连接到以太坊网络：

   • 在 hardhat.config.js 中配置网络：

     require("@nomicfoundation/hardhat-toolbox");
     const PRIVATE_KEY = "YOUR_PRIVATE_KEY_HERE"; // 测试账户私钥
     const RPC_URL = "YOUR_LOCAL_RPC_URL_OR_TESTNET_RPC_URL"; // 如 Ganache的RPC URL或Infura/Alchemy的测试网URL
     module.exports = {
       solidity: "0.8.20",
       networks: {
         hardhat: {},
     //       sepolia: {
     //         url: RPC_URL,
     //         accounts: [PRIVATE_KEY]
     //       }
       },
     };

   • 本地测试网：默认使用Hardhat Network或Ganache。

   • 公共测试网（如Sepolia）：需要从Infura或Alchemy获取RPC URL，并拥有测试网ETH（可通过水龙头获取）。

3. 执行部署：

   • 本地部署：npx hardhat run scripts/deploy.js --network hardhat
   • 测试网部署：npx hardhat run scripts/deploy.js --network sepolia (确保配置了sepolia网络且账户有ETH)

DApp前端开发与交互

1. 创建前端项目：

   npx create-react-app frontend
   cd frontend
   npm install ethers

2. 连接MetaMask：

   • 在React组件中，使用ethers库连接MetaMask：

     import { ethers } from "ethers";
     async function connectWallet() {
         if (window.ethereum) {
             try {
                 await window.ethereum.request({ method: 'eth_requestAccounts' });
                 const provider = new ethers.providers.Web3Provider(window.ethereum);
                 const signer = provider.getSigner();
                 const address = await signer.getAddress();
                 console.log("Connected address:", address);
                 // 更新UI状态