合约接口

部署合约

deployContract

部署合约，同步方式调用。

• 函数原型

public MychainBaseResult<ReplyTransactionReceipt> deployContract(DeployContractRequest request)

• 请求参数

• 返回字段

• 示例

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

ContractParameters contractParameters = new ContractParameters();

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

asyncDeployContract

部署合约，异步方式调用。

• 函数原型

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

• 请求参数

• 返回字段

• 示例

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

ContractParameters contractParameters = new ContractParameters();

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

DeployContractRequest

下面是部署合约所需要的参数。

调用合约

callContract

调用合约，同步方式调用。

• 函数原型

public MychainBaseResult<ReplyTransactionReceipt> callContract(CallContractRequest request)

• 请求参数

• 返回字段

• 示例

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

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

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

asyncCallContract

调用合约，异步方式调用。

• 函数原型

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

• 请求参数

• 返回字段

• 示例

// build  params
MychainParams params = new MychainParams.Builder()
  .gas(BigInteger.valueOf(4000000))
  .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,
        params
    ),
    (txHash, response) -> {
        System.out.println("async call contract, txHash:"+txHash+", result: "+ response.getErrorCode());
    }
);

CallContractRequest

调用合约所需要的参数：

升级合约

updateContract

升级合约，同步方式调用。

• 函数原型

public MychainBaseResult<ReplyTransactionReceipt> updateContract(UpdateContractRequest request)

• 请求参数

• 返回字段

• 示例

// 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

升级合约，异步方式调用。

• 函数原型

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

• 请求参数

• 返回字段

• 示例

// 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

升级合约所需要的参数：

合约参数对象

参数对象，用于编码合约方法和参数。

EVM 合约参数对象

• ContractParameters

• 代码示例

  //JAVA 示例代码
  MychainParams params = new MychainParams();
  params.setGas(BigInteger.valueOf(4000000));
  params.setPrivateKeyList(adminPrivateKeys);
  BigInteger value = new BigInteger("0");
  
  ContractParameters parameters = new ContractParameters("set(uint256)");
  parameters.addUint(new BigInteger("100"));
  
  CallContractRequest request = CallContractRequest.build(adminAccount.getIdentity(),
  Utils.getIdentityByName(testContractId,env), parameters, value, params, 0, 0,
  BaseFixedSizeUnsignedInteger.Fixed64BitUnsignedInteger.valueOf(BigInteger.ONE));
  assertNotNull(request);
  
  MychainBaseResult<ReplyTransactionReceipt> replyTransactionReceipt = sdk
  .getContractService().callContract(request);

EVM 数据解析

• ContractReturnValues

EVM 合约编码说明

EVM 的参数和返回值编码规则一致，都与 Solidity 合约一样。对于静态类型的变量，直接编码为 32 字节按顺序拼接。对应动态数据类型，则用一个 32 字节偏移量占住位置，所有动态数据类型的真实数据按顺序以 LV 的格式放在后面。其中 L 表示数据的实际长度，L 占用 32 字节；V 为实际数据。

下面通过示例进行详细说明。

要返回的多值结果列表

假设要返回一个多值结果列表，如下表所示。

编码结果

编码结果如下：

  0000000000000000000000000000000000000000000000000000000000000064
  00000000000000000000000000000000000000000000000000000000000000a0
  00000000000000000000000000000000000000000000000000000000000000e0
  0000000000000000000000000000000000000000000000000000000000000001
  e7d3e769f3f593dadcb8634cc5b09fc90dd3a61c4a06a79cb0923662fe6fae6b
  0000000000000000000000000000000000000000000000000000000000000003
  6162630000000000000000000000000000000000000000000000000000000000
  0000000000000000000000000000000000000000000000000000000000000024
  303132333435363738396162636465666768696a6b6c6d6e6f70717273747576
  7778797a00000000000000000000000000000000000000000000000000000000

具体解析

• 0000000000000000000000000000000000000000000000000000000000000064 为“100”的编码，uint 类型，定长 32 字节，是大端编码。

• 00000000000000000000000000000000000000000000000000000000000000a0“abc”为动态类型，这里的 a0 为其实际数据编码所处偏移位置。因为这里一共 5 个变量，每个变量占用 0x20 个字节，所以第一个动态类型的数据偏移位置就是 5*0x20=0xA0，偏移量的编码规则和 uint 一样。

• 000000000000000000000000000000000000000000000000000000000000000e0 “0123456789abcdefghijklmopqrstuvwxyz” 为动态类型，这里 e0 为其实际数据编码所处偏移位置。本数据在“abc”之后，由于“abc”的长度和数据各占 0x20 字节，所以本数据就在 0xA0+0x40=0xE0 的位置。

• 00000000000000000000000000000000000000000000000000000000000000001 为“true” 的编码，bool 型数据，定长 32 字节。true 最后一个字节为 01；false 最后一个字节为 00。

• 1e7d3e769f3f593dadcb8634cc5b09fc90dd3a61c4a06a79cb0923662fe6fae6b 是一个 “Identity” 类型的编码，与源数据完全一致。

• 00000000000000000000000000000000000000000000000000000000000000003 为“abc”的长度，编码规则和 uint 一样。

• 61626300000000000000000000000000000000000000000000000000000000000 为“abc”的实际数据，String 类型的数据占用长度为 32 的整数倍，实际数据靠左编码，后面填充 00。

• 00000000000000000000000000000000000000000000000000000000000000024 为 “0123456789abcdefghijklmnopqrstuvwxyz” 的编码，长度为 36=0x24。

• 303132333435363738396162636465666768696a6b6c6d6e6f70717273747576，7778797a00000000000000000000000000000000000000000000000000000000 为“0123456789abcdefghijklmnopqrstuvwxyz”的实际数据编码。

  // 获取返回值解码示例
  ContractReturnValues contractReturnValues = new ContractReturnValues(ByteUtils.toHexString(replyTransactionReceipt.getData().getTransactionReceipt().getOutput()));
  //按顺序获得返回值
   BigInteger bigInteger = contractReturnValues.getUint(); // 100
   String string = contractReturnValues.getString();       // "abc"
   // "0123456789abcdefghijklmnopqrstuvwxyz"
   String string1 = contractReturnValues.getString(); 
   boolean b = contractReturnValues.getBoolean();          // true 
  // "1e7d3e769f3f593dadcb8634cc5b09fc90dd3a61c4a06a79cb0923662fe6fae6b"
  Identity id = contractReturnValues.getIdentity();