kyberNetwork是基於以太坊平臺建立的去中心化金融應用。
KyberNetwork支援兌換以太坊代幣,類似於傳統的外匯交易,還支援兌換其他法定貨幣。主要的區別在於根本不涉及任何中心交易所!KyberNetwork的基礎代幣是以太坊(ETH),而不是任何法定貨幣。
作為“ KyberDAO”社羣實驗的一部分,該網路於6月啟動了其基於DAOstack的DAO(在Aragon平臺上進行了首次實驗之後),併為其提供了約17,000 KNC(約合4500美元)的資金。社羣中的任何人都可以提交提案,並提出資金申請,以獲取部分或全部贈款(請參見公告)。
從介面的角度來看,KyberNetwork除了提供直接的智慧合約abi之外,kyberNetwork還提供了restful api,它為使用者(沒有太多智慧合約知識)提供了與其合約互動的能力。
關於Kyber Java客戶端庫
現在讓我們深入瞭解KyberNetwork的Java客戶端庫。首先,讓我們執行Java教程應用程式。
準備步驟:在機器上安裝java、git和gradle。
很明顯,您的機器上安裝了java和git,還要使用gradle構建環境,這樣您就可以從命令列輕鬆執行教程程式碼。在您的計算機上安裝所有這三個依賴項。
準備步驟:使用web3j命令建立一個ropsten測試錢包
在我們的例子中,我們必須在ropsten測試網路上建立一個測試錢包,用於我們的代幣交換場景。命令列工具可以使用各種安裝程式。
如果是Windows,請使用ZIP檔案分發並提取到目錄中,然後執行web3j.bat檔案。
使用錢包工具建立一個錢包。“wallet create”將建立wallet.json檔案。
檢視錢包檔案中建立的以太坊地址,然後轉移一些以太坊到該地址上。
· 您可以使用Ropsten水龍頭建立以太坊測試幣:https://faucet.ropsten.be/
· 檢查您的地址、交易和任何其他區塊鏈資訊,使用https://ropsten.etherscan.io/
· 在我們的教程應用程式中,需要為錢包選擇密碼才能載入必要的憑據。
準備步驟:建立infura測試節點帳戶
要將Kyber交換交易寫入以太坊區塊鏈,您需要一個infura測試節點帳戶.
· 在infura上設定帳戶
· 建立一個新專案,您將使用Infura秘密代幣(Project Secret)連線到Ropsten Test網路。
準備步驟:複製github目錄並建立一個secret目錄
· 使用本教程複製github目錄:https://github.com/talfco/clb-kyber-java-tutorial
· 在clb-kyber-java-tutorial中建立一個secret目錄,然後複製wallet.json檔案。
· 建立secret.properties檔案並新增錢包密碼和infura代幣新增條目。
執行教程應用程式
只需輸入gradle run即可啟動教程應用程式。
應用程式將呼叫三種功能:
1. 首先,它將部分測試以太幣轉換為兩個DAI令牌(eth2token)。需要Kyber購買費率才能確定所需的以太坊的數量。
2. 其次,它將一個DAI代幣轉換回以太坊(token2eth)。為了確定支付的以太坊數量,需要Kyber銷售率。
3. 第三,它將一個DAI代幣轉換為一個BAT代幣(token2token)。 對於此交易,同時需要Kyber的購買率和銷售率,以確定可以購買多少個BAT代幣。
public static void main(String[] args) throws Exception {
Application app = new Application();
log.info(">>> SCENARIO: ETH2TOKEN");
Thread.sleep(3000);
app.eth2token("DAI","2");
log.info(">>> SCENARIO: TOKEN2ETH");
Thread.sleep(3000);
app.token2eth("DAI","1");
log.info(">>> SCENARIO: TOKEN2TOKEN");
Thread.sleep(3000);
app.token2token("DAI","BAT","0.5");
}
檢查控制檯輸出中已建立的交易雜湊和其他資訊。
教程生成的以太坊交易
該教程應用程式將生成3個以太坊交易,您可以透過etherscan.io Web應用程式進行結帳。
1. https://ropsten.etherscan.io/address/ <yourTestWalletAddress>
2. 您將看到由我們的三個功能觸發的三筆交易
您現在也是Ropsten網路上DAI和BAT代幣的所有者。將來,您可以使用這個簡單的java應用程式生成任何型別的測試代幣(只要kyber測試網路支援它)
例如下面的螢幕截圖是來自eth2token轉換(購買了2個dai代幣)的詳細事務資訊。現在,您可以深入瞭解並研究與此交易相關的kyber合約。
實施方面-Kyber API功能設計為web3j模組
本教程是我對Ethereum的第一篇Java程式設計文章,我發現Ethereum網路的一個不錯的Java庫。Web3實驗室的web3j是一個著名的例子。它主要側重於智慧合約(主要受到Kyber Restful API的保護),並將具有必要的工具包來載入錢包憑證和簽署交易,這在Kyber Restful API中也發揮著作用。
引入的java類和介面繼承自web3j的核心類,並以類似的方式實現。這讓我一方面可以利用來自web3j的大量程式碼;另一方面,使用web3j的開發人員將發現類似的模式。
為了符合web3j(圍繞JSON-RPC介面構建),我引入了JsonRpc2_0Kyber類,該類充當協議轉換器併為Kyber REST API準備請求。
Kyber Java API介面支援以下功能。
package net.cloudburo.kyber.tutorial.protocol;
import net.cloudburo.kyber.tutorial.methods.request.GasPriceRange;
import net.cloudburo.kyber.tutorial.methods.request.SingleRate;
import net.cloudburo.kyber.tutorial.methods.response.*;
import org.web3j.protocol.core.Request;
import java.math.BigInteger;
public interface KyberAPI {
public Request<?, Currencies> currencies();
public Request<?, BuyRate> buyRate(String id, String qty,boolean onlyOfficialReserve);
public Request<?, SellRate> sellRate(String id, String qty, boolean onlyOfficialReserve);
public Request<?, TradeData> tradeData(String userAddress, SingleRate rate, GasPriceRange gasPrice);
public Request<?, TradeData> tradeData(String userAddress, SingleRate rate, GasPriceRange gasPrice, BigInteger nonce);
public Request<?, TradeData> tradeData(String userAddress, String srcId, String dstId, Float srcQty,Float minDstQty,
GasPriceRange gasPrice, String walletId, boolean onlyOfficialReserve);
public Request<?,EnabledTokensForWallet> enabledTokensForWallet(String userAddress);
public Request<?, EnableTokenTransfer> enableTokenTransfer(String userAddress, String id, GasPriceRange gasPrice);
}
可以看到,主要部分是Java strong型別。JSON資料請求透過Jackson XML解析支援自動轉換為Java類。
第二篇文章將深入探討構建的客戶端庫的各個設計方面。
交易場景程式碼
結束本教程;提供了這三種情況的程式碼序列。 如您所見,程式碼非常緊湊,易讀且易於理解。 如果您檢視基本的web3j以太坊事務示例,您將看到程式碼的相似性。
場景:ETH2TOKEN
只要認識到使用kyber api交換ethereum上的代幣是多麼容易!
private void eth2token(String tokenSymbol, String tokenQuantity) {
Kyber3j kyber3j = Kyber3j.build(new KyberService(KyberService.KYBER_ROPSTEN));
log.info("Connected to Kyber Network: "+KyberService.KYBER_ROPSTEN);
// ETH2<Token> Swap
try {
// Check if token is supported
Currencies currencies = kyber3j.currencies().send();
log.info("Exists Currency"+tokenSymbol+": " + currencies.existsCurreny(tokenSymbol));
if (!checkForError(currencies) && currencies.existsCurreny(tokenSymbol)) {
// Get buy rates
BuyRate buyRate = kyber3j.buyRate(currencies.getCurrency(tokenSymbol).getId(),tokenQuantity,
false).send();
if (!checkForError(buyRate)) {
Rates rates = buyRate.getData().get(0);
SingleRate singleRate = rates.getSingleRate(0);
log.info("Conversion Rate: " + singleRate.getSrc_qty());
// Get tradeData
// Adjust conversion rates to 97%
singleRate.approximateReceivableToken(0.97);
TradeData tradeData = kyber3j.tradeData(credentials.getAddress(), singleRate, GasPriceRange.medium,nonce).send();
if (!checkForError(tradeData)) {
executeEthereumTransaction(tradeData.getData().get(0));
}
}
}
} catch (Exception e) { e.printStackTrace(); }
}
場景:TOKEN2ETH
private void token2eth(String tokenSymbol, String tokenQuantity){
Kyber3j kyber3j = Kyber3j.build(new KyberService(KyberService.KYBER_ROPSTEN));
log.info("Connected to Kyber Network: "+KyberService.KYBER_ROPSTEN);
try {
// Check if token is supported
Currencies currencies = kyber3j.currencies().send();
if (!checkForError(currencies) && currencies.existsCurreny(tokenSymbol)) {
EnabledTokensForWallet tokens = kyber3j.enabledTokensForWallet(credentials.getAddress()).send();
if (!checkForError(tokens)){
// Check if wallet is enabled for token
String tokenId = currencies.getCurrency(tokenSymbol).getId();
EnabledTokensForWallet.EnabledTokenStatus tokenStatus = tokens.getEnabledTokenStatus(tokenId);
if ( tokenStatus.isEnabled()) {
if (tokenStatus.getTxs_required() == 1) {
// Enable Token Transfer
EnableTokenTransfer tokenData = kyber3j.enableTokenTransfer(credentials.getAddress(), tokenId,
GasPriceRange.medium).send();
executeEthereumTransaction(tokenData.getData());
}
SellRate sellRate = kyber3j.sellRate(currencies.getCurrency(tokenSymbol).getId(), tokenQuantity,
false).send();
if (!checkForError(sellRate)) {
Rates rates = sellRate.getData().get(0);
SingleRate singleRate = rates.getSingleRate(0);
log.info("Conversion Rate: " + singleRate.getSrc_qty());
singleRate.approximateReceivableToken(0.97);
TradeData tradeData = kyber3j.tradeData(credentials.getAddress(), singleRate, GasPriceRange.medium,nonce).send();
if (!checkForError(tradeData)) {
executeEthereumTransaction(tradeData.getData().get(0));
}
}
}
}
}
} catch (Exception e){ e.printStackTrace(); }
}
場景:Token2Token
private void token2token(String tokenSymbolFrom, String tokenSymbolTo, String tokenQuantity) {
//Suppose we want to convert 100 BAT to DAI tokens, which is a token to token conversion.
// Note that ETH is used as the base pair i.e. BAT -> ETH -> DAI.
Kyber3j kyber3j = Kyber3j.build(new KyberService(KyberService.KYBER_ROPSTEN));
log.info("Connected to Kyber Network: "+KyberService.KYBER_ROPSTEN);
try {
Currencies currencies = kyber3j.currencies().send();
if (!checkForError(currencies) && currencies.existsCurreny(tokenSymbolFrom)
&& currencies.existsCurreny(tokenSymbolTo) ) {
EnabledTokensForWallet tokens = kyber3j.enabledTokensForWallet(credentials.getAddress()).send();
if (!checkForError(tokens)) {
// Check if wallet is enabled for tokens
String tokenId = currencies.getCurrency(tokenSymbolFrom).getId();
EnabledTokensForWallet.EnabledTokenStatus tokenStatus = tokens.getEnabledTokenStatus(tokenId);
if ( tokenStatus.isEnabled()) {
// Check if the sell token is already enabled to be sold by the network on behalf of this user
if (tokenStatus.getTxs_required() == 1) {
EnableTokenTransfer tokenData = kyber3j.enableTokenTransfer(credentials.getAddress(), tokenId,
GasPriceRange.medium).send();
executeEthereumTransaction(tokenData.getData());
} else if (tokenStatus.getTxs_required() == 2) {
// TODO Implement validation
log.error("Not implemented for getTxs_required = 2");
}
} else {
log.error("Curreny not supported");
return;
}
// Get Sell Rate in ETH: <fromTokenQuantity> -> ETH ?
SellRate sellRate = kyber3j.sellRate(currencies.getCurrency(tokenSymbolFrom).getId(), tokenQuantity,
false).send();
if (!checkForError(sellRate)) {
Rates rates = sellRate.getData().get(0);
SingleRate singleRateFromToken = rates.getSingleRate(0);
Float sellQty = singleRateFromToken.getDst_qty();
log.info(tokenSymbolFrom+" Sell Rate: " + singleRateFromToken.getSrc_qty());
// Get Buy Rate for 1 toToken: ETH ? -> 1 <toToken>
BuyRate buyRate = kyber3j.buyRate(currencies.getCurrency(tokenSymbolTo).getId(),"1",
false).send();
if (!checkForError(buyRate)) {
rates = buyRate.getData().get(0);
SingleRate singleRateToToken = rates.getSingleRate(0);
Float buyQty = singleRateToToken.getSrc_qty();
Float expectedAmountWithoutSlippage = sellQty / buyQty; // * Float.valueOf(tokenQuantity);
Float expectedAmountWithSlippage = expectedAmountWithoutSlippage * 0.97f;
singleRateFromToken.setDst_id(singleRateToToken.getDst_id());
singleRateFromToken.setDst_qty(expectedAmountWithSlippage);
TradeData tradeData = kyber3j.tradeData(credentials.getAddress(), singleRateFromToken, GasPriceRange.medium, nonce).send();
if (!checkForError(tradeData)) {
executeEthereumTransaction(tradeData.getData().get(0));
}
}
}
}
}
} catch (Exception e){e.printStackTrace();}
}
最後一點
我希望本教程對您有用,將程式碼載入到java ide中並開始使用它。您將認識到在以太坊網路上執行和交換代幣事務是多麼容易一件事。