@ledgerhq/coin-evm 16.2.5 → 16.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (110) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/lib/adapters/blockscoutV2.d.ts +40 -0
  3. package/lib/adapters/blockscoutV2.d.ts.map +1 -0
  4. package/lib/adapters/blockscoutV2.js +177 -0
  5. package/lib/adapters/blockscoutV2.js.map +1 -0
  6. package/lib/adapters/index.d.ts +1 -0
  7. package/lib/adapters/index.d.ts.map +1 -1
  8. package/lib/adapters/index.js +1 -0
  9. package/lib/adapters/index.js.map +1 -1
  10. package/lib/chains.d.ts +1 -1
  11. package/lib/chains.js +1 -1
  12. package/lib/chains.js.map +1 -1
  13. package/lib/config.d.ts +24 -23
  14. package/lib/config.d.ts.map +1 -1
  15. package/lib/config.js +0 -16
  16. package/lib/config.js.map +1 -1
  17. package/lib/logic/internalTransactionsFetcher.d.ts.map +1 -1
  18. package/lib/logic/internalTransactionsFetcher.js +13 -2
  19. package/lib/logic/internalTransactionsFetcher.js.map +1 -1
  20. package/lib/network/blockscoutV2.d.ts +35 -0
  21. package/lib/network/blockscoutV2.d.ts.map +1 -0
  22. package/lib/network/blockscoutV2.js +311 -0
  23. package/lib/network/blockscoutV2.js.map +1 -0
  24. package/lib/network/explorer/etherscan.d.ts.map +1 -1
  25. package/lib/network/explorer/etherscan.js +11 -28
  26. package/lib/network/explorer/etherscan.js.map +1 -1
  27. package/lib/network/explorer/index.d.ts.map +1 -1
  28. package/lib/network/explorer/index.js +5 -0
  29. package/lib/network/explorer/index.js.map +1 -1
  30. package/lib/network/explorer/types.d.ts +6 -0
  31. package/lib/network/explorer/types.d.ts.map +1 -1
  32. package/lib/network/explorer/types.js +8 -1
  33. package/lib/network/explorer/types.js.map +1 -1
  34. package/lib/network/rewards.d.ts +11 -0
  35. package/lib/network/rewards.d.ts.map +1 -0
  36. package/lib/network/rewards.js +32 -0
  37. package/lib/network/rewards.js.map +1 -0
  38. package/lib/types/blockscoutV2.d.ts +80 -0
  39. package/lib/types/blockscoutV2.d.ts.map +1 -0
  40. package/lib/types/blockscoutV2.js +5 -0
  41. package/lib/types/blockscoutV2.js.map +1 -0
  42. package/lib/types/index.d.ts +1 -0
  43. package/lib/types/index.d.ts.map +1 -1
  44. package/lib/types/index.js +1 -0
  45. package/lib/types/index.js.map +1 -1
  46. package/lib-es/adapters/blockscoutV2.d.ts +40 -0
  47. package/lib-es/adapters/blockscoutV2.d.ts.map +1 -0
  48. package/lib-es/adapters/blockscoutV2.js +168 -0
  49. package/lib-es/adapters/blockscoutV2.js.map +1 -0
  50. package/lib-es/adapters/index.d.ts +1 -0
  51. package/lib-es/adapters/index.d.ts.map +1 -1
  52. package/lib-es/adapters/index.js +1 -0
  53. package/lib-es/adapters/index.js.map +1 -1
  54. package/lib-es/chains.d.ts +1 -1
  55. package/lib-es/chains.js +1 -1
  56. package/lib-es/chains.js.map +1 -1
  57. package/lib-es/config.d.ts +24 -23
  58. package/lib-es/config.d.ts.map +1 -1
  59. package/lib-es/config.js +0 -16
  60. package/lib-es/config.js.map +1 -1
  61. package/lib-es/logic/internalTransactionsFetcher.d.ts.map +1 -1
  62. package/lib-es/logic/internalTransactionsFetcher.js +14 -3
  63. package/lib-es/logic/internalTransactionsFetcher.js.map +1 -1
  64. package/lib-es/network/blockscoutV2.d.ts +35 -0
  65. package/lib-es/network/blockscoutV2.d.ts.map +1 -0
  66. package/lib-es/network/blockscoutV2.js +271 -0
  67. package/lib-es/network/blockscoutV2.js.map +1 -0
  68. package/lib-es/network/explorer/etherscan.d.ts.map +1 -1
  69. package/lib-es/network/explorer/etherscan.js +2 -19
  70. package/lib-es/network/explorer/etherscan.js.map +1 -1
  71. package/lib-es/network/explorer/index.d.ts.map +1 -1
  72. package/lib-es/network/explorer/index.js +5 -0
  73. package/lib-es/network/explorer/index.js.map +1 -1
  74. package/lib-es/network/explorer/types.d.ts +6 -0
  75. package/lib-es/network/explorer/types.d.ts.map +1 -1
  76. package/lib-es/network/explorer/types.js +6 -0
  77. package/lib-es/network/explorer/types.js.map +1 -1
  78. package/lib-es/network/rewards.d.ts +11 -0
  79. package/lib-es/network/rewards.d.ts.map +1 -0
  80. package/lib-es/network/rewards.js +29 -0
  81. package/lib-es/network/rewards.js.map +1 -0
  82. package/lib-es/types/blockscoutV2.d.ts +80 -0
  83. package/lib-es/types/blockscoutV2.d.ts.map +1 -0
  84. package/lib-es/types/blockscoutV2.js +4 -0
  85. package/lib-es/types/blockscoutV2.js.map +1 -0
  86. package/lib-es/types/index.d.ts +1 -0
  87. package/lib-es/types/index.d.ts.map +1 -1
  88. package/lib-es/types/index.js +1 -0
  89. package/lib-es/types/index.js.map +1 -1
  90. package/package.json +1 -1
  91. package/src/adapters/blockscoutV2.test.ts +296 -0
  92. package/src/adapters/blockscoutV2.ts +244 -0
  93. package/src/adapters/index.ts +1 -0
  94. package/src/api/tests/index.alpen_testnet.integ.test.ts +73 -0
  95. package/src/api/tests/index.integ.test.ts +4 -2
  96. package/src/api/tests/index.scroll.integ.test.ts +168 -0
  97. package/src/api/tests/index.shape.integ.test.ts +34 -0
  98. package/src/chains.ts +1 -1
  99. package/src/config.ts +25 -16
  100. package/src/logic/internalTransactionsFetcher.ts +20 -3
  101. package/src/logic/tests/internalTransactionsFetcher.test.ts +51 -0
  102. package/src/network/blockscoutV2.ts +460 -0
  103. package/src/network/explorer/etherscan.ts +2 -29
  104. package/src/network/explorer/index.ts +5 -0
  105. package/src/network/explorer/types.ts +9 -0
  106. package/src/network/rewards.ts +47 -0
  107. package/src/network/tests/blockscoutV2.test.ts +565 -0
  108. package/src/network/tests/explorer/index.test.ts +21 -0
  109. package/src/types/blockscoutV2.ts +85 -0
  110. package/src/types/index.ts +1 -0
@@ -0,0 +1,168 @@
1
+ // SPDX-FileCopyrightText: © 2026 LEDGER SAS
2
+ // SPDX-License-Identifier: Apache-2.0
3
+
4
+ import type { EvmConfigInfo } from '../../config'
5
+ import type { MemoNotSupported, Operation } from '@ledgerhq/coin-module-framework/api/types'
6
+ import { internalTxSourcesFromList } from '../../config'
7
+ import { createMockEvmContext } from '../../fixtures/context.fixtures'
8
+ import { createApi } from '../index'
9
+
10
+ describe('EVM Scroll Network (blockscout-v2 explorer)', () => {
11
+ const config: Partial<EvmConfigInfo> = {
12
+ chainId: 534352,
13
+ node: {
14
+ type: 'external',
15
+ uri: 'https://scroll.alpaca.api.ledger.com',
16
+ },
17
+ explorer: {
18
+ type: 'blockscout-v2',
19
+ uri: 'https://proxyblockscout.api.live.ledger.com/534352/api/v2',
20
+ },
21
+ supportedTokens: ['erc721', 'erc1155'],
22
+ }
23
+ const module = createApi()
24
+ const context = createMockEvmContext(config)
25
+
26
+ // Account with transactions, ERC-20 transfers and internal transactions. It is still active, so
27
+ // the tests read it from a fixed block (the cursor is the highest block of the page).
28
+ const address = '0x0459a84952C85c6E9345e5d22d9B110790a5e1Ba'
29
+ const txHash = '0x43e90e6c63094c216268f02fea72f798ecbea691f208c4143d2aac322f6690ff'
30
+ const txHeight = 10582834
31
+ // Fee actually paid, mostly the L1 data fee: gasUsed × gasPrice alone is far lower, see LIVE-38797
32
+ const expectedFees = 6_863_830_062_607n
33
+
34
+ it('getBlock reports the fee including the L1 data fee', async () => {
35
+ const block = await module.getBlock(context, txHeight)
36
+ expect(block.transactions.find((t) => t.hash === txHash)?.fees).toEqual(expectedFees)
37
+ })
38
+
39
+ it('listOperations reports the same fee and block hash as getBlock', async () => {
40
+ const { items } = await module.listOperations(context, address, {
41
+ minHeight: 0,
42
+ cursor: String(txHeight),
43
+ limit: 5,
44
+ order: 'desc',
45
+ })
46
+ const operation = items.find((o) => o.tx.hash === txHash)
47
+ const block = await module.getBlock(context, txHeight)
48
+
49
+ expect(operation?.tx.fees).toEqual(expectedFees)
50
+ expect(operation?.tx.block.hash).toEqual(block.info.hash)
51
+ })
52
+
53
+ it('pages in descending order without gaps or duplicates', async () => {
54
+ const isInRange = (o: Operation<MemoNotSupported>): boolean => o.tx.block.height <= txHeight
55
+ const all = (await module.listOperations(context, address, { minHeight: 0 })).items.filter(
56
+ isInRange
57
+ )
58
+
59
+ const paged: Array<Operation<MemoNotSupported>> = []
60
+ let cursor: string | undefined = String(txHeight)
61
+ while (cursor) {
62
+ const page = await module.listOperations(context, address, {
63
+ minHeight: 0,
64
+ cursor,
65
+ limit: 5,
66
+ order: 'desc',
67
+ })
68
+ paged.push(...page.items)
69
+ cursor = page.next || undefined
70
+ }
71
+
72
+ const heights = paged.map((o) => o.tx.block.height)
73
+ expect(heights).toEqual([...heights].sort((a, b) => b - a))
74
+ expect(paged.map((o) => o.id).sort()).toEqual(all.map((o) => o.id).sort())
75
+ expect(paged.some((o) => o.asset.type === 'erc20')).toBe(true)
76
+ expect(paged.some((o) => o.details?.internal === true)).toBe(true)
77
+ })
78
+
79
+ it('lists an ERC-721 transfer', async () => {
80
+ const recipient = '0x2a10ed109Fe3088383D6b4d50C326D2DdeCE9923'
81
+ const height = 35442515
82
+ const { items } = await module.listOperations(context, recipient, {
83
+ minHeight: 0,
84
+ cursor: String(height),
85
+ limit: 5,
86
+ order: 'desc',
87
+ })
88
+ const operation = items.find(
89
+ (o) =>
90
+ o.tx.hash === '0x7dd31b6af23800b24311974d21d1ad3da4fbdc296879c40d33d4641ee7470eb2' &&
91
+ o.asset.type === 'erc721'
92
+ )
93
+ const block = await module.getBlock(context, height)
94
+
95
+ expect(operation).toMatchObject({
96
+ type: 'NFT_IN',
97
+ value: 1n,
98
+ asset: { type: 'erc721', assetReference: '0xcE8c1FcDD440b4Fd6e6c236568C74e6022767c97' },
99
+ senders: ['0x0000000000000000000000000000000000000000'],
100
+ recipients: [recipient],
101
+ tx: { block: { height, hash: block.info.hash } },
102
+ details: { tokenId: '1288' },
103
+ })
104
+ })
105
+
106
+ it('lists ERC-1155 transfers', async () => {
107
+ const recipient = '0xe71e46A8dd85BB3818fbBDaF8179da50A12D7166'
108
+ const height = 35419686
109
+ const { items } = await module.listOperations(context, recipient, {
110
+ minHeight: 0,
111
+ cursor: String(height),
112
+ limit: 5,
113
+ order: 'desc',
114
+ })
115
+ const operations = items.filter(
116
+ (o) => o.tx.hash === '0x37f8029709b9d4cce91881dee890c14ae8cd251495aef17f312a409e163b092c'
117
+ )
118
+ const block = await module.getBlock(context, height)
119
+
120
+ expect(
121
+ operations.find(
122
+ (o) =>
123
+ o.asset.type === 'erc1155' &&
124
+ o.asset.assetReference === '0x9D17534FaFf815D629abCfEF0d45D2Da7652D1eB'
125
+ )
126
+ ).toMatchObject({
127
+ type: 'NFT_IN',
128
+ value: 1n,
129
+ senders: ['0xcA11bde05977b3631167028862bE2a173976CA11'],
130
+ recipients: [recipient],
131
+ tx: { block: { height, hash: block.info.hash } },
132
+ details: { tokenId: '0' },
133
+ })
134
+ // One operation per transfer of the batch, with unique ids
135
+ const nftOperations = operations.filter((o) => o.asset.type === 'erc1155')
136
+ expect(nftOperations.length).toBeGreaterThan(1)
137
+ expect(new Set(nftOperations.map((o) => o.id)).size).toEqual(nftOperations.length)
138
+ })
139
+
140
+ it('getBlock reads internal transactions from the Blockscout v2 API', async () => {
141
+ // Only the explorer source, so that a failure cannot fall back to the node traces
142
+ const explorerOnly = createMockEvmContext({
143
+ ...config,
144
+ getBlockInternalTxsSources: internalTxSourcesFromList(['explorer']),
145
+ })
146
+
147
+ const block = await module.getBlock(explorerOnly, 33240184)
148
+ const operations = block.transactions.find(
149
+ (t) => t.hash === '0xda0d5242920bb16027cea259849a8f3f7f0e0c7b0cd9277fc0a78e4cf86e1900'
150
+ )?.operations
151
+
152
+ expect(operations).toContainEqual(
153
+ expect.objectContaining({
154
+ type: 'transfer',
155
+ address: '0x127B15f37aCBeaA4188A3388689445Ae892787bC',
156
+ peer: '0xbdA143d49da40C2cDA27c40edfBbe8A0D4AE0cBc',
157
+ asset: { type: 'native' },
158
+ amount: 3_000_000_000_000_000_000n,
159
+ })
160
+ )
161
+ })
162
+
163
+ it('rejects ascending pages', async () => {
164
+ await expect(
165
+ module.listOperations(context, address, { minHeight: 0, limit: 5, order: 'asc' })
166
+ ).rejects.toThrow('Ascending order is not supported')
167
+ })
168
+ })
@@ -47,4 +47,38 @@ describe('Shape (external node)', () => {
47
47
  )
48
48
  })
49
49
  })
50
+
51
+ // Shape's Blockscout reports the L1 data fee in `txlist` (`L1FeesPaid`), so the v1 API is enough
52
+ describe('fees include the L1 data fee', () => {
53
+ const config: Partial<EvmConfigInfo> = {
54
+ chainId: 360,
55
+ node: {
56
+ type: 'external',
57
+ uri: 'https://mainnet.shape.network',
58
+ },
59
+ explorer: {
60
+ type: 'blockscout',
61
+ uri: 'https://proxyblockscout.api.live.ledger.com/360/api',
62
+ },
63
+ }
64
+ const module = createApi()
65
+
66
+ const txHash = '0x68d2739afa41ec0523e03eb672002152195af1cf928ba6afa4b48944462d6754'
67
+ // gasUsed × gasPrice (21000 × 1000252 = 21_005_292_000) + L1 data fee, see LIVE-38797
68
+ const expectedFees = 846_354_837_246n
69
+
70
+ it('getBlock', async () => {
71
+ const block = await module.getBlock(createMockEvmContext(config), 3505965)
72
+ expect(block.transactions.find((t) => t.hash === txHash)?.fees).toEqual(expectedFees)
73
+ })
74
+
75
+ it('listOperations', async () => {
76
+ const { items } = await module.listOperations(
77
+ createMockEvmContext(config),
78
+ '0x9425E212647518853a92ae7D2C1Ab09D343e70b6',
79
+ { minHeight: 3505965, order: 'asc', limit: 5 }
80
+ )
81
+ expect(items.find((o) => o.tx.hash === txHash)?.tx.fees).toEqual(expectedFees)
82
+ })
83
+ })
50
84
  })
package/src/chains.ts CHANGED
@@ -32,7 +32,6 @@ export const CHAIN_ID = {
32
32
  BITTORRENT: 199,
33
33
  DEXON: 237,
34
34
  ENERGY_WEB: 246,
35
- FANTOM: 250,
36
35
  HPB: 269,
37
36
  BOBA: 288,
38
37
  ZKSYNC_SEPOLIA: 300,
@@ -65,6 +64,7 @@ export const CHAIN_ID = {
65
64
  MONAD_TESTNET: 10143,
66
65
  ZERO_GRAVITY: 16661,
67
66
  ALPEN_TESTNET: 20310,
67
+ ALPEN: 29032,
68
68
  ETHERSOCIAL: 31102,
69
69
  ADI: 36900,
70
70
  ARBITRUM: 42161,
package/src/config.ts CHANGED
@@ -48,6 +48,12 @@ export type EvmConfig = {
48
48
  explorer:
49
49
  | {
50
50
  type: 'etherscan' | 'blockscout' | 'teloscan' | 'klaytnfinder' | 'corescan' | 'cronos'
51
+ /**
52
+ * Disable the explorer response cache. By default, identical `getOperations` and
53
+ * `discoverTokenAssets` calls (same chain, address, block range, cursor, limit and order)
54
+ * made within 5 seconds share one explorer request; a failed request is not cached.
55
+ * Set to `true` to always send a new request.
56
+ */
51
57
  noCache?: boolean | undefined
52
58
  /**
53
59
  * Optional cap applied to the requested operation `limit` before the internal `limit + 1` probe.
@@ -66,6 +72,25 @@ export type EvmConfig = {
66
72
  /** Number of retries for explorer API calls. Defaults to 8 if not set. Set to 0 for no retries. */
67
73
  retries?: number
68
74
  }
75
+ | {
76
+ /**
77
+ * Blockscout v2 REST API. Unlike the Etherscan-compatible v1 API (`type: 'blockscout'`), it
78
+ * reports the fee actually paid, including the L1 data fee of rollups.
79
+ * Only serves operations in descending order.
80
+ */
81
+ type: 'blockscout-v2'
82
+ /** Base URI of the v2 API, e.g. `https://proxyblockscout.api.live.ledger.com/534352/api/v2` */
83
+ uri: string
84
+ /**
85
+ * Disable the explorer response cache. By default, identical `getOperations` and
86
+ * `discoverTokenAssets` calls (same chain, address, block range, cursor, limit and order)
87
+ * made within 5 seconds share one explorer request; a failed request is not cached.
88
+ * Set to `true` to always send a new request.
89
+ */
90
+ noCache?: boolean | undefined
91
+ /** Number of retries for explorer API calls. Defaults to 8 if not set. Set to 0 for no retries. */
92
+ retries?: number
93
+ }
69
94
  | {
70
95
  type: 'ledger'
71
96
  explorerId: string
@@ -382,22 +407,6 @@ export const evmDefaults = {
382
407
  type: 'none',
383
408
  },
384
409
  },
385
- fantom: {
386
- status: {
387
- type: 'active',
388
- features: [{ id: 'blockchain_txs', status: 'active' }],
389
- },
390
- chainId: 250,
391
- name: 'Fantom',
392
- unit: { name: 'FTM', code: 'FTM', magnitude: 18 },
393
- node: {
394
- type: 'external',
395
- uri: 'https://fantom.coin.ledger.com',
396
- },
397
- explorer: {
398
- type: 'none',
399
- },
400
- },
401
410
  flare: {
402
411
  status: {
403
412
  type: 'active',
@@ -9,8 +9,12 @@ import type { Logger } from '@ledgerhq/coin-module-framework/config'
9
9
  import { traceBlockItemsToOperationsByHash } from '../adapters/blockOperations'
10
10
  import { internalTxsToOperationsByHash } from '../adapters/etherscan'
11
11
  import { SourceUnavailableError } from '../errors'
12
+ import { getInternalTransactionsByBlock as getBlockscoutV2InternalTransactionsByBlock } from '../network/blockscoutV2'
12
13
  import { getInternalTransactionsByBlock } from '../network/explorer/etherscan'
13
- import { isEtherscanLikeExplorerConfig } from '../network/explorer/types'
14
+ import {
15
+ isBlockscoutV2ExplorerConfig,
16
+ isEtherscanLikeExplorerConfig,
17
+ } from '../network/explorer/types'
14
18
 
15
19
  export type InternalTxsByHash = Map<string, BlockOperation[]>
16
20
 
@@ -61,6 +65,18 @@ async function runInternalTxSources(
61
65
  throw new Error('no internal tx sources configured')
62
66
  }
63
67
 
68
+ function explorerInternalTxsByBlock(
69
+ explorer: EvmConfigInfo['explorer']
70
+ ): typeof getInternalTransactionsByBlock | undefined {
71
+ if (isBlockscoutV2ExplorerConfig(explorer)) {
72
+ return getBlockscoutV2InternalTransactionsByBlock
73
+ }
74
+ if (isEtherscanLikeExplorerConfig(explorer)) {
75
+ return getInternalTransactionsByBlock
76
+ }
77
+ return undefined
78
+ }
79
+
64
80
  export function composeInternalTxsFetcher(
65
81
  sources: readonly InternalTxSource[],
66
82
  fetchers: Record<InternalTxSource, SourceFetcher>
@@ -107,14 +123,15 @@ export function makeSourceFetchers(
107
123
  .then((items) => traceBlockItemsToOperationsByHash(items, logger))
108
124
  },
109
125
  explorer: (height: number) => {
110
- if (!isEtherscanLikeExplorerConfig(explorer)) {
126
+ const getByBlock = explorerInternalTxsByBlock(explorer)
127
+ if (getByBlock === undefined) {
111
128
  return Promise.reject(
112
129
  new SourceUnavailableError(
113
130
  `explorer internal txs not configured for currency ${config.name}`
114
131
  )
115
132
  )
116
133
  }
117
- return getInternalTransactionsByBlock(config, height)
134
+ return getByBlock(config, height)
118
135
  .then((txs) => internalTxsToOperationsByHash(txs, logger))
119
136
  .catch((error) => {
120
137
  logger('coin-evm', 'debug: explorer internal txs failed, falling through', {
@@ -12,6 +12,7 @@ import {
12
12
  mkLedgerExplorer,
13
13
  testLogger,
14
14
  } from '../../fixtures/context.fixtures'
15
+ import { getInternalTransactionsByBlock as getBlockscoutV2InternalTransactionsByBlock } from '../../network/blockscoutV2'
15
16
  import { getInternalTransactionsByBlock } from '../../network/explorer/etherscan'
16
17
  import { mockNodeApi } from '../../network/tests/node/node.fixtures'
17
18
  import { composeInternalTxsFetcher, makeSourceFetchers } from '../internalTransactionsFetcher'
@@ -19,6 +20,9 @@ import { composeInternalTxsFetcher, makeSourceFetchers } from '../internalTransa
19
20
  jest.mock('../../network/explorer/etherscan', () => ({
20
21
  getInternalTransactionsByBlock: jest.fn().mockResolvedValue([]),
21
22
  }))
23
+ jest.mock('../../network/blockscoutV2', () => ({
24
+ getInternalTransactionsByBlock: jest.fn().mockResolvedValue([]),
25
+ }))
22
26
 
23
27
  const rejectFetcher = () => Promise.reject(new Error('not implemented'))
24
28
 
@@ -218,6 +222,53 @@ describe('makeSourceFetchers', () => {
218
222
  expect(mockGetInternalTransactionsByBlock).toHaveBeenCalledWith(config, 99)
219
223
  })
220
224
 
225
+ it('reads the block internal transactions from the Blockscout v2 API for a blockscout-v2 explorer', async () => {
226
+ const config = createMockEvmConfigInfo({
227
+ chainId: 534352,
228
+ node: mkExternalNode(),
229
+ explorer: { type: 'blockscout-v2', uri: 'https://blockscout.example/api/v2' },
230
+ })
231
+ jest.mocked(getBlockscoutV2InternalTransactionsByBlock).mockResolvedValueOnce([
232
+ {
233
+ blockNumber: '99',
234
+ hash: '0xabc',
235
+ from: '0x9425E212647518853a92ae7D2C1Ab09D343e70b6',
236
+ to: '0x0459a84952C85c6E9345e5d22d9B110790a5e1Ba',
237
+ value: '9',
238
+ contractAddress: '',
239
+ input: '',
240
+ type: 'call',
241
+ callType: 'call',
242
+ gas: '2300',
243
+ gasUsed: '',
244
+ traceId: '1',
245
+ isError: '0',
246
+ errCode: '',
247
+ },
248
+ ])
249
+
250
+ const fetchers = makeSourceFetchers(config, mockNodeApi(), testLogger)
251
+ const result = await fetchers.explorer(99)
252
+
253
+ expect(getBlockscoutV2InternalTransactionsByBlock).toHaveBeenCalledWith(config, 99)
254
+ expect(getInternalTransactionsByBlock).not.toHaveBeenCalled()
255
+ expect(result.get('0xabc')?.map((op) => op.type === 'transfer' && op.amount)).toEqual([-9n, 9n])
256
+ })
257
+
258
+ it('wraps Blockscout v2 failures as SourceUnavailableError', async () => {
259
+ const config = createMockEvmConfigInfo({
260
+ chainId: 534352,
261
+ node: mkExternalNode(),
262
+ explorer: { type: 'blockscout-v2', uri: 'https://blockscout.example/api/v2' },
263
+ })
264
+ jest
265
+ .mocked(getBlockscoutV2InternalTransactionsByBlock)
266
+ .mockRejectedValueOnce(new Error('explorer error'))
267
+
268
+ const fetchers = makeSourceFetchers(config, mockNodeApi(), testLogger)
269
+ await expect(fetchers.explorer(99)).rejects.toBeInstanceOf(SourceUnavailableError)
270
+ })
271
+
221
272
  it('empty always resolves to an empty map', async () => {
222
273
  const config = createMockEvmConfigInfo({ chainId: 1, node: mkExternalNode() })
223
274