BUMO 资产发行 JAVA 开发指南

场景描述

某资方在buchain上发行资产代码为GLA、名称为Global、总发行量为10亿的数字资产，具体信息如下：

字段	是否必填	示例	描述
name	是	Global	资产名称
code	是	GLA	资产代码
totalSupply	是	1000000000	资产总发行量
decimals	是	8	资产精度
description	否		资产描述
icon	否		资产ICON
version	是	1.0	协议版本号

注意：

code：推荐使用大写简拼。
decimals：小数位在0~8的范围，0表示无小数位。
totalSupply：范围是0~2^63-1。0表示不固定Token的上限。 假如发行一笔数量是10000, 精度为8的ATP 10 Token，此时totalSupply = 10 ^ 8 * 10000, 结果是1000000000000。
icon： base64位编码，图标文件大小是32k以内,推荐200*200像素。
version：协议版本，目前填写1.0。

资产发行开发流程

本文以Java语言为例，新创建一个资产发行方（简称为“资方”）并发行10亿GLA资产。

note : 示例中的[资方账户地址]请替换为资方待发行资产的账户地址，[资方账户私钥]请替换为资方待发行资产的账户私钥。

创建SDK实例

创建实例并设置url(部署的某节点的IP和端口)。

 String url = "http://seed1.bumotest.io:26002";SDK sdk = SDK.getInstance(url);

在BuChain网络里，每个区块产生时间是10秒，每个交易只需要一次确认即可得到交易终态。

环境说明如下：

网络环境	IP	Port	区块链浏览器
主网	seed1.bumo.io	16002	https://explorer.bumo.io
测试	seed1.bumotest.io	26002	https://explorer.bumotest.io

创建资方账户

创建资方账户的具体代码示例如下：

public static AccountCreateResult createAccount() {AccountCreateResponse response = sdk.getAccountService().create();if (response.getErrorCode() != 0) {return null;}return response.getResult();
}

创建账户的返回值如下：

 AccountCreateResultaddress:  buQYszjqVYdhcPT56GZcKHVh4i7xtx6amr2gprivateKey:  privbUAYxPLLyaxvU3EMkSTfuEDTWxAYvyCasUcCgUxDihtNXQL4oHJxpublicKey: b001724ed9475ca4c8893329924c7dceae66c61d8577ab2c2c3b29376e143137c20a4bbed176

注意：通过以上方式创建的账户是未被激活的账户。

激活资方账户

账户未被激活时需要通过已被激活（已上链）的账户进行激活。已被激活的资方账户请跳过本节内容。

注意：

主网环境：账户激活可以通过小布口袋（钱包）给该资方账户转50.03BU（用于支付资产发行时需要的交易费用），即可激活该账户。
测试环境：通过访问水龙头，将待激活（或充值）的账户地址输入到编辑框中，点击"Confirm"，就完成了激活（或充值）。

获取资方账户的序列号

每个账户都维护着自己的序列号，该序列号从1开始，依次递增，一个序列号标志着一个该账户的交易。

获取资方账号序列号的代码如下：

 public long getAccountNonce() {long nonce = 0;// Init requestString accountAddress = [资方账户地址];AccountGetNonceRequest request = new AccountGetNonceRequest();request.setAddress(accountAddress);// Call getNonceAccountGetNonceResponse response = sdk.getAccountService().getNonce(request);if (0 == response.getErrorCode()) {nonce = response.getResult().getNonce();} else {System.out.println("error: " + response.getErrorDesc());}return nonce;}

获取资方账号序列号的返回值如下：

 nonce: 28

组装发行资产操作

一个交易可由多个操作组成，每个操作都指向一个具体的交易内容。

发行资产则需要两个操作: 资产发行操作（AssetIssueOperation）和设置资产信息操作（AccountSetMetadataOperation）。

组装发行资产操作的具体代码如下：

    public BaseOperation[] buildOperations() {// The account address to issue apt1.0 tokenString issuerAddress = [资方账户地址];// The token nameString name = "Global";// The token codeString code = "GLA";// The apt token versionString version = "1.0";// The apt token iconString icon = "";// The token total supply numberLong totalSupply = 1000000000L;// The token now supply numberLong nowSupply = 1000000000L;// The token descriptionString description = "GLA TOKEN";// The token decimalsInteger decimals = 0;// Build asset issuance operationAssetIssueOperation assetIssueOperation = new AssetIssueOperation();assetIssueOperation.setSourceAddress(issuerAddress);assetIssueOperation.setCode(code);assetIssueOperation.setAmount(nowSupply);// If this is an atp 1.0 token, you must set metadata like thisJSONObject atp10Json = new JSONObject();atp10Json.put("name", name);atp10Json.put("code", code);atp10Json.put("description", description);atp10Json.put("decimals", decimals);atp10Json.put("totalSupply", totalSupply);atp10Json.put("icon", icon);atp10Json.put("version", version);String key = "asset_property_" + code;String value = atp10Json.toJSONString();// Build setMetadataAccountSetMetadataOperation accountSetMetadataOperation = new AccountSetMetadataOperation();accountSetMetadataOperation.setSourceAddress(issuerAddress);accountSetMetadataOperation.setKey(key);accountSetMetadataOperation.setValue(value);BaseOperation[] operations = {assetIssueOperation, accountSetMetadataOperation};return operations;}

序列化交易

序列化交易以便网络传输。

注意：

feeLimit: 本次交易发起方最多支付本次交易的交易费用，发行资产操作请填写50.03BU
nonce: 本次交易发起方的交易序列号，该值由当前账户的nonce值加1得到。

序列化交易的具体代码如下,示例中的参数 nonce 是调用 getAccountNonce 得到的账户序列号，参数 operations 是调用 buildOperations 得到发行资产的操作。

 public String seralizeTransaction(Long nonce,  BaseOperation[] operations) {String transactionBlob = null;// The account address to issue atp1.0 tokenString senderAddresss = [资方账户地址];// The gasPrice is fixed at 1000L, the unit is MOLong gasPrice = 1000L;// Set up the maximum cost 50.03BULong feeLimit = ToBaseUnit.BU2MO("50.03");// Nonce should add 1nonce += 1;// Build transaction  BlobTransactionBuildBlobRequest transactionBuildBlobRequest = new TransactionBuildBlobRequest();transactionBuildBlobRequest.setSourceAddress(senderAddresss);transactionBuildBlobRequest.setNonce(nonce);transactionBuildBlobRequest.setFeeLimit(feeLimit);transactionBuildBlobRequest.setGasPrice(gasPrice);for (int i = 0; i < operations.length; i++) {transactionBuildBlobRequest.addOperation(operations[i]);}TransactionBuildBlobResponse transactionBuildBlobResponse = sdk.getTransactionService().buildBlob(transactionBuildBlobRequest);if (transactionBuildBlobResponse.getErrorCode() == 0) {transactionBlob = transactionBuildBlobResponse. getResult().getTransactionBlob();} else {System.out.println("error: " + transactionBuildBlobResponse.getErrorDesc());}return transactionBlob;}

序列化交易的返回值如下：

 transactionBlob: 0A2462755173757248314D34726A4C6B666A7A6B7852394B584A366A537532723978424E4577101C18C0F1CED11220E8073A350802122462755173757248314D34726A4C6B666A7A6B7852394B584A366A537532723978424E45772A0B0A03474C41108094EBDC033AB6010804122462755173757248314D34726A4C6B666A7A6B7852394B584A366A537532723978424E45773A8B010A1261737365745F70726F70657274795F474C4112757B22636F6465223A22474C41222C22746F74616C537570706C79223A313030303030303030302C22646563696D616C73223A302C226E616D65223A22474C41222C2269636F6E223A22222C226465736372697074696F6E223A22474C4120544F4B454E222C2276657273696F6E223A22312E30227D

签名交易

所有的交易都需要经过签名后，才是有效的。签名结果包括签名数据和公钥。

签名交易的具体代码如下,示例中的参数transactionBlob是调用seralizeTransaction得到的序列化交易字符串。

 public Signature[] signTransaction(String transactionBlob) {Signature[] signatures = null;// The account private key to issue atp1.0 tokenString senderPrivateKey = [资方账户私钥];// Sign transaction BLobTransactionSignRequest transactionSignRequest = new TransactionSignRequest();transactionSignRequest.setBlob(transactionBlob);transactionSignRequest.addPrivateKey(senderPrivateKey);TransactionSignResponse transactionSignResponse = sdk.getTransactionService().sign(transactionSignRequest);if (transactionSignResponse.getErrorCode() == 0) {signatures = transactionSignResponse.getResult().getSignatures();} else {System.out.println("error: " + transactionSignResponse.getErrorDesc());}return signatures;}

签名交易的返回值如下：

 signData: 6CEA42B11253BD49E7F1A0A90EB16448C6BC35E8684588DAB8C5D77B5E771BD5C7E1718942B32F9BDE14551866C00FEBA832D92F88755226434413F98E5A990CpublicKey: b00179b4adb1d3188aa1b98d6977a837bd4afdbb4813ac65472074fe3a491979bf256ba63895

发送交易

将序列化的交易和签名发送到BuChain。

发送交易具体代码如下,示例中的参数transactionBlob是调用seralizeTransaction得到的序列化交易字符串，signatures是调用signTransaction得到的签名数据。

 public String submitTransaction(String transactionBlob, Signature[] signatures) {String  hash = null;// Submit transactionTransactionSubmitRequest transactionSubmitRequest = new TransactionSubmitRequest();transactionSubmitRequest.setTransactionBlob(transactionBlob);transactionSubmitRequest.setSignatures(signatures);TransactionSubmitResponse transactionSubmitResponse = sdk.getTransactionService().submit(transactionSubmitRequest);if (0 == transactionSubmitResponse.getErrorCode()) {hash = transactionSubmitResponse.getResult().getHash();} else {System.out.println("error: " + transactionSubmitResponse.getErrorDesc());}return  hash ;}

发送交易的返回值如下：

 hash:  031fa9a7da6cf8777cdd55df782713d4d05e2465146a697832011b058c0a0cd8

查询交易是否执行成功

注意：发送交易返回的结果只是交易是否提交成功的结果，而交易是否执行成功的结果需要执行如下查询操作, 具体有两种方法：

区块链浏览器查询

在BUMO区块链浏览器中查询上面的hash，主网，测试网，操作如下图：

查询结果如下：

调用接口查询

调用接口查询的代码如下,示例中的参数txHash是调用submitTransaction得到的交易哈希(交易的惟一标识)。

 public int checkTransactionStatus(String txHash) {// Init requestTransactionGetInfoRequest request = new TransactionGetInfoRequest();request.setHash(txHash);// Call getInfoTransactionGetInfoResponse response = sdk.getTransactionService().getInfo(request);int errorCode = response.getErrorCode();if (errorCode == 0){TransactionHistory transactionHistory = response.getResult().getTransactions()[0];errorCode = transactionHistory.getErrorCode();}return errorCode;}

返回值：

错误码	描述
0	Successful operation
1	Inner service defect
2	Parameters error
3	Objects already exist, such as repeated transactions
4	Objects do not exist, such as null account, transactions and blocks etc.
5	Transactions expired. It means the transaction has been removed from the buffer, but it still has probability to be executed.
7	Math calculation is overflown
20	The expression returns false. It means the TX failed to be executed currently, but it still has probability to be executed in the following blocks .
21	The syntax of the expression returns are false. It means that the TX must fail.
90	Invalid public key
91	Invalid private key
92	Invalid assets
93	The weight of the signature does not match the threshold of the operation.
94	Invalid address
97	Absent operation of TX
98	Over 100 operations in a single transaction
99	Invalid sequence or nonce of TX
100	Low reserve in the account
101	Sender and receiver accounts are the same
102	The target account already exists
103	Accounts do not exist
104	Low reserve in the account
105	Amount of assets exceeds the limitation ( int64 )
106	Insufficient initial reserve for account creation
111	Low transaction fee
114	TX buffer is full
120	Invalid weight
121	Invalid threshold
144	Invalid data version of metadata
146	exceeds upper limitation
151	Failure in contract execution
152	Failure in syntax analysis
153	The depth of contract recursion exceeds upper limitation
154	the TX submitted from the contract exceeds upper limitation
155	Contract expired
160	Fail to insert the TX into buffer
11060	BlockNumber must bigger than 0
11007	Failed to connect to the network
12001	Request parameter cannot be null
20000	System error

开发指南：BUMO 资产发行 JAVA 开发指南相关推荐

开发指南：BUMO 智能合约 Java 开发指南
BUMO 智能合约 Java 开发指南概述合约是一段JavaScript代码,标准(ECMAScript as specified in ECMA-262).合约的初始化函数是init, 执行的入 ...
开发指南：BUMO 存证 JAVA 开发指南
BUMO 存证 JAVA 开发指南 BUMO开发概述 BUMO是新一代商用级基础公链.通过创新的共识算法(BU Firework).主链-子链多链结构(BU Orbits).主链-主链跨链结构(BU ...
Java自己文章只能自己修改_文章目录Java代码俯身指南，主要为Java开发人员提供代码复审参考，快捷有效提出修改意见。目的发现代码错误：一个人写的代码可能会有一些思想和设计盲点，多个人尽...
文章目录 Java代码俯身指南,主要为Java开发人员提供代码复审参考,快捷有效提出修改意见. 目的发现代码错误:一个人写的代码可能会有一些思想和设计盲点,多个人尽早的发现BUG. 统一代码风格:统一 ...
java 操作vss,java开发常用工具总结，java开发常用工具
java开发常用工具总结,java开发常用工具 1.editplus editplus 是我使用最频繁的工具,不管是java程序还是其他的语言的程序,本人都使用它,方便好用,速度快.如果配置好的话,可 ...
哈尔滨java开发工资_给哈尔滨Java开发初学者的几个学习建议
对于初学者应该如何学习Java开发技术,纵观中国目前整体行业来说,互联网IT行业成为了拔尖的行业,IT互联网程序开发成了靠自己能力可以多挣一点钱,所以各个行业都在转行,其实互联网不存在饱和,只不过大多 ...
VMware vSphere Web Services SDK编程指南（二）-Java 开发设置
Java 开发设置这节说明如何设置开发java客户端的开发环境. 主要包括以下内容: ■ Java 开发的各项要求 ■ java 开发设置 ■ 生成存根和编译类文件 ■ 运行 SimpleClien ...
java的flex开发_繁忙的Flex Java开发人员指南
java的flex开发除非您在过去的四年左右的时间里一直从相当大的巨石下面编写代码,否则对于所有出色的孩子来说,"富Internet应用程序"或" RIA"的 ...
java 集成开发工具_最好的Java开发人员测试和集成工具
java 集成开发工具通过从您的应用程序学习企业APM产品,发现更快,更有效的性能监控. 参加AppDynamics APM导览! 无论您是刚刚起步还是已经从事了一段时间,使用正确的工具进行编程都可 ...
java开发面试复试_面试java开发，面试官会问哪些问题？
作为一个当初从学校刚毕业找工作而被面试饱经摧残的小白,到现在的java开发从业人员,中间不可谓之不艰辛,当初的屡屡碰壁,工作受挫,一直到现在我仍然认为那是我人生中不可或缺的一段经历. 关于面试的艰辛这 ...

开发指南：BUMO 资产发行 JAVA 开发指南