@atomiqlabs/chain-evm 1.0.0-dev.50 → 1.0.0-dev.52

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,354 +0,0 @@
1
- import {
2
- ChainEvent,
3
- ChainEvents,
4
- ChainSwapType,
5
- ClaimEvent,
6
- EventListener,
7
- InitializeEvent,
8
- RefundEvent, SpvVaultClaimEvent, SpvVaultCloseEvent, SpvVaultDepositEvent, SpvVaultFrontEvent, SpvVaultOpenEvent
9
- } from "@atomiqlabs/base";
10
- import {IClaimHandler} from "../swaps/handlers/claim/ClaimHandlers";
11
- import {EVMSwapData} from "../swaps/EVMSwapData";
12
- import {Block, EventFilter, hexlify, Log, WebSocketProvider} from "ethers";
13
- import { EVMSwapContract } from "../swaps/EVMSwapContract";
14
- import {getLogger, onceAsync} from "../../utils/Utils";
15
- import {EVMSpvVaultContract, unpackOwnerAndVaultId} from "../spv_swap/EVMSpvVaultContract";
16
- import { EVMChainInterface } from "../chain/EVMChainInterface";
17
- import {TypedEventLog} from "../typechain/common";
18
- import {EscrowManager} from "../swaps/EscrowManagerTypechain";
19
- import {SpvVaultManager} from "../spv_swap/SpvVaultContractTypechain";
20
- import {EVMTxTrace} from "../chain/modules/EVMTransactions";
21
-
22
- type AtomiqTypedEvent = (
23
- TypedEventLog<EscrowManager["filters"]["Initialize" | "Refund" | "Claim"]> |
24
- TypedEventLog<SpvVaultManager["filters"]["Opened" | "Deposited" | "Fronted" | "Claimed" | "Closed"]>
25
- );
26
-
27
- /**
28
- * EVM on-chain event handler for front-end systems without access to fs, uses WS or long-polling to subscribe, might lose
29
- * out on some events if the network is unreliable, front-end systems should take this into consideration and not
30
- * rely purely on events
31
- */
32
- export class EVMChainEventsBrowserWS implements ChainEvents<EVMSwapData> {
33
-
34
- protected readonly listeners: EventListener<EVMSwapData>[] = [];
35
- protected readonly provider: WebSocketProvider;
36
- protected readonly chainInterface: EVMChainInterface;
37
- protected readonly evmSwapContract: EVMSwapContract;
38
- protected readonly evmSpvVaultContract: EVMSpvVaultContract<any>;
39
- protected readonly logger = getLogger("EVMChainEventsBrowser: ");
40
-
41
- protected readonly spvVaultContractLogFilter: EventFilter;
42
- protected readonly swapContractLogFilter: EventFilter;
43
-
44
- protected unconfirmedEventQueue: AtomiqTypedEvent[] = [];
45
-
46
- protected stopped: boolean;
47
-
48
- constructor(
49
- chainInterface: EVMChainInterface,
50
- evmSwapContract: EVMSwapContract,
51
- evmSpvVaultContract: EVMSpvVaultContract<any>
52
- ) {
53
- this.chainInterface = chainInterface;
54
- this.provider = chainInterface.provider as WebSocketProvider;
55
- this.evmSwapContract = evmSwapContract;
56
- this.evmSpvVaultContract = evmSpvVaultContract;
57
-
58
- this.spvVaultContractLogFilter = {
59
- address: this.evmSpvVaultContract.contractAddress
60
- };
61
- this.swapContractLogFilter = {
62
- address: this.evmSwapContract.contractAddress
63
- };
64
- }
65
-
66
- findInitSwapData(call: EVMTxTrace, escrowHash: string, claimHandler: IClaimHandler<any, any>): EVMSwapData {
67
- if(call.to.toLowerCase() === this.evmSwapContract.contractAddress.toLowerCase()) {
68
- const result = this.evmSwapContract.parseCalldata<typeof this.evmSwapContract.contract.initialize>(call.input);
69
- if(result!=null && result.name==="initialize") {
70
- //Found, check correct escrow hash
71
- const [escrowData, signature, timeout, extraData] = result.args;
72
- const escrow = EVMSwapData.deserializeFromStruct(escrowData, claimHandler);
73
- if("0x"+escrow.getEscrowHash()===escrowHash) {
74
- const extraDataHex = hexlify(extraData);
75
- if(extraDataHex.length>2) {
76
- escrow.setExtraData(extraDataHex.substring(2));
77
- }
78
- return escrow;
79
- }
80
- }
81
- }
82
- for(let _call of call.calls) {
83
- const found = this.findInitSwapData(_call, escrowHash, claimHandler);
84
- if(found!=null) return found;
85
- }
86
- return null;
87
- }
88
-
89
- /**
90
- * Returns async getter for fetching on-demand initialize event swap data
91
- *
92
- * @param event
93
- * @param claimHandler
94
- * @private
95
- * @returns {() => Promise<EVMSwapData>} getter to be passed to InitializeEvent constructor
96
- */
97
- private getSwapDataGetter(
98
- event: TypedEventLog<EscrowManager["filters"]["Initialize"]>,
99
- claimHandler: IClaimHandler<any, any>
100
- ): () => Promise<EVMSwapData> {
101
- return async () => {
102
- const trace = await this.chainInterface.Transactions.traceTransaction(event.transactionHash);
103
- if(trace==null) return null;
104
- return this.findInitSwapData(trace, event.args.escrowHash, claimHandler);
105
- }
106
- }
107
-
108
- protected parseInitializeEvent(
109
- event: TypedEventLog<EscrowManager["filters"]["Initialize"]>
110
- ): InitializeEvent<EVMSwapData> {
111
- const escrowHash = event.args.escrowHash.substring(2);
112
- const claimHandlerHex = event.args.claimHandler;
113
- const claimHandler = this.evmSwapContract.claimHandlersByAddress[claimHandlerHex.toLowerCase()];
114
- if(claimHandler==null) {
115
- this.logger.warn("parseInitializeEvent("+escrowHash+"): Unknown claim handler with claim: "+claimHandlerHex);
116
- return null;
117
- }
118
- const swapType: ChainSwapType = claimHandler.getType();
119
-
120
- this.logger.debug("InitializeEvent escrowHash: "+escrowHash);
121
- return new InitializeEvent<EVMSwapData>(
122
- escrowHash,
123
- swapType,
124
- onceAsync<EVMSwapData>(this.getSwapDataGetter(event, claimHandler))
125
- );
126
- }
127
-
128
- protected parseRefundEvent(
129
- event: TypedEventLog<EscrowManager["filters"]["Refund"]>
130
- ): RefundEvent<EVMSwapData> {
131
- const escrowHash = event.args.escrowHash.substring(2);
132
- this.logger.debug("RefundEvent escrowHash: "+escrowHash);
133
- return new RefundEvent<EVMSwapData>(escrowHash);
134
- }
135
-
136
- protected parseClaimEvent(
137
- event: TypedEventLog<EscrowManager["filters"]["Claim"]>
138
- ): ClaimEvent<EVMSwapData> {
139
- const escrowHash = event.args.escrowHash.substring(2);
140
- const claimHandlerHex = event.args.claimHandler;
141
- const claimHandler = this.evmSwapContract.claimHandlersByAddress[claimHandlerHex.toLowerCase()];
142
- if(claimHandler==null) {
143
- this.logger.warn("parseClaimEvent("+escrowHash+"): Unknown claim handler with claim: "+claimHandlerHex);
144
- return null;
145
- }
146
- const witnessResult = event.args.witnessResult.substring(2);
147
- this.logger.debug("ClaimEvent witnessResult: "+witnessResult+" escrowHash: "+escrowHash);
148
- return new ClaimEvent<EVMSwapData>(escrowHash, witnessResult);
149
- }
150
-
151
- protected parseSpvOpenEvent(
152
- event: TypedEventLog<SpvVaultManager["filters"]["Opened"]>
153
- ): SpvVaultOpenEvent {
154
- const owner = event.args.owner;
155
- const vaultId = event.args.vaultId;
156
- const btcTxId = Buffer.from(event.args.btcTxHash.substring(2), "hex").reverse().toString("hex");
157
- const vout = Number(event.args.vout);
158
-
159
- this.logger.debug("SpvOpenEvent owner: "+owner+" vaultId: "+vaultId+" utxo: "+btcTxId+":"+vout);
160
- return new SpvVaultOpenEvent(owner, vaultId, btcTxId, vout);
161
- }
162
-
163
- protected parseSpvDepositEvent(
164
- event: TypedEventLog<SpvVaultManager["filters"]["Deposited"]>
165
- ): SpvVaultDepositEvent {
166
- const [owner, vaultId] = unpackOwnerAndVaultId(event.args.ownerAndVaultId);
167
- const amounts = [event.args.amount0, event.args.amount1];
168
- const depositCount = Number(event.args.depositCount);
169
-
170
- this.logger.debug("SpvDepositEvent owner: "+owner+" vaultId: "+vaultId+" depositCount: "+depositCount+" amounts: ", amounts);
171
- return new SpvVaultDepositEvent(owner, vaultId, amounts, depositCount);
172
- }
173
-
174
- protected parseSpvFrontEvent(
175
- event: TypedEventLog<SpvVaultManager["filters"]["Fronted"]>
176
- ): SpvVaultFrontEvent {
177
- const [owner, vaultId] = unpackOwnerAndVaultId(event.args.ownerAndVaultId);
178
- const btcTxId = Buffer.from(event.args.btcTxHash.substring(2), "hex").reverse().toString("hex");
179
- const recipient = event.args.recipient;
180
- const executionHash = event.args.executionHash;
181
- const amounts = [event.args.amount0, event.args.amount1];
182
- const frontingAddress = event.args.caller;
183
-
184
- this.logger.debug("SpvFrontEvent owner: "+owner+" vaultId: "+vaultId+" btcTxId: "+btcTxId+
185
- " recipient: "+recipient+" frontedBy: "+frontingAddress+" amounts: ", amounts);
186
- return new SpvVaultFrontEvent(owner, vaultId, btcTxId, recipient, executionHash, amounts, frontingAddress);
187
- }
188
-
189
- protected parseSpvClaimEvent(
190
- event: TypedEventLog<SpvVaultManager["filters"]["Claimed"]>
191
- ): SpvVaultClaimEvent {
192
- const [owner, vaultId] = unpackOwnerAndVaultId(event.args.ownerAndVaultId);
193
- const btcTxId = Buffer.from(event.args.btcTxHash.substring(2), "hex").reverse().toString("hex");
194
- const recipient = event.args.recipient;
195
- const executionHash = event.args.executionHash;
196
- const amounts = [event.args.amount0, event.args.amount1];
197
- const caller = event.args.caller;
198
- const frontingAddress = event.args.frontingAddress;
199
- const withdrawCount = Number(event.args.withdrawCount);
200
-
201
- this.logger.debug("SpvClaimEvent owner: "+owner+" vaultId: "+vaultId+" btcTxId: "+btcTxId+" withdrawCount: "+withdrawCount+
202
- " recipient: "+recipient+" frontedBy: "+frontingAddress+" claimedBy: "+caller+" amounts: ", amounts);
203
-
204
- return new SpvVaultClaimEvent(owner, vaultId, btcTxId, recipient, executionHash, amounts, caller, frontingAddress, withdrawCount);
205
- }
206
-
207
- protected parseSpvCloseEvent(
208
- event: TypedEventLog<SpvVaultManager["filters"]["Closed"]>
209
- ): SpvVaultCloseEvent {
210
- const btcTxId = Buffer.from(event.args.btcTxHash.substring(2), "hex").reverse().toString("hex");
211
-
212
- return new SpvVaultCloseEvent(event.args.owner, event.args.vaultId, btcTxId, event.args.error);
213
- }
214
-
215
- /**
216
- * Processes event as received from the chain, parses it & calls event listeners
217
- *
218
- * @param events
219
- * @param currentBlock
220
- * @protected
221
- */
222
- protected async processEvents(
223
- events: AtomiqTypedEvent[],
224
- currentBlock?: Block
225
- ) {
226
- const parsedEvents: ChainEvent<EVMSwapData>[] = [];
227
-
228
- for(let event of events) {
229
- let parsedEvent: ChainEvent<EVMSwapData>;
230
- switch(event.eventName) {
231
- case "Claim":
232
- parsedEvent = this.parseClaimEvent(event as any);
233
- break;
234
- case "Refund":
235
- parsedEvent = this.parseRefundEvent(event as any);
236
- break;
237
- case "Initialize":
238
- parsedEvent = this.parseInitializeEvent(event as any);
239
- break;
240
- case "Opened":
241
- parsedEvent = this.parseSpvOpenEvent(event as any);
242
- break;
243
- case "Deposited":
244
- parsedEvent = this.parseSpvDepositEvent(event as any);
245
- break;
246
- case "Fronted":
247
- parsedEvent = this.parseSpvFrontEvent(event as any);
248
- break;
249
- case "Claimed":
250
- parsedEvent = this.parseSpvClaimEvent(event as any);
251
- break;
252
- case "Closed":
253
- parsedEvent = this.parseSpvCloseEvent(event as any);
254
- break;
255
- }
256
- const timestamp = event.blockNumber===currentBlock?.number ? currentBlock.timestamp : await this.chainInterface.Blocks.getBlockTime(event.blockNumber);
257
- parsedEvent.meta = {
258
- blockTime: timestamp,
259
- txId: event.transactionHash,
260
- timestamp //Maybe deprecated
261
- } as any;
262
- parsedEvents.push(parsedEvent);
263
- }
264
-
265
- for(let listener of this.listeners) {
266
- await listener(parsedEvents);
267
- }
268
- }
269
-
270
- protected handleEvents(
271
- events : AtomiqTypedEvent[]
272
- ): Promise<void> {
273
- if(this.chainInterface.config.safeBlockTag==="latest" || this.chainInterface.config.safeBlockTag==="pending") {
274
- return this.processEvents(events);
275
- }
276
- this.unconfirmedEventQueue.push(...events);
277
- }
278
-
279
- protected spvVaultContractListener: (log: Log) => void;
280
- protected swapContractListener: (log: Log) => void;
281
- protected blockListener: (blockNumber: number) => Promise<void>;
282
-
283
- protected async setupWebsocket() {
284
- await this.provider.on(this.spvVaultContractLogFilter, this.spvVaultContractListener = (log) => {
285
- let events = this.evmSpvVaultContract.Events.toTypedEvents([log]);
286
- events = events.filter(val => !val.removed);
287
- this.handleEvents(events);
288
- });
289
-
290
- await this.provider.on(this.swapContractLogFilter, this.swapContractListener = (log) => {
291
- let events = this.evmSwapContract.Events.toTypedEvents([log]);
292
- events = events.filter(val => !val.removed && (val.eventName==="Initialize" || val.eventName==="Refund" || val.eventName==="Claim"));
293
- this.handleEvents(events);
294
- });
295
-
296
- const safeBlockTag = this.chainInterface.config.safeBlockTag;
297
- let processing = false;
298
- if(safeBlockTag!=="latest" && safeBlockTag!=="pending") await this.provider.on("block", this.blockListener = async (blockNumber: number) => {
299
- if(processing) return;
300
- processing = true;
301
- try {
302
- const latestSafeBlock = await this.provider.getBlock(this.chainInterface.config.safeBlockTag);
303
-
304
- const events = [];
305
- this.unconfirmedEventQueue = this.unconfirmedEventQueue.filter(event => {
306
- if(event.blockNumber <= latestSafeBlock.number) {
307
- events.push(event);
308
- return false;
309
- }
310
- return true;
311
- });
312
-
313
- const blocks: {[blockNumber: number]: Block} = {};
314
- for(let event of events) {
315
- const block = blocks[event.blockNumber] ?? (blocks[event.blockNumber] = await this.provider.getBlock(event.blockNumber));
316
- if(block.hash===event.blockHash) {
317
- //Valid event
318
- await this.processEvents([event], block);
319
- } else {
320
- //Block hash doesn't match
321
- }
322
- }
323
- } catch (e) {
324
- this.logger.error(`on('block'): Error when processing new block ${blockNumber}:`, e);
325
- }
326
- processing = false;
327
- });
328
- }
329
-
330
- async init(): Promise<void> {
331
- await this.setupWebsocket();
332
- this.stopped = false;
333
- }
334
-
335
- async stop(): Promise<void> {
336
- this.stopped = true;
337
- await this.provider.off(this.spvVaultContractLogFilter, this.spvVaultContractListener);
338
- await this.provider.off(this.swapContractLogFilter, this.swapContractListener);
339
- await this.provider.off("block", this.blockListener);
340
- }
341
-
342
- registerListener(cbk: EventListener<EVMSwapData>): void {
343
- this.listeners.push(cbk);
344
- }
345
-
346
- unregisterListener(cbk: EventListener<EVMSwapData>): boolean {
347
- const index = this.listeners.indexOf(cbk);
348
- if(index>=0) {
349
- this.listeners.splice(index, 1);
350
- return true;
351
- }
352
- return false;
353
- }
354
- }