import { TronWeb } from '../tronweb.js'; import { NodeProvider } from '../types/TronWeb.js'; import utils from '../utils/index.js'; import { HttpProvider } from './providers/index.js'; export interface GetEventResultOptions { /** * Name of the event to filter by. */ eventName?: string; /** * Specific block number to query. */ blockNumber?: number; /** * Maximum number returned. */ limit?: number; /** * When the data volume of the query result is large, the returned result of one query will not contain all the data, and it takes multiple queries to obtain the complete data. Therefore, the fingerprint field will appear in the last piece of data in the returned result. After specifying this field as the content of the fingerprint in the result of the previous query in the next query, the query will return subsequent data. If there is no such field in the last data of the query result, it means that there is no more data. */ fingerprint?: string; /** * If set to true, only returns confirmed transactions. */ onlyConfirmed?: boolean; /** * If set to true, only returns unconfirmed transactions. */ onlyUnconfirmed?: boolean; /** * Specify the query order, whether to query forward or backward from the sinceTimestamp. * The value can be 'block_timestamp,desc' for time sequence or 'block_timestamp,asc' for the reverse. * Default is 'block_timestamp,desc'. */ orderBy?: 'block_timestamp,desc' | 'block_timestamp,asc'; /** * Specifies the starting timestamp of the query, in milliseconds, default value is the current time. */ minBlockTimestamp?: number; /** * Specifies the ending timestamp of the query, in milliseconds. */ maxBlockTimestamp?: number; } export interface EventResponse { success: boolean; error?: string; data?: { block_number: number; block_timestamp: number; caller_contract_address: string; contract_address: string; event_index: number; event_name: string; result: Record; result_type: Record; event: string; transaction_id: string; _unconfirmed: boolean; }[]; meta?: { at: number; fingerprint?: string; links?: { next: string; }; page_size: number; }; } export class Event { private tronWeb: TronWeb; constructor(tronWeb: TronWeb) { if (!tronWeb || !(tronWeb instanceof TronWeb)) throw new Error('Expected instance of TronWeb'); this.tronWeb = tronWeb; } setServer(eventServer: NodeProvider, healthcheck = 'healthcheck') { if (!eventServer) return (this.tronWeb.eventServer = undefined); if (utils.isString(eventServer)) eventServer = new HttpProvider(eventServer); if (!this.tronWeb.isValidProvider(eventServer)) throw new Error('Invalid event server provided'); this.tronWeb.eventServer = eventServer; this.tronWeb.eventServer.isConnected = () => this.tronWeb .eventServer!.request(healthcheck) .then(() => true) .catch(() => false); } async getEventsByContractAddress(contractAddress: string, options: GetEventResultOptions = {}) { const newOptions = Object.assign( { limit: 20, }, options ); const { eventName, blockNumber, onlyUnconfirmed, onlyConfirmed, minBlockTimestamp, maxBlockTimestamp, orderBy, fingerprint, } = newOptions; let { limit } = newOptions; if (!this.tronWeb.eventServer) { throw new Error('No event server configured'); } if (!this.tronWeb.isAddress(contractAddress)) { throw new Error('Invalid contract address provided'); } if (typeof minBlockTimestamp !== 'undefined' && !utils.isInteger(minBlockTimestamp)) { throw new Error('Invalid minBlockTimestamp provided'); } if (typeof maxBlockTimestamp !== 'undefined' && !utils.isInteger(maxBlockTimestamp)) { throw new Error('Invalid maxBlockTimestamp provided'); } if (utils.isInteger(limit) && limit > 200) { console.warn('Defaulting to maximum accepted limit: 200'); limit = 200; } const qs = {} as any; if (eventName) qs.event_name = eventName; if (blockNumber) qs.block_number = blockNumber; if (typeof onlyUnconfirmed === 'boolean') qs.only_unconfirmed = onlyUnconfirmed; if (typeof onlyConfirmed === 'boolean') qs.only_confirmed = onlyConfirmed; if (minBlockTimestamp) qs.min_block_timestamp = minBlockTimestamp; if (maxBlockTimestamp) qs.max_block_timestamp = maxBlockTimestamp; if (orderBy) qs.order_by = orderBy; if (fingerprint) qs.fingerprint = fingerprint; if (utils.isInteger(limit)) qs.limit = limit; const res = await this.tronWeb.eventServer.request( `v1/contracts/${this.tronWeb.address.fromHex(contractAddress)}/events?${new URLSearchParams(qs).toString()}` ); if (res.success) { return res; } throw new Error(res.error); } async getEventsByTransactionID( transactionID: string, options: { only_unconfirmed?: boolean; only_confirmed?: boolean; } = {} ) { if (!this.tronWeb.eventServer) { throw new Error('No event server configured'); } const qs = {} as any; if (typeof options.only_unconfirmed === 'boolean') { qs.only_unconfirmed = options.only_unconfirmed; } if (typeof options.only_confirmed === 'boolean') { qs.only_confirmed = options.only_confirmed; } return this.tronWeb.eventServer .request(`v1/transactions/${transactionID}/events?${new URLSearchParams(qs).toString()}`) .then((res) => { if (res.success) { return res; } throw new Error(JSON.parse(res.error!).message); }); } async getEventsByBlockNumber( blockNumber: number | string, options: { only_confirmed?: boolean; limit?: number; fingerprint?: string; } = {} ) { if (!this.tronWeb.eventServer) { throw new Error('No event server configured'); } const qs = {} as any; if (typeof options.only_confirmed === 'boolean') { qs.only_confirmed = options.only_confirmed; } if (options.limit) { qs.limit = options.limit; } if (options.fingerprint) { qs.fingerprint = options.fingerprint; } return this.tronWeb.eventServer .request(`v1/blocks/${blockNumber}/events?${new URLSearchParams(qs).toString()}`) .then((res) => { if (res.success) { return res; } throw new Error(res.error); }); } async getEventsOfLatestBlock( options: { only_confirmed?: boolean; } = {} ) { if (!this.tronWeb.eventServer) { throw new Error('No event server configured'); } const qs = {} as any; if (typeof options.only_confirmed === 'boolean') { qs.only_confirmed = options.only_confirmed; } return this.tronWeb.eventServer .request(`v1/blocks/latest/events?${new URLSearchParams(qs).toString()}`) .then((res) => { if (res.success) { return res; } throw new Error(res.error); }); } }