圖片來源

本篇章會以實際的程式碼來說明開發Solidity的組成脈絡與重要的區塊，讓我們不再害怕閱讀艱澀難懂的程式碼，並且具備基礎知識以後也能看懂外面的合約。

SPDX License Identifier

開源程式碼常常會面臨到法律的問題，因此License的宣告就變得非常重要，而Solidity也考慮到這一塊，因此特別規劃了一塊License宣告的區塊。

舉例來說，假設我們希望這份合約是MIT License時可以這樣撰寫

// SPDX-License-Identifier: MIT

在Solidity編譯時會預先檢查這個部分，因此算是比較強規範的一種約定。

Pragmas

主要是透過宣告一些前置檢查作業，像是特定版本，加掛外部的程式碼檢查器避免一些比較基本的錯誤，舉例來說，我們希望solidity的版本不能低於0.5.0時，可以這樣宣告。

pragma solidity ^0.5.0;

而這些規則也是使用標準的semver ，更多的規則細節請參考這裡。

不過除了solidity的特定版本限制之外，也支援ABI解碼器的版本宣告，詳細資訊請參考「這裡」。

引入模組

圖片來源

隨著我們的合約功能越來越複雜，通常會進行模組化，此時就會需要載入外部模組，而在Solidity的開發之下，也提供了Javascript ES6的import語法。

import * as moduleName from "otherfile";
// or this 
import {symbol1 as alias, symbol2} from "otherfile";

關於更進階的import方式請參考「javascript/import」。

擬合約

一份合約裡面一定會有密密麻麻的條文，而整個合約亦會擬定一個名稱，例如一份工作的合約草擬如下：

contract Work {
    ...
}

P.S 一份檔案中可以包含多個合約的組成。

寫條款

每份合約裡面的條文內容就是組成智能合約的重要核心，我們就以工作的合約為例，會有薪資、工作、支付三大基本元素，而每次工作就會增加薪水的這個條件也被撰寫於合約條件之中，最終會產生付款，這邊僅是無條件的付款，我們還可以設計一些額外的約定才能付款，例如： 業績達標幾成…等。

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.7;
contract Work {
    uint salary;
    // Create a new work contract to initialize the salary
    constructor() {
        salary = 0;
    }
    // Increase your salary once you work
    function doWork() public {
        salary += 1;
    }
    // Pay salary
    function pay() public view returns (uint) {
        return salary;
    }
}

說明

每條合約都還能夠細部說明，而單行則以//進行註記，多行則以///進行註記。

// This is a single-line comment.  
/// This is a 
/// multi-line comment.

結語

感覺起來非常直觀，語法也不是說非常艱澀難懂，對於熟悉Javascript的朋友來說應該相當親切，其實最難就是概念了，例如： 怎麼編譯、怎麼上傳到鏈上、怎麼與錢包結合…，這些都是非常重要的議題，也是完整的智能合約運行的環節，這次的篇章已經是跨越一小步了，距離目標又拉近了一點，加油，持續學習。

以上的範例程式碼都在這裡「📦 solidity-remix-toturial/Ep1」歡迎自行取用與Fork，並使用Remix編輯器進行匯入，至於如何匯入可以參考此篇章「【開發智能合約 — Solidity系列】開發環境準備」。

📚 更多關於Solidity的文章請看這裡…

喜歡撰寫文章的你，不妨來了解一下：

Web3.0時代下為創作者、閱讀者打造的專屬共贏平台 — 為什麼要加入？ 

歡迎加入一起練習寫作，賺取知識，累積財富！