solcjs是用于编译solidity文件的node.js库和命令行工具。它不使用solc命令行编译器,而是纯粹使用JavaScript进行编译,因此它的安装比solc简单得多。
Solc是真实的solidity编译器,用C++编写。C++代码使用emscripten被编译成JavaScript。Solc的每一个版本都被编译成JavaScript。访问https://gIthub.com/ethereum/solc-bin/tree/gh-pages/bin ,可以发现每个solidity版本的以JavaScript为基础的编译器。solcjs仅使用这些编译器中的一种来编译solidity源代码。这些编译器在浏览器和node.js环境中都可以运行。
solidity的浏览器使用这些以JavaScript为基础的编译器编译solidity源代码。
6.2.1 安装solcjs
solcjs可以作为solc的npm包使用。和其他npm包一样,solcjs npm包可以在本地或者全局安装。如果包安装在全局,则命令行工具solcjs可用。因此,为了安装命令行工具,运行如下命令:
接着运行如下命令,看看如何用命令行编译器编译solidity文件:
我们不学习solcjs命令行工具,而是学习用solcjs API编译solidity文件。
solcjs默认使用的编译器版本与其自身版本匹配。例如,如果安装solcjs的0.4.8版本,则将默认使用0.4.8编译器版本进行编译。也可以配置solcjs,以使用一些其他的编译器版本。在写本书之时,solcjs的最新版本是0.4.8。
6.2.2 solcjs API
solcjs提供了compiler方法,用于编译solidity代码。根据源代码是否有import(引用),该 方法可以用于两种不同方法:如果源代码没有import,则需要两个实参,即第一个实参是字符串作solidity源代码,第二个实参是Boolean, 表示是否最优化字节码。如果源字符串包含多个合约,则将编译全部。示例如下:
如果源代码包含对其他合约的引用(imports),则第一个实参就是一个对象,它的键是文件名,值是文件内容。所以无论何时编译器看到一个import语句,它不会在文件系统中寻找文件,而是通过与文件名匹配的键在对象中寻找文件内容。示例如下:
如果想在编译时从文件系统读取被引用的文件或者在编译时解析文件内容,则compiler方法支持第三个实参,即取文件名并返回文件内容的方法。示例如下:
1.使用不同的编译器版本
为了使用不同的solidity版本编译合约,需要用useVersion方法去引用一个不同的编译器。useVersion用一个字符串,该字符串表示存储了编译器的JavaScript文件名,并在/node_modules/solc/bin目录中寻找该文件。
solcjs还提供另一种方式loadRemoteVersion,它用的编译器文件名与solc-bin文件库(https://github.com/etherum/solc-bin )中的solc-bin/bin目录下的文件名进行匹配,并下载和使用。
最后,solcjs还提供了另一个setupMethods方法,它与useVersion类似,但是可以从任意目录加载编译器。
下面用一个示例来演示这三个方法的用法:
为了运行上述代码,首先需要从solc-bin repository下载v0.4.7.commit.822622cf.js文件,并将其保存在node_modules/solc/bin目录中。然 后需要下载编译器文件版本0.4.8,将其保存在文件系统中某处,并把setupMethods调用中的路径指向那个目录。
2.接入库
如果solidity源代码引用库,生成的字节码将包含被引用库真实地址的占位符。这些必须在部署合约之前,通过一个称为接入(linking)的程序更新。
solcjs提供了把库地址接入生成的字节码的linkByteCode方法。示例如下:
3.更新ABI
合约ABI提供多种信息,这些信息不包括合约的实现。两种不同版本的编译器生成的ABI可能不匹配,因为较高版本比较 低版本支持更多的solidity功能,所以ABI中有一些额外信息。例如,回退函数是在Solidity 0.4.0版本时引入的,所以使用0.4.0以下版本编译器生成的ABI没有回退函数的信息,但这些智能合约的行为就像它们有回退函数一样,只不过是空的 函数体和应付修改器。所以应当更新ABI,以便让依赖于较新Solidity版本ABI的应用有关于合约的更佳信息。
solcjs提供了用于更新的API。示例如下:
其中,0.3.6表示ABI是由0.3.6版本编译器生成的。因为我们正在使用solcjs版本0.4.8,将更新ABI以匹配编译器版本生成的ABI,但不能是更高的版本。
上述代码的输出如下:
来源:我是码农,转载请保留出处和链接!
本文链接:http://www.54manong.com/?id=553