@human-protocol/sdk 3.0.0 → 3.0.1

package/dist/statistics.js

@@ -362,7 +362,7 @@ class StatisticsClient {
     async getHMTStatistics(params = {}) {
         try {
             const { hmtokenStatistics } = await (0, graphql_request_1.default)(this.subgraphUrl, graphql_1.GET_HMTOKEN_STATISTICS_QUERY);
-            const { holders } = await (0, graphql_request_1.default)(this.subgraphUrl, graphql_1.GET_HOLDERS_QUERY);
+            const { holders } = await (0, graphql_request_1.default)(this.subgraphUrl, (0, graphql_1.GET_HOLDERS_QUERY)());
             const { eventDayDatas } = await (0, graphql_request_1.default)(this.subgraphUrl, (0, graphql_1.GET_EVENT_DAY_DATA_QUERY)(params), {
                 from: params.from ? params.from.getTime() / 1000 : undefined,
                 to: params.to ? params.to.getTime() / 1000 : undefined,
@@ -379,6 +379,8 @@ class StatisticsClient {
                     timestamp: new Date(+eventDayData.timestamp * 1000),
                     totalTransactionAmount: ethers_1.ethers.toBigInt(eventDayData.dailyHMTTransferAmount),
                     totalTransactionCount: +eventDayData.dailyHMTTransferCount,
+                    dailyUniqueSenders: +eventDayData.dailyUniqueSenders,
+                    dailyUniqueReceivers: +eventDayData.dailyUniqueReceivers,
                 })),
             };
         }
@@ -386,5 +388,48 @@ class StatisticsClient {
             return (0, utils_1.throwError)(e);
         }
     }
+    /**
+     * This function returns the holders of the HMToken with optional filters and ordering.
+     *
+     * **Input parameters**
+     *
+     * @param {IHMTHoldersParams} params HMT Holders params with filters and ordering
+     * @returns {HMTHolder[]} List of HMToken holders.
+     *
+     * **Code example**
+     *
+     * ```ts
+     * import { StatisticsClient, ChainId, NETWORKS } from '@human-protocol/sdk';
+     *
+     * const statisticsClient = new StatisticsClient(NETWORKS[ChainId.POLYGON_AMOY]);
+     *
+     * const hmtHolders = await statisticsClient.getHMTHolders({
+     *   orderDirection: 'asc',
+     * });
+     *
+     * console.log('HMT holders:', hmtHolders.map((h) => ({
+     *   ...h,
+     *   balance: h.balance.toString(),
+     * })));
+     * ```
+     */
+    async getHMTHolders(params = {}) {
+        try {
+            const { address, orderDirection } = params;
+            const query = (0, graphql_1.GET_HOLDERS_QUERY)(address);
+            const { holders } = await (0, graphql_request_1.default)(this.subgraphUrl, query, {
+                address,
+                orderBy: 'balance',
+                orderDirection,
+            });
+            return holders.map((holder) => ({
+                address: holder.address,
+                balance: ethers_1.ethers.toBigInt(holder.balance),
+            }));
+        }
+        catch (e) {
+            return (0, utils_1.throwError)(e);
+        }
+    }
 }
 exports.StatisticsClient = StatisticsClient;

package/dist/transaction.d.ts

@@ -26,13 +26,16 @@ export declare class TransactionUtils {
      *
      * ```ts
      * interface ITransactionsFilter {
-     *   networks: ChainId[]; // List of chain IDs to query.
+     *   chainId: ChainId; // List of chain IDs to query.
      *   fromAddress?: string; // (Optional) The address from which transactions are sent.
      *   toAddress?: string; // (Optional) The address to which transactions are sent.
      *   startDate?: Date; // (Optional) The start date to filter transactions (inclusive).
      *   endDate?: Date; // (Optional) The end date to filter transactions (inclusive).
      *   startBlock?: number; // (Optional) The start block number to filter transactions (inclusive).
      *   endBlock?: number; // (Optional) The end block number to filter transactions (inclusive).
+     *   first?: number; // (Optional) Number of transactions per page. Default is 10.
+     *   skip?: number; // (Optional) Number of transactions to skip. Default is 0.
+     *   orderDirection?: OrderDirection; // (Optional) Order of the results. Default is DESC.
      * }
      * ```
      *
@@ -54,12 +57,15 @@ export declare class TransactionUtils {
      * **Code example**
      *
      * ```ts
-     * import { TransactionUtils, ChainId } from '@human-protocol/sdk';
+     * import { TransactionUtils, ChainId, OrderDirection } from '@human-protocol/sdk';
      *
      * const filter: ITransactionsFilter = {
-     *   networks: [ChainId.POLYGON],
+     *   chainId: ChainId.POLYGON,
      *   startDate: new Date('2022-01-01'),
-     *   endDate: new Date('2022-12-31')
+     *   endDate: new Date('2022-12-31'),
+     *   first: 10,
+     *   skip: 0,
+     *   orderDirection: OrderDirection.DESC,
      * };
      * const transactions = await TransactionUtils.getTransactions(filter);
      * ```

package/dist/transaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAUlC,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGjE,qBAAa,gBAAgB;IAC3B;;;;;;;;;;;;;;OAcG;WACiB,cAAc,CAChC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,CAAC;IAmBxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;WACiB,eAAe,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC;CAqC3B"}
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAkB,MAAM,SAAS,CAAC;AAUlD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGjE,qBAAa,gBAAgB;IAC3B;;;;;;;;;;;;;;OAcG;WACiB,cAAc,CAChC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,CAAC;IAmBxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoDG;WACiB,eAAe,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC;CAyC3B"}

package/dist/transaction.js

@@ -8,6 +8,7 @@ exports.TransactionUtils = void 0;
 const ethers_1 = require("ethers");
 const graphql_request_1 = __importDefault(require("graphql-request"));
 const constants_1 = require("./constants");
+const enums_1 = require("./enums");
 const error_1 = require("./error");
 const transaction_1 = require("./graphql/queries/transaction");
 const utils_1 = require("./utils");
@@ -49,13 +50,16 @@ class TransactionUtils {
      *
      * ```ts
      * interface ITransactionsFilter {
-     *   networks: ChainId[]; // List of chain IDs to query.
+     *   chainId: ChainId; // List of chain IDs to query.
      *   fromAddress?: string; // (Optional) The address from which transactions are sent.
      *   toAddress?: string; // (Optional) The address to which transactions are sent.
      *   startDate?: Date; // (Optional) The start date to filter transactions (inclusive).
      *   endDate?: Date; // (Optional) The end date to filter transactions (inclusive).
      *   startBlock?: number; // (Optional) The start block number to filter transactions (inclusive).
      *   endBlock?: number; // (Optional) The end block number to filter transactions (inclusive).
+     *   first?: number; // (Optional) Number of transactions per page. Default is 10.
+     *   skip?: number; // (Optional) Number of transactions to skip. Default is 0.
+     *   orderDirection?: OrderDirection; // (Optional) Order of the results. Default is DESC.
      * }
      * ```
      *
@@ -77,12 +81,15 @@ class TransactionUtils {
      * **Code example**
      *
      * ```ts
-     * import { TransactionUtils, ChainId } from '@human-protocol/sdk';
+     * import { TransactionUtils, ChainId, OrderDirection } from '@human-protocol/sdk';
      *
      * const filter: ITransactionsFilter = {
-     *   networks: [ChainId.POLYGON],
+     *   chainId: ChainId.POLYGON,
      *   startDate: new Date('2022-01-01'),
-     *   endDate: new Date('2022-12-31')
+     *   endDate: new Date('2022-12-31'),
+     *   first: 10,
+     *   skip: 0,
+     *   orderDirection: OrderDirection.DESC,
      * };
      * const transactions = await TransactionUtils.getTransactions(filter);
      * ```
@@ -92,30 +99,32 @@ class TransactionUtils {
             (!!filter.startBlock || !!filter.endBlock)) {
             throw error_1.ErrorCannotUseDateAndBlockSimultaneously;
         }
-        const transactions_data = [];
-        for (const chainId of filter.networks) {
-            const networkData = constants_1.NETWORKS[chainId];
-            if (!networkData) {
-                throw error_1.ErrorUnsupportedChainID;
-            }
-            const { transactions } = await (0, graphql_request_1.default)((0, utils_1.getSubgraphUrl)(networkData), (0, transaction_1.GET_TRANSACTIONS_QUERY)(filter), {
-                fromAddress: filter?.fromAddress,
-                toAddress: filter?.toAddress,
-                startDate: filter?.startDate
-                    ? Math.floor(filter?.startDate.getTime() / 1000)
-                    : undefined,
-                endDate: filter.endDate
-                    ? Math.floor(filter.endDate.getTime() / 1000)
-                    : undefined,
-                startBlock: filter.startBlock ? filter.startBlock : undefined,
-                endBlock: filter.endBlock ? filter.endBlock : undefined,
-            });
-            if (!transactions) {
-                continue;
-            }
-            transactions_data.push(...transactions);
+        const first = filter.first !== undefined ? Math.min(filter.first, 1000) : 10;
+        const skip = filter.skip || 0;
+        const orderDirection = filter.orderDirection || enums_1.OrderDirection.DESC;
+        const networkData = constants_1.NETWORKS[filter.chainId];
+        if (!networkData) {
+            throw error_1.ErrorUnsupportedChainID;
+        }
+        const { transactions } = await (0, graphql_request_1.default)((0, utils_1.getSubgraphUrl)(networkData), (0, transaction_1.GET_TRANSACTIONS_QUERY)(filter), {
+            fromAddress: filter?.fromAddress,
+            toAddress: filter?.toAddress,
+            startDate: filter?.startDate
+                ? Math.floor(filter?.startDate.getTime() / 1000)
+                : undefined,
+            endDate: filter.endDate
+                ? Math.floor(filter.endDate.getTime() / 1000)
+                : undefined,
+            startBlock: filter.startBlock ? filter.startBlock : undefined,
+            endBlock: filter.endBlock ? filter.endBlock : undefined,
+            orderDirection: orderDirection,
+            first: first,
+            skip: skip,
+        });
+        if (!transactions) {
+            return [];
         }
-        return transactions_data;
+        return transactions;
     }
 }
 exports.TransactionUtils = TransactionUtils;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@human-protocol/sdk",
   "description": "Human Protocol SDK",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "files": [
     "src",
     "dist"
@@ -52,8 +52,8 @@
     "winston": "^3.13.0"
   },
   "devDependencies": {
-    "typedoc": "^0.25.1",
-    "typedoc-plugin-markdown": "^4.0.3"
+    "typedoc": "^0.26.5",
+    "typedoc-plugin-markdown": "^4.2.3"
   },
   "typedocOptions": {
     "entryPoints": [
@@ -64,7 +64,8 @@
       "./src/operator.ts",
       "./src/staking.ts",
       "./src/storage.ts",
-      "./src/statistics.ts"
+      "./src/statistics.ts",
+      "./src/transaction.ts"
     ]
   }
 }

package/src/enums.ts

@@ -19,3 +19,8 @@ export enum ChainId {
   LOCALHOST = 1338,
   XLAYER = 196,
 }
+
+export enum OrderDirection {
+  ASC = 'asc',
+  DESC = 'desc',
+}

package/src/error.ts

@@ -335,5 +335,13 @@ export class InvalidEthereumAddressError extends Error {
  */
 export const ErrorInvalidHash = new Error('Invalid hash');
 
+/**
+ * @constant {Error} - The Status is not supported
+ */
+export const ErrorUnsupportedStatus = new Error('Unsupported status for query');
+
+/**
+ * @constant {Error} - The SUBGRAPH_API_KEY is not being provided
+ */
 export const WarnSubgraphApiKeyNotProvided =
   '"SUBGRAPH_API_KEY" is not being provided. It might cause issues with the subgraph.';

package/src/escrow.ts

@@ -12,7 +12,7 @@ import gqlFetch from 'graphql-request';
 import { BaseEthersClient } from './base';
 import { DEFAULT_TX_ID, NETWORKS } from './constants';
 import { requiresSigner } from './decorators';
-import { ChainId } from './enums';
+import { ChainId, OrderDirection } from './enums';
 import {
   ErrorAmountMustBeGreaterThanZero,
   ErrorAmountsCannotBeEmptyArray,
@@ -41,6 +41,8 @@ import {
   EscrowData,
   GET_ESCROWS_QUERY,
   GET_ESCROW_BY_ADDRESS_QUERY,
+  GET_STATUS_UPDATES_QUERY,
+  StatusEvent,
 } from './graphql';
 import { IEscrowConfig, IEscrowsFilter } from './interfaces';
 import { EscrowCancel, EscrowStatus, NetworkData } from './types';
@@ -1399,7 +1401,7 @@ export class EscrowClient extends BaseEthersClient {
  * import { ChainId, EscrowUtils } from '@human-protocol/sdk';
  *
  * const escrowAddresses = new EscrowUtils.getEscrows({
- *   networks: [ChainId.POLYGON_AMOY]
+ *   network: ChainId.POLYGON_AMOY
  * });
  * ```
  */
@@ -1412,7 +1414,7 @@ export class EscrowUtils {
    *
    * ```ts
    * interface IEscrowsFilter {
-   *   networks: ChainId[];
+   *   chainId: ChainId;
    *   launcher?: string;
    *   reputationOracle?: string;
    *   recordingOracle?: string;
@@ -1421,6 +1423,9 @@ export class EscrowUtils {
    *   status?: EscrowStatus;
    *   from?: Date;
    *   to?: Date;
+   *   first?: number;
+   *   skip?: number;
+   *   orderDirection?: OrderDirection;
    * }
    * ```
    *
@@ -1447,6 +1452,13 @@ export class EscrowUtils {
    * ```
    *
    * ```ts
+   * enum OrderDirection {
+   *   ASC = 'asc',
+   *   DESC = 'desc',
+   * }
+   * ```
+   *
+   * ```ts
    * enum EscrowStatus {
    *   Launched,
    *   Pending,
@@ -1497,7 +1509,7 @@ export class EscrowUtils {
    *   status: EscrowStatus.Pending,
    *   from: new Date(2023, 4, 8),
    *   to: new Date(2023, 5, 8),
-   *   networks: [ChainId.POLYGON_AMOY]
+   *   chainId: ChainId.POLYGON_AMOY
    * };
    * const escrowDatas = await EscrowUtils.getEscrows(filters);
    * ```
@@ -1505,9 +1517,6 @@ export class EscrowUtils {
   public static async getEscrows(
     filter: IEscrowsFilter
   ): Promise<EscrowData[]> {
-    if (!filter?.networks?.length) {
-      throw ErrorUnsupportedChainID;
-    }
     if (filter.launcher && !ethers.isAddress(filter.launcher)) {
       throw ErrorInvalidAddress;
     }
@@ -1524,42 +1533,46 @@ export class EscrowUtils {
       throw ErrorInvalidAddress;
     }
 
-    try {
-      const escrowAddresses: EscrowData[] = [];
-      for (const chainId of filter.networks) {
-        const networkData = NETWORKS[chainId];
+    const first =
+      filter.first !== undefined ? Math.min(filter.first, 1000) : 10;
+    const skip = filter.skip || 0;
+    const orderDirection = filter.orderDirection || OrderDirection.DESC;
 
-        if (!networkData) {
-          throw ErrorUnsupportedChainID;
-        }
+    const networkData = NETWORKS[filter.chainId];
 
-        const { escrows } = await gqlFetch<{ escrows: EscrowData[] }>(
-          getSubgraphUrl(networkData),
-          GET_ESCROWS_QUERY(filter),
-          {
-            ...filter,
-            launcher: filter.launcher?.toLowerCase(),
-            reputationOracle: filter.reputationOracle?.toLowerCase(),
-            recordingOracle: filter.recordingOracle?.toLowerCase(),
-            exchangeOracle: filter.exchangeOracle?.toLowerCase(),
-            status:
-              filter.status !== undefined
-                ? Object.entries(EscrowStatus).find(
-                    ([, value]) => value === filter.status
-                  )?.[0]
-                : undefined,
-            from: filter.from ? +filter.from.getTime() / 1000 : undefined,
-            to: filter.to ? +filter.to.getTime() / 1000 : undefined,
-          }
-        );
-        escrows.map((escrow) => (escrow.chainId = networkData.chainId));
-        escrowAddresses.push(...escrows);
+    if (!networkData) {
+      throw ErrorUnsupportedChainID;
+    }
+
+    const { escrows } = await gqlFetch<{ escrows: EscrowData[] }>(
+      getSubgraphUrl(networkData),
+      GET_ESCROWS_QUERY(filter),
+      {
+        ...filter,
+        launcher: filter.launcher?.toLowerCase(),
+        reputationOracle: filter.reputationOracle?.toLowerCase(),
+        recordingOracle: filter.recordingOracle?.toLowerCase(),
+        exchangeOracle: filter.exchangeOracle?.toLowerCase(),
+        status:
+          filter.status !== undefined
+            ? Object.entries(EscrowStatus).find(
+                ([, value]) => value === filter.status
+              )?.[0]
+            : undefined,
+        from: filter.from ? +filter.from.getTime() / 1000 : undefined,
+        to: filter.to ? +filter.to.getTime() / 1000 : undefined,
+        orderDirection: orderDirection,
+        first: first,
+        skip: skip,
       }
-      escrowAddresses.sort((a, b) => Number(b.createdAt) - Number(a.createdAt));
-      return escrowAddresses;
-    } catch (e: any) {
-      return throwError(e);
+    );
+    escrows.map((escrow) => (escrow.chainId = networkData.chainId));
+
+    if (!escrows) {
+      return [];
     }
+
+    return escrows;
   }
 
   /**
@@ -1644,16 +1657,152 @@ export class EscrowUtils {
       throw ErrorInvalidAddress;
     }
 
-    try {
-      const { escrow } = await gqlFetch<{ escrow: EscrowData }>(
-        getSubgraphUrl(networkData),
-        GET_ESCROW_BY_ADDRESS_QUERY(),
-        { escrowAddress: escrowAddress.toLowerCase() }
-      );
+    const { escrow } = await gqlFetch<{ escrow: EscrowData }>(
+      getSubgraphUrl(networkData),
+      GET_ESCROW_BY_ADDRESS_QUERY(),
+      { escrowAddress: escrowAddress.toLowerCase() }
+    );
 
-      return escrow || null;
-    } catch (e: any) {
-      return throwError(e);
+    return escrow || null;
+  }
+
+  /**
+   * This function returns the status events for a given set of networks within an optional date range.
+   *
+   * > This uses Subgraph
+   *
+   * **Input parameters**
+   *
+   * ```ts
+   * enum ChainId {
+   *   ALL = -1,
+   *   MAINNET = 1,
+   *   RINKEBY = 4,
+   *   GOERLI = 5,
+   *   SEPOLIA = 11155111,
+   *   BSC_MAINNET = 56,
+   *   BSC_TESTNET = 97,
+   *   POLYGON = 137,
+   *   POLYGON_MUMBAI = 80001,
+   *   POLYGON_AMOY = 80002,
+   *   MOONBEAM = 1284,
+   *   MOONBASE_ALPHA = 1287,
+   *   AVALANCHE = 43114,
+   *   AVALANCHE_TESTNET = 43113,
+   *   CELO = 42220,
+   *   CELO_ALFAJORES = 44787,
+   *   LOCALHOST = 1338,
+   *   XLAYER_TESTNET = 195,
+   *   XLAYER = 196,
+   * }
+   * ```
+   *
+   * ```ts
+   * enum OrderDirection {
+   *   ASC = 'asc',
+   *   DESC = 'desc',
+   * }
+   * ```
+   *
+   * ```ts
+   * type Status = {
+   *   escrowAddress: string;
+   *   timestamp: string;
+   *   status: string;
+   * };
+   * ```
+   *
+   * @param {ChainId} chainId - List of network IDs to query for status events.
+   * @param {EscrowStatus[]} [statuses] - Optional array of statuses to query for. If not provided, queries for all statuses.
+   * @param {Date} [from] - Optional start date to filter events.
+   * @param {Date} [to] - Optional end date to filter events.
+   * @param {string} [launcher] - Optional launcher address to filter events. Must be a valid Ethereum address.
+   * @param {number} [first] - Optional number of transactions per page. Default is 10.
+   * @param {number} [skip] - Optional number of transactions to skip. Default is 0.
+   * @param {OrderDirection} [orderDirection] - Optional order of the results. Default is DESC.
+   * @returns {Promise<StatusEvent[]>} - Array of status events with their corresponding statuses.
+   *
+   * **Code example**
+   *
+   * ```ts
+   * import { ChainId, EscrowUtils, EscrowStatus } from '@human-protocol/sdk';
+   *
+   * (async () => {
+   *   const fromDate = new Date('2023-01-01');
+   *   const toDate = new Date('2023-12-31');
+   *   const statusEvents = await EscrowUtils.getStatusEvents(
+   *     [ChainId.POLYGON, ChainId.MAINNET],
+   *     [EscrowStatus.Pending, EscrowStatus.Complete],
+   *     fromDate,
+   *     toDate
+   *   );
+   *   console.log(statusEvents);
+   * })();
+   * ```
+   */
+
+  public static async getStatusEvents(
+    chainId: ChainId,
+    statuses?: EscrowStatus[],
+    from?: Date,
+    to?: Date,
+    launcher?: string,
+    first?: number,
+    skip?: number,
+    orderDirection?: OrderDirection
+  ): Promise<StatusEvent[]> {
+    if (launcher && !ethers.isAddress(launcher)) {
+      throw ErrorInvalidAddress;
     }
+
+    first = first !== undefined ? Math.min(first, 1000) : 10;
+    skip = skip || 0;
+    orderDirection = orderDirection || OrderDirection.DESC;
+
+    // If statuses are not provided, use all statuses except Launched
+    const effectiveStatuses = statuses ?? [
+      EscrowStatus.Launched,
+      EscrowStatus.Pending,
+      EscrowStatus.Partial,
+      EscrowStatus.Paid,
+      EscrowStatus.Complete,
+      EscrowStatus.Cancelled,
+    ];
+
+    const networkData = NETWORKS[chainId];
+    if (!networkData) {
+      throw ErrorUnsupportedChainID;
+    }
+
+    const statusNames = effectiveStatuses.map((status) => EscrowStatus[status]);
+
+    const data = await gqlFetch<{
+      escrowStatusEvents: StatusEvent[];
+    }>(
+      getSubgraphUrl(networkData),
+      GET_STATUS_UPDATES_QUERY(from, to, launcher),
+      {
+        status: statusNames,
+        from: from ? Math.floor(from.getTime() / 1000) : undefined,
+        to: to ? Math.floor(to.getTime() / 1000) : undefined,
+        launcher: launcher || undefined,
+        orderDirection: orderDirection,
+        first: first,
+        skip: skip,
+      }
+    );
+
+    if (!data || !data['escrowStatusEvents']) {
+      return [];
+    }
+
+    const statusEvents = data['escrowStatusEvents'] as StatusEvent[];
+
+    const eventsWithChainId = statusEvents.map((event) => ({
+      ...event,
+      chainId,
+    }));
+
+    return eventsWithChainId;
   }
 }

package/src/graphql/queries/escrow.ts

@@ -51,14 +51,14 @@ export const GET_ESCROWS_QUERY = (filter: IEscrowsFilter) => {
 
   const WHERE_CLAUSE = `
     where: {
-      ${launcher ? `launcher: $launcher` : ''}
-      ${jobRequesterId ? `jobRequesterId: $jobRequesterId` : ''}
-      ${reputationOracle ? `reputationOracle: $reputationOracle` : ''}
-      ${recordingOracle ? `recordingOracle: $recordingOracle` : ''}
-      ${exchangeOracle ? `exchangeOracle: $exchangeOracle` : ''}
-      ${status !== undefined ? `status: $status` : ''}
-      ${from ? `createdAt_gte: $from` : ''}
-      ${to ? `createdAt_lte: $to` : ''}
+      ${launcher ? `launcher: $launcher,` : ''}
+      ${jobRequesterId ? `jobRequesterId: $jobRequesterId,` : ''}
+      ${reputationOracle ? `reputationOracle: $reputationOracle,` : ''}
+      ${recordingOracle ? `recordingOracle: $recordingOracle,` : ''}
+      ${exchangeOracle ? `exchangeOracle: $exchangeOracle,` : ''}
+      ${status !== undefined ? `status: $status,` : ''}
+      ${from ? `createdAt_gte: $from,` : ''}
+      ${to ? `createdAt_lte: $to,` : ''}
     }
   `;
 
@@ -72,9 +72,16 @@ export const GET_ESCROWS_QUERY = (filter: IEscrowsFilter) => {
       $status: String
       $from: Int
       $to: Int
+      $orderDirection: String
+      $first: Int
+      $skip: Int
     ) {
       escrows(
         ${WHERE_CLAUSE}
+        orderBy: createdAt,
+        orderDirection: $orderDirection,
+        first: $first,
+        skip: $skip
       ) {
         ...EscrowFields
       }
@@ -82,3 +89,41 @@ export const GET_ESCROWS_QUERY = (filter: IEscrowsFilter) => {
     ${ESCROW_FRAGMENT}
   `;
 };
+
+export const GET_STATUS_UPDATES_QUERY = (
+  from?: Date,
+  to?: Date,
+  launcher?: string
+) => {
+  const WHERE_CLAUSE = `
+    where: {
+      status_in: $status
+      ${from ? `timestamp_gte: $from` : ''}
+      ${to ? `timestamp_lte: $to` : ''}
+      ${launcher ? `launcher: $launcher` : ''}
+    }
+  `;
+  return gql`
+    query getStatus(
+      $status: [String!]!
+      $from: Int
+      $to: Int
+      $launcher: String
+      $orderDirection: String
+      $first: Int
+      $skip: Int
+    ) {
+      escrowStatusEvents(
+        ${WHERE_CLAUSE}
+        orderBy: timestamp,
+        orderDirection: $orderDirection,
+        first: $first,
+        skip: $skip
+      ) {
+        escrowAddress,
+        timestamp,
+        status,
+      }
+    }
+  `;
+};