aboutsummaryrefslogtreecommitdiffstats
path: root/src/order_watcher/event_watcher.ts
blob: c9e72281cac055d30b84d732f76ed43296dc8d93 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
import * as Web3 from 'web3';
import * as _ from 'lodash';
import {Web3Wrapper} from '../web3_wrapper';
import {
    BlockParamLiteral,
    EventCallback,
    EventWatcherCallback,
    ZeroExError,
} from '../types';
import {AbiDecoder} from '../utils/abi_decoder';
import {intervalUtils} from '../utils/interval_utils';
import {assert} from '../utils/assert';
import {utils} from '../utils/utils';

const DEFAULT_EVENT_POLLING_INTERVAL = 200;

enum LogEventState {
    Removed,
    Added,
}

/*
 * The EventWatcher watches for blockchain events at the specified block confirmation
 * depth.
 */
export class EventWatcher {
    private _web3Wrapper: Web3Wrapper;
    private _pollingIntervalMs: number;
    private _intervalIdIfExists?: NodeJS.Timer;
    private _lastEvents: Web3.LogEntry[] = [];
    private _numConfirmations: number;
    constructor(web3Wrapper: Web3Wrapper, pollingIntervalMs: undefined|number, numConfirmations: number) {
        this._web3Wrapper = web3Wrapper;
        this._numConfirmations = numConfirmations;
        this._pollingIntervalMs = _.isUndefined(pollingIntervalMs) ?
                                    DEFAULT_EVENT_POLLING_INTERVAL :
                                    pollingIntervalMs;
    }
    public subscribe(callback: EventWatcherCallback): void {
        assert.isFunction('callback', callback);
        if (!_.isUndefined(this._intervalIdIfExists)) {
            throw new Error(ZeroExError.SubscriptionAlreadyPresent);
        }
        this._intervalIdIfExists = intervalUtils.setAsyncExcludingInterval(
            this._pollForBlockchainEventsAsync.bind(this, callback), this._pollingIntervalMs,
        );
    }
    public unsubscribe(): void {
        this._lastEvents = [];
        if (!_.isUndefined(this._intervalIdIfExists)) {
            intervalUtils.clearAsyncExcludingInterval(this._intervalIdIfExists);
            delete this._intervalIdIfExists;
        }
    }
    private async _pollForBlockchainEventsAsync(callback: EventWatcherCallback): Promise<void> {
        const pendingEvents = await this._getEventsAsync();
        if (pendingEvents.length === 0) {
            // HACK: Sometimes when node rebuilds the pending block we get back the empty result.
            // We don't want to emit a lot of removal events and bring them back after a couple of miliseconds,
            // that's why we just ignore those cases.
            return;
        }
        const removedEvents = _.differenceBy(this._lastEvents, pendingEvents, JSON.stringify);
        const newEvents = _.differenceBy(pendingEvents, this._lastEvents, JSON.stringify);
        await this._emitDifferencesAsync(removedEvents, LogEventState.Removed, callback);
        await this._emitDifferencesAsync(newEvents, LogEventState.Added, callback);
        this._lastEvents = pendingEvents;
    }
    private async _getEventsAsync(): Promise<Web3.LogEntry[]> {
        let latestBlock: BlockParamLiteral|number;
        if (this._numConfirmations === 0) {
            latestBlock = BlockParamLiteral.Pending;
        } else {
            const currentBlock = await this._web3Wrapper.getBlockNumberAsync();
            latestBlock = currentBlock - this._numConfirmations;
        }
        const eventFilter = {
            fromBlock: latestBlock,
            toBlock: latestBlock,
        };
        const events = await this._web3Wrapper.getLogsAsync(eventFilter);
        return events;
    }
    private async _emitDifferencesAsync(
        logs: Web3.LogEntry[], logEventState: LogEventState, callback: EventWatcherCallback,
    ): Promise<void> {
        for (const log of logs) {
            const logEvent = {
                removed: logEventState === LogEventState.Removed,
                ...log,
            };
            if (!_.isUndefined(this._intervalIdIfExists)) {
                await callback(logEvent);
            }
        }
    }
}