All Products
Search

This Product

    Blockchain as a Service:Envelope transaction interface

    Document Center

    Blockchain as a Service:Envelope transaction interface

    Last Updated:May 08, 2020

    An envelope transaction is executed in an independent group to protect privacy. The smart contract platform supports envelope transactions of deploying, calling, updating, and querying for contracts.

    depositEnvelope

    This API is called synchronously for envelope transactions.

    • Function prototype
    1. public DepositEnvelopeResponse depositEnvelope(DepositEnvelopeRequest request)
    • Request parameter
    Parameter Required Type Description
    request true DepositEnvelopeRequest The envelope transaction request.
    • Response field
    Response field Field type Description
    response DepositEnvelopeResponse The envelope transaction response.
    • Example
    1. // create Group
    2. CreateGroupRequest createGroupRequest = new CreateGroupRequest(new PublicKey(keypair.getPubkeyId()), adminAccount.getIdentity());
    3. createGroupResponse = sdk.getEnvelopeService().createGroup(createGroupRequest);
    5. // join group  
    6. byte[] groupPrivateKey = createGroupResponse.getPrivateKey();
    7. PublicKey anoymousPublicKey = new PublicKey(keypair.getPubkeyId());
    8. JoinGroupRequest request = new JoinGroupRequest(groupPrivateKey, anoymousPublicKey, createGroupResponse.getGroupId(), adminAccount.getIdentity());
    9. JoinGroupResponse joinGroupResponse = sdk.getEnvelopeService().joinGroup(request);
    11. // get groupId by createGroupResponse
    12. BaseFixedSizeByteArray.Fixed20ByteArray groupId = createGroupResponse.getGroupId();
    14. // get keypair from createGroupResponse
    15. Pkcs8KeyOperator pkcs8KeyOperator = new Pkcs8KeyOperator();
    16. Keypair keypair = pkcs8KeyOperator.loadFromPrivkey(createGroupResponse.getPrivateKey());
    18. // create signerOption by keypair
    19. SignerOption signerOption = new SignerOption();
    20. List<SignerBase> signerBaseList = new ArrayList<>();
    21. signerBaseList.add(MyCrypto.getInstance().createSigner(keypair));
    22. signerOption.setSigners(signerBaseList);
    24. // create inner request
    25. CreateAccountRequest createAccountRequest = new CreateAccountRequest(accId, account);
    27. // create DepositEnvelopeRequest
    28. IHash hashTool = HashFactory.getHash();
    29. DepositEnvelopeRequest request = new DepositEnvelopeRequest(createAccountRequest, groupId, signerOption, keypair);
    30. request.setAnoymousIdentity(new Identity(hashTool.hash(keypair.getPubkeyId())));
    31. // Refer to the error message description document to check the returned data.
    32. DepositEnvelopeResponse response = sdk.getEnvelopeService().depositEnvelope(request);

    asyncDepositRequest

    This API is called asynchronously for envelope transactions.

    • Function prototype
    1. public int asyncDepositRequest(DepositEnvelopeRequest request, IAsyncCallback callback)
    • Request parameter
    Parameter Required Type Description
    request true DepositEnvelopeRequest The envelope transaction request.
    callback true IAsyncCallback The callback function.
    • Response field
    Response field Field type Description
    result int The return value.
    • Example
    1. DepositEnvelopeRequest request = new DepositEnvelopeRequest(createAccountRequest, groupId, signerOption, keypair);
    2. request.setAnoymousIdentity(new Identity(hashTool.hash(keypair.getPubkeyId())));
    3. int result = sdk.getEnvelopeService().asyncDepositRequest(
    4.     request,
    5.     new IAsyncCallback() {
    6.         @Override
    7.         public void onResponse(int errorCode, Response response) {
    8.             // Refer to the error messages in section 4.11 to check the returned data.
    9.             System.out.println("async deposit envelope, errorCode:" + errorCode + ", response: " + response.getErrorCode());
    10.         }
    11.     });

    Request parameters for an envelope transaction

    • DepositEnvelopeRequest
    Parameter Type Description
    anoymousIdentity Identity The anonymous identity.
    signerOption SignerOption The signature configuration option.
    keypair Keypair The key pair.
    • GroupTransactionRequest

    GroupTransactionRequest is the parent class of DepositEnvelopeRequest.

    Parameter Type Description
    request AbstractTransactionRequest The inner transaction, including deploying, calling, and updating a contract.

    Response parameters for an envelope transaction

    • DepositEnvelopeResponse
    Parameter Type Description
    transactionReceipt TransactionReceipt The transaction receipt.
    blockNumber BigInteger The block number.