https://blog.csdn.net/mongo_node/article/details/83057326
本文描述了在dotNet核心中使用像以太坊這樣的區塊鏈平臺的過程。目標受衆是其他想要從以太坊開始的dotNet開發者。需要了解區塊鏈。在本文中,我們構建了一個完整的示例,允許你與自定義編寫的智能合約進行交互。
第一代區塊鏈的可以被視爲僅比特幣而沒有智能合約。儘管如此,第二代區塊鏈的表現明顯給人更有希望。隨着比特幣以外的更多區塊鏈平臺,變得更加成熟,區塊鏈有了更多可能性。以太坊區塊鏈更像是一個使用加密貨幣的智能合約的分佈式分類賬。以太坊的重點更多地放在智能合約部分,然後是加密貨幣。以太幣(以太坊的加密貨幣)的目的是爲執行採礦合約或執行合約的交易提供報酬。
智能合約是爲以太坊虛擬機編寫的一段代碼。這可以用Solidity編寫並編譯爲字節代碼。此字節代碼放在分類帳中並變爲不可變但仍可以與之交互,並且可以更改狀態。正如以太坊文檔所說:“從實用的角度來看,EVM可以被認爲是一個包含數百萬個對象的大型分散計算機,稱爲”帳戶“,它們能夠維護內部數據庫,執行代碼並相互通信。“從開發人員的角度來看,你可以將Solidity視爲類似Javascript的語言,這有點受限。由於Solidity代碼在區塊鏈中運行,因此有充分的理由限制它。像隨機數這樣簡單的東西也是一個挑戰。也無法通過Http調用獲取數據,因爲所有事實需要在系統中。你仍然可以調用合約並輸入數據來改變狀態,因此外部影響是可行的。
首先安裝Mist瀏覽器和Geth。Mist瀏覽器是一個GUI,可用作Ether的錢包。Geth是代碼連接到的程序接口,Geth連接到以太坊的區塊鏈。對於本文,我們將使用testnet。這樣我們就可以免費開採一些以太幣。啓動Mist後,從菜單中選擇使用測試網。創建一個帳戶並挖掘一些以太幣(菜單項目開發並開始挖掘)。
過了一段時間,你會有一些以太幣。這在交易時很方便。即使發佈合約或執行合約也要花費成本。現在讓我們關閉錢包,否則你無法打開一個新的geth過程。所以在控制檯中啓動已安裝的Geth:
“\Program Files\Geth\geth” --testnet --rpcapi eth,web3,personal --rpc
上圖是我們命令的結果。我們看到它正在接收當前的區塊鏈緩存,並且它的http端點正在localhost:8545上進行偵聽。這很重要,因爲我們需要Mist瀏覽器和其他應用程序使用IPC或RPC訪問它。由於在Windows上只支持IPC實現,我們不能在dotNetCore中使用它。我們在解決方案中使用web3 RPC。
現在你可以再次打開錢包。只是不能開始挖掘,因爲有獨立的Geth正在運行。
現在是時候開始開發,打開Visual Studio並創建一個新項目了。請注意,我們的Github提供了該代碼。創建“ASP.NET核心Web應用程序”,然後選擇“Web.API模板”。我們將創建一個服務,其中包含一些與區塊鏈交互的方法,並向區塊鏈發佈合約。這個存錢合約將存儲我們的代幣餘額。合約開採後我們可以調用合約方法。沒什麼高大上的,也不是一個完整的應用程序,但很高興看到我們能做什麼。我們選擇使用Azure Table存儲來保持系統的持久性,它快速且便宜。
首先將這些依賴項添加到Project.json中:
"Nethereum.Web3": "2.0.0-rc1",
"Portable.BouncyCastle": "1.8.1.1",
"WindowsAzure.Storage": "8.1.1"
保存並查看正在恢復的軟件包。前兩個是以太坊相關,最後一個用於表存儲。Nethereum.Web3是通過RPC json訪問本地Geth進程的完整類庫。BouncyCastle是Nethereum所需的加密庫。
首先,我們需要一個模型來捕獲我們的以太坊合約狀態。以太坊沒有任何選擇讓合約退出區塊鏈,主要是出於安全/不可變的原因。一旦合約被放入區塊鏈,就無法更改,也無法檢索到Solidity代碼。這就是我們需要將這些信息存儲在我們的系統中的原因。在模型文件夾中創建一個名爲EthereumContractInfo的文件,該文件派生自Azure Storage類TableEntity:
using Microsoft.WindowsAzure.Storage.Table;
namespace EthereumStart.Models
{
public class EthereumContractInfo : TableEntity
{
public string Abi { get; set; }
public string Bytecode { get; set; }
public string TransactionHash { get; set; }
public string ContractAddress { get; set; }
public EthereumContractInfo()
{
}
public EthereumContractInfo(string name, string abi, string bytecode, string transactionHash)
{
PartitionKey = "contract";
RowKey = name;
Abi = abi;
Bytecode = bytecode;
TransactionHash = transactionHash;
}
}
}
現在創建一個名爲Services的文件夾並創建文件IEthereumService接口,這樣我們就可以將它用於依賴注入:
using System.Threading.Tasks;
using EthereumStart.Models;
using Nethereum.Contracts;
namespace EthereumStart.Services
{
public interface IEthereumService
{
string AccountAddress { get; set; }
Task<bool> SaveContractToTableStorage(EthereumContractInfo contract);
Task<EthereumContractInfo> GetContractFromTableStorage(string name);
Task<decimal> GetBalance(string address);
Task<bool> ReleaseContract(string name, string abi, string byteCode, int gas);
Task<string> TryGetContractAddress(string name);
Task<Contract> GetContract(string name);
}
}
所有方法都應該返回一個任務,因爲我們希望使實現使用異步。我們的想法是,我們將發佈合約,嘗試獲取它的地址,然後在該地址上調用它的方法。現在我們創建文件BasicEthereumService來實現接口。
using Microsoft.Extensions.Options;
using Microsoft.WindowsAzure.Storage;
using Microsoft.WindowsAzure.Storage.Auth;
using Microsoft.WindowsAzure.Storage.Table;
using Nethereum.Web3;
using System;
using System.Threading.Tasks;
using EthereumStart.Models;
using Nethereum.Contracts;
namespace EthereumStart.Services
{
public class BasicEthereumService : IEthereumService
{
private Nethereum.Web3.Web3 _web3;
private string _accountAddress;
private string _password;
private string _storageKey;
private string _storageAccount;
public string AccountAddress
{
get
{
return _accountAddress;
}
set
{
_accountAddress = value;
}
}
public BasicEthereumService(IOptions<EthereumSettings> config)
{
_web3 = new Web3("http://localhost:8545");
_accountAddress = config.Value.EhtereumAccount;
_password = config.Value.EhtereumPassword;
_storageAccount = config.Value.StorageAccount;
_storageKey = config.Value.StorageKey;
}
public async Task<bool> SaveContractToTableStorage(EthereumContractInfo contract)
{
StorageCredentials credentials = new StorageCredentials(_storageAccount, _storageKey);
CloudStorageAccount account = new CloudStorageAccount(credentials, true);
var client = account.CreateCloudTableClient();
var tableRef = client.GetTableReference("ethtransactions");
await tableRef.CreateIfNotExistsAsync();
TableOperation ops = TableOperation.InsertOrMerge(contract);
await tableRef.ExecuteAsync(ops);
return true;
}
public async Task<EthereumContractInfo> GetContractFromTableStorage(string name)
{
StorageCredentials credentials = new StorageCredentials(_storageAccount, _storageKey);
CloudStorageAccount account = new CloudStorageAccount(credentials, true);
var client = account.CreateCloudTableClient();
var tableRef = client.GetTableReference("ethtransactions");
await tableRef.CreateIfNotExistsAsync();
TableOperation ops = TableOperation.Retrieve<EthereumContractInfo>("contract", name);
var tableResult = await tableRef.ExecuteAsync(ops);
if (tableResult.HttpStatusCode == 200)
return (EthereumContractInfo)tableResult.Result;
else
return null;
}
public async Task<decimal> GetBalance(string address)
{
var balance = await _web3.Eth.GetBalance.SendRequestAsync(address);
return _web3.Convert.FromWei(balance.Value, 18);
}
public async Task<bool> ReleaseContract(string name, string abi, string byteCode, int gas)
{
// check contractName
var existing = await this.GetContractFromTableStorage(name);
if (existing != null) throw new Exception($"Contract {name} is present in storage");
try
{
var resultUnlocking = await _web3.Personal.UnlockAccount.SendRequestAsync(_accountAddress, _password, 60);
if (resultUnlocking)
{
var transactionHash = await _web3.Eth.DeployContract.SendRequestAsync(abi, byteCode, _accountAddress, new Nethereum.Hex.HexTypes.HexBigInteger(gas), 2);
EthereumContractInfo eci = new EthereumContractInfo(name, abi, byteCode, transactionHash);
return await SaveContractToTableStorage(eci);
}
}
catch (Exception exc)
{
return false;
}
return false;
}
public async Task<string> TryGetContractAddress(string name)
{
// check contractName
var existing = await this.GetContractFromTableStorage(name);
if (existing == null) throw new Exception($"Contract {name} does not exist in storage");
if (!String.IsNullOrEmpty(existing.ContractAddress))
return existing.ContractAddress;
else
{
var resultUnlocking = await _web3.Personal.UnlockAccount.SendRequestAsync(_accountAddress, _password, 60);
if (resultUnlocking)
{
var receipt = await _web3.Eth.Transactions.GetTransactionReceipt.SendRequestAsync(existing.TransactionHash);
if (receipt != null)
{
existing.ContractAddress = receipt.ContractAddress;
await SaveContractToTableStorage(existing);
return existing.ContractAddress;
}
}
}
return null;
}
public async Task<Contract> GetContract(string name)
{
var existing = await this.GetContractFromTableStorage(name);
if (existing == null) throw new Exception($"Contract {name} does not exist in storage");
if (existing.ContractAddress == null) throw new Exception($"Contract address for {name} is empty. Please call TryGetContractAddress until it returns the address");
var resultUnlocking = await _web3.Personal.UnlockAccount.SendRequestAsync(_accountAddress, _password, 60);
if (resultUnlocking)
{
return _web3.Eth.GetContract(existing.Abi, existing.ContractAddress);
}
return null;
}
}
}
這是很多代碼。我將跳過Save和Load -ContractFromTableStorage,因爲這些只是簡單的Azure表交互。
在構造函數中,我們看到與Geth進程的連接,我們連接到端口8545,因此它可以進行RPC json通信。
第一個方法實現的是getBalance。由於一切都圍繞金錢,所以檢查地址的以太幣的餘額是很重要的,比如你的賬戶,錢包甚至合約。在此示例中,所有以太坊交互都通過對象web3完成。在我們在Wei中取得餘額之後,這就像是人民幣的分數,然後是1018因子而不是102。我們可以使用convert.FromWEi將其轉換回以太幣。
第二個方法實現的是ReleaseContract。它首先檢查我們是否尚未發佈合約並將其保留在存儲中。如果沒有,我們可以開始解鎖帳戶120秒。當我們想要部署合約或其他東西時,需要解鎖。之後,我們可以調用deploy方法並獲取交易哈希。這是必要的,因爲現在合約將被開採。將挖掘視爲區塊鏈的同行所做的過程,以便合約被接受到區塊鏈中。當12個同行已經這樣做時,合約地址被退回。這個挖掘過程需要花錢(又名Gas),並且會從你輸入的_accountAddress中扣除。這個數量在Wei中,我們在控制器中指定它,它將調用EthereumService。每份合約都有不同的汽油價格。編譯合約時可以使用此值。我們可以在方法SendRequestAsync中指定合約構造函數參數。在我們的情況下,我們指定2,因爲合約發佈時我們的餘額應爲2個以太幣。
如上所述,必須挖掘部署才能獲得合約地址。我們需要這個地址來調用它上面的方法。在我們的TryGetContractAddress中,我們檢查我們的合約是否已經在我們的表存儲中有一個地址,如果沒有,我們會詢問以太坊區塊鏈。如果GetTransactionReceipt返回有效地址,我們可以保留它。
我們服務的最後一個方法是GetContract,這只是對以太坊合約的引用。如你所見,合約必須存在於表存儲中才能獲得合約地址。我們將在下一部分之後討論調用合約。
所以現在我們從dotNet離開下,轉到solidity程序語言。首先讓我們看看我們的測試合法性;
pragma solidity ^0.4.6;
contract CoinsContract {
uint public balance;
function CoinsContract(uint initial) {
balance = initial;
}
function addCoins(uint add) returns (uint b) {
b = balance + add;
return b;
}
function subtractCoins(uint add) returns (uint b) {
b = balance - add;
return b;
}
}
它只是一個基於其構造函數值的piggybank從該餘額開始。然後我們可以調用加法和減法來修改我們的代幣餘額。我知道這是非常基本的但是一開始總是好的,對嗎?合約發佈後,我們可以從dotNet代碼中調用addCoints或subtractCoints方法。那你爲什麼要這樣做呢?它只會花費我們以太?好的好處是,每次調用方法都會被添加到分配分類帳中,因此可以在https://testnet.etherscan.io/查看。
爲了發佈這個合約,我們需要將它編譯爲字節代碼。我們使用Remix網站這個基於網絡的基本編輯器可以編譯和測試你的合約。編譯完成後,我們可以獲得字節代碼(請不要忘記前面的0x)和接口,也稱爲ABI。在簽訂合約時需要提供這兩個部件。ABI代表應用程序二進制接口,就像Web服務的WSDL一樣。
回到Visual Studio,在我們發佈合約並開始調用方法之前,我們只需再做四個步驟。
首先,我們創建名爲EthereumSettings的設置文件:
namespace EthereumStart.Model
{
public class EthereumSettings
{
public EthereumSettings()
{
}
public string EhtereumAccount { get; set; }
public string EhtereumPassword { get; set; }
public string StorageKey { get; set; }
public string StorageAccount { get; set; }
}
}
其次,我們將這些設置添加到appsettings.json:
"ehtereumAccount": "x",
"ehtereumPassword": "y",
"storageKey": "w",
"storageAccount": "v"
當然,不是使用這些值,而是使用你自己的以太坊帳戶和密碼以及Azure存儲帳戶和密鑰。
第三,我們在我們的startup.cs中添加了ConfigureServices方法中的代碼:
services.Configure<EthereumSettings>(Configuration);
services.AddScoped<IEthereumService, BasicEthereumService>();
對於我們的最後一步,添加一個名爲EthereumTestController的控制器,內容應該是:
using EthereumStart.Services;
using Microsoft.AspNetCore.Mvc;
using System;
using System.Threading.Tasks;
namespace EthereumStart.Controllers
{
[Route("api/[controller]")]
public class EthereumTestController : Controller
{
private IEthereumService service;
private const string abi = @"[{""constant"":false,""inputs"":[{""name"":""add"",""type"":""uint256""}],""name"":""addCoins"",""outputs"":[{""name"":""b"",""type"":""uint256""}],""payable"":false,""type"":""function""},{""constant"":false,""inputs"":[{""name"":""add"",""type"":""uint256""}],""name"":""subtractCoins"",""outputs"":[{""name"":""b"",""type"":""uint256""}],""payable"":false,""type"":""function""},{""constant"":true,""inputs"":[],""name"":""balance"",""outputs"":[{""name"":"""",""type"":""uint256""}],""payable"":false,""type"":""function""},{""inputs"":[{""name"":""initial"",""type"":""uint256""}],""payable"":false,""type"":""constructor""}]";
private const string byteCode = "0x6060604052341561000c57fe5b604051602080610185833981016040528080519060200190919050505b806000819055505b505b610143806100426000396000f30060606040526000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff1680630173e3f41461005157806349fb396614610085578063b69ef8a8146100b9575bfe5b341561005957fe5b61006f60048080359060200190919050506100df565b6040518082815260200191505060405180910390f35b341561008d57fe5b6100a360048080359060200190919050506100f8565b6040518082815260200191505060405180910390f35b34156100c157fe5b6100c9610111565b6040518082815260200191505060405180910390f35b600081600054019050806000819055508090505b919050565b600081600054039050806000819055508090505b919050565b600054815600a165627a7a723058200085d6d7778b3c30ba2e3bf4af4c4811451f7367109c1a9b44916d876cb67c5c0029";
private const int gas = 4700000;
public EthereumTestController(IEthereumService ethereumService)
{
service = ethereumService;
}
[HttpGet]
[Route("getBalance/{walletAddress}")]
public async Task<decimal> GetBalance([FromRoute]string walletAddress)
{
return await service.GetBalance(walletAddress);
}
[HttpGet]
[Route("releaseContract/{name}")]
public async Task<bool> ReleaseContract([FromRoute] string name)
{
return await service.ReleaseContract(name, abi, byteCode, gas);
}
[HttpGet]
[Route("checkContract/{name}")]
public async Task<bool> CheckContract([FromRoute] string name)
{
return await service.TryGetContractAddress(name) != null;
}
[HttpGet]
[Route("exeContract/{name}/{contractMethod}/{value}")]
public async Task<string> ExecuteContract([FromRoute] string name, [FromRoute] string contractMethod, [FromRoute] int value)
{
string contractAddress = await service.TryGetContractAddress(name);
var contract = await service.GetContract(name);
if (contract == null) throw new System.Exception("Contact not present in storage");
var method = contract.GetFunction(contractMethod);
try
{
// var result = await method.CallAsync<int>(value);
var result = await method.SendTransactionAsync(service.AccountAddress, value);
return result.ToString();
}
catch (Exception ex)
{
return "error";
}
}
[HttpGet]
[Route("checkValue/{name}/{functionName}")]
public async Task<int> CheckValue([FromRoute] string name, [FromRoute] string functionName)
{
string contractAddress = await service.TryGetContractAddress(name);
var contract = await service.GetContract(name);
if (contract == null) throw new System.Exception("Contact not present in storage");
var function = contract.GetFunction(functionName);
var result = await function.CallAsync<int>();
return result;
}
}
}
它看起來很多代碼,但它是一些方法。首先,我們有合約的ABI和二進制代碼,第二個是我們加載服務的構造函數。然後我們可以調用4個http調用(請自己添加localhost +端口)
/api/EthereumTest/getBalance/0xfC1857DD580B41c03D7 e086dD23e7cB e1f0Edd17,這將檢查錢包,並應返回5 Ehter。
/api/EthereumTest/releaseContract/coins,這將釋放合約將結果保存到Azure存儲。
/api/EthereumTest/checkContract/coins,這將檢查合約地址是否可用。如果爲true,則存在合約地址,我們可以調用它。這可能需要一些時間(有時2分鐘,但有時20秒)。
/api/EthereumTest/exeContract/coins/addCoins/123,實際調用合約和方法addCoins的值爲123。一旦調用它,就會給出一個交易結果。可以使用CallAsync但是它會在你的本地以太坊VM中調用,因此這不會導致交易。因爲它是一個交易,所以返回交易地址。我們也可以在Etherscan網站上看到我們的合約。Etherscan顯示了以太坊的主要和測試網絡的所有交易。有了這個,你就可以證明你做了一筆交易。這是我們的一個交易可以查看。
/api/EthereumTest/checkValue/coins/balance,當我們的ExeContract中的交易被挖掘(驗證)時,我們也可以查看我們的乘法結果。合約中包含一個公共變量lastResult。可以調用此方法來獲取當前狀態。在與123簽訂合約後,餘額爲125。
/api/EthereumTest/exeContract/coins/subtractCoins/5,現在我們減去5個以太幣,再次檢查餘額,它應該是120。