Class WalletUnlocked

Readonlyaddress

signer

StaticdefaultPath

privateKey

• get privateKey(): string

• Gets the private key of the wallet.

  Returns string

  The private key of the wallet.

provider

• get provider(): Provider

• The provider used to interact with the network.

  Returns Provider

  A Provider instance.

  Throws

  FuelError if the provider is not set.

• set provider(provider): void

• Sets the provider for the account.

  Parameters

  • provider: Provider

    A Provider instance.

  Returns void

publicKey

• get publicKey(): string

• Gets the public key of the wallet.

  Returns string

addBatchTransfer

• addBatchTransfer(request, transferParams): ScriptTransactionRequest

• Adds multiple transfers to a script transaction request.

  Parameters

  • request: ScriptTransactionRequest

    The script transaction request to add transfers to.
  • transferParams: TransferParams[]

    An array of TransferParams objects representing the transfers to be made.

  Returns ScriptTransactionRequest

  The updated script transaction request.

addTransfer

• addTransfer(request, transferParams): ScriptTransactionRequest

• Adds a transfer to the given transaction request.

  Parameters

  • request: ScriptTransactionRequest

    The script transaction request to add transfers to.
  • transferParams: TransferParams

    The object representing the transfer to be made.

  Returns ScriptTransactionRequest

  The updated transaction request with the added transfer.

assembleBaseAssetConsolidationTxs

• assembleBaseAssetConsolidationTxs(params): Promise<{
      submitAll: SubmitAllCallback;
      totalFeeCost: BN;
      txs: ScriptTransactionRequest[];
  }>

• Assembles transactions for consolidating base asset coins into fewer UTXOs.

  This method splits the provided coins into batches and creates transaction requests to consolidate them. It calculates the necessary fee and sets up the transactions to be submitted either in parallel (default) or sequentially.

  Parameters

  • params: AssembleConsolidationTxsParams

    The parameters for assembling base asset consolidation transactions.

  Returns Promise<{
      submitAll: SubmitAllCallback;
      totalFeeCost: BN;
      txs: ScriptTransactionRequest[];
  }>

  An object containing the assembled transactions, the total fee cost, and a callback to submit all transactions.

batchTransfer

• batchTransfer(transferParams, txParams?): Promise<TransactionResponse>

• Transfers multiple amounts of a token to multiple recipients.

  Parameters

  • transferParams: TransferParams[]

    An array of TransferParams objects representing the transfers to be made.
  • txParams: TxParamsType = {}

    Optional transaction parameters.

  Returns Promise<TransactionResponse>

  A promise that resolves to a TransactionResponse object representing the transaction result.

batchTransferToContracts

• batchTransferToContracts(contractTransferParams, txParams?): Promise<TransactionResponse>

• Parameters

  • contractTransferParams: ContractTransferParams[]
  • txParams: TxParamsType = {}

  Returns Promise<TransactionResponse>

connect

• connect(provider): Provider

• Changes the provider connection for the account.

  Parameters

  • provider: Provider

    A Provider instance.

  Returns Provider

  The updated Provider instance.

consolidateCoins

• consolidateCoins(params): Promise<SubmitAllCallbackResponse>

• Consolidates base asset UTXOs into fewer, larger ones.

  Retrieves a limited number of base asset coins (as defined by Provider.RESOURCES_PAGE_SIZE_LIMIT), assembles consolidation transactions, and submits them to the network.

  Note: This method currently supports only the base asset.

  Parameters

  • params: ConsolidateCoins

    The parameters for coin consolidation, including the asset ID, mode, and output number.

  Returns Promise<SubmitAllCallbackResponse>

  A promise that resolves to the response of the submitted transactions.

  Throws

  Will throw an error if the asset is not a base asset as non-base asset consolidation is not implemented.

createTransfer

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

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

  Parameters

  • destination: string | Address

    The address of the destination.
  • amount: BigNumberish

    The amount of coins to transfer.
  • OptionalassetId: BytesLike

    The asset ID of the coins to transfer (optional).
  • txParams: TxParamsType = {}

    The transaction parameters (optional).

  Returns Promise<ScriptTransactionRequest>

  A promise that resolves to the prepared transaction request.

encrypt

• encrypt(password): Promise<string>

• Encrypts an unlocked wallet with a password.

  Parameters

  • password: string

    the password to encrypt the wallet with.

  Returns Promise<string>

  • the encrypted wallet.

fund

• fund<T>(request, params): Promise<T>

• Funds a transaction request by adding the necessary resources.

  Type Parameters

  • T extends TransactionRequest

    The type of the TransactionRequest.

  Parameters

  • request: T

    The transaction request to fund.
  • params: EstimatedTxParams

    The estimated transaction parameters.

  Returns Promise<T>

  A promise that resolves to the funded transaction request.

  Deprecated

  Use provider.assembleTx instead Check the migration guide https://docs.fuel.network/guide/assembling-transactions/migration-guide.html for more information.

generateFakeResources

• generateFakeResources(coins): Resource[]

• Generates an array of fake resources based on the provided coins.

  Parameters

  • coins: FakeResources[]

    An array of FakeResources objects representing the coins.

  Returns Resource[]

  An array of Resource objects with generated properties.

getBalance

• getBalance(assetId?): Promise<BN>

• Retrieves the balance of the account for the given asset.

  Parameters

  • OptionalassetId: BytesLike

    The asset ID to check the balance for (optional).

  Returns Promise<BN>

  A promise that resolves to the balance amount.

getBalances

• getBalances(): Promise<GetBalancesResponse>

• Retrieves all the balances for the account.

  Returns Promise<GetBalancesResponse>

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

getCoins

• getCoins(assetId?, paginationArgs?): Promise<GetCoinsResponse>

• Retrieves coins owned by the account.

  Parameters

  • OptionalassetId: BytesLike

    The asset ID of the coins to retrieve (optional).
  • OptionalpaginationArgs: CursorPaginationArgs

  Returns Promise<GetCoinsResponse>

  A promise that resolves to an array of Coins.

getMessages

• getMessages(paginationArgs?): Promise<GetMessagesResponse>

• Retrieves messages owned by the account.

  Parameters

  • OptionalpaginationArgs: CursorPaginationArgs

  Returns Promise<GetMessagesResponse>

  A promise that resolves to an array of Messages.

getResourcesToSpend

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

• Retrieves resources satisfying the spend query for the account.

  Parameters

  • quantities: CoinQuantityLike[]

    Quantities of resources to be obtained.
  • OptionalresourcesIdsToIgnore: ResourcesIdsToIgnore

    IDs of resources to be excluded from the query (optional).

  Returns Promise<Resource[]>

  A promise that resolves to an array of Resources.

getTransactionCost

• getTransactionCost(transactionRequestLike, transactionCostParams?): Promise<TransactionCost>

• Returns a transaction cost to enable user to set gasLimit and also reserve balance amounts on the transaction.

  Parameters

  • transactionRequestLike: TransactionRequestLike

    The transaction request object.
  • transactionCostParams: TransactionCostParams = {}

    The transaction cost parameters (optional).

  Returns Promise<TransactionCost>

  A promise that resolves to the transaction cost object.

  Deprecated

  Use provider.assembleTx instead Check the migration guide https://docs.fuel.network/guide/assembling-transactions/migration-guide.html for more information.

populateTransactionWitnessesSignature

• populateTransactionWitnessesSignature<T>(transactionRequestLike): Promise<T>

• Populates a transaction with the witnesses signature.

  Type Parameters

  • T extends TransactionRequest

  Parameters

  • transactionRequestLike: TransactionRequestLike

    The transaction request to populate.

  Returns Promise<T>

  The populated transaction request.

prepareSubmitAll

• prepareSubmitAll(params): SubmitAllCallback

• Prepares a function to submit all transactions either sequentially or in parallel.

  Parameters

  • params: PrepareSubmitAllParams

    The parameters for preparing the submitAll callback.

  Returns SubmitAllCallback

  A callback that, when called, submits all transactions and returns their results and any errors encountered.

sendTransaction

• sendTransaction(transactionRequestLike, estimateTxDependencies?): Promise<TransactionResponse>

• Populates the witness signature for a transaction and sends it to the network using provider.sendTransaction.

  Parameters

  • transactionRequestLike: TransactionRequestLike

    The transaction request to send.
  • estimateTxDependencies: ProviderSendTxParams = {}

    Whether to estimate the transaction dependencies.

  Returns Promise<TransactionResponse>

  A promise that resolves to the TransactionResponse object.

signMessage

• signMessage(message): Promise<string>

• Signs a message with the wallet's private key.

  Parameters

  • message: HashableMessage

    The message to sign.

  Returns Promise<string>

  A promise that resolves to the signature as a ECDSA 64 bytes string.

signTransaction

• signTransaction(transactionRequestLike): Promise<string>

• Signs a transaction with the wallet's private key.

  Parameters

  • transactionRequestLike: TransactionRequestLike

    The transaction request to sign.

  Returns Promise<string>

  A promise that resolves to the signature as a ECDSA 64 bytes string.

simulateTransaction

• simulateTransaction(transactionRequestLike, __namedParameters?): Promise<CallResult>

• Populates the witness signature for a transaction and sends a call to the network using provider.dryRun.

  Parameters

  • transactionRequestLike: TransactionRequestLike

    The transaction request to simulate.
  • __namedParameters: EstimateTransactionParams = {}

  Returns Promise<CallResult>

  A promise that resolves to the CallResult object.

transfer

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

• Transfers coins to a destination address.

  Parameters

  • destination: string | Address

    The address of the destination.
  • amount: BigNumberish

    The amount of coins to transfer.
  • OptionalassetId: BytesLike

    The asset ID of the coins to transfer (optional).
  • txParams: TxParamsType = {}

    The transaction parameters (optional).

  Returns Promise<TransactionResponse>

  A promise that resolves to the transaction response.

transferToContract

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

• Transfers coins to a contract address.

  Parameters

  • contractId: string | Address

    The address of the contract.
  • amount: BigNumberish

    The amount of coins to transfer.
  • assetId: BytesLike

    The asset ID of the coins to transfer (optional).
  • txParams: TxParamsType = {}

    The transaction parameters (optional).

  Returns Promise<TransactionResponse>

  A promise that resolves to the transaction response.

withdrawToBaseLayer

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

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

  Parameters

  • recipient: AddressInput

    Address of the recipient on the base chain.
  • amount: BigNumberish

    Amount of base asset.
  • txParams: TxParamsType = {}

    The transaction parameters (optional).

  Returns Promise<TransactionResponse>

  A promise that resolves to the transaction response.