@fuel-ts/account 0.0.0-rc-1356-20240522164420 → 0.0.0-rc-1356-20240523144307

package/dist/test-utils.mjs

@@ -2602,6 +2602,13 @@ var ScriptTransactionRequest = class extends BaseTransactionRequest {
     }
     return this.outputs.length - 1;
   }
+  /**
+   * Calculates the maximum gas for the transaction.
+   *
+   * @param chainInfo - The chain information.
+   * @param minGas - The minimum gas.
+   * @returns the maximum gas.
+   */
   calculateMaxGas(chainInfo, minGas) {
     const { consensusParameters } = chainInfo;
     const {
@@ -3716,7 +3723,6 @@ var _Provider = class {
    * Constructor to initialize a Provider.
    *
    * @param url - GraphQL endpoint of the Fuel node
-   * @param chainInfo - Chain info of the Fuel node
    * @param options - Additional options for the provider
    * @hidden
    */
@@ -3739,10 +3745,14 @@ var _Provider = class {
     this.operations = this.createOperations();
     this.cache = options.cacheUtxo ? new MemoryCache(options.cacheUtxo) : void 0;
   }
+  /** @hidden */
   static clearChainAndNodeCaches() {
     _Provider.nodeInfoCache = {};
     _Provider.chainInfoCache = {};
   }
+  /**
+   * @hidden
+   */
   static getFetchFn(options) {
     const { retryOptions, timeout } = options;
     return autoRetryFetch(async (...args) => {
@@ -3758,8 +3768,11 @@ var _Provider = class {
   }
   /**
    * Creates a new instance of the Provider class. This is the recommended way to initialize a Provider.
+   *
    * @param url - GraphQL endpoint of the Fuel node
    * @param options - Additional options for the provider
+   *
+   * @returns A promise that resolves to a Provider instance.
    */
   static async create(url, options = {}) {
     const provider = new _Provider(url, options);
@@ -3768,6 +3781,8 @@ var _Provider = class {
   }
   /**
    * Returns the cached chainInfo for the current URL.
+   *
+   * @returns the chain information configuration.
    */
   getChain() {
     const chain = _Provider.chainInfoCache[this.url];
@@ -3781,6 +3796,8 @@ var _Provider = class {
   }
   /**
    * Returns the cached nodeInfo for the current URL.
+   *
+   * @returns the node information configuration.
    */
   getNode() {
     const node = _Provider.nodeInfoCache[this.url];
@@ -3812,6 +3829,9 @@ var _Provider = class {
   }
   /**
    * Updates the URL for the provider and fetches the consensus parameters for the new URL, if needed.
+   *
+   * @param url - The URL to connect to.
+   * @param options - Additional options for the provider.
    */
   async connect(url, options) {
     this.url = url;
@@ -3820,9 +3840,9 @@ var _Provider = class {
     await this.fetchChainAndNodeInfo();
   }
   /**
-   * Fetches both the chain and node information, saves it to the cache, and return it.
+   * Return the chain and node information.
    *
-   * @returns NodeInfo and Chain
+   * @returns A promise that resolves to the Chain and NodeInfo.
    */
   async fetchChainAndNodeInfo() {
     const chain = await this.fetchChain();
@@ -3833,6 +3853,9 @@ var _Provider = class {
       nodeInfo
     };
   }
+  /**
+   * @hidden
+   */
   static ensureClientVersionIsSupported(nodeInfo) {
     const { isMajorSupported, isMinorSupported, supportedVersion } = checkFuelCoreVersionCompatibility(nodeInfo.nodeVersion);
     if (!isMajorSupported || !isMinorSupported) {
@@ -3848,6 +3871,7 @@ Supported fuel-core version: ${supportedVersion}.`
    * Create GraphQL client and set operations.
    *
    * @returns The operation SDK object
+   * @hidden
    */
   createOperations() {
     const fetchFn = _Provider.getFetchFn(this.options);
@@ -3892,18 +3916,18 @@ Supported fuel-core version: ${supportedVersion}.`
     return nodeVersion;
   }
   /**
-   * Returns the block number.
+   * Returns the latest block number.
    *
-   * @returns A promise that resolves to the block number
+   * @returns A promise that resolves to the latest block number.
    */
   async getBlockNumber() {
     const { chain } = await this.operations.getChain();
     return bn17(chain.latestBlock.height, 10);
   }
   /**
-   * Returns the chain information.
-   * @param url - The URL of the Fuel node
-   * @returns NodeInfo object
+   * Returns the node information for the current provider network.
+   *
+   * @returns a promise that resolves to the node information.
    */
   async fetchNode() {
     const { nodeInfo } = await this.operations.getNodeInfo();
@@ -3918,9 +3942,9 @@ Supported fuel-core version: ${supportedVersion}.`
     return processedNodeInfo;
   }
   /**
-   * Fetches the `chainInfo` for the given node URL.
-   * @param url - The URL of the Fuel node
-   * @returns ChainInfo object
+   * Returns the chain information for the current provider network.
+   *
+   * @returns a promise that resolves to the chain information.
    */
   async fetchChain() {
     const { chain } = await this.operations.getChain();
@@ -3929,8 +3953,9 @@ Supported fuel-core version: ${supportedVersion}.`
     return processedChain;
   }
   /**
-   * Returns the chain ID
-   * @returns A promise that resolves to the chain ID number
+   * Returns the chain ID for the current provider network.
+   *
+   * @returns A promise that resolves to the chain ID number.
    */
   getChainId() {
     const {
@@ -3939,9 +3964,9 @@ Supported fuel-core version: ${supportedVersion}.`
     return chainId.toNumber();
   }
   /**
-   * Returns the base asset ID for the current provider network
+   * Returns the base asset ID for the current provider network.
    *
-   * @returns the base asset ID
+   * @returns the base asset ID.
    */
   getBaseAssetId() {
     const {
@@ -3956,6 +3981,7 @@ Supported fuel-core version: ${supportedVersion}.`
    * the transaction will be mutated and those dependencies will be added.
    *
    * @param transactionRequestLike - The transaction request object.
+   * @param sendTransactionParams - The provider send transaction parameters (optional).
    * @returns A promise that resolves to the transaction response object.
    */
   // #region Provider-sendTransaction
@@ -4000,7 +4026,7 @@ Supported fuel-core version: ${supportedVersion}.`
    * the transaction will be mutated and those dependencies will be added.
    *
    * @param transactionRequestLike - The transaction request object.
-   * @param utxoValidation - Additional provider call parameters.
+   * @param sendTransactionParams - The provider call parameters (optional).
    * @returns A promise that resolves to the call result object.
    */
   async call(transactionRequestLike, { utxoValidation, estimateTxDependencies = true } = {}) {
@@ -4020,6 +4046,8 @@ Supported fuel-core version: ${supportedVersion}.`
   /**
    * Verifies whether enough gas is available to complete transaction.
    *
+   * @template T - The type of the transaction request object.
+   *
    * @param transactionRequest - The transaction request object.
    * @returns A promise that resolves to the estimated transaction request object.
    */
@@ -4054,9 +4082,8 @@ Supported fuel-core version: ${supportedVersion}.`
    * If there are missing variable outputs,
    * `addVariableOutputs` is called on the transaction.
    *
-   *
    * @param transactionRequest - The transaction request object.
-   * @returns A promise.
+   * @returns A promise that resolves to the estimate transaction dependencies.
    */
   async estimateTxDependencies(transactionRequest) {
     if (transactionRequest.type === TransactionType8.Create) {
@@ -4169,6 +4196,14 @@ Supported fuel-core version: ${supportedVersion}.`
     }
     return results;
   }
+  /**
+   * Dry runs multiple transactions.
+   *
+   * @param transactionRequests - Array of transaction request objects.
+   * @param sendTransactionParams - The provider call parameters (optional).
+   *
+   * @returns A promise that resolves to an array of results for each transaction call.
+   */
   async dryRunMultipleTransactions(transactionRequests, { utxoValidation, estimateTxDependencies = true } = {}) {
     if (estimateTxDependencies) {
       return this.estimateMultipleTxDependencies(transactionRequests);
@@ -4239,6 +4274,7 @@ Supported fuel-core version: ${supportedVersion}.`
    * the transaction will be mutated and those dependencies will be added
    *
    * @param transactionRequestLike - The transaction request object.
+   * @param estimateTxParams - The estimate transaction params (optional).
    * @returns A promise that resolves to the call result object.
    */
   async simulate(transactionRequestLike, { estimateTxDependencies = true } = {}) {
@@ -4263,14 +4299,9 @@ Supported fuel-core version: ${supportedVersion}.`
    * to set gasLimit and also reserve balance amounts
    * on the the transaction.
    *
-   * @privateRemarks
-   * The tolerance is add on top of the gasUsed calculated
-   * from the node, this create a safe margin costs like
-   * change states on transfer that don't occur on the dryRun
-   * transaction. The default value is 0.2 or 20%
-   *
    * @param transactionRequestLike - The transaction request object.
-   * @param tolerance - The tolerance to add on top of the gasUsed.
+   * @param transactionCostParams - The transaction cost parameters (optional).
+   *
    * @returns A promise that resolves to the transaction cost object.
    */
   async getTransactionCost(transactionRequestLike, { resourcesOwner, signatureCallback, quantitiesToContract = [] } = {}) {
@@ -4338,6 +4369,15 @@ Supported fuel-core version: ${supportedVersion}.`
       updateMaxFee
     };
   }
+  /**
+   * Get the required quantities and associated resources for a transaction.
+   *
+   * @param owner - address to add resources from.
+   * @param transactionRequestLike - transaction request to populate resources for.
+   * @param quantitiesToContract - quantities for the contract (optional).
+   *
+   * @returns a promise resolving to the required quantities for the transaction.
+   */
   async getResourcesForTransaction(owner, transactionRequestLike, quantitiesToContract = []) {
     const ownerAddress = Address2.fromAddressOrString(owner);
     const transactionRequest = transactionRequestify(clone3(transactionRequestLike));
@@ -4359,6 +4399,12 @@ Supported fuel-core version: ${supportedVersion}.`
   }
   /**
    * Returns coins for the given owner.
+   *
+   * @param owner - The address to get coins for.
+   * @param assetId - The asset ID of coins to get (optional).
+   * @param paginationArgs - Pagination arguments (optional).
+   *
+   * @returns A promise that resolves to the coins.
    */
   async getCoins(owner, assetId, paginationArgs) {
     const ownerAddress = Address2.fromAddressOrString(owner);
@@ -4381,8 +4427,8 @@ Supported fuel-core version: ${supportedVersion}.`
    * Returns resources for the given owner satisfying the spend query.
    *
    * @param owner - The address to get resources for.
-   * @param quantities - The quantities to get.
-   * @param excludedIds - IDs of excluded resources from the selection.
+   * @param quantities - The coin quantities to get.
+   * @param excludedIds - IDs of excluded resources from the selection (optional).
    * @returns A promise that resolves to the resources.
    */
   async getResourcesToSpend(owner, quantities, excludedIds) {
@@ -4437,7 +4483,7 @@ Supported fuel-core version: ${supportedVersion}.`
    * Returns block matching the given ID or height.
    *
    * @param idOrHeight - ID or height of the block.
-   * @returns A promise that resolves to the block.
+   * @returns A promise that resolves to the block or null.
    */
   async getBlock(idOrHeight) {
     let variables;
@@ -4567,7 +4613,7 @@ Supported fuel-core version: ${supportedVersion}.`
    * Returns balances for the given owner.
    *
    * @param owner - The address to get coins for.
-   * @param paginationArgs - Pagination arguments.
+   * @param paginationArgs - Pagination arguments (optional).
    * @returns A promise that resolves to the balances.
    */
   async getBalances(owner, paginationArgs) {
@@ -4586,7 +4632,7 @@ Supported fuel-core version: ${supportedVersion}.`
    * Returns message for the given address.
    *
    * @param address - The address to get message from.
-   * @param paginationArgs - Pagination arguments.
+   * @param paginationArgs - Pagination arguments (optional).
    * @returns A promise that resolves to the messages.
    */
   async getMessages(address, paginationArgs) {
@@ -4617,8 +4663,8 @@ Supported fuel-core version: ${supportedVersion}.`
    *
    * @param transactionId - The transaction to get message from.
    * @param messageId - The message id from MessageOut receipt.
-   * @param commitBlockId - The commit block id.
-   * @param commitBlockHeight - The commit block height.
+   * @param commitBlockId - The commit block id (optional).
+   * @param commitBlockHeight - The commit block height (optional).
    * @returns A promise that resolves to the message proof.
    */
   async getMessageProof(transactionId, nonce, commitBlockId, commitBlockHeight) {
@@ -4706,10 +4752,21 @@ Supported fuel-core version: ${supportedVersion}.`
       data
     };
   }
+  /**
+   * Get the latest gas price from the node.
+   *
+   * @returns A promise that resolves to the latest gas price.
+   */
   async getLatestGasPrice() {
     const { latestGasPrice } = await this.operations.getLatestGasPrice();
     return bn17(latestGasPrice.gasPrice);
   }
+  /**
+   * Returns the estimate gas price for the given block horizon.
+   *
+   * @param blockHorizon - The block horizon to estimate gas price for.
+   * @returns A promise that resolves to the estimated gas price.
+   */
   async estimateGasPrice(blockHorizon) {
     const { estimateGasPrice } = await this.operations.estimateGasPrice({
       blockHorizon: String(blockHorizon)
@@ -4729,8 +4786,8 @@ Supported fuel-core version: ${supportedVersion}.`
   /**
    * Lets you produce blocks with custom timestamps and the block number of the last block produced.
    *
-   * @param amount - The amount of blocks to produce
-   * @param startTime - The UNIX timestamp (milliseconds) to set for the first produced block
+   * @param amount - The amount of blocks to produce.
+   * @param startTime - The UNIX timestamp (milliseconds) to set for the first produced block (optional).
    * @returns A promise that resolves to the block number of the last produced block.
    */
   async produceBlocks(amount, startTime) {
@@ -4740,6 +4797,12 @@ Supported fuel-core version: ${supportedVersion}.`
     });
     return bn17(latestBlockHeight);
   }
+  /**
+   * Get the transaction response for the given transaction ID.
+   *
+   * @param transactionId - The transaction ID to get the response for.
+   * @returns A promise that resolves to the transaction response.
+   */
   // eslint-disable-next-line @typescript-eslint/require-await
   async getTransactionResponse(transactionId) {
     return new TransactionResponse(transactionId, this);
@@ -4748,7 +4811,7 @@ Supported fuel-core version: ${supportedVersion}.`
    * Returns Message for given nonce.
    *
    * @param nonce - The nonce of the message to retrieve.
-   * @returns A promise that resolves to the Message object.
+   * @returns A promise that resolves to the Message object or null.
    */
   async getMessageByNonce(nonce) {
     const { message } = await this.operations.getMessageByNonce({ nonce });
@@ -4757,6 +4820,12 @@ Supported fuel-core version: ${supportedVersion}.`
     }
     return message;
   }
+  /**
+   * Get the relayed transaction for the given transaction ID.
+   *
+   * @param relayedTransactionId - The relayed transaction ID to get the response for.
+   * @returns A promise that resolves to the relayed transaction.
+   */
   async getRelayedTransactionStatus(relayedTransactionId) {
     const { relayedTransactionStatus } = await this.operations.getRelayedTransactionStatus({
       relayedTransactionId
@@ -4766,6 +4835,9 @@ Supported fuel-core version: ${supportedVersion}.`
     }
     return relayedTransactionStatus;
   }
+  /**
+   * @hidden
+   */
   extractDryRunError(transactionRequest, receipts, dryRunStatus) {
     const status = dryRunStatus;
     let logs = [];
@@ -4795,7 +4867,9 @@ cacheInputs_fn = function(inputs) {
     }
   });
 };
+/** @hidden */
 __publicField(Provider, "chainInfoCache", {});
+/** @hidden */
 __publicField(Provider, "nodeInfoCache", {});
 
 // src/providers/transaction-summary/get-transaction-summary.ts
@@ -4922,12 +4996,16 @@ var Account = class extends AbstractAccount {
    * The provider used to interact with the network.
    */
   _provider;
+  /**
+   * The connector for use with external wallets
+   */
   _connector;
   /**
    * Creates a new Account instance.
    *
    * @param address - The address of the account.
    * @param provider - A Provider instance  (optional).
+   * @param connector - A FuelConnector instance (optional).
    */
   constructor(address, provider, connector) {
     super();
@@ -4969,8 +5047,8 @@ var Account = class extends AbstractAccount {
   /**
    * Retrieves resources satisfying the spend query for the account.
    *
-   * @param quantities - IDs of coins to exclude.
-   * @param excludedIds - IDs of resources to be excluded from the query.
+   * @param quantities - Quantities of resources to be obtained.
+   * @param excludedIds - IDs of resources to be excluded from the query (optional).
    * @returns A promise that resolves to an array of Resources.
    */
   async getResourcesToSpend(quantities, excludedIds) {
@@ -4979,7 +5057,7 @@ var Account = class extends AbstractAccount {
   /**
    * Retrieves coins owned by the account.
    *
-   * @param assetId - The asset ID of the coins to retrieve.
+   * @param assetId - The asset ID of the coins to retrieve (optional).
    * @returns A promise that resolves to an array of Coins.
    */
   async getCoins(assetId) {
@@ -5032,7 +5110,7 @@ var Account = class extends AbstractAccount {
   /**
    * Retrieves the balance of the account for the given asset.
    *
-   * @param assetId - The asset ID to check the balance for.
+   * @param assetId - The asset ID to check the balance for (optional).
    * @returns A promise that resolves to the balance amount.
    */
   async getBalance(assetId) {
@@ -5072,7 +5150,7 @@ var Account = class extends AbstractAccount {
    * @typeParam T - The type of the TransactionRequest.
    * @param request - The transaction request to fund.
    * @param params - The estimated transaction parameters.
-   * @returns The funded transaction request.
+   * @returns A promise that resolves to the funded transaction request.
    */
   async fund(request, params) {
     const { addedSignatures, estimatedPredicates, requiredQuantities, updateMaxFee } = params;
@@ -5165,8 +5243,8 @@ var Account = class extends AbstractAccount {
    *
    * @param destination - The address of the destination.
    * @param amount - The amount of coins to transfer.
-   * @param assetId - The asset ID of the coins to transfer.
-   * @param txParams - The transaction parameters (gasLimit, tip, maturity, maxFee, witnessLimit).
+   * @param assetId - The asset ID of the coins to transfer (optional).
+   * @param txParams - The transaction parameters (optional).
    * @returns A promise that resolves to the prepared transaction request.
    */
   async createTransfer(destination, amount, assetId, txParams = {}) {
@@ -5180,8 +5258,8 @@ var Account = class extends AbstractAccount {
    *
    * @param destination - The address of the destination.
    * @param amount - The amount of coins to transfer.
-   * @param assetId - The asset ID of the coins to transfer.
-   * @param txParams - The transaction parameters (gasLimit, maturity).
+   * @param assetId - The asset ID of the coins to transfer (optional).
+   * @param txParams - The transaction parameters (optional).
    * @returns A promise that resolves to the transaction response.
    */
   async transfer(destination, amount, assetId, txParams = {}) {
@@ -5241,8 +5319,8 @@ var Account = class extends AbstractAccount {
    *
    * @param contractId - The address of the contract.
    * @param amount - The amount of coins to transfer.
-   * @param assetId - The asset ID of the coins to transfer.
-   * @param txParams - The optional transaction parameters.
+   * @param assetId - The asset ID of the coins to transfer (optional).
+   * @param txParams - The transaction parameters (optional).
    * @returns A promise that resolves to the transaction response.
    */
   async transferToContract(contractId, amount, assetId, txParams = {}) {
@@ -5283,7 +5361,7 @@ var Account = class extends AbstractAccount {
    *
    * @param recipient - Address of the recipient on the base chain.
    * @param amount - Amount of base asset.
-   * @param txParams - The optional transaction parameters.
+   * @param txParams - The transaction parameters (optional).
    * @returns A promise that resolves to the transaction response.
    */
   async withdrawToBaseLayer(recipient, amount, txParams = {}) {
@@ -5313,7 +5391,14 @@ var Account = class extends AbstractAccount {
     await this.fund(request, txCost);
     return this.sendTransaction(request);
   }
-  /** @hidden * */
+  /**
+   * Sign a message from the account via the connector.
+   *
+   * @param message - the message to sign.
+   * @returns a promise that resolves to the signature.
+   *
+   * @hidden
+   */
   async signMessage(message) {
     if (!this._connector) {
       throw new FuelError15(ErrorCode15.MISSING_CONNECTOR, "A connector is required to sign messages.");
@@ -5321,7 +5406,7 @@ var Account = class extends AbstractAccount {
     return this._connector.signMessage(this.address.toString(), message);
   }
   /**
-   * Signs a transaction with the wallet's private key.
+   * Signs a transaction from the account via the connector..
    *
    * @param transactionRequestLike - The transaction request to sign.
    * @returns A promise that resolves to the signature of the transaction.
@@ -5339,6 +5424,7 @@ var Account = class extends AbstractAccount {
    * Sends a transaction to the network.
    *
    * @param transactionRequestLike - The transaction request to be sent.
+   * @param sendTransactionParams - The provider send transaction parameters (optional).
    * @returns A promise that resolves to the transaction response.
    */
   async sendTransaction(transactionRequestLike, { estimateTxDependencies = true, awaitExecution } = {}) {
@@ -5360,6 +5446,7 @@ var Account = class extends AbstractAccount {
    * Simulates a transaction.
    *
    * @param transactionRequestLike - The transaction request to be simulated.
+   * @param estimateTxParams - The estimate transaction params (optional).
    * @returns A promise that resolves to the call result.
    */
   async simulateTransaction(transactionRequestLike, { estimateTxDependencies = true } = {}) {
@@ -5701,6 +5788,8 @@ var BaseWalletUnlocked = class extends Account {
    * Populates the witness signature for a transaction and sends it to the network using `provider.sendTransaction`.
    *
    * @param transactionRequestLike - The transaction request to send.
+   * @param estimateTxDependencies - Whether to estimate the transaction dependencies.
+   * @param awaitExecution - Whether to wait for the transaction to be executed.
    * @returns A promise that resolves to the TransactionResponse object.
    */
   async sendTransaction(transactionRequestLike, { estimateTxDependencies = false, awaitExecution } = {}) {
@@ -5732,6 +5821,12 @@ var BaseWalletUnlocked = class extends Account {
       }
     );
   }
+  /**
+   * Encrypts an unlocked wallet with a password.
+   *
+   * @param password - the password to encrypt the wallet with.
+   * @returns - the encrypted wallet.
+   */
   async encrypt(password) {
     return encryptKeystoreWallet(this.privateKey, this.address, password);
   }