internal static QueryContractParams QueryParameters(QueryContractParams queryParameters)
{
if (queryParameters is null)
{
throw new ArgumentNullException(nameof(queryParameters), "The query parameters are missing. Please check that the argument is not null.");
}
return(queryParameters);
}
internal ContractCallLocalQuery(QueryContractParams queryParameters) : this()
{
if (queryParameters is null)
{
throw new ArgumentNullException(nameof(queryParameters), "The query parameters are missing. Please check that the argument is not null.");
}
ContractID = new ContractID(queryParameters.Contract);
Gas = queryParameters.Gas;
FunctionParameters = ByteString.CopyFrom(Abi.EncodeFunctionWithArguments(queryParameters.FunctionName, queryParameters.FunctionArgs).Span);
_throwOnFail = queryParameters.ThrowOnFail;
}
protected async Task HandleValidSubmit()
{
_output = null;
await _network.ExecuteAsync(_input.Gateway, _input.Payer, async client =>
{
var queryParams = new QueryContractParams
{
Contract = _input.Contract,
Gas = _input.Gas.GetValueOrDefault(),
ReturnValueCharge = _input.ReturnValueCharge.GetValueOrDefault(),
MaxAllowedReturnSize = _input.MaxAllowedReturnSize.GetValueOrDefault(),
FunctionName = _input.FunctionName,
FunctionArgs = _input.Arguments.ToArray()
};
_output = await client.QueryContractAsync(queryParams, ctx => ctx.Memo = _input.Memo?.Trim());
});
}
/// <summary>
/// Calls a smart contract function locally on the gateway node.
/// </summary>
/// <remarks>
/// This is performed locally on the gateway node. It cannot change the state of the contract instance
/// (and so, cannot spend anything from the instance's cryptocurrency account). It will not have a
/// consensus timestamp nor a record or a receipt. The response will contain the output returned
/// by the function call.
/// </remarks>
/// <param name="queryParameters">
/// The parameters identifying the contract and function method to call.
/// </param>
/// <param name="configure">
/// Optional callback method providing an opportunity to modify
/// the execution configuration for just this method call.
/// It is executed prior to submitting the request to the network.
/// </param>
/// <returns>
/// The results from the local contract query call.
/// </returns>
/// <exception cref="ArgumentOutOfRangeException">If required arguments are missing.</exception>
/// <exception cref="InvalidOperationException">If required context configuration is missing.</exception>
/// <exception cref="PrecheckException">If the gateway node create rejected the request upon submission.</exception>
/// <exception cref="ContractException">If the request was accepted by the network but the cotnract failed for
/// some reason. Contains additional information returned from the contract virual machine. Only thrown if
/// the <see cref="QueryContractParams.ThrowOnFail"/> is set to <code>true</code>, the default, otherwise
/// the method returns a <see cref="ContractCallResult"/> with the same information.</exception>
public async Task <ContractCallResult> QueryContractAsync(QueryContractParams queryParameters, Action <IContext>?configure = null)
{
return(new ContractCallResult(await ExecuteQueryAsync(new ContractCallLocalQuery(queryParameters), configure, queryParameters.ReturnValueCharge).ConfigureAwait(false)));
}