@fuel-ts/program .FunctionInvocationScope
Represents a scope for invoking a function.
| Name | Type | Description |
|---|---|---|
TArgs | extends any[] = any[] | The type of the function arguments. |
TReturn | any | The type of the return value. |
BaseInvocationScope<TReturn>
↳ FunctionInvocationScope
• new FunctionInvocationScope<TArgs, TReturn>(program, func, args): FunctionInvocationScope <TArgs, TReturn>
Constructs an instance of FunctionInvocationScope.
| Name | Type |
|---|---|
TArgs | extends any[] = any[] |
TReturn | any |
| Name | Type | Description |
|---|---|---|
program | AbstractProgram | The program. |
func | FunctionFragment<JsonAbi, string> | The function fragment. |
args | TArgs | The arguments. |
FunctionInvocationScope <TArgs, TReturn>
BaseInvocationScope<TReturn>.constructor
packages/program/src/functions/invocation-scope.ts:34
• Protected args: TArgs
packages/program/src/functions/invocation-scope.ts:25
• Private Optional callParameters: Partial<{ forward: CoinQuantityLike ; gasLimit: BigNumberish }>
packages/program/src/functions/invocation-scope.ts:23
• Private Optional forward: CoinQuantity
packages/program/src/functions/invocation-scope.ts:24
• Protected func: FunctionFragment<JsonAbi, string>
packages/program/src/functions/invocation-scope.ts:22
• Protected functionInvocationScopes: InvocationScopeLike [] = []
BaseInvocationScope.functionInvocationScopes
packages/program/src/functions/base-invocation-scope.ts:52
• Protected isMultiCall: boolean = false
BaseInvocationScope.isMultiCall
packages/program/src/functions/base-invocation-scope.ts:55
• Protected program: AbstractProgram
BaseInvocationScope.program
packages/program/src/functions/base-invocation-scope.ts:51
• Protected requiredCoins: CoinQuantity [] = []
BaseInvocationScope.requiredCoins
packages/program/src/functions/base-invocation-scope.ts:54
• Protected transactionRequest: ScriptTransactionRequest
BaseInvocationScope.transactionRequest
packages/program/src/functions/base-invocation-scope.ts:50
• Protected Optional txParameters: Partial<{ gasLimit: BigNumberish ; gasPrice: BigNumberish ; maturity?: number ; maxFee?: BigNumberish ; variableOutputs: number ; witnessLimit?: BigNumberish }>
BaseInvocationScope.txParameters
packages/program/src/functions/base-invocation-scope.ts:53
• get calls(): ContractCall []
Getter for the contract calls.
ContractCall []
An array of contract calls.
BaseInvocationScope.calls
packages/program/src/functions/base-invocation-scope.ts:75
▸ addCall(funcScope): FunctionInvocationScope <TArgs, TReturn>
Adds a single call to the invocation scope.
| Name | Type | Description |
|---|---|---|
funcScope | InvocationScopeLike | The function scope to add. |
FunctionInvocationScope <TArgs, TReturn>
The current instance of the class.
BaseInvocationScope.addCall
packages/program/src/functions/base-invocation-scope.ts:154
▸ addCalls(funcScopes): FunctionInvocationScope <TArgs, TReturn>
Adds multiple calls to the invocation scope.
| Name | Type | Description |
|---|---|---|
funcScopes | InvocationScopeLike [] | An array of function scopes to add. |
FunctionInvocationScope <TArgs, TReturn>
The current instance of the class.
BaseInvocationScope.addCalls
packages/program/src/functions/base-invocation-scope.ts:165
▸ addContracts(contracts): FunctionInvocationScope <TArgs, TReturn>
Adds contracts to the invocation scope.
| Name | Type | Description |
|---|---|---|
contracts | AbstractContract [] | An array of contracts to add. |
FunctionInvocationScope <TArgs, TReturn>
The current instance of the class.
BaseInvocationScope.addContracts
packages/program/src/functions/base-invocation-scope.ts:268
▸ call<T>(): Promise<FunctionInvocationResult <T, void>>
Submits a transaction.
| Name | Type |
|---|---|
T | TReturn |
Promise<FunctionInvocationResult <T, void>>
The result of the function invocation.
BaseInvocationScope.call
packages/program/src/functions/base-invocation-scope.ts:291
▸ callParams(callParams): FunctionInvocationScope <TArgs, TReturn>
Sets the call parameters for the function invocation.
Throws
If the function is not payable and forward is set.
| Name | Type | Description |
|---|---|---|
callParams | Partial<{ forward: CoinQuantityLike ; gasLimit: BigNumberish }> | The call parameters. |
FunctionInvocationScope <TArgs, TReturn>
The instance of FunctionInvocationScope.
packages/program/src/functions/invocation-scope.ts:76
▸ checkGasLimitTotal(): void
Checks if the total gas limit is within the acceptable range.
void
BaseInvocationScope.checkGasLimitTotal
packages/program/src/functions/base-invocation-scope.ts:193
▸ dryRun<T>(): Promise<InvocationCallResult<T>>
Executes a transaction in dry run mode.
| Name | Type |
|---|---|
T | TReturn |
Promise<InvocationCallResult<T>>
The result of the invocation call.
BaseInvocationScope.dryRun
packages/program/src/functions/base-invocation-scope.ts:349
▸ fundWithRequiredCoins(fee): Promise<FunctionInvocationScope <TArgs, TReturn>>
Funds the transaction with the required coins.
| Name | Type |
|---|---|
fee | BN |
Promise<FunctionInvocationScope <TArgs, TReturn>>
The current instance of the class.
BaseInvocationScope.fundWithRequiredCoins
packages/program/src/functions/base-invocation-scope.ts:227
▸ getCallConfig(): CallConfig <TArgs>
Gets the call configuration.
CallConfig <TArgs>
The call configuration.
packages/program/src/functions/invocation-scope.ts:47
▸ getProvider(): Provider
BaseInvocationScope.getProvider
packages/program/src/functions/base-invocation-scope.ts:373
▸ getRequiredCoins(): CoinQuantity []
Gets the required coins for the transaction.
CoinQuantity []
An array of required coin quantities.
BaseInvocationScope.getRequiredCoins
packages/program/src/functions/base-invocation-scope.ts:117
▸ getTransactionCost(options?): Promise<TransactionCost >
Gets the transaction cost ny dry running the transaction.
| Name | Type | Description |
|---|---|---|
options? | Partial<{ fundTransaction: boolean ; gasPrice: BigNumberish }> | Optional transaction cost options. |
Promise<TransactionCost >
The transaction cost details.
BaseInvocationScope.getTransactionCost
packages/program/src/functions/base-invocation-scope.ts:212
▸ getTransactionId(chainId?): Promise<string>
Obtains the ID of a transaction.
| Name | Type | Description |
|---|---|---|
chainId? | number | the chainId to use to hash the transaction with |
Promise<string>
the ID of the transaction.
BaseInvocationScope.getTransactionId
packages/program/src/functions/base-invocation-scope.ts:385
▸ getTransactionRequest(): Promise<ScriptTransactionRequest >
Prepares and returns the transaction request object.
Promise<ScriptTransactionRequest >
The prepared transaction request.
BaseInvocationScope.getTransactionRequest
packages/program/src/functions/base-invocation-scope.ts:281
▸ prepareTransaction(): Promise<void>
Prepares the transaction by updating the script request, required coins, and checking the gas limit.
Promise<void>
BaseInvocationScope.prepareTransaction
packages/program/src/functions/base-invocation-scope.ts:175
▸ setArguments(...args): FunctionInvocationScope <TArgs, TReturn>
Sets the arguments for the function invocation.
| Name | Type | Description |
|---|---|---|
...args | TArgs | The arguments. |
FunctionInvocationScope <TArgs, TReturn>
The instance of FunctionInvocationScope.
packages/program/src/functions/invocation-scope.ts:64
▸ simulate<T>(): Promise<InvocationCallResult<T>>
Simulates a transaction.
| Name | Type |
|---|---|
T | TReturn |
Promise<InvocationCallResult<T>>
The result of the invocation call.
BaseInvocationScope.simulate
packages/program/src/functions/base-invocation-scope.ts:317
▸ txParams(txParams): FunctionInvocationScope <TArgs, TReturn>
Sets the transaction parameters.
| Name | Type | Description |
|---|---|---|
txParams | Partial<{ gasLimit: BigNumberish ; gasPrice: BigNumberish ; maturity?: number ; maxFee?: BigNumberish ; variableOutputs: number ; witnessLimit?: BigNumberish }> | The transaction parameters to set. |
FunctionInvocationScope <TArgs, TReturn>
The current instance of the class.
BaseInvocationScope.txParams
packages/program/src/functions/base-invocation-scope.ts:244
▸ updateContractInputAndOutput(): void
Updates the transaction request with the current input/output.
void
BaseInvocationScope.updateContractInputAndOutput
packages/program/src/functions/base-invocation-scope.ts:103
▸ updateRequiredCoins(): void
Updates the required coins for the transaction.
void
BaseInvocationScope.updateRequiredCoins
packages/program/src/functions/base-invocation-scope.ts:130
▸ updateScriptRequest(): void
Updates the script request with the current contract calls.
void
BaseInvocationScope.updateScriptRequest