NetCore使用以太坊區塊鏈簡介

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。
 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章