开发环境搭建

使用以太坊合约,你需要准备以下工具和环境：

1. 代码编辑器：
   • Visual Studio Code (VS Code)：推荐安装Solidity相关插件，如Solidity by Juan Blanco、Hardhat for VS Code等，提供语法高亮、代码提示和编译功能。
2. 以太坊客户端/开发框架：
   • Hardhat：一个流行的以太坊开发环境，编译、测试、部署和调试智能合约非常方便。
   • Truffle：另一个成熟的开发框架，尤其适合开发去中心化应用（DApps），内置测试网络管理和部署工具。
   • Foundry：用Solidity编写的快速、可移植且模块化的开发套件，近年来 gaining popularity。
3. 钱包：
   • MetaMask：最常用的浏览器钱包插件，用于管理你的以太坊账户、私钥，与去中心化应用（DApps）交互，并支付Gas费，你需要从MetaMask导出私钥或助记词来管理你的开发账户。
4. 测试网络（Testnet）：
   • 以太坊主网上的交易是真实且不可逆的,因此开发和测试应使用测试网，如Sepolia、Goerli（未来可能被其他测试网取代）。
   • 你需要从水龙头（Faucet）获取免费的测试网ETH，用于支付Gas费，Sepolia Faucet。
5. Node.js 和 npm/yarn：

   大多数开发框架（如Hardhat、Truffle）需要Node.js环境，并通过npm（或yarn）来管理依赖包。

编写你的第一个智能合约

我们以一个简单的“存储合约”（Storage Contract）为例，它允许你存储一个uint256类型的数字。

1. 创建项目目录：

   mkdir my-first-contract
   cd my-first-contract
   npm init -y

2. 安装Hardhat（以Hardhat为例）：

   npm install --save-dev hardhat
   npx hardhat

   按照提示选择"Create a basic sample project"，这将创建一个简单的合约结构。

3. 编写合约代码： 在contracts目录下，创建一个新的Solidity文件，例如Storage.sol：

   // SPDX-License-Identifier: MIT
   pragma solidity ^0.8.9;
   /**
    * @title Storage
    * @dev 一个简单的存储合约，可以存储和检索一个数字。
    */
   contract Storage {
       uint256 private storedData;
       event DataSet(uint256 value);
       /**
        * @dev 存储一个数字
        * @param value 要存储的数字
        */
       function set(uint256 value) public {
           storedData = value;
           emit DataSet(value);
       }
       /**
        * @dev 检索存储的数字
        * @return 存储的数字
        */
       function get() public view returns (uint256) {
           return storedData;
       }
   }

4. 编译合约： 在项目根目录下运行：

   npx hardhat compile

   成功编译后,会在artifacts目录下生成ABI（Application Binary Interface）和字节码（Bytecode），ABI是合约与外界交互的接口规范，字节码是部署到EVM的实际代码。

部署智能合约

部署合约是将编译好的字节码上传到以太坊网络（测试网或主网）的过程。

1. 配置部署脚本： 在scripts目录下，你可以找到或创建一个部署脚本，例如deploy.js：

   async function main() {
       // 获取合约工厂
       const Storage = await ethers.getContractFactory("Storage");
       // 部署合约
       const storage = await Storage.deploy();
       // 等待部署完成
       await storage.deployed();
       console.log("Storage合约已部署到:", storage.address);
   }
   main()
       .then(() => process.exit(0))
       .catch((error) => {
           console.error(error);
           process.exit(1);
       });

2. 配置网络： 在hardhat.config.js文件中，添加测试网配置，你需要确保MetaMask连接到对应的测试网，并且账户中有足够的测试ETH。

   require("@nomicfoundation/hardhat-toolbox");
   /** @type import('hardhat/config').HardhatUserConfig */
   module.exports = {
     solidity: "0.8.9",
     networks: {
       sepolia: {
         url: "https://sepolia.infura.io/v3/YOUR_INFURA_PROJECT_ID", // 替换为你的Infura项目ID或其他节点服务
         accounts: ["YOUR_PRIVATE_KEY_HERE"], // 替换为你的测试网账户私钥（注意：不要将私钥提交到代码仓库！）
       },
     },
   };

   你可以从Infura或Alchemy获取免费节点URL。

3. 执行部署： 确保MetaMask连接到Sepolia测试网，然后运行：

   npx hardhat run scripts/deploy.js --network sepolia

   如果部署成功,控制台会输出合约的地址，这个地址就是你合约在以太坊网络上的唯一标识。

与智能合约交互

合约部署后,你可以通过调用其函数来与之交互。

1. 通过Hardhat脚本调用： 创建一个新的脚本，例如interact.js：

   async function main() {
       const [deployer] = await ethers.getSigners();
       console.log("使用账户部署:", deployer.address);
       // 获取已部署的合约实例
       const Storage = await ethers.getContractFactory("Storage");
       const storage = await Storage.attach("YOUR_DEPLOYED_CONTRACT_ADDRESS"); // 替换为你的合约地址
       // 调用get函数
       let currentValue = await storage.get();
       console.log("当前存储的值:", currentValue);
       // 调用set函数
       const tx = await storage.set(42);
       await tx.wait(); // 等待交易确认
       // 再次调用get函数
       currentValue = await storage.get();
       console.log("设置后的值:", currentValue);
   }
   main()
       .then(() => process.exit(0))
       .catch((error) => {
           console.error(error);
           process.exit(1);
       });

   然后运行：

   npx hardhat run scripts/interact.js --network sepolia

2. 通过Web3与DApps交互： 在实际应用中，你通常会在前端（如React、Vue）应用中使用Web3.js或ethers.js库与合约交互。

   • 连接钱包：使用ethers.js的BrowserProvider连接MetaMask。
   • 获取合约实例：使用合约地址和ABI创建合约实例。
   • 调用读函数（view/pure）：直接调用，无需交易费。
   • 调用写函数（修改状态）：需要发送交易，并支付Gas费，交易会等待矿工打包确认。

   使用ethers.js在前端调用set函数：

   import { ethers } from "ethers";
   // 假设你已经有了provider,