Solidity语言编辑器REMIX指导大全

我不是女神ヾ 2022-05-20 01:44 253阅读 0赞

# 文章摘要 #

本文目标：本文翻译和实践Solidity语言编辑器REMIX官网帮助文档，但并不拘泥于逐字翻译，而时根据实践用中文语言讲透编辑器相关功能。

前置条件：了解以太坊ETH和Solidity语言。

技术收获：

*  使用REMIX编辑器进行Solidity语言编程，编译，运行，调试。
 *  REMIX界面介绍
    
    2 使用REMIX编辑器执行”HELLO WORLD”的智能合约

REMIX是一个智能合约编程语言Solidity的集成开发环境。

最简单的入门就是进行”HELLO WORLD”的程序运行。

2.1 智能合约编译

在CHROME浏览器上点击链接REMIX官网浏览器版编辑器（[http://remix.ethereum.org/][http_remix.ethereum.org]）即可打开REMIX编辑器。部分不能正常访问官网的，可以访问笔者的国内REMIX编辑器（[http://remix2.ju3ban.net/][http_remix2.ju3ban.net]）。

新增一个命名为“HelloWorld.sol”的文件，复制以下代码：

pragma solidity ^0.4.17;
    
    contract Hello         
    
    {    
    
    address creator;         
    
    string greeting;         
    
    function Hello(string _greeting) public       
    
    {        
    
    creator = msg.sender;        
    
    greeting = _greeting;    
    
    }        
    
    function greet() public constant returns (string)               
    
    {
    
    return greeting;    
    
    }        
    
    function setGreeting(string _newgreeting) public    
    
    {        
    
    greeting = _newgreeting;    
    
    }         
    
    /**********      Standard kill() function to recover funds       **********/        
    
    function kill() public    
    
    {         
    
    if (msg.sender == creator)            
    
    suicide(creator);  // kills this contract and sends remaining funds back to creator    
    
    }
    
    }

点击”Start to compile”按钮，会得到一下结果：

![image][]

智能合约编译

除一些函数的告警提示外，结果表明该智能合约编译成功。

2.1.1 编译告警

如果编写的程序有告警，REMIX会有提示。一般来说，提示不必修改。

![image][image 1]

REMIXD编译告警

2.1.2 编译错误

为了说明编译错误案例，把该文件的第17行”return greeting;”改为”return \_greeting;”, 重新编译，得到以下结果

![image][image 2]

REMIXD编译错误

如果编写的Solidity程序存在语法错误，Remix编译器会以粉红色底色提示显示错误原因，并在编辑器窗口提示位置。

编译错误演示完后，恢复第17行代码为”return greeting;”

2.1.3 详情信息

点击”Detail”按钮，可以看到详细信息。其中WEB3DEPLOY部分的内容就是在案例《第二课 如何实现以太坊最简智能合约“Hello World”的运行》([https://www.jianshu.com/p/2a5d60744988][https_www.jianshu.com_p_2a5d60744988]）中geth控制台使用的编译后代码。

![image][image 3]

DETAIL的内容

2.2 智能合约运行

2.2.1 创建智能合约

选择“Run”的页面，选择Environment环境为Javascript VM,在“Create”按钮前输入框内输入”Hello World!”\[注意：输入字符串一定要有英文双引号\]，点击“Create”按钮。

![image][image 4]

创建智能合约

2.2.2 运行greet函数

点击浅蓝色函数”greet”按钮，可以看到输出结果为“Hello World!”

![image][image 5]

运行函数greet

说明：浅蓝色按钮函数表示该交易函数运行时不需要消耗GAS的。

2.2.3 运行setGreeting函数

在setGreeting函数按钮的输入框输入内容”Hello Duncan!”, 运行后在点击执行”greet”函数，发现该函数的输出内容已变为”Hello Duncan!”了，说明setGreeting执行正常。

![image][image 6]

运行函数SetGreeting

说明：粉红色按钮函数表示该交易函数运行时是需要消耗GAS的。

# 3 #

# REMIX界面详解 #

第2章以“Hello World”为例，介绍了REMIX集成环境的基本使用方法。本章介绍REMIX编辑器的详细功能描述。

3.1 REMIX集成环境概述

REMIX是一个智能合约编程语言Solidity的集成开发环境，它集成了一个调试器和测试环境。

如果你对以下内容感兴趣，REMIX是一个不错的学习方式：

*  开发智能合约（REMIX集成了SOLIDITY编辑器）
 *  调试智能合约
 *  获取已运行合约的状态和属性
 *  调试已经提交的合约
 *  分析SOLIDITY代码，以便减少编码错误和加强最佳实践
 *  配合Mist(或者任何植入web3的工具)，REMIX可用于测试和调试DAPP分布式程序。（参考链接Debugging a Dapp using Remix - Mist - Geth ）（[https://remix.readthedocs.io/en/latest/tutorial\_mist.html][https_remix.readthedocs.io_en_latest_tutorial_mist.html]）

详解介绍使用的程序案例为”ballot.sol”文件的代码，完整代码如下：

pragma solidity ^0.4.0;
    
    contract Ballot {    
    
    struct Voter {        
    
    uint weight;        
    
    bool voted;        
    
    uint8 vote;        
    
    address delegate;    
    
    }    
    
    struct Proposal {        
    
    uint voteCount;    
    
    }    
    
    address chairperson;    
    
    mapping(address => Voter) voters;    
    
    Proposal[] proposals;    
    
    /// Create a new ballot with $(_numProposals) different proposals.    function Ballot(uint8 _numProposals) public {        
    
    chairperson = msg.sender;       
    
     voters[chairperson].weight = 1;        
    
    proposals.length = _numProposals;    
    
    }    
    
    /// Give $(toVoter) the right to vote on this ballot.   
    
    /// May only be called by $(chairperson).    
    
    function giveRightToVote(address toVoter) public {        
    
    if (msg.sender != chairperson || voters[toVoter].voted) return;        
    
    voters[toVoter].weight = 1;    
    
    }    
    
    /// Delegate your vote to the voter $(to).    
    
    function delegate(address to) public {        
    
    Voter storage sender = voters[msg.sender]; // assigns reference        if (sender.voted) return;        
    
    while (voters[to].delegate != address(0) && voters[to].delegate != msg.sender)            
    
    to = voters[to].delegate;        
    
    if (to == msg.sender) return;        
    
    sender.voted = true;        
    
    sender.delegate = to;        
    
    Voter storage delegateTo = voters[to];        
    
    if (delegateTo.voted)            
    
    proposals[delegateTo.vote].voteCount += sender.weight;        
    
    else            
    
    delegateTo.weight += sender.weight;    
    
    }    
    
    /// Give a single vote to proposal $(toProposal).    
    
    function vote(uint8 toProposal) public {        
    
    Voter storage sender = voters[msg.sender];       
    
     if (sender.voted || toProposal >= proposals.length) return;        
    
    sender.voted = true;        
    
    sender.vote = toProposal;        
    
    proposals[toProposal].voteCount += sender.weight;    
    
    }    
    
    function winningProposal() public constant returns (uint8 _winningProposal) {        
    
    uint256 winningVoteCount = 0;       
    
     for (uint8 prop = 0; prop < proposals.length; prop++)            
    
    if (proposals[prop].voteCount > winningVoteCount) {                winningVoteCount = proposals[prop].voteCount;                _winningProposal = prop;           
    
     }    
    
    }
    
    }

REMIX主界面截图如下，具体说明参考各个子章节。

![image][image 7]

REMIX主界面截图

3.2 文件浏览器

![image][image 8]

文件浏览器

1）增加新文件(Create new File)

点击在浏览器上增加一个新的智能合约文件

![image][image 9]

增加新文件

2）打开文件(Add Local File)

![image][image 10]

打开存在文件

3） 匿名发布到GitHub（Publish to Gist）

![image][image 11]

匿名发布到GitHub

4） 复制文件列表到其他浏览器(Copy to another instance)

例如，把“[http://remix2.ju3ban.net][http_remix2.ju3ban.net]”的文件列表复制到另一个浏览器“[http://remix.ju3ban.net][http_remix.ju3ban.net]”

修改输入目标浏览器的网址：

![image][image 12]

复制到别的浏览器

打开新的浏览器，文件列表已复制过来了：

![image][image 13]

别的浏览器的文件列表

5）链接本地服务器（Connect to Localhost）

在Remix文件浏览器上的文件并不会同步到本地文件系统，对浏览器文件列表的新增/修改/删除并不会同步本地文件。一般操作时，调试成功的代码需要在本地文件系统新建文件保存。Remix浏览器提供了一种方法，就是使用Remixd，允许保存和同步浏览器文件到你的本地计算机中。因为根据官网文档，笔者没有能够在Windows 10系统或者Ubuntu中安装成功Remixd，本文不再详细介绍该功能。有兴趣的朋友欢迎根据官网文档（）尝试使用REMIXD同步。成功者欢迎跟辉哥反馈交流，补充完整这个文档。

![image][image 14]

链接本地文件系统

3.3 Solidity语言编辑器

![image][image 15]

Solidity 浏览器

Solidity语言编辑器重要的功能列表：

*  TAB页面显示打开的文件
 *  编译告警或者错误会显示在编辑器最左侧边
 *  Remix自动保存当前文件（修改后5秒内）
 *  \+/- 表示增加/减少编辑器的字体大小

3.4 终端输出器

![image][image 16]

终端输出器窗口

终端输出器功能说明：

*  点击1按钮可隐藏终端输出器
 *  点击2按钮可情况输出器内容
 *  点击3按钮可复制地址信息等到缓存，便于粘贴
 *  点击Details按钮可展开交易详细内容
 *  点击Debug按钮可调试该交易合约
 *  点击复选框，可增加选择显示所有的交易还是只显示智能合约相关的交易程序。默认只显示后者。

![image][image 17]

终端显示内容

*  输入关键字可搜索定位输出内容   
    例如输入”Hello “关键字，相关的内容就显示出来了。

![image][image 18]

搜索Hello关键字

*  监听网络（Listen to network）   
    勾选后，REMIX不仅监听REMIX编辑器中创建的交易，还监听当前环境中所有的交易。

3.5 分页控制面板

3.5.1 编译合约

![image][image 19]

Compile控制面板

发布到Swarm网络(Publish on Swarm)

点击“Publish on Swarm”按钮可把智能合约源码和对应的ABI信息发布到网络上。这个合约智能是非抽象类的才能发布。

合约发布后，你可以点击Detail按钮，在弹出窗口的“SWARM LOCATION”

位置找到对应的MetaDATA信息。

信息中的SWARM LOCATION位置有对应网址，在能科学上网的计算机就可找到该合同的MetaData信息 “bzzr://165fad4c3d8ead3a7fe28296777b4bedafb09bb57de2e9ba39c1547866437182”

3.5.2 运行

![image][image 20]

Run控制面板

重点特性说明

1） 环境选择

JavaScript VM: 所有交易在浏览器的沙盒中被执行。这以为着没有结果是永久保存的。当页面重载后，一个新的区块链会被从零开始运行，老的会被丢弃。

Injected Provider: Remix将连接被植入的Web3对象。例如Mist或者Metamask钱包是提供植入的Web3对象的例子。例如《第八课 如何调试以太坊官网的智能合约众筹案例》（[https://www.jianshu.com/p/c7c87c7ad74f][https_www.jianshu.com_p_c7c87c7ad74f]）就是使用Meta的账号。

Web3 Provider: Remix将连接到一个远程节点。你可以用这个地址来选择钱包客户端：geth, parity or any Ethereum client.

2） 初始化合约

创建合约

“Create”按钮用于创建合约。合约创建时，需要参考左边构建函数定义（智能合约的同名函数为构建函数）的类型来输入参数。

![image][image 21]

创建合约

注意：如果输入参数为地址或者字符串，都需要使用英文双引号(“”)囊括起来，使用英文(“,”)表示输入参数分割。

运行合约

假设给出的地址是一个选择合同的实例。通过这种方法就可以跟已经运行的合同进行交互。要特别谨慎使用该功能，因为系统不做验证。运行时要确认信任这个地址的合同。

等待(pending)合约

![image][image 22]

挂起合约

等待合约表示还没有完成执行过程的合约。按钮功能描述参考上述附件。

3.5.1.1 Web3 Provider远程节点配置

1） 启动Ganache客户端。不熟悉的，可参考该篇文章的对应关键字“在WINDOWS上安装Ganache”安装好客户端（[https://www.jianshu.com/p/683ea7d62a39][https_www.jianshu.com_p_683ea7d62a39]）。

![image][image 23]

启动Ganache客户端

2） 输入Web3 Provider远程节点，例如Ganache的签宝地址为“[HTTP://127.0.0.1:7545][HTTP_127.0.0.1_7545]”

![image][image 24]

输入WEB3 privider的服务器地址

3） 输入完成后，Remix的账号列表更新为Ganache的账号列表了。

![账号为Ganache的账号列表][Ganache]

3.5.3 调试

调试/回滚和单步调试是一个很重要的功能，点击《第九课 如何在Remix环境下进行Solidity代码单步调试》（[https://www.jianshu.com/p/a2502274b092][https_www.jianshu.com_p_a2502274b092]）文章查看。

3.5.4 设置

![Settiongs][]

重要特性说明：

*  Solidity version：编译SOLIDITY版本，不调整的话系统会默认选择最新正式发布的版本。
 *  Always use Ethereum VM at Load：勾选此项会在重新加载时默认选择JavaScript VM环境。
 *  Enable Optimization：勾选此项会节省运行GAS，JVM等测试环境可不用勾选。

3.5.5 分析

分析面板显示的是最后一次编译的信息，默认情况下每一次编译都会产生一个新的分析。

这个分析面板显示的是合约代码的详细信息，它可以帮助你避免代码错误或者增强编码能力。

![Analysis页面][Analysis]

Security:   
Transaction origin: 如果tx.origin被使用则会告警；   
Check effects: 避免潜在的可重入性BUG；   
Inline assembly:  使用植入汇编方式；   
Block timestamp: Semantics maybe unclear；   
Low level calls: Semantics maybe unclear；   
Block.blockhash usage: 自毁调用；

Gas & Economy:   
Gas costs: 函数的GAS消耗太高会告警。   
This on local calls: 勾选后本地函数会被唤醒；

Miscellaneous:   
Constant functions: 检查潜在的常量函数   
Similar variable names: 检查变量名是否太相似

Miscelllaneous下方显示的是本次编译的优化告警，供程序员优化代码使用。

![Analysis页面2][Analysis_2]

3.5.6 支持

支持页面，可点击需求技术支持和交流。

![remix\_supporttab][remix_supporttab]

# 4 #

# 典型错误介绍 #

4.1 REMIX编译器官网链接打不开

提示内容：点击官网链接（[http://remix.ethereum.org][http_remix.ethereum.org]），如果打不开或者有错误提示“mock compiler: source not found”

原因分析： 这个主要是不能科学上网引起官网浏览器不能下载完全。

解决办法：

1，参考欧阳哥哥的文章《【以太坊开发】Remix IDE本地部署与配置个性风格》完成本地REMIX的部署；   
2，采用一个已国内部署的REMIX浏览器链接：[http://remix2.ju3ban.net][http_remix2.ju3ban.net]

4.2 参数转换失败

提示内容： 终端输出器显示为“transact to Donation.moveFund errored: Error encoding arguments: Error: Assertion failed ”

原因分析：   
Solidity函数定义为”function moveFund(address \_to, uint \_amount)”

RUN面板的函数输入参数如下，希望转移5个ETH给目标账号。

> “0x14723a09acff6d2a60dcdf7aa4aff308fddc160c”,500000000000000

结果提示错误。

这个原因主要是因为”5 ＊10^18”的值超过了计算器的范围，需要增加”“来让程序进行转换。Solidity的默认单位为wei，1 ETH = 1\*10^18 wei。

解决办法：   
输入参数改为2个参数均有双引号则不会有错误提示。

> “0x14723a09acff6d2a60dcdf7aa4aff308fddc160c”,”500000000000000”

在remix中，任何输入参数都可以带”“表示。

# 5 #

# 参考文档 #

REMIX英文官网帮助文档（[http://remix.readthedocs.io/en/latest/][http_remix.readthedocs.io_en_latest]）

【以太坊开发】Remix IDE本地部署与配置个性风格（[https://www.jianshu.com/p/afdee36ccbc0][https_www.jianshu.com_p_afdee36ccbc0]）

SOLIDITY语言官网中文版（[http://solidity-cn.readthedocs.io/zh/develop/solidity-in-depth.html][http_solidity-cn.readthedocs.io_zh_develop_solidity-in-depth.html]）

[http_remix.ethereum.org]: http://remix.ethereum.org/
[http_remix2.ju3ban.net]: http://remix2.ju3ban.net/
[image]: /images/20220520/83a86a5f384a4c8ead4f61d4afb5fa04.png
[image 1]: /images/20220520/bc18d97191f64655ba6557abd7dabac7.png
[image 2]: /images/20220520/9f98e32e0a7f42ec897af4bc3a9535a2.png
[https_www.jianshu.com_p_2a5d60744988]: https://www.jianshu.com/p/2a5d60744988
[image 3]: /images/20220520/de00be6328684eb0a7f23a874d370172.png
[image 4]: /images/20220520/20c16ece57134dc39ca5c18c214be278.png
[image 5]: /images/20220520/3de96de483e64ed1a8255dd80e5997af.png
[image 6]: /images/20220520/1a050ce2e5364acebc1ccc352368851c.png
[https_remix.readthedocs.io_en_latest_tutorial_mist.html]: https://remix.readthedocs.io/en/latest/tutorial_mist.html
[image 7]: /images/20220520/2c43841af6d444bbadb44c4e413d6867.png
[image 8]: /images/20220520/c4b38cb0df2f46358b9209e1c34f8a5b.png
[image 9]: /images/20220520/1d42749f74f54616bd648d8756efe3b6.png
[image 10]: /images/20220520/6f386df516464e678f8ddc1db792e0cb.png
[image 11]: /images/20220520/1b0c7e064e9a4100a14c62a52e6cd913.png
[http_remix.ju3ban.net]: http://remix.ju3ban.net/
[image 12]: /images/20220520/25b40ed41acb43538b2695900eb78a62.png
[image 13]: /images/20220520/ce281440a2664b0aa7f44045ede0de3a.png
[image 14]: /images/20220520/791ce6629e5c48c7a479c89cb6b5836f.png
[image 15]: /images/20220520/9ea8a9e81a8e4c389a102e1edadc54f7.png
[image 16]: /images/20220520/fd36365c589147828ac870d2387d9b11.png
[image 17]: /images/20220520/54128efc6d5e4290b03dc80f86b24d2c.png
[image 18]: /images/20220520/757092127559459b80f09433817f3886.png
[image 19]: /images/20220520/769f364cf03f4fbe9c714eadd4f02cbc.png
[image 20]: /images/20220520/98908ca560b44b989304d4bf1e89cdcd.png
[https_www.jianshu.com_p_c7c87c7ad74f]: https://www.jianshu.com/p/c7c87c7ad74f
[image 21]: /images/20220520/e395b4de41f249ccad8f45eb7a82459e.png
[image 22]: /images/20220520/e194f6fe2ba84e54a74667ea361b869a.png
[https_www.jianshu.com_p_683ea7d62a39]: https://www.jianshu.com/p/683ea7d62a39
[image 23]: /images/20220520/1442155b5ffd47ca80ded20bb114f243.png
[HTTP_127.0.0.1_7545]: http://127.0.0.1:7545/
[image 24]: /images/20220520/e6f40d814ac147f5a9efe8985555cd46.png
[Ganache]: /images/20220520/d3dfb3070e254ab098e99141c3605f71.png
[https_www.jianshu.com_p_a2502274b092]: https://www.jianshu.com/p/a2502274b092
[Settiongs]: /images/20220520/971537f516b24102b6789527a8a1518e.png
[Analysis]: /images/20220520/fe936776bee84bc294868d636d2c535c.png
[Analysis_2]: /images/20220520/240b007e07c24ea4ae9e41eed66925c7.png
[remix_supporttab]: /images/20220520/c0e449dbe8c14207b1c7c1f73673c733.png
[http_remix.readthedocs.io_en_latest]: http://remix.readthedocs.io/en/latest/
[https_www.jianshu.com_p_afdee36ccbc0]: https://www.jianshu.com/p/afdee36ccbc0
[http_solidity-cn.readthedocs.io_zh_develop_solidity-in-depth.html]: http://solidity-cn.readthedocs.io/zh/develop/solidity-in-depth.html