Blockchain as a Service:Contract Interface

Deploy smart contracts

deployContract

You can call this synchronous operation to deploy a smart contract.

• Function

public MychainBaseResult<ReplyTransactionReceipt> deployContract(DeployContractRequest request)

• Request parameters

• Response fields

• Examples

// build  params
MychainParams params = new MychainParams.Builder()
  .gas(BigInteger.valueOf(40000))
  .privateKeyList(adminPrivateKeys)
  .build();

ContractParameters contractParameters = new ContractParameters();

//deploy contract
MychainBaseResult<ReplyTransactionReceipt> result = sdk.getContractService().deployContract(
    DeployContractRequest.build(
        adminAccount.getIdentity(),
        Utils.getIdentityByName(testContractId),
        contractCode,
        contractParameters,
        new BigInteger("10000"),
        params
    )
);

asyncDeployContract

You can call this asynchronous operation to deploy a smart contract.

• Function

public MychainBaseResult<Response> asyncDeployContract(DeployContractRequest request, ICallback callback)

• Request parameters

• Response fields

• Examples

// build  params
MychainParams params = new MychainParams.Builder()
  .gas(BigInteger.valueOf(40000))
  .privateKeyList(adminPrivateKeys)
  .build();

ContractParameters contractParameters = new ContractParameters();

//deploy contract
MychainBaseResult<Response> result = sdk.getContractService().asyncDeployContract(
    DeployContractRequest.build(
        adminAccount.getIdentity(),
        Utils.getIdentityByName(testContractId),
        contractCode,
        contractParameters,
        new BigInteger("10000"),
        params
    ),
    (txHash, response) -> {
        System.out.println("async deploy contract, txHash:"+txHash+", result: "+ response.getErrorCode());
    }
);

DeployContractRequest

Parameters required to deploy a smart contract:

Call smart contracts

callContract

You can call this synchronous operation to call a smart contract.

• Function

public MychainBaseResult<ReplyTransactionReceipt> callContract(CallContractRequest request)

• Request parameters

• Response fields

• Examples

// build  params
MychainParams params = new MychainParams.Builder()
  .gas(BigInteger.valueOf(40000))
  .privateKeyList(adminPrivateKeys)
  .build();

BigInteger value = new BigInteger("0");
String method = "set(uint256)";
List<String> parameters = new ArrayList<>();
parameters.add("100");

//call contract
MychainBaseResult<ReplyTransactionReceipt> replyTransactionReceipt = sdk.getContractService().callContract(
    CallContractRequest.build(
        adminAccount.getIdentity(),
        Utils.getIdentityByName(testContractId),
        parameters,
        value,
        method,
        params
    )
);

asyncCallContract

You can call this asynchronous operation to call a smart contract.

• Function

public MychainBaseResult<Response> asyncCallContract(CallContractRequest request, ICallback callback)

• Request parameters

• Response fields

• Examples

// build  params
MychainParams params = new MychainParams.Builder()
  .gas(BigInteger.valueOf(40000))
  .privateKeyList(adminPrivateKeys)
  .build();

ContractParameters parameters = new ContractParameters("set(uint256)");
parameters.addUint(new BigInteger("100"));

// call contract
MychainBaseResult<Response> replyTransactionReceipt = sdk.getContractService().asyncCallContract(
    CallContractRequest.build(
        adminAccount.getIdentity(),
        Utils.getIdentityByName(testContractId),
        parameters,
        value,
        method,
        params
    ),
    (txHash, response) -> {
        System.out.println("async call contract, txHash:"+txHash+", result: "+ response.getErrorCode());
    }
);

CallContractRequest

Parameters required to call a smart contract:

Update smart contracts

updateContract

You can call this synchronous operation to update a smart contract.

• Function

public MychainBaseResult<ReplyTransactionReceipt> updateContract(UpdateContractRequest request)

• Request parameters

• Response fields

• Examples

// build  params
MychainParams params = new MychainParams.Builder()
  .gas(BigInteger.valueOf(40000))
  .privateKeyList(adminPrivateKeys)
  .build();

ContractParameters contractParameters = new ContractParameters();

//update contract
MychainBaseResult<ReplyTransactionReceipt> result = sdk.getContractService()
    .updateContract(
        UpdateContractRequest.build(Utils.getIdentityByName(testContractId), newContractCode, VMTypeEnum.EVM, params));

asyncUpdateContract

You can call this asynchronous operation to update a contract.

• Function

public MychainBaseResult<Response> asyncUpdateContract(UpdateContractRequest request, ICallback callback)

• Request parameters

• Response fields

• Examples

// build  params
// build  params
MychainParams params = new MychainParams.Builder()
  .gas(BigInteger.valueOf(40000))
  .privateKeyList(adminPrivateKeys)
  .build();

ContractParameters contractParameters = new ContractParameters();

//update contract
MychainBaseResult<Response> result = sdk.getContractService().asyncUpdateContract(
    UpdateContractRequest.build(contractId, newContractCode, VMTypeEnum.EVM, params),
    new ICallback() {
        @Override
        public void onResponse(String txHash, Response response) {
            System.out.println("async update contract, txHash:" + txHash + ", result: "
                               + response.getErrorCode());
            assertTrue(response.isSuccess());
            assertEquals("0", response.getErrorCode().getErrorCode());
        }
    });

UpdateContractRequest

Parameters required to update a smart contract.

Notes: To update the contract, the compiled runtime bytecode is required. This bytecode can be obtained directly by using the --bin-runtime parameter of solc compiler, the Solidity compiler. It is the subset of the bytecode of the compiled --bin parameter. The runtime bytecode can also be obtained by deploying local contracts.

The contract parameter object.

The contract parameter class used to compile smart contract methods and parameters in these methods.

The EVM contract parameter object.

• ContractParameters

Resolve EVM contract return values

• ContractReturnValues

WASM contract parameter objects

Note: The C++ smart contract development feature has not been officially released.

• WasmContractParameters