Class MultiCallInvocationScope<TReturn>

Represents a scope for invoking multiple calls.

Type Parameters

TReturn = any
The type of the return value.

Hierarchy

BaseInvocationScope<TReturn>
- MultiCallInvocationScope

Constructors

constructor

new MultiCallInvocationScope<TReturn>(contract, funcScopes): MultiCallInvocationScope<TReturn>
Constructs an instance of MultiCallInvocationScope.
Type Parameters
- TReturn = any
Parameters
- contract: AbstractContract
  The contract.
- funcScopes: FunctionInvocationScope<any[], any>[]
  An array of function invocation scopes.
Returns MultiCallInvocationScope<TReturn>
Overrides BaseInvocationScope<TReturn>.constructor
- Defined in functions/multicall-scope.ts:19

Properties

`Protected` `Optional`assembleTxParameters

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

`Protected`externalAbis

externalAbis: Record<string, JsonAbi> = {}

`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): MultiCallInvocationScope<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 MultiCallInvocationScope<TReturn>
The current instance of the class.
Inherited from BaseInvocationScope.addBatchTransfer
- Defined in functions/base-invocation-scope.ts:415

addCall

addCall(funcScope): MultiCallInvocationScope<TReturn>
Adds a single function invocation scope to the multi-call invocation scope.
Parameters
- funcScope: FunctionInvocationScope<any[], any>
  The function invocation scope.
Returns MultiCallInvocationScope<TReturn>
The instance of MultiCallInvocationScope.
Overrides BaseInvocationScope.addCall
- Defined in functions/multicall-scope.ts:30

addCalls

addCalls(funcScopes): MultiCallInvocationScope<TReturn>
Adds multiple function invocation scopes to the multi-call invocation scope.
Parameters
- funcScopes: FunctionInvocationScope<any[], any>[]
  An array of function invocation scopes.
Returns MultiCallInvocationScope<TReturn>
The instance of MultiCallInvocationScope.
Overrides BaseInvocationScope.addCalls
- Defined in functions/multicall-scope.ts:40

addContracts

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

addSigners

addSigners(signers): MultiCallInvocationScope<TReturn>
Adds signers to the transaction request.
Parameters
- signers: Account | Account[]
  The signers to add.
Returns MultiCallInvocationScope<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): MultiCallInvocationScope<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 MultiCallInvocationScope<TReturn>
The current instance of the class.
Inherited from BaseInvocationScope.addTransfer
- Defined in functions/base-invocation-scope.ts:398

assembleTxParams

assembleTxParams(txParams): MultiCallInvocationScope<TReturn>
Sets the transaction parameters.
Parameters
- txParams: Partial<Omit<AssembleTxParams, "request">>
Returns MultiCallInvocationScope<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

`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): MultiCallInvocationScope<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 MultiCallInvocationScope<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

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

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): MultiCallInvocationScope<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 MultiCallInvocationScope<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 MultiCallInvocationScope<TReturn>

Type Parameters

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Type Parameters

Parameters

Returns MultiCallInvocationScope<TReturn>

Properties

Protected OptionalassembleTxParameters

ProtectedexternalAbis

ProtectedfunctionInvocationScopes

ProtectedhasCallParamsGasLimit

ProtectedisMultiCall

Protectedprogram

ProtectedrequiredCoins

ProtectedtransactionRequest

Protected OptionaltxParameters

Accessors

Protectedcalls

Returns ContractCall[]

Methods

addBatchTransfer

Parameters

Returns MultiCallInvocationScope<TReturn>

addCall

Parameters

Returns MultiCallInvocationScope<TReturn>

addCalls

Parameters

Returns MultiCallInvocationScope<TReturn>

addContracts

Parameters

Returns MultiCallInvocationScope<TReturn>

addSigners

Parameters

Returns MultiCallInvocationScope<TReturn>

Deprecated

addTransfer

Parameters

Returns MultiCallInvocationScope<TReturn>

assembleTxParams

Parameters

Returns MultiCallInvocationScope<TReturn>

call

Type Parameters

Parameters

OptionalskipAssembleTx?: boolean

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

ProtectedcheckGasLimitTotal

Returns void

dryRun

Type Parameters

Returns Promise<DryRunResult<T>>

Deprecated

fromRequest

Parameters

Returns MultiCallInvocationScope<TReturn>

fundWithRequiredCoins

Returns Promise<ScriptTransactionRequest>

get

Type Parameters

Returns Promise<DryRunResult<T>>

getProvider

Returns Provider

ProtectedgetRequiredCoins

Returns CoinQuantity[]

getTransactionCost

Returns Promise<TransactionCost>

Deprecated

getTransactionRequest

Returns Promise<ScriptTransactionRequest>

ProtectedprepareTransaction

Returns Promise<void>

simulate

`Protected` `Optional`assembleTxParameters

`Protected`externalAbis

`Protected`functionInvocationScopes

`Protected`hasCallParamsGasLimit

`Protected`isMultiCall

`Protected`program

`Protected`requiredCoins

`Protected`transactionRequest

`Protected` `Optional`txParameters

`Protected`calls

`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