C#如何进行以太坊调用、交易、事件、过滤器和主题

本指南将深入探讨调用合约,交易,事件,过滤器和主题。

测试合约

以下智能合约是上一指南中multiply合约的更新版本:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
contract test {

int _multiplier;
event Multiplied(int indexed a, address indexed sender, int result );

function test(int multiplier) {
_multiplier = multiplier;
}

function multiply(int a) returns (int r) {
r = a * _multiplier;
Multiplied(a, msg.sender, r);
return r;
}
}

智能合约现在是一个Multiplied事件。该事件将在日志中存储原始参数包括asender的地址和结果result。参数asender的地址都被编入索引,因此我们可以使用主题topic为这两个创建特定的过滤器filter

部署合约

我们可以按如下方式部署合约:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
var senderAddress = "0x12890d2cce102216644c59daE5baed380d84830c";
var password = "password";

var abi = @"[{'constant':false,'inputs':[{'name':'a','type':'int256'}],'name':'multiply','outputs':[{'name':'r','type':'int256'}],'type':'function'},{'inputs':[{'name':'multiplier','type':'int256'}],'type':'constructor'},{'anonymous':false,'inputs':[{'indexed':true,'name':'a','type':'int256'},{'indexed':true,'name':'sender','type':'address'},{'indexed':false,'name':'result','type':'int256'}],'name':'Multiplied','type':'event'}]";

var byteCode = "0x6060604052604051602080610104833981016040528080519060200190919050505b806000600050819055505b5060ca8061003a6000396000f360606040526000357c0100000000000000000000000000000000000000000000000000000000900480631df4f144146037576035565b005b604b60048080359060200190919050506061565b6040518082815260200191505060405180910390f35b60006000600050548202905080503373ffffffffffffffffffffffffffffffffffffffff16827f841774c8b4d8511a3974d7040b5bc3c603d304c926ad25d168dacd04e25c4bed836040518082815260200191505060405180910390a380905060c5565b91905056";

var multiplier = 7;

var web3 = new Web3.Web3();

var unlockResult = await web3.Personal.UnlockAccount.SendRequestAsync(senderAddress, password, new HexBigInteger(120));
Assert.True(unlockResult);

var transactionHash = await web3.Eth.DeployContract.SendRequestAsync(abi, byteCode, senderAddress, new HexBigInteger(900000), multiplier);
var receipt = await MineAndGetReceiptAsync(web3, transactionHash);

multiply乘法交易

这是在智能合约状态下执行的,或者我们正在执行操作(如乘法),调用不是通过区块链一致性验证的交易。

提交交易以在智能合约中执行功能操作不会返回结果,我们可以通过使用函数调用来检查智能合约的条件。

1
2
3
4
5
6
7
8
9
10
var contractAddress = receipt.ContractAddress;  

var contract = web3.Eth.GetContract(abi, contractAddress);

var multiplyFunction = contract.GetFunction("multiply");

transactionHash = await multiplyFunction.SendTransactionAsync(senderAddress, 7);
transactionHash = await multiplyFunction.SendTransactionAsync(senderAddress, 8);

receipt = await MineAndGetReceiptAsync(web3, transactionHash);

使用部署交易的合同地址,我们可以创建合约对象的实例和函数“multiply”。

函数对象以与调用相同的方式简化提交交易。根据上面的例子,我们只需要包含“senderAddress”,其将与操作相关的gas及函数的参数操作一起缴费。

还可以选择指定gas或以太币值作为交易的一部分。

在示例中,我们提交了2个交易来执行7和8的乘法,并在我们的私有测试链上等待交易被挖掘。

事件,过滤器和主题

创建事件和过滤器

事件被定义为abi的一部分,类似于我们可以使用合约实例获取事件的函数。

1
var multiplyEvent = contract.GetEvent("Multiplied");

事件对象允许创建create以查询存储在日志中的信息。

我们可以创建查询所有事件日志的过滤器。

1
var filterAll = await multiplyEvent.CreateFilterAsync();

或者指定一个主题。

1
var filter7 = await multiplyEvent.CreateFilterAsync(7);

在上面的例子中,我们查询了参数为7的日志,因为这个输入参数被标记为索引,我们可以过滤该主题。

我们使用发件人地址作为过滤器,因为它也被标记为索引,但如果我们想要过滤该特定主题,我们将在创建过滤器时第二个参数。

1
var filterSender = await multiplyEvent.CreateFilterAsync(null, senderAddress);

DTO事件

事件数据传输对象将所有事件参数解码为传输对象,其方式与我们将Json对象反序列化的方式类似。

1
2
3
4
5
6
7
8
9
10
11
12
public class MultipliedEvent
{
[Parameter("int", "a", 1, true)]
public int MultiplicationInput {get; set;}

[Parameter("address", "sender", 2, true)]
public string Sender {get; set;}

[Parameter("int", "result", 3, false)]
public int Result {get; set;}

}

在上面的示例中,MultipliedEvent属性已使用自定义参数属性mapped到事件参数。

每个参数都指定原始类型,名称,顺序以及它是否被索引。我们可以看到地址的类型被解码为字符串,在我们的场景中,我们可以安全地将int256解码为int32,但如果不知道最终类型BigInteger将是一个更好的选择。

查询事件和日志

使用我们已经创建的过滤器,我们可以查询日志和事件。

1
2
var log = await multiplyEvent.GetFilterChanges<MultipliedEvent>(filterAll);
var log7 = await multiplyEvent.GetFilterChanges<MultipliedEvent>(filter7);

上面我们使用GetFilterChanges,这可用于查询过滤符合我们条件的,已创建或自上次我们尝试获取更改以来的任何日志。

参数将用于使用GetAllChangesFilterInput

最后

所有的源代码都可以Tutorials solution找到。

======================================================================

如果你想马上使用c#开发以太坊dapp,可以学习下面的教程:

C#以太坊,主要讲解如何使用C#开发基于.Net的以太坊应用,包括账户管理、状态与交易、智能合约开发与交互、过滤器和事件等。

其他区块链教程:

  • php以太坊,主要是介绍使用php进行智能合约开发交互,进行账号创建、交易、转账、代币开发以及过滤器和事件等内容。
  • web3j教程,主要是针对java和android程序员进行区块链以太坊开发的web3j详解。
  • 以太坊教程,主要介绍智能合约与dapp应用开发,适合入门。
  • 以太坊开发,主要是介绍使用node.js、mongodb、区块链、ipfs实现去中心化电商DApp实战,适合进阶。
  • python以太坊,主要是针对python工程师使用web3.py进行区块链以太坊开发的详解。
  • EOS智能合约与DApp开发入门教程,内容涵盖EOS工具链、账户与钱包、发行代币、智能合约开发与部署、使用代码与智能合约交互等核心知识点,最后运用react和各知识点完成一个便签DApp的开发。

汇智网原创翻译,转载请标明出处。这里是原文