@my-packages-changeit/evm-address-tx-extractor 3.0.2

package/CHANGELOG.md

@@ -0,0 +1,311 @@
+# @rosen-bridge/evm-address-tx-extractor
+
+## 3.0.2
+
+### Patch Changes
+
+- Update dependencies
+  - @rosen-bridge/abstract-extractor@3.2.3
+  - @rosen-bridge/abstract-scanner@2.0.3
+
+## 3.0.1
+
+### Patch Changes
+
+- Update dependencies
+  - @rosen-bridge/abstract-extractor@3.2.2
+  - @rosen-bridge/abstract-scanner@2.0.2
+
+## 3.0.0
+
+### Major Changes
+
+- **Add Nonce-Based Range Validation**: Added the `hasEventInHeightRange` method to `EvmTxExtractor` to determine if an address may have transactions within a specified block range by comparing stored nonce values with network nonce data.
+  - Added `checkNonceAtToHeight` option to the constructor, allowing the extractor to fetch nonce at the specified `toHeight` before falling back to the latest nonce (useful for archive nodes).
+  - Added RPC URL and optional auth token to the constructor so the extractor can directly fetch nonce data from the network via ethers `JsonRpcProvider`.
+
+### Patch Changes
+
+- Add dependency
+  - @rosen-bridge/abstract-scanner@2.0.1
+- Update dependencies
+  - @rosen-bridge/abstract-extractor@3.2.1
+
+## 2.0.5
+
+### Patch Changes
+
+- Update dependencies
+  - @rosen-bridge/abstract-extractor@3.2.0
+  - @rosen-bridge/scanner-interfaces@1.0.0
+
+## 2.0.4
+
+### Patch Changes
+
+- Update dependencies
+  - @rosen-bridge/abstract-extractor@3.1.2
+  - @rosen-bridge/extended-typeorm@1.1.0
+
+## 2.0.3
+
+### Patch Changes
+
+- Update dependencies
+  - @rosen-bridge/abstract-extractor@3.1.1
+
+## 2.0.2
+
+### Patch Changes
+
+- Fix typo in logs descriptions
+- Update dependencies
+  - @rosen-bridge/abstract-extractor@3.1.0
+
+## 2.0.1
+
+### Patch Changes
+
+- Update dependencies
+  - @rosen-bridge/abstract-extractor@3.0.1
+  - @rosen-bridge/scanner-interfaces@0.2.2
+  - ethers@6.16.0
+
+## 2.0.0
+
+### Major Changes
+
+- Update AbstractExtractor interface; use `BlockInfo` in `processTransactions` and rename `initializeBoxes` to `initializeData`
+
+### Minor Changes
+
+- Update AbstractExtractor interface; add `createUsedBlocksQuery` method that returns the query for used blocks
+
+### Patch Changes
+
+- Update dependencies
+  - @rosen-bridge/abstract-logger@4.0.0
+  - @rosen-bridge/abstract-extractor@3.0.0
+
+## 1.2.3
+
+### Patch Changes
+
+- Update Dependencies
+  - @rosen-bridge/rosen-extractor@11.0.0
+
+## 1.2.2
+
+### Patch Changes
+
+- Fix package-lock and move typescript and types/node into root
+- Update eslint and plugins:
+  - Apply new rules such as sort imports and file name
+- Update dependencies
+  - @rosen-bridge/extended-typeorm@1.0.1
+  - @rosen-clients/rate-limited-axios@1.1.0
+  - @rosen-bridge/rosen-extractor@10.1.1
+  - @rosen-bridge/tokens@4.0.1
+  - @rosen-bridge/abstract-logger@3.0.1
+  - @rosen-bridge/json-bigint@1.1.0
+  - @rosen-clients/ergo-explorer@2.1.0
+  - @rosen-clients/ergo-node@3.1.0
+  - @rosen-bridge/abstract-extractor@2.1.2
+  - @rosen-bridge/scanner-interfaces@0.2.1
+
+## 1.2.1
+
+### Patch Changes
+
+- Update dependencies
+  - @rosen-bridge/abstract-extractor@2.1.1
+  - @rosen-bridge/extended-typeorm@1.0.0
+  - @rosen-bridge/abstract-logger@3.0.0
+
+## 1.2.0
+
+### Minor Changes
+
+- Upgrade to Node.js version 22.18.0
+
+### Patch Changes
+
+- Update dependencies
+  - @rosen-bridge/abstract-extractor@2.1.0
+  - @rosen-bridge/scanner-interfaces@0.2.0
+
+## 1.1.4
+
+### Patch Changes
+
+- Update package license to MIT
+- Update dependencies
+  - @rosen-bridge/abstract-extractor@2.0.3
+  - @rosen-bridge/scanner-interfaces@0.1.1
+
+## 1.1.3
+
+### Patch Changes
+
+- Downgrade ethers version
+
+## 1.1.2
+
+### Patch Changes
+
+- Update network clients and ethers and rateLimitedAxios packages
+- Update dependencies
+  - @rosen-bridge/abstract-extractor@2.0.2
+
+## 1.1.1
+
+### Patch Changes
+
+- Updated dependencies
+  - @rosen-bridge/abstract-extractor@2.0.1
+
+## 1.1.0
+
+### Minor Changes
+
+- Unify and move shared interfaces and update all package dependencies
+
+### Patch Changes
+
+- Updated dependencies
+  - @rosen-bridge/abstract-extractor@2.0.0
+
+## 1.0.8
+
+### Patch Changes
+
+- Improve extraction speed by applying the checks on response and transform only the desired transactions
+- Updated dependencies
+  - @rosen-bridge/abstract-extractor@1.0.2
+
+## 1.0.7
+
+### Patch Changes
+
+- Update node version to 20
+- Update logger package
+- Updated dependencies
+  - @rosen-bridge/abstract-extractor@1.0.1
+  - @rosen-bridge/scanner@5.0.2
+
+## 1.0.6
+
+### Patch Changes
+
+- Prevent redundant store function calls
+- Updated dependencies
+  - @rosen-bridge/abstract-extractor@1.0.0
+  - @rosen-bridge/scanner@5.0.1
+
+## 1.0.5
+
+### Patch Changes
+
+- Updated dependencies
+  - @rosen-bridge/scanner@5.0.0
+  - @rosen-bridge/abstract-extractor@0.3.1
+
+## 1.0.4
+
+### Patch Changes
+
+- Updated dependencies
+  - @rosen-bridge/scanner@4.1.3
+
+## 1.0.3
+
+### Patch Changes
+
+- fix address comparision (uses lower case address while comparing)
+- change log levels to debug
+- Updated dependencies
+  - @rosen-bridge/abstract-extractor@0.3.0
+  - @rosen-bridge/scanner@4.1.2
+
+## 1.0.2
+
+### Patch Changes
+
+- Updated dependencies
+  - @rosen-bridge/scanner@4.1.1
+
+## 1.0.1
+
+### Patch Changes
+
+- Updated dependencies
+  - @rosen-bridge/abstract-extractor@0.2.0
+  - @rosen-bridge/scanner@4.1.0
+
+## 1.0.0
+
+### Major Changes
+
+- change transaction type to TransactionResponse
+- add status to AddressTxsEntity which represents if the transaction succeeded or failed
+
+## 0.1.8
+
+### Patch Changes
+
+- Updated dependencies
+  - @rosen-bridge/abstract-extractor@0.1.5
+  - @rosen-bridge/scanner@4.0.5
+
+## 0.1.7
+
+### Patch Changes
+
+- Updated dependencies
+  - @rosen-bridge/abstract-extractor@0.1.4
+  - @rosen-bridge/scanner@4.0.4
+
+## 0.1.6
+
+### Patch Changes
+
+- Updated dependencies
+  - @rosen-bridge/abstract-extractor@0.1.3
+  - @rosen-bridge/scanner@4.0.3
+
+## 0.1.5
+
+### Patch Changes
+
+- Updated dependencies
+  - @rosen-bridge/abstract-extractor@0.1.2
+  - @rosen-bridge/scanner@4.0.2
+
+## 0.1.4
+
+### Patch Changes
+
+- Updated dependencies
+  - @rosen-bridge/abstract-extractor@0.1.1
+  - @rosen-bridge/scanner@4.0.1
+
+## 0.1.3
+
+### Patch Changes
+
+- Updated dependencies
+  - @rosen-bridge/scanner@4.0.0
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies
+  - @rosen-bridge/scanner@3.2.9
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies
+  - @rosen-bridge/scanner@3.2.8

package/README.md

@@ -0,0 +1,24 @@
+# @rosen-bridge/evm-address-tx-extractor
+
+## Table of contents
+
+- [Introduction](#introduction)
+- [Installation](#installation)
+
+## Introduction
+
+Extract and store EVM chain notable data of transactions for an address
+
+## Installation
+
+npm:
+
+```sh
+npm i @rosen-bridge/evm-address-tx-extractor
+```
+
+yarn:
+
+```sh
+yarn add @rosen-bridge/evm-address-tx-extractor
+```

package/dist/actions/db.d.ts

@@ -0,0 +1,43 @@
+import { AbstractLogger } from '@rosen-bridge/abstract-logger';
+import { DataSource, SelectQueryBuilder } from '@rosen-bridge/extended-typeorm';
+import { BlockInfo } from '@rosen-bridge/scanner-interfaces';
+import { AddressTxsEntity } from '../entities/addressTxsEntity';
+import { ExtractedTx } from '../interfaces/types';
+export declare class TxAction {
+    private readonly repository;
+    readonly logger: AbstractLogger;
+    constructor(dataSource: DataSource, logger?: AbstractLogger);
+    /**
+     * remove all inserted transaction for specific block in specific extractor from database
+     * @param blockId selected block id
+     * @param extractor selected extractor
+     */
+    deleteBlockTxs: (blockId: string, extractor: string) => Promise<void>;
+    /**
+     * remove old list of transactions and
+     * store a new list of transactions database for specific block and extractor
+     * @param txs
+     * @param block
+     * @param extractor
+     */
+    storeTxs: (txs: Array<ExtractedTx>, block: BlockInfo, extractor: string) => Promise<void>;
+    /**
+     * Builds a query that returns used blocks by selecting the `block` column from the `evmAddressTxEntity` repository,
+     * filtered by the provided `extractorId`
+     *
+     * @param extractorId - Identifier of the extractor
+     * @returns A query builder selecting used blocks
+     */
+    createUsedBlocksQuery: (extractorId: string) => SelectQueryBuilder<AddressTxsEntity>;
+    /**
+     * Returns the highest nonce recorded for the specified extractor and address
+     * up to and including the given block height.
+     *
+     * @param extractor - Extractor identifier.
+     * @param address - The address to filter transactions by.
+     * @param height - Upper bound block height (Inclusive).
+     * @returns The highest nonce up to the given height, or -1 if no transaction found.
+     */
+    getNonceUpToHeight: (extractor: string, address: string, height: number) => Promise<number>;
+}
+//# sourceMappingURL=db.d.ts.map

package/dist/actions/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../lib/actions/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAe,MAAM,+BAA+B,CAAC;AAE5E,OAAO,EACL,UAAU,EAEV,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA+B;IAC1D,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;gBAEpB,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,cAAc;IAK3D;;;;OAIG;IACH,cAAc,GAAU,SAAS,MAAM,EAAE,WAAW,MAAM,mBAYxD;IAEF;;;;;;OAMG;IACH,QAAQ,GACN,KAAK,KAAK,CAAC,WAAW,CAAC,EACvB,OAAO,SAAS,EAChB,WAAW,MAAM,mBAuBjB;IAEF;;;;;;OAMG;IACH,qBAAqB,GACnB,aAAa,MAAM,KAClB,kBAAkB,CAAC,gBAAgB,CAAC,CAKrC;IAEF;;;;;;;;OAQG;IACH,kBAAkB,GAChB,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,QAAQ,MAAM,KACb,OAAO,CAAC,MAAM,CAAC,CAahB;CACH"}

package/dist/actions/db.js

@@ -0,0 +1,87 @@
+import { DummyLogger } from '@rosen-bridge/abstract-logger';
+import { BlockEntity } from '@rosen-bridge/abstract-scanner';
+import { AddressTxsEntity } from '../entities/addressTxsEntity';
+export class TxAction {
+    repository;
+    logger;
+    constructor(dataSource, logger) {
+        this.repository = dataSource.getRepository(AddressTxsEntity);
+        this.logger = logger ? logger : new DummyLogger();
+    }
+    /**
+     * remove all inserted transaction for specific block in specific extractor from database
+     * @param blockId selected block id
+     * @param extractor selected extractor
+     */
+    deleteBlockTxs = async (blockId, extractor) => {
+        this.logger.debug(`Deleting transactions of block ${blockId} and extractor ${extractor}`);
+        await this.repository
+            .createQueryBuilder()
+            .delete()
+            .where('extractor = :extractor AND blockId = :blockId', {
+            blockId: blockId,
+            extractor: extractor,
+        })
+            .execute();
+    };
+    /**
+     * remove old list of transactions and
+     * store a new list of transactions database for specific block and extractor
+     * @param txs
+     * @param block
+     * @param extractor
+     */
+    storeTxs = async (txs, block, extractor) => {
+        await this.deleteBlockTxs(block.hash, extractor);
+        this.logger.debug(`Inserting new transactions [${txs.map((tx) => tx.signedHash)}] in block ${block.hash} and extractor ${extractor}`);
+        await this.repository
+            .createQueryBuilder()
+            .insert()
+            .values(txs.map((tx) => ({
+            unsignedHash: tx.unsignedHash,
+            signedHash: tx.signedHash,
+            nonce: tx.nonce,
+            address: tx.address,
+            blockId: block.hash,
+            extractor: extractor,
+            status: tx.status,
+        })))
+            .execute();
+    };
+    /**
+     * Builds a query that returns used blocks by selecting the `block` column from the `evmAddressTxEntity` repository,
+     * filtered by the provided `extractorId`
+     *
+     * @param extractorId - Identifier of the extractor
+     * @returns A query builder selecting used blocks
+     */
+    createUsedBlocksQuery = (extractorId) => {
+        return this.repository
+            .createQueryBuilder('evmAddressTxEntity')
+            .select('evmAddressTxEntity.blockId', 'block')
+            .where('evmAddressTxEntity.extractor = :extractorId', { extractorId });
+    };
+    /**
+     * Returns the highest nonce recorded for the specified extractor and address
+     * up to and including the given block height.
+     *
+     * @param extractor - Extractor identifier.
+     * @param address - The address to filter transactions by.
+     * @param height - Upper bound block height (Inclusive).
+     * @returns The highest nonce up to the given height, or -1 if no transaction found.
+     */
+    getNonceUpToHeight = async (extractor, address, height) => {
+        const result = await this.repository
+            .createQueryBuilder('tx')
+            .innerJoin(BlockEntity, 'block', 'block.hash = tx.blockId')
+            .select('MAX(tx.nonce)', 'nonce')
+            .where('tx.extractor = :extractor', { extractor })
+            .andWhere('tx.address = :address', { address })
+            .andWhere('block.height <= :height', { height })
+            .getRawOne();
+        return result?.nonce !== null && result?.nonce !== undefined
+            ? Number(result.nonce)
+            : -1;
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9saWIvYWN0aW9ucy9kYi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQWtCLFdBQVcsRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBQzVFLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQVE3RCxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUdoRSxNQUFNLE9BQU8sUUFBUTtJQUNGLFVBQVUsQ0FBK0I7SUFDakQsTUFBTSxDQUFpQjtJQUVoQyxZQUFZLFVBQXNCLEVBQUUsTUFBdUI7UUFDekQsSUFBSSxDQUFDLFVBQVUsR0FBRyxVQUFVLENBQUMsYUFBYSxDQUFDLGdCQUFnQixDQUFDLENBQUM7UUFDN0QsSUFBSSxDQUFDLE1BQU0sR0FBRyxNQUFNLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsSUFBSSxXQUFXLEVBQUUsQ0FBQztJQUNwRCxDQUFDO0lBRUQ7Ozs7T0FJRztJQUNILGNBQWMsR0FBRyxLQUFLLEVBQUUsT0FBZSxFQUFFLFNBQWlCLEVBQUUsRUFBRTtRQUM1RCxJQUFJLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FDZixrQ0FBa0MsT0FBTyxrQkFBa0IsU0FBUyxFQUFFLENBQ3ZFLENBQUM7UUFDRixNQUFNLElBQUksQ0FBQyxVQUFVO2FBQ2xCLGtCQUFrQixFQUFFO2FBQ3BCLE1BQU0sRUFBRTthQUNSLEtBQUssQ0FBQywrQ0FBK0MsRUFBRTtZQUN0RCxPQUFPLEVBQUUsT0FBTztZQUNoQixTQUFTLEVBQUUsU0FBUztTQUNyQixDQUFDO2FBQ0QsT0FBTyxFQUFFLENBQUM7SUFDZixDQUFDLENBQUM7SUFFRjs7Ozs7O09BTUc7SUFDSCxRQUFRLEdBQUcsS0FBSyxFQUNkLEdBQXVCLEVBQ3ZCLEtBQWdCLEVBQ2hCLFNBQWlCLEVBQ2pCLEVBQUU7UUFDRixNQUFNLElBQUksQ0FBQyxjQUFjLENBQUMsS0FBSyxDQUFDLElBQUksRUFBRSxTQUFTLENBQUMsQ0FBQztRQUNqRCxJQUFJLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FDZiwrQkFBK0IsR0FBRyxDQUFDLEdBQUcsQ0FDcEMsQ0FBQyxFQUFFLEVBQUUsRUFBRSxDQUFDLEVBQUUsQ0FBQyxVQUFVLENBQ3RCLGNBQWMsS0FBSyxDQUFDLElBQUksa0JBQWtCLFNBQVMsRUFBRSxDQUN2RCxDQUFDO1FBQ0YsTUFBTSxJQUFJLENBQUMsVUFBVTthQUNsQixrQkFBa0IsRUFBRTthQUNwQixNQUFNLEVBQUU7YUFDUixNQUFNLENBQ0wsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFDLEVBQUUsRUFBRSxFQUFFLENBQUMsQ0FBQztZQUNmLFlBQVksRUFBRSxFQUFFLENBQUMsWUFBWTtZQUM3QixVQUFVLEVBQUUsRUFBRSxDQUFDLFVBQVU7WUFDekIsS0FBSyxFQUFFLEVBQUUsQ0FBQyxLQUFLO1lBQ2YsT0FBTyxFQUFFLEVBQUUsQ0FBQyxPQUFPO1lBQ25CLE9BQU8sRUFBRSxLQUFLLENBQUMsSUFBSTtZQUNuQixTQUFTLEVBQUUsU0FBUztZQUNwQixNQUFNLEVBQUUsRUFBRSxDQUFDLE1BQU07U0FDbEIsQ0FBQyxDQUFDLENBQ0o7YUFDQSxPQUFPLEVBQUUsQ0FBQztJQUNmLENBQUMsQ0FBQztJQUVGOzs7Ozs7T0FNRztJQUNILHFCQUFxQixHQUFHLENBQ3RCLFdBQW1CLEVBQ21CLEVBQUU7UUFDeEMsT0FBTyxJQUFJLENBQUMsVUFBVTthQUNuQixrQkFBa0IsQ0FBQyxvQkFBb0IsQ0FBQzthQUN4QyxNQUFNLENBQUMsNEJBQTRCLEVBQUUsT0FBTyxDQUFDO2FBQzdDLEtBQUssQ0FBQyw2Q0FBNkMsRUFBRSxFQUFFLFdBQVcsRUFBRSxDQUFDLENBQUM7SUFDM0UsQ0FBQyxDQUFDO0lBRUY7Ozs7Ozs7O09BUUc7SUFDSCxrQkFBa0IsR0FBRyxLQUFLLEVBQ3hCLFNBQWlCLEVBQ2pCLE9BQWUsRUFDZixNQUFjLEVBQ0csRUFBRTtRQUNuQixNQUFNLE1BQU0sR0FBRyxNQUFNLElBQUksQ0FBQyxVQUFVO2FBQ2pDLGtCQUFrQixDQUFDLElBQUksQ0FBQzthQUN4QixTQUFTLENBQUMsV0FBVyxFQUFFLE9BQU8sRUFBRSx5QkFBeUIsQ0FBQzthQUMxRCxNQUFNLENBQUMsZUFBZSxFQUFFLE9BQU8sQ0FBQzthQUNoQyxLQUFLLENBQUMsMkJBQTJCLEVBQUUsRUFBRSxTQUFTLEVBQUUsQ0FBQzthQUNqRCxRQUFRLENBQUMsdUJBQXVCLEVBQUUsRUFBRSxPQUFPLEVBQUUsQ0FBQzthQUM5QyxRQUFRLENBQUMseUJBQXlCLEVBQUUsRUFBRSxNQUFNLEVBQUUsQ0FBQzthQUMvQyxTQUFTLEVBQUUsQ0FBQztRQUVmLE9BQU8sTUFBTSxFQUFFLEtBQUssS0FBSyxJQUFJLElBQUksTUFBTSxFQUFFLEtBQUssS0FBSyxTQUFTO1lBQzFELENBQUMsQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQztZQUN0QixDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDVCxDQUFDLENBQUM7Q0FDSCIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IEFic3RyYWN0TG9nZ2VyLCBEdW1teUxvZ2dlciB9IGZyb20gJ0Byb3Nlbi1icmlkZ2UvYWJzdHJhY3QtbG9nZ2VyJztcbmltcG9ydCB7IEJsb2NrRW50aXR5IH0gZnJvbSAnQHJvc2VuLWJyaWRnZS9hYnN0cmFjdC1zY2FubmVyJztcbmltcG9ydCB7XG4gIERhdGFTb3VyY2UsXG4gIFJlcG9zaXRvcnksXG4gIFNlbGVjdFF1ZXJ5QnVpbGRlcixcbn0gZnJvbSAnQHJvc2VuLWJyaWRnZS9leHRlbmRlZC10eXBlb3JtJztcbmltcG9ydCB7IEJsb2NrSW5mbyB9IGZyb20gJ0Byb3Nlbi1icmlkZ2Uvc2Nhbm5lci1pbnRlcmZhY2VzJztcblxuaW1wb3J0IHsgQWRkcmVzc1R4c0VudGl0eSB9IGZyb20gJy4uL2VudGl0aWVzL2FkZHJlc3NUeHNFbnRpdHknO1xuaW1wb3J0IHsgRXh0cmFjdGVkVHggfSBmcm9tICcuLi9pbnRlcmZhY2VzL3R5cGVzJztcblxuZXhwb3J0IGNsYXNzIFR4QWN0aW9uIHtcbiAgcHJpdmF0ZSByZWFkb25seSByZXBvc2l0b3J5OiBSZXBvc2l0b3J5PEFkZHJlc3NUeHNFbnRpdHk+O1xuICByZWFkb25seSBsb2dnZXI6IEFic3RyYWN0TG9nZ2VyO1xuXG4gIGNvbnN0cnVjdG9yKGRhdGFTb3VyY2U6IERhdGFTb3VyY2UsIGxvZ2dlcj86IEFic3RyYWN0TG9nZ2VyKSB7XG4gICAgdGhpcy5yZXBvc2l0b3J5ID0gZGF0YVNvdXJjZS5nZXRSZXBvc2l0b3J5KEFkZHJlc3NUeHNFbnRpdHkpO1xuICAgIHRoaXMubG9nZ2VyID0gbG9nZ2VyID8gbG9nZ2VyIDogbmV3IER1bW15TG9nZ2VyKCk7XG4gIH1cblxuICAvKipcbiAgICogcmVtb3ZlIGFsbCBpbnNlcnRlZCB0cmFuc2FjdGlvbiBmb3Igc3BlY2lmaWMgYmxvY2sgaW4gc3BlY2lmaWMgZXh0cmFjdG9yIGZyb20gZGF0YWJhc2VcbiAgICogQHBhcmFtIGJsb2NrSWQgc2VsZWN0ZWQgYmxvY2sgaWRcbiAgICogQHBhcmFtIGV4dHJhY3RvciBzZWxlY3RlZCBleHRyYWN0b3JcbiAgICovXG4gIGRlbGV0ZUJsb2NrVHhzID0gYXN5bmMgKGJsb2NrSWQ6IHN0cmluZywgZXh0cmFjdG9yOiBzdHJpbmcpID0+IHtcbiAgICB0aGlzLmxvZ2dlci5kZWJ1ZyhcbiAgICAgIGBEZWxldGluZyB0cmFuc2FjdGlvbnMgb2YgYmxvY2sgJHtibG9ja0lkfSBhbmQgZXh0cmFjdG9yICR7ZXh0cmFjdG9yfWAsXG4gICAgKTtcbiAgICBhd2FpdCB0aGlzLnJlcG9zaXRvcnlcbiAgICAgIC5jcmVhdGVRdWVyeUJ1aWxkZXIoKVxuICAgICAgLmRlbGV0ZSgpXG4gICAgICAud2hlcmUoJ2V4dHJhY3RvciA9IDpleHRyYWN0b3IgQU5EIGJsb2NrSWQgPSA6YmxvY2tJZCcsIHtcbiAgICAgICAgYmxvY2tJZDogYmxvY2tJZCxcbiAgICAgICAgZXh0cmFjdG9yOiBleHRyYWN0b3IsXG4gICAgICB9KVxuICAgICAgLmV4ZWN1dGUoKTtcbiAgfTtcblxuICAvKipcbiAgICogcmVtb3ZlIG9sZCBsaXN0IG9mIHRyYW5zYWN0aW9ucyBhbmRcbiAgICogc3RvcmUgYSBuZXcgbGlzdCBvZiB0cmFuc2FjdGlvbnMgZGF0YWJhc2UgZm9yIHNwZWNpZmljIGJsb2NrIGFuZCBleHRyYWN0b3JcbiAgICogQHBhcmFtIHR4c1xuICAgKiBAcGFyYW0gYmxvY2tcbiAgICogQHBhcmFtIGV4dHJhY3RvclxuICAgKi9cbiAgc3RvcmVUeHMgPSBhc3luYyAoXG4gICAgdHhzOiBBcnJheTxFeHRyYWN0ZWRUeD4sXG4gICAgYmxvY2s6IEJsb2NrSW5mbyxcbiAgICBleHRyYWN0b3I6IHN0cmluZyxcbiAgKSA9PiB7XG4gICAgYXdhaXQgdGhpcy5kZWxldGVCbG9ja1R4cyhibG9jay5oYXNoLCBleHRyYWN0b3IpO1xuICAgIHRoaXMubG9nZ2VyLmRlYnVnKFxuICAgICAgYEluc2VydGluZyBuZXcgdHJhbnNhY3Rpb25zIFske3R4cy5tYXAoXG4gICAgICAgICh0eCkgPT4gdHguc2lnbmVkSGFzaCxcbiAgICAgICl9XSBpbiBibG9jayAke2Jsb2NrLmhhc2h9IGFuZCBleHRyYWN0b3IgJHtleHRyYWN0b3J9YCxcbiAgICApO1xuICAgIGF3YWl0IHRoaXMucmVwb3NpdG9yeVxuICAgICAgLmNyZWF0ZVF1ZXJ5QnVpbGRlcigpXG4gICAgICAuaW5zZXJ0KClcbiAgICAgIC52YWx1ZXMoXG4gICAgICAgIHR4cy5tYXAoKHR4KSA9PiAoe1xuICAgICAgICAgIHVuc2lnbmVkSGFzaDogdHgudW5zaWduZWRIYXNoLFxuICAgICAgICAgIHNpZ25lZEhhc2g6IHR4LnNpZ25lZEhhc2gsXG4gICAgICAgICAgbm9uY2U6IHR4Lm5vbmNlLFxuICAgICAgICAgIGFkZHJlc3M6IHR4LmFkZHJlc3MsXG4gICAgICAgICAgYmxvY2tJZDogYmxvY2suaGFzaCxcbiAgICAgICAgICBleHRyYWN0b3I6IGV4dHJhY3RvcixcbiAgICAgICAgICBzdGF0dXM6IHR4LnN0YXR1cyxcbiAgICAgICAgfSkpLFxuICAgICAgKVxuICAgICAgLmV4ZWN1dGUoKTtcbiAgfTtcblxuICAvKipcbiAgICogQnVpbGRzIGEgcXVlcnkgdGhhdCByZXR1cm5zIHVzZWQgYmxvY2tzIGJ5IHNlbGVjdGluZyB0aGUgYGJsb2NrYCBjb2x1bW4gZnJvbSB0aGUgYGV2bUFkZHJlc3NUeEVudGl0eWAgcmVwb3NpdG9yeSxcbiAgICogZmlsdGVyZWQgYnkgdGhlIHByb3ZpZGVkIGBleHRyYWN0b3JJZGBcbiAgICpcbiAgICogQHBhcmFtIGV4dHJhY3RvcklkIC0gSWRlbnRpZmllciBvZiB0aGUgZXh0cmFjdG9yXG4gICAqIEByZXR1cm5zIEEgcXVlcnkgYnVpbGRlciBzZWxlY3RpbmcgdXNlZCBibG9ja3NcbiAgICovXG4gIGNyZWF0ZVVzZWRCbG9ja3NRdWVyeSA9IChcbiAgICBleHRyYWN0b3JJZDogc3RyaW5nLFxuICApOiBTZWxlY3RRdWVyeUJ1aWxkZXI8QWRkcmVzc1R4c0VudGl0eT4gPT4ge1xuICAgIHJldHVybiB0aGlzLnJlcG9zaXRvcnlcbiAgICAgIC5jcmVhdGVRdWVyeUJ1aWxkZXIoJ2V2bUFkZHJlc3NUeEVudGl0eScpXG4gICAgICAuc2VsZWN0KCdldm1BZGRyZXNzVHhFbnRpdHkuYmxvY2tJZCcsICdibG9jaycpXG4gICAgICAud2hlcmUoJ2V2bUFkZHJlc3NUeEVudGl0eS5leHRyYWN0b3IgPSA6ZXh0cmFjdG9ySWQnLCB7IGV4dHJhY3RvcklkIH0pO1xuICB9O1xuXG4gIC8qKlxuICAgKiBSZXR1cm5zIHRoZSBoaWdoZXN0IG5vbmNlIHJlY29yZGVkIGZvciB0aGUgc3BlY2lmaWVkIGV4dHJhY3RvciBhbmQgYWRkcmVzc1xuICAgKiB1cCB0byBhbmQgaW5jbHVkaW5nIHRoZSBnaXZlbiBibG9jayBoZWlnaHQuXG4gICAqXG4gICAqIEBwYXJhbSBleHRyYWN0b3IgLSBFeHRyYWN0b3IgaWRlbnRpZmllci5cbiAgICogQHBhcmFtIGFkZHJlc3MgLSBUaGUgYWRkcmVzcyB0byBmaWx0ZXIgdHJhbnNhY3Rpb25zIGJ5LlxuICAgKiBAcGFyYW0gaGVpZ2h0IC0gVXBwZXIgYm91bmQgYmxvY2sgaGVpZ2h0IChJbmNsdXNpdmUpLlxuICAgKiBAcmV0dXJucyBUaGUgaGlnaGVzdCBub25jZSB1cCB0byB0aGUgZ2l2ZW4gaGVpZ2h0LCBvciAtMSBpZiBubyB0cmFuc2FjdGlvbiBmb3VuZC5cbiAgICovXG4gIGdldE5vbmNlVXBUb0hlaWdodCA9IGFzeW5jIChcbiAgICBleHRyYWN0b3I6IHN0cmluZyxcbiAgICBhZGRyZXNzOiBzdHJpbmcsXG4gICAgaGVpZ2h0OiBudW1iZXIsXG4gICk6IFByb21pc2U8bnVtYmVyPiA9PiB7XG4gICAgY29uc3QgcmVzdWx0ID0gYXdhaXQgdGhpcy5yZXBvc2l0b3J5XG4gICAgICAuY3JlYXRlUXVlcnlCdWlsZGVyKCd0eCcpXG4gICAgICAuaW5uZXJKb2luKEJsb2NrRW50aXR5LCAnYmxvY2snLCAnYmxvY2suaGFzaCA9IHR4LmJsb2NrSWQnKVxuICAgICAgLnNlbGVjdCgnTUFYKHR4Lm5vbmNlKScsICdub25jZScpXG4gICAgICAud2hlcmUoJ3R4LmV4dHJhY3RvciA9IDpleHRyYWN0b3InLCB7IGV4dHJhY3RvciB9KVxuICAgICAgLmFuZFdoZXJlKCd0eC5hZGRyZXNzID0gOmFkZHJlc3MnLCB7IGFkZHJlc3MgfSlcbiAgICAgIC5hbmRXaGVyZSgnYmxvY2suaGVpZ2h0IDw9IDpoZWlnaHQnLCB7IGhlaWdodCB9KVxuICAgICAgLmdldFJhd09uZSgpO1xuXG4gICAgcmV0dXJuIHJlc3VsdD8ubm9uY2UgIT09IG51bGwgJiYgcmVzdWx0Py5ub25jZSAhPT0gdW5kZWZpbmVkXG4gICAgICA/IE51bWJlcihyZXN1bHQubm9uY2UpXG4gICAgICA6IC0xO1xuICB9O1xufVxuIl19

package/dist/entities/addressTxsEntity.d.ts

@@ -0,0 +1,11 @@
+export declare class AddressTxsEntity {
+    id: number;
+    unsignedHash: string;
+    signedHash: string;
+    nonce: number;
+    address: string;
+    blockId: string;
+    extractor: string;
+    status: string;
+}
+//# sourceMappingURL=addressTxsEntity.d.ts.map

package/dist/entities/addressTxsEntity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addressTxsEntity.d.ts","sourceRoot":"","sources":["../../lib/entities/addressTxsEntity.ts"],"names":[],"mappings":"AAMA,qBACa,gBAAgB;IAE3B,EAAE,EAAE,MAAM,CAAC;IAGX,YAAY,EAAE,MAAM,CAAC;IAGrB,UAAU,EAAE,MAAM,CAAC;IAGnB,KAAK,EAAE,MAAM,CAAC;IAGd,OAAO,EAAE,MAAM,CAAC;IAGhB,OAAO,EAAE,MAAM,CAAC;IAGhB,SAAS,EAAE,MAAM,CAAC;IAGlB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/entities/addressTxsEntity.js

@@ -0,0 +1,57 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Column, Entity, PrimaryGeneratedColumn, } from '@rosen-bridge/extended-typeorm';
+let AddressTxsEntity = class AddressTxsEntity {
+    id;
+    unsignedHash;
+    signedHash;
+    nonce;
+    address;
+    blockId;
+    extractor;
+    status;
+};
+__decorate([
+    PrimaryGeneratedColumn({ type: 'integer' }),
+    __metadata("design:type", Number)
+], AddressTxsEntity.prototype, "id", void 0);
+__decorate([
+    Column({ type: 'varchar' }),
+    __metadata("design:type", String)
+], AddressTxsEntity.prototype, "unsignedHash", void 0);
+__decorate([
+    Column({ type: 'varchar' }),
+    __metadata("design:type", String)
+], AddressTxsEntity.prototype, "signedHash", void 0);
+__decorate([
+    Column({ type: 'integer' }),
+    __metadata("design:type", Number)
+], AddressTxsEntity.prototype, "nonce", void 0);
+__decorate([
+    Column({ type: 'varchar' }),
+    __metadata("design:type", String)
+], AddressTxsEntity.prototype, "address", void 0);
+__decorate([
+    Column({ type: 'varchar' }),
+    __metadata("design:type", String)
+], AddressTxsEntity.prototype, "blockId", void 0);
+__decorate([
+    Column({ type: 'varchar' }),
+    __metadata("design:type", String)
+], AddressTxsEntity.prototype, "extractor", void 0);
+__decorate([
+    Column({ type: 'varchar' }),
+    __metadata("design:type", String)
+], AddressTxsEntity.prototype, "status", void 0);
+AddressTxsEntity = __decorate([
+    Entity('address_txs_entity')
+], AddressTxsEntity);
+export { AddressTxsEntity };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWRkcmVzc1R4c0VudGl0eS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL2xpYi9lbnRpdGllcy9hZGRyZXNzVHhzRW50aXR5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7OztBQUFBLE9BQU8sRUFDTCxNQUFNLEVBQ04sTUFBTSxFQUNOLHNCQUFzQixHQUN2QixNQUFNLGdDQUFnQyxDQUFDO0FBR2pDLElBQU0sZ0JBQWdCLEdBQXRCLE1BQU0sZ0JBQWdCO0lBRTNCLEVBQUUsQ0FBUztJQUdYLFlBQVksQ0FBUztJQUdyQixVQUFVLENBQVM7SUFHbkIsS0FBSyxDQUFTO0lBR2QsT0FBTyxDQUFTO0lBR2hCLE9BQU8sQ0FBUztJQUdoQixTQUFTLENBQVM7SUFHbEIsTUFBTSxDQUFTO0NBQ2hCLENBQUE7QUF0QkM7SUFEQyxzQkFBc0IsQ0FBQyxFQUFFLElBQUksRUFBRSxTQUFTLEVBQUUsQ0FBQzs7NENBQ2pDO0FBR1g7SUFEQyxNQUFNLENBQUMsRUFBRSxJQUFJLEVBQUUsU0FBUyxFQUFFLENBQUM7O3NEQUNQO0FBR3JCO0lBREMsTUFBTSxDQUFDLEVBQUUsSUFBSSxFQUFFLFNBQVMsRUFBRSxDQUFDOztvREFDVDtBQUduQjtJQURDLE1BQU0sQ0FBQyxFQUFFLElBQUksRUFBRSxTQUFTLEVBQUUsQ0FBQzs7K0NBQ2Q7QUFHZDtJQURDLE1BQU0sQ0FBQyxFQUFFLElBQUksRUFBRSxTQUFTLEVBQUUsQ0FBQzs7aURBQ1o7QUFHaEI7SUFEQyxNQUFNLENBQUMsRUFBRSxJQUFJLEVBQUUsU0FBUyxFQUFFLENBQUM7O2lEQUNaO0FBR2hCO0lBREMsTUFBTSxDQUFDLEVBQUUsSUFBSSxFQUFFLFNBQVMsRUFBRSxDQUFDOzttREFDVjtBQUdsQjtJQURDLE1BQU0sQ0FBQyxFQUFFLElBQUksRUFBRSxTQUFTLEVBQUUsQ0FBQzs7Z0RBQ2I7QUF2QkosZ0JBQWdCO0lBRDVCLE1BQU0sQ0FBQyxvQkFBb0IsQ0FBQztHQUNoQixnQkFBZ0IsQ0F3QjVCIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHtcbiAgQ29sdW1uLFxuICBFbnRpdHksXG4gIFByaW1hcnlHZW5lcmF0ZWRDb2x1bW4sXG59IGZyb20gJ0Byb3Nlbi1icmlkZ2UvZXh0ZW5kZWQtdHlwZW9ybSc7XG5cbkBFbnRpdHkoJ2FkZHJlc3NfdHhzX2VudGl0eScpXG5leHBvcnQgY2xhc3MgQWRkcmVzc1R4c0VudGl0eSB7XG4gIEBQcmltYXJ5R2VuZXJhdGVkQ29sdW1uKHsgdHlwZTogJ2ludGVnZXInIH0pXG4gIGlkOiBudW1iZXI7XG5cbiAgQENvbHVtbih7IHR5cGU6ICd2YXJjaGFyJyB9KVxuICB1bnNpZ25lZEhhc2g6IHN0cmluZztcblxuICBAQ29sdW1uKHsgdHlwZTogJ3ZhcmNoYXInIH0pXG4gIHNpZ25lZEhhc2g6IHN0cmluZztcblxuICBAQ29sdW1uKHsgdHlwZTogJ2ludGVnZXInIH0pXG4gIG5vbmNlOiBudW1iZXI7XG5cbiAgQENvbHVtbih7IHR5cGU6ICd2YXJjaGFyJyB9KVxuICBhZGRyZXNzOiBzdHJpbmc7XG5cbiAgQENvbHVtbih7IHR5cGU6ICd2YXJjaGFyJyB9KVxuICBibG9ja0lkOiBzdHJpbmc7XG5cbiAgQENvbHVtbih7IHR5cGU6ICd2YXJjaGFyJyB9KVxuICBleHRyYWN0b3I6IHN0cmluZztcblxuICBAQ29sdW1uKHsgdHlwZTogJ3ZhcmNoYXInIH0pXG4gIHN0YXR1czogc3RyaW5nO1xufVxuIl19

package/dist/extractors/evmTxExtractor.d.ts

@@ -0,0 +1,55 @@
+import { TransactionResponse } from 'ethers';
+import { AbstractExtractor } from '@rosen-bridge/abstract-extractor';
+import { AbstractLogger } from '@rosen-bridge/abstract-logger';
+import { DataSource, SelectQueryBuilder } from '@rosen-bridge/extended-typeorm';
+import { BlockInfo } from '@rosen-bridge/scanner-interfaces';
+import { TxAction } from '../actions/db';
+import { AddressTxsEntity } from '../entities/addressTxsEntity';
+export declare class EvmTxExtractor extends AbstractExtractor<TransactionResponse, AddressTxsEntity> {
+    readonly logger: AbstractLogger;
+    readonly action: TxAction;
+    private readonly id;
+    private readonly address;
+    private readonly provider;
+    private readonly checkNonceAtToHeight;
+    /**
+     * address should be lower case (without checksum)
+     */
+    constructor(dataSource: DataSource, id: string, address: string, rpcUrl: string, authToken?: string, checkNonceAtToHeight?: boolean, logger?: AbstractLogger);
+    /**
+     * get Id for current extractor
+     */
+    getId: () => string;
+    /**
+     * gets block id and transactions corresponding to the block and saves all transaction ids in database
+     * @param txs
+     * @param block
+     */
+    processTransactions: (txs: Array<TransactionResponse>, block: BlockInfo) => Promise<boolean>;
+    /**
+     * fork one block and remove all stored txId for this block
+     * @param hash: block hash
+     */
+    forkBlock: (hash: string) => Promise<void>;
+    /**
+     * Initializes the database with older boxes related to the address
+     */
+    initializeData: () => Promise<void>;
+    /**
+     * Builds a query that returns used blocks by selecting the `block` column from the `evmAddressTxEntity` repository,
+     * filtered by the provided `extractorId`
+     *
+     * @returns A query builder selecting used blocks
+     */
+    createUsedBlocksQuery: () => SelectQueryBuilder<AddressTxsEntity>;
+    /**
+     * checks if nonce changes within the specified height range
+     *
+     * @param fromHeight - Start height of the range being evaluated.
+     * @param toHeight - End height of the range being evaluated.
+     * @returns `true` if the range may contain relevant transactions,
+     * `false` if it is guaranteed to be empty.
+     */
+    hasEventInHeightRange: (fromHeight: number, toHeight: number) => Promise<boolean>;
+}
+//# sourceMappingURL=evmTxExtractor.d.ts.map

package/dist/extractors/evmTxExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evmTxExtractor.d.ts","sourceRoot":"","sources":["../../lib/extractors/evmTxExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,mBAAmB,EACpB,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAe,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAE7D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGhE,qBAAa,cAAe,SAAQ,iBAAiB,CACnD,mBAAmB,EACnB,gBAAgB,CACjB;IACC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAU;IAE/C;;OAEG;gBAED,UAAU,EAAE,UAAU,EACtB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,oBAAoB,UAAQ,EAC5B,MAAM,GAAE,cAAkC;IAa5C;;OAEG;IACH,KAAK,eAAiB;IAEtB;;;;OAIG;IACH,mBAAmB,GACjB,KAAK,KAAK,CAAC,mBAAmB,CAAC,EAC/B,OAAO,SAAS,KACf,OAAO,CAAC,OAAO,CAAC,CAkCjB;IAEF;;;OAGG;IACH,SAAS,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC,CAE7C;IAEF;;OAEG;IACH,cAAc,sBAEZ;IAEF;;;;;OAKG;IACH,qBAAqB,QAAO,kBAAkB,CAAC,gBAAgB,CAAC,CACd;IAElD;;;;;;;OAOG;IACH,qBAAqB,GACnB,YAAY,MAAM,EAClB,UAAU,MAAM,KACf,OAAO,CAAC,OAAO,CAAC,CAgDjB;CACH"}