开发指南:BUMO,智能合约,Java,开发指南x
开发指南:BUMO 智能合约 Java 开发指南 BUMO 智能合约 Java 开发指南 概述 合约是一段 JavaScript 代码,标准( ECMAScript
as specified in ECMA-262 )。合约的初始化函数是 init , 执行的入口函数是 main 函数,您写的合约代码中必须有 init和 main 函数的定义。该函数的入参是字符串 input ,是调用该合约的时候指定的。
介绍。
的语法,请看合约语法。
• 详细的合约编辑器的用户手册,请看合约编辑器的介绍。
本章节介绍了三个基于 Java 语言的智能合约开发实例场景,三个场景都是相关联的。
一创建 二触发 • 实例场景三主要实现合约的查询功能。
实例场景都是基于以下遵循 CTP 1.0 协议的智能合约代码,该代码来自 contractBasedToken.js 。
"use strict";
let globalAttribute = {};
const globalAttributeKey = "global_attribute";
function makeAllowanceKey(owner, spender){
return "allow_" + owner + "_to_" + spender;
}
function approve(spender, value){
assert(addressCheck(spender) === true, "Arg-spender is not a valid address.");
assert(stoI64Check(value) === true, "Arg-value must be alphanumeric.");
assert(int64Compare(value, "0") > 0, "Arg-value of spender " + spender + " must be greater than 0.");
let key = makeAllowanceKey(sender, spender);
storageStore(key, value);
tlog("approve", sender, spender, value);
return true;
}
function allowance(owner, spender){
assert(addressCheck(owner) === true, "Arg-owner is not a valid address.");
assert(addressCheck(spender) === true, "Arg-spender is not a valid address.");
let key = makeAllowanceKey(owner, spender);
let value = storageLoad(key);
assert(value !== false, "Failed to get the allowance given to " + spender + " by " + owner + " from metadata.");
return value;
}
function transfer(to, value){
assert(addressCheck(to) === true, "Arg-to is not a valid address.");
assert(stoI64Check(value) === true, "Arg-value must be alphanumeric.");
assert(int64Compare(value, "0") > 0, "Arg-value must be greater than 0.");
if(sender === to) {
tlog("transfer", sender, to, value);
return true;
}
let senderValue = storageLoad(sender);
assert(senderValue !== false, "Failed to get the balance of " + sender + " from metadata.");
assert(int64Compare(senderValue, value) >= 0, "Balance:" + senderValue + " of sender:" + sender + " < transfer value:" + value + ".");
let toValue = storageLoad(to);
toValue = (toValue === false) ? value : int64Add(toValue, value);
storageStore(to, toValue);
senderValue = int64Sub(senderValue, value);
storageStore(sender, senderValue);
tlog("transfer", sender, to, value);
return true;
}
function transferFrom(from, to, value){
assert(addressCheck(from) === true, "Arg-from is not a valid address.");
assert(addressCheck(to) === true, "Arg-to is not a valid address.");
assert(stoI64Check(value) === true, "Arg-value must be alphanumeric.");
assert(int64Compare(value, "0") > 0, "Arg-value must be greater than 0.");
if(from === to) {
tlog("transferFrom", sender, from, to, value);
return true;
}
let fromValue = storageLoad(from);
assert(fromValue !== false, "Failed to get the value, probably because " + from + " has no value.");
assert(int64Compare(fromValue, value) >= 0, from + " Balance:" + fromValue + " < transfer value:" + value + ".");
let allowValue = allowance(from, sender);
assert(int64Compare(allowValue, value) >= 0, "Allowance value:" + allowValue + " < transfer value:" + value + " from " + from + " to " + to
+ ".");
let toValue = storageLoad(to);
toValue = (toValue === false) ? value : int64Add(toValue, value);
storageStore(to, toValue);
fromValue = int64Sub(fromValue, value);
storageStore(from, fromValue);
let allowKey = makeAllowanceKey(from, sender);
allowValue
= int64Sub(allowValue, value);
storageStore(allowKey, allowValue);
tlog("transferFrom", sender, from, to, value);
return true;
}
function balanceOf(address){
assert(addressCheck(address) === true, "Arg-address is not a valid address.");
let value = storageLoad(address);
assert(value !== false, "Failed to get the balance of " + address + " from metadata.");
return value;
}
function init(input_str){
let params = JSON.parse(input_str).params;
assert(stoI64Check(params.totalSupply) === true && params.totalSupply > 0 &&
typeof params.name === "string" && params.name.length > 0 &&
typeof params.symbol === "string" && params.symbol.length > 0 &&
typeof params.decimals === "number" && params.decimals >= 0,
"Failed to check args");
globalAttribute.totalSupply = params.totalSupply;
globalAttribute.name = params.name;
globalAttribute.symbol = params.symbol;
globalAttribute.version = "ATP20";
globalAttribute.decimals = params.decimals;
storageStore(globalAttributeKey, JSON.stringify(globalAttribute));
storageStore(sender, globalAttribute.totalSupply);
}
function main(input_str){
let input = JSON.parse(input_str);
if(input.method === "transfer"){
transfer(input.params.to, input.params.value);
}
else if(input.method === "transferFrom"){
transferFrom(input.params.from, input.params.to, input.params.value);
}
else if(input.method === "approve"){
approve(input.params.spender, input.params.value);
}
else{
throw "<Main interface passes an invalid operation type>";
}
}
function query(input_str){
let result = {};
let input
= JSON.parse(input_str);
if(input.method === "tokenInfo"){
globalAttribute = JSON.parse(storageLoad(globalAttributeKey));
result.tokenInfo = globalAttribute;
}
else if(input.method === "allowance"){
result.allowance = allowance(input.params.owner, input.params.spender);
}
else if(input.method === "balanceOf"){
result.balance = balanceOf(input.params.address);
}
else{
throw "<Query interface passes an invalid operation type>";
}
return JSON.stringify(result);
}
实例场景一 该示例主要实现合约的创建功能。线上 demo 请看: CreateContractDemo.java。
某资方在 BuChain 上基于 ATP 2.0 发行代码为 CGO、名称为 Contract Global、总发行量为 10 亿的智能合约币种,具体信息如下:
字段 是否必填 示例 描述 name Contract Global 名称 symbol CGO 代码 decimals 8 币种精度 totalSupply 是 1000000000 资产总发行量 本场景的具体执行过程包括 验证代码是否有效、文本压缩、创建 SDK 实例-1、创建资方账户、激活资方账户、获取资方账户的序列号-1、组装创建合约账户并发行CGO 代币操作、序列化交易-1、签名交易-1、发送交易-1、查询交易是否执行成功-1。
验证代码是否有效 打开在线检测页面: bumo-jslint,将上面的智能合约代码拷贝到编辑框中,点击 JSLint 按钮,这里提示智能合约代码没有问题。
如果出现背景是红色的 warning 提示,表示语法有问题,如下图:
如果没有语法问题,弹出的提示如下图:
文本压缩 打开在线文本压缩页面: 第三方工具 ,将验证无误的智能合约代码拷贝到页面中的编辑框中,然后点击 压缩 按钮,将压缩后的字符串拷贝下来,如下图:
创建 SDK 实例-1 创建实例并设置 url (部署的某节点的 IP 和端口)。
网络环境 IP Port 区块链浏览器 主网 .io 1.io 测试 seed1.bumotest.io 26002 https://explorer.bumotest.io 代码示例:
String url = "http://seed1.bumotest.io:26002";
SDK sdk = SDK.getInstance(url);
在 BuChain 网络里,每个区块产生的时间是 10 秒,每个交易只需要一次确认即可得到交易终态。
创建资方账户 创建资方账户的代码如下:
public static AccountCreateResult createAccount() {
AccountCreateResponse response = sdk.getAccountService().create();
if (response.getErrorCode() != 0) {
return null;
}
return response.getResult();
}
创建账户的返回值如下:
AccountCreateResult
address: buQkSyTRbsjVZrTjxQkVdEwDx3HEBHSu9N4X
privateKey: privbyYK6NwBJbcgK9yGx6tQ7swXG45t4WT7fgS29Y8v8Cyd2NZeLKXG
publicKey: b001526ae8b7542c9c84583e926705ff4f27725e2c5ce63dce07e4d22186fb43304a02ab6fce
注意 注意:通过该方式创建的账户是未被激活的账户。
激活资方账户 账户未被激活时需要通过已被激活(已上链)的账户进行激活。已被激活的资方账户请跳过本节内容。
注意 注意:
• 主网环境:账户激活可以通过小布口袋(钱包)给该资方账户转 10.09 BU(用于支付资产发行时需要的交易费用),即可激活该账户。
• 测试环境:资方可访问水龙头,将待激活(或待充值)的账户地址输入到编辑框中,点 Confirm 即可完成激活(或充值)。
获取资方账户的序列号-1 每个账户都维护着自己的序列号,该序列号从 1 开始,依次递增,一个序列号标志着一个该账户的交易。获取资方账号(这里的账户地址是buQYLtRq4j3eqbjVNGYkKYo3sLBqW3TQH2xH )序列号的代码如下:
public long getAccountNonce() {
long nonce = 0;
// Init request
String accountAddress = "buQYLtRq4j3eqbjVNGYkKYo3sLBqW3TQH2xH";
AccountGetNonceRequest request = new AccountGetNonceRequest();
request.setAddress(accountAddress);
// Call getNonce
AccountGetNonceResponse response = sdk.getAccountService().getNonce(request);
if (0 == response.getErrorCode()) {
nonce = response.getResult().getNonce();
} else {
System.out.println("error: " + response.getErrorDesc());
}
return nonce;
}
返回值如下:
nonce: 6
注意 注意:
如果查询不到某账户,则表示该账户未激活。
组装创建合约账户并发行 CGO 代币操作 代码中将压缩好的合约代码赋值给 payload
变量,具体代码如下:
public BaseOperation[] buildOperations() {
// The account address to issue apt1.0 token
String createContractAddress = "buQYLtRq4j3eqbjVNGYkKYo3sLBqW3TQH2xH";
// Contract account initialization BU,the unit is MO,and 1 BU = 10^8 MO
Long initBalance = ToBaseUnit.BU2MO("0.01");
// The token name
String name = "Contract Global";
// The token code
String symbol = "CGO";
// The token total supply, which includes the dicimals.
// If decimals is 8 and you want to issue 10 tokens now, the nowSupply must be 10 * 10 ^ 8, like below.
String totalSupply = "1000000000";
// The token decimals
Integer decimals = 8;
// Contract code
String payload = ""use strict";let globalAttribute={};const globalAttributeKey="global_attribute";function makeAllowanceKey(owner,spender){return"allow_"+owner+"_to_"+spender;}function approve(spender,value){assert(addressCheck(spender)===true,"Arg-spender is not a valid address.");assert(stoI64Check(value)===true,"Arg-value must be alphanumeric.");assert(int64Compare(value,"0")>0,"Arg-value of spender "+spender+" must be greater than 0.");let key=makeAllowanceKey(sender,spender);storageStore(key,value);tlog("approve",sender,spender,value);return true;}function allowance(owner,spender){assert(addressCheck(owner)===true,"Arg-owner is not a valid address.");assert(addressCheck(spender)===true,"Arg-spender is not a valid address.");let key=makeAllowanceKey(owner,spender);let value=storageLoad(key);assert(value!==false,"Failed to get the allowance given to "+spender+" by "+owner+" from metadata.");return value;}function transfer(to,value){assert(addressCheck(to)===true,"Arg-to i
s not a valid address.");assert(stoI64Check(value)===true,"Arg-value must be alphanumeric.");assert(int64Compare(value,"0")>0,"Arg-value must be greater than 0.");if(sender===to){tlog("transfer",sender,to,value);return true;}let senderValue=storageLoad(sender);assert(senderValue!==false,"Failed to get the balance of "+sender+" from metadata.");assert(int64Compare(senderValue,value)>=0,"Balance:"+senderValue+" of sender:"+sender+" < transfer value:"+value+".");let toValue=storageLoad(to);toValue=(toValue===false)?value:int64Add(toValue,value);storageStore(to,toValue);senderValue=int64Sub(senderValue,value);storageStore(sender,senderValue);tlog("transfer",sender,to,value);return true;}function transferFrom(from,to,value){assert(addressCheck(from)===true,"Arg-from is not a valid address.");assert(addressCheck(to)===true,"Arg-to is not a valid address.");assert(stoI64Check(value)===true,"Arg-value must be alphanumeric.");assert(int64Compare(value,"0")>0,"Arg-value must be greater than 0.");if(from===to){tlog("transferFrom",sender,from,to,value);return true;}let fromValue=storageLoad(from);assert(fromValue!==false,"Failed to get the value, probably because "+from+" has no value.");assert(int64Compare(fromValue,value)>=0,from+" Balance:"+fromValue+" < transfer value:"+value+".");let allowValue=allowance(from,sender);assert(int64Compare(allowValue,value)>=0,"Allowance value:"+allowValue+" < transfer value:"+value+" from "+from+" to "+to+".");let toValue=storageLoad(to);toValue=(toValue===false)?value:int64Add(toValue,value);storageStore(to,toValue);fromValue=int64Sub(fromValue,value);storageStore(from,fromValue);let allowKey=makeAllowanceKey(from,sender);allowValue=int64Sub(allowValue,value);storageStore(allowKey,allowValue);tlog("transferFrom",sender,from,to,value);return true;}function balanceOf(address){assert(addressCheck(address)===true,"Arg-address is not a valid address.");let value=storageLoad(address);assert(value!==false,"Failed to get the balance of "+address+" from metadata.");return value;}function init(input_str){let params=JSON.parse(input_str).params;assert(stoI64Check(params.totalSupply)===true&&params.totalSupply>0&&typeof params.name==="string"&&params.name.length>0&&typeof params.symbol==="string"&&params.symbol.length>0&&typeof params.decimals==="number"&&params.decimals>=0,"Failed to check args");globalAttribute.totalSupply=params.totalSupply;globalAttribute.name=params.name;globalAttribute.symbol=params.symbol;globalAttribute.version="ATP20";globalAttribute.decimals=params.decimals;storageStore(globalAttributeKey,JSON.stringify(globalAttribute));storageStore(sender,globalAttribute.totalSupply);}function main(input_str){let input=JSON.parse(input_str);if(input.method==="transfer"){transfer(input.params.to,input.params.value);}else if(input.method==="transferFrom"){transferFrom(input.params.from,input.params.to,input.params.value);}else if(input.method==="approve"){approve(input.params.spender,input.params.value);}else{throw"<Main interface passes an invalid operation type>";}}function query(input_str){let result={};let input=JSON.parse(input_str);if(input.method==="tokenInfo"){globalAttribute=JSON.parse(storageLoad(globalAttributeKey));result.tokenInfo=globalAttribute;}else if(input.method==="allowance"){result.allowance=allowance(input.params.owner,input.params.spender);}else if(input.method==="balanceOf"){result.balance=balanceOf(input.params.address);}else{throw"<Query interface passes an invalid operation type>";}return JSON.stringify(result);}";
// Init initInput
JSONObject initInput = new JSONObject();
JSONObject params = new JSONObject();
params.put("name", name);
params.put("symbol", symbol);
params.put("decimals", decimals);
params.put("totalSupply", totalSupply);
initInput.put("params", params);
// Build create contract operation
ContractCreateOperation contractCreateOperation = new ContractCreateOperation();
contractCreateOperation.setSourceAddress(createContractAddress);
contractCreateOperation.setInitBalance(initBalance);
contractCreateOperation.setPayload(payload);
contractCreateOperation.setInitInput(initInput.toJSONString());
contractCreateOperation.setMetadata("create ctp 1.0 contract");
BaseOperation[] operations = { contractCreateOperation };
return operations;
}
序列化交易-1 序列化交易即将交易序列化以便网络传输。
注意 注意:
• feeLimit: 本次交易发起方最多支付本次交易的交易费用,发行资产操作请填写 10.08BU。
• nonce: 本次交易发起方的交易序列号,该值由当前账户的 nonce 值加 1 得到。
序列化交易的具体代码如下,示例中的参数 nonce
是调用 getAccountNonce
得到的账户序列号,参数 operations
是调用 buildOperations
得到发行资产的操作。
public String seralizeTransaction(Long nonce,
BaseOperation[] operations) {
String transactionBlob = null;
// The account address to create contract and issue ctp 1.0 token
String senderAddresss = "buQYLtRq4j3eqbjVNGYkKYo3sLBqW3TQH2xH";
// The gasPrice is fixed at 1000L, the unit is MO
Long gasPrice = 1000L;
// Set up the maximum cost 10.08BU
Long feeLimit = ToBaseUnit.BU2MO("10.08");
// Nonce should add 1
nonce += 1;
// Build transaction
Blob
TransactionBuildBlobRequest 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: 0A24627551594C745271346A336571626A564E47596B4B596F33734C4271573354514832784810071880B8D3E00320E8073AC42408011224627551594C745271346A336571626A564E47596B4B596F33734C427157335451483278481A176372656174652063747020312E3020636F6E74726163742280241295231292232775736520737472696374273B6C657420676C6F62616C4174747269627574653D7B7D3B636F6E737420676C6F62616C4174747269627574654B65793D27676C6F62616C5F617474726962757465273B66756E6374696F6E206D616B65416C6C6F77616E63654B6579286F776E65722C7370656E646572297B72657475726E27616C6C6F775F272B6F776E65722B275F746F5F272B7370656E6465723B7D66756E6374696F6E20617070726F7665287370656E6465722C76616C7565297B6173736572742861646472657373436865636B287370656E646572293D3D3D747275652C274172672D7370656E646572206973206E6F7420612076616C696420616464726573732E27293B6173736572742873746F493634436865636B2876616C7565293D3D3D747275652C274172672D76616C7565206D75737420626520616C7068616E756D657269632E27293B61737365727428696E743634436F6D706172652876616C75652C273027293E302C274172672D76616C7565206F66207370656E64657220272B7370656E6465722B27206D7573742062652067726561746572207468616E20302E27293B6C6574206B65793D6D616B65416C6C6F77616E63654B65792873656E6465722C7370656E646572293B73746F7261676553746F7265286B65792C76616C7565293B746C6F672827617070726F7665272C73656E6465722C7370656E6465722C76616C7565293B72657475726E20747275653B7D66756E6374696F6E20616C6C6F77616E6365286F776E65722C7370656E646572297B6173736572742861646472657373436865636B286F776E6572293D3D3D747275652C274172672D6F776E6572206973206E6F7420612076616C696420616464726573732E27293B6173736572742861646472657373436865636B287370656E646572293D3D3D747275652C274172672D7370656E646572206973206E6F7420612076616C696420616464726573732E27293B6C6574206B65793D6D616B65416C6C6F77616E63654B6579286F776E65722C7370656E646572293B6C65742076616C75653D73746F726167654C6F6164286B6579293B
6173736572742876616C7565213D3D66616C73652C274661696C656420746F206765742074686520616C6C6F77616E636520676976656E20746F20272B7370656E6465722B2720627920272B6F776E65722B272066726F6D206D657461646174612E27293B72657475726E2076616C75653B7D66756E6374696F6E207472616E7366657228746F2C76616C7565297B6173736572742861646472657373436865636B28746F293D3D3D747275652C274172672D746F206973206E6F7420612076616C696420616464726573732E27293B6173736572742873746F493634436865636B2876616C7565293D3D3D747275652C274172672D76616C7565206D75737420626520616C7068616E756D657269632E27293B61737365727428696E743634436F6D706172652876616C75652C273027293E302C274172672D76616C7565206D7573742062652067726561746572207468616E20302E27293B69662873656E6465723D3D3D746F297B746C6F6728277472616E73666572272C73656E6465722C746F2C76616C7565293B72657475726E20747275653B7D6C65742073656E64657256616C75653D73746F726167654C6F61642873656E646572293B6173736572742873656E64657256616C7565213D3D66616C73652C274661696C656420746F20676574207468652062616C616E6365206F6620272B73656E6465722B272066726F6D206D657461646174612E27293B61737365727428696E743634436F6D706172652873656E64657256616C75652C76616C7565293E3D302C2742616C616E63653A272B73656E64657256616C75652B27206F662073656E6465723A272B73656E6465722B27203C207472616E736665722076616C75653A272B76616C75652B272E27293B6C657420746F56616C75653D73746F726167654C6F616428746F293B746F56616C75653D28746F56616C75653D3D3D66616C7365293F76616C75653A696E74363441646428746F56616C75652C76616C7565293B73746F7261676553746F726528746F2C746F56616C7565293B73656E64657256616C75653D696E7436345375622873656E64657256616C75652C76616C7565293B73746F7261676553746F72652873656E6465722C73656E64657256616C7565293B746C6F6728277472616E73666572272C73656E6465722C746F2C76616C7565293B72657475726E20747275653B7D66756E6374696F6E207472616E7366657246726F6D2866726F6D2C746F2C76616C7565297B6173736572742861646472657373436865636B2866726F6D293D3D3D747275652C274172672D66726F6D206973206E6F7420612076616C696420616464726573732E27293B6173736572742861646472657373436865636B28746F293D3D3D747275652C274172672D746F206973206E6F7420612076616C696420616464726573732E27293B6173736572742873746F493634436865636B2876616C7565293D3D3D747275652C274172672D76616C7565206D75737420626520616C7068616E756D657269632E27293B61737365727428696E743634436F6D706172652876616C75652C273027293E302C274172672D76616C7565206D7573742062652067726561746572207468616E20302E27293B69662866726F6D3D3D3D746F297B746C6F6728277472616E7366657246726F6D272C73656E6465722C66726F6D2C746F2C76616C7565293B72657475726E20747275653B7D6C65742066726F6D56616C75653D73746F726167654C6F61642866726F6D293B6173736572742866726F6D56616C7565213D3D66616C73652C274661696C656420746F20676574207468652076616C75652C2070726F6261626C79206265636175736520272B66726F6D2B2720686173206E6F2076616C75652E27293B61737365727428696E743634436F6D706172652866726F6D56616C75652C76616C7565293E3D302C66726F6D2B272042616C616E63653A272B66726F6D56616C75652B27203C207472616E736665722076616C75653A272B76616C75652B272E27293B6C657420616C6C6F7756616C75653D616C6C6F77616E63652866726F6D2C73656E646572293B61737365727428696E743634436F6D7061726528616C6C6F7756616C75652C76616C7565293E3D302C27416C6C6F77616E63652076616C75653A272B616C6C6F7756616C75652B27203C207472616E736665722076616C75653A272B76616C75652B272066726F6D20272B66726F6D2B2720746F20272B746F2B272E27293B6C657420746F56616C75653D73746F726167654C6F616428746F293B746F56616C75653D28746F56616C75653D3D3D66616C7365293F76616C75653A696E74363441646428746F56616C75652C76616C7565293B73746F7261676553746F726528746F2C746F56616C7565293B66726F6D56616C75653D696E7436345375622866726F6D56
616C75652C76616C7565293B73746F7261676553746F72652866726F6D2C66726F6D56616C7565293B6C657420616C6C6F774B65793D6D616B65416C6C6F77616E63654B65792866726F6D2C73656E646572293B616C6C6F7756616C75653D696E74363453756228616C6C6F7756616C75652C76616C7565293B73746F7261676553746F726528616C6C6F774B65792C616C6C6F7756616C7565293B746C6F6728277472616E7366657246726F6D272C73656E6465722C66726F6D2C746F2C76616C7565293B72657475726E20747275653B7D66756E6374696F6E2062616C616E63654F662861646472657373297B6173736572742861646472657373436865636B2861646472657373293D3D3D747275652C274172672D61646472657373206973206E6F7420612076616C696420616464726573732E27293B6C65742076616C75653D73746F726167654C6F61642861646472657373293B6173736572742876616C7565213D3D66616C73652C274661696C656420746F20676574207468652062616C616E6365206F6620272B616464726573732B272066726F6D206D657461646174612E27293B72657475726E2076616C75653B7D66756E6374696F6E20696E697428696E7075745F737472297B6C657420706172616D733D4A534F4E2E706172736528696E7075745F737472292E706172616D733B6173736572742873746F493634436865636B28706172616D732E746F74616C537570706C79293D3D3D747275652626706172616D732E746F74616C537570706C793E302626747970656F6620706172616D732E6E616D653D3D3D27737472696E67272626706172616D732E6E616D652E6C656E6774683E302626747970656F6620706172616D732E73796D626F6C3D3D3D27737472696E67272626706172616D732E73796D626F6C2E6C656E6774683E302626747970656F6620706172616D732E646563696D616C733D3D3D276E756D626572272626706172616D732E646563696D616C733E3D302C274661696C656420746F20636865636B206172677327293B676C6F62616C4174747269627574652E746F74616C537570706C793D706172616D732E746F74616C537570706C793B676C6F62616C4174747269627574652E6E616D653D706172616D732E6E616D653B676C6F62616C4174747269627574652E73796D626F6C3D706172616D732E73796D626F6C3B676C6F62616C4174747269627574652E76657273696F6E3D274154503230273B676C6F62616C4174747269627574652E646563696D616C733D706172616D732E646563696D616C733B73746F7261676553746F726528676C6F62616C4174747269627574654B65792C4A534F4E2E737472696E6769667928676C6F62616C41747472696275746529293B73746F7261676553746F72652873656E6465722C676C6F62616C4174747269627574652E746F74616C537570706C79293B7D66756E6374696F6E206D61696E28696E7075745F737472297B6C657420696E7075743D4A534F4E2E706172736528696E7075745F737472293B696628696E7075742E6D6574686F643D3D3D277472616E7366657227297B7472616E7366657228696E7075742E706172616D732E746F2C696E7075742E706172616D732E76616C7565293B7D656C736520696628696E7075742E6D6574686F643D3D3D277472616E7366657246726F6D27297B7472616E7366657246726F6D28696E7075742E706172616D732E66726F6D2C696E7075742E706172616D732E746F2C696E7075742E706172616D732E76616C7565293B7D656C736520696628696E7075742E6D6574686F643D3D3D27617070726F766527297B617070726F766528696E7075742E706172616D732E7370656E6465722C696E7075742E706172616D732E76616C7565293B7D656C73657B7468726F77273C4D61696E20696E746572666163652070617373657320616E20696E76616C6964206F7065726174696F6E20747970653E273B7D7D66756E6374696F6E20717565727928696E7075745F737472297B6C657420726573756C743D7B7D3B6C657420696E7075743D4A534F4E2E706172736528696E7075745F737472293B696628696E7075742E6D6574686F643D3D3D27746F6B656E496E666F27297B676C6F62616C4174747269627574653D4A534F4E2E70617273652873746F726167654C6F616428676C6F62616C4174747269627574654B657929293B726573756C742E746F6B656E496E666F3D676C6F62616C4174747269627574653B7D656C736520696628696E7075742E6D6574686F643D3D3D27616C6C6F77616E636527297B726573756C742E616C6C6F77616E63653D616C6C6F77616E636528696E7075742E706172616D732E6F776E65722C696E7075742E706172616D732E7370656E646572293B7D656C736520696628696E7075742E6D6574686F
643D3D3D2762616C616E63654F6627297B726573756C742E62616C616E63653D62616C616E63654F6628696E7075742E706172616D732E61646472657373293B7D656C73657B7468726F77273C517565727920696E746572666163652070617373657320616E20696E76616C6964206F7065726174696F6E20747970653E273B7D72657475726E204A534F4E2E737472696E6769667928726573756C74293B7D1A041A02080128C0843D325C7B22706172616D73223A7B2273796D626F6C223A2243474F222C22746F74616C537570706C79223A2231303030303030303030222C22646563696D616C73223A382C226E616D65223A22436F6E747261637420476C6F62616C227D7D
签名交易-1 所有的交易都需要对其进行签名,签名完成后交易才能生效。签名结果包括签名数据和公钥。
签名交易的具体代码如下,示例中的参数 transactionBlob
是调用 seralizeTransaction
得到的序列化交易字符串。
public Signature[] signTransaction(String transactionBlob) {
Signature[] signatures = null;
// The account private key to create contract and issue ctp 1.0 token
String senderPrivateKey = "privbs4iBCugQeb2eiycU8RzqkPqd28eaAYrRJGwtJTG8FVHjwAyjiyC";
// Sign transaction BLob
TransactionSignRequest 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: 37C3EEF6FDA7CBF9AFDFAA038EE9444886F37563E5897B65F719FEB3B216E485D11A5AD31255F3DFFE533C1AA16DE9F23C73E51CF94368FDF2C5638D25D23D07
publicKey: b00135e99d67a4c2e10527f766e08bc6afd4420951628149042fdad6584a5321c23c716a528b
发送交易-1 发送交易即将序列化的交易和签名发送到 BuChain。
发送交易具体代码如下,示例中的参数 transactionBlob 是调用 seralizeTransaction
得到的序列化交易字符串, signatures
是调用 signTransaction
得到的签名数据。
public String submitTransaction(String transactionBlob, Signature[] signatures) {
String
hash = null;
// Submit transaction
TransactionSubmitRequest 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: ac296754120911c47fb0e83d0df0c0ae82e32e9822a4a92d910886d9303b015e
查询交易是否执行成功-1 注意 注意:
发送交易返回的结果只是交易是否提交成功的结果,而交易是否执行成功的结果需要执行如下操作进行查询, 具体有两种方法:
区块链浏览器查询-1 在 BUMO 区块链浏览器中查询上面的 hash,主网,测试网,操作如下图:
查询结果如下:
调用接口查询-1 调用接口查询的代码如下,示例中的参数 txHash 是调用 submitTransaction
得到的交易哈希(交易的惟一标识)。
public int checkTransactionStatus(String txHash) {
// Init request
TransactionGetInfoRequest request = new TransactionGetInfoRequest();
request.setHash(txHash);
// Call getInfo
TransactionGetInfoResponse 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 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 bexecuted 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 ublic key 91 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 0 Low reserve in the account 1 Sender and receiver accounts are the same 2 The target account already exists 103 Accounts do not exist
4 Low reserve in the account 5 Amount of assets exceeds the limitation ( int64 ) 106 Insufficient initial reserve for account creation 1 Low transaction fee 114 TX buffer is full 0 weight 121 threshold 4 Invalid data version of metadata 146 exceeds upper limitation 1 contract execution 2 Failure in syntax analysis 3 The depth of contract recursion exceeds upper limitation 4 the TX submitted from the contract exceeds upper limitation 155 Contract expired 160 Fail to insert the TX into buffer 60 BlockNumber must bigger than 0 117 Failed to connect to the network 121 Request parameter cannot be null 20000 System error 实例场景二 该实例主要实现合约的触发功能。线上 demo 请看: TriggerContractDemo.java。
资方 buQYLtRq4j3eqbjVNGYkKYo3sLBqW3TQH2xH
在 BuChain 上通过智能合约账户 buQcEk2dpUv6uoXjAqisVRyP1bBSeWUHCtF2
分配给自己 20000 CGO, 并将 10000 CGO 转移给另一个账户 buQXPeTjT173kagZ7j8NWAPJAgJCpJHFdyc7 。
本场景的具体执行过程包括 :创建 SDK 实例-2、获取资方账户的序列号-2、组装分配 CGO 和转移 CGO、序列化交易-2、签名交易-2、发送交易-2、查询交易是否执行成功-2。
创建 SDK 实例-2 创建实例并设置 url (部署的某节点的 IP 和端口)。
String url = "http://seed1.bumotest.io:26002";
SDK sdk = SDK.getInstance(url);
在 BuChain 网络里,每个区块产生时间是 10 秒,每个交易只需要一次确认即可得到交易终态。
环境说明如下:
网络环境 IP Port 区块链浏览器 主网 .io 1.io 测试 seed1.bumotest.io 26002 https://explorer.bumotest.io 获取资方账户的序列号-2 每个账户都维护着自己的序列号,该序列号从 1 开始,依次递增,一个序列号标志着一个该账户的交易。
获取资方账号序列号的代码如下:
public long getAccountNonce() {
long nonce = 0;
// Init request
String accountAddress = [资方账户地址];
AccountGetNonceRequest request = new AccountGetNonceRequest();
request.setAddress(accountAddress);
// Call getNonce
AccountGetNonceResponse response = sdk.getAccountService().getNonce(request);
if (0 == response.getErrorCode()...