@human-protocol/sdk 1.1.11 → 1.1.13

package/src/constants.ts

@@ -184,29 +184,31 @@ export const NETWORKS: {
     chainId: ChainId.AVALANCHE_TESTNET,
     title: 'Fuji C-Chain',
     scanUrl: 'https://testnet.snowtrace.io',
-    factoryAddress: '0xfb4469201951C3B9a7F1996c477cb7BDBEcE0A88',
+    factoryAddress: '0x56C2ba540726ED4f46E7a134b6b9Ee9C867FcF92',
     hmtAddress: '0x9406d5c635AD22b0d76c75E52De57A2177919ca3',
-    stakingAddress: '',
-    rewardPoolAddress: '',
-    kvstoreAddress: '0xd232c1426CF0653cE8a71DC98bCfDf10c471c114',
-
-    subgraphUrl: 'https://api.thegraph.com/subgraphs/name/humanprotocol/fuji',
-    oldSubgraphUrl: '',
-    oldFactoryAddress: '',
+    stakingAddress: '0x9890473B0b93E24d6D1a8Dfb739D577C6f25FFd3',
+    rewardPoolAddress: '0x5517fE916Fe9F8dB15B0DDc76ebDf0BdDCd4ed18',
+    kvstoreAddress: '0x707fb5A5d36BC15275Af3f73262bf9a1D8C470EB',
+    subgraphUrl:
+      'https://api.thegraph.com/subgraphs/name/humanprotocol/fuji-v2',
+    oldSubgraphUrl:
+      'https://api.thegraph.com/subgraphs/name/humanprotocol/fuji',
+    oldFactoryAddress: '0xfb4469201951C3B9a7F1996c477cb7BDBEcE0A88',
   },
   [ChainId.AVALANCHE]: {
     chainId: ChainId.AVALANCHE,
     title: 'Avalanche C-Chain Mainnet',
     scanUrl: 'https://snowtrace.io',
-    factoryAddress: '0x9767a578ba7a5FA1563c8229943cB01cd8446BB4',
+    factoryAddress: '0xD9c75a1Aa4237BB72a41E5E26bd8384f10c1f55a',
     hmtAddress: '0x12365293cb6477d4fc2686e46BB97E3Fb64f1550',
-    stakingAddress: '',
-    rewardPoolAddress: '',
-    kvstoreAddress: '0x4B79eaD28F52eD5686bf0e379717e85fc7aD10Df',
+    stakingAddress: '0x05398211bA2046E296fBc9a9D3EB49e3F15C3123',
+    rewardPoolAddress: '0x4A5963Dd6792692e9147EdC7659936b96251917a',
+    kvstoreAddress: '0x70671167176C4934204B1C7e97F5e86695857ef2',
     subgraphUrl:
+      'https://api.thegraph.com/subgraphs/name/humanprotocol/avalanche-v2',
+    oldSubgraphUrl:
       'https://api.thegraph.com/subgraphs/name/humanprotocol/avalanche',
-    oldSubgraphUrl: '',
-    oldFactoryAddress: '',
+    oldFactoryAddress: '0x9767a578ba7a5FA1563c8229943cB01cd8446BB4',
   },
   [ChainId.SKALE]: {
     chainId: ChainId.SKALE,

package/src/error.ts

@@ -75,6 +75,13 @@ export const ErrorInvalidReputationOracleAddressProvided = new Error(
   'Invalid reputation oracle address provided'
 );
 
+/**
+ * @constant {Error} - Invalid reputation oracle address provided.
+ */
+export const ErrorInvalidExchangeOracleAddressProvided = new Error(
+  'Invalid exchange oracle address provided'
+);
+
 /**
  * @constant {Error} - The Staking value must be positive.
  */
@@ -160,6 +167,13 @@ export const ErrorEscrowAddressIsNotProvidedByFactory = new Error(
   'Escrow address is not provided by the factory'
 );
 
+/**
+ * @constant {Error} - Transfer event not found in transaction logs.
+ */
+export const ErrorTransferEventNotFoundInTransactionLogs = new Error(
+  'Transfer event not found in transaction logs'
+);
+
 /**
  * @constant {Error} - Manifest file does not exist.
  */

package/src/escrow.ts

@@ -35,11 +35,17 @@ import {
   ErrorTotalFeeMustBeLessThanHundred,
   ErrorUrlIsEmptyString,
   InvalidEthereumAddressError,
+  ErrorInvalidExchangeOracleAddressProvided,
+  ErrorTransferEventNotFoundInTransactionLogs,
 } from './error';
 import { IEscrowConfig, IEscrowsFilter } from './interfaces';
-import { EscrowStatus, NetworkData } from './types';
+import { EscrowCancel, EscrowStatus, NetworkData } from './types';
 import { isValidUrl, throwError } from './utils';
-import { EscrowData, GET_ESCROWS_QUERY } from './graphql';
+import {
+  EscrowData,
+  GET_ESCROWS_QUERY,
+  GET_ESCROW_BY_ADDRESS_QUERY,
+} from './graphql';
 
 export class EscrowClient {
   private escrowFactoryContract: EscrowFactory;
@@ -155,8 +161,10 @@ export class EscrowClient {
     const {
       recordingOracle,
       reputationOracle,
+      exchangeOracle,
       recordingOracleFee,
       reputationOracleFee,
+      exchangeOracleFee,
       manifestUrl,
       manifestHash,
     } = escrowConfig;
@@ -169,15 +177,25 @@ export class EscrowClient {
       throw ErrorInvalidReputationOracleAddressProvided;
     }
 
+    if (!ethers.utils.isAddress(exchangeOracle)) {
+      throw ErrorInvalidExchangeOracleAddressProvided;
+    }
+
     if (!ethers.utils.isAddress(escrowAddress)) {
       throw ErrorInvalidEscrowAddressProvided;
     }
 
-    if (recordingOracleFee.lte(0) || reputationOracleFee.lte(0)) {
+    if (
+      recordingOracleFee.lte(0) ||
+      reputationOracleFee.lte(0) ||
+      exchangeOracleFee.lte(0)
+    ) {
       throw ErrorAmountMustBeGreaterThanZero;
     }
 
-    if (recordingOracleFee.add(reputationOracleFee).gt(100)) {
+    if (
+      recordingOracleFee.add(reputationOracleFee).add(exchangeOracleFee).gt(100)
+    ) {
       throw ErrorTotalFeeMustBeLessThanHundred;
     }
 
@@ -205,8 +223,10 @@ export class EscrowClient {
       await this.escrowContract.setup(
         reputationOracle,
         recordingOracle,
+        exchangeOracle,
         reputationOracleFee,
         recordingOracleFee,
+        exchangeOracleFee,
         manifestUrl,
         manifestHash
       );
@@ -461,11 +481,11 @@ export class EscrowClient {
    * Cancels the specified escrow and sends the balance to the canceler.
    *
    * @param {string} escrowAddress - Address of the escrow.
-   * @returns {Promise<void>}
+   * @returns {Promise<EscrowCancel>}
    * @throws {Error} - An error object if an error occurred.
    */
   @requiresSigner
-  async cancel(escrowAddress: string): Promise<void> {
+  async cancel(escrowAddress: string): Promise<EscrowCancel> {
     if (!ethers.utils.isAddress(escrowAddress)) {
       throw ErrorInvalidEscrowAddressProvided;
     }
@@ -479,8 +499,39 @@ export class EscrowClient {
         escrowAddress,
         this.signerOrProvider
       );
-      await this.escrowContract.cancel();
-      return;
+      const tx = await this.escrowContract.cancel();
+      const transactionReceipt = await tx.wait();
+
+      let amountTransferred: BigNumber | undefined = undefined;
+      const tokenAddress = await this.escrowContract.token();
+
+      const tokenContract: HMToken = HMToken__factory.connect(
+        tokenAddress,
+        this.signerOrProvider
+      );
+
+      for (const log of transactionReceipt.logs) {
+        if (log.address === tokenAddress) {
+          const parsedLog = tokenContract.interface.parseLog(log);
+
+          const from = parsedLog.args[0];
+          if (parsedLog.name === 'Transfer' && from === escrowAddress) {
+            amountTransferred = parsedLog.args[2];
+            break;
+          }
+        }
+      }
+
+      if (amountTransferred === undefined) {
+        throw ErrorTransferEventNotFoundInTransactionLogs;
+      }
+
+      const escrowCancelData: EscrowCancel = {
+        txHash: transactionReceipt.transactionHash,
+        amountRefunded: amountTransferred,
+      };
+
+      return escrowCancelData;
     } catch (e) {
       return throwError(e);
     }
@@ -748,56 +799,40 @@ export class EscrowClient {
   }
 
   /**
-   * Returns the list of escrows for given filter
+   * Returns the recording oracle address of given escrow
    *
-   * @param {IEscrowsFilter} filter - Filter parameters.
-   * @returns {Promise<EscrowData[]>}
+   * @param {string} escrowAddress - Address of the escrow.
+   * @returns {Promise<string>} - Address of the recording oracle.
    * @throws {Error} - An error object if an error occurred.
    */
-  async getEscrows(filter: IEscrowsFilter = {}): Promise<EscrowData[]> {
-    if (filter.launcher && !ethers.utils.isAddress(filter.launcher)) {
-      throw ErrorInvalidAddress;
-    }
-
-    if (
-      filter.recordingOracle &&
-      !ethers.utils.isAddress(filter.recordingOracle)
-    ) {
-      throw ErrorInvalidAddress;
+  async getRecordingOracleAddress(escrowAddress: string): Promise<string> {
+    if (!ethers.utils.isAddress(escrowAddress)) {
+      throw ErrorInvalidEscrowAddressProvided;
     }
 
-    if (
-      filter.reputationOracle &&
-      !ethers.utils.isAddress(filter.reputationOracle)
-    ) {
-      throw ErrorInvalidAddress;
+    if (!(await this.escrowFactoryContract.hasEscrow(escrowAddress))) {
+      throw ErrorEscrowAddressIsNotProvidedByFactory;
     }
 
     try {
-      const { escrows } = await gqlFetch<{ escrows: EscrowData[] }>(
-        this.network.subgraphUrl,
-        GET_ESCROWS_QUERY(filter),
-        {
-          ...filter,
-          from: filter.from ? +filter.from.getTime() / 1000 : undefined,
-          to: filter.to ? +filter.to.getTime() / 1000 : undefined,
-        }
+      this.escrowContract = Escrow__factory.connect(
+        escrowAddress,
+        this.signerOrProvider
       );
-
-      return escrows;
+      return this.escrowContract.recordingOracle();
     } catch (e: any) {
       return throwError(e);
     }
   }
 
   /**
-   * Returns the recording oracle address of given escrow
+   * Returns the job launcher address of given escrow
    *
    * @param {string} escrowAddress - Address of the escrow.
-   * @returns {Promise<string>} - Address of the recording oracle.
+   * @returns {Promise<string>} - Address of the job launcher.
    * @throws {Error} - An error object if an error occurred.
    */
-  async getRecordingOracleAddress(escrowAddress: string): Promise<string> {
+  async getJobLauncherAddress(escrowAddress: string): Promise<string> {
     if (!ethers.utils.isAddress(escrowAddress)) {
       throw ErrorInvalidEscrowAddressProvided;
     }
@@ -811,20 +846,20 @@ export class EscrowClient {
         escrowAddress,
         this.signerOrProvider
       );
-      return this.escrowContract.recordingOracle();
+      return this.escrowContract.launcher();
     } catch (e: any) {
       return throwError(e);
     }
   }
 
   /**
-   * Returns the job launcher address of given escrow
+   * Returns the reputation oracle address of given escrow
    *
    * @param {string} escrowAddress - Address of the escrow.
-   * @returns {Promise<string>} - Address of the job launcher.
+   * @returns {Promise<string>} - Address of the reputation oracle.
    * @throws {Error} - An error object if an error occurred.
    */
-  async getJobLauncherAddress(escrowAddress: string): Promise<string> {
+  async getReputationOracleAddress(escrowAddress: string): Promise<string> {
     if (!ethers.utils.isAddress(escrowAddress)) {
       throw ErrorInvalidEscrowAddressProvided;
     }
@@ -838,7 +873,7 @@ export class EscrowClient {
         escrowAddress,
         this.signerOrProvider
       );
-      return this.escrowContract.launcher();
+      return this.escrowContract.reputationOracle();
     } catch (e: any) {
       return throwError(e);
     }
@@ -851,7 +886,7 @@ export class EscrowClient {
    * @returns {Promise<string>} - Address of the reputation oracle.
    * @throws {Error} - An error object if an error occurred.
    */
-  async getReputationOracleAddress(escrowAddress: string): Promise<string> {
+  async getExchangeOracleAddress(escrowAddress: string): Promise<string> {
     if (!ethers.utils.isAddress(escrowAddress)) {
       throw ErrorInvalidEscrowAddressProvided;
     }
@@ -865,7 +900,7 @@ export class EscrowClient {
         escrowAddress,
         this.signerOrProvider
       );
-      return this.escrowContract.reputationOracle();
+      return this.escrowContract.exchangeOracle();
     } catch (e: any) {
       return throwError(e);
     }
@@ -898,3 +933,111 @@ export class EscrowClient {
     }
   }
 }
+
+export class EscrowUtils {
+  /**
+   * Returns the list of escrows for given filter
+   *
+   * @param {IEscrowsFilter} filter - Filter parameters.
+   * @returns {Promise<EscrowData[]>}
+   * @throws {Error} - An error object if an error occurred.
+   */
+  public static async getEscrows(
+    filter: IEscrowsFilter
+  ): Promise<EscrowData[]> {
+    if (!filter?.networks?.length) {
+      throw ErrorUnsupportedChainID;
+    }
+    if (filter.launcher && !ethers.utils.isAddress(filter.launcher)) {
+      throw ErrorInvalidAddress;
+    }
+
+    if (
+      filter.recordingOracle &&
+      !ethers.utils.isAddress(filter.recordingOracle)
+    ) {
+      throw ErrorInvalidAddress;
+    }
+
+    if (
+      filter.reputationOracle &&
+      !ethers.utils.isAddress(filter.reputationOracle)
+    ) {
+      throw ErrorInvalidAddress;
+    }
+
+    if (
+      filter.exchangeOracle &&
+      !ethers.utils.isAddress(filter.exchangeOracle)
+    ) {
+      throw ErrorInvalidAddress;
+    }
+
+    try {
+      const escrowAddresses: EscrowData[] = [];
+      for (const chainId of filter.networks) {
+        const networkData = NETWORKS[chainId];
+
+        if (!networkData) {
+          throw ErrorUnsupportedChainID;
+        }
+
+        const { escrows } = await gqlFetch<{ escrows: EscrowData[] }>(
+          networkData.subgraphUrl,
+          GET_ESCROWS_QUERY(filter),
+          {
+            ...filter,
+            status: filter.status
+              ? 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);
+      }
+      escrowAddresses.sort((a, b) => Number(b.createdAt) - Number(a.createdAt));
+      return escrowAddresses;
+    } catch (e: any) {
+      return throwError(e);
+    }
+  }
+
+  /**
+   * Returns the escrow for a given address
+   *
+   * @param {string} escrowAddress - Escrow address.
+   * @param {ChainId} chainId - Chain id.
+   * @returns {Promise<EscrowData>}
+   * @throws {Error} - An error object if an error occurred.
+   */
+  public static async getEscrow(
+    chainId: ChainId,
+    escrowAddress: string
+  ): Promise<EscrowData> {
+    const networkData = NETWORKS[chainId];
+
+    if (!networkData) {
+      throw ErrorUnsupportedChainID;
+    }
+
+    if (escrowAddress && !ethers.utils.isAddress(escrowAddress)) {
+      throw ErrorInvalidAddress;
+    }
+
+    try {
+      const { escrow } = await gqlFetch<{ escrow: EscrowData }>(
+        networkData.subgraphUrl,
+        GET_ESCROW_BY_ADDRESS_QUERY(),
+        { escrowAddress }
+      );
+
+      return escrow || null;
+    } catch (e: any) {
+      return throwError(e);
+    }
+  }
+}

package/src/graphql/queries/escrow.ts

@@ -11,6 +11,7 @@ const ESCROW_FRAGMENT = gql`
     finalResultsUrl
     id
     intermediateResultsUrl
+    jobRequesterId
     launcher
     manifestHash
     manifestUrl
@@ -18,6 +19,8 @@ const ESCROW_FRAGMENT = gql`
     recordingOracleFee
     reputationOracle
     reputationOracleFee
+    exchangeOracle
+    exchangeOracleFee
     status
     token
     totalFundedAmount
@@ -25,15 +28,34 @@ const ESCROW_FRAGMENT = gql`
   }
 `;
 
+export const GET_ESCROW_BY_ADDRESS_QUERY = () => gql`
+  query getEscrowByAddress($escrowAddress: String!) {
+    escrow(id: $escrowAddress) {
+      ...EscrowFields
+    }
+  }
+  ${ESCROW_FRAGMENT}
+`;
+
 export const GET_ESCROWS_QUERY = (filter: IEscrowsFilter) => {
-  const { launcher, reputationOracle, recordingOracle, status, from, to } =
-    filter;
+  const {
+    launcher,
+    jobRequesterId,
+    reputationOracle,
+    recordingOracle,
+    exchangeOracle,
+    status,
+    from,
+    to,
+  } = filter;
 
   const WHERE_CLAUSE = `
     where: {
       ${launcher ? `launcher: $launcher` : ''}
+      ${jobRequesterId ? `jobRequesterId: $jobRequesterId` : ''}
       ${reputationOracle ? `reputationOracle: $reputationOracle` : ''}
       ${recordingOracle ? `recordingOracle: $recordingOracle` : ''}
+      ${exchangeOracle ? `exchangeOracle: $exchangeOracle` : ''}
       ${status ? `status: $status` : ''}
       ${from ? `createdAt_gte: $from` : ''}
       ${to ? `createdAt_lte: $to` : ''}
@@ -43,8 +65,10 @@ export const GET_ESCROWS_QUERY = (filter: IEscrowsFilter) => {
   return gql`
     query getEscrows(
       $launcher: String
+      $jobRequesterId: String
       $reputationOracle: String
       $recordingOracle: String
+      $exchangeOracle: String
       $status: String
       $from: Int
       $to: Int

package/src/graphql/queries/index.ts

@@ -2,3 +2,4 @@ export * from './escrow';
 export * from './hmtoken';
 export * from './reward';
 export * from './statistics';
+export * from './payout';

package/src/graphql/queries/payout.ts

@@ -0,0 +1,47 @@
+import gql from 'graphql-tag';
+import { IPayoutFilter } from '../../interfaces';
+
+const PAYOUT_FRAGMENT = gql`
+  fragment PayoutFields on Payout {
+    id
+    escrowAddress
+    recipient
+    amount
+    createdAt
+  }
+`;
+
+export const GET_PAYOUTS_QUERY = (filter: IPayoutFilter) => {
+  const { escrowAddress, recipient, from, to } = filter;
+
+  const WHERE_CLAUSE = `
+    where: {
+      ${escrowAddress ? `escrowAddress: $escrowAddress` : ''}
+      ${recipient ? `recipient: $recipient` : ''}
+      ${from ? `createdAt_gte: $from` : ''}
+      ${to ? `createdAt_lt: $to` : ''}
+    }
+  `;
+  const LIMIT_CLAUSE = `
+    first: 1000
+  `;
+
+  return gql`
+    query getPayouts(
+      $escrowAddress: String
+      $recipient: String
+      $from: Int
+      $to: Int
+    ) {
+      payouts(
+        ${WHERE_CLAUSE}
+        orderBy: createdAt,
+        orderDirection: desc,
+        ${LIMIT_CLAUSE}
+      ) {
+        ...PayoutFields
+      }
+    }
+    ${PAYOUT_FRAGMENT}
+  `;
+};

package/src/graphql/queries/staking.ts

@@ -0,0 +1,57 @@
+import gql from 'graphql-tag';
+import { ILeadersFilter } from 'src/interfaces';
+
+const LEADER_FRAGMENT = gql`
+  fragment LeaderFields on Leader {
+    id
+    address
+    amountStaked
+    amountAllocated
+    amountLocked
+    lockedUntilTimestamp
+    amountWithdrawn
+    amountSlashed
+    reputation
+    reward
+    amountJobsLaunched
+    role
+    fee
+    publicKey
+    webhookUrl
+    url
+  }
+`;
+
+export const GET_LEADERS_QUERY = (filter: ILeadersFilter) => {
+  const { role } = filter;
+
+  const WHERE_CLAUSE = `
+    where: {
+      ${role ? `role: $role` : ''}
+    }
+  `;
+
+  return gql`
+    query getLeaders(
+      $role: String
+    ) {
+      leaders(
+        ${WHERE_CLAUSE}
+        orderBy: amountStaked,
+        orderDirection: desc,
+      ) {
+        ...LeaderFields
+      }
+    }
+    ${LEADER_FRAGMENT}
+  `;
+};
+
+export const GET_LEADER_QUERY = gql`
+  query getLeader($address: String!) {
+    leader(id: $address) {
+      ...LeaderFields
+    }
+  }
+  ${LEADER_FRAGMENT}
+`;

package/src/graphql/queries/statistics.ts

@@ -69,17 +69,25 @@ export const GET_ESCROW_STATISTICS_QUERY = gql`
 `;
 
 export const GET_EVENT_DAY_DATA_QUERY = (params: IStatisticsParams) => {
-  const { from, to } = params;
+  const { from, to, limit } = params;
   const WHERE_CLAUSE = `
     where: {
       ${from !== undefined ? `timestamp_gte: $from` : ''}
       ${to !== undefined ? `timestamp_lte: $to` : ''}
     }
   `;
+  const LIMIT_CLAUSE = `
+    first: ${limit ? `$limit` : `1000`}
+  `;
 
   return gql`
     query GetEscrowDayData($from: Int, $to: Int) {
-      eventDayDatas(${WHERE_CLAUSE}) {
+      eventDayDatas(
+        ${WHERE_CLAUSE},
+        orderBy: timestamp,
+        orderDirection: desc,
+        ${LIMIT_CLAUSE}
+      ) {
         ...EventDayDataFields
       }
     }

package/src/graphql/types.ts

@@ -16,10 +16,21 @@ export type EscrowData = {
   recordingOracleFee?: string;
   reputationOracle?: string;
   reputationOracleFee?: string;
+  exchangeOracle?: string;
+  exchangeOracleFee?: string;
   status: string;
   token: string;
   totalFundedAmount: string;
   createdAt: string;
+  chainId: number;
+};
+
+export type PayoutData = {
+  id: string;
+  escrowAddress: string;
+  recipient: string;
+  amount: string;
+  createdAt: string;
 };
 
 export type HMTStatisticsData = {
@@ -89,7 +100,6 @@ export type EscrowStatistics = {
 export type DailyWorkerData = {
   timestamp: Date;
   activeWorkers: number;
-  averageJobsSolved: number;
 };
 
 export type WorkerStatistics = {
@@ -100,7 +110,6 @@ export type DailyPaymentData = {
   timestamp: Date;
   totalAmountPaid: BigNumber;
   totalCount: number;
-  averageAmountPerJob: BigNumber;
   averageAmountPerWorker: BigNumber;
 };
 
@@ -126,7 +135,25 @@ export type DailyHMTData = {
 
 export type HMTStatistics = {
   totalTransferAmount: BigNumber;
+  totalTransferCount: number;
   totalHolders: number;
   holders: HMTHolder[];
   dailyHMTData: DailyHMTData[];
 };
+
+export type IMDataEntity = {
+  served: number;
+  solved: number;
+};
+
+export type IMData = Record<string, IMDataEntity>;
+
+export type DailyTaskData = {
+  timestamp: Date;
+  tasksTotal: number;
+  tasksSolved: number;
+};
+
+export type TaskStatistics = {
+  dailyTasksData: DailyTaskData[];
+};