Class FunctionInvocationScope<TArgs, TReturn>

Represents a scope for invoking a function.

Type Parameters

TArgs extends any[] = any[]
The type of the function arguments.
TReturn = any
The type of the return value.

Hierarchy

BaseInvocationScope<TReturn>
- FunctionInvocationScope

Constructors

constructor

new FunctionInvocationScope<TArgs, TReturn>(program, func, args): FunctionInvocationScope<TArgs, TReturn>
Constructs an instance of FunctionInvocationScope.
Type Parameters
- TArgs extends any[] = any[]
- TReturn = any
Parameters
- program: AbstractProgram
  The program.
- func: FunctionFragment
  The function fragment.
- args: TArgs
  The arguments.
Returns FunctionInvocationScope<TArgs, TReturn>
Overrides BaseInvocationScope<TReturn>.constructor
- Defined in functions/invocation-scope.ts:33

Properties

`Protected`args

args: TArgs

`Protected` `Optional`assembleTxParameters

assembleTxParameters?: Partial<Omit<AssembleTxParams, "request">>

`Protected`externalAbis

externalAbis: Record<string, JsonAbi> = {}

`Protected`func

func: FunctionFragment

`Protected`functionInvocationScopes

functionInvocationScopes: InvocationScopeLike[] = []

`Protected`hasCallParamsGasLimit

hasCallParamsGasLimit: boolean = false

`Protected`isMultiCall

isMultiCall: boolean = false

`Protected`program

program: AbstractProgram

`Protected`requiredCoins

requiredCoins: CoinQuantity[] = []

`Protected`transactionRequest

transactionRequest: ScriptTransactionRequest

`Protected` `Optional`txParameters

txParameters?: Partial<{
    expiration?: number;
    gasLimit: BigNumberish;
    maturity?: number;
    maxFee?: BigNumberish;
    tip: BigNumberish;
    variableOutputs: number;
    witnessLimit?: BigNumberish;
}>

Accessors

`Protected`calls

get calls(): ContractCall[]
Getter for the contract calls.

Returns ContractCall[]
An array of contract calls.
Inherited from BaseInvocationScope.calls
- Defined in functions/base-invocation-scope.ts:106

Methods

addBatchTransfer

addBatchTransfer(transferParams): FunctionInvocationScope<TArgs, TReturn>
Adds multiple transfers to the contract call transaction request.
Parameters
- transferParams: TransferParams[]
  An array of TransferParams objects representing the transfers to be made.
Returns FunctionInvocationScope<TArgs, TReturn>
The current instance of the class.
Inherited from BaseInvocationScope.addBatchTransfer
- Defined in functions/base-invocation-scope.ts:415

`Protected`addCall

addCall(funcScope): FunctionInvocationScope<TArgs, TReturn>
Adds a single call to the invocation scope.
Parameters
- funcScope: InvocationScopeLike
  The function scope to add.
Returns FunctionInvocationScope<TArgs, TReturn>
The current instance of the class.
Inherited from BaseInvocationScope.addCall
- Defined in functions/base-invocation-scope.ts:183

`Protected`addCalls

addCalls(funcScopes): FunctionInvocationScope<TArgs, TReturn>
Adds multiple calls to the invocation scope.
Parameters
- funcScopes: InvocationScopeLike[]
  An array of function scopes to add.
Returns FunctionInvocationScope<TArgs, TReturn>
The current instance of the class.
Inherited from BaseInvocationScope.addCalls
- Defined in functions/base-invocation-scope.ts:194

addContracts

addContracts(contracts): FunctionInvocationScope<TArgs, TReturn>
Adds contracts to the invocation scope.
Parameters
- contracts: (string | AbstractContract)[]
  An array of contracts to add.
Returns FunctionInvocationScope<TArgs, TReturn>
The current instance of the class.
Inherited from BaseInvocationScope.addContracts
- Defined in functions/base-invocation-scope.ts:380

addSigners

addSigners(signers): FunctionInvocationScope<TArgs, TReturn>
Adds signers to the transaction request.
Parameters
- signers: Account | Account[]
  The signers to add.
Returns FunctionInvocationScope<TArgs, TReturn>
The current instance of the class.

Deprecated
This method is deprecated and will be removed in a future versions. All signatures should be manually added to the transaction request witnesses. If your Sway program relies on in-code signature validation, visit this guide: https://docs.fuel.network/docs/fuels-ts/cookbook/sway-script-with-signature-validation/
Inherited from BaseInvocationScope.addSigners
- Defined in functions/base-invocation-scope.ts:438

addTransfer

addTransfer(transferParams): FunctionInvocationScope<TArgs, TReturn>
Adds an asset transfer to an Account on the contract call transaction request.
Parameters
- transferParams: TransferParams
  The object representing the transfer to be made.
Returns FunctionInvocationScope<TArgs, TReturn>
The current instance of the class.
Inherited from BaseInvocationScope.addTransfer
- Defined in functions/base-invocation-scope.ts:398

assembleTxParams

assembleTxParams(txParams): FunctionInvocationScope<TArgs, TReturn>
Sets the transaction parameters.
Parameters
- txParams: Partial<Omit<AssembleTxParams, "request">>
Returns FunctionInvocationScope<TArgs, TReturn>
The current instance of the class.
Inherited from BaseInvocationScope.assembleTxParams
- Defined in functions/base-invocation-scope.ts:369

call

call<T>(params?): Promise<{
    transactionId: string;
    waitForPreConfirmation: (() => Promise<PreConfirmationFunctionResult<T>>);
    waitForResult: (() => Promise<FunctionResult<T>>);
}>
Submits the contract call transaction and returns a promise that resolves to an object containing the transaction ID and a function to wait for the result. The promise will resolve as soon as the transaction is submitted to the node.
Type Parameters
- T = TReturn
  The type of the return value.
Parameters
- Optionalparams: {
  skipAssembleTx?: boolean;
  }
  Optional parameters for the call.
  - skipAssembleTx: A boolean indicating whether to skip assembling the transaction. This is useful when customizations were made to the transaction request using the assembleTx method.
  - OptionalskipAssembleTx?: boolean
Returns Promise<{
    transactionId: string;
    waitForPreConfirmation: (() => Promise<PreConfirmationFunctionResult<T>>);
    waitForResult: (() => Promise<FunctionResult<T>>);
}>
A promise that resolves to an object containing:
- transactionId: The ID of the submitted transaction.
- waitForResult: A function that waits for the transaction result.
- waitForPreConfirmation: A function that waits for the transaction pre-confirmation.
Inherited from BaseInvocationScope.call
- Defined in functions/base-invocation-scope.ts:482

callParams

callParams(callParams): FunctionInvocationScope<TArgs, TReturn>
Sets the call parameters for the function invocation.
Parameters
- callParams: Partial<{
  forward: CoinQuantityLike;
  gasLimit: BigNumberish;
  }>
  The call parameters.
Returns FunctionInvocationScope<TArgs, TReturn>
The instance of FunctionInvocationScope.

Throws
If the function is not payable and forward is set.
- Defined in functions/invocation-scope.ts:76

`Protected`checkGasLimitTotal

checkGasLimitTotal(): void
Checks if the total gas limit is within the acceptable range.

Returns void
Inherited from BaseInvocationScope.checkGasLimitTotal
- Defined in functions/base-invocation-scope.ts:226

dryRun

dryRun<T>(): Promise<DryRunResult<T>>
Executes a transaction in dry run mode.
Type Parameters
- T = TReturn
Returns Promise<DryRunResult<T>>
The result of the invocation call.

Deprecated
Use .get instead
Inherited from BaseInvocationScope.dryRun
- Defined in functions/base-invocation-scope.ts:562

fromRequest

fromRequest(request): FunctionInvocationScope<TArgs, TReturn>
Sets the transaction request. Useful when you have used getTransactionRequest or fundWithRequiredCoins from the scope to apply customizations to the transaction request.
Parameters
- request: ScriptTransactionRequest
  The transaction request to set.
Returns FunctionInvocationScope<TArgs, TReturn>
The current instance of the class.
Inherited from BaseInvocationScope.fromRequest
- Defined in functions/base-invocation-scope.ts:462

fundWithRequiredCoins

fundWithRequiredCoins(): Promise<ScriptTransactionRequest>
Funds the transaction request with the required coins and returns it.

Returns Promise<ScriptTransactionRequest>
The transaction request.
Inherited from BaseInvocationScope.fundWithRequiredCoins
- Defined in functions/base-invocation-scope.ts:262

get

get<T>(): Promise<DryRunResult<T>>
Type Parameters
- T = TReturn
Returns Promise<DryRunResult<T>>
Inherited from BaseInvocationScope.get
- Defined in functions/base-invocation-scope.ts:576

getCallConfig

getCallConfig(): CallConfig<TArgs>
Gets the call configuration.

Returns CallConfig<TArgs>
The call configuration.
- Defined in functions/invocation-scope.ts:46

getProvider

getProvider(): Provider
Returns Provider
Inherited from BaseInvocationScope.getProvider
- Defined in functions/base-invocation-scope.ts:621

`Protected`getRequiredCoins

getRequiredCoins(): CoinQuantity[]
Gets the required coins for the transaction.

Returns CoinQuantity[]
An array of required coin quantities.
Inherited from BaseInvocationScope.getRequiredCoins
- Defined in functions/base-invocation-scope.ts:146

getTransactionCost

getTransactionCost(): Promise<TransactionCost>
Gets the transaction cost for dry running the transaction.

Returns Promise<TransactionCost>
The transaction cost details.

Deprecated
Use contract.fundWithRequiredCoins instead Check the migration guide https://docs.fuel.network/docs/fuels-ts/transactions/assemble-tx-migration-guide/ for more information.
Inherited from BaseInvocationScope.getTransactionCost
- Defined in functions/base-invocation-scope.ts:247

getTransactionRequest

getTransactionRequest(): Promise<ScriptTransactionRequest>
Prepares and returns the transaction request object.

Returns Promise<ScriptTransactionRequest>
The prepared transaction request.
Inherited from BaseInvocationScope.getTransactionRequest
- Defined in functions/base-invocation-scope.ts:450

`Protected`prepareTransaction

prepareTransaction(): Promise<void>
Prepares the transaction by updating the script request, required coins, and checking the gas limit.

Returns Promise<void>
Inherited from BaseInvocationScope.prepareTransaction
- Defined in functions/base-invocation-scope.ts:204

setArguments

setArguments(...args): FunctionInvocationScope<TArgs, TReturn>
Sets the arguments for the function invocation.
Parameters
- Rest...args: TArgs
  The arguments.
Returns FunctionInvocationScope<TArgs, TReturn>
The instance of FunctionInvocationScope.
- Defined in functions/invocation-scope.ts:64

simulate

simulate<T>(): Promise<DryRunResult<T>>
Simulates a transaction.
Type Parameters
- T = TReturn
Returns Promise<DryRunResult<T>>
The result of the invocation call.
Inherited from BaseInvocationScope.simulate
- Defined in functions/base-invocation-scope.ts:533

txParams

txParams(txParams): FunctionInvocationScope<TArgs, TReturn>
Sets the transaction parameters.
Parameters
- txParams: Partial<{
      expiration?: number;
      gasLimit: BigNumberish;
      maturity?: number;
      maxFee?: BigNumberish;
      tip: BigNumberish;
      variableOutputs: number;
      witnessLimit?: BigNumberish;
  }>
  The transaction parameters to set.
Returns FunctionInvocationScope<TArgs, TReturn>
The current instance of the class.
Inherited from BaseInvocationScope.txParams
- Defined in functions/base-invocation-scope.ts:347

`Protected`updateContractInputAndOutput

updateContractInputAndOutput(): void
Updates the transaction request with the current input/output.

Returns void
Inherited from BaseInvocationScope.updateContractInputAndOutput
- Defined in functions/base-invocation-scope.ts:127

`Protected`updateRequiredCoins

updateRequiredCoins(): void
Updates the required coins for the transaction.

Returns void
Inherited from BaseInvocationScope.updateRequiredCoins
- Defined in functions/base-invocation-scope.ts:159

`Protected`updateScriptRequest

updateScriptRequest(): Promise<void>
Updates the script request with the current contract calls.

Returns Promise<void>
Inherited from BaseInvocationScope.updateScriptRequest
- Defined in functions/base-invocation-scope.ts:113

Class FunctionInvocationScope<TArgs, TReturn>

Type Parameters

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Type Parameters

Parameters

Returns FunctionInvocationScope<TArgs, TReturn>

Properties

Protectedargs

Protected OptionalassembleTxParameters

ProtectedexternalAbis

Protectedfunc

ProtectedfunctionInvocationScopes

ProtectedhasCallParamsGasLimit

ProtectedisMultiCall

Protectedprogram

ProtectedrequiredCoins

ProtectedtransactionRequest

Protected OptionaltxParameters

Accessors

Protectedcalls

Returns ContractCall[]

Methods

addBatchTransfer

Parameters

Returns FunctionInvocationScope<TArgs, TReturn>

ProtectedaddCall

Parameters

Returns FunctionInvocationScope<TArgs, TReturn>

ProtectedaddCalls

Parameters

Returns FunctionInvocationScope<TArgs, TReturn>

addContracts

Parameters

Returns FunctionInvocationScope<TArgs, TReturn>

addSigners

Parameters

Returns FunctionInvocationScope<TArgs, TReturn>

Deprecated

addTransfer

Parameters

Returns FunctionInvocationScope<TArgs, TReturn>

assembleTxParams

Parameters

Returns FunctionInvocationScope<TArgs, TReturn>

call

Type Parameters

Parameters

OptionalskipAssembleTx?: boolean

Returns Promise<{ transactionId: string; waitForPreConfirmation: (() => Promise<PreConfirmationFunctionResult<T>>); waitForResult: (() => Promise<FunctionResult<T>>); }>

callParams

Parameters

Returns FunctionInvocationScope<TArgs, TReturn>

Throws

ProtectedcheckGasLimitTotal

Returns void

dryRun

Type Parameters

Returns Promise<DryRunResult<T>>

Deprecated

fromRequest

Parameters

Returns FunctionInvocationScope<TArgs, TReturn>

fundWithRequiredCoins

Returns Promise<ScriptTransactionRequest>

get

Type Parameters

Returns Promise<DryRunResult<T>>

getCallConfig

Returns CallConfig<TArgs>

getProvider

Returns Provider

ProtectedgetRequiredCoins

Returns CoinQuantity[]

`Protected`args

`Protected` `Optional`assembleTxParameters

`Protected`externalAbis

`Protected`func

`Protected`functionInvocationScopes

`Protected`hasCallParamsGasLimit

`Protected`isMultiCall

`Protected`program

`Protected`requiredCoins

`Protected`transactionRequest

`Protected` `Optional`txParameters

`Protected`calls

`Protected`addCall

`Protected`addCalls

`Optional`skipAssembleTx?: boolean

Returns Promise<{
transactionId: string;
waitForPreConfirmation: (() => Promise<PreConfirmationFunctionResult<T>>);
waitForResult: (() => Promise<FunctionResult<T>>);
}>

`Protected`checkGasLimitTotal

`Protected`getRequiredCoins

`Protected`prepareTransaction

`Protected`updateContractInputAndOutput

`Protected`updateRequiredCoins

`Protected`updateScriptRequest