// SPDX-License-Identifier: MIT
// SPDX 用于声明开源协议
// MIT 是最常见的 Solidity 开源许可证

pragma solidity ^0.8.20;
// 指定 Solidity 编译器版本
// ^0.8.20 表示：
// >=0.8.20 且 <0.9.0 都可以编译

contract MyContract {
    // contract = 智能合约
    // 类似 Java 里的 class
    // 部署后会生成一个链上地址

    // =========================================================
    // 1. State Variable（状态变量）
    // =========================================================

    uint public count;
    // uint = 无符号整数
    // public = 自动生成 getter 读取函数
    // count 会永久存储在区块链 storage 中

    // =========================================================
    // 2. Event（事件）
    // =========================================================

    event Increment(address user, uint value);
    // event = 链上日志系统
    // 用于记录重要行为
    // 前端 / 区块浏览器可以监听

    // 参数：
    // user  = 谁触发了 increment
    // value = increment 后的新值

    // =========================================================
    // 3. Modifier（修饰器）
    // =========================================================

    modifier onlyOwner() {
        // modifier = 函数执行前的统一规则

        // "_" 表示：
        // 真正函数逻辑插入这里

        _;
    }

    // =========================================================
    // 4. Constructor（构造函数）
    // =========================================================

    constructor() {
        // constructor 会在部署时执行一次

        // 常用于：
        // 1. 初始化 owner
        // 2. 初始化状态
        // 3. 初始化配置
    }

    // =========================================================
    // 5. Function（函数）
    // =========================================================

    function increment() public {
        // public = 任何地址都能调用

        count++;
        // 等价于：
        // count = count + 1

        // 修改 storage
        // 会消耗 Gas

        emit Increment(msg.sender, count);
        // emit = 触发 event

        // msg.sender =
        // 当前调用这个函数的钱包地址
    }

    // =========================================================
    // 6. Struct（结构体）
    // =========================================================

    struct User {
        // struct = 自定义数据结构

        uint age;
    }

    // 类似 Java：

    /*
    class User {
        int age;
    }
    */

    // =========================================================
    // 7. Enum（枚举）
    // =========================================================

    enum State {
        Open,
        Closed
    }

    // enum = 有限状态集合

    // Open   = 0
    // Closed = 1

    // 常用于：
    // 订单状态
    // NFT销售状态
    // DAO投票状态

    // =========================================================
    // 8. Custom Error（自定义错误）
    // =========================================================

    error NotEnoughBalance(uint current, uint required);

    // error 比 require("string")
    // 更省 Gas

    // current  = 当前余额
    // required = 需要余额
}

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;  // 指定编译器版本

contract MyToken {
    // 状态变量（存储在 Storage，永久保存，写入贵！）
    string public name = "MyToken";
    uint256 public totalSupply;
    
    // mapping：类似 Java 的 HashMap<address, uint256>
    mapping(address => uint256) public balanceOf;
    
    // 事件：写入日志，比写 Storage 便宜 10 倍
    event Transfer(address indexed from, address indexed to, uint256 value);
    
    // constructor：只在部署时执行一次
    constructor(uint256 _initialSupply) {
        totalSupply = _initialSupply;
        balanceOf[msg.sender] = _initialSupply;  // msg.sender = 部署者地址
    }
    
    // 函数修饰符
    // public   = 外部和内部都能调用
    // private  = 只有合约内部
    // internal = 合约内部 + 继承合约
    // external = 只有外部调用
    // view     = 不修改状态（免费 call，不消耗 Gas）
    // pure     = 不读不写状态
    
    function transfer(address _to, uint256 _amount) public returns (bool) {
        require(balanceOf[msg.sender] >= _amount, "Insufficient balance");
        balanceOf[msg.sender] -= _amount;
        balanceOf[_to] += _amount;
        emit Transfer(msg.sender, _to, _amount);  // 发出事件，记录日志
        return true;
    }
}

interface IERC20 {
    // 查询类（view，免费）
    function totalSupply() external view returns (uint256);
    function balanceOf(address account) external view returns (uint256);
    function allowance(address owner, address spender) external view returns (uint256);
    
    // 写操作（需要发交易，消耗 Gas）
    function transfer(address to, uint256 amount) external returns (bool);
    function approve(address spender, uint256 amount) external returns (bool);
    function transferFrom(address from, address to, uint256 amount) external returns (bool);
    
    // 事件（转账和授权时必须 emit）
    event Transfer(address indexed from, address indexed to, uint256 value);
    event Approval(address indexed owner, address indexed spender, uint256 value);
}

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

/**
 * @title MyERC20Token
 * @dev 手动实现 ERC-20（学习用途，生产环境请用 OpenZeppelin）
 */
contract MyERC20Token {
    // ===== 基本信息 =====
    string public name;
    string public symbol;
    uint8 public decimals = 18;  // 和 ETH 一样，18位小数
    uint256 public totalSupply;

    // ===== 核心状态 =====
    mapping(address => uint256) public balanceOf;
    mapping(address => mapping(address => uint256)) public allowance;

    // ===== 事件 =====
    event Transfer(address indexed from, address indexed to, uint256 value);
    event Approval(address indexed owner, address indexed spender, uint256 value);

    // ===== 构造函数 =====
    constructor(string memory _name, string memory _symbol, uint256 _initialSupply) {
        name = _name;
        symbol = _symbol;
        // _initialSupply 是"人类可读"数量，乘以 10^18 转换为最小单位
        totalSupply = _initialSupply * 10 ** uint256(decimals);
        balanceOf[msg.sender] = totalSupply;
        emit Transfer(address(0), msg.sender, totalSupply);  // 铸造事件
    }

    // ===== 转账 =====
    function transfer(address to, uint256 amount) public returns (bool) {
        require(to != address(0), "Transfer to zero address");
        require(balanceOf[msg.sender] >= amount, "Insufficient balance");
        
        balanceOf[msg.sender] -= amount;
        balanceOf[to] += amount;
        emit Transfer(msg.sender, to, amount);
        return true;
    }

    // ===== 授权 =====
    function approve(address spender, uint256 amount) public returns (bool) {
        require(spender != address(0), "Approve to zero address");
        allowance[msg.sender][spender] = amount;
        emit Approval(msg.sender, spender, amount);
        return true;
    }

    // ===== 代扣转账（需要先授权）=====
    function transferFrom(address from, address to, uint256 amount) public returns (bool) {
        require(to != address(0), "Transfer to zero address");
        require(balanceOf[from] >= amount, "Insufficient balance");
        require(allowance[from][msg.sender] >= amount, "Insufficient allowance");
        
        allowance[from][msg.sender] -= amount;
        balanceOf[from] -= amount;
        balanceOf[to] += amount;
        emit Transfer(from, to, amount);
        return true;
    }
}

function A() public { balanceOf[msg.sender] += 1; }
function B() public view returns (uint256) { return balanceOf[msg.sender]; }
function C() public pure returns (uint256) { return 1 + 1; }
function D() external payable { /* 接收ETH */ }