Struct fuels_contract::contract::ContractCallHandler
source · pub struct ContractCallHandler<D> {
pub contract_call: ContractCall,
pub tx_parameters: TxParameters,
pub wallet: WalletUnlocked,
pub provider: Provider,
pub datatype: PhantomData<D>,
pub log_decoder: LogDecoder,
}
Expand description
Helper that handles submitting a call to a client and formatting the response
Fields§
§contract_call: ContractCall
§tx_parameters: TxParameters
§wallet: WalletUnlocked
§provider: Provider
§datatype: PhantomData<D>
§log_decoder: LogDecoder
Implementations§
source§impl<D> ContractCallHandler<D>where
D: Tokenizable + Debug,
impl<D> ContractCallHandler<D>where
D: Tokenizable + Debug,
sourcepub fn set_contracts(self, contract_ids: &[Bech32ContractId]) -> Self
pub fn set_contracts(self, contract_ids: &[Bech32ContractId]) -> Self
Sets external contracts as dependencies to this contract’s call.
Effectively, this will be used to create Input::Contract
/Output::Contract
pairs and set them into the transaction.
Note that this is a builder method, i.e. use it as a chain:
my_contract_instance.my_method(...).set_contracts(&[another_contract_id]).call()
sourcepub fn append_contract(self, contract_id: Bech32ContractId) -> Self
pub fn append_contract(self, contract_id: Bech32ContractId) -> Self
Appends additional external contracts as dependencies to this contract’s call.
Effectively, this will be used to create additional
Input::Contract
/Output::Contract
pairs
and set them into the transaction.
Note that this is a builder method, i.e. use it as a chain:
my_contract_instance.my_method(...).append_contracts(additional_contract_id).call()
sourcepub fn tx_params(self, params: TxParameters) -> Self
pub fn tx_params(self, params: TxParameters) -> Self
Sets the transaction parameters for a given transaction. Note that this is a builder method, i.e. use it as a chain:
let params = TxParameters { gas_price: 100, gas_limit: 1000000 };
my_contract_instance.my_method(...).tx_params(params).call()
sourcepub fn call_params(self, params: CallParameters) -> Self
pub fn call_params(self, params: CallParameters) -> Self
Sets the call parameters for a given contract call. Note that this is a builder method, i.e. use it as a chain:
let params = CallParameters { amount: 1, asset_id: BASE_ASSET_ID };
my_contract_instance.my_method(...).call_params(params).call()
sourcepub fn append_variable_outputs(self, num: u64) -> Self
pub fn append_variable_outputs(self, num: u64) -> Self
Appends num
Output::Variable
s to the transaction.
Note that this is a builder method, i.e. use it as a chain:
my_contract_instance.my_method(...).add_variable_outputs(num).call()
sourcepub fn append_message_outputs(self, num: u64) -> Self
pub fn append_message_outputs(self, num: u64) -> Self
Appends num
Output::Message
s to the transaction.
Note that this is a builder method, i.e. use it as a chain:
my_contract_instance.my_method(...).add_message_outputs(num).call()
sourcepub async fn get_executable_call(&self) -> Result<ExecutableFuelCall, Error>
pub async fn get_executable_call(&self) -> Result<ExecutableFuelCall, Error>
Returns the script that executes the contract call
sourcepub async fn call(self) -> Result<FuelCallResponse<D>, Error>
pub async fn call(self) -> Result<FuelCallResponse<D>, Error>
Call a contract’s method on the node, in a state-modifying manner.
sourcepub async fn simulate(self) -> Result<FuelCallResponse<D>, Error>
pub async fn simulate(self) -> Result<FuelCallResponse<D>, Error>
Call a contract’s method on the node, in a simulated manner, meaning the state of the
blockchain is not modified but simulated.
It is the same as the call
method because the API is more user-friendly this way.
sourcepub async fn estimate_tx_dependencies(
self,
max_attempts: Option<u64>
) -> Result<Self, Error>
pub async fn estimate_tx_dependencies(
self,
max_attempts: Option<u64>
) -> Result<Self, Error>
Simulates the call and attempts to resolve missing tx dependencies. Forwards the received error if it cannot be fixed.
sourcepub async fn estimate_transaction_cost(
&self,
tolerance: Option<f64>
) -> Result<TransactionCost, Error>
pub async fn estimate_transaction_cost(
&self,
tolerance: Option<f64>
) -> Result<TransactionCost, Error>
Get a contract’s estimated cost
sourcepub fn get_response(
&self,
receipts: Vec<Receipt>
) -> Result<FuelCallResponse<D>, Error>
pub fn get_response(
&self,
receipts: Vec<Receipt>
) -> Result<FuelCallResponse<D>, Error>
Create a FuelCallResponse
from call receipts