HomeGuidesAPI ReferenceChangelog
GuidesAPI ReferenceCommunityDiscordBlogFAQBug BountyAnnouncementsChange Log
API Reference

Interacting with Smart Contracts

Calling Constant Methods

Constant methods are those that read a value in a smart contract and do not alter the state of the smart contract. In Solidity, methods have the modifiers of view or pure are constant methods.

To call a method in trident-java, first to construct one:

Function name = new Function("name",
                Collections.emptyList(), Arrays.asList(new TypeReference<Utf8String>() {}));
//method name, input params, output params

Then, call the method via ApiWrapper.constantCall:

TransactionExtention extension = wrapper.constantCall("caller address", "contract address", name);

Finally, decode the constant result to human-readable text:

String result = Numeric.toHexString(txnExt.getConstantResult(0).toByteArray());

(String)FunctionReturnDecoder.decode(result, name.getOutputParameters()).get(0).getValue();

For USDT, the result should be:

> Tether USD

📘

Constant Calls

Constant calls are not resource consumption transactions.

Trigger Calls

Trigger calls change the state (compare with constant calls). The first half of trigger calls are the same as constant calls, and signature and broadcast are required. For example:

Function transfer = new Function("transfer",
                Arrays.asList(new Address(destAddr),
                        new Uint256(BigInteger.valueOf(amount).multiply(BigInteger.valueOf(10).pow(decimals)))),
                Arrays.asList(new TypeReference<Bool>() {}));

Call this method via ApiWrapper.triggerCall:

TransactionBuilder builder = wrapper.triggerCall("caller address", "contract address", transfer);

Rest steps are the same as normal transactions. Refer to Sending Transactions.

📘

Fee Limit Setting

Trigger calls require the setting of feeLimit, refer to Resource Model.