@fuel-ts/account 0.91.0 → 0.92.1

package/dist/index.mjs

@@ -761,6 +761,9 @@ ${TransactionFragmentDoc}`;
 var GetBlocksDocument = gql`
     query getBlocks($after: String, $before: String, $first: Int, $last: Int) {
   blocks(after: $after, before: $before, first: $first, last: $last) {
+    pageInfo {
+      ...pageInfoFragment
+    }
     edges {
       node {
         ...blockFragment
@@ -768,7 +771,8 @@ var GetBlocksDocument = gql`
     }
   }
 }
-    ${BlockFragmentDoc}`;
+    ${PageInfoFragmentDoc}
+${BlockFragmentDoc}`;
 var GetCoinDocument = gql`
     query getCoin($coinId: UtxoId!) {
   coin(utxoId: $coinId) {
@@ -785,6 +789,9 @@ var GetCoinsDocument = gql`
     first: $first
     last: $last
   ) {
+    pageInfo {
+      ...pageInfoFragment
+    }
     edges {
       node {
         ...coinFragment
@@ -792,7 +799,8 @@ var GetCoinsDocument = gql`
     }
   }
 }
-    ${CoinFragmentDoc}`;
+    ${PageInfoFragmentDoc}
+${CoinFragmentDoc}`;
 var GetCoinsToSpendDocument = gql`
     query getCoinsToSpend($owner: Address!, $queryPerAsset: [SpendQueryElementInput!]!, $excludedIds: ExcludeInput) {
   coinsToSpend(
@@ -851,6 +859,9 @@ var GetBalancesDocument = gql`
     first: $first
     last: $last
   ) {
+    pageInfo {
+      ...pageInfoFragment
+    }
     edges {
       node {
         ...balanceFragment
@@ -858,7 +869,8 @@ var GetBalancesDocument = gql`
     }
   }
 }
-    ${BalanceFragmentDoc}`;
+    ${PageInfoFragmentDoc}
+${BalanceFragmentDoc}`;
 var GetMessagesDocument = gql`
     query getMessages($owner: Address!, $after: String, $before: String, $first: Int, $last: Int) {
   messages(
@@ -868,6 +880,9 @@ var GetMessagesDocument = gql`
     first: $first
     last: $last
   ) {
+    pageInfo {
+      ...pageInfoFragment
+    }
     edges {
       node {
         ...messageFragment
@@ -875,7 +890,8 @@ var GetMessagesDocument = gql`
     }
   }
 }
-    ${MessageFragmentDoc}`;
+    ${PageInfoFragmentDoc}
+${MessageFragmentDoc}`;
 var GetMessageProofDocument = gql`
     query getMessageProof($transactionId: TransactionId!, $nonce: Nonce!, $commitBlockId: BlockId, $commitBlockHeight: U32) {
   messageProof(
@@ -3736,12 +3752,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,
@@ -3767,6 +3789,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.
    *
@@ -3830,6 +3861,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 {
@@ -4473,7 +4506,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).
@@ -4584,20 +4617,27 @@ Supported fuel-core version: ${supportedVersion}.`
    */
   async getCoins(owner, assetId, paginationArgs) {
     const ownerAddress = Address2.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 && hexlify12(assetId) }
     });
-    const coins = result.coins.edges.map((edge) => edge.node);
-    return coins.map((coin) => ({
-      id: coin.utxoId,
-      assetId: coin.assetId,
-      amount: bn17(coin.amount),
-      owner: Address2.fromAddressOrString(coin.owner),
-      blockCreated: bn17(coin.blockCreated),
-      txCreatedIdx: bn17(coin.txCreatedIdx)
+    const coins = edges.map(({ node }) => ({
+      id: node.utxoId,
+      assetId: node.assetId,
+      amount: bn17(node.amount),
+      owner: Address2.fromAddressOrString(node.owner),
+      blockCreated: bn17(node.blockCreated),
+      txCreatedIdx: bn17(node.txCreatedIdx)
     }));
+    return {
+      coins,
+      pageInfo
+    };
   }
   /**
    * Returns resources for the given owner satisfying the spend query.
@@ -4690,14 +4730,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: bn17(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.
@@ -4807,17 +4854,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: Address2.fromAddressOrString(owner).toB256() }
     });
-    const balances = result.balances.edges.map((edge) => edge.node);
-    return balances.map((balance) => ({
-      assetId: balance.assetId,
-      amount: bn17(balance.amount)
+    const balances = edges.map(({ node }) => ({
+      assetId: node.assetId,
+      amount: bn17(node.amount)
     }));
+    return { balances };
   }
   /**
    * Returns message for the given address.
@@ -4827,27 +4879,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: Address2.fromAddressOrString(address).toB256()
     });
-    const messages = result.messages.edges.map((edge) => edge.node);
-    return messages.map((message) => ({
+    const messages = edges.map(({ node }) => ({
       messageId: InputMessageCoder.getMessageId({
-        sender: message.sender,
-        recipient: message.recipient,
-        nonce: message.nonce,
-        amount: bn17(message.amount),
-        data: message.data
+        sender: node.sender,
+        recipient: node.recipient,
+        nonce: node.nonce,
+        amount: bn17(node.amount),
+        data: node.data
       }),
-      sender: Address2.fromAddressOrString(message.sender),
-      recipient: Address2.fromAddressOrString(message.recipient),
-      nonce: message.nonce,
-      amount: bn17(message.amount),
-      data: InputMessageCoder.decodeData(message.data),
-      daHeight: bn17(message.daHeight)
+      sender: Address2.fromAddressOrString(node.sender),
+      recipient: Address2.fromAddressOrString(node.recipient),
+      nonce: node.nonce,
+      amount: bn17(node.amount),
+      data: InputMessageCoder.decodeData(node.data),
+      daHeight: bn17(node.daHeight)
     }));
+    return {
+      messages,
+      pageInfo
+    };
   }
   /**
    * Returns Message Proof for given transaction id and the message id from MessageOut receipt.
@@ -5026,6 +5085,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 FuelError13(
+        ErrorCode13.INVALID_INPUT_PARAMETERS,
+        'Pagination arguments "after" and "before" cannot be used together'
+      );
+    }
+    if ((first || 0) > paginationLimit || (last || 0) > paginationLimit) {
+      throw new FuelError13(
+        ErrorCode13.INVALID_INPUT_PARAMETERS,
+        `Pagination limit for this query cannot exceed ${paginationLimit} items`
+      );
+    }
+    if (first && before) {
+      throw new FuelError13(
+        ErrorCode13.INVALID_INPUT_PARAMETERS,
+        'The use of pagination argument "first" with "before" is not supported'
+      );
+    }
+    if (last && after) {
+      throw new FuelError13(
+        ErrorCode13.INVALID_INPUT_PARAMETERS,
+        'The use of pagination argument "last" with "after" is not supported'
+      );
+    }
+    if (!first && !last) {
+      inputArgs.first = paginationLimit;
+    }
+    return inputArgs;
+  }
   /**
    * @hidden
    */
@@ -5426,52 +5520,16 @@ var Account = class extends 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 FuelError15(
-        ErrorCode15.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 FuelError15(
-        ErrorCode15.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.
@@ -5490,25 +5548,7 @@ var Account = class extends 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 FuelError15(
-        ErrorCode15.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.
@@ -9745,7 +9785,7 @@ var FuelConnector = class extends EventEmitter2 {
     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.
@@ -9759,7 +9799,7 @@ var FuelConnector = class extends EventEmitter2 {
     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.
@@ -10240,6 +10280,7 @@ __publicField(Fuel, "defaultConfig", {});
 export {
   Account,
   AddressType,
+  BLOCKS_PAGE_SIZE_LIMIT,
   BaseTransactionRequest,
   BaseWalletUnlocked,
   CHAIN_IDS,
@@ -10264,6 +10305,7 @@ export {
   Predicate,
   PrivateKeyVault,
   Provider,
+  RESOURCES_PAGE_SIZE_LIMIT,
   ScriptTransactionRequest,
   Signer,
   StorageAbstract,