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`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:91

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:331

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:296

addSigners

addSigners(signers): MultiCallInvocationScope<TReturn>
Parameters
- signers: Account | Account[]
Returns MultiCallInvocationScope<TReturn>
Inherited from BaseInvocationScope.addSigners
- Defined in functions/base-invocation-scope.ts:343

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:314

call

call<T>(): Promise<{
transactionId: string;
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.
Returns Promise<{
transactionId: string;
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.
Inherited from BaseInvocationScope.call
- Defined in functions/base-invocation-scope.ts:370

`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:211

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.
Inherited from BaseInvocationScope.dryRun
- Defined in functions/base-invocation-scope.ts:428

fundWithRequiredCoins

fundWithRequiredCoins(): Promise<ScriptTransactionRequest>
Costs and funds the underlying transaction request.

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

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:442

getProvider

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

`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:131

getTransactionCost

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

Returns Promise<TransactionCost>
The transaction cost details.
Inherited from BaseInvocationScope.getTransactionCost
- Defined in functions/base-invocation-scope.ts:229

getTransactionId

getTransactionId(chainId?): Promise<string>
Obtains the ID of a transaction.
Parameters
- OptionalchainId: number
  the chainId to use to hash the transaction with
Returns Promise<string>
the ID of the transaction.
Inherited from BaseInvocationScope.getTransactionId
- Defined in functions/base-invocation-scope.ts:468

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:355

`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:189

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:401

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:274

`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:112

`Protected`updateRequiredCoins

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

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

`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:98

Class MultiCallInvocationScope<TReturn>

Type Parameters

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Type Parameters

Parameters

Returns MultiCallInvocationScope<TReturn>

Properties

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>

addTransfer

Parameters

Returns MultiCallInvocationScope<TReturn>

call

Type Parameters

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

ProtectedcheckGasLimitTotal

Returns void

dryRun

Type Parameters

Returns Promise<DryRunResult<T>>

fundWithRequiredCoins

Returns Promise<ScriptTransactionRequest>

get

Type Parameters

Returns Promise<DryRunResult<T>>

getProvider

Returns Provider

ProtectedgetRequiredCoins

Returns CoinQuantity[]

getTransactionCost

Returns Promise<TransactionCost>

getTransactionId

Parameters

Returns Promise<string>

getTransactionRequest

Returns Promise<ScriptTransactionRequest>

ProtectedprepareTransaction

Returns Promise<void>

simulate

Type Parameters

Returns Promise<DryRunResult<T>>

txParams

Parameters

Returns MultiCallInvocationScope<TReturn>

ProtectedupdateContractInputAndOutput

Returns void

ProtectedupdateRequiredCoins

Returns void

`Protected`externalAbis

`Protected`functionInvocationScopes

`Protected`hasCallParamsGasLimit

`Protected`isMultiCall

`Protected`program

`Protected`requiredCoins

`Protected`transactionRequest

`Protected` `Optional`txParameters

`Protected`calls

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

`Protected`checkGasLimitTotal

`Protected`getRequiredCoins

`Protected`prepareTransaction

`Protected`updateContractInputAndOutput

`Protected`updateRequiredCoins

`Protected`updateScriptRequest