账户接口

本节主要介绍在操作账户时所涉及的一些接口参数。

创建账户

createAccount

创建账户，同步方式调用。

  • 函数原型
  1. public MychainBase<ReplyTransactionReceipt> createAccount(CreateAccountRequest request)
  • 请求参数
参数 必选 类型 说明
request true CreateAccountRequest 创建账户的请求
  • 返回字段
返回字段 字段类型 说明
result MychainBase< ReplyTransactionReceipt> MychainBaseResult持有所有 response 类型。
  • 示例
  1. MychainBase<ReplyTransactionReceipt> result = sdk.getAccountService().createAccount(
  2.     CreateAccountRequest.build(
  3.             adminAccount.getIdentity(), testAccount1, params
  4.     )
  5. );

asyncCreateAccount

创建账户，异步方式调用。

  • 函数原型
  1. public MychainBase<Response> asyncCreateAccount(CreateAccountRequest request, ICallback callback)
  • 请求参数
参数 必选 类型 说明
request true CreateAccountRequest 创建账户的请求
callback true ICallback 回调函数
  • 返回字段
返回字段 字段类型 说明
result MychainBaseResult MychainBaseResult 持有所有 response 类型。
  • 示例
  1. MychainBase<Response> result = sdk.getAccountService().asyncCreateAccount(
  2.             CreateAccountRequest.build(adminAccount.getIdentity(), testAccount3, params),
  3.             new ICallback() {
  4.                 @Override
  5.                 public void onResponse(String txHash, Response response) {
  6.                     System.out.println("async create account, txHash:" + txHash + ", result: " + response.getErrorCode());
  7.                 }
  8.             });

CreateAccountRequest

创建账户所需要的参数：

参数 类型 说明
account Account 待创建者账户
fromAccountId Identity 创建者账户 ID
mychainParams MychainParams 接口通用扩展参数

转账

transferBalance

交易转帐，同步方式调用。

  • 函数原型
  1. public MychainBase<ReplyTransactionReceipt> transferBalance(TransferBalanceRequest request)
  • 请求参数
参数 必选 类型 说明
request true TransferBalanceRequest 交易转帐的请求
  • 返回字段
返回字段 字段类型 说明
result MychainBaseResult MychainBaseResult 持有所有 response 类型。
  • 示例
  1. // 准备参数 params
  2. MychainParams params = new MychainParams.Builder()
  3.   .gas(BigInteger.valueOf(40000))
  4.   .privateKeyList(adminPrivateKeys)
  5.   .build();
  7. //转移余额
  8. MychainBase<ReplyTransactionReceipt> result = sdk.getAccountService().transferBalance(
  9.     TransferBalanceRequest.build(testAccount1.getIdentity(),
  10.         testAccount2.getIdentity(),
  11.         new BigInteger(transferAmount+""),
  12.         params
  13.     )
  14. );

asyncTransferBalance

交易转帐，异步方式调用。

  • 函数原型
  1. public MychainBase<Response> asyncTransferBalance(TransferBalanceRequest request, ICallback callback)
  • 请求参数
参数 必选 类型 说明
request true TransferBalanceRequest 交易转帐的请求
callback true ICallback 回调函数
  • 返回字段
返回字段 字段类型 说明
result MychainBaseResult MychainBaseResult 持有所有 response 类型。
  • 示例
  1. // 准备参数 params
  2. MychainParams params = new MychainParams.Builder()
  3.   .gas(BigInteger.valueOf(40000))
  4.   .privateKeyList(adminPrivateKeys)
  5.   .build();
  7. // 异步传输余额
  8. MychainBase<Response> result = sdk.getAccountService().asyncTransferBalance(
  9.     TransferBalanceRequest.build(testAccount2.getIdentity(),
  10.         testAccount1.getIdentity(),
  11.         new BigInteger(transferAmount+""),
  12.         params),
  13.     (txHash, response) -> {
  14.         System.out.println("async transfer balance, txHash:"+txHash+", result: "+ response.getErrorCode());
  15.     }
  16. );

TransferBalanceRequest

转账所需要的参数：

参数 类型 说明
fromAcctId Identity 转出账户
toAcctId Identity 转入账户
amount BigInteger 转账金额
mychainParams MychainParams 通用参数

设置恢复公钥

setRecoverKey

设置恢复公钥，同步方式调用。

  • 函数原型
  1. public MychainBase<ReplyTransactionReceipt> setRecoverKey(SetRecoverKeyRequest request)
  • 请求参数
参数 必选 类型 说明
request true SetRecoverKeyRequest 恢复公钥的请求
  • 返回字段
返回字段 字段类型 说明
result MychainBaseResult MychainBaseResult 持有所有 response 类型
  • 示例
  1. // 准备参数 params
  2. MychainParams params = new MychainParams.Builder()
  3.   .gas(BigInteger.valueOf(40000))
  4.   .privateKeyList(adminPrivateKeys)
  5.   .build();
  7. MychainBase<ReplyTransactionReceipt> result = sdk.getAccountService().setRecoverKey(
  8.             SetRecoverKeyRequest.build(testAccount1.getIdentity(), newRecoverKey, params));

asyncSetRecoverKey

设置恢复公钥，异步方式调用。

  • 函数原型
  1. public MychainBase<Response> asyncSetRecoverKey(SetRecoverKeyRequest request, ICallback callback)
  • 请求参数
参数 必选 类型 说明
request true SetRecoverKeyRequest 恢复公钥的请求
callback true ICallback 回调函数
  • 返回字段
返回字段 字段类型 说明
result MychainBase MychainBaseResult 持有所有 response 类型。
  • 示例
  1. // 准备参数 params
  2. MychainParams params = new MychainParams.Builder()
  3.   .gas(BigInteger.valueOf(40000))
  4.   .privateKeyList(adminPrivateKeys)
  5.   .build();
  7. MychainBase<Response> result = sdk.getAccountService().asyncSetRecoverKey(
  8.     SetRecoverKeyRequest.build(testAccount1.getIdentity(), newRecoverKey, params),
  9.     new ICallback() {
  10.         @Override
  11.         public void onResponse(String txHash, Response response) {
  12.             System.out.println("async set recover key, txHash:" + txHash + ", result: "
  13.                                + response.getErrorCode());
  14.         }
  15.     });

SetRecoverKeyRequest

重置恢复公钥所需要的参数：

参数 类型 说明
acctId Identity 要设置的账户 ID
recoverPubKey String 新的恢复公钥
mychainParams MychainParams 通用参数

预重置公钥

preResetPubKey

预重置公钥，同步方式调用。

  • 函数原型
  1. public MychainBase<ReplyTransactionReceipt> preResetPubKey(PreResetPubKeyRequest request)
  • 请求参数
参数 必选 类型 说明
request true PreResetPubKeyRequest 预重置公钥的请求
  • 返回字段
返回字段 字段类型 说明
result MychainBase MychainBaseResult 持有所有 response 类型。
  • 示例
  1. // 准备参数 params
  2. MychainParams params = new MychainParams.Builder()
  3.   .gas(BigInteger.valueOf(40000))
  4.   .privateKeyList(adminPrivateKeys)
  5.   .build();
  7. // 预重置
  8. MychainBase<ReplyTransactionReceipt> result = sdk.getAccountService().preResetPubKey(PreResetPubKeyRequest.build( acctId, params));

asyncPreResetPubKey

预重置公钥，异步方式调用。

  • 函数原型
  1. public MychainBase<Response> asyncPreResetPubKey(PreResetPubKeyRequest request, ICallback callback)
  • 请求参数
参数 必选 类型 说明
request true PreResetPubKeyRequest 预重置公钥的请求
callback true ICallback 回调函数
  • 返回字段
返回字段 字段类型 说明
result MychainBase MychainBaseResult 持有所有 response 类型。
  • 示例
  1. // 准备参数 params
  2. MychainParams params = new MychainParams.Builder()
  3.   .gas(BigInteger.valueOf(40000))
  4.   .privateKeyList(adminPrivateKeys)
  5.   .build();
  9. MychainBase<Response> response = sdk.getAccountService().asyncPreResetPubKey(
  10.     PreResetPubKeyRequest.build(accId, params), new ICallback() {
  11.         @Override
  12.         public void onResponse(String txHash, Response response) {
  14.         }
  15.     });

PreResetPubKeyRequest

预重置公钥所需要的参数：

参数 类型 说明
acctId Identity 要预重置的账户 ID
mychainParams MychainParams 通用参数

重置公钥

resetPubKey

重置公钥，同步方式调用。

  • 函数原型
  1. public MychainBase<ReplyTransactionReceipt> resetPubKey(ResetPubKeyRequest request)
  • 请求参数
参数 必选 类型 说明
request true ResetPubKeyTransaction 重置公钥的请求
  • 返回字段
返回字段 字段类型 说明
result MychainBase MychainBaseResult 持有所有 response 类型。
  • 示例
  1. // 准备参数 params
  2. MychainParams params = new MychainParams.Builder()
  3.   .gas(BigInteger.valueOf(40000))
  4.   .privateKeyList(adminPrivateKeys)
  5.   .build();
  8. // 重置公钥
  9. MychainBase<Response> response = sdk.getAccountService().resetPubKey(
  10.     ResetPubKeyRequest.build(testAccount1.getIdentity(), authMap, params));

asyncResetPubKey

重置公钥，异步方式调用。

  • 函数原型
  1.  public MychainBase<Response> asyncResetPubKey(ResetPubKeyRequest request,ICallback callback)
  • 请求参数
参数 必选 类型 说明
request true ResetPubKeyRequest 重置公钥的请求
callback true ICallback 回调函数
  • 返回字段
返回字段 字段类型 说明
result MychainBase MychainBaseResult持有所有 response 类型。
  • 示例
  1. // 准备参数 params
  2. MychainParams params = new MychainParams.Builder()
  3.   .gas(BigInteger.valueOf(40000))
  4.   .privateKeyList(adminPrivateKeys)
  5.   .build();
  7. // 重置公钥
  8. MychainBase<Response> response = sdk.getAccountService().asyncResetPubKey(
  9.     ResetPubKeyRequest.build(testAccount1.getIdentity(), beforeAuthMap, params),
  10.     new ICallback() {
  11.         @Override
  12.         public void onResponse(String txHash, Response response) {
  13.             System.out.println("async reset pubkey, txHash:" + txHash + ", result: " + response.getErrorCode());
  14.         }
  15.     });

ResetPubKeyRequest

重置公钥所需要的参数：

参数 类型 说明
acctId Identity 要重置的账户 ID
mychainParams MychainParams 通用参数

更新权重

updateAuthMap

更新权重，同步方式调用。

  • 函数原型
  1. public MychainBase<ReplyTransactionReceipt> updateAuthMap(UpdateAuthMapRequest request)
  • 请求参数
参数 必选 类型 说明
request true UpdateAuthMapRequest 更新权重的请求
  • 返回字段
返回字段 字段类型 说明
result MychainBase MychainBaseResult 持有所有 response 类型。
  • 示例
  1. // 准备参数 params
  2. MychainParams params = new MychainParams.Builder()
  3.   .gas(BigInteger.valueOf(40000))
  4.   .privateKeyList(adminPrivateKeys)
  5.   .build();
  8. // 更新认证图
  9. MychainBase<ReplyTransactionReceipt> response = sdk.getAccountService().updateAuthMap(
  10.     UpdateAuthMapRequest.build(testAccount1.getIdentity(), beforeAuthMap, params));

asyncUpdateAuthMap

更新权重，异步方式调用。

  • 函数原型
  1.  public MychainBase<Response> asyncUpdateAuthMap(UpdateAuthMapRequest request,ICallback callback)
  • 请求参数
参数 必选 类型 说明
request true UpdateAuthMapRequest 更新权重的请求
callback true ICallback 回调函数
  • 返回字段
返回字段 字段类型 说明
result MychainBase MychainBaseResult 持有所有 response 类型。
  • 示例
  1. // 准备参数 params
  2. MychainParams params = new MychainParams.Builder()
  3.   .gas(BigInteger.valueOf(40000))
  4.   .privateKeyList(adminPrivateKeys)
  5.   .build();
  8. AuthMap beforeAuthMap = sdk.getQueryService()
  9.  .queryAccount(testAccount1.getIdentity().hexStrValue()).getData().getAccount().getAuthMap();
  11. for (Map.Entry<String, Integer> entry : beforeAuthMap.getAuthMap().entrySet()) {
  12.     beforeAuthMap.updateAuth(entry.getKey(), entry.getValue() + 10);
  13. }
  15. MychainBase<Response> result = sdk.getAccountService().asyncUpdateAuthMap(
  16.     UpdateAuthMapRequest.build(testAccount1.getIdentity(), beforeAuthMap, params),
  17.     new ICallback() {
  18.         @Override
  19.         public void onResponse(String txHash, Response response) {
  20.             System.out.println("async update auth map, txHash:" + txHash + ", result: "  + response.getErrorCode());
  21.         }
  22.     });

UpdateAuthMapRequest

更新权重所需要的参数：

参数 类型 说明
acctId Identity 要设置的账户 ID
authMap AuthMap 新的权重
mychainParams MychainParams 通用参数

冻结账户

freezeAccount

冻结账户，同步方式调用。

  • 函数原型
  1. public MychainBase<ReplyTransactionReceipt> freezeAccount(FreezeAccountRequest request)
  • 请求参数
参数 必选 类型 说明
request true FreezeAccountRequest 冻结账户的请求
  • 返回字段
返回字段 字段类型 说明
result MychainBase MychainBaseResult 持有所有 response 类型。
  • 示例
  1. // 准备参数 params
  2. MychainParams params = new MychainParams.Builder()
  3.   .gas(BigInteger.valueOf(40000))
  4.   .privateKeyList(adminPrivateKeys)
  5.   .build();
  8. // 冻结账户
  9. MychainBase<ReplyTransactionReceipt> result = sdk.getAccountService().freezeAccount(
  10.     FreezeAccountRequest.build(adminAccount.getIdentity(), testAccount1.getIdentity(),
  11.         params))

asyncFreezeAccount

冻结账户，异步方式调用。

  • 函数原型
  1. public MychainBase<Response> asyncFreezeAccount(FreezeAccountRequest request,ICallback callback)
  • 请求参数
参数 必选 类型 说明
request true FreezeAccountRequest 冻结账户的请求
callback true ICallback 回调函数
  • 返回字段
返回字段 字段类型 说明
result MychainBase MychainBaseResult 持有所有 response 类型。
  • 示例
  1. // 准备参数 params
  2. MychainParams params = new MychainParams.Builder()
  3.   .gas(BigInteger.valueOf(40000))
  4.   .privateKeyList(adminPrivateKeys)
  5.   .build();
  8. // 异步冻结帐户
  9. MychainBase<Response> result = sdk.getAccountService().asyncFreezeAccount(
  10.     FreezeAccountRequest.build(adminAccount.getIdentity(), testAccount1.getIdentity(),
  11.         params), new ICallback() {
  12.         @Override
  13.         public void onResponse(String txHash, Response response) {
  14.             assertNotNull(txHash);
  15.             assertTrue(response.getErrorCode().isSuccess());
  16.         }
  17.     });

FreezeAccountRequest

冻结账户请求所需要的参数：

参数 类型 说明
from Identity 冻结账户的操作者 ID
to Identity 待冻结的账户 ID
mychainParams MychainParams 通用参数

解冻账户

unFreezeAccount

解除冻结账户，同步方式调用。

  • 函数原型
  1. public MychainBase<ReplyTransactionReceipt> unFreezeAccount(UnfreezeAccountRequest request)
  • 请求参数
参数 必选 类型 说明
request true UnfreezeAccountRequest 解除冻结账户的请求
  • 返回字段
返回字段 字段类型 说明
result MychainBase<ReplyTransactionReceipt> MychainBaseResult 持有所有 response类型。
  • 示例
  1. // 准备参数 params
  2. MychainParams params = new MychainParams.Builder()
  3.   .gas(BigInteger.valueOf(40000))
  4.   .privateKeyList(adminPrivateKeys)
  5.   .build();
  8. // 解除冻结账户
  9. MychainBase<ReplyTransactionReceipt> result2 = sdk.getAccountService()
  10.     .unFreezeAccount(
  11.         UnfreezeAccountRequest.build(adminAccount.getIdentity(),
  12.             testAccount1.getIdentity(), params));

asyncUnFreezeAccount

解除冻结账户，异步方式调用。

  • 函数原型
  1. public MychainBase<Response> asyncUnFreezeAccount(UnfreezeAccountRequest request,ICallback callback)
  • 请求参数
参数 必选 类型 说明
request true UnfreezeAccountRequest 解除冻结账户的请求
callback true ICallback 回调函数
  • 返回字段
返回字段 字段类型 说明
result MychainBase MychainBaseResult 持有所有 response 类型。
  • 示例
  1. // 准备参数 params
  2. MychainParams params = new MychainParams.Builder()
  3.   .gas(BigInteger.valueOf(40000))
  4.   .privateKeyList(adminPrivateKeys)
  5.   .build();
  8. // 异步解除冻结账户
  9. MychainBase<Response> result2 = sdk.getAccountService().asyncUnFreezeAccount(
  10.     UnfreezeAccountRequest.build(adminAccount.getIdentity(), testAccount1.getIdentity(),
  11.         params), new ICallback() {
  12.         @Override
  13.         public void onResponse(String txHash, Response response) {
  14.             assertNotNull(txHash);
  15.             assertTrue(response.getErrorCode().isSuccess());
  16.         }
  17.     });

UnfreezeAccountRequest

解冻账户请求所需要的参数：

参数 类型 说明
from Identity 解冻账户的操作者 ID
to Identity 待解冻的账户 ID
mychainParams MychainParams 通用参数