@hyperlane-xyz/sdk 16.0.0 → 16.1.0

package/dist/rpc/evm/EvmEventLogsReader.hardhat-test.js

@@ -0,0 +1,279 @@
+import chai, { expect } from 'chai';
+import chaiAsPromised from 'chai-as-promised';
+import { ethers } from 'ethers';
+import hre from 'hardhat';
+import { ERC20Test__factory } from '@hyperlane-xyz/core';
+import { assert } from '@hyperlane-xyz/utils';
+import { KNOWN_BASE_TIMELOCK_CONTRACT, TestChainName, baseTestChain, } from '../../consts/testChains.js';
+import { MultiProvider } from '../../providers/MultiProvider.js';
+import { randomAddress, randomInt } from '../../test/testUtils.js';
+import { EvmEtherscanLikeEventLogsReader, EvmEventLogsReader, EvmRpcEventLogsReader, } from './EvmEventLogsReader.js';
+chai.use(chaiAsPromised);
+describe('EvmEventLogsReader', () => {
+    let contractOwner;
+    let tokenRecipient1;
+    let tokenRecipient2;
+    let providerChainTest1;
+    let multiProvider;
+    let testContract;
+    let erc20Factory;
+    let deploymentBlockNumber;
+    const transferTopic = ethers.utils.id('Transfer(address,address,uint256)');
+    beforeEach(async () => {
+        [contractOwner, tokenRecipient1, tokenRecipient2] =
+            await hre.ethers.getSigners();
+        assert(contractOwner.provider, 'Provider should be available');
+        // Initialize MultiProvider with test chain
+        multiProvider = MultiProvider.createTestMultiProvider({
+            signer: contractOwner,
+            provider: contractOwner.provider,
+        });
+        providerChainTest1 = contractOwner.provider;
+        // Get contract factory for ERC20Test
+        erc20Factory = new ERC20Test__factory(contractOwner);
+    });
+    async function deployTestErc20() {
+        testContract = await erc20Factory.deploy('TestToken', 'TST', ethers.utils.parseEther('1000000'), 18);
+        await testContract.deployed();
+        assert(testContract.deployTransaction.blockNumber, 'Expected the Contract deployment block number to be defined');
+        deploymentBlockNumber = testContract.deployTransaction.blockNumber;
+    }
+    async function mineRandomNumberOfBlocks() {
+        const blocksToMine = randomInt(5, 20);
+        for (let blockNum = 0; blockNum < blocksToMine; blockNum++) {
+            await providerChainTest1.send('evm_mine', []);
+        }
+    }
+    describe('constructor', () => {
+        it('should initialize with BlockExplorer strategy when useRPC is false', async () => {
+            const readerWithRpc = EvmEventLogsReader.fromConfig({
+                chain: TestChainName.test1,
+            }, multiProvider);
+            // Access the private property indirectly
+            expect(readerWithRpc['logReaderStrategy']).to.be.instanceOf(EvmEtherscanLikeEventLogsReader);
+        });
+        it('should initialize with RPC strategy when useRPC is true', async () => {
+            const readerWithRpc = EvmEventLogsReader.fromConfig({
+                chain: TestChainName.test1,
+                useRPC: true,
+            }, multiProvider);
+            // Access the private property indirectly
+            expect(readerWithRpc['logReaderStrategy']).to.be.instanceOf(EvmRpcEventLogsReader);
+        });
+        it('should initialize with RPC strategy when no explorer is available', async () => {
+            const multiProviderNoExplorer = new MultiProvider({});
+            multiProviderNoExplorer.setSharedSigner(contractOwner);
+            const reader = EvmEventLogsReader.fromConfig({
+                chain: TestChainName.test1,
+                // Even when false, should use RPC if no explorer
+                useRPC: false,
+            }, multiProviderNoExplorer);
+            // Access the private property indirectly
+            expect(reader['logReaderStrategy']).to.be.instanceOf(EvmRpcEventLogsReader);
+        });
+    });
+    describe(`${EvmEventLogsReader.prototype.getLogsByTopic.name} (rpc)`, () => {
+        let reader;
+        beforeEach(async () => {
+            await deployTestErc20();
+            reader = EvmEventLogsReader.fromConfig({
+                chain: TestChainName.test1,
+                useRPC: true,
+                paginationBlockRange: 1000,
+            }, multiProvider);
+        });
+        it('should retrieve logs for Transfer events emitted by the contract', async () => {
+            // Emit some Transfer events
+            const tx1 = await testContract.transfer(tokenRecipient1.address, ethers.utils.parseEther('100'));
+            await tx1.wait();
+            const tx2 = await testContract.transfer(tokenRecipient2.address, ethers.utils.parseEther('200'));
+            await tx2.wait();
+            const logs = await reader.getLogsByTopic({
+                eventTopic: transferTopic,
+                contractAddress: testContract.address,
+                fromBlock: deploymentBlockNumber,
+            });
+            // Should have 3 transfer events: 1 from constructor mint + 2 from transfers
+            expect(logs).to.have.length(3);
+            logs.forEach((log) => {
+                expect(log.address).to.equal(testContract.address);
+                expect(log.topics[0]).to.equal(transferTopic);
+            });
+        });
+        it('should work when fromBlock is not specified (uses deployment block)', async () => {
+            // Emit Transfer event
+            const tx = await testContract.transfer(tokenRecipient1.address, ethers.utils.parseEther('100'));
+            await tx.wait();
+            const logs = await reader.getLogsByTopic({
+                eventTopic: transferTopic,
+                contractAddress: testContract.address,
+            });
+            // Should have 2 transfer events: 1 from constructor mint + 1 from transfer
+            expect(logs).to.have.length(2);
+            logs.forEach((log) => {
+                expect(log.address).to.equal(testContract.address);
+                expect(log.topics[0]).to.equal(transferTopic);
+            });
+        });
+        it('should work when toBlock is not specified (uses current block)', async () => {
+            // Emit Transfer event
+            const tx = await testContract.transfer(tokenRecipient1.address, ethers.utils.parseEther('100'));
+            await tx.wait();
+            const logs = await reader.getLogsByTopic({
+                eventTopic: transferTopic,
+                contractAddress: testContract.address,
+                fromBlock: deploymentBlockNumber,
+                // No toBlock specified
+            });
+            // Should have 2 transfer events: 1 from constructor mint + 1 from transfer
+            expect(logs).to.have.length(2);
+            logs.forEach((log) => {
+                expect(log.address).to.equal(testContract.address);
+                expect(log.topics[0]).to.equal(transferTopic);
+            });
+        });
+        it('should work when both fromBlock and toBlock are specified', async () => {
+            await mineRandomNumberOfBlocks();
+            const startBlock = await providerChainTest1.getBlockNumber();
+            // Emit event in first block
+            const tx1 = await testContract.transfer(tokenRecipient1.address, ethers.utils.parseEther('100'));
+            await tx1.wait();
+            const firstEventBlock = await providerChainTest1.getBlockNumber();
+            await mineRandomNumberOfBlocks();
+            // Emit event in later block
+            const tx2 = await testContract.transfer(tokenRecipient1.address, ethers.utils.parseEther('200'));
+            await tx2.wait();
+            // Query only the first event's block range
+            const logs = await reader.getLogsByTopic({
+                eventTopic: transferTopic,
+                contractAddress: testContract.address,
+                fromBlock: startBlock,
+                toBlock: firstEventBlock,
+            });
+            expect(logs).to.have.length(1);
+            expect(logs[0].blockNumber).to.equal(firstEventBlock);
+            expect(logs[0].address).to.equal(testContract.address);
+            expect(logs[0].topics[0]).to.equal(transferTopic);
+        });
+        it('should return empty array when no logs match the filter', async () => {
+            // Emit an event just to be sure that filtering works as expected
+            const tx = await testContract.transfer(tokenRecipient1.address, ethers.utils.parseEther('100'));
+            await tx.wait();
+            const nonExistentTopic = ethers.utils.id('NonExistentEvent(uint256)');
+            const logs = await reader.getLogsByTopic({
+                eventTopic: nonExistentTopic,
+                contractAddress: testContract.address,
+                fromBlock: deploymentBlockNumber,
+            });
+            expect(logs).to.have.length(0);
+        });
+        it('should handle multiple events across different blocks', async () => {
+            const numberOfEventsToEmit = randomInt(3, 10);
+            const eventBlocks = [];
+            for (let i = 0; i < numberOfEventsToEmit; i++) {
+                const tx = await testContract.mint(ethers.utils.parseEther(`${(i + 1) * 50}`));
+                await tx.wait();
+                eventBlocks.push(await providerChainTest1.getBlockNumber());
+                // Mine a few blocks between events
+                await mineRandomNumberOfBlocks();
+            }
+            // +1 because of the transfer event emitted on contract deployment
+            const expectedNumberOfEvents = numberOfEventsToEmit + 1;
+            const logs = await reader.getLogsByTopic({
+                eventTopic: transferTopic,
+                contractAddress: testContract.address,
+                fromBlock: deploymentBlockNumber,
+            });
+            expect(logs).to.have.length(expectedNumberOfEvents);
+            // Verify all logs are from the correct contract and have the right topic
+            logs.forEach((log) => {
+                expect(log.address).to.equal(testContract.address);
+                expect(log.topics[0]).to.equal(transferTopic);
+            });
+        });
+        it('should work with small logPageSize (testing chunking)', async () => {
+            const readerWithSmallPageSize = EvmEventLogsReader.fromConfig({
+                chain: TestChainName.test1,
+                useRPC: true,
+                paginationBlockRange: 2,
+            }, multiProvider);
+            const numberOfEventsToEmit = 5;
+            for (let i = 0; i < numberOfEventsToEmit; i++) {
+                const tx = await testContract.mint(ethers.utils.parseEther(`${(i + 1) * 100}`));
+                await tx.wait();
+            }
+            // +1 because of the transfer event emitted on contract deployment
+            const expectedNumberOfEvents = numberOfEventsToEmit + 1;
+            const logs = await readerWithSmallPageSize.getLogsByTopic({
+                eventTopic: transferTopic,
+                contractAddress: testContract.address,
+                fromBlock: deploymentBlockNumber,
+            });
+            expect(logs).to.have.length(expectedNumberOfEvents);
+        });
+        it('should throw an error for non-existing contract address', async () => {
+            const nonExistentAddress = randomAddress();
+            await expect(reader.getLogsByTopic({
+                eventTopic: transferTopic,
+                contractAddress: nonExistentAddress,
+                fromBlock: deploymentBlockNumber,
+            })).to.be.rejected;
+        });
+        it('should handle edge case where fromBlock equals toBlock', async () => {
+            // Emit event
+            const tx = await testContract.transfer(tokenRecipient1.address, ethers.utils.parseEther('100'));
+            await tx.wait();
+            const eventBlock = await providerChainTest1.getBlockNumber();
+            const logs = await reader.getLogsByTopic({
+                eventTopic: transferTopic,
+                contractAddress: testContract.address,
+                fromBlock: eventBlock,
+                toBlock: eventBlock,
+            });
+            expect(logs).to.have.length(1);
+            expect(logs[0].blockNumber).to.equal(eventBlock);
+        });
+    });
+    describe(`${EvmEventLogsReader.prototype.getLogsByTopic.name} (block explorer)`, () => {
+        let reader;
+        let multiProvider;
+        beforeEach(async () => {
+            await deployTestErc20();
+            multiProvider = new MultiProvider({
+                base: baseTestChain,
+            });
+            reader = EvmEventLogsReader.fromConfig({
+                chain: baseTestChain.name,
+            }, multiProvider);
+        });
+        it('should get the expected number of events when fromBlock is not provided', async () => {
+            const res = await reader.getLogsByTopic({
+                contractAddress: KNOWN_BASE_TIMELOCK_CONTRACT,
+                // CallExecuted signature
+                eventTopic: '0xc2617efa69bab66782fa219543714338489c4e9e178271560a91b82c3f612b58',
+                // Omitting from block to test getting contract deployment block from explorer
+                toBlock: 32986242,
+            });
+            expect(res.length).to.equal(5);
+        });
+    });
+    describe('error handling', () => {
+        let reader;
+        beforeEach(async () => {
+            await deployTestErc20();
+            reader = EvmEventLogsReader.fromConfig({
+                chain: TestChainName.test1,
+                useRPC: true,
+            }, multiProvider);
+        });
+        it('should not allow invalid topic signatures', async () => {
+            const invalidTopic = 'invalid-topic';
+            expect(reader.getLogsByTopic({
+                eventTopic: invalidTopic,
+                contractAddress: testContract.address,
+                fromBlock: deploymentBlockNumber,
+            })).to.be.rejectedWith();
+        });
+    });
+});
+//# sourceMappingURL=EvmEventLogsReader.hardhat-test.js.map

package/dist/rpc/evm/EvmEventLogsReader.hardhat-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvmEventLogsReader.hardhat-test.js","sourceRoot":"","sources":["../../../src/rpc/evm/EvmEventLogsReader.hardhat-test.ts"],"names":[],"mappings":"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"}

package/dist/rpc/evm/EvmEventLogsReader.js

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import { rootLogger } from '@hyperlane-xyz/utils';
+import { getContractDeploymentTransaction, getLogsFromEtherscanLikeExplorerAPI, } from '../../block-explorer/etherscan.js';
+import { assertIsContractAddress } from '../../contracts/contracts.js';
+import { ZBytes32String, ZHash, ZUint } from '../../metadata/customZodTypes.js';
+import { getContractCreationBlockFromRpc, getLogsFromRpc } from './utils.js';
+export const GetLogByTopicOptionsSchema = z.object({
+    eventTopic: ZBytes32String,
+    contractAddress: ZHash,
+    fromBlock: ZUint.optional(),
+    toBlock: ZUint.optional(),
+});
+export const RequiredGetLogByTopicOptionsSchema = GetLogByTopicOptionsSchema.required();
+export class EvmEtherscanLikeEventLogsReader {
+    chain;
+    config;
+    multiProvider;
+    constructor(chain, config, multiProvider) {
+        this.chain = chain;
+        this.config = config;
+        this.multiProvider = multiProvider;
+    }
+    async getContractDeploymentBlockNumber(address) {
+        const contractDeploymentTx = await getContractDeploymentTransaction({ apiUrl: this.config.apiUrl, apiKey: this.config.apiKey }, { contractAddress: address });
+        const deploymentTransactionReceipt = await this.multiProvider
+            .getProvider(this.chain)
+            .getTransactionReceipt(contractDeploymentTx.txHash);
+        return deploymentTransactionReceipt.blockNumber;
+    }
+    async getContractLogs(options) {
+        const parsedOptions = RequiredGetLogByTopicOptionsSchema.parse(options);
+        return getLogsFromEtherscanLikeExplorerAPI({
+            apiUrl: this.config.apiUrl,
+            apiKey: this.config.apiKey,
+        }, {
+            address: parsedOptions.contractAddress,
+            fromBlock: parsedOptions.fromBlock,
+            toBlock: parsedOptions.toBlock,
+            topic0: parsedOptions.eventTopic,
+        });
+    }
+}
+export class EvmRpcEventLogsReader {
+    chain;
+    config;
+    multiProvider;
+    constructor(chain, config, multiProvider) {
+        this.chain = chain;
+        this.config = config;
+        this.multiProvider = multiProvider;
+    }
+    getContractDeploymentBlockNumber(address) {
+        return getContractCreationBlockFromRpc(this.chain, address, this.multiProvider);
+    }
+    getContractLogs(options) {
+        const parsedOptions = RequiredGetLogByTopicOptionsSchema.parse(options);
+        return getLogsFromRpc({
+            chain: this.chain,
+            contractAddress: parsedOptions.contractAddress,
+            topic: parsedOptions.eventTopic,
+            fromBlock: parsedOptions.fromBlock,
+            toBlock: parsedOptions.toBlock,
+            multiProvider: this.multiProvider,
+            range: this.config.paginationBlockRange,
+        });
+    }
+}
+export class EvmEventLogsReader {
+    config;
+    multiProvider;
+    logReaderStrategy;
+    logger;
+    constructor(config, multiProvider, logReaderStrategy, logger) {
+        this.config = config;
+        this.multiProvider = multiProvider;
+        this.logReaderStrategy = logReaderStrategy;
+        this.logger = logger;
+    }
+    static fromConfig(config, multiProvider, logger = rootLogger.child({
+        module: EvmEventLogsReader.name,
+    })) {
+        const explorer = multiProvider.tryGetEvmExplorerMetadata(config.chain);
+        let logReaderStrategy;
+        if (explorer && !config.useRPC) {
+            logReaderStrategy = new EvmEtherscanLikeEventLogsReader(config.chain, explorer, multiProvider);
+        }
+        else {
+            logReaderStrategy = new EvmRpcEventLogsReader(config.chain, { paginationBlockRange: config.paginationBlockRange }, multiProvider);
+        }
+        return new EvmEventLogsReader(config, multiProvider, logReaderStrategy, logger);
+    }
+    async getLogsByTopic(options) {
+        const parsedOptions = GetLogByTopicOptionsSchema.parse(options);
+        const provider = this.multiProvider.getProvider(this.config.chain);
+        await assertIsContractAddress(this.multiProvider, this.config.chain, options.contractAddress);
+        const fromBlock = parsedOptions.fromBlock ??
+            (await this.logReaderStrategy.getContractDeploymentBlockNumber(parsedOptions.contractAddress));
+        const toBlock = parsedOptions.toBlock ?? (await provider.getBlockNumber());
+        return this.logReaderStrategy.getContractLogs({
+            contractAddress: parsedOptions.contractAddress,
+            eventTopic: parsedOptions.eventTopic,
+            fromBlock,
+            toBlock,
+        });
+    }
+}
+//# sourceMappingURL=EvmEventLogsReader.js.map

package/dist/rpc/evm/EvmEventLogsReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvmEventLogsReader.js","sourceRoot":"","sources":["../../../src/rpc/evm/EvmEventLogsReader.ts"],"names":[],"mappings":"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"}

package/dist/rpc/evm/types.d.ts

@@ -0,0 +1,11 @@
+import { Address, HexString } from '@hyperlane-xyz/utils';
+export type GetEventLogsResponse = {
+    address: Address;
+    blockNumber: number;
+    data: HexString;
+    logIndex: number;
+    topics: ReadonlyArray<HexString>;
+    transactionHash: HexString;
+    transactionIndex: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/rpc/evm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/rpc/evm/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACjC,eAAe,EAAE,SAAS,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC"}

package/dist/rpc/evm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/rpc/evm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/rpc/evm/types.ts"],"names":[],"mappings":""}

package/dist/rpc/evm/utils.d.ts

@@ -0,0 +1,18 @@
+import { Log } from 'viem';
+import { Address } from '@hyperlane-xyz/utils';
+import { MultiProvider } from '../../providers/MultiProvider.js';
+import { ChainNameOrId } from '../../types.js';
+import { GetEventLogsResponse } from './types.js';
+export declare function getContractCreationBlockFromRpc(chain: ChainNameOrId, contractAddress: Address, multiProvider: MultiProvider): Promise<number>;
+export type GetLogsFromRpcOptions = {
+    chain: ChainNameOrId;
+    contractAddress: Address;
+    multiProvider: MultiProvider;
+    fromBlock: number;
+    topic: string;
+    toBlock?: number;
+    range?: number;
+};
+export declare function getLogsFromRpc({ chain, contractAddress, multiProvider, fromBlock, topic, toBlock, range, }: GetLogsFromRpcOptions): Promise<GetEventLogsResponse[]>;
+export declare function viemLogFromGetEventLogsResponse(log: GetEventLogsResponse): Log;
+//# sourceMappingURL=utils.d.ts.map

package/dist/rpc/evm/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/rpc/evm/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,GAAG,EAAE,MAAM,MAAM,CAAC;AAEhC,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAM/C,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,aAAa,EACpB,eAAe,EAAE,OAAO,EACxB,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,aAAa,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,cAAc,CAAC,EACnC,KAAK,EACL,eAAe,EACf,aAAa,EACb,SAAS,EACT,KAAK,EACL,OAAO,EACP,KAAW,GACZ,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAoCzD;AAED,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,oBAAoB,GACxB,GAAG,CAYL"}

package/dist/rpc/evm/utils.hardhat-test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=utils.hardhat-test.d.ts.map

package/dist/rpc/evm/utils.hardhat-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.hardhat-test.d.ts","sourceRoot":"","sources":["../../../src/rpc/evm/utils.hardhat-test.ts"],"names":[],"mappings":""}

package/dist/rpc/evm/utils.hardhat-test.js

@@ -0,0 +1,144 @@
+import chai, { expect } from 'chai';
+import chaiAsPromised from 'chai-as-promised';
+import { ethers } from 'ethers';
+import hre from 'hardhat';
+import { ERC20Test__factory } from '@hyperlane-xyz/core';
+import { assert } from '@hyperlane-xyz/utils';
+import { TestChainName } from '../../consts/testChains.js';
+import { MultiProvider } from '../../providers/MultiProvider.js';
+import { randomAddress, randomInt } from '../../test/testUtils.js';
+import { getContractCreationBlockFromRpc, getLogsFromRpc } from './utils.js';
+chai.use(chaiAsPromised);
+describe('RPC Utils', () => {
+    let contractOwner;
+    let tokenRecipient1;
+    let tokenRecipient2;
+    let providerChainTest1;
+    let multiProvider;
+    let testContract;
+    let erc20Factory;
+    let deploymentBlockNumber;
+    const transferTopic = ethers.utils.id('Transfer(address,address,uint256)');
+    beforeEach(async () => {
+        [contractOwner, tokenRecipient1, tokenRecipient2] =
+            await hre.ethers.getSigners();
+        assert(contractOwner.provider, 'Expected provider to be defined on the signer');
+        // Initialize MultiProvider with test chain
+        multiProvider = MultiProvider.createTestMultiProvider({
+            signer: contractOwner,
+            provider: contractOwner.provider,
+        });
+        providerChainTest1 = contractOwner.provider;
+        // Get contract factory for ERC20Test
+        erc20Factory = new ERC20Test__factory(contractOwner);
+    });
+    async function deployTestErc20() {
+        testContract = await erc20Factory.deploy('TestToken', 'TST', ethers.utils.parseEther('1000000'), 18);
+        await testContract.deployed();
+        assert(testContract.deployTransaction.blockNumber, 'Expected the Contract deployment block number to be defined');
+        deploymentBlockNumber = testContract.deployTransaction.blockNumber;
+    }
+    async function mineRandomNumberOfBlocks() {
+        const blocksToMine = randomInt(69, 420);
+        for (let blockNum = 0; blockNum < blocksToMine; blockNum++) {
+            await providerChainTest1.send('evm_mine', []);
+        }
+    }
+    describe(getContractCreationBlockFromRpc.name, () => {
+        it('should find the correct deployment block for a deployed contract', async () => {
+            await mineRandomNumberOfBlocks();
+            await deployTestErc20();
+            await mineRandomNumberOfBlocks();
+            const foundBlock = await getContractCreationBlockFromRpc(TestChainName.test1, testContract.address, multiProvider);
+            expect(foundBlock).to.equal(deploymentBlockNumber);
+            const contractCode = await providerChainTest1.getCode(testContract.address);
+            expect(contractCode).not.to.equal('0x');
+        });
+        it('should throw an error for non-existing contract address', async () => {
+            const nonExistentAddress = randomAddress();
+            await expect(getContractCreationBlockFromRpc(TestChainName.test1, nonExistentAddress, multiProvider)).to.be.rejectedWith(`Address "${nonExistentAddress}" on chain "${TestChainName.test1}" is not a contract`);
+        });
+    });
+    describe(getLogsFromRpc.name, () => {
+        beforeEach(async () => {
+            await deployTestErc20();
+        });
+        it('should retrieve logs for Transfer events emitted by the contract', async () => {
+            // Emit some Transfer events
+            const tx1 = await testContract.transfer(tokenRecipient1.address, ethers.utils.parseEther('100'));
+            await tx1.wait();
+            const tx2 = await testContract.transfer(tokenRecipient2.address, ethers.utils.parseEther('200'));
+            await tx2.wait();
+            const logs = await getLogsFromRpc({
+                chain: TestChainName.test1,
+                contractAddress: testContract.address,
+                multiProvider,
+                fromBlock: deploymentBlockNumber,
+                topic: transferTopic,
+            });
+            // Should have 3 transfer events: 1 from constructor mint + 2 from transfers
+            expect(logs).to.have.length(3);
+            logs.forEach((log) => {
+                expect(log.address).to.equal(testContract.address);
+                expect(log.topics[0]).to.equal(transferTopic);
+            });
+        });
+        it('should work when fromBlock and toBlock are provided', async () => {
+            await mineRandomNumberOfBlocks();
+            const startBlock = await providerChainTest1.getBlockNumber();
+            // Emit event in first block
+            const tx1 = await testContract.transfer(tokenRecipient1.address, ethers.utils.parseEther('100'));
+            await tx1.wait();
+            const firstEventBlock = await providerChainTest1.getBlockNumber();
+            await mineRandomNumberOfBlocks();
+            // Emit event in later block
+            const tx2 = await testContract.transfer(tokenRecipient1.address, ethers.utils.parseEther('200'));
+            await tx2.wait();
+            // Query only the first event's block range
+            const logs = await getLogsFromRpc({
+                chain: TestChainName.test1,
+                contractAddress: testContract.address,
+                multiProvider,
+                fromBlock: startBlock,
+                toBlock: firstEventBlock,
+                topic: transferTopic,
+            });
+            expect(logs).to.have.length(1);
+            expect(logs[0].blockNumber).to.equal(firstEventBlock);
+        });
+        it('should work when a custom range parameter is provided', async () => {
+            const numberOfEventsToEmit = randomInt(1, 47);
+            for (let i = 0; i < numberOfEventsToEmit; i++) {
+                const tx = await testContract.mint(ethers.utils.parseEther(`${(i + 1) * 100}`));
+                await tx.wait();
+            }
+            // +1 because of the transfer event emitted on contract deployment
+            const expectedNumberOfEvents = numberOfEventsToEmit + 1;
+            const logs = await getLogsFromRpc({
+                chain: TestChainName.test1,
+                contractAddress: testContract.address,
+                multiProvider,
+                fromBlock: deploymentBlockNumber,
+                topic: transferTopic,
+                // Small range to test chunking
+                range: 2,
+            });
+            expect(logs).to.have.length(expectedNumberOfEvents);
+        });
+        it('should return empty array when no logs match the criteria', async () => {
+            // Emitting an event just to be sure that filtering works as expected
+            const tx1 = await testContract.transfer(tokenRecipient1.address, ethers.utils.parseEther('100'));
+            await tx1.wait();
+            const nonExistentTopic = ethers.utils.id('NonExistentEvent(uint256)');
+            const logs = await getLogsFromRpc({
+                chain: TestChainName.test1,
+                contractAddress: testContract.address,
+                multiProvider,
+                fromBlock: deploymentBlockNumber,
+                topic: nonExistentTopic,
+            });
+            expect(logs).to.have.length(0);
+        });
+    });
+});
+//# sourceMappingURL=utils.hardhat-test.js.map

package/dist/rpc/evm/utils.hardhat-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.hardhat-test.js","sourceRoot":"","sources":["../../../src/rpc/evm/utils.hardhat-test.ts"],"names":[],"mappings":"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"}