Solidity智能合约开发技术与实战-事件与日志

以太坊Solidity智能合约开发教程事件与日志学前提示事件是以太坊网络的基本功能，借助事件可以将数据记录为日志，保存在区块链上。事件还是与智能合约的外部进行交互的渠道，例如与前端的交互。知识要点7.1事件7.2日志7.1事件7.1.1事件模型.7.1.2定义和触发事件7.1.1事件模型7.1.2定义和触发事件Solidity语言的事件编程包括定义事件、触发事件和监听事件。其中定义和触发事件的功能在智能合约中实现；监听事件可以通过Web3.js实现。1．定义事件在Solidity语言中，可以使用event关键字来定义一个事件，方法如下：event<事件名>(<事件的参数>);例如eventPersonInfoUpdate(stringname,uintage);

2．触发事件可以使用emit关键字触发事件，具体方法如下：emit<事件名>(<事件的实参>);可以在任意函数中触发事件，例如：·functionsetInfo(string_fName,uint_age)public{fName=_fName;age=_age;emitPersonInfoUpdate(_fName,_age);}7.1.3在Web3.js中监听事件1．以WebSocket方式连接到以太坊节点2．订阅合约事件1．以WebSocket方式连接到以太坊节点以WebSocket模式启动以太坊私有链的选项--ws启用WS-RPC服务器--wsaddrvalue指定WS-RPC服务器监听的地址--wsportvalue指定WS-RPC服务器监听的端口--wsoriginsvalue指定websockets请求允许的源。通常使用--wsorigins'*'表示允许所有的连接通过如下命令启动以太坊私有链，并启用WS-RPC服务./geth--datadirethchain--nodiscoverconsole2>>1.log--dev.period1--password'./password.txt'--rpcport8545--rpccorsdomain"*"--rpcaddr=01-rpc--rpcapi="db,eth,net,web3,personal"--ws--wsaddr01--wsport7777--wsorigins在Web3.js中，可以通过如下的代码连接到WS-RPC服务web3=newWeb3(newWviders.WebsocketProvider("ws://01:7777"));【例7-1】contractPerson{stringpublicname;uintpublicage;functionSetInfo(stringmemory_name,uint_age)public{name=_name;age=_age;emitPersonInfoUpdate(_name,_age);}eventPersonInfoUpdate(stringname,uintage);}署合约Personcurl-H‘Content-Type:application/json’--data‘{“jsonrpc”:“2.0”,“method”:“eth_sendTransaction”,“params”:[{“from”:“0xd169d4387c2dcd1ec4e6952bddf0a22c1f8c2b2f”,“data”:“0x60806040523……."}],"id":20}'01:8545执行结果如下{"jsonrpc":"2.0","id":20,"result":"0x4b1501ec48388f48f9cf987f52c6fd7d3fffddcdf9cdfb96679adcea98613449"}获取本次交易的合约地址curl-H'Content-Type:application/json'--data'{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["0x4b1501ec48388f48f9cf987f52c6fd7d3fffddcdf9cdfb96679adcea98613449"],"id":21}'01:8545返回结果如下{"jsonrpc":"2.0","id":21,"result":{"blockHash":"0xdc30bd518cf80fb5d73391e1409ce004c979c10f09bf4f3211cec86737dd3e0f","blockNumber":"0x1d088","contractAddress":"0xed2d42ad9aa54e77fb5c35b7834aedc1171aef57","cumulativeGasUsed":"0x3a33a","from":"0xd169d4387c2dcd1ec4e6952bddf0a22c1f8c2b2f","gasUsed":"0x3a33a","logs":[],"logsBloom":"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","status":"0x1","to":null,"transactionHash":"0x4b1501ec48388f48f9cf987f52c6fd7d3fffddcdf9cdfb96679adcea98613449","transactionIndex":"0x0"}}2．订阅合约事件可以通过如下方法订阅合约事件：<智能合约对象>.events.<事件名>([options][,回调函数])options是可选参数，用于配置率先事件的选项。例如订阅事件MyEvent的代码myContract.events.PersonInfoUpdate(function(error,event){ if(!error){ console.log(event.returnV); console.log(event.returnValues.age);//$("#instructor").html(+'('+event.args.age+'yearsold)');}else{console.log(error);} })event对象包含如下属性

Event：事件名；

Signature：事件签名；

Address：事件源地址。

returnValues：事件的返回数据。例如，可以使用如下代码获取事件对象的参数值：

event.returnValues.<参数名>

logIndex：事件在块中的索引位置。

transactionIndex：事件在交易中的索引位置。

transactionHash：事件所在交易的哈希值。

blockHash：事件所在块的哈希值。

blockNumber：事件所在块的区块号。

raw.data：该字段包含未索引的日志参数。

raw.topics：事件的主题。<智能合约对象>.events.<事件名>()的返回值是一个事件发生器EventEmitter事件发生器可以触发如下的事件。

"data"：接收到新的事件时触发。

"changed"：当事件从区块链上移除时触发。

"error"：当发生错误时触发。可以通过如下方式响应这些事件<智能合约对象>.events.<事件名>([options][,回调函数]).on('data',function(event){console.log(event);}).on('changed',function(event){//将事件从本地数据库删除}).on('error',console.error);【例7-2】$(function(){if(typeofweb3!=='undefined'){web3=newWeb3(web3.currentProvider);}else{//settheprovideryouwantfromWvidersweb3=newWeb3(newWviders.WebsocketProvider("ws://01:7777"));}varmyContract=newweb3.eth.Contract([ { "constant":true, "inputs":[], "name":"name", "outputs":[ { "name":"", "type":"string" } ], "payable":false, "stateMutability":"view", "type":"function" },

{ "constant":true, "inputs":[], "name":"age", "outputs":[ { "name":"", "type":"uint256" } ], "payable":false, "stateMutability":"view", "type":"function" },

{ "constant":false, "inputs":[ { "name":"_name", "type":"string" }, { "name":"_age", "type":"uint256" } ],

"name":"SetInfo", "outputs":[], "payable":false, "stateMutability":"nonpayable", "type":"function" }, { "anonymous":false, "inputs":[

{ "indexed":false, "name":"name", "type":"string" }, { "indexed":false, "name":"age", "type":"uint256" } ], "name":"PersonInfoUpdate", "type":"event" }],"0xed2d42ad9aa54e77fb5c35b7834aedc1171aef57");使用合约对象web3订阅合约事件PersonInfoUpdate的代码如下//订阅事件

vareventUpdate=myContract.events.PersonInfoUpdate(function(error,event){ if(!error){ console.log(event.returnV); console.log(event.returnValues.age);}else{console.log(error);} }) .on('data',function(event){console.log(event);}).on('changed',function(event){

}).on('error',console.error);在sample7-2.html中定义以下HTML元素，用于输入智能合约Person的name和age变量值。<span>

姓名：<inputtype="text"id="name"></input><br/>

年龄：<inputtype="text"id="age"></input><br/><buttonid="btnSetInfo">修改</button></span>

单击“修改”按钮，将调用智能合约Person的SetInfo()函数，设置name和age变量值，并触发PersonInfoUpdate事件$("#btnSetInfo").click(function(){ alert($("#name").val()+$("#age").val()); myContract.methods.SetInfo($("#name").val(),$("#age").val()).send({from:"0xd169d4387c2dcd1ec4e6952bddf0a22c1f8c2b2f",gas:150000,gasPrice:"10000"})});浏览sample7-2.html的网页在Console面板中查看事件PersonInfoUpdate的参数数据

如果在Console面板中看到如下报错信息，则说明指定的from账户被锁定了web3.min.js:13Uncaught(inpromise)Error:Returnederror:authenticationneeded:passwordorunlock}可以通过如下方法解决此问题（1）在启动以太坊私有链时使用--allow-insecure-unlock选项，具体命令如下：

./geth--datadirethchain--nodiscoverconsole2>>1.log--dev.period1--password'./password.txt'--rpcport8545--rpccorsdomain"*"--rpcaddr=01-rpc--rpcapi="db,eth,net,web3,personal"--ws--wsaddr01--wsport7777--wsorigins'*'--allow-insecure-unlock（2）执行miner.stop()命令停止挖矿。并执行eth.mining命令检查挖矿的状态。如果返回false，则说明挖矿已经停止。（3）执行下面的命令解锁第一个账户：personal.unlockAccount(eth.accounts[0])输入账户密码后，账户被解锁解锁以太坊账户7.2日志7.2.1在Remix中查看日志数据7.2.2底层日志接口7.2.3检索日志7.2.1在Remix中查看日志数据【例7-3】创建一个智能合约MetaCoin，其中定义一个Transfer事件，代码如下：eventTransfer(address_from,address_to,uint256_value);在智能合约MetaCoin中定义了一个映射balances，用于保存各账户地址中的金额mapping(address=>uint256)balances;

智能合约MetaCoin的构造函数的代码如下：

constructor()payablepublic{balances[msg.sender]=100;}定义一个SendCoin()函数，程序模拟账户间的转账functionSendCoin(address_reciver,uint256_amount)publicreturns(boolsufficient){if(balances[msg.sender]<_amount)returnfalse;balances[msg.sender]-=_amount;balances[_reciver]+=_amount;//触发事件

emitTransfer(msg.sender,_reciver,_amount);returntrue;}在Remix中查看已部署的合约输入SendCoin()函数的参数查看交易的明细信息。

7.2.2底层日志接口除了在触发事件时会记录日志，Solidity还提供了一些底层日志接口。通过调用log0、log1、log2、log3、log4、……函数可以直接访问底层的日志组件。【例7-4】例7-3的日志，可以通过底层日志接口log3()函数记录pragmasolidity^0.5.1;

contractMetaCoin{eventTransfer(addressindexed_from,addressindexed_to,uint256_value);functionrecordLog()publicpayable{addressaddr=0x14723A09ACff6D2A60DcdF7aA4AFf308FDDC160C;log3(bytes32(msg.value),bytes32(keccak256('Transfer(address,address,uint256)')),bytes32(bytes20(addr)),bytes32(bytes20(msg.sender)));}}log3()函数包含如下4个实参（1）msg.value：交易金额作为日志的数据部分；（2）keccak256('Transfer(address,address,uint256)')：事件Transfer的AB