Shenzhen Shilian Information Technology Co., Ltd.
深圳市识链信息科技有限公司
智能合约开发入门第一步：准确认识并理解合约代码的含义
智能合约开发第一步，在于要认识与理解合约代码的含义。接下来让我们先看一下最根本的例子。如今就算你都不睬解也没关系，后面我们会有更深切的讲解。
1、存储合约示例
把一个数据保留到链上
// SPDX-License-Identifier: GPL-3.0
pragma solidity=0.4.160.9.0;
contractSimpleStorage{
uintstoredData;
functionset(uintx)public{
storedData=x;
functionget()public view returns(uint){
returnstoredData;
第一行是阐明源代码是根据GPL 3.0版本受权的。默认情状下，在发布源代码时参加机器可读答应证阐明是很重要的，
下一行是告诉编译器源代码所适用的Solidity版本为=0.4.16 及 pragma是告知编译器若何处置源代码的通用指令（例如，pragma once）。
Solidity中智能合约的含义就是一组代码（它的功用)和数据（它的形态）的聚集，而且它们是位于以太坊区块链的一个特定地址上的。uintstoredData;那一行代码声了然一个名为``storedData``的形态变量，其类型为uint(256位无符号整数）。 你也能够认为它是数据库里的一个插槽，而且能够通过挪用办理数据库代码的函数停止查询和更改。在那个例子中，上述的合约定义了``set``和``get`` 函数，能够用来修改或检索变量的值。
要拜候当前合约的成员（如：形态变量），凡是不需要像添加this.如许的前缀，你只需要通过名字就能够间接拜候它。 与其他一些语言差别的是，省略它不单单是一个气概问题，因为它是一种完全差别的拜候成员的体例，那一块后面会详细介绍。
展开全文
该合约能完成的工作其实不多（因为以太坊构建的根底架构的原因）：它能允许任何人在合约中存储一个零丁的数字，而且那个数字能够被世界上任何人拜候，且没有可行的办法阻遏你发布那个数字。当然，任何人都能够再次挪用set，传入差别的值，笼盖你的数字，但是那个数字仍会被存储在区块链的汗青笔录中。随后，我们会看到如何施加拜候限造，以确保只要你才气改动那个数字。
2、货币合约（Subcurrency）示例
下面的合约实现了一个最简单的加密货币。那里，币确实能够无中生有地产生，但是只要创建合约的人才气做到（实现一个差别的发行方案也不难）。并且，任何人都能够给其别人转币，不需要注册用户名和密码 —— 所需要的只是以太坊密钥对。
// SPDX-License-Identifier: GPL-3.0
pragma solidity^0.8.4;
contractCoin{
// 关键字“public”让那些变量能够从外部读取
addresspublic minter;
mapping(address=uint)publicbalances;
// 轻客户端能够通过事务针对改变做出高效的反响
eventSent(addressfrom,addressto,uintamount);
// 那是构造函数，只要当合约创建时运行
constructor(){
minter =msg.sender;
functionmint(addressreceiver,uintamount)public{
require(msg.sender== minter);
balances[receiver]+=amount;
// Errors allow you to provide information about
// why an operation failed. They are returned
// to the caller of the function.
error InsufficientBalance(uintrequested,uintavailable);
functionsend(addressreceiver,uintamount)public{
if(amount balances[msg.sender])
revert InsufficientBalance({
requested: amount,
available: balances[msg.sender]
balances[msg.sender]-= amount;
balances[receiver]+=amount;
emit Sent(msg.sender, receiver, amount);
那个合约引入了一些新的概念，让我们一一解读。
addresspublicminter;那一行声了然一个能够被公开拜候的address类型的形态变量。address类型是一个160位的值，且不允许任何算数操做。那品种型合适存储合约地址或外部人员的密钥对。关键字public主动生成一个函数，允许你在那个合约之外拜候那个形态变量的当前值。若是没有那个关键字，其他的合约没有办法拜候那个变量。由编译器生成的函数的代码大致如下所示（暂时忽略 external 和 view）：
functionminter()external view returns(address){return minter;}
当然，加一个和上面完全一样的函数是行欠亨的，因为我们会有同名的一个函数和一个变量，那里，次要是希望你能大白——编译器已经帮你实现了。
下一行，mapping(address=uint)publicbalances;也创建一个公共形态变量，但它是一个更复杂的数据类型。 该类型将address映射为无符号整数。 Mappings 能够看做是一个哈希表它会施行虚拟初始化，以使所有可能存在的键都映射到一个字节表达为全零的值。 但是，那品种比其实不太安妥，因为它既不克不及获得映射的所有键的列表，也不克不及获得所有值的列表。 因而，要么记住你添加到mapping中的数据（利用列表或更高级的数据类型会更好），要么在不需要键列表或值列表的上下文中利用它，就如本例。 而由public关键字创建的getter函数getter function则是更复杂一些的情状， 它大致如下所示：
functionbalances(addressaccount)external view returns(uint){
return balances[account];
正如你所看到的，你能够通过该函数轻松地查询到账户的余额。
eventSent(addressfrom,addressto,uintamount);那行声了然一个所谓的“事务（event）”，它会在send函数的最初一行被发出。用户界面（当然也包罗办事器应用法式）能够监听区块链上正在发送的事务，而不会破费太多成本。一旦它被发出，监听该事务的listener都将收到通知。而所有的事务都包罗了from，to和amount三个参数，可便利逃踪交易。 为了监听那个事务，你能够利用如下JavaScript代码（假设 Coin 是已经通过web3.js 创建好的合约对象）：
Coin.Sent().watch({},'',function(error,result){
if(!error){
console.log("Coin transfer: "+result.args.amount+
" coins were sent from "+result.args.from+
" to "+result.args.to+".");
console.log("Balances now:\n"+
"Sender: "+Coin.balances.call(result.args.from)+
"Receiver: "+Coin.balances.call(result.args.to));
那里请留意主动生成的balances函数是若何从用户界面挪用的。
特殊函数constructor是仅在创建合约期间运行的构造函数，不克不及在创建之后挪用。 在 Coin 合约中，构造函数永久存储创建合约的人的地址:msg(类似的还有tx和block) 是一个特殊的全局变量， 参考特殊变量和函数，那些变量允许我们拜候区块链的属性。msg.sender始末笔录当前（外部）函数挪用是来自于哪一个地址。
最初，实正被用户或其他合约所挪用的，以完成本合约功用的办法是mint和send。
mint函数用来新发行必然数量的币到一个地址。require用来查抄某些前提，若是不称心那些前提就会回推所有的形态改变。 在那个例子中,require(msg.sender==minter);确保只要合约的创建者能够挪用mint。 一般来说，创建者能够为所欲为地铸造代币，但在某些时候，那将招致一种叫做 “溢出” 的现象。
请留意，因为默认的算术查抄形式，若是表达式balances[receiver]+=amount;溢出交易将被复原。 即当肆意精度算术中的balances[receiver]+amount大于uint(2**256-1)。同样在在函数send中的balances[receiver]+=amount;那对语句来说也是如斯。
Errors用来向挪用者描述错误信息。Error与revert 语句一路利用。revert语句无前提地中行施行并回退所有的改变，类似于require函数，它也同样允许你供给一个错误的名称和额外的数据，那些额外数据将提赐与挪用者(并最末提赐与前端应用法式或区块资本办理器），如许就能够更容易地调试或应对失败。
任何人（已经拥有一些代币）都能够利用send函数来向其别人发送代币。若是发送者没有足够的代币能够发送，if前提为实revert将触发失败，并通过InsufficientBalance向发送者供给错误细节。
若是mint被合约创建者外的其别人挪用则什么也不会发作。 另一方面，send函数可被任何人用于向别人发送币 (当然，前提是发送者拥有那些币)。记住，若是你利用合约发送币给一个地址，当你在区块链阅读器上查看该地址时是看不到任何相关信息的。因为，现实上你发送币和更改余额的信息仅仅存储在特定合约的数据存储器中。通过利用事务，你能够十分简单地为你的新币创建一个“区块链阅读器”来逃踪交易和余额。
国内领先的Web3.0倡导者