【開發智能合約 — Solidity系列】實作篇Ep.2 — 合約中的基本組成元素

State Variables(狀態變數)

...contract Bank {
    /// @notice 記載存款數字
    /// @dev State Variables(狀態變數)
    uint private value;    /// @notice 記載存款擁有者
    /// @dev State Variables(狀態變數)
    address private owner;
}

Functions(功能)

...contract Bank {
   ...    /// @dev Functions(功能): 存款並增加總資產
    function deposit(uint amount){
        value += amount;
    }
}

Function Modifiers(修飾函式)

...contract Bank {    ...    /// @dev Function Modifiers(修飾函式): 務必只能存款擁有者...
    /// msg.sender: 訊息的發送者（或這說是發出這個呼叫的人）
    modifier onlyOwner {
        require(owner == msg.sender);
        _;
    }    /// @dev Functions(功能): 存款並增加總資產
    function deposit(uint amount) public onlyOwner {
        value += amount;
    }
}

Events(事件)

...
contract Bank {
		...    /// @dev 已存款的事件
    /// @param addr 存款者的地址
    /// @param amount 存多少金額
    event Deposited(address addr, uint amount);    /// @dev Functions(功能): 存款並增加總資產
    /// @param amount 欲存款的金額數量
    function deposit(uint amount) public onlyOwner {
        value += amount;        // 觸發已存款的事件
        emit Deposited(msg.sender, amount); 
    }
}

Errors(錯誤處理)

...contract Bank {
    ...    /// @dev 自訂錯誤類型: 資金不足
    /// @param requested 要求的資金
    /// @param available 可用的資金
    error NotEnoughFunds(uint requested, uint available);    /// @dev Errors(錯誤處理): 提款並減少總資產
    function withdraw(uint amount) public onlyOwner {
        if (amount > value)
            revert NotEnoughFunds(amount, value);
        value -= amount;
    }
}

Struct Types(結構型別)

...
contract Bank {
		...    // @dev 帳號的組成內容
    struct Account {        // @dev 帳號的用戶名
        string username;        // @dev 帳號的識別碼
        string id;
    }    // @dev 帳號的變數宣告
    Account private account;}

Enum Types(列舉型別)

...
contract Bank {
		...    /// @notice 交易狀態
    /// @dev 狀態定義包含Start、Doing、Done
    enum Status  { Start, Doing, Done }     /// @notice 狀態
    /// @dev 狀態的變數宣告
    Status private status;    /// @notice 更新狀態
    /// @dev 將內部的狀態更新為外部指定的狀態
    function set(Status _status) public {
        status = _status;
    }}

結語