智能合约最佳实践 之 Solidity 编码规范
每一门语言都有其相应的编码规范, Solidity 也一样, 下面官方推荐的规范及我的总结,供大家参考,希望可以帮助大家写出更好规范的智能合约。
命名规范
避免使用
小写的l,大写的I,大写的O 应该避免在命名中单独出现,因为很容易产生混淆。
合约、库、事件、枚举及结构体命名
合约、库、事件及结构体命名应该使用单词首字母大写的方式,这个方式也称为:帕斯卡命名法或大驼峰式命名法,比如:SimpleToken, SmartBank, CertificateHashRepository,Player。
函数、参数、变量及修饰器
函数、参数、变量及修饰器应该使用首单词小写后面单词大写的方式,这个方式也称为:(小)驼峰式命名法,是一种混合大小写的方式,如:
- 函数名应该如:getBalance,transfer,verifyOwner,addMember。
- 参数和变量应该如:initialSupply,senderAddress,account,isPreSale。
- 修饰器应该如:onlyAfter,onlyOwner。
代码格式相关
缩进
使用空格(spaces)而不是Tab, 缩进应该是4个空格
空行
合约之间应该有空行,例如:
|
|
而不是使用:
|
|
- 函数之间应该有空行,例如:
|
|
没有实现的话,空行可以省去,如:
|
|
而不是:
|
|
左括号应该跟定义在一行
定义包括合约定义、函数定义、库定义、结构体定义等等,例如推荐使用:
|
|
而不是:
|
|
左括号应该跟条件控制在一行
在使用if, else, while, for 时,推荐的写法是:
|
|
而不是:
|
|
如果控制语句内只有一行,括号可省略,如:
|
|
但像下面一个语句有多方就不能省略,如:
|
|
表达式内的空格
一个单行的表达里,在小括号、中括号、大括号里应该避免不必要的空格,例如推荐使用:
1
spam(ham[1], Coin({name: "ham"}));
而不是:
1
spam( ham[ 1 ], Coin( { name: "ham" } ) );
有一种例外是,结尾的括号跟在结束的分号后面, 应该加一个空格,如下面的方式也是推荐的:
1
function singleLine() public { spam(); }
分号;前不应该有空格,例如推荐使用:
1
function spam(uint i, Coin coin) public;
而不是:
1
function spam(uint i , Coin coin) public ;
不要为对齐添加不必要的空格,例如推荐使用:
1 2 3
x = 1; y = 2; long_variable = 3;
而不是:
1
2
3
x = 1;
y = 2;
long_variable = 3;
回退函数不应该有空格,例如推荐使用:
1 2 3 4 5 6 7 8 9 10 11 12
function() public {... }``` 而不是:```js function () public {... }
控制每一行长度
每行不应该太长,最好在79(或99)个字符以内,函数的参数应该是单独的行,且只有一个缩进,例如推荐的方式是:
|
|
而不是:
|
|
对应的赋值语句应该是这样写:
|
|
而不是:
|
|
事件定义也应该遵循同样的原则,例如应该使用:
|
|
而不是:
|
|
文件编码格式
推荐使用utf-8 及 ASCII 编码
引入文件应该在最上方
建议使用:
|
|
而不是:
|
|
函数编写规范
函数的顺序
在编写函数的时候,应该让大家容易找到构造函数,回退函数,官方推荐的的函数顺序是:
- 构造函数
- 回退函数 (如果有)
- 外部函数(external)
- 公有函数(public)
- 内部函数(internal)
- 私有函数(private)
同一类函数时,constant函数放在后面, 例如推荐方式为:
|
|
而不是下面的函数顺序:
|
|
明确函数的可见性
所有的函数(包括构造函数)应该在定义的时候明确函数的可见性,例如应该使用:
|
|
而不是
|
|
可见性应该在修饰符前面
函数的可见性应该写在自定义的函数修饰符前面,例如:
|
|
而不是
|
|
区分函数和事件
为了防止函数和事件(Event)产生混淆,声明一个事件使用大写并加入前缀(可使用LOG)。对于函数, 始终以小写字母开头,构造函数除外。
|
|
常量
常量应该使用全大写及下划线分割大词的方式,如:MAX_BLOCKS,TOKEN_NAME, CONTRACT_VERSION。
参考文献
Solidity style-guide
- 本文作者: Tiny熊
- 本文链接: https://learnblockchain.cn/2018/05/04/solidity-style-guide/
智能合约最佳实践 之 Solidity 编码规范相关推荐
- 智能合约_HPB智能合约最佳实践
1 .概述 1.1 前言 本文档主要通过实例指导如何在HPB主网上发布智能合约教程. 文档阅读人员:社区开发人员.测试人员.运维人员. 1.2 学习准备 1.2.1 Solidity语言 Solidi ...
- 蚂蚁区块链第10课 可信计算及TEE硬件隐私合约链智能合约开发实践
1,摘要 本文介绍可信计算分类INTEL SGX技术和ARM TRUSTZONE技术技术方案概要,以及应用INTEL SGX技术的蚂蚁区块链TEE硬件隐私链的智能合约开发实践. 2,可信计算和2种技术 ...
- 本周五丨数据库智能管控最佳实践与探索
数据库管控能力的高低直接影响了企业数字化转型的进程,甚至于关乎成败.面对日趋丰富的业务场景和复杂的数据库环境,要做好数据库的管控工作,势必要引入云化.平台化.智能化的架构设计与技术. 那么本次云和恩墨 ...
- 以太坊智能合约 —— 最佳安全开发指南
原文出处: https://github.com/ConsenSys/smart-contract-best-practices/blob/master/README-zh.md#%E4%BB%A5% ...
- C++ 智能指针最佳实践源码分析
作者:lucasfan,腾讯 IEG Global Pub.Tech. 客户端工程师 智能指针在 C++11 标准中被引入真正标准库(C++98 中引入的 auto_ptr 存在较多问题),但目前很多 ...
- 智能分析最佳实践——指标逻辑树
背景 所有业务都会面对"为什么涨.为什么降.原因是什么?"这种简单粗暴又不易定位的业务问题.为了找出数据发生异动的原因,业务人员会通过使用多维查询.dashboard等数据产品锁定 ...
- [EOS源码分析]7.EOS智能合约开发实践之合约调用合约(inline action)
首先,目前dawn-4.1, dawn-4.2使用inline action是会报如下错误 transaction declares authority '{"actor":&qu ...
- 最佳实践之Android代码规范
命名规范 包命名规范 采用反域名命名规则,包名全部小写,连续的单词只是简单地连接起来,不使用下划线,一级包名为com,二级包名为xxx(可以是公司域名或者个人命名),三级包名根据应用进行命名,四级包名 ...
- 智能合约开发 Ganache | Truffle | Solidity | Web3.js
Truffle Truffle是最全面的智能合约开发套件 内置智能合约编译.链接.部署和二进制管理. 使用断点.变量分析和步骤功能进行高级调试. Truffle基于JavaScript编写,可以在智能 ...
最新文章
- 欢迎来到美多商城!-项目准备之项目介绍-项目需求分析-项目架构设计
- 朋友在小厂待到三十多岁了 现在跳槽能找到什么样的工作
- iOS 11开发教程(六)iOS11Main.storyboard文件编辑界面
- MFC:总结篇 CDialog 类
- 教给孩子的10句“保命金言”(图)
- 博士面试被拒,只因第一学历非985、211...
- 《我的第一本算法书》读书笔记
- mysql之desc 与asc
- 【Android开发】消息提示框与对话框-使用AlertDialog创建对话框
- 一张图慢慢转换成下一张图_如何把一张照片变成炫酷的动图?
- hadoop 2022 面试题总结了
- 2022N1叉车司机考试练习题及在线模拟考试
- html使用highcharts绘制饼图,饼图.html · 赵文博/Highcharts - Gitee.com
- 超低功耗LoRa无线通信应用实践
- 36氪WISE 2017:融云斩获年度最具影响力奖
- 获取 Windows 任务管理器中应用程序和进程 任务
- git 批量删除 tag
- 网络攻击与防御期末考试知识点
- wangEditor自定义上传图片上传按钮,适合各种JS或者后端上传
- 怎么修改html行内样式表,原生JS获取及设置CSS样式-1.行内样式
热门文章
- windows脚本编制引擎_从零开始的场景编辑器(二):脚本系统
- java 内存分配实例_java内存管理实例讲解
- 无监控,不运维:解读企业全栈式监控运
- PTA L2-006 树的遍历-二叉树的后序遍历+中序遍历,输出层序遍历 团体程序设计天梯赛-练习集...
- [洛谷P4234]最小差值生成树
- 询问任意区间的min,max,gcd,lcm,sum,xor,or,and
- 4.Unix工作环境
- 变量提升、作用域this实战(真题:看代码输出)
- (进阶)LeetCode(119)——杨辉三角 II(JavaScript)
- 就9.5面试做个小结