Solidity 最新 0.5.8 中文文檔發佈

本文首發於深刻淺出區塊鏈社區

熱烈祝賀 Solidity 最新 0.5.8 中文文檔發佈， 這不單是一份 Solidity 速查手冊，更是一份深刻以太坊智能合約開發寶典。

翻譯說明

Solidity 最新 0.5.8 中文文檔 根據當前 最新官方版本v0.5.8 進行翻譯，本翻譯最初 HiBlock 社區發起，後通過 深刻淺出區塊鏈社區 社區成員根據最新版本補充翻譯。

大部分的譯者，都是國內頂尖的以太坊開發和研究人員，部分譯者以下：

• 楊鎮 《深刻以太坊智能合約開發》做者，《精通以太坊》譯者
• 姜信寶 HiBlock 區塊鏈社區發起人 ，
• Tiny熊 《精通以太坊智能合約開發》做者，深刻淺出區塊鏈技術博客發起人
• 蓋方宇 哥倫比亞大學電子工程系博士，專一擴容研究
• 虞是乎 磨鏈發起人
• 左洪斌《Scrum精髓(敏捷轉型指南)》譯者

感謝全部的譯者貢獻，獻花~ 獻花~

這份文檔無疑是最新質量最好的中文文檔，本文僅僅是部分摘要和目錄， 完整文檔請前往 https://learnblockchain.cn/docs/solidity/ 。

翻譯工做是一個持續的過程（這份文檔目前也還有部分未完成），咱們熱情邀請熱愛區塊鏈技術的小夥伴一塊兒參與，歡迎加入咱們Group： https://github.com/lbc-team 。

本中文文檔大部分狀況下，英中直譯，但有時爲了更好的理解也會使用意譯，如需轉載請聯繫Tiny熊（微信：xlbxiong）.

Solidity 語言簡介 及 文檔目錄

Solidity 是一門面向合約的、爲實現智能合約而建立的高級編程語言。這門語言受到了 C++，Python 和 Javascript 語言的影響，設計的目的是能在以太坊虛擬機（EVM）]上運行。

要理解智能合約及虛擬機是怎麼運行，推薦這兩篇很是好的文章 徹底理解以太坊智能合約 及 深刻淺出以太坊虛擬機

Solidity 是靜態類型語言，支持繼承、庫和複雜的用戶定義類型等特性， 如下是完整目錄。

文檔目錄

• 入門智能合約
  • 簡單的智能合約
    • 存儲合約（把一個數據保存到鏈上）
    • 子貨幣合約（Subcurrency）示例
  • 區塊鏈基礎
    • 交易/事務
    • 區塊
  • 以太坊虛擬機
    • 概述
    • 帳戶
    • 交易
    • Gas
    • 存儲，內存和棧
    • 指令集
    • 消息調用
    • 委託調用/代碼調用和庫
    • 日誌
    • 合約建立
    • 失效和自毀
• 安裝Solidity編譯器
  • 版本
  • Remix
  • npm / Node.js
  • Docker
  • 二進制包
  • 從源代碼編譯
    • 克隆代碼庫
    • 先決條件 - macOS
    • 先決條件 - Windows
    • 外部依賴
    • 命令行構建
  • CMake參數
    • SMT Solvers
  • 版本號字符串詳解
  • 版本信息詳情
• 根據例子學習Solidity
  • 投票合約
    • 可能的優化
  • 祕密競價（盲拍）合約
    • 簡單的公開拍賣
    • 祕密競拍（盲拍）
  • 安全的遠程購買合約
  • 微支付通道合約
    • 建立及驗證簽名
      • 建立簽名
      • 哪些內容須要簽名
      • 打包參數
      • 在Solidity中還原消息簽名者
      • 提取簽名參數
      • 計算信息的Hash
      • ReceiverPays 完整合約代碼
    • 編寫一個簡單的支付通道
      • 什麼是支付通道？
      • 打開支付通道
      • 進行支付
      • 關閉狀態通道
      • 通道有效期
      • 完整合約代碼
      • 驗證支付
  • 庫合約使用
• 深刻理解Solidity
  • Solidity 源文件結構
    • Pragmas
    • 版本標識
      • 標註實驗性功能
    • 導入其餘源文件
      • 語法與語義
      • 路徑
      • 在實際的編譯器中使用
    • 註釋
  • 合約結構
    • 狀態變量
    • 函數
    • 函數 修飾器modifier
    • 事件 Event
    • 結構體
    • 枚舉類型
  • 類型
    • 值類型
      • 布爾類型
      • 整型
      • 定長浮點型
      • 地址類型 Address
      • 合約類型
      • 定長字節數組
      • 變長字節數組
      • 地址字面常量
      • 有理數和整數字面常量
      • 字符串字面常量及類型
      • 十六進制字面常量
      • 枚舉類型
      • 函數類型
    • 引用類型
      • 數據位置
      • 數組
      • 結構體
    • 映射
    • 涉及 LValues 的運算符
      • delete
    • 基本類型之間的轉換
      • 隱式轉換
      • 顯式轉換
    • 字面常量與基本類型的轉換
      • 整型
      • 定長字節數組
      • 地址類型
    • 類型推斷(已棄用)
  • 單位和全局變量
    • 以太幣Ether 單位
    • 時間單位
    • 特殊變量和函數
      • 區塊和交易屬性
      • ABI 編碼函數
      • 錯誤處理
      • 數學和密碼學函數
      • 地址相關
      • 合約相關
      • 類型信息
  • 表達式和控制結構
    • 輸入參數和輸出參數
      • 輸入參數
      • 輸出參數
    • 控制結構
    • 函數調用
      • 內部函數調用
      • 外部函數調用
      • 具名調用和匿名函數參數
      • 省略函數參數名稱
    • 經過 new 建立合約
    • 賦值
      • 解構賦值和返回多值
      • 數組和結構體的複雜性
    • 做用域和聲明
    • 錯誤處理：Assert, Require, Revert and Exceptions
  • 合約
    • 建立合約
    • 可見性和 getter 函數
      • Getter 函數
    • 函數 修飾器modifier
    • Constant 狀態變量
    • 函數
      • 函數參數及返回值
      • View 函數
      • Pure 函數
      • Fallback 回退函數
      • 函數重載
    • 事件
      • 日誌的底層接口
      • 其它學習事件機制的資源
    • 繼承
      • 構造器
      • 基類構造函數的參數
      • 多重繼承與線性化
      • 繼承有相同名字的不一樣類型成員
    • 抽象合約
    • 接口
    • 庫
      • 庫的調用保護
    • Using For
  • Solidity彙編
    • 內聯彙編
      • 例子
      • 語法
      • 操做碼
      • 字面常量
      • 函數風格
      • 訪問外部變量和函數
      • 標籤
      • 彙編局部變量聲明
      • 賦值
      • If
      • Switch
      • 循環
      • 函數
      • 注意事項
      • Solidity 慣例
    • 獨立彙編
      • 彙編語法
  • 雜項
    • 存儲storage 中的狀態變量儲存結構
    • 內存memory 中的存儲結構
    • 調用數據存儲結構
    • 內部機制 - 清理變量
    • 內部機制 - 優化器
    • 源代碼映射
    • 技巧和竅門
    • 速查表
      • 操做符優先級
      • 全局變量
      • 函數可見性說明符
      • 修改器
      • 保留字
      • 語法表
  • Solidity v0.5.0 重大更新
    • 語義變化
    • 語義及語法更改
    • 準確性要求
    • 棄用元素
      • 棄用命令行及 JSON 接口
      • 構造函數變動
      • 棄用函數
      • 棄用類型轉換
      • 棄用字面量及後綴
      • 棄用變量
      • 棄用語法
    • 和老合約進行交互
    • 舉例
• 註釋描述規範
  • 文檔舉例
  • 標籤
    • Dynamic expressions
    • Inheritance Notes
  • 文檔輸出
    • 用戶文檔
    • 開發者文檔
• 安全考量
  • 陷阱
    • 私有信息和隨機性
    • 重入
    • gas 限制和循環
    • 發送和接收 以太幣Ether
    • 調用棧深度
    • tx.origin問題
    • 整型溢出問題
    • 細枝末節
  • 推薦作法
    • 認真對待警告
    • 限定 以太幣Ether 的數量
    • 保持合約簡練且模塊化
    • 使用「檢查-生效-交互」（Checks-Effects-Interactions）模式
    • 包含故障-安全（Fail-Safe）模式
  • 形式化驗證
• 資源
  • 經常使用資源
  • Solidity IDE及編輯器
  • Solidity 工具
  • 第三方 Solidity 解析器
• 使用編譯器
  • 使用命令行編譯器
  • 編譯器輸入輸出JSON描述
    • 輸入說明
    • 輸出說明
      • 錯誤類型
• 合約的元數據
  • 元數據哈希字節碼的編碼
  • 自動化接口生成和 以太坊標準說明格式natspec 的使用方法
  • 源代碼驗證的使用方法
• 應用二進制接口Application Binary Interface(ABI) 說明
  • 基本設計
  • 函數選擇器Function Selector
  • 參數編碼
  • 類型
  • 編碼的形式化說明
  • 函數選擇器Function Selector 和參數編碼
  • 例子
  • 動態類型的使用
  • 事件
  • JSON
    • 處理 元組tuple 類型
  • 非標準打包模式
• Yul
  • Yul 語言說明
    • 語法層面的限制
    • 做用域規則
    • 形式規範
    • 類型轉換函數
    • 低級函數
    • 後端
    • 後端: EVM
    • 後端: 「EVM 1.5」
    • 後端: eWASM
  • Yul 對象說明
• 編程風格指南
  • 概述
  • 代碼結構
    • 縮進
    • 製表符或空格
    • 空行
    • 代碼行的最大長度
    • 源文件編碼格式
    • Imports 規範
    • 函數順序
    • 表達式中的空格
    • 控制結構
    • 函數聲明
    • 映射
    • 變量聲明
    • 其餘建議
  • 命名規範
    • 命名方式
    • 應避免的名稱
    • 合約和庫名稱
    • 結構體名稱
    • 事件名稱
    • 函數名稱
    • 函數參數命名
    • 局部變量和狀態變量名稱
    • 常量命名
    • 修飾符命名
    • 枚舉變量命名
    • 避免命名衝突
  • 描述註釋 NatSpec
• 通用模式
  • 從合約中提款
  • 限制訪問
  • 狀態機
    • 示例
• 已知bug列表
• 貢獻方式
  • 怎樣報告問題
  • Pull Request 的工做流
  • 運行編譯器測試
    • 編寫和運行語法測試
  • 經過 AFL 運行 Fuzzer
  • Whiskers 模板系統
• LLL
• 常見問題
  • 基本問題
  • 高級問題
    • 怎樣才能在合約中獲取一個隨機數？（實施一份自動回款的博彩合約）
    • 從另外一份合約中的 non-constant 函數獲取返回值
    • 讓合約在首次被挖出時就開始作些事情
    • 怎樣才能建立二維數組？

深刻淺出區塊鏈 - 系統學習區塊鏈，學區塊鏈都在這裏，打造最好的區塊鏈技術博客。