@0xtorch/evm 0.0.8 → 0.0.9

package/_types/explorers/types.d.ts

@@ -5,8 +5,11 @@ export type Explorer = {
     readonly url: string;
     readonly apiUrl: string;
     readonly getAddressTransactionHashes: FunctionGetAddressTransactionHashes;
+    readonly getAddressTransactionHashesWithTimestamp: FunctionGetAddressTransactionHashesWithTimestamp;
     readonly getAddressInternalTransactions: FunctionGetAddressInternalTransactions;
+    readonly getAddressInternalTransactionsWithTimestamp: FunctionGetAddressInternalTransactionsWithTimestamp;
     readonly getAddressTokenTransferHashes: FunctionGetAddressTokenTransferHashes;
+    readonly getAddressTokenTransferHashesWithTimestamp: FunctionGetAddressTokenTransferHashesWithTimestamp;
     readonly getBlockNumberOfTimestamp: (timestamp: number, logger?: Logger) => Promise<bigint>;
     readonly getContract: FunctionGetContract;
     readonly getInternalTransactionOfTransaction: FunctionGetInternalTransactionOfTransaction;
@@ -17,6 +20,15 @@ type FunctionGetAddressTransactionHashes = (parameters: {
     readonly endBlock?: bigint;
     readonly logger?: Logger;
 }) => Promise<readonly Hex[]>;
+type FunctionGetAddressTransactionHashesWithTimestamp = (parameters: {
+    readonly address: Hex;
+    readonly startBlock?: bigint;
+    readonly endBlock?: bigint;
+    readonly logger?: Logger;
+}) => Promise<readonly {
+    readonly hash: Hex;
+    readonly timestamp: number;
+}[]>;
 type FunctionGetAddressInternalTransactions = (parameters: {
     readonly address: Hex;
     readonly startBlock?: bigint;
@@ -24,12 +36,30 @@ type FunctionGetAddressInternalTransactions = (parameters: {
     readonly nativeCurrency: CryptoCurrency;
     readonly logger?: Logger;
 }) => Promise<readonly InternalTransaction<undefined>[]>;
+type FunctionGetAddressInternalTransactionsWithTimestamp = (parameters: {
+    readonly address: Hex;
+    readonly startBlock?: bigint;
+    readonly endBlock?: bigint;
+    readonly nativeCurrency: CryptoCurrency;
+    readonly logger?: Logger;
+}) => Promise<readonly (InternalTransaction<undefined> & {
+    readonly timestamp: number;
+})[]>;
 type FunctionGetAddressTokenTransferHashes = (parameters: {
     readonly address: Hex;
     readonly startBlock?: bigint;
     readonly endBlock?: bigint;
     readonly logger?: Logger;
 }) => Promise<readonly Hex[]>;
+type FunctionGetAddressTokenTransferHashesWithTimestamp = (parameters: {
+    readonly address: Hex;
+    readonly startBlock?: bigint;
+    readonly endBlock?: bigint;
+    readonly logger?: Logger;
+}) => Promise<readonly {
+    readonly hash: Hex;
+    readonly timestamp: number;
+}[]>;
 type FunctionGetContract = (address: Hex, logger?: Logger) => Promise<{
     readonly name: string;
     readonly abi: string;

package/_types/explorers/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../explorers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,KAAK,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAExD,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,2BAA2B,EAAE,mCAAmC,CAAA;IACzE,QAAQ,CAAC,8BAA8B,EAAE,sCAAsC,CAAA;IAC/E,QAAQ,CAAC,6BAA6B,EAAE,qCAAqC,CAAA;IAC7E,QAAQ,CAAC,yBAAyB,EAAE,CAClC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,KACZ,OAAO,CAAC,MAAM,CAAC,CAAA;IACpB,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAA;IACzC,QAAQ,CAAC,mCAAmC,EAAE,2CAA2C,CAAA;CAC1F,CAAA;AAED,KAAK,mCAAmC,GAAG,CAAC,UAAU,EAAE;IACtD,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,KAAK,OAAO,CAAC,SAAS,GAAG,EAAE,CAAC,CAAA;AAE7B,KAAK,sCAAsC,GAAG,CAAC,UAAU,EAAE;IACzD,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,KAAK,OAAO,CAAC,SAAS,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;AAExD,KAAK,qCAAqC,GAAG,CAAC,UAAU,EAAE;IACxD,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,KAAK,OAAO,CAAC,SAAS,GAAG,EAAE,CAAC,CAAA;AAE7B,KAAK,mBAAmB,GAAG,CACzB,OAAO,EAAE,GAAG,EACZ,MAAM,CAAC,EAAE,MAAM,KACZ,OAAO,CACR;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB,GACD,SAAS,CACZ,CAAA;AAED,KAAK,2CAA2C,GAAG,CAAC,UAAU,EAAE;IAC9D,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAA;IAClB,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,KAAK,OAAO,CAAC,SAAS,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../explorers/types.ts"],"names":[],"mappings":"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"}

package/decoder/tests.ts

@@ -73,6 +73,15 @@ const testExplorer: Explorer = {
   getInternalTransactionOfTransaction: () => {
     throw new Error('Not implemented')
   },
+  getAddressTransactionHashesWithTimestamp: () => {
+    throw new Error('not implemented')
+  },
+  getAddressInternalTransactionsWithTimestamp: () => {
+    throw new Error('not implemented')
+  },
+  getAddressTokenTransferHashesWithTimestamp: () => {
+    throw new Error('not implemented')
+  },
 }
 
 export const testChain = createEthereumChainCustom({

package/explorers/definitions/blockscout.ts

@@ -133,7 +133,7 @@ export const createBlockscout = <
       const loop = true
       const hashSet = new Set<LowerHex>()
 
-      // erc20 transfer
+      // token transfer
       let mut_startBlock = startBlock
       while (loop) {
         const transfers = await getTokenTransfersByAddress({
@@ -202,4 +202,144 @@ export const createBlockscout = <
         price: undefined,
       }))
     },
+    getAddressTransactionHashesWithTimestamp: async ({
+      address,
+      startBlock,
+      endBlock,
+      logger,
+    }) => {
+      const loop = true
+      const mut_hashesWithTimestamp: {
+        readonly hash: LowerHex
+        readonly timestamp: number
+      }[] = []
+      let mut_startBlock = startBlock
+      while (loop) {
+        const transactions = await getNormalTransactionsByAddress({
+          apiEndpoint: apiUrl,
+          address,
+          startBlock: mut_startBlock,
+          endBlock,
+          logger,
+        })
+        for (const { hash, timeStamp } of transactions) {
+          if (mut_hashesWithTimestamp.every(({ hash: h }) => h !== hash)) {
+            mut_hashesWithTimestamp.push({ hash, timestamp: timeStamp })
+          }
+        }
+        if (transactions.length < 10_000) {
+          break
+        }
+        const maxTxBlockNumber = transactions.reduce(
+          (max, { blockNumber }) =>
+            max < BigInt(blockNumber) ? BigInt(blockNumber) : max,
+          0n,
+        )
+        if (maxTxBlockNumber === 0n || maxTxBlockNumber === mut_startBlock) {
+          break
+        }
+        mut_startBlock = maxTxBlockNumber
+      }
+      return mut_hashesWithTimestamp
+    },
+    getAddressInternalTransactionsWithTimestamp: async ({
+      address,
+      startBlock,
+      endBlock,
+      nativeCurrency,
+      logger,
+    }) => {
+      const loop = true
+      const mut_internalTransactionsWithTimestamp: (InternalTransaction<undefined> & {
+        readonly timestamp: number
+      })[] = []
+      let mut_startBlock = startBlock
+      while (loop) {
+        const transactions = await getInternalTransactionsByAddress({
+          apiEndpoint: apiUrl,
+          address,
+          startBlock: mut_startBlock,
+          endBlock,
+          logger,
+        })
+        for (const transaction of transactions) {
+          if (
+            mut_internalTransactionsWithTimestamp.some(
+              ({ transactionHash, from, to, value }) =>
+                transaction.transactionHash === transactionHash &&
+                transaction.from === from &&
+                transaction.to === to &&
+                transaction.value === value,
+            )
+          ) {
+            continue
+          }
+          mut_internalTransactionsWithTimestamp.push({
+            ...transaction,
+            type: 'InternalTransaction',
+            to: transaction.to,
+            contractAddress: transaction.contractAddress,
+            txType: transaction.type,
+            currency: nativeCurrency,
+            price: undefined,
+            timestamp: transaction.timeStamp,
+          })
+        }
+        if (transactions.length < 10_000) {
+          break
+        }
+        const maxTxBlockNumber = transactions.reduce(
+          (max, { blockNumber }) =>
+            max < BigInt(blockNumber) ? BigInt(blockNumber) : max,
+          0n,
+        )
+        if (maxTxBlockNumber === 0n || maxTxBlockNumber === mut_startBlock) {
+          break
+        }
+        mut_startBlock = maxTxBlockNumber
+      }
+      return mut_internalTransactionsWithTimestamp
+    },
+    getAddressTokenTransferHashesWithTimestamp: async ({
+      address,
+      startBlock,
+      endBlock,
+      logger,
+    }) => {
+      const loop = true
+      const mut_hashesWithTimestamp: {
+        readonly hash: LowerHex
+        readonly timestamp: number
+      }[] = []
+
+      // token transfer
+      let mut_startBlock = startBlock
+      while (loop) {
+        const transfers = await getTokenTransfersByAddress({
+          apiEndpoint: apiUrl,
+          address,
+          startBlock: mut_startBlock,
+          endBlock,
+          logger,
+        })
+        for (const { hash, timeStamp } of transfers) {
+          if (mut_hashesWithTimestamp.every(({ hash: h }) => h !== hash)) {
+            mut_hashesWithTimestamp.push({ hash, timestamp: timeStamp })
+          }
+        }
+        if (transfers.length < 10_000) {
+          break
+        }
+        const maxTxBlockNumber = transfers.reduce(
+          (max, { blockNumber }) =>
+            max < BigInt(blockNumber) ? BigInt(blockNumber) : max,
+          0n,
+        )
+        if (maxTxBlockNumber === 0n || maxTxBlockNumber === mut_startBlock) {
+          break
+        }
+        mut_startBlock = maxTxBlockNumber
+      }
+      return mut_hashesWithTimestamp
+    },
   })

package/explorers/definitions/etherscan.ts

@@ -276,4 +276,215 @@ export const createEtherscan = <
         price: undefined,
       }))
     },
+    getAddressTransactionHashesWithTimestamp: async ({
+      address,
+      startBlock,
+      endBlock,
+      logger,
+    }) => {
+      const loop = true
+      const mut_hashesWithTimestamp: {
+        readonly hash: LowerHex
+        readonly timestamp: number
+      }[] = []
+      let mut_startBlock = startBlock
+      while (loop) {
+        const transactions = await getNormalTransactionsByAddress({
+          apiEndpoint: apiUrl,
+          apiKey,
+          address,
+          startBlock: mut_startBlock,
+          endBlock,
+          logger,
+        })
+        for (const { hash, timeStamp } of transactions) {
+          if (mut_hashesWithTimestamp.every(({ hash: h }) => h !== hash)) {
+            mut_hashesWithTimestamp.push({ hash, timestamp: timeStamp })
+          }
+        }
+        if (transactions.length < 10_000) {
+          break
+        }
+        const maxTxBlockNumber = transactions.reduce(
+          (max, { blockNumber }) =>
+            max < BigInt(blockNumber) ? BigInt(blockNumber) : max,
+          0n,
+        )
+        if (maxTxBlockNumber === 0n || maxTxBlockNumber === mut_startBlock) {
+          break
+        }
+        mut_startBlock = maxTxBlockNumber
+      }
+      return mut_hashesWithTimestamp
+    },
+    getAddressInternalTransactionsWithTimestamp: async ({
+      address,
+      startBlock,
+      endBlock,
+      nativeCurrency,
+      logger,
+    }) => {
+      const loop = true
+      const mut_internalTransactionsWithTimestamp: (InternalTransaction<undefined> & {
+        readonly timestamp: number
+      })[] = []
+      let mut_startBlock = startBlock
+      while (loop) {
+        const transactions = await getInternalTransactionsByAddress({
+          apiEndpoint: apiUrl,
+          apiKey,
+          address,
+          startBlock: mut_startBlock,
+          endBlock,
+          logger,
+        })
+        for (const transaction of transactions) {
+          if (
+            mut_internalTransactionsWithTimestamp.some(
+              ({ transactionHash, from, to, value }) =>
+                transaction.hash === transactionHash &&
+                transaction.from === from &&
+                transaction.to === to &&
+                transaction.value === value,
+            )
+          ) {
+            continue
+          }
+          mut_internalTransactionsWithTimestamp.push({
+            ...transaction,
+            type: 'InternalTransaction',
+            transactionHash: transaction.hash,
+            to: transaction.to,
+            contractAddress: transaction.contractAddress,
+            txType: transaction.type,
+            currency: nativeCurrency,
+            price: undefined,
+            timestamp: transaction.timeStamp,
+          })
+        }
+        if (transactions.length < 10_000) {
+          break
+        }
+        const maxTxBlockNumber = transactions.reduce(
+          (max, { blockNumber }) =>
+            max < BigInt(blockNumber) ? BigInt(blockNumber) : max,
+          0n,
+        )
+        if (maxTxBlockNumber === 0n || maxTxBlockNumber === mut_startBlock) {
+          break
+        }
+        mut_startBlock = maxTxBlockNumber
+      }
+      return mut_internalTransactionsWithTimestamp
+    },
+    getAddressTokenTransferHashesWithTimestamp: async ({
+      address,
+      startBlock,
+      endBlock,
+      logger,
+    }) => {
+      const loop = true
+      const mut_hashesWithTimestamp: {
+        readonly hash: LowerHex
+        readonly timestamp: number
+      }[] = []
+
+      // erc20 transfer
+      let mut_erc20StartBlock = startBlock
+      while (loop) {
+        const transfers = await getErc20TokenTransfersByAddress({
+          apiEndpoint: apiUrl,
+          apiKey,
+          address,
+          startBlock: mut_erc20StartBlock,
+          endBlock,
+          logger,
+        })
+        for (const { hash, timeStamp } of transfers) {
+          if (mut_hashesWithTimestamp.every(({ hash: h }) => h !== hash)) {
+            mut_hashesWithTimestamp.push({ hash, timestamp: timeStamp })
+          }
+        }
+        if (transfers.length < 10_000) {
+          break
+        }
+        const maxTxBlockNumber = transfers.reduce(
+          (max, { blockNumber }) =>
+            max < BigInt(blockNumber) ? BigInt(blockNumber) : max,
+          0n,
+        )
+        if (
+          maxTxBlockNumber === 0n ||
+          maxTxBlockNumber === mut_erc20StartBlock
+        ) {
+          break
+        }
+        mut_erc20StartBlock = maxTxBlockNumber
+      }
+      // erc721 transfer
+      let mut_erc721StartBlock = startBlock
+      while (loop) {
+        const transfers = await getErc721TokenTransfersByAddress({
+          apiEndpoint: apiUrl,
+          apiKey,
+          address,
+          startBlock: mut_erc721StartBlock,
+          endBlock,
+          logger,
+        })
+        for (const { hash, timeStamp } of transfers) {
+          if (mut_hashesWithTimestamp.every(({ hash: h }) => h !== hash)) {
+            mut_hashesWithTimestamp.push({ hash, timestamp: timeStamp })
+          }
+        }
+        if (transfers.length < 10_000) {
+          break
+        }
+        const maxTxBlockNumber = transfers.reduce(
+          (max, { blockNumber }) =>
+            max < BigInt(blockNumber) ? BigInt(blockNumber) : max,
+          0n,
+        )
+        if (
+          maxTxBlockNumber === 0n ||
+          maxTxBlockNumber === mut_erc721StartBlock
+        ) {
+          break
+        }
+        mut_erc721StartBlock = maxTxBlockNumber
+      }
+      // erc1155 transfer
+      let mut_erc1155StartBlock = startBlock
+      while (loop) {
+        const transfers = await getErc1155TokenTransfersByAddress({
+          apiEndpoint: apiUrl,
+          apiKey,
+          address,
+          startBlock: mut_erc1155StartBlock,
+          endBlock,
+          logger,
+        })
+        for (const { hash, timeStamp } of transfers) {
+          if (mut_hashesWithTimestamp.every(({ hash: h }) => h !== hash)) {
+            mut_hashesWithTimestamp.push({ hash, timestamp: timeStamp })
+          }
+        }
+        if (transfers.length < 10_000) {
+          break
+        }
+        const maxTxBlockNumber = transfers.reduce(
+          (max, { blockNumber }) =>
+            max < BigInt(blockNumber) ? BigInt(blockNumber) : max,
+          0n,
+        )
+        if (
+          maxTxBlockNumber === 0n ||
+          maxTxBlockNumber === mut_erc1155StartBlock
+        ) {
+          break
+        }
+        mut_erc1155StartBlock = maxTxBlockNumber
+      }
+      return mut_hashesWithTimestamp
+    },
   })

package/explorers/definitions/roninExplorer.ts

@@ -1,4 +1,5 @@
 import type { Hex } from 'viem'
+import type { LowerHex } from '../../types'
 import {
   getInternalTransactionByHash,
   getNormalTransactionsByAddress,
@@ -147,4 +148,102 @@ export const createRoninExplorer = <
         price: undefined,
       }))
     },
+    getAddressTransactionHashesWithTimestamp: async ({
+      address,
+      startBlock,
+      endBlock,
+      logger,
+    }) => {
+      const mut_hashesWithTimestamp: {
+        readonly hash: LowerHex
+        readonly timestamp: number
+      }[] = []
+      let mut_from = 0
+      while (mut_from >= 0) {
+        const { total, transactions } = await getNormalTransactionsByAddress({
+          apiEndpoint: explorerApiUrl,
+          address,
+          size: 100,
+          from: mut_from,
+          logger,
+        })
+        for (const transaction of transactions) {
+          if (
+            startBlock !== undefined &&
+            BigInt(transaction.block_number) < startBlock
+          ) {
+            return mut_hashesWithTimestamp
+          }
+          if (
+            (endBlock === undefined ||
+              BigInt(transaction.block_number) <= endBlock) &&
+            mut_hashesWithTimestamp.every(
+              ({ hash }) => hash !== transaction.hash,
+            )
+          ) {
+            mut_hashesWithTimestamp.push({
+              hash: transaction.hash,
+              timestamp: transaction.timestamp,
+            })
+          }
+        }
+        mut_from += transactions.length
+        if (mut_from + transactions.length >= total) {
+          break
+        }
+      }
+      return mut_hashesWithTimestamp
+    },
+    getAddressInternalTransactionsWithTimestamp: ({ logger }) => {
+      if (logger !== undefined) {
+        logger.info('getAddressInternalTransactions is not implemented')
+      }
+      return Promise.resolve([])
+    },
+    getAddressTokenTransferHashesWithTimestamp: async ({
+      address,
+      startBlock,
+      endBlock,
+      logger,
+    }) => {
+      const mut_hashesWithTimestamp: {
+        readonly hash: LowerHex
+        readonly timestamp: number
+      }[] = []
+      let mut_from = 0
+      while (mut_from >= 0) {
+        const { total, transfers } = await getTokenTransfersByAddress({
+          apiEndpoint: explorerApiUrl,
+          address,
+          size: 100,
+          from: mut_from,
+          logger,
+        })
+        for (const transfer of transfers) {
+          if (
+            startBlock !== undefined &&
+            BigInt(transfer.block_number) < startBlock
+          ) {
+            return mut_hashesWithTimestamp
+          }
+          if (
+            (endBlock === undefined ||
+              BigInt(transfer.block_number) <= endBlock) &&
+            mut_hashesWithTimestamp.every(
+              ({ hash }) => hash !== transfer.tx_hash,
+            )
+          ) {
+            mut_hashesWithTimestamp.push({
+              hash: transfer.tx_hash,
+              timestamp: transfer.timestamp,
+            })
+          }
+        }
+        mut_from += transfers.length
+        if (mut_from + transfers.length >= total) {
+          break
+        }
+      }
+      return mut_hashesWithTimestamp
+    },
   })

package/explorers/definitions/routescan.ts

@@ -54,4 +54,19 @@ export const createRoutescan = <
       await new Promise((resolve) => setTimeout(resolve))
       throw new Error('not implemented')
     },
+    getAddressTransactionHashesWithTimestamp: async () => {
+      // TODO implement
+      await new Promise((resolve) => setTimeout(resolve))
+      throw new Error('not implemented')
+    },
+    getAddressInternalTransactionsWithTimestamp: async () => {
+      // TODO implement
+      await new Promise((resolve) => setTimeout(resolve))
+      throw new Error('not implemented')
+    },
+    getAddressTokenTransferHashesWithTimestamp: async () => {
+      // TODO implement
+      await new Promise((resolve) => setTimeout(resolve))
+      throw new Error('not implemented')
+    },
   })

package/explorers/types.ts

@@ -6,8 +6,11 @@ export type Explorer = {
   readonly url: string
   readonly apiUrl: string
   readonly getAddressTransactionHashes: FunctionGetAddressTransactionHashes
+  readonly getAddressTransactionHashesWithTimestamp: FunctionGetAddressTransactionHashesWithTimestamp
   readonly getAddressInternalTransactions: FunctionGetAddressInternalTransactions
+  readonly getAddressInternalTransactionsWithTimestamp: FunctionGetAddressInternalTransactionsWithTimestamp
   readonly getAddressTokenTransferHashes: FunctionGetAddressTokenTransferHashes
+  readonly getAddressTokenTransferHashesWithTimestamp: FunctionGetAddressTokenTransferHashesWithTimestamp
   readonly getBlockNumberOfTimestamp: (
     timestamp: number,
     logger?: Logger,
@@ -23,6 +26,18 @@ type FunctionGetAddressTransactionHashes = (parameters: {
   readonly logger?: Logger
 }) => Promise<readonly Hex[]>
 
+type FunctionGetAddressTransactionHashesWithTimestamp = (parameters: {
+  readonly address: Hex
+  readonly startBlock?: bigint
+  readonly endBlock?: bigint
+  readonly logger?: Logger
+}) => Promise<
+  readonly {
+    readonly hash: Hex
+    readonly timestamp: number
+  }[]
+>
+
 type FunctionGetAddressInternalTransactions = (parameters: {
   readonly address: Hex
   readonly startBlock?: bigint
@@ -31,6 +46,16 @@ type FunctionGetAddressInternalTransactions = (parameters: {
   readonly logger?: Logger
 }) => Promise<readonly InternalTransaction<undefined>[]>
 
+type FunctionGetAddressInternalTransactionsWithTimestamp = (parameters: {
+  readonly address: Hex
+  readonly startBlock?: bigint
+  readonly endBlock?: bigint
+  readonly nativeCurrency: CryptoCurrency
+  readonly logger?: Logger
+}) => Promise<
+  readonly (InternalTransaction<undefined> & { readonly timestamp: number })[]
+>
+
 type FunctionGetAddressTokenTransferHashes = (parameters: {
   readonly address: Hex
   readonly startBlock?: bigint
@@ -38,6 +63,18 @@ type FunctionGetAddressTokenTransferHashes = (parameters: {
   readonly logger?: Logger
 }) => Promise<readonly Hex[]>
 
+type FunctionGetAddressTokenTransferHashesWithTimestamp = (parameters: {
+  readonly address: Hex
+  readonly startBlock?: bigint
+  readonly endBlock?: bigint
+  readonly logger?: Logger
+}) => Promise<
+  readonly {
+    readonly hash: Hex
+    readonly timestamp: number
+  }[]
+>
+
 type FunctionGetContract = (
   address: Hex,
   logger?: Logger,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xtorch/evm",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "Cryptorch EVM extension",
   "keywords": [
     "cryptorch",