2. 程式人生 > >web3j教程：java使用web3j開發以太坊智慧合約交易

web3j教程：java使用web3j開發以太坊智慧合約交易

阿新 • • 發佈：2018-11-25

從廣義上講，有web3j支援三種類型的以太坊交易：

  • 1.以太幣從一方交易到另一方
  • 2.建立一個智慧合約
  • 3.與智慧合約交易

為了進行這些交易，必須有以太幣(以太坊區塊鏈的代幣)存在於交易發生的以太坊賬戶中。這是為了支付gas成本，這是為支付參與交易的以太坊客戶端的交易執行成本，支付了這個成本就能將結果提交到以太坊區塊鏈上。獲得以太幣的說明下文會說到。

此外，我們還可以查詢智慧合約的狀態。

如何獲得以太幣Ether

要想獲得以太幣Ether你有兩種途徑可以選擇：

  • 1.自己開採挖礦
  • 2.從別人那裡獲取以太幣

在私有鏈中自己挖礦，或者公共測試鏈(testnet

)是非常簡單直接的。但是，在主要的公有鏈(mainnet)中，它需要很多很明顯的專用GPU時間，除非你已經擁有多個專用GPU的礦機，否則基本上不太可行。如果你希望使用私有鏈，則在這個官方文件中有一些指導。

要購買以太幣Ether，你需要通過交易所。由於不同的地區有不同的交易所，你還需要研究自己去哪兒合適。官方文件中包含多個交易所，是一個很好的參考。

以太坊測試鏈(testnets)

針對Ethereum以太坊有許多專用測試網路或者叫測試鏈，他們由各種客戶端支援。

  • 1.Rinkeby：只支援geth客戶端。
  • 2.Kovan：只支援Parity客戶端。
  • 3.Ropsten：支援geth和Parity客戶端。

對於開發，建議你使用Rinkeby或KoVan測試鏈。這是因為他們使用的工作量證明POA共識機制，確保交易和塊能夠一致並及時的建立。Ropsten測試鏈，雖然最接近公有鏈(Mainnet)，但是因為它使用的工作量證明是POW共識機制，過去已受到攻擊，對以太坊開發人員來說往往有更多的問題。

你可以通過Rinkeby測試鏈的Rinkeby Crypto Fauce請求以太坊幣，具體怎麼做可以看這裡https://www.rinkeby.io/。

有關如何請求Kovan測試鏈的細節可以在這裡找到。

如果你需要在Ropsten上的得到一些以太幣，將你的錢包地址的訊息釋出到web3j gitter channel

，然後會發送一些給你。

在testnet測試鏈或者私有鏈上挖掘

在ethereum以太坊測試鏈testnet中，挖掘難度低於公有鏈mainnet。這意味著你可以用普通的CPU，比如你的膝上型電腦來挖掘新的以太幣。你需要做的是執行一個以太坊客戶端，例如geth或Parity，開始做一些儲備。進一步的資料可在他們的官方網站上獲得。

一旦你開採了一些以太幣，你就可以開始使用以太坊區塊鏈了。

然而，如上所述，使用Kovan或者Rinkeby測試網路更簡單些。

gas

當在Ethereum以太坊發生交易時，必須為執行該交易的客戶端支付交易成本，將該交易的輸出提交到以太坊區塊鏈Ethereum blockchain。

此成本是通過gas來測量的，其中gas是用於在以太坊虛擬機器中執行交易指令的數量。請參閱官方文件以獲取更多資訊。

當你使用以太坊客戶端時，這意味著，有兩個引數用來指示你希望花費多少以太來完成傳輸：

  • gas price ：氣體價格，這是每單位gas中以太的消耗量。Web3j使用的預設價格為22000000000 wei(22×10-8 Ether)。這是在交易管理中定義的。
  • gas limit：氣體最大量，這是你願意在交易執行上花費的gas的最大總量。單個交易在一個以太坊區塊中有多大的上限，通常將該值限制為小於6700000。當前的gas限制在這裡查https://ethstats.net/。

這兩個引數共同決定了你願意花費在交易成本上的最大量的以太幣Ether。也就是說，你花費的gas不會超過gas price * gas limit。gas價格也會影響交易發生的速度，這取決於其他交易是否能為礦工提供更有利的gas價格。

你可能需要調整這些引數以確保交易能及時進行。

交易機制

當你用一些以太幣Ether建立了一個有效的帳戶時，你可以使用兩種機制來與以太坊進行交易。

  • 通過以太坊ethereum客戶端進行認證簽名交易
  • 離線交易簽名認證

這兩種機制都是Web3j所支援的。

通過以太坊ethereum客戶端進行認證簽名交易

為了通過以太坊客戶端進行交易，首先需要確保你正在使用的客戶端知道你的錢包地址。最好是執行自己的以太坊客戶端，比如geth/Parity，以便可以更方便的做到這一點。一旦你有一個客戶端執行，你可以建立一個以太坊錢包，通過：

  • geth Wiki包含了geth支援的良好執行的不同機制，例如匯入私有金鑰檔案，並通過控制檯建立新的以太坊帳戶。
  • 或者，你可以通過客戶端使用JSON-RPC管理命令，例如用personal_newAccount為geth/Parity建立新以太坊賬戶。

通過建立你的錢包檔案，你可以通過web3j開啟帳戶，首先建立支援geth/Parity管理命令的web3j例項：

Admin web3j = Admin.build(new HttpService());

然後，你可以解鎖帳戶，並如果是成功的，就可以傳送一個交易：

PersonalUnlockAccount personalUnlockAccount = web3j.personalUnlockAccount("0x000...", "a password").send();
if (personalUnlockAccount.accountUnlocked()) {
    // send a transaction
}

以這種方式傳送的交易應該通過EthSendTransaction建立，使用Transaction型別：

Transaction transaction = Transaction.createContractTransaction(
              <from address>,
              <nonce>,
              BigInteger.valueOf(<gas price>),  // we use default gas limit
              "0x...<smart contract code to execute>"
      );

      org.web3j.protocol.core.methods.response.EthSendTransaction
              transactionResponse = parity.ethSendTransaction(ethSendTransaction)
              .send();

      String transactionHash = transactionResponse.getTransactionHash();

      // poll for transaction response via org.web3j.protocol.Web3j.ethGetTransactionReceipt(<txHash>)

其中nonce值獲得方式，下文會提到。 有關此交易工作流的詳細資訊，請參閱 DeployContractIT和Scenario。

web3j支援的各種管理命令的進一步細節在Management APIs中。

離線交易簽名認證Offline transaction signing

如果你不想管理自己的以太坊客戶端，或者不想向以太坊客戶端提供諸如密碼之類的錢包詳細資訊，那麼就通過離線交易認證簽名。

離線交易簽名認證允許你在web3j中使用你的以太坊錢包簽署交易，允許你完全控制你的私有憑據。然後，離線建立的交易可以被髮送到網路上的任何以太坊客戶端，只要它是一個有效的交易，它會將交易傳播到其他節點。

如果需要，還可以執行程序外交易簽名認證。這可以通過重寫ECKeyPair的sign方法來實現。

建立和使用錢包檔案Ethereum wallet file

為了離線離線交易，你需要有你的錢包檔案或與私密錢包/賬戶相關的公共和私人金鑰。

web3j能夠為你生成一個新的安全的以太坊錢包檔案Ethereum wallet file，或者與也可以通過私鑰來和現有的錢包檔案一起工作。

建立新的錢包檔案:

String fileName = WalletUtils.generateNewWalletFile(
        "your password",
        new File("/path/to/destination"));

載入憑據從錢包檔案:

Credentials credentials = WalletUtils.loadCredentials(
        "your password",
        "/path/to/walletfile");

然後這些憑據會被用來簽署交易，請參閱Web3安全儲存定義錢包檔案規範Web3 Secret Storage Definition

簽署以太坊交易

要使離線簽名交易得到簽署，需要設定一個RawTransaction型別。RawTransaction類似於前面提到的Transaction型別，但是它不需要通過具體的賬號地址來請求，因為可以從簽名中推斷出來。

為了建立和簽署原生交易，交易的順序如下：

  • 1.確定交易發起者帳戶的下一個可用隨機數nonce
  • 2.建立RawTransaction物件
  • 3.使用遞迴長度字首編碼(RLP即Recursive Length Prefix)對RawTransaction物件進行編碼
  • 4.簽署RawTransaction物件
  • 5.將RawTransaction物件傳送到節點進行處理

nonce是一個不斷增長的數值，用來唯一地標識交易。一個nonce只能使用一次，直到交易被挖掘完成，可以以相同的隨機數傳送交易的多個版本，但是一旦其中一個被挖掘完成，其他後續提交的都將被拒絕。

一旦獲得下一個可用的nonce，該值就可以用來建立transaction物件：

RawTransaction rawTransaction  = RawTransaction.createEtherTransaction(
             nonce, <gas price>, <gas limit>, <toAddress>, <value>);

然後可以對交易進行簽名和編碼：

byte[] signedMessage = TransactionEncoder.signMessage(rawTransaction, <credentials>);
String hexValue = Numeric.toHexString(signedMessage);

其中憑據是根據建立和使用錢包檔案載入的。

然後使用eth_SendRawTransaction傳送交易：

EthSendTransaction ethSendTransaction = web3j.ethSendRawTransaction(hexValue).sendAsync().get();
String transactionHash = ethSendTransaction.getTransactionHash();
// poll for transaction response via org.web3j.protocol.Web3j.ethGetTransactionReceipt(<txHash>)

有關建立和傳送原始事務的完整示例，請參閱 CreateRawTransactionIT。

交易隨機數nonce

nonce是一個不斷增長的數值，用來唯一地標識交易。一個nonce只能使用一次，直到交易被挖掘完成，可以以相同的隨機數傳送交易的多個版本，但是一旦其中一個被挖掘完成，其他後續提交的都將被拒絕。

可以通過eth_getTransactionCount方法獲得下一個可用的nonce：

EthGetTransactionCount ethGetTransactionCount = web3j.ethGetTransactionCount(
             address, DefaultBlockParameterName.LATEST).sendAsync().get();

     BigInteger nonce = ethGetTransactionCount.getTransactionCount();

然後可以使用nonce建立你的交易物件：

RawTransaction rawTransaction  = RawTransaction.createEtherTransaction(
             nonce, <gas price>, <gas limit>, <toAddress>, <value>);

交易型別

web3j中的不同型別的交易都使用Transaction和RawTransaction物件。關鍵的區別是交易物件必須始終有一個地址，以便處理eth_sendTransaction請求的以太坊客戶端知道要使用哪個錢包來代表訊息傳送者併發送該交易。如上所述，對於離線簽名認證簽署的原始交易而言，這不是必須的。

接下來的部分概述了不同交易型別所需的關鍵交易屬性。下列屬性對所有人都是不變：

  • Gas price 天然氣氣體價格
  • Gas limit 天然氣氣體限制
  • Nonce 隨機數
  • from 傳送地址

Transaction和RawTransaction物件在所有後續示例中都可互換使用。

以太幣從一方交易到另一方

在雙方之間傳送以太幣Ether需要交易物件的最少量的資訊：

  • to ：目的地錢包地址
  • value：價值，希望傳送到目的地的以太幣數量
BigInteger value = Convert.toWei("1.0", Convert.Unit.ETHER).toBigInteger();
RawTransaction rawTransaction  = RawTransaction.createEtherTransaction(
             <nonce>, <gas price>, <gas limit>, <toAddress>, value);
// send...

但是，建議你使用TransferClass來發送以太幣Ether，它負責對nonce管理和通過不斷的輪詢為你提供響應：

Web3j web3 = Web3j.build(new HttpService());  // defaults to http://localhost:8545/
Credentials credentials = WalletUtils.loadCredentials("password", "/path/to/walletfile");
TransactionReceipt transactionReceipt = Transfer.sendFunds(
        web3, credentials, "0x<address>|<ensName>",
        BigDecimal.valueOf(1.0), Convert.Unit.ETHER).send();

使用智慧合約打包器smart contract wrappers

當使用下面列出的智慧合約打包器時，將不得不手動執行從Solidity到本機Java型別的所有轉換。使用Solidity smart contract wrappers是非常有效的，它負責所有的程式碼生成和轉換。

建立一個智慧合約

要部署新的智慧合約，需要提供以下屬性：

  • value ：在智慧合約中希望存放的以太坊Ether量(如果沒有提供預設為零)
  • data ：十六進位制格式化、編譯的智慧合約建立程式碼
// using a raw transaction
RawTransaction rawTransaction = RawTransaction.createContractTransaction(
        <nonce>,
        <gasPrice>,
        <gasLimit>,
        <value>,
        "0x <compiled smart contract code>");
// send...

// get contract address
EthGetTransactionReceipt transactionReceipt =
             web3j.ethGetTransactionReceipt(transactionHash).send();

if (transactionReceipt.getTransactionReceipt.isPresent()) {
    String contractAddress = transactionReceipt.get().getContractAddress();
} else {
    // try again
}

如果智慧合約包含建構函式，則必須對關聯的建構函式欄位值進行編碼，並將其附加到編譯的智慧合約程式碼中compiled smart contract code：

String encodedConstructor =
             FunctionEncoder.encodeConstructor(Arrays.asList(new Type(value), ...));

// using a regular transaction
Transaction transaction = Transaction.createContractTransaction(
        <fromAddress>,
        <nonce>,
        <gasPrice>,
        <gasLimit>,
        <value>,
        "0x <compiled smart contract code>" + encodedConstructor);

// send...

與智慧合約交易

要與現有的智慧合約進行交易，需要提供以下屬性：

  • to：智慧合同地址
  • value：在智慧合約中你希望存放的以太幣Ether量(如果智慧合約接受以太幣Ether的話)
  • data: 已編碼的函式選擇器和自變數引數

web3j負責函式編碼，有關實現的進一步細節，請參閱應用程式二進位制介面部分Application Binary Interface。

Function function = new Function<>(
             "functionName",  // function we're calling
             Arrays.asList(new Type(value), ...),  // Parameters to pass as Solidity Types
             Arrays.asList(new TypeReference<Type>() {}, ...));

String encodedFunction = FunctionEncoder.encode(function)
Transaction transaction = Transaction.createFunctionCallTransaction(
             <from>, <gasPrice>, <gasLimit>, contractAddress, <funds>, encodedFunction);

org.web3j.protocol.core.methods.response.EthSendTransaction transactionResponse =
             web3j.ethSendTransaction(transaction).sendAsync().get();

String transactionHash = transactionResponse.getTransactionHash();

// wait for response using EthGetTransactionReceipt...

無論訊息簽名的返回型別如何，都不可能從事務性函式呼叫返回值。但是，使用過濾器捕獲函式返回的值是可能的。詳情請參閱過濾器和事件部分。

查詢智慧合約狀態

這種功能是由eth_call通過JSON-RPC呼叫來實現的。

eth_call允許你呼叫智慧合約上的方法來查詢某個值。此函式沒有關聯交易成本，這是因為它不改變任何智慧合約方法的狀態，它只返回它們的值：

Function function = new Function<>(
             "functionName",
             Arrays.asList(new Type(value)),  // Solidity Types in smart contract functions
             Arrays.asList(new TypeReference<Type>() {}, ...));

String encodedFunction = FunctionEncoder.encode(function)
org.web3j.protocol.core.methods.response.EthCall response = web3j.ethCall(
             Transaction.createEthCallTransaction(<from>, contractAddress, encodedFunction),
             DefaultBlockParameterName.LATEST)
             .sendAsync().get();

List<Type> someTypes = FunctionReturnDecoder.decode(
             response.getValue(), function.getOutputParameters());

注意：如果一個無效的函式呼叫被執行，或者得到一個空null返回結果時，返回值將是一個Collections.emptyList例項。

  • web3j教程，主要是針對java和android程式設計師進行區塊鏈以太坊開發的web3j開發詳解。
  • 以太坊教程，主要介紹智慧合約與dapp應用開發，適合入門。
  • 以太坊開發，主要是介紹使用node.js、mongodb、區塊鏈、ipfs實現去中心化電商DApp實戰，適合進階。

匯智網原創翻譯，轉載請標明出處。原文訪問其官方部落格

相關推薦

web3j教程：java使用web3j開發以太坊智慧合約交易

從廣義上講，有web3j支援三種類型的以太坊交易： 1.以太幣從一方交易到另一方 2.建立一個智慧合約 3.與智慧合約交易 為了進行這些交易，必須有以太幣(以太坊區塊鏈的代幣)存在於交易發生的以太坊賬戶中。這是為了支付gas成本，這是為支付參與交易的以太坊客戶端的交

java如何在Spring Boot中用web3j開始開發以太坊智慧合約

通過Spring的依賴注入將web3j整合到Spring Boot應用程式中。此處提供了示例應用程式： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25

java類庫web3j開發以太坊智慧合約快速入門

web3j簡介 web3j是一個輕量級、高度模組化、響應式、型別安全的Java和Android類庫提供豐富API，用於處理以太坊智慧合約及與以太坊網路上的客戶端(節點)進行整合。 可以通過它進行以太坊區塊鏈的開發，而無需為你的java應用平臺編寫整合程式碼。

olidity語言開發以太坊智慧合約中的繼承

我們已經探索了很多主題，在編寫智慧合約時我們發現經常使用相同的模式：例如，智慧合約具有在建構函式中設定的所有者，然後生成修改器以便僅讓所有者使用一些功能。如果我們制定實施這些功能的基礎合約並在未來的智慧合約中重複使用它們那該怎麼辦？你一定猜得到，我們將使用繼承。 在Solidity中，繼承與經典的面向物

solidity語言開發以太坊智慧合約中的繼承

我們【天恆幸運飛艇原始碼下載】【征途原始碼論壇http://zhengtuwangluo.com】聯絡方式：QQ：2747044651已經探索了很多主題，在編寫智慧合約時我們發現經常使用相同的模式：例如，智慧合約具有在建構函式中設定的所有者，然後生成修改器以便僅

以太坊智慧合約學習筆記：使用Truffle框架開發部署智慧合約

truffle是一個智慧合約的開發框架，具體的就不介紹了，我們主要是說說怎麼使用這個框架來進行智慧合約的開發，官網戳這裡。 文章目錄 #安裝 首先我們要先安裝npm和truffle，安裝命令如下 sudo apt install npm sudo n

以太坊智慧合約學習筆記：開發流程及工具鏈使用

本文主要介紹開發流程和工具鏈的使用，安裝過程百度上有好多，這裡就不贅述了 網上隨便找了一個智慧合約的例子，咱們來做一個投票系統，先用傳統的中心化方案去實現，然後在過度到區塊鏈1.0，最後再用區塊鏈2.0，感受一下開發思想的不同。 業務分析 傳統

以太坊教程-web3 + express開發以太坊錢包

在上一節中我們講到了瞭如何使用web3調來用以太坊API，學習瞭如何建立賬戶，使用私鑰簽名交易，查詢餘額，轉賬等操作。本節我們將建立一個視覺化的介面，來完成建立賬戶，轉賬、查詢餘額等功能。 目錄： 建立專案 安裝專案依賴 獲取web3例項物件 建立前端頁面

一起學：以太坊智慧合約開發

課程介紹無論在科技圈還是金融圈，“區塊鏈”儼然成了最熱的詞彙。2016年，區塊鏈寫入了國家的十三五規劃中；2017年，央行基於區塊鏈技術的數字票據交易平臺測試成功；同年，工信部發布了首個區塊鏈參考架構標準。
經過2017年如火如荼的投資盛宴，區塊鏈開始逐漸走向應用落地，業內都

以太坊智慧合約學習筆記：網頁互動

沒搞過web程式，花了幾天研究一下，總算是搞懂了網頁與以太坊節點的互動流程。 網頁與智慧合約互動，需要使用web3.js，它實現了通用JSON PRC規範，通過JSON RPC協議與以太坊節點進行互動。除了js以外，以太坊還提供了Java、Python等語言的API，對於沒有提供API的語言

區塊鏈開發（二）部署並執行第一個以太坊智慧合約

        網路上不少部署智慧合約的文章，但是都有一個共同的特點，就是採用命令列的方式來部署，先是建立SOLC的編譯環境，然後部署Geth或者Eth節點，然後一步一步生成錢包、ABI、合約地址進行部署，對初學者來說晦澀難懂而且容易失敗，本文主要介紹如何在圖形化介面下一鍵部

區塊鏈開發（二）部署和執行第一個以太坊智慧合約

區塊鏈開發（二）部署並執行第一個以太坊智慧合約 李赫2016年8月22日 本文首發8BTC         網路上不少部署智慧合約的文章，但是都有一個共同的特點，就是採用命令列的方式來部署，先是建立S

以太坊智慧合約程式設計之菜鳥教程

手把手帶你走上智慧合約程式設計之路 譯註：原文首發於ConsenSys開發者部落格，原作者為Eva以及ConsenSys的開發團隊。如果您想要獲取更多及時資訊，可以訪問ConsenSys首頁點選左下角Newsletter訂閱郵件。本文的翻譯獲得了ConsenSys創始人Lubin先生的授權。 有些人說以太

區塊鏈100講：以太坊智慧合約solidity如何節省GAS費？

1 摘要 在以太坊上，程式碼即法律，交易即金錢。每一筆智慧合約的執行，都要根據複雜度消耗一筆GAS費(ETH)。那麼，智慧合約solidity語言的編寫，不僅要考慮安全，也要考慮語言的優化，以便高效便宜了。 本文將從以下一些方面分析如何節約GAS的程式設計總結

【以太坊系列-003】以太坊智慧合約 —— 最佳安全開發指南

1基本理念 以太坊和其他複雜的區塊鏈專案都處於早期階段並且有很強的實驗性質。因此，隨著新的bug和安全漏洞被發現，新的功能不斷被開發出來，其面臨的安全威脅也是不斷變化的。這篇文章對於開發人員編寫安全的智慧合約來說只是個開始。 開發智慧合約需要一個全新的工程思維，它不同於我們以往專案的開發。因

Android通過web3j以太坊智慧合約互動

如果要下載整個以太坊區塊鏈並保持本地節點同步。當區塊鏈佔用了我計算機上超過100GB的空間。這在臺式計算機上可能有意義，但在移動裝置上則不太合理。 解決此限制的一種方法是使用像Infura這樣的服務。Infura允許你連線到遠端以太坊節點並執行交易，而無需擔心維護和同步本地

以太坊智慧合約開發環境搭建

以太坊合約開發最快速上手是使用remix-ide，用瀏覽器開啟即可使用。不過喜歡折騰的話，就需要手動搭環境了，本文簡單介紹了以太坊開發環境的搭建。 一、 搭建環境 本文使用的作業系統為Ubuntu 16.04。 以太坊開發需要安裝：geth、s

以太坊智慧合約教程1-概念入門

很多同學已經躍躍欲試投入到區塊鏈開發隊伍當中來，可是又感覺無從下手，本文將基於以太坊平臺，以通俗的方式介紹以太坊開發中涉及的各晦澀的概念，輕鬆帶大家入門。以太坊是什麼以太坊（Ethereum）是一個建立在區塊鏈技術之上， 去中心化應用平臺。它允許任何人在平臺中建立和使用通過區

《區塊鏈學堂》第三課：以太坊智慧合約實戰（附課程視訊）

既區塊鏈學堂第二課：以太坊架構和工具之後，時隔一週的4月2日區塊鏈學堂推出了第三課：以太坊智慧合約實戰。 本期主要介紹了以太坊智慧合約程式設計基礎及實戰。 從這一期開始我們區塊鏈學堂會在鬥魚進行直播，方便不能到現場聽課的朋友們。 以下一些現場照片，課程視訊和PPT在最後。

以太坊智慧合約代幣應用開發（2）-geth的基本應用

一、概述本節將介紹geth私有鏈環境的搭建，在進行區塊鏈開發時一般需要在私有鏈環境當中進行，一開始就在公鏈上開發所有的資源使用都需要支付相關費用，而且所有區塊在同步資料時都會有延遲。二、相關概念1、共有鏈與私有鏈公共區塊鏈是指全世界任何人都可讀取的、任何人都能傳送交易且交易能