从零开始学以太坊智能合约开发,一份完整教学指南

// SPDX-License-Identifier: MIT // 指定许可证标识
pragma solidity ^0.8.0; // 指定编译器版本
contract SimpleStorage {
    uint256 private storedData; // 状态变量，存储在区块链上
    // 存储函数
    function set(uint256 x) public {
        storedData = x;
    }
    // 读取函数
    function get() public view returns (uint256) {
        return storedData;
    }
}

数据类型

• 值类型：uint256（无符号整数）、int256（有符号整数）、bool（布尔值）、address（以太坊地址）等。
• 引用类型：string（字符串）、bytes（字节数组）、array（数组）、mapping（键值对映射）。

关键字

• constructor：合约部署时执行的初始化函数（仅运行一次）。
• event：用于日志记录，方便前端监听合约状态变化。
• require、revert、assert：错误处理机制，确保合约执行条件。

实战开发：一个简单的投票合约

通过一个“投票系统”合约，巩固Solidity语法与合约逻辑设计。

需求

• 创建候选人列表,支持用户投票。
• 每个地址只能投一票,投票结果公开可查。

代码实现

pragma solidity ^0.8.0;
contract Voting {
    // 候选人结构体
    struct Candidate {
        string name;
        uint256 voteCount;
    }
    // 状态变量
    mapping(address => bool) public hasVoted; // 记录是否投票
    mapping(uint256 => Candidate) public candidates; // 候选人列表
    uint256 public candidateCount;
    // 事件：投票时触发
    event VotedEvent(address voter, uint256 candidateIndex);
    // 添加候选人（仅合约创建者可调用）
    function addCandidate(string memory name) public {
        candidates[candidateCount] = Candidate(name, 0);
        candidateCount++;
    }
    // 投票函数
    function vote(uint256 candidateIndex) public {
        require(!hasVoted[msg.sender], "You have already voted!"); // 检查是否已投票
        require(candidateIndex < candidateCount, "Invalid candidate!"); // 检查候选人是否存在
        hasVoted[msg.sender] = true; // 标记已投票
        candidates[candidateIndex].voteCount++; // 候选人票数+1
        emit VotedEvent(msg.sender, candidateIndex); // 触发事件
    }
}

合约部署：从本地到测试网

使用Hardhat部署

• 安装Hardhat：npm install --save-dev hardhat
• 初始化项目：npx hardhat，选择“Create a basic JavaScript project”
• 编写部署脚本（scripts/deploy.js）：

  async function main() {
      const Voting = await ethers.getContractFactory("Voting");
      const voting = await Voting.deploy();
      await voting.deployed();
      console.log("Voting contract deployed to:", voting.address);
  }
  main().catch((error) => {
      console.error(error);
      process.exitCode = 1;
  });

• 运行部署：npx hardhat run scripts/deploy.js --network localhost（本地网络）或--network goerli（测试网）

通过Remix IDE部署（无环境配置）

• 访问Remix IDE，直接在浏览器中编写Solidity代码。
• 编译合约后,切换到“Deploy”标签，选择MetaMask账户，点击“Deploy”即可部署到测试网。

合约交互：前端与后端调用

部署后的合约需通过应用程序（DApp）与用户交互，常见方式包括：

使用Web3.js（前端库）

// 连接以太坊网络
const web3 = new Web3(Web3.givenProvider || "http://localhost:8545");
const contractAddress = "0x..."; // 合约地址
const abi = [...]; // 合置的ABI（应用程序二进制接口）
const votingContract = new web3.eth.Contract(abi, contractAddress);
// 调用投票函数
votingContract.methods.vote(0).send({ from: "0xUserAddress" })
    .then(console.log("Voted successfully!"));

使用Ethers.js（更现代的库）

import { ethers } from "ethers";
// 连接Provider（如MetaMask）
const provider = new ethers.providers.Web3Provider(window.ethereum);
const signer = provider.getSigner();
const contract = new ethers.Contract(contractAddress, abi, signer);
// 调用投票函数
await contract.vote(0);

安全与最佳实践：避免“重入攻击”与“溢出漏洞”

智能合约一旦部署,漏洞修复成本极高，开发时需注意：

1. 遵循ERC标准：如ERC-20（代币）、ERC-721（NFT）等，确保合约兼容性。
2. 输入验证：使用require检查参数合法性，防止恶意输入。
3. 防止重入攻击：在修改状态前先检查外部调用（如“检查- effects- 交互”模式）。
4. 使用OpenZeppelin库：开源的合约库，提供安全审计过的标准组件（如Ownable、SafeMath）。
5. 进行测试：编写单元测试（Hardhat内置Chai测试框架），覆盖所有业务逻辑。

进阶学习：探索智能合约的更多可能

掌握基础后,可进一步学习：

• DeFi开发：如借贷协议（Aave）、去中心化交易所（Uniswap）的核心逻辑。
• Layer 2扩容：通过Optimism、Arbitrum等Layer 2解决方案降低交易成本。
• DAO治理：使用Compound Governor等框架构建去中心化自治组织。

以太坊智能合约开发是通往Web3世界的钥匙,从Solidity语法到合约部署，从安全审计到DApp交互，每一步都需要理论与实践结合，随着以太坊2.0的演进和生态的完善，智能合约的应用场景将更加广阔，保持学习热情，动手实践，你也能成为区块链世界的“代码架构师”。