从零到一,区块链应用开发示例与实战指南

核心功能模块开发示例

以下将重点介绍智能合约和前端部分的核心开发思路。

智能合约开发示例 (Solidity - 简化版)

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
contract DonationTracker {
    // 项目结构
    struct Project {
        uint id;
        string title;
        string description;
        address beneficiary;
        uint targetAmount;
        uint raisedAmount;
        bool isOpen;
        mapping(address => uint) donations;
    }
    // 事件
    event DonationMade(uint projectId, address donor, uint amount);
    event ProjectFunded(uint projectId, uint amount);
    event FundsWithdrawn(uint projectId, address to, uint amount);
    uint public projectCount;
    mapping(uint => Project) public projects;
    address public owner; // 平台拥有者，可发布项目
    constructor() {
        owner = msg.sender;
    }
    // 捐赠者向项目捐赠
    function donate(uint projectId) public payable {
        require(projects[projectId].isOpen, "Project is not open");
        require(msg.value > 0, "Donation amount must be positive");
        projects[projectId].donations[msg.sender] += msg.value;
        projects[projectId].raisedAmount += msg.value;
        emit DonationMade(projectId, msg.sender, msg.value);
    }
    // 项目方申请提款（简化版，实际中需要更复杂的审批逻辑）
    function withdrawFunds(uint projectId) public {
        require(msg.sender == projects[projectId].beneficiary, "Only beneficiary can withdraw");
        require(projects[projectId].raisedAmount >= projects[projectId].targetAmount, "Target not reached yet");
        uint amount = projects[projectId].raisedAmount;
        projects[projectId].raisedAmount = 0;
        projects[projectId].isOpen = false;
        payable(msg.sender).transfer(amount);
        emit FundsWithdrawn(projectId, msg.sender, amount);
    }
    // 平台拥有者发布新项目
    function createProject(string memory _title, string memory _description, address _beneficiary, uint _targetAmount) public {
        require(msg.sender == owner, "Only owner can create project");
        projectCount++;
        projects[projectCount] = Project(projectCount, _title, _description, _beneficiary, _targetAmount, 0, true);
    }
}

• 说明：
  • 这是一个极度简化的示例，实际项目中需要考虑更多安全因素（如重入攻击、整数溢出等，可用OpenZeppelin库增强安全性）。
  • 提款逻辑非常简单，实际中可能需要多签钱包、或者引入审计机构角色进行链下/链上审批。
  • 物资捐赠可以设计为另一种NFT或通证来表示。

前端应用开发示例 (React + Ethers.js)

• 环境准备：创建React项目，安装Ethers.js (npm install ethers)。

• 连接钱包：

  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);
        return { provider, signer, address };
      } catch (error) {
        console.error('Error connecting wallet:', error);
      }
    } else {
      alert('Please install MetaMask!');
    }
  }

• 调用智能合约：

  import DonationTrackerArtifact from './artifacts/contracts/DonationTracker.sol/DonationTracker.json'; // 假设编译后的ABI和Bytecode放在这里
  async function donateToProject(projectId, amountInEther) {
    const { signer } = await connectWallet();
    const contractAddress = 'YOUR_DEPLOYED_CONTRACT_ADDRESS'; // 部署后的合约地址
    const contract = new ethers.Contract(contractAddress, DonationTrackerArtifact.abi, signer);
    const amount = ethers.utils.parseEther(amountInEther); // 将ETH转换为wei
    const tx = await contract.donate(projectId, { value: amount });
    await tx.wait(); // 等待交易确认
    console.log('Donation successful!');
  }
  async function loadProjects() {
    const { provider } = await connectWallet();
    const contractAddress = 'YOUR_DEPLOYED_CONTRACT_ADDRESS';
    const contract = new ethers.Contract(contractAddress, DonationTrackerArtifact.abi, provider);
    const projectCount = await contract.projectCount();
    const projects = [];
    for (let i = 1; i <= projectCount; i++) {
      const project = await contract.projects(i);
      projects.push(project);
    }
    console.log('Projects:', projects);
    // 在前端展示projects
  }

• 说明：