Blockchain as a Service:Account interface

Create an account

createAccount

This API is called synchronously to create an account.

• Function prototype

public CreateAccountResponse createAccount(CreateAccountRequest request)

• Request parameter

• Response field

• Example

// Create an account and transfer an amount.
// CreateAccountRequest request = new CreateAccountRequest(accountId, account, amount);  
// Create an account based on accountId.
CreateAccountRequest request = new CreateAccountRequest(accountId, account);
// Refer to the error message description document to check the returned data.
CreateAccountResponse response = sdk.getAccountService().createAccount(request);

asyncCreateAccount

This API is called asynchronously to create an account.

• Function prototype

public int asyncCreateAccount(CreateAccountRequest request, IAsyncCallback callback)

• Request parameter

• Response field

• Asynchronous response field

• Example

// Create an account based on accountId.
CreateAccountRequest request = new CreateAccountRequest(accountId, account);
int result = sdk.getAccountService().asyncCreateAccount(
            request,
            new IAsyncCallback() {
                @Override
                public void onResponse(int errorCode, Response response) {
                    // Refer to the error message description document to check the returned data.
                    System.out.println("async create account, errorCode:" + errorCode + ", response: " + response.getErrorCode());
                }
            });

CreateAccountRequest

The following table describes parameters for creating an account.

CreateAccountResponse

The following table describes response parameters for creating an account.

Transfer

transferBalance

This API is called synchronously for transaction transfer.

• Function prototype

public TransferBalanceResponse transferBalance(TransferBalanceRequest request)

• Request parameter

• Response field

• Example

TransferBalanceRequest request = TransferBalanceRequest(id, receiverId, amount);
//transfer balance
// Refer to the error message description document to check the returned data.
TransferBalanceResponse response = sdk.getAccountService().transferBalance(request);

asyncTransferBalance

This API is called asynchronously for transaction transfer.

• Function prototype

public int asyncTransferBalance(TransferBalanceRequest request, IAsyncCallback callback)

• Request parameter

• Response field

• Example

TransferBalanceRequest request = TransferBalanceRequest(id, receiverId, amount);
// async transfer balance
int result = sdk.getAccountService().asyncTransferBalance(
            request,
            new IAsyncCallback() {
                @Override
                public void onResponse(int errorCode, Response response) {
                    // Refer to the error message description document to check the returned data.
                    System.out.println("async transfer balance, errorCode:" + errorCode + ", response: " + response.getErrorCode());
                }
            });

TransferBalanceRequest

The following table describes parameters required for transfer.

TransferBalanceResponse

The following table describes response parameters for transfer.

Set a recovery public key

setRecoverKey

This API is called synchronously to set a recovery public key.

• Function prototype

public SetRecoverKeyResponse setRecoverKey(SetRecoverKeyRequest request)

• Request parameter

• Response field

• Example

SetRecoverKeyRequest request = new SetRecoverKeyRequest(acctId, recoverPubKey);
// Refer to the error message description document to check the returned data.
SetRecoverKeyResponse response = sdk.getAccountService().setRecoverKey(request);

asyncSetRecoverKey

This API is called asynchronously to set a recovery public key.

• Function prototype

public int asyncSetRecoverKey(SetRecoverKeyRequest request, IAsyncCallback callback)

• Request parameter

• Response field

• Example

SetRecoverKeyRequest request = new SetRecoverKeyRequest(acctId, recoverPubKey)
int result = sdk.getAccountService().asyncSetRecoverKey(
    request,
    new IAsyncCallback() {
        @Override
        public void onResponse(int errorCode, Response response) {
            // Refer to the error message description document to check the returned data.  
            System.out.println("async set recover key, errorCode:" + errorCode + ", response: " + response.getErrorCode());
        }
    });

SetRecoverKeyRequest

The following table describes parameters for setting a recovery public key.

SetRecoverKeyResponse

The following table describes response parameters for setting a recovery public key.

Preset a public key

preResetPubKey

This API is called synchronously to preset a public key.

• Function prototype

public PreResetPubKeyResponse preResetPubKey(PreResetPubKeyRequest request)

• Request parameter

• Response field

• Example

PreResetPubKeyRequest request = new PreResetPubKeyRequest(acctId);
// Refer to the error message description document to check the returned data.  
PreResetPubKeyResponse response = sdk.getAccountService().preResetPubKey(request);

asyncPreResetPubKey

This API is called asynchronously to preset a public key.

• Function prototype

public int asyncPreResetPubKey(PreResetPubKeyRequest request, IAsyncCallback callback)

• Request parameter

• Response field

• Example

PreResetPubKeyRequest request = new PreResetPubKeyRequest(acctId);
int result = sdk.getAccountService().asyncPreResetPubKey(request, new IAsyncCallback() {
        @Override
        public void onResponse(int errorCode, Response response) {
          // Refer to the error message description document to check the returned data.  
          System.out.println("async reset pubkey, errorCode:" + errorCode + ", response: " + response.getErrorCode()); 
        }
    });

PreResetPubKeyRequest

The following table describes a parameter for presetting a public key.

PreResetPubKeyResponse

The following table describes response parameters for presetting a public key.

Reset a public key

resetPublicKey

This API is called synchronously to reset a public key.

• Function prototype

public ResetPubKeyResponse resetPublicKey(ResetPubKeyRequest request)

• Request parameter

• Response field

• Example

ResetPubKeyRequest request = new ResetPubKeyRequest(acctId, authMap);
// Refer to the error message description document to check the returned data.
ResetPubKeyResponse response = sdk.getAccountService().resetPubKey(request);

asyncResetPubKey

This API is called asynchronously to reset a public key.

• Function prototype

public int asyncResetPubKey(ResetPubKeyRequest request,IAsyncCallback callback)

• Request parameter

• Response field

• Example

ResetPubKeyRequest request = new ResetPubKeyRequest(acctId, authMap); 
// reset public key
int response = sdk.getAccountService().asyncResetPubKey(
    request,
    new IAsyncCallback() {
        @Override
        public void onResponse(int errorCode, Response response) {
            // Refer to the error message description document to check the returned data.
            System.out.println("async reset pubkey, errorCode:" + errorCode + ", response: " + response.getErrorCode());
        }
    });

ResetPubKeyRequest

The following table describes parameters for resetting a public key.

ResetPubKeyResponse

The following table describes response parameters for resetting a public key.

Update a weight

updateAuthMap

This API is called synchronously to update a weight.

• Function prototype

public UpdateAuthMapResponse updateAuthMap(UpdateAuthMapRequest request)

• Request parameter

• Response field

• Example

UpdateAuthMapRequest request =  new UpdateAuthMapRequest(acctId, authMap);
// Refer to the error message description document to check the returned data.  
UpdateAuthMapResponse response = sdk.getAccountService().updateAuthMap(request);

asyncUpdateAuthMap

This API is called asynchronously to update a weight.

• Function prototype

public int asyncUpdateAuthMap(UpdateAuthMapRequest request,IAsyncCallback callback)

• Request parameter

• Response field

• Example

UpdateAuthMapRequest request =  new UpdateAuthMapRequest(acctId, authMap);
int result = sdk.getAccountService().asyncUpdateAuthMap(
    request,
    new IAsyncCallback() {
        @Override
        public void onResponse(int errorCode, Response response) {
            // Refer to the error message description document to check the returned data.
            System.out.println("async update auth map, errorCode:" + errorCode + ", response: " + response.getErrorCode());
        }
    });

UpdateAuthMapRequest

The following table describes parameters for updating a weight.

UpdateAuthMapResponse

The following table describes response parameters for updating a weight.

Freeze an account

freezeAccount

This API is called synchronously to freeze an account.

• Function prototype

public FreezeAccountResponse freezeAccount(FreezeAccountRequest request)

• Request parameter

• Response field

• Example

FreezeAccountRequest request = new FreezeAccountRequest(from, to);
// Refer to the error message description document to check the returned data.  
FreezeAccountResponse result = sdk.getAccountService().freezeAccount(request)

asyncFreezeAccount

This API is called asynchronously to freeze an account.

• Function prototype

public int asyncFreezeAccount(FreezeAccountRequest request,IAsyncCallback callback)

• Request parameter

• Response field

• Example

FreezeAccountRequest request = new FreezeAccountRequest(from, to);
// async freeze account
int result = sdk.getAccountService().asyncFreezeAccount(
    request
    , new IAsyncCallback() {
        @Override
        public void onResponse(int errorCode, Response response) {
          // Refer to the error message description document to check the returned data.
          System.out.println("async freeze account, errorCode:" + errorCode + ", response: " + response.getErrorCode());
        }
    });

FreezeAccountRequest

The following table describes parameters for freezing an account.

FreezeAccountResponse

The following table describes response parameters for freezing an account.

Unfreeze an account

unFreezeAccount

This API is called synchronously to unfreeze an account.

• Function prototype

public UnFreezeAccountResponse unFreezeAccount(UnFreezeAccountRequest request)

• Request parameter

• Response field

• Example

UnfreezeAccountRequest request = new UnFreezeAccountRequest(id, frozenId);
// unfreeze account
// Refer to the error message description document to check the returned data.  
UnFreezeAccountResponse response = sdk.getAccountService().unFreezeAccount(request);

asyncUnFreezeAccount

This API is called asynchronously to unfreeze an account.

• Function prototype

public int asyncUnFreezeAccount(UnFreezeAccountRequest request,IAsyncCallback callback)

• Request parameter

• Response field

• Example

UnFreezeAccountRequest request = new UnfreezeAccountRequest(id, frozenId);
// async unfreeze account
int result = sdk.getAccountService().asyncUnFreezeAccount(
    request, 
    new IAsyncCallback() {
        @Override
        public void onResponse(int errorCode, Response response) {
          // Refer to the error message description document to check the returned data.
          System.out.println("async unFreeze account, errorCode:" + errorCode + ", response: " + response.getErrorCode());
        }
    });

UnfreezeAccountRequest

The following table describes parameters for unfreezing an account.

UnFreezeAccountResponse

The following table describes response parameters for unfreezing an account.

Update an encryption key

updateEncryptionKey

This API is called synchronously to update an encryption key.

• Function prototype

public UpdateEncryptionKeyResponse updateEncryptionKey(UpdateEncryptionKeyRequest request)

• Request parameter

• Response field

• Example

UpdateEncryptionKeyRequest request = new UpdateEncryptionKeyRequest(acctId, encryptionKey);
// Refer to the error message description document to check the returned data.  
UpdateEncryptionKeyResponse response = sdk.getAccountService().updateEncryptionKey(request);

asyncUpdateEncryptionKey

This API is called asynchronously to update an encryption key.

• Function prototype

public int asyncUpdateEncryptionKey(UpdateEncryptionKeyRequest request,IAsyncCallback callback)

• Request parameter

• Response field

• Example

UpdateEncryptionKeyRequest request = new UpdateEncryptionKeyRequest(acctId, encryptionKey);
int result = sdk.getAccountService().asyncUpdateEncryptionKey(
    request, 
    new IAsyncCallback() {
        @Override
        public void onResponse(int errorCode, Response response) {
          // Refer to the error message description document to check the returned data.  
          System.out.println("async update encryption key, errorCode:" + errorCode + ", response: " + response.getErrorCode());
        }
    });

UpdateEncryptionKeyRequest

The following table describes parameters for updating an encryption key.

UpdateEncryptionKeyResponse

The following table describes response parameters for updating an encryption key.