@human-protocol/sdk • Docs
@human-protocol/sdk / statistics / StatisticsClient
Class: StatisticsClient
Introduction
This client enables to obtain statistical information from the subgraph.
Unlikely from the other SDK clients, StatisticsClient
does not require signer
or provider
to be provided. We just need to create client object using relevant network data.
Copy constructor (network: NetworkData)
A Signer
or a Provider
should be passed depending on the use case of this module:
Signer : when the user wants to use this model in order to send transactions caling the contract functions.
Provider : when the user wants to use this model in order to get information from the contracts or subgraph.
Installation
npm
Copy npm install @human-protocol/sdk
yarn
Copy yarn install @human-protocol/sdk
Code example
Copy import { StatisticsClient , ChainId , NETWORKS } from '@human-protocol/sdk' ;
const statisticsClient = new StatisticsClient ( NETWORKS [ ChainId . POLYGON_AMOY ]);
Constructors
new StatisticsClient()
new StatisticsClient (networkData
): StatisticsClient
StatisticsClient constructor
Parameters
• networkData : NetworkData
The network information required to connect to the Statistics contract
Returns
StatisticsClient
Source
statistics.ts:69
Properties
networkData
networkData : NetworkData
Source
statistics.ts:61
subgraphUrl
subgraphUrl : string
Source
statistics.ts:62
Methods
getEscrowStatistics()
getEscrowStatistics (params
): Promise
<EscrowStatistics
>
This function returns the statistical data of escrows.
Input parameters
Copy interface IStatisticsParams {
from ?: Date ;
to ?: Date ;
limit ?: number ;
}
Copy type DailyEscrowsData = {
timestamp : Date ;
escrowsTotal : number ;
escrowsPending : number ;
escrowsSolved : number ;
escrowsPaid : number ;
escrowsCancelled : number ;
};
type EscrowStatistics = {
totalEscrows : number ;
dailyEscrowsData : DailyEscrowsData [];
};
Parameters
• params : IStatisticsParams
= {}
Statistics params with duration data
Returns
Promise
<EscrowStatistics
>
Escrow statistics data.
Code example
Copy import { StatisticsClient , ChainId , NETWORKS } from '@human-protocol/sdk' ;
const statisticsClient = new StatisticsClient ( NETWORKS [ ChainId . POLYGON_AMOY ]);
const escrowStatistics = await statisticsClient .getEscrowStatistics ();
const escrowStatisticsApril = await statisticsClient .getEscrowStatistics ({
from : new Date ( '2021-04-01' ) ,
to : new Date ( '2021-04-30' ) ,
});
Source
statistics.ts:123
getHMTStatistics()
getHMTStatistics (params
): Promise
<HMTStatistics
>
This function returns the statistical data of HMToken.
Input parameters
Copy interface IStatisticsParams {
from ?: Date ;
to ?: Date ;
limit ?: number ;
}
Copy type HMTHolder = {
address : string ;
balance : BigNumber ;
}
type DailyHMTData = {
timestamp : Date ;
totalTransactionAmount : BigNumber ;
totalTransactionCount : number ;
};
type HMTStatistics = {
totalTransferAmount : BigNumber ;
totalTransferCount : BigNumber ;
totalHolders : number ;
holders : HMTHolder [];
dailyHMTData : DailyHMTData [];
};
Parameters
• params : IStatisticsParams
= {}
Statistics params with duration data
Returns
Promise
<HMTStatistics
>
HMToken statistics data.
Code example
Copy import { StatisticsClient , ChainId , NETWORKS } from '@human-protocol/sdk' ;
const statisticsClient = new StatisticsClient ( NETWORKS [ ChainId . POLYGON_AMOY ]);
const hmtStatistics = await statisticsClient .getHMTStatistics ();
console .log ( 'HMT statistics:' , {
... hmtStatistics ,
totalTransferAmount : hmtStatistics . totalTransferAmount .toString () ,
holders : hmtStatistics . holders .map ((h) => ({
... h ,
balance : h . balance .toString () ,
})) ,
dailyHMTData : hmtStatistics . dailyHMTData .map ((d) => ({
... d ,
totalTransactionAmount : d . totalTransactionAmount .toString () ,
})) ,
});
const hmtStatisticsRange = await statisticsClient .getHMTStatistics ({
from : new Date ( 2023 , 4 , 8 ) ,
to : new Date ( 2023 , 5 , 8 ) ,
});
console .log ( 'HMT statistics from 5/8 - 6/8:' , {
... hmtStatisticsRange ,
totalTransferAmount : hmtStatisticsRange . totalTransferAmount .toString () ,
holders : hmtStatisticsRange . holders .map ((h) => ({
... h ,
balance : h . balance .toString () ,
})) ,
dailyHMTData : hmtStatisticsRange . dailyHMTData .map ((d) => ({
... d ,
totalTransactionAmount : d . totalTransactionAmount .toString () ,
})) ,
});
Source
statistics.ts:396
getPaymentStatistics()
getPaymentStatistics (params
): Promise
<PaymentStatistics
>
This function returns the statistical data of payments.
Input parameters
Copy interface IStatisticsParams {
from ?: Date ;
to ?: Date ;
limit ?: number ;
}
Copy type DailyPaymentData = {
timestamp : Date ;
totalAmountPaid : BigNumber ;
totalCount : number ;
averageAmountPerWorker : BigNumber ;
};
type PaymentStatistics = {
dailyPaymentsData : DailyPaymentData [];
};
Parameters
• params : IStatisticsParams
= {}
Statistics params with duration data
Returns
Promise
<PaymentStatistics
>
Payment statistics data.
Code example
Copy import { StatisticsClient , ChainId , NETWORKS } from '@human-protocol/sdk' ;
const statisticsClient = new StatisticsClient ( NETWORKS [ ChainId . POLYGON_AMOY ]);
console .log (
'Payment statistics:' ,
( await statisticsClient .getPaymentStatistics ()). dailyPaymentsData .map (
(p) => ({
... p ,
totalAmountPaid : p . totalAmountPaid .toString () ,
averageAmountPerJob : p . averageAmountPerJob .toString () ,
averageAmountPerWorker : p . averageAmountPerWorker .toString () ,
})
)
);
console .log (
'Payment statistics from 5/8 - 6/8:' ,
(
await statisticsClient .getPaymentStatistics ({
from : new Date ( 2023 , 4 , 8 ) ,
to : new Date ( 2023 , 5 , 8 ) ,
})
). dailyPaymentsData .map ((p) => ({
... p ,
totalAmountPaid : p . totalAmountPaid .toString () ,
averageAmountPerJob : p . averageAmountPerJob .toString () ,
averageAmountPerWorker : p . averageAmountPerWorker .toString () ,
}))
);
Source
statistics.ts:287
getWorkerStatistics()
getWorkerStatistics (params
): Promise
<WorkerStatistics
>
This function returns the statistical data of workers.
Input parameters
Copy interface IStatisticsParams {
from ?: Date ;
to ?: Date ;
limit ?: number ;
}
Copy type DailyWorkerData = {
timestamp : Date ;
activeWorkers : number ;
};
type WorkerStatistics = {
dailyWorkersData : DailyWorkerData [];
};
Parameters
• params : IStatisticsParams
= {}
Statistics params with duration data
Returns
Promise
<WorkerStatistics
>
Worker statistics data.
Code example
Copy import { StatisticsClient , ChainId , NETWORKS } from '@human-protocol/sdk' ;
const statisticsClient = new StatisticsClient ( NETWORKS [ ChainId . POLYGON_AMOY ]);
const workerStatistics = await statisticsClient .getWorkerStatistics ();
const workerStatisticsApril = await statisticsClient .getWorkerStatistics ({
from : new Date ( '2021-04-01' ) ,
to : new Date ( '2021-04-30' ) ,
});
Source
statistics.ts:198
Last updated 6 months ago