@fuel-ts/account 0.91.0 → 0.92.0

package/dist/index.js

@@ -59,6 +59,7 @@ var src_exports = {};
 __export(src_exports, {
   Account: () => Account,
   AddressType: () => AddressType,
+  BLOCKS_PAGE_SIZE_LIMIT: () => BLOCKS_PAGE_SIZE_LIMIT,
   BaseTransactionRequest: () => BaseTransactionRequest,
   BaseWalletUnlocked: () => BaseWalletUnlocked,
   CHAIN_IDS: () => CHAIN_IDS,
@@ -83,6 +84,7 @@ __export(src_exports, {
   Predicate: () => Predicate,
   PrivateKeyVault: () => PrivateKeyVault,
   Provider: () => Provider,
+  RESOURCES_PAGE_SIZE_LIMIT: () => RESOURCES_PAGE_SIZE_LIMIT,
   ScriptTransactionRequest: () => ScriptTransactionRequest,
   Signer: () => Signer,
   StorageAbstract: () => StorageAbstract,
@@ -922,6 +924,9 @@ ${TransactionFragmentDoc}`;
 var GetBlocksDocument = import_graphql_tag.default`
     query getBlocks($after: String, $before: String, $first: Int, $last: Int) {
   blocks(after: $after, before: $before, first: $first, last: $last) {
+    pageInfo {
+      ...pageInfoFragment
+    }
     edges {
       node {
         ...blockFragment
@@ -929,7 +934,8 @@ var GetBlocksDocument = import_graphql_tag.default`
     }
   }
 }
-    ${BlockFragmentDoc}`;
+    ${PageInfoFragmentDoc}
+${BlockFragmentDoc}`;
 var GetCoinDocument = import_graphql_tag.default`
     query getCoin($coinId: UtxoId!) {
   coin(utxoId: $coinId) {
@@ -946,6 +952,9 @@ var GetCoinsDocument = import_graphql_tag.default`
     first: $first
     last: $last
   ) {
+    pageInfo {
+      ...pageInfoFragment
+    }
     edges {
       node {
         ...coinFragment
@@ -953,7 +962,8 @@ var GetCoinsDocument = import_graphql_tag.default`
     }
   }
 }
-    ${CoinFragmentDoc}`;
+    ${PageInfoFragmentDoc}
+${CoinFragmentDoc}`;
 var GetCoinsToSpendDocument = import_graphql_tag.default`
     query getCoinsToSpend($owner: Address!, $queryPerAsset: [SpendQueryElementInput!]!, $excludedIds: ExcludeInput) {
   coinsToSpend(
@@ -1012,6 +1022,9 @@ var GetBalancesDocument = import_graphql_tag.default`
     first: $first
     last: $last
   ) {
+    pageInfo {
+      ...pageInfoFragment
+    }
     edges {
       node {
         ...balanceFragment
@@ -1019,7 +1032,8 @@ var GetBalancesDocument = import_graphql_tag.default`
     }
   }
 }
-    ${BalanceFragmentDoc}`;
+    ${PageInfoFragmentDoc}
+${BalanceFragmentDoc}`;
 var GetMessagesDocument = import_graphql_tag.default`
     query getMessages($owner: Address!, $after: String, $before: String, $first: Int, $last: Int) {
   messages(
@@ -1029,6 +1043,9 @@ var GetMessagesDocument = import_graphql_tag.default`
     first: $first
     last: $last
   ) {
+    pageInfo {
+      ...pageInfoFragment
+    }
     edges {
       node {
         ...messageFragment
@@ -1036,7 +1053,8 @@ var GetMessagesDocument = import_graphql_tag.default`
     }
   }
 }
-    ${MessageFragmentDoc}`;
+    ${PageInfoFragmentDoc}
+${MessageFragmentDoc}`;
 var GetMessageProofDocument = import_graphql_tag.default`
     query getMessageProof($transactionId: TransactionId!, $nonce: Nonce!, $commitBlockId: BlockId, $commitBlockHeight: U32) {
   messageProof(
@@ -3878,12 +3896,18 @@ var TransactionResponse = class {
     await this.fetch();
   }
   /**
-   * Waits for transaction to complete and returns the result.
+   * Assembles the result of a transaction by retrieving the transaction summary,
+   * decoding logs (if available), and handling transaction failure.
    *
-   * @returns The completed transaction result
+   * This method can be used to obtain the result of a transaction that has just
+   * been submitted or one that has already been processed.
+   *
+   * @template TTransactionType - The type of the transaction.
+   * @param contractsAbiMap - The map of contract ABIs.
+   * @returns - The assembled transaction result.
+   * @throws If the transaction status is a failure.
    */
-  async waitForResult(contractsAbiMap) {
-    await this.waitForStatusChange();
+  async assembleResult(contractsAbiMap) {
     const transactionSummary = await this.getTransactionSummary(contractsAbiMap);
     const transactionResult = {
       gqlTransaction: this.gqlTransaction,
@@ -3909,6 +3933,15 @@ var TransactionResponse = class {
     }
     return transactionResult;
   }
+  /**
+   * Waits for transaction to complete and returns the result.
+   *
+   * @returns The completed transaction result
+   */
+  async waitForResult(contractsAbiMap) {
+    await this.waitForStatusChange();
+    return this.assembleResult(contractsAbiMap);
+  }
   /**
    * Waits for transaction to complete and returns the result.
    *
@@ -3972,6 +4005,8 @@ var mergeQuantities = (...coinQuantities) => {
 
 // src/providers/provider.ts
 var MAX_RETRIES = 10;
+var RESOURCES_PAGE_SIZE_LIMIT = 512;
+var BLOCKS_PAGE_SIZE_LIMIT = 5;
 var processGqlChain = (chain) => {
   const { name, daHeight, consensusParameters, latestBlock } = chain;
   const {
@@ -4615,7 +4650,7 @@ Supported fuel-core version: ${supportedVersion}.`
   /**
    * Returns a transaction cost to enable user
    * to set gasLimit and also reserve balance amounts
-   * on the the transaction.
+   * on the transaction.
    *
    * @param transactionRequestLike - The transaction request object.
    * @param transactionCostParams - The transaction cost parameters (optional).
@@ -4726,20 +4761,27 @@ Supported fuel-core version: ${supportedVersion}.`
    */
   async getCoins(owner, assetId, paginationArgs) {
     const ownerAddress = import_address3.Address.fromAddressOrString(owner);
-    const result = await this.operations.getCoins({
-      first: 10,
-      ...paginationArgs,
+    const {
+      coins: { edges, pageInfo }
+    } = await this.operations.getCoins({
+      ...this.validatePaginationArgs({
+        paginationLimit: RESOURCES_PAGE_SIZE_LIMIT,
+        inputArgs: paginationArgs
+      }),
       filter: { owner: ownerAddress.toB256(), assetId: assetId && (0, import_utils23.hexlify)(assetId) }
     });
-    const coins = result.coins.edges.map((edge) => edge.node);
-    return coins.map((coin) => ({
-      id: coin.utxoId,
-      assetId: coin.assetId,
-      amount: (0, import_math17.bn)(coin.amount),
-      owner: import_address3.Address.fromAddressOrString(coin.owner),
-      blockCreated: (0, import_math17.bn)(coin.blockCreated),
-      txCreatedIdx: (0, import_math17.bn)(coin.txCreatedIdx)
+    const coins = edges.map(({ node }) => ({
+      id: node.utxoId,
+      assetId: node.assetId,
+      amount: (0, import_math17.bn)(node.amount),
+      owner: import_address3.Address.fromAddressOrString(node.owner),
+      blockCreated: (0, import_math17.bn)(node.blockCreated),
+      txCreatedIdx: (0, import_math17.bn)(node.txCreatedIdx)
     }));
+    return {
+      coins,
+      pageInfo
+    };
   }
   /**
    * Returns resources for the given owner satisfying the spend query.
@@ -4832,14 +4874,21 @@ Supported fuel-core version: ${supportedVersion}.`
    * @returns A promise that resolves to the blocks.
    */
   async getBlocks(params) {
-    const { blocks: fetchedData } = await this.operations.getBlocks(params);
-    const blocks = fetchedData.edges.map(({ node: block }) => ({
+    const {
+      blocks: { edges, pageInfo }
+    } = await this.operations.getBlocks({
+      ...this.validatePaginationArgs({
+        paginationLimit: BLOCKS_PAGE_SIZE_LIMIT,
+        inputArgs: params
+      })
+    });
+    const blocks = edges.map(({ node: block }) => ({
       id: block.id,
       height: (0, import_math17.bn)(block.height),
       time: block.header.time,
       transactionIds: block.transactions.map((tx) => tx.id)
     }));
-    return blocks;
+    return { blocks, pageInfo };
   }
   /**
    * Returns block matching the given ID or type, including transaction data.
@@ -4949,17 +4998,22 @@ Supported fuel-core version: ${supportedVersion}.`
    * @param paginationArgs - Pagination arguments (optional).
    * @returns A promise that resolves to the balances.
    */
-  async getBalances(owner, paginationArgs) {
-    const result = await this.operations.getBalances({
-      first: 10,
-      ...paginationArgs,
+  async getBalances(owner) {
+    const {
+      balances: { edges }
+    } = await this.operations.getBalances({
+      /**
+       * The query parameters for this method were designed to support pagination,
+       * but the current Fuel-Core implementation does not support pagination yet.
+       */
+      first: 1e4,
       filter: { owner: import_address3.Address.fromAddressOrString(owner).toB256() }
     });
-    const balances = result.balances.edges.map((edge) => edge.node);
-    return balances.map((balance) => ({
-      assetId: balance.assetId,
-      amount: (0, import_math17.bn)(balance.amount)
+    const balances = edges.map(({ node }) => ({
+      assetId: node.assetId,
+      amount: (0, import_math17.bn)(node.amount)
     }));
+    return { balances };
   }
   /**
    * Returns message for the given address.
@@ -4969,27 +5023,34 @@ Supported fuel-core version: ${supportedVersion}.`
    * @returns A promise that resolves to the messages.
    */
   async getMessages(address, paginationArgs) {
-    const result = await this.operations.getMessages({
-      first: 10,
-      ...paginationArgs,
+    const {
+      messages: { edges, pageInfo }
+    } = await this.operations.getMessages({
+      ...this.validatePaginationArgs({
+        inputArgs: paginationArgs,
+        paginationLimit: RESOURCES_PAGE_SIZE_LIMIT
+      }),
       owner: import_address3.Address.fromAddressOrString(address).toB256()
     });
-    const messages = result.messages.edges.map((edge) => edge.node);
-    return messages.map((message) => ({
+    const messages = edges.map(({ node }) => ({
       messageId: import_transactions20.InputMessageCoder.getMessageId({
-        sender: message.sender,
-        recipient: message.recipient,
-        nonce: message.nonce,
-        amount: (0, import_math17.bn)(message.amount),
-        data: message.data
+        sender: node.sender,
+        recipient: node.recipient,
+        nonce: node.nonce,
+        amount: (0, import_math17.bn)(node.amount),
+        data: node.data
       }),
-      sender: import_address3.Address.fromAddressOrString(message.sender),
-      recipient: import_address3.Address.fromAddressOrString(message.recipient),
-      nonce: message.nonce,
-      amount: (0, import_math17.bn)(message.amount),
-      data: import_transactions20.InputMessageCoder.decodeData(message.data),
-      daHeight: (0, import_math17.bn)(message.daHeight)
+      sender: import_address3.Address.fromAddressOrString(node.sender),
+      recipient: import_address3.Address.fromAddressOrString(node.recipient),
+      nonce: node.nonce,
+      amount: (0, import_math17.bn)(node.amount),
+      data: import_transactions20.InputMessageCoder.decodeData(node.data),
+      daHeight: (0, import_math17.bn)(node.daHeight)
     }));
+    return {
+      messages,
+      pageInfo
+    };
   }
   /**
    * Returns Message Proof for given transaction id and the message id from MessageOut receipt.
@@ -5168,6 +5229,41 @@ Supported fuel-core version: ${supportedVersion}.`
     }
     return relayedTransactionStatus;
   }
+  /**
+   * @hidden
+   */
+  validatePaginationArgs(params) {
+    const { paginationLimit, inputArgs = {} } = params;
+    const { first, last, after, before } = inputArgs;
+    if (after && before) {
+      throw new import_errors14.FuelError(
+        import_errors14.ErrorCode.INVALID_INPUT_PARAMETERS,
+        'Pagination arguments "after" and "before" cannot be used together'
+      );
+    }
+    if ((first || 0) > paginationLimit || (last || 0) > paginationLimit) {
+      throw new import_errors14.FuelError(
+        import_errors14.ErrorCode.INVALID_INPUT_PARAMETERS,
+        `Pagination limit for this query cannot exceed ${paginationLimit} items`
+      );
+    }
+    if (first && before) {
+      throw new import_errors14.FuelError(
+        import_errors14.ErrorCode.INVALID_INPUT_PARAMETERS,
+        'The use of pagination argument "first" with "before" is not supported'
+      );
+    }
+    if (last && after) {
+      throw new import_errors14.FuelError(
+        import_errors14.ErrorCode.INVALID_INPUT_PARAMETERS,
+        'The use of pagination argument "last" with "after" is not supported'
+      );
+    }
+    if (!first && !last) {
+      inputArgs.first = paginationLimit;
+    }
+    return inputArgs;
+  }
   /**
    * @hidden
    */
@@ -5568,52 +5664,16 @@ var Account = class extends import_interfaces.AbstractAccount {
    * @param assetId - The asset ID of the coins to retrieve (optional).
    * @returns A promise that resolves to an array of Coins.
    */
-  async getCoins(assetId) {
-    const coins = [];
-    const pageSize = 9999;
-    let cursor;
-    for (; ; ) {
-      const pageCoins = await this.provider.getCoins(this.address, assetId, {
-        first: pageSize,
-        after: cursor
-      });
-      coins.push(...pageCoins);
-      const hasNextPage = pageCoins.length >= pageSize;
-      if (!hasNextPage) {
-        break;
-      }
-      throw new import_errors16.FuelError(
-        import_errors16.ErrorCode.NOT_SUPPORTED,
-        `Wallets containing more than ${pageSize} coins exceed the current supported limit.`
-      );
-    }
-    return coins;
+  async getCoins(assetId, paginationArgs) {
+    return this.provider.getCoins(this.address, assetId, paginationArgs);
   }
   /**
    * Retrieves messages owned by the account.
    *
    * @returns A promise that resolves to an array of Messages.
    */
-  async getMessages() {
-    const messages = [];
-    const pageSize = 9999;
-    let cursor;
-    for (; ; ) {
-      const pageMessages = await this.provider.getMessages(this.address, {
-        first: pageSize,
-        after: cursor
-      });
-      messages.push(...pageMessages);
-      const hasNextPage = pageMessages.length >= pageSize;
-      if (!hasNextPage) {
-        break;
-      }
-      throw new import_errors16.FuelError(
-        import_errors16.ErrorCode.NOT_SUPPORTED,
-        `Wallets containing more than ${pageSize} messages exceed the current supported limit.`
-      );
-    }
-    return messages;
+  async getMessages(paginationArgs) {
+    return this.provider.getMessages(this.address, paginationArgs);
   }
   /**
    * Retrieves the balance of the account for the given asset.
@@ -5632,25 +5692,7 @@ var Account = class extends import_interfaces.AbstractAccount {
    * @returns A promise that resolves to an array of Coins and their quantities.
    */
   async getBalances() {
-    const balances = [];
-    const pageSize = 9999;
-    let cursor;
-    for (; ; ) {
-      const pageBalances = await this.provider.getBalances(this.address, {
-        first: pageSize,
-        after: cursor
-      });
-      balances.push(...pageBalances);
-      const hasNextPage = pageBalances.length >= pageSize;
-      if (!hasNextPage) {
-        break;
-      }
-      throw new import_errors16.FuelError(
-        import_errors16.ErrorCode.NOT_SUPPORTED,
-        `Wallets containing more than ${pageSize} balances exceed the current supported limit.`
-      );
-    }
-    return balances;
+    return this.provider.getBalances(this.address);
   }
   /**
    * Funds a transaction request by adding the necessary resources.
@@ -9879,7 +9921,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
     throw new Error("Method not implemented.");
   }
   /**
-   * Should add the the assets metadata to the connector and return true if the asset
+   * Should add the assets metadata to the connector and return true if the asset
    * was added successfully.
    *
    * If the asset already exists it should throw an error.
@@ -9893,7 +9935,7 @@ var FuelConnector = class extends import_events2.EventEmitter {
     throw new Error("Method not implemented.");
   }
   /**
-   * Should add the the asset metadata to the connector and return true if the asset
+   * Should add the asset metadata to the connector and return true if the asset
    * was added successfully.
    *
    * If the asset already exists it should throw an error.
@@ -10375,6 +10417,7 @@ __publicField(Fuel, "defaultConfig", {});
 0 && (module.exports = {
   Account,
   AddressType,
+  BLOCKS_PAGE_SIZE_LIMIT,
   BaseTransactionRequest,
   BaseWalletUnlocked,
   CHAIN_IDS,
@@ -10399,6 +10442,7 @@ __publicField(Fuel, "defaultConfig", {});
   Predicate,
   PrivateKeyVault,
   Provider,
+  RESOURCES_PAGE_SIZE_LIMIT,
   ScriptTransactionRequest,
   Signer,
   StorageAbstract,