Icon HelpCircleForumIcon Link

⌘K

Icon HelpCircleForumIcon Link

Icon LinkClass: Account

@fuel-ts/wallet .Account

Account provides an abstraction for interacting with accounts or wallets on the network.

Icon LinkHierarchy

Icon LinkConstructors

Icon Linkconstructor

new Account(address, provider?): Account

Creates a new Account instance.

Icon LinkParameters

Name
Type
Description
address
The address of the account.
provider?
A Provider instance (optional).

Icon LinkReturns

Account

Icon LinkOverrides

AbstractAccount .constructor

Icon LinkDefined in

account.ts:62 Icon Link

Icon LinkProperties

Icon Link_provider

Protected Optional _provider: Provider

The provider used to interact with the network.

Icon LinkDefined in

account.ts:54 Icon Link


Icon Linkaddress

Readonly address: AbstractAddress

The address associated with the account.

Icon LinkOverrides

AbstractAccount .address

Icon LinkDefined in

account.ts:49 Icon Link

Icon LinkAccessors

Icon Linkprovider

get provider(): Provider

The provider used to interact with the network.

Throws

FuelError if the provider is not set.

Icon LinkReturns

Provider

A Provider instance.

Icon LinkOverrides

AbstractAccount.provider

Icon LinkDefined in

account.ts:75 Icon Link

set provider(provider): void

Sets the provider for the account.

Icon LinkParameters

Name
Type
Description
provider
A Provider instance.

Icon LinkReturns

void

Icon LinkOverrides

AbstractAccount.provider

Icon LinkDefined in

account.ts:88 Icon Link

Icon LinkMethods

Icon Linkconnect

connect(provider): Provider

Changes the provider connection for the account.

Icon LinkParameters

Name
Type
Description
provider
A Provider instance.

Icon LinkReturns

Provider

The updated Provider instance.

Icon LinkDefined in

account.ts:98 Icon Link


Icon LinkcreateTransfer

createTransfer(destination, amount, assetId?, txParams?): Promise<TransactionRequest >

A helper that creates a transfer transaction request and returns it.

Icon LinkParameters

Name
Type
Default value
Description
destination
undefined
The address of the destination.
amount
BigNumberish
undefined
The amount of coins to transfer.
assetId
BytesLike
BaseAssetId
The asset ID of the coins to transfer.
txParams
{}
The transaction parameters (gasLimit, gasPrice, maturity).

Icon LinkReturns

Promise<TransactionRequest >

A promise that resolves to the prepared transaction request.

Icon LinkDefined in

account.ts:318 Icon Link


Icon Linkfund

fund<T>(request, coinQuantities, fee): Promise<void>

Adds resources to the transaction enough to fund it.

Icon LinkType parameters

Name
Type
T

Icon LinkParameters

Name
Type
Description
request
T
The transaction request.
coinQuantities
The coin quantities required to execute the transaction.
fee
BN
The estimated transaction fee.

Icon LinkReturns

Promise<void>

A promise that resolves when the resources are added to the transaction.

Icon LinkOverrides

AbstractAccount .fund

Icon LinkDefined in

account.ts:239 Icon Link


Icon LinkgetBalance

getBalance(assetId?): Promise<BN>

Retrieves the balance of the account for the given asset.

Icon LinkParameters

Name
Type
Default value
Description
assetId
BytesLike
BaseAssetId
The asset ID to check the balance for.

Icon LinkReturns

Promise<BN>

A promise that resolves to the balance amount.

Icon LinkDefined in

account.ts:192 Icon Link


Icon LinkgetBalances

getBalances(): Promise<CoinQuantity []>

Retrieves all the balances for the account.

Icon LinkReturns

Promise<CoinQuantity []>

A promise that resolves to an array of Coins and their quantities.

Icon LinkDefined in

account.ts:202 Icon Link


Icon LinkgetCoins

getCoins(assetId?): Promise<Coin []>

Retrieves coins owned by the account.

Icon LinkParameters

Name
Type
Description
assetId?
BytesLike
The asset ID of the coins to retrieve.

Icon LinkReturns

Promise<Coin []>

A promise that resolves to an array of Coins.

Icon LinkDefined in

account.ts:123 Icon Link


Icon LinkgetMessages

getMessages(): Promise<Message []>

Retrieves messages owned by the account.

Icon LinkReturns

Promise<Message []>

A promise that resolves to an array of Messages.

Icon LinkDefined in

account.ts:157 Icon Link


Icon LinkgetResourcesToSpend

getResourcesToSpend(quantities, excludedIds?): Promise<Resource []>

Retrieves resources satisfying the spend query for the account.

Icon LinkParameters

Name
Type
Description
quantities
IDs of coins to exclude.
excludedIds?
ExcludeResourcesOption
IDs of resources to be excluded from the query.

Icon LinkReturns

Promise<Resource []>

A promise that resolves to an array of Resources.

Icon LinkOverrides

AbstractAccount .getResourcesToSpend

Icon LinkDefined in

account.ts:110 Icon Link


Icon LinksendTransaction

sendTransaction(transactionRequestLike, options?): Promise<TransactionResponse >

Sends a transaction to the network.

Icon LinkParameters

Name
Type
Description
transactionRequestLike
The transaction request to be sent.
options?
Pick<ProviderSendTxParams , "awaitExecution">
-

Icon LinkReturns

Promise<TransactionResponse >

A promise that resolves to the transaction response.

Icon LinkOverrides

AbstractAccount .sendTransaction

Icon LinkDefined in

account.ts:458 Icon Link


Icon LinksimulateTransaction

simulateTransaction(transactionRequestLike): Promise<CallResult >

Simulates a transaction.

Icon LinkParameters

Name
Type
Description
transactionRequestLike
The transaction request to be simulated.

Icon LinkReturns

Promise<CallResult >

A promise that resolves to the call result.

Icon LinkOverrides

AbstractAccount .simulateTransaction

Icon LinkDefined in

account.ts:476 Icon Link


Icon Linktransfer

transfer(destination, amount, assetId?, txParams?): Promise<TransactionResponse >

Transfers coins to a destination address.

Icon LinkParameters

Name
Type
Default value
Description
destination
undefined
The address of the destination.
amount
BigNumberish
undefined
The amount of coins to transfer.
assetId
BytesLike
BaseAssetId
The asset ID of the coins to transfer.
txParams
{}
The transaction parameters (gasLimit, gasPrice, maturity).

Icon LinkReturns

Promise<TransactionResponse >

A promise that resolves to the transaction response.

Icon LinkDefined in

account.ts:346 Icon Link


Icon LinktransferToContract

transferToContract(contractId, amount, assetId?, txParams?): Promise<TransactionResponse >

Transfers coins to a contract address.

Icon LinkParameters

Name
Type
Default value
Description
contractId
undefined
The address of the contract.
amount
BigNumberish
undefined
The amount of coins to transfer.
assetId
BytesLike
BaseAssetId
The asset ID of the coins to transfer.
txParams
{}
The optional transaction parameters.

Icon LinkReturns

Promise<TransactionResponse >

A promise that resolves to the transaction response.

Icon LinkDefined in

account.ts:369 Icon Link


Icon LinkwithdrawToBaseLayer

withdrawToBaseLayer(recipient, amount, txParams?): Promise<TransactionResponse >

Withdraws an amount of the base asset to the base chain.

Icon LinkParameters

Name
Type
Description
recipient
Address of the recipient on the base chain.
amount
BigNumberish
Amount of base asset.
txParams
The optional transaction parameters.

Icon LinkReturns

Promise<TransactionResponse >

A promise that resolves to the transaction response.

Icon LinkDefined in

account.ts:416 Icon Link