TransactionUtils

@human-protocol/sdk

---

@human-protocol/sdk / transaction / TransactionUtils

Class: TransactionUtils

Defined in: transaction.ts:23

Constructors

Constructor

new TransactionUtils(): TransactionUtils

Returns

TransactionUtils

Methods

getTransaction()

static getTransaction(chainId, hash, options?): Promise<ITransaction | null>

Defined in: transaction.ts:68

This function returns the transaction data for the given hash.

type ITransaction = {
  block: bigint;
  txHash: string;
  from: string;
  to: string;
  timestamp: bigint;
  value: bigint;
  method: string;
  receiver?: string;
  escrow?: string;
  token?: string;
  internalTransactions: InternalTransaction[];
};

type InternalTransaction = {
 from: string;
 to: string;
 value: bigint;
 method: string;
 receiver?: string;
 escrow?: string;
 token?: string;
};

Parameters

chainId

ChainId

The chain ID.

hash

string

The transaction hash.

options?

SubgraphOptions

Optional configuration for subgraph requests.

Returns

Promise<ITransaction | null>

• Returns the transaction details or null if not found.

Code example

import { TransactionUtils, ChainId } from '@human-protocol/sdk';

const transaction = await TransactionUtils.getTransaction(ChainId.POLYGON, '0x62dD51230A30401C455c8398d06F85e4EaB6309f');

---

getTransactions()

static getTransactions(filter, options?): Promise<ITransaction[]>

Defined in: transaction.ts:170

This function returns all transaction details based on the provided filter.

This uses Subgraph

Input parameters

interface ITransactionsFilter {
  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.
  method?: string; // (Optional) The method of the transaction to filter by.
  escrow?: string; // (Optional) The escrow address to filter transactions.
  token?: string; // (Optional) The token address to filter transactions.
  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.
}

```ts
type InternalTransaction = {
 from: string;
 to: string;
 value: bigint;
 method: string;
 receiver?: string;
 escrow?: string;
 token?: string;
};

type ITransaction = {
  block: bigint;
  txHash: string;
  from: string;
  to: string;
  timestamp: bigint;
  value: bigint;
  method: string;
  receiver?: string;
  escrow?: string;
  token?: string;
  internalTransactions: InternalTransaction[];
};

@param {ITransactionsFilter} filter Filter for the transactions. @param {SubgraphOptions} options Optional configuration for subgraph requests. @returns {Promise<ITransaction[]>} Returns an array with all the transaction details.

Code example

import { TransactionUtils, ChainId, OrderDirection } from '@human-protocol/sdk';

const filter: ITransactionsFilter = {
  chainId: ChainId.POLYGON,
  startDate: new Date('2022-01-01'),
  endDate: new Date('2022-12-31'),
  first: 10,
  skip: 0,
  orderDirection: OrderDirection.DESC,
};
const transactions = await TransactionUtils.getTransactions(filter);

Parameters

filter

ITransactionsFilter

options?

SubgraphOptions

Returns

Promise<ITransaction[]>