@rosen-bridge/evm-scanner 0.1.0-52fc0239

package/.eslintignore

@@ -0,0 +1 @@
+dist

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# @rosen-bridge/evm-scanner
+
+---
+
+## 0.1.0
+
+- This package was **renamed** from `@rosen-bridge/evm-rpc-scanner`.  
+  You can follow the previous history in the old package’s changelog. The last changelog update is available [here](https://github.com/rosen-bridge/scanner/blob/71f759d7e7ca6b6a7a60425f1848741104e1b65b/packages/scanners/evm-rpc-scanner/CHANGELOG.md).

package/README.md

@@ -0,0 +1,24 @@
+# @rosen-bridge/evm-scanner
+
+## Table of contents
+
+- [Introduction](#introduction)
+- [Installation](#installation)
+
+## Introduction
+
+An EVM chain scanner based on RPC.
+
+## Installation
+
+npm:
+
+```sh
+npm i @rosen-bridge/evm-scanner
+```
+
+yarn:
+
+```sh
+yarn add @rosen-bridge/evm-scanner
+```

package/dist/EvmRpcNetwork.d.ts

@@ -0,0 +1,24 @@
+import { AbstractNetworkConnector, Block } from '@rosen-bridge/scanner-interfaces';
+import { JsonRpcProvider, TransactionResponse } from 'ethers';
+export declare class EvmRpcNetwork extends AbstractNetworkConnector<TransactionResponse> {
+    protected readonly provider: JsonRpcProvider;
+    constructor(url: string, timeout?: number, authToken?: string);
+    /**
+     * Returns block at height
+     * @param height
+     * @returns Block
+     */
+    getBlockAtHeight: (height: number) => Promise<Block>;
+    /**
+     * Returns current network height
+     * @returns current height
+     */
+    getCurrentHeight: () => Promise<number>;
+    /**
+     * Return transactions in a block with specified hash
+     * @param blockHash
+     * @returns array of RpcTransaction
+     */
+    getBlockTxs: (blockHash: string) => Promise<Array<TransactionResponse>>;
+}
+//# sourceMappingURL=EvmRpcNetwork.d.ts.map

package/dist/EvmRpcNetwork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvmRpcNetwork.d.ts","sourceRoot":"","sources":["../lib/EvmRpcNetwork.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,KAAK,EACN,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAE9D,qBAAa,aAAc,SAAQ,wBAAwB,CAAC,mBAAmB,CAAC;IAC9E,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;gBAEjC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAU7D;;;;OAIG;IACH,gBAAgB,WAAY,MAAM,KAAG,QAAQ,KAAK,CAAC,CAiBjD;IAEF;;;OAGG;IACH,gBAAgB,QAAO,QAAQ,MAAM,CAAC,CAEpC;IAEF;;;;OAIG;IACH,WAAW,cACE,MAAM,KAChB,QAAQ,MAAM,mBAAmB,CAAC,CAAC,CAMpC;CACH"}

package/dist/EvmRpcNetwork.js

@@ -0,0 +1,57 @@
+import { AbstractNetworkConnector, } from '@rosen-bridge/scanner-interfaces';
+import { BlockNotFound } from './types';
+import { JsonRpcProvider } from 'ethers';
+export class EvmRpcNetwork extends AbstractNetworkConnector {
+    provider;
+    constructor(url, timeout, authToken) {
+        super();
+        this.provider = authToken
+            ? new JsonRpcProvider(`${url}/${authToken}`)
+            : new JsonRpcProvider(`${url}`);
+        if (timeout) {
+            this.provider._getConnection().timeout = timeout;
+        }
+    }
+    /**
+     * Returns block at height
+     * @param height
+     * @returns Block
+     */
+    getBlockAtHeight = (height) => {
+        return this.provider.getBlock(height).then((block) => {
+            if (block == undefined) {
+                throw new BlockNotFound(`Block with height ${height} is not found.`);
+            }
+            if (block.hash == undefined) {
+                throw new Error('no block hash!');
+            }
+            return {
+                hash: block.hash,
+                height: block.number,
+                parentHash: block.parentHash,
+                timestamp: block.timestamp,
+                txCount: block.length,
+            };
+        });
+    };
+    /**
+     * Returns current network height
+     * @returns current height
+     */
+    getCurrentHeight = () => {
+        return this.provider.getBlockNumber();
+    };
+    /**
+     * Return transactions in a block with specified hash
+     * @param blockHash
+     * @returns array of RpcTransaction
+     */
+    getBlockTxs = async (blockHash) => {
+        const block = await this.provider.getBlock(blockHash, true);
+        if (block == undefined) {
+            throw new BlockNotFound(`Block with hash ${blockHash} is not found.`);
+        }
+        return block.prefetchedTransactions;
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiRXZtUnBjTmV0d29yay5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL2xpYi9Fdm1ScGNOZXR3b3JrLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFDTCx3QkFBd0IsR0FFekIsTUFBTSxrQ0FBa0MsQ0FBQztBQUMxQyxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBQ3hDLE9BQU8sRUFBRSxlQUFlLEVBQXVCLE1BQU0sUUFBUSxDQUFDO0FBRTlELE1BQU0sT0FBTyxhQUFjLFNBQVEsd0JBQTZDO0lBQzNELFFBQVEsQ0FBa0I7SUFFN0MsWUFBWSxHQUFXLEVBQUUsT0FBZ0IsRUFBRSxTQUFrQjtRQUMzRCxLQUFLLEVBQUUsQ0FBQztRQUNSLElBQUksQ0FBQyxRQUFRLEdBQUcsU0FBUztZQUN2QixDQUFDLENBQUMsSUFBSSxlQUFlLENBQUMsR0FBRyxHQUFHLElBQUksU0FBUyxFQUFFLENBQUM7WUFDNUMsQ0FBQyxDQUFDLElBQUksZUFBZSxDQUFDLEdBQUcsR0FBRyxFQUFFLENBQUMsQ0FBQztRQUNsQyxJQUFJLE9BQU8sRUFBRSxDQUFDO1lBQ1osSUFBSSxDQUFDLFFBQVEsQ0FBQyxjQUFjLEVBQUUsQ0FBQyxPQUFPLEdBQUcsT0FBTyxDQUFDO1FBQ25ELENBQUM7SUFDSCxDQUFDO0lBRUQ7Ozs7T0FJRztJQUNILGdCQUFnQixHQUFHLENBQUMsTUFBYyxFQUFrQixFQUFFO1FBQ3BELE9BQU8sSUFBSSxDQUFDLFFBQVEsQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLENBQUMsSUFBSSxDQUFDLENBQUMsS0FBSyxFQUFFLEVBQUU7WUFDbkQsSUFBSSxLQUFLLElBQUksU0FBUyxFQUFFLENBQUM7Z0JBQ3ZCLE1BQU0sSUFBSSxhQUFhLENBQUMscUJBQXFCLE1BQU0sZ0JBQWdCLENBQUMsQ0FBQztZQUN2RSxDQUFDO1lBQ0QsSUFBSSxLQUFLLENBQUMsSUFBSSxJQUFJLFNBQVMsRUFBRSxDQUFDO2dCQUM1QixNQUFNLElBQUksS0FBSyxDQUFDLGdCQUFnQixDQUFDLENBQUM7WUFDcEMsQ0FBQztZQUVELE9BQU87Z0JBQ0wsSUFBSSxFQUFFLEtBQUssQ0FBQyxJQUFJO2dCQUNoQixNQUFNLEVBQUUsS0FBSyxDQUFDLE1BQU07Z0JBQ3BCLFVBQVUsRUFBRSxLQUFLLENBQUMsVUFBVTtnQkFDNUIsU0FBUyxFQUFFLEtBQUssQ0FBQyxTQUFTO2dCQUMxQixPQUFPLEVBQUUsS0FBSyxDQUFDLE1BQU07YUFDdEIsQ0FBQztRQUNKLENBQUMsQ0FBQyxDQUFDO0lBQ0wsQ0FBQyxDQUFDO0lBRUY7OztPQUdHO0lBQ0gsZ0JBQWdCLEdBQUcsR0FBb0IsRUFBRTtRQUN2QyxPQUFPLElBQUksQ0FBQyxRQUFRLENBQUMsY0FBYyxFQUFFLENBQUM7SUFDeEMsQ0FBQyxDQUFDO0lBRUY7Ozs7T0FJRztJQUNILFdBQVcsR0FBRyxLQUFLLEVBQ2pCLFNBQWlCLEVBQ29CLEVBQUU7UUFDdkMsTUFBTSxLQUFLLEdBQUcsTUFBTSxJQUFJLENBQUMsUUFBUSxDQUFDLFFBQVEsQ0FBQyxTQUFTLEVBQUUsSUFBSSxDQUFDLENBQUM7UUFDNUQsSUFBSSxLQUFLLElBQUksU0FBUyxFQUFFLENBQUM7WUFDdkIsTUFBTSxJQUFJLGFBQWEsQ0FBQyxtQkFBbUIsU0FBUyxnQkFBZ0IsQ0FBQyxDQUFDO1FBQ3hFLENBQUM7UUFDRCxPQUFPLEtBQUssQ0FBQyxzQkFBc0IsQ0FBQztJQUN0QyxDQUFDLENBQUM7Q0FDSCIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7XG4gIEFic3RyYWN0TmV0d29ya0Nvbm5lY3RvcixcbiAgQmxvY2ssXG59IGZyb20gJ0Byb3Nlbi1icmlkZ2Uvc2Nhbm5lci1pbnRlcmZhY2VzJztcbmltcG9ydCB7IEJsb2NrTm90Rm91bmQgfSBmcm9tICcuL3R5cGVzJztcbmltcG9ydCB7IEpzb25ScGNQcm92aWRlciwgVHJhbnNhY3Rpb25SZXNwb25zZSB9IGZyb20gJ2V0aGVycyc7XG5cbmV4cG9ydCBjbGFzcyBFdm1ScGNOZXR3b3JrIGV4dGVuZHMgQWJzdHJhY3ROZXR3b3JrQ29ubmVjdG9yPFRyYW5zYWN0aW9uUmVzcG9uc2U+IHtcbiAgcHJvdGVjdGVkIHJlYWRvbmx5IHByb3ZpZGVyOiBKc29uUnBjUHJvdmlkZXI7XG5cbiAgY29uc3RydWN0b3IodXJsOiBzdHJpbmcsIHRpbWVvdXQ/OiBudW1iZXIsIGF1dGhUb2tlbj86IHN0cmluZykge1xuICAgIHN1cGVyKCk7XG4gICAgdGhpcy5wcm92aWRlciA9IGF1dGhUb2tlblxuICAgICAgPyBuZXcgSnNvblJwY1Byb3ZpZGVyKGAke3VybH0vJHthdXRoVG9rZW59YClcbiAgICAgIDogbmV3IEpzb25ScGNQcm92aWRlcihgJHt1cmx9YCk7XG4gICAgaWYgKHRpbWVvdXQpIHtcbiAgICAgIHRoaXMucHJvdmlkZXIuX2dldENvbm5lY3Rpb24oKS50aW1lb3V0ID0gdGltZW91dDtcbiAgICB9XG4gIH1cblxuICAvKipcbiAgICogUmV0dXJucyBibG9jayBhdCBoZWlnaHRcbiAgICogQHBhcmFtIGhlaWdodFxuICAgKiBAcmV0dXJucyBCbG9ja1xuICAgKi9cbiAgZ2V0QmxvY2tBdEhlaWdodCA9IChoZWlnaHQ6IG51bWJlcik6IFByb21pc2U8QmxvY2s+ID0+IHtcbiAgICByZXR1cm4gdGhpcy5wcm92aWRlci5nZXRCbG9jayhoZWlnaHQpLnRoZW4oKGJsb2NrKSA9PiB7XG4gICAgICBpZiAoYmxvY2sgPT0gdW5kZWZpbmVkKSB7XG4gICAgICAgIHRocm93IG5ldyBCbG9ja05vdEZvdW5kKGBCbG9jayB3aXRoIGhlaWdodCAke2hlaWdodH0gaXMgbm90IGZvdW5kLmApO1xuICAgICAgfVxuICAgICAgaWYgKGJsb2NrLmhhc2ggPT0gdW5kZWZpbmVkKSB7XG4gICAgICAgIHRocm93IG5ldyBFcnJvcignbm8gYmxvY2sgaGFzaCEnKTtcbiAgICAgIH1cblxuICAgICAgcmV0dXJuIHtcbiAgICAgICAgaGFzaDogYmxvY2suaGFzaCxcbiAgICAgICAgaGVpZ2h0OiBibG9jay5udW1iZXIsXG4gICAgICAgIHBhcmVudEhhc2g6IGJsb2NrLnBhcmVudEhhc2gsXG4gICAgICAgIHRpbWVzdGFtcDogYmxvY2sudGltZXN0YW1wLFxuICAgICAgICB0eENvdW50OiBibG9jay5sZW5ndGgsXG4gICAgICB9O1xuICAgIH0pO1xuICB9O1xuXG4gIC8qKlxuICAgKiBSZXR1cm5zIGN1cnJlbnQgbmV0d29yayBoZWlnaHRcbiAgICogQHJldHVybnMgY3VycmVudCBoZWlnaHRcbiAgICovXG4gIGdldEN1cnJlbnRIZWlnaHQgPSAoKTogUHJvbWlzZTxudW1iZXI+ID0+IHtcbiAgICByZXR1cm4gdGhpcy5wcm92aWRlci5nZXRCbG9ja051bWJlcigpO1xuICB9O1xuXG4gIC8qKlxuICAgKiBSZXR1cm4gdHJhbnNhY3Rpb25zIGluIGEgYmxvY2sgd2l0aCBzcGVjaWZpZWQgaGFzaFxuICAgKiBAcGFyYW0gYmxvY2tIYXNoXG4gICAqIEByZXR1cm5zIGFycmF5IG9mIFJwY1RyYW5zYWN0aW9uXG4gICAqL1xuICBnZXRCbG9ja1R4cyA9IGFzeW5jIChcbiAgICBibG9ja0hhc2g6IHN0cmluZ1xuICApOiBQcm9taXNlPEFycmF5PFRyYW5zYWN0aW9uUmVzcG9uc2U+PiA9PiB7XG4gICAgY29uc3QgYmxvY2sgPSBhd2FpdCB0aGlzLnByb3ZpZGVyLmdldEJsb2NrKGJsb2NrSGFzaCwgdHJ1ZSk7XG4gICAgaWYgKGJsb2NrID09IHVuZGVmaW5lZCkge1xuICAgICAgdGhyb3cgbmV3IEJsb2NrTm90Rm91bmQoYEJsb2NrIHdpdGggaGFzaCAke2Jsb2NrSGFzaH0gaXMgbm90IGZvdW5kLmApO1xuICAgIH1cbiAgICByZXR1cm4gYmxvY2sucHJlZmV0Y2hlZFRyYW5zYWN0aW9ucztcbiAgfTtcbn1cbiJdfQ==

package/dist/EvmRpcScanner.d.ts

@@ -0,0 +1,7 @@
+import { GeneralScanner, ScannerConfig } from '@rosen-bridge/abstract-scanner';
+import { TransactionResponse } from 'ethers';
+export declare class EvmRpcScanner extends GeneralScanner<TransactionResponse> {
+    readonly chain: string;
+    constructor(chain: string, config: ScannerConfig<TransactionResponse>);
+}
+//# sourceMappingURL=EvmRpcScanner.d.ts.map

package/dist/EvmRpcScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvmRpcScanner.d.ts","sourceRoot":"","sources":["../lib/EvmRpcScanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAE7C,qBAAa,aAAc,SAAQ,cAAc,CAAC,mBAAmB,CAAC;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC;CAWtE"}

package/dist/EvmRpcScanner.js

@@ -0,0 +1,8 @@
+import { GeneralScanner } from '@rosen-bridge/abstract-scanner';
+export class EvmRpcScanner extends GeneralScanner {
+    chain;
+    constructor(chain, config) {
+        super(`${chain}`, config.dataSource, config.initialHeight, config.network, config.blockRetrieveGap, config.logger, config.suffix);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiRXZtUnBjU2Nhbm5lci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL2xpYi9Fdm1ScGNTY2FubmVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxjQUFjLEVBQWlCLE1BQU0sZ0NBQWdDLENBQUM7QUFHL0UsTUFBTSxPQUFPLGFBQWMsU0FBUSxjQUFtQztJQUMzRCxLQUFLLENBQVM7SUFFdkIsWUFBWSxLQUFhLEVBQUUsTUFBMEM7UUFDbkUsS0FBSyxDQUNILEdBQUcsS0FBSyxFQUFFLEVBQ1YsTUFBTSxDQUFDLFVBQVUsRUFDakIsTUFBTSxDQUFDLGFBQWEsRUFDcEIsTUFBTSxDQUFDLE9BQU8sRUFDZCxNQUFNLENBQUMsZ0JBQWdCLEVBQ3ZCLE1BQU0sQ0FBQyxNQUFNLEVBQ2IsTUFBTSxDQUFDLE1BQU0sQ0FDZCxDQUFDO0lBQ0osQ0FBQztDQUNGIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgR2VuZXJhbFNjYW5uZXIsIFNjYW5uZXJDb25maWcgfSBmcm9tICdAcm9zZW4tYnJpZGdlL2Fic3RyYWN0LXNjYW5uZXInO1xuaW1wb3J0IHsgVHJhbnNhY3Rpb25SZXNwb25zZSB9IGZyb20gJ2V0aGVycyc7XG5cbmV4cG9ydCBjbGFzcyBFdm1ScGNTY2FubmVyIGV4dGVuZHMgR2VuZXJhbFNjYW5uZXI8VHJhbnNhY3Rpb25SZXNwb25zZT4ge1xuICByZWFkb25seSBjaGFpbjogc3RyaW5nO1xuXG4gIGNvbnN0cnVjdG9yKGNoYWluOiBzdHJpbmcsIGNvbmZpZzogU2Nhbm5lckNvbmZpZzxUcmFuc2FjdGlvblJlc3BvbnNlPikge1xuICAgIHN1cGVyKFxuICAgICAgYCR7Y2hhaW59YCxcbiAgICAgIGNvbmZpZy5kYXRhU291cmNlLFxuICAgICAgY29uZmlnLmluaXRpYWxIZWlnaHQsXG4gICAgICBjb25maWcubmV0d29yayxcbiAgICAgIGNvbmZpZy5ibG9ja1JldHJpZXZlR2FwLFxuICAgICAgY29uZmlnLmxvZ2dlcixcbiAgICAgIGNvbmZpZy5zdWZmaXhcbiAgICApO1xuICB9XG59XG4iXX0=

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { EvmRpcScanner } from './EvmRpcScanner';
+export { EvmRpcNetwork } from './EvmRpcNetwork';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { EvmRpcScanner } from './EvmRpcScanner';
+export { EvmRpcNetwork } from './EvmRpcNetwork';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9saWIvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBQ2hELE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImV4cG9ydCB7IEV2bVJwY1NjYW5uZXIgfSBmcm9tICcuL0V2bVJwY1NjYW5uZXInO1xuZXhwb3J0IHsgRXZtUnBjTmV0d29yayB9IGZyb20gJy4vRXZtUnBjTmV0d29yayc7XG4iXX0=

package/dist/types.d.ts

@@ -0,0 +1,4 @@
+export declare class BlockNotFound extends Error {
+    constructor(msg: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../lib/types.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,GAAG,EAAE,MAAM;CAGxB"}

package/dist/types.js

@@ -0,0 +1,6 @@
+export class BlockNotFound extends Error {
+    constructor(msg) {
+        super('BlockNotFound: ' + msg);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9saWIvdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsTUFBTSxPQUFPLGFBQWMsU0FBUSxLQUFLO0lBQ3RDLFlBQVksR0FBVztRQUNyQixLQUFLLENBQUMsaUJBQWlCLEdBQUcsR0FBRyxDQUFDLENBQUM7SUFDakMsQ0FBQztDQUNGIiwic291cmNlc0NvbnRlbnQiOlsiZXhwb3J0IGNsYXNzIEJsb2NrTm90Rm91bmQgZXh0ZW5kcyBFcnJvciB7XG4gIGNvbnN0cnVjdG9yKG1zZzogc3RyaW5nKSB7XG4gICAgc3VwZXIoJ0Jsb2NrTm90Rm91bmQ6ICcgKyBtc2cpO1xuICB9XG59XG4iXX0=

package/lib/EvmRpcNetwork.ts

@@ -0,0 +1,67 @@
+import {
+  AbstractNetworkConnector,
+  Block,
+} from '@rosen-bridge/scanner-interfaces';
+import { BlockNotFound } from './types';
+import { JsonRpcProvider, TransactionResponse } from 'ethers';
+
+export class EvmRpcNetwork extends AbstractNetworkConnector<TransactionResponse> {
+  protected readonly provider: JsonRpcProvider;
+
+  constructor(url: string, timeout?: number, authToken?: string) {
+    super();
+    this.provider = authToken
+      ? new JsonRpcProvider(`${url}/${authToken}`)
+      : new JsonRpcProvider(`${url}`);
+    if (timeout) {
+      this.provider._getConnection().timeout = timeout;
+    }
+  }
+
+  /**
+   * Returns block at height
+   * @param height
+   * @returns Block
+   */
+  getBlockAtHeight = (height: number): Promise<Block> => {
+    return this.provider.getBlock(height).then((block) => {
+      if (block == undefined) {
+        throw new BlockNotFound(`Block with height ${height} is not found.`);
+      }
+      if (block.hash == undefined) {
+        throw new Error('no block hash!');
+      }
+
+      return {
+        hash: block.hash,
+        height: block.number,
+        parentHash: block.parentHash,
+        timestamp: block.timestamp,
+        txCount: block.length,
+      };
+    });
+  };
+
+  /**
+   * Returns current network height
+   * @returns current height
+   */
+  getCurrentHeight = (): Promise<number> => {
+    return this.provider.getBlockNumber();
+  };
+
+  /**
+   * Return transactions in a block with specified hash
+   * @param blockHash
+   * @returns array of RpcTransaction
+   */
+  getBlockTxs = async (
+    blockHash: string
+  ): Promise<Array<TransactionResponse>> => {
+    const block = await this.provider.getBlock(blockHash, true);
+    if (block == undefined) {
+      throw new BlockNotFound(`Block with hash ${blockHash} is not found.`);
+    }
+    return block.prefetchedTransactions;
+  };
+}

package/lib/EvmRpcScanner.ts

@@ -0,0 +1,18 @@
+import { GeneralScanner, ScannerConfig } from '@rosen-bridge/abstract-scanner';
+import { TransactionResponse } from 'ethers';
+
+export class EvmRpcScanner extends GeneralScanner<TransactionResponse> {
+  readonly chain: string;
+
+  constructor(chain: string, config: ScannerConfig<TransactionResponse>) {
+    super(
+      `${chain}`,
+      config.dataSource,
+      config.initialHeight,
+      config.network,
+      config.blockRetrieveGap,
+      config.logger,
+      config.suffix
+    );
+  }
+}

package/lib/index.ts

@@ -0,0 +1,2 @@
+export { EvmRpcScanner } from './EvmRpcScanner';
+export { EvmRpcNetwork } from './EvmRpcNetwork';

package/lib/types.ts

@@ -0,0 +1,5 @@
+export class BlockNotFound extends Error {
+  constructor(msg: string) {
+    super('BlockNotFound: ' + msg);
+  }
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@rosen-bridge/evm-scanner",
+  "version": "0.1.0-52fc0239",
+  "description": "An EVM chain scanner based on RPC.",
+  "repository": "https://github.com/rosen-bridge/scanner",
+  "license": "MIT",
+  "author": "Rosen Team",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc --build tsconfig.build.json",
+    "coverage": "npm run test -- --coverage",
+    "lint": "eslint --fix . && npm run prettify",
+    "prettify": "prettier --write . --ignore-path ./.gitignore",
+    "release": "npm run build && npm publish --access public",
+    "test": "NODE_OPTIONS=--loader=extensionless vitest",
+    "type-check": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "^22.18.0",
+    "@vitest/coverage-istanbul": "^1.2.2",
+    "extensionless": "^1.9.6",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.2"
+  },
+  "dependencies": {
+    "@rosen-bridge/abstract-scanner": "^0.1.0-52fc0239",
+    "@rosen-bridge/scanner-interfaces": "^0.1.1-52fc0239",
+    "ethers": "6.13.2"
+  },
+  "engines": {
+    "node": ">=22.18.0"
+  }
+}

package/tests/EvmRpcNetwork.spec.ts

@@ -0,0 +1,141 @@
+import { Transaction } from 'ethers';
+import * as testData from './testData';
+import { TestEvmRpcNetwork } from './TestRpcNetwork';
+import {
+  mockGetBlockNumber,
+  mockGetBlock,
+  resetRpcMock,
+} from './mocked/JsonRpcProvider.mock';
+import { BlockNotFound } from '../lib/types';
+
+describe('EvmRpcNetwork', () => {
+  let network: TestEvmRpcNetwork;
+
+  beforeEach(() => {
+    resetRpcMock();
+    network = new TestEvmRpcNetwork('', 1);
+  });
+
+  describe('getCurrentHeight', () => {
+    /**
+     * @target `EvmRpcNetwork.getHeight` should return block height successfully
+     * @dependencies
+     * @scenario
+     * - mock `RPC.getBlockNumber`
+     * - run test
+     * - check returned value
+     * @expected
+     * - it should be mocked block height
+     */
+    it('should return block height successfully', async () => {
+      // mock client response
+      mockGetBlockNumber(network.getProvider());
+
+      // run test
+      const result = await network.getCurrentHeight();
+
+      // check returned value
+      expect(result).toEqual(testData.blockHeight);
+    });
+  });
+
+  describe('getBlockTxs', () => {
+    /**
+     * @target `EvmRpcNetwork.getBlockTxs` should return
+     * transactions of the block
+     * @dependencies
+     * @scenario
+     * - mock `RPC.getBlock` with prefetchTxs `true`
+     * - run test
+     * - check returned value
+     * @expected
+     * - it should return transactions of the block
+     */
+    it('should return transactions of the block', async () => {
+      // mock client response
+      mockGetBlock(network.getProvider(), testData.blockInfo);
+
+      // run test
+      const result = await network.getBlockTxs(testData.blockHash);
+
+      // check returned value
+      for (let i = 0; i < result.length; i++) {
+        const trx = Transaction.from(result[i]);
+        expect(trx.toJSON()).toEqual(testData.convertedTxList[i]);
+      }
+    });
+
+    /**
+     * @target `EvmRpcNetwork.getBlockTxs` should throw
+     * error if block can not be found.
+     * @dependencies
+     * @scenario
+     * - mock `RPC.getBlock` with prefetchTxs `true`
+     * - run test
+     * - call the function and expect error
+     * @expected
+     * - getBlockTxs should throw BlockNotFound
+     */
+    it('should throw BlockNotFound', async () => {
+      // mock client response
+      mockGetBlock(network.getProvider(), null);
+
+      // run test
+      const result = network.getBlockTxs(testData.blockHash);
+
+      // check returned value
+      expect(result).rejects.toThrowError(BlockNotFound);
+    });
+  });
+
+  describe('getBlockAtHeight', () => {
+    /**
+     * @target `EvmRpcNetwork.getBlockInfo` should return block info
+     * @dependencies
+     * @scenario
+     * - mock `RPC.getBlock`
+     * - run test
+     * - check returned value
+     * @expected
+     * - it should return block info successfully
+     */
+    it('should return block info successfully', async () => {
+      // mock client response
+      mockGetBlock(network.getProvider(), testData.blockInfo);
+
+      // run test
+      const result = await network.getBlockAtHeight(testData.blockHeight);
+
+      // check returned value
+      expect(result).toEqual({
+        hash: testData.blockInfo.hash,
+        height: testData.blockInfo.number,
+        parentHash: testData.blockInfo.parentHash,
+        timestamp: testData.blockInfo.timestamp,
+        txCount: testData.blockInfo.length,
+      });
+    });
+
+    /**
+     * @target `EvmRpcNetwork.getBlockAtHeight` should throw
+     * error when block height is wrong
+     * @dependencies
+     * @scenario
+     * - mock `RPC.getBlock`
+     * - run test
+     * - call the function and expect error
+     * @expected
+     * - getBlockAtHeight should throw BlockNotFound
+     */
+    it('should throw error when block height is wrong', async () => {
+      // mock client response
+      mockGetBlock(network.getProvider(), null);
+
+      // run test
+      const result = network.getBlockAtHeight(testData.wrongBlockHeight);
+
+      // check returned value
+      expect(result).rejects.toThrow(BlockNotFound);
+    });
+  });
+});

package/tests/TestRpcNetwork.ts

@@ -0,0 +1,5 @@
+import { EvmRpcNetwork } from '../lib/EvmRpcNetwork';
+
+export class TestEvmRpcNetwork extends EvmRpcNetwork {
+  getProvider = () => this.provider;
+}

package/tests/mocked/JsonRpcProvider.mock.ts

@@ -0,0 +1,47 @@
+import { vi } from 'vitest';
+import { Block, JsonRpcProvider } from 'ethers';
+import * as testData from '../testData';
+
+vi.mock('ethers', () => {
+  return {
+    JsonRpcProvider: vi.fn().mockImplementation(() => {
+      return rpcInstance;
+    }),
+  };
+});
+
+export const rpcInstance = {
+  getBlock: vi.fn(),
+  getBlockNumber: vi.fn(),
+  _getConnection: () => {
+    return {
+      timeout: 0,
+    };
+  },
+};
+
+/**
+ * resets rpc functions mocks and call counts
+ */
+export const resetRpcMock = () => {
+  rpcInstance.getBlock.mockReset();
+  rpcInstance.getBlockNumber.mockReset();
+};
+
+/**
+ * mocks `getBlock` function of the provider to return value
+ * @param provider
+ */
+export const mockGetBlock = (provider: JsonRpcProvider, data: Block | null) => {
+  vi.spyOn(provider, 'getBlock').mockResolvedValue(data);
+};
+
+/**
+ * mocks `getBlockNumber` function of the provider to return value
+ * @param provider
+ */
+export const mockGetBlockNumber = (provider: JsonRpcProvider) => {
+  vi.spyOn(provider, 'getBlockNumber').mockResolvedValue(
+    testData.blockInfo.number
+  );
+};