本篇章會以實際的程式碼來說明開發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";
擬合約
一份合約裡面一定會有密密麻麻的條文,而整個合約亦會擬定一個名稱,例如一份工作的合約草擬如下:
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的朋友來說應該相當親切,其實最難就是概念了,例如: 怎麼編譯、怎麼上傳到鏈上、怎麼與錢包結合…,這些都是非常重要的議題,也是完整的智能合約運行的環節,這次的篇章已經是跨越一小步了,距離目標又拉近了一點,加油,持續學習。
喜歡撰寫文章的你,不妨來了解一下:
歡迎加入一起練習寫作,賺取知識