阿里云首页 区块链服务 BaaS

账户接口

创建账户

createAccount

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

  • 函数原型
  1. public CreateAccountResponse createAccount(CreateAccountRequest request)
  • 请求参数
参数 必选 类型 说明
request true CreateAccountRequest 创建账户的请求
  • 返回字段
返回字段 字段类型 说明
result CreateAccountResponse 创建账户的响应
  • 示例
  1. // 创建账号并转账
  2. // CreateAccountRequest request = new CreateAccountRequest(accountId,account, amount);
  3. // accountId创建account账号
  4. CreateAccountRequest request = new CreateAccountRequest(accountIdaccount);
  5. // 参考错误信息说明文档内容,检查返回的数据
  6. CreateAccountResponse response = sdk.getAccountService().createAccount(request);

asyncCreateAccount

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

  • 函数原型
  1. public int asyncCreateAccount(CreateAccountRequest request, IAsyncCallback callback)
  • 请求参数
参数 必选 类型 说明
request true CreateAccountRequest 创建账户的请求
callback true IAsyncCallback 回调函数
  • 返回字段
返回字段 字段类型 说明
result int 发送返回值。
  • 异步返回字段
返回字段 字段类型 说明
errorCode int SDK 发送消息超时或者成功。
response Response 平台返回的响应,其中 response.getErrorCode()是平台返回的错误码。
  • 示例
  1. // accountId 创建 account 账号
  2. CreateAccountRequest request = new CreateAccountRequest(accountIdaccount);
  3. int result = sdk.getAccountService().asyncCreateAccount(
  4. request,
  5. new IAsyncCallback() {
  6. @Override
  7. public void onResponse(int errorCode, Response response) {
  8. // 参考错误信息说明文档,检查返回的数据
  9. System.out.println("async create account, errorCode:" + errorCode + ", response: " + response.getErrorCode());
  10. }
  11. });

CreateAccountRequest

创建账户的参数:

参数 类型 说明
account Account 待创建的账户
accountId Identity 创建的账户 ID

CreateAccountResponse

创建账户的返回参数:

参数 类型 说明
transactionReceipt TransactionReceipt 交易收据
blockNumber BigInteger 区块号

转账

transferBalance

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

  • 函数原型
  1. public TransferBalanceResponse transferBalance(TransferBalanceRequest request)
  • 请求参数
参数 必选 类型 说明
request true TransferBalanceRequest 交易转帐的请求
  • 返回字段
返回字段 字段类型 说明
response TransferBalanceResponse 交易转账的响应
  • 示例
  1. TransferBalanceRequest request = TransferBalanceRequest(id, receiverId, amount);
  2. //transfer balance
  3. // 参考错误信息说明文档,检查返回的数据
  4. TransferBalanceResponse response = sdk.getAccountService().transferBalance(request);

asyncTransferBalance

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

  • 函数原型
  1. public int asyncTransferBalance(TransferBalanceRequest request, IAsyncCallback callback)
  • 请求参数
参数 必选 类型 说明
request true TransferBalanceRequest 交易转帐的请求
callback true IAsyncCallback 回调函数
  • 返回字段
返回字段 字段类型 说明
result int 发送返回值
  • 示例
  1. TransferBalanceRequest request = TransferBalanceRequest(id, receiverId, amount);
  2. // async transfer balance
  3. int result = sdk.getAccountService().asyncTransferBalance(
  4. request,
  5. new IAsyncCallback() {
  6. @Override
  7. public void onResponse(int errorCode, Response response) {
  8. // 参考错误信息说明文档,检查返回的数据
  9. System.out.println("async transfer balance, errorCode:" + errorCode + ", response: " + response.getErrorCode());
  10. }
  11. });

TransferBalanceRequest

转账所需要的参数:

参数 类型 说明
id Identity 转出账户
receiverId Identity 转入账户
amount BigInteger 转账金额

TransferBalanceResponse

转账的返回参数:

参数 类型 说明
transactionReceipt TransactionReceipt 交易收据
blockNumber BigInteger 区块号

设置恢复公钥

setRecoverKey

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

  • 函数原型
  1. public SetRecoverKeyResponse setRecoverKey(SetRecoverKeyRequest request)
  • 请求参数
参数 必选 类型 说明
request true SetRecoverKeyRequest 恢复公钥的请求
  • 返回字段
返回字段 字段类型 说明
response SetRecoverKeyResponse 恢复公钥的响应
  • 示例
  1. SetRecoverKeyRequest request = new SetRecoverKeyRequest(acctId, recoverPubKey);
  2. // 参考错误信息说明文档,检查返回的数据
  3. SetRecoverKeyResponse response = sdk.getAccountService().setRecoverKey(request);

asyncSetRecoverKey

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

  • 函数原型
  1. public int asyncSetRecoverKey(SetRecoverKeyRequest request, IAsyncCallback callback)
  • 请求参数
参数 必选 类型 说明
request true SetRecoverKeyRequest 恢复公钥的请求
callback true IAsyncCallback 回调函数
  • 返回字段
返回字段 字段类型 说明
result int 发送返回值
  • 示例
  1. SetRecoverKeyRequest request = new SetRecoverKeyRequest(acctId, recoverPubKey)
  2. int result = sdk.getAccountService().asyncSetRecoverKey(
  3. request,
  4. new IAsyncCallback() {
  5. @Override
  6. public void onResponse(int errorCode, Response response) {
  7. // 参考错误信息说明文档,检查返回的数据
  8. System.out.println("async set recover key, errorCode:" + errorCode + ", response: " + response.getErrorCode());
  9. }
  10. });

SetRecoverKeyRequest

重置恢复公钥的参数:

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

SetRecoverKeyResponse

重置恢复公钥的返回参数:

参数 类型 说明
transactionReceipt TransactionReceipt 交易收据
blockNumber BigInteger 区块号

预重置公钥

preResetPubKey

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

  • 函数原型
  1. public PreResetPubKeyResponse preResetPubKey(PreResetPubKeyRequest request)
  • 请求参数
参数 必选 类型 说明
request true PreResetPubKeyRequest 预重置公钥的请求
  • 返回字段
返回字段 字段类型 说明
response PreResetPubKeyResponse 预重置公钥的响应
  • 示例
  1. PreResetPubKeyRequest request = new PreResetPubKeyRequest(acctId);
  2. // 参考错误信息说明文档,检查返回的数据
  3. PreResetPubKeyResponse response = sdk.getAccountService().preResetPubKey(request);

asyncPreResetPubKey

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

  • 函数原型
  1. public int asyncPreResetPubKey(PreResetPubKeyRequest request, IAsyncCallback callback)
  • 请求参数
参数 必选 类型 说明
request true PreResetPubKeyRequest 预重置公钥的请求
callback true IAsyncCallback 回调函数
  • 返回字段
返回字段 字段类型 说明
result int 发送返回值
  • 示例
  1. PreResetPubKeyRequest request = new PreResetPubKeyRequest(acctId);
  2. int result = sdk.getAccountService().asyncPreResetPubKey(request, new IAsyncCallback() {
  3. @Override
  4. public void onResponse(int errorCode, Response response) {
  5. // 参考错误信息说明文档,检查返回的数据
  6. System.out.println("async reset pubkey, errorCode:" + errorCode + ", response: " + response.getErrorCode());
  7. }
  8. });

PreResetPubKeyRequest

预重置公钥的参数:

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

PreResetPubKeyResponse

预重置公钥的返回参数:

参数 类型 说明
transactionReceipt TransactionReceipt 交易收据
blockNumber BigInteger 区块号

重置公钥

resetPublicKey

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

  • 函数原型
  1. public ResetPubKeyResponse resetPublicKey(ResetPubKeyRequest request)
  • 请求参数
参数 必选 类型 说明
request true ResetPubKeyRequest 重置公钥的请求
  • 返回字段
返回字段 字段类型 说明
response ResetPubKeyResponse 重置公钥的响应
  • 示例
  1. ResetPubKeyRequest request = new ResetPubKeyRequest(acctId, authMap);
  2. // 参考错误信息说明文档,检查返回的数据
  3. ResetPubKeyResponse response = sdk.getAccountService().resetPubKey(request);

asyncResetPubKey

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

  • 函数原型
  1. public int asyncResetPubKey(ResetPubKeyRequest request,IAsyncCallback callback)
  • 请求参数
参数 必选 类型 说明
request true ResetPubKeyRequest 重置公钥的请求
callback true IAsyncCallback 回调函数
  • 返回字段
返回字段 字段类型 说明
result int 发送返回值
  • 示例
  1. ResetPubKeyRequest request = new ResetPubKeyRequest(acctId, authMap);
  2. // reset public key
  3. int response = sdk.getAccountService().asyncResetPubKey(
  4. request,
  5. new IAsyncCallback() {
  6. @Override
  7. public void onResponse(int errorCode, Response response) {
  8. // 参考错误信息说明文档,检查返回的数据
  9. System.out.println("async reset pubkey, errorCode:" + errorCode + ", response: " + response.getErrorCode());
  10. }
  11. });

ResetPubKeyRequest

重置公钥的参数:

参数 类型 说明
acctId Identity 要重置的账户 ID
authMap AuthMap 账户或者合约的公钥和权重值

ResetPubKeyResponse

重置公钥的返回参数:

参数 类型 说明
transactionReceipt TransactionReceipt 交易收据
blockNumber BigInteger 区块号

更新权重

updateAuthMap

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

  • 函数原型

    1. public UpdateAuthMapResponse updateAuthMap(UpdateAuthMapRequest request)
  • 请求参数

参数 必选 类型 说明
request true UpdateAuthMapRequest 更新权重的请求
  • 返回字段
返回字段 字段类型 说明
response UpdateAuthMapResponse 更新权重的响应
  • 示例
  1. UpdateAuthMapRequest request = new UpdateAuthMapRequest(acctId, authMap);
  2. // 参考错误信息说明文档,检查返回的数据
  3. UpdateAuthMapResponse response = sdk.getAccountService().updateAuthMap(request);

asyncUpdateAuthMap

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

  • 函数原型
  1. public int asyncUpdateAuthMap(UpdateAuthMapRequest request,IAsyncCallback callback)
  • 请求参数
参数 必选 类型 说明
request true UpdateAuthMapRequest 更新权重的请求
callback true IAsyncCallback 回调函数
  • 返回字段
返回字段 字段类型 说明
result int 发送返回值
  • 示例
  1. UpdateAuthMapRequest request = new UpdateAuthMapRequest(acctId, authMap);
  2. int result = sdk.getAccountService().asyncUpdateAuthMap(
  3. request,
  4. new IAsyncCallback() {
  5. @Override
  6. public void onResponse(int errorCode, Response response) {
  7. // 参考错误信息说明文档,检查返回的数据
  8. System.out.println("async update auth map, errorCode:" + errorCode + ", response: " + response.getErrorCode());
  9. }
  10. });

UpdateAuthMapRequest

更新权重的参数:

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

UpdateAuthMapResponse

更新权重的返回参数:

参数 类型 说明
transactionReceipt TransactionReceipt 交易收据
blockNumber BigInteger 区块号

冻结账户

freezeAccount

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

  • 函数原型
  1. public FreezeAccountResponse freezeAccount(FreezeAccountRequest request)
  • 请求参数
参数 必选 类型 说明
request true FreezeAccountRequest 冻结账户的请求
  • 返回字段
返回字段 字段类型 说明
response FreezeAccountResponse 冻结账户的响应
  • 示例
  1. FreezeAccountRequest request = new FreezeAccountRequest(from, to);
  2. // 参考错误信息说明文档,检查返回的数据
  3. FreezeAccountResponse result = sdk.getAccountService().freezeAccount(request)

asyncFreezeAccount

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

  • 函数原型
  1. public int asyncFreezeAccount(FreezeAccountRequest request,IAsyncCallback callback)
  • 请求参数
参数 必选 类型 说明
request true FreezeAccountRequest 冻结账户的请求
callback true IAsyncCallback 回调函数
  • 返回字段
返回字段 字段类型 说明
result int 发送返回值
  • 示例
  1. FreezeAccountRequest request = new FreezeAccountRequest(from, to);
  2. // async freeze account
  3. int result = sdk.getAccountService().asyncFreezeAccount(
  4. request
  5. , new IAsyncCallback() {
  6. @Override
  7. public void onResponse(int errorCode, Response response) {
  8. // 参考错误信息说明文档,检查返回的数据
  9. System.out.println("async freeze account, errorCode:" + errorCode + ", response: " + response.getErrorCode());
  10. }
  11. });

FreezeAccountRequest

冻结账户的参数:

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

FreezeAccountResponse

冻结账户的返回参数:

参数 类型 说明
transactionReceipt TransactionReceipt 交易收据
blockNumber BigInteger 区块号

解冻账户

unFreezeAccount

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

  • 函数原型
  1. public UnFreezeAccountResponse unFreezeAccount(UnFreezeAccountRequest request)
  • 请求参数
参数 必选 类型 说明
request true UnFreezeAccountRequest 解除冻结账户的请求
  • 返回字段
返回字段 字段类型 说明
response UnFreezeAccountResponse 解除冻结账户的响应
  • 示例
  1. UnfreezeAccountRequest request = new UnFreezeAccountRequest(id, frozenId);
  2. // unfreeze account
  3. // 参考错误信息说明文档,检查返回的数据
  4. UnFreezeAccountResponse response = sdk.getAccountService().unFreezeAccount(request);

asyncUnFreezeAccount

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

  • 函数原型
  1. public int asyncUnFreezeAccount(UnFreezeAccountRequest request,IAsyncCallback callback)
  • 请求参数
参数 必选 类型 说明
request true UnFreezeAccountRequest 解除冻结账户的请求
callback true IAsyncCallback 回调函数
  • 返回字段
返回字段 字段类型 说明
result int 发送返回值
  • 示例
  1. UnFreezeAccountRequest request = new UnfreezeAccountRequest(id, frozenId);
  2. // async unfreeze account
  3. int result = sdk.getAccountService().asyncUnFreezeAccount(
  4. request,
  5. new IAsyncCallback() {
  6. @Override
  7. public void onResponse(int errorCode, Response response) {
  8. // 参考错误信息说明文档,检查返回的数据
  9. System.out.println("async unFreeze account, errorCode:" + errorCode + ", response: " + response.getErrorCode());
  10. }
  11. });

UnfreezeAccountRequest

解冻账户的参数:

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

UnFreezeAccountResponse

解冻账户的返回参数:

参数 类型 说明
transactionReceipt TransactionReceipt 交易收据
blockNumber BigInteger 区块号

更新加密密钥

updateEncryptionKey

更新加密密钥,同步方式调用。

  • 函数原型
  1. public UpdateEncryptionKeyResponse updateEncryptionKey(UpdateEncryptionKeyRequest request)
  • 请求参数
参数 必选 类型 说明
request true UpdateEncryptionKeyRequest 更新加密密钥的请求。
  • 返回字段
返回字段 字段类型 说明
response UpdateEncryptionKeyResponse 更新加密密钥的响应。
  • 示例
  1. UpdateEncryptionKeyRequest request = new UpdateEncryptionKeyRequest(acctId, encryptionKey);
  2. // 参考错误信息说明文档,检查返回的数据
  3. UpdateEncryptionKeyResponse response = sdk.getAccountService().updateEncryptionKey(request);

asyncUpdateEncryptionKey

更新加密密钥,异步方式调用。

  • 函数原型
  1. public int asyncUpdateEncryptionKey(UpdateEncryptionKeyRequest request,IAsyncCallback callback)
  • 请求参数
参数 必选 类型 说明
request true UpdateEncryptionKeyRequest 更新加密密钥的请求。
callback true IAsyncCallback 回调函数
  • 返回字段
返回字段 字段类型 说明
result int 发送返回值
  • 示例
  1. UpdateEncryptionKeyRequest request = new UpdateEncryptionKeyRequest(acctId, encryptionKey);
  2. int result = sdk.getAccountService().asyncUpdateEncryptionKey(
  3. request,
  4. new IAsyncCallback() {
  5. @Override
  6. public void onResponse(int errorCode, Response response) {
  7. // 参考错误信息说明文档,检查返回的数据
  8. System.out.println("async update encryption key, errorCode:" + errorCode + ", response: " + response.getErrorCode());
  9. }
  10. });

UpdateEncryptionKeyRequest

更新加密密钥的参数:

参数 类型 说明
acctId Identity 更新密钥的操作者 ID
encryptionKey byte[] 密钥

UpdateEncryptionKeyResponse

更新加密密钥的返回参数:

参数 类型 说明
transactionReceipt TransactionReceipt 交易收据
blockNumber BigInteger 区块号