智能合约从入门到精通：Solidity语言的开发规范和开发流程

最新推荐文章于 2024-11-03 11:01:20 发布

weixin_34391854

最新推荐文章于 2024-11-03 11:01:20 发布

阅读量135

点赞数

文章标签：数据结构与算法区块链 json

原文链接：https://juejin.im/post/5b3ee4dfe51d4519627284fb

版权

简介：上面介绍的在Solidity中嵌入的内联汇编语言也可以单独使用。实际上，它是被计划用来作为编译器的一种中间语言。本文我们将介绍开发智能合约过程中Solidity语言的开发规范和开发流程。

Solidity作为编译器的一种中间语言。在开发智能合约时需要遵守相应的开发规范和开发流程。

开发规范

命名规范

目录和文件

目录使用小写，请勿使用特殊符号；
库文件和合约文件统一以.sol为后缀；
合约文件名保持与合约名一致；
文件名采用驼峰命名（首字母大写）；

合约、库文件命名

合约名采用驼峰命名（首字符大写），例如：UserManager、ActionManager；
方法的命名使用驼峰法（首字母小写），例如：getNumber；
属性的命名使用驼峰法（首字母小写），例如：userName；
以双下划线__打头的函数或方法作为内部合约调用方法；
合约library库命名以前缀Lib+结构体名称，如：LibUser、LibAction；

常量和配置

常量以大写字母和下划线命名，例如 APP_PATH；
配置参数以小写字母和下划线命名，例如url_route_on和url_convert；

目录结构

|-app(truffle服务目录)
|-contracts(合约目录)                    
|  └─interfaces(抽象合约目录)                   
|                  
|  └─library(结构解析库目录)                    
|     
|  └─sysbase(公共合约目录)                
|     |-OwnerNamed.sol(基础合约，所有用户业务合约，必须继承此基础合约)       
|     └─BaseModule.sol  
|        
|  └─utillib(工具库目录)                    
|     |-LibDB.sol
|     |-LibDecode.sol
|     |-LibInt.sol
|     |-LibJson.sol
|     |-LibLog.sol
|     |-LibNIZK.sol
|     |-LibNizkParam.sol
|     |-LibPaillier.sol
|     |-LibStack.sol
|     |-LibString.sol
|     └─Strings.sol
|  
|-migrations(truffle发布配置目录)
|-test(测试脚本目录)
|-truffle.js
Copy
复制代码

常规开发中，使用目录对合约文件的功能进行分类，下面逐一介绍功能：

contracts truffle 标准工作目录中的合约目录，合约存放在此目录下，如：UserManager.sol；
interfaces 存放抽象合约，如：IConsumerManager.sol；
library 存放struct结构库文件；
sysbase 存储公共合约目录，例如：OwnerNamed.sol；
utillib 存放工具库，如：LibString.sol, LibLog.sol；

开发流程

合约接口定义

按照良好的编程习惯，在编写业务方法前，首先定义接口，并交付给调用者。

数据结构定义

用户定义的合约接口中，如果有比较复杂的输入/输出数据，就有必要提前定义一些数据结构，并提供操作这些数据结构的一些常用方法（主要是一些序列化成JSON字符串的方法）。

业务合约编写

实现合约接口定义，并实现用户的业务逻辑。在业务合约的构造函数中，需要把业务合约注册到模块合约中。

如果用户只是想编写业务合约，做学习，测试用，则可以把业务合约注册到"juzix.io.debugModule"这个特殊名称的模块合约中，则用户可以不需要编写模块合约，从而在JUICE客户端IDE中直接调用业务合约的方法。

模块合约编写

编写模块合约，这是JUICE开放服务平台的要求，以便管理用户的DAPP应用、业务合约。在模块合约的构造函数中，需要把模块合约注册到链上，并在构造函数中说明模块合约将会使用到的所有业务合约。

用户编写了模块合约、并部署到JUICE区块链后，模块的名称将会显示在JUICE开放服务平台的“我的应用”中，点击“我的应用”的某个应用，将会跳转到用户开放的DAPP应用。如何设置应用的跳转URL，参考模块合约编写https://open.juzix.net/api_doc/part03/example/modules.md