@ledgerhq/coin-evm 16.2.4 → 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.
- package/CHANGELOG.md +24 -0
- package/lib/adapters/blockscoutV2.d.ts +40 -0
- package/lib/adapters/blockscoutV2.d.ts.map +1 -0
- package/lib/adapters/blockscoutV2.js +177 -0
- package/lib/adapters/blockscoutV2.js.map +1 -0
- package/lib/adapters/index.d.ts +1 -0
- package/lib/adapters/index.d.ts.map +1 -1
- package/lib/adapters/index.js +1 -0
- package/lib/adapters/index.js.map +1 -1
- package/lib/chains.d.ts +1 -1
- package/lib/chains.js +1 -1
- package/lib/chains.js.map +1 -1
- package/lib/config.d.ts +1499 -0
- package/lib/config.d.ts.map +1 -1
- package/lib/config.js +968 -1
- package/lib/config.js.map +1 -1
- package/lib/logic/internalTransactionsFetcher.d.ts.map +1 -1
- package/lib/logic/internalTransactionsFetcher.js +13 -2
- package/lib/logic/internalTransactionsFetcher.js.map +1 -1
- package/lib/network/blockscoutV2.d.ts +35 -0
- package/lib/network/blockscoutV2.d.ts.map +1 -0
- package/lib/network/blockscoutV2.js +311 -0
- package/lib/network/blockscoutV2.js.map +1 -0
- package/lib/network/explorer/etherscan.d.ts.map +1 -1
- package/lib/network/explorer/etherscan.js +11 -28
- package/lib/network/explorer/etherscan.js.map +1 -1
- package/lib/network/explorer/index.d.ts.map +1 -1
- package/lib/network/explorer/index.js +5 -0
- package/lib/network/explorer/index.js.map +1 -1
- package/lib/network/explorer/types.d.ts +6 -0
- package/lib/network/explorer/types.d.ts.map +1 -1
- package/lib/network/explorer/types.js +8 -1
- package/lib/network/explorer/types.js.map +1 -1
- package/lib/network/rewards.d.ts +11 -0
- package/lib/network/rewards.d.ts.map +1 -0
- package/lib/network/rewards.js +32 -0
- package/lib/network/rewards.js.map +1 -0
- package/lib/types/blockscoutV2.d.ts +80 -0
- package/lib/types/blockscoutV2.d.ts.map +1 -0
- package/lib/types/blockscoutV2.js +5 -0
- package/lib/types/blockscoutV2.js.map +1 -0
- package/lib/types/index.d.ts +1 -0
- package/lib/types/index.d.ts.map +1 -1
- package/lib/types/index.js +1 -0
- package/lib/types/index.js.map +1 -1
- package/lib-es/adapters/blockscoutV2.d.ts +40 -0
- package/lib-es/adapters/blockscoutV2.d.ts.map +1 -0
- package/lib-es/adapters/blockscoutV2.js +168 -0
- package/lib-es/adapters/blockscoutV2.js.map +1 -0
- package/lib-es/adapters/index.d.ts +1 -0
- package/lib-es/adapters/index.d.ts.map +1 -1
- package/lib-es/adapters/index.js +1 -0
- package/lib-es/adapters/index.js.map +1 -1
- package/lib-es/chains.d.ts +1 -1
- package/lib-es/chains.js +1 -1
- package/lib-es/chains.js.map +1 -1
- package/lib-es/config.d.ts +1499 -0
- package/lib-es/config.d.ts.map +1 -1
- package/lib-es/config.js +967 -0
- package/lib-es/config.js.map +1 -1
- package/lib-es/logic/internalTransactionsFetcher.d.ts.map +1 -1
- package/lib-es/logic/internalTransactionsFetcher.js +14 -3
- package/lib-es/logic/internalTransactionsFetcher.js.map +1 -1
- package/lib-es/network/blockscoutV2.d.ts +35 -0
- package/lib-es/network/blockscoutV2.d.ts.map +1 -0
- package/lib-es/network/blockscoutV2.js +271 -0
- package/lib-es/network/blockscoutV2.js.map +1 -0
- package/lib-es/network/explorer/etherscan.d.ts.map +1 -1
- package/lib-es/network/explorer/etherscan.js +2 -19
- package/lib-es/network/explorer/etherscan.js.map +1 -1
- package/lib-es/network/explorer/index.d.ts.map +1 -1
- package/lib-es/network/explorer/index.js +5 -0
- package/lib-es/network/explorer/index.js.map +1 -1
- package/lib-es/network/explorer/types.d.ts +6 -0
- package/lib-es/network/explorer/types.d.ts.map +1 -1
- package/lib-es/network/explorer/types.js +6 -0
- package/lib-es/network/explorer/types.js.map +1 -1
- package/lib-es/network/rewards.d.ts +11 -0
- package/lib-es/network/rewards.d.ts.map +1 -0
- package/lib-es/network/rewards.js +29 -0
- package/lib-es/network/rewards.js.map +1 -0
- package/lib-es/types/blockscoutV2.d.ts +80 -0
- package/lib-es/types/blockscoutV2.d.ts.map +1 -0
- package/lib-es/types/blockscoutV2.js +4 -0
- package/lib-es/types/blockscoutV2.js.map +1 -0
- package/lib-es/types/index.d.ts +1 -0
- package/lib-es/types/index.d.ts.map +1 -1
- package/lib-es/types/index.js +1 -0
- package/lib-es/types/index.js.map +1 -1
- package/package.json +1 -1
- package/src/adapters/blockscoutV2.test.ts +296 -0
- package/src/adapters/blockscoutV2.ts +244 -0
- package/src/adapters/index.ts +1 -0
- package/src/api/tests/index.alpen_testnet.integ.test.ts +73 -0
- package/src/api/tests/index.integ.test.ts +4 -2
- package/src/api/tests/index.scroll.integ.test.ts +168 -0
- package/src/api/tests/index.shape.integ.test.ts +34 -0
- package/src/chains.ts +1 -1
- package/src/config.ts +993 -0
- package/src/logic/internalTransactionsFetcher.ts +20 -3
- package/src/logic/tests/internalTransactionsFetcher.test.ts +51 -0
- package/src/network/blockscoutV2.ts +460 -0
- package/src/network/explorer/etherscan.ts +2 -29
- package/src/network/explorer/index.ts +5 -0
- package/src/network/explorer/types.ts +9 -0
- package/src/network/rewards.ts +47 -0
- package/src/network/tests/blockscoutV2.test.ts +565 -0
- package/src/network/tests/explorer/index.test.ts +21 -0
- package/src/types/blockscoutV2.ts +85 -0
- package/src/types/index.ts +1 -0
|
@@ -0,0 +1,244 @@
|
|
|
1
|
+
// SPDX-FileCopyrightText: © 2026 LEDGER SAS
|
|
2
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
|
|
4
|
+
import type { ChainId } from '../config'
|
|
5
|
+
import type {
|
|
6
|
+
BlockscoutV2InternalTransaction,
|
|
7
|
+
BlockscoutV2TokenTransfer,
|
|
8
|
+
BlockscoutV2Transaction,
|
|
9
|
+
EtherscanERC1155Event,
|
|
10
|
+
EtherscanERC20Event,
|
|
11
|
+
EtherscanERC721Event,
|
|
12
|
+
EtherscanInternalTransaction,
|
|
13
|
+
} from '../types'
|
|
14
|
+
import type { MemoNotSupported, Operation } from '@ledgerhq/coin-module-framework/api/types'
|
|
15
|
+
import type { Logger } from '@ledgerhq/coin-module-framework/config'
|
|
16
|
+
import { InvalidExplorerResponse } from '../errors'
|
|
17
|
+
import {
|
|
18
|
+
etherscanERC1155EventToOperations,
|
|
19
|
+
etherscanERC20EventToOperations,
|
|
20
|
+
etherscanERC721EventToOperations,
|
|
21
|
+
etherscanInternalTransactionToOperations,
|
|
22
|
+
etherscanOperationToOperations,
|
|
23
|
+
} from './etherscan'
|
|
24
|
+
|
|
25
|
+
// Blockscout v2 items are mapped onto the Etherscan-like records, so that both explorers produce the
|
|
26
|
+
// same operations (ids, types, details) from the same on-chain data.
|
|
27
|
+
|
|
28
|
+
/** Unix timestamp in seconds, as Etherscan-like explorers report it. Omitted when unknown. */
|
|
29
|
+
function timeStamp(timestamp: string | null): { timeStamp?: string } {
|
|
30
|
+
const ms = timestamp === null ? Number.NaN : Date.parse(timestamp)
|
|
31
|
+
return Number.isNaN(ms) ? {} : { timeStamp: String(Math.floor(ms / 1000)) }
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* Token transfers carry no nonce: drop the empty `sequence` the Etherscan-like adapters set, so
|
|
36
|
+
* `listOperations` falls back to the parent transaction's.
|
|
37
|
+
*/
|
|
38
|
+
function withoutEmptySequence(op: Operation<MemoNotSupported>): Operation<MemoNotSupported> {
|
|
39
|
+
if (op.details?.sequence !== '') return op
|
|
40
|
+
const { sequence: _, ...details } = op.details
|
|
41
|
+
return { ...op, details }
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Index of each item among the items of the same transaction, which makes the operation ids unique
|
|
46
|
+
* when a transaction emits several transfers (same scheme as the Etherscan-like explorer).
|
|
47
|
+
*/
|
|
48
|
+
function indexByTransaction<T extends { transaction_hash: string }>(
|
|
49
|
+
items: T[]
|
|
50
|
+
): Array<[T, number]> {
|
|
51
|
+
const counts = new Map<string, number>()
|
|
52
|
+
return items.map((item) => {
|
|
53
|
+
const index = counts.get(item.transaction_hash) ?? 0
|
|
54
|
+
counts.set(item.transaction_hash, index + 1)
|
|
55
|
+
return [item, index]
|
|
56
|
+
})
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Adapter to convert a Blockscout v2 transaction into Ledger Live Operations.
|
|
61
|
+
* It can return more than one operation in case of self-send.
|
|
62
|
+
*
|
|
63
|
+
* The fee is the one Blockscout reports as paid, which includes the L1 data fee of rollups.
|
|
64
|
+
*
|
|
65
|
+
* @param blockHash hash of the transaction's block, which the v2 transaction list does not report
|
|
66
|
+
*/
|
|
67
|
+
export const blockscoutV2TransactionToOperations = (
|
|
68
|
+
address: string,
|
|
69
|
+
chainId: ChainId,
|
|
70
|
+
tx: BlockscoutV2Transaction,
|
|
71
|
+
blockHash: string,
|
|
72
|
+
logger: Logger
|
|
73
|
+
): Array<Operation<MemoNotSupported>> => {
|
|
74
|
+
const input = tx.raw_input ?? ''
|
|
75
|
+
const failed = tx.status === 'error'
|
|
76
|
+
const operations = etherscanOperationToOperations(
|
|
77
|
+
address,
|
|
78
|
+
chainId,
|
|
79
|
+
{
|
|
80
|
+
blockNumber: String(tx.block_number ?? 0),
|
|
81
|
+
...timeStamp(tx.timestamp),
|
|
82
|
+
hash: tx.hash,
|
|
83
|
+
nonce: String(tx.nonce),
|
|
84
|
+
blockHash,
|
|
85
|
+
transactionIndex: String(tx.position ?? ''),
|
|
86
|
+
from: tx.from.hash,
|
|
87
|
+
to: tx.to?.hash ?? '',
|
|
88
|
+
value: tx.value,
|
|
89
|
+
gas: tx.gas_limit,
|
|
90
|
+
gasPrice: tx.gas_price ?? '',
|
|
91
|
+
isError: failed ? '1' : '0',
|
|
92
|
+
txreceipt_status: failed ? '0' : '1',
|
|
93
|
+
input,
|
|
94
|
+
contractAddress: tx.created_contract?.hash ?? '',
|
|
95
|
+
cumulativeGasUsed: '',
|
|
96
|
+
gasUsed: tx.gas_used ?? '',
|
|
97
|
+
confirmations: '',
|
|
98
|
+
methodId: input.length >= 10 ? input.slice(0, 10) : '',
|
|
99
|
+
functionName: tx.method ?? '',
|
|
100
|
+
},
|
|
101
|
+
logger
|
|
102
|
+
)
|
|
103
|
+
// A missing fee must fail rather than silently become 0 (`BigInt('')` is `0n`)
|
|
104
|
+
if (tx.fee.type !== 'actual' || !/^\d+$/.test(tx.fee.value)) {
|
|
105
|
+
throw new InvalidExplorerResponse(`Missing or invalid fee in Blockscout v2 transaction`, {
|
|
106
|
+
hash: tx.hash,
|
|
107
|
+
fee: JSON.stringify(tx.fee),
|
|
108
|
+
})
|
|
109
|
+
}
|
|
110
|
+
const fees = BigInt(tx.fee.value)
|
|
111
|
+
return operations.map((op) => ({ ...op, tx: { ...op.tx, fees } }))
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
/** Fields shared by the Etherscan-like ERC-20, ERC-721 and ERC-1155 events */
|
|
115
|
+
type TokenEventBase = Omit<EtherscanERC20Event, 'value' | 'tokenDecimal'>
|
|
116
|
+
|
|
117
|
+
function tokenTransferBase(transfer: BlockscoutV2TokenTransfer): TokenEventBase {
|
|
118
|
+
return {
|
|
119
|
+
blockNumber: String(transfer.block_number),
|
|
120
|
+
...timeStamp(transfer.timestamp),
|
|
121
|
+
hash: transfer.transaction_hash,
|
|
122
|
+
nonce: '',
|
|
123
|
+
blockHash: transfer.block_hash,
|
|
124
|
+
from: transfer.from.hash,
|
|
125
|
+
contractAddress: transfer.token.address_hash,
|
|
126
|
+
to: transfer.to.hash,
|
|
127
|
+
tokenName: transfer.token.name ?? '',
|
|
128
|
+
tokenSymbol: transfer.token.symbol ?? '',
|
|
129
|
+
transactionIndex: '',
|
|
130
|
+
gas: '',
|
|
131
|
+
gasPrice: '',
|
|
132
|
+
gasUsed: '',
|
|
133
|
+
cumulativeGasUsed: '',
|
|
134
|
+
input: '',
|
|
135
|
+
confirmations: '',
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
/**
|
|
140
|
+
* Adapter to convert Blockscout v2 ERC-20 transfers into Ledger Live Operations.
|
|
141
|
+
* A transfer can produce up to 2 operations in case of self-send or airdrop.
|
|
142
|
+
*
|
|
143
|
+
* The fees are left to 0: `listOperations` takes them from the parent transaction.
|
|
144
|
+
*/
|
|
145
|
+
export const blockscoutV2ERC20TransfersToOperations = (
|
|
146
|
+
address: string,
|
|
147
|
+
transfers: BlockscoutV2TokenTransfer[],
|
|
148
|
+
logger: Logger
|
|
149
|
+
): Array<Operation<MemoNotSupported>> =>
|
|
150
|
+
indexByTransaction(transfers).flatMap(([transfer, index]) => {
|
|
151
|
+
const event: EtherscanERC20Event = {
|
|
152
|
+
...tokenTransferBase(transfer),
|
|
153
|
+
value: transfer.total?.value ?? '0',
|
|
154
|
+
tokenDecimal: transfer.token.decimals ?? '',
|
|
155
|
+
}
|
|
156
|
+
return etherscanERC20EventToOperations(address, event, index, logger).map(withoutEmptySequence)
|
|
157
|
+
})
|
|
158
|
+
|
|
159
|
+
/**
|
|
160
|
+
* Adapter to convert Blockscout v2 ERC-721 transfers into Ledger Live Operations.
|
|
161
|
+
*/
|
|
162
|
+
export const blockscoutV2ERC721TransfersToOperations = (
|
|
163
|
+
address: string,
|
|
164
|
+
transfers: BlockscoutV2TokenTransfer[],
|
|
165
|
+
logger: Logger
|
|
166
|
+
): Array<Operation<MemoNotSupported>> =>
|
|
167
|
+
indexByTransaction(transfers).flatMap(([transfer, index]) => {
|
|
168
|
+
const event: EtherscanERC721Event = {
|
|
169
|
+
...tokenTransferBase(transfer),
|
|
170
|
+
tokenID: transfer.total?.token_id ?? '',
|
|
171
|
+
tokenDecimal: transfer.token.decimals ?? '',
|
|
172
|
+
}
|
|
173
|
+
return etherscanERC721EventToOperations(address, event, index, logger).map(withoutEmptySequence)
|
|
174
|
+
})
|
|
175
|
+
|
|
176
|
+
/**
|
|
177
|
+
* Adapter to convert Blockscout v2 ERC-1155 transfers into Ledger Live Operations.
|
|
178
|
+
*/
|
|
179
|
+
export const blockscoutV2ERC1155TransfersToOperations = (
|
|
180
|
+
address: string,
|
|
181
|
+
transfers: BlockscoutV2TokenTransfer[],
|
|
182
|
+
logger: Logger
|
|
183
|
+
): Array<Operation<MemoNotSupported>> =>
|
|
184
|
+
indexByTransaction(transfers).flatMap(([transfer, index]) => {
|
|
185
|
+
const event: EtherscanERC1155Event = {
|
|
186
|
+
...tokenTransferBase(transfer),
|
|
187
|
+
tokenID: transfer.total?.token_id ?? '',
|
|
188
|
+
tokenValue: transfer.total?.value ?? '0',
|
|
189
|
+
}
|
|
190
|
+
return etherscanERC1155EventToOperations(address, event, index, logger).map(
|
|
191
|
+
withoutEmptySequence
|
|
192
|
+
)
|
|
193
|
+
})
|
|
194
|
+
|
|
195
|
+
/**
|
|
196
|
+
* Map a Blockscout v2 internal transaction onto the Etherscan-like record, so that both explorers
|
|
197
|
+
* share the same internal transaction adapters (`listOperations` and `getBlock` paths).
|
|
198
|
+
*/
|
|
199
|
+
export const blockscoutV2InternalTransactionToEtherscan = (
|
|
200
|
+
internalTx: BlockscoutV2InternalTransaction
|
|
201
|
+
): EtherscanInternalTransaction => ({
|
|
202
|
+
blockNumber: String(internalTx.block_number),
|
|
203
|
+
...timeStamp(internalTx.timestamp),
|
|
204
|
+
hash: internalTx.transaction_hash,
|
|
205
|
+
from: internalTx.from.hash,
|
|
206
|
+
// A contract creation has no `to`: its recipient is the created contract
|
|
207
|
+
to: internalTx.to?.hash ?? internalTx.created_contract?.hash ?? '',
|
|
208
|
+
value: internalTx.value,
|
|
209
|
+
contractAddress: internalTx.created_contract?.hash ?? '',
|
|
210
|
+
input: '',
|
|
211
|
+
type: internalTx.type,
|
|
212
|
+
callType: internalTx.type,
|
|
213
|
+
gas: internalTx.gas_limit ?? '',
|
|
214
|
+
gasUsed: '',
|
|
215
|
+
traceId: String(internalTx.index),
|
|
216
|
+
isError: internalTx.success ? '0' : '1',
|
|
217
|
+
errCode: internalTx.error ?? '',
|
|
218
|
+
})
|
|
219
|
+
|
|
220
|
+
/**
|
|
221
|
+
* Adapter to convert Blockscout v2 internal transactions into Ledger Live Operations.
|
|
222
|
+
*
|
|
223
|
+
* @param blockHashes hash of each block, which the v2 internal transaction list does not report
|
|
224
|
+
*/
|
|
225
|
+
export const blockscoutV2InternalTransactionsToOperations = (
|
|
226
|
+
address: string,
|
|
227
|
+
internalTransactions: BlockscoutV2InternalTransaction[],
|
|
228
|
+
blockHashes: ReadonlyMap<number, string>,
|
|
229
|
+
logger: Logger
|
|
230
|
+
): Array<Operation<MemoNotSupported>> =>
|
|
231
|
+
indexByTransaction(internalTransactions).flatMap(([internalTx, index]) =>
|
|
232
|
+
etherscanInternalTransactionToOperations(
|
|
233
|
+
address,
|
|
234
|
+
blockscoutV2InternalTransactionToEtherscan(internalTx),
|
|
235
|
+
index,
|
|
236
|
+
logger
|
|
237
|
+
).map((op) => ({
|
|
238
|
+
...op,
|
|
239
|
+
tx: {
|
|
240
|
+
...op.tx,
|
|
241
|
+
block: { ...op.tx.block, hash: blockHashes.get(internalTx.block_number) ?? '' },
|
|
242
|
+
},
|
|
243
|
+
}))
|
|
244
|
+
)
|
package/src/adapters/index.ts
CHANGED
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
// SPDX-FileCopyrightText: © 2026 LEDGER SAS
|
|
2
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
|
|
4
|
+
import type { EvmConfigInfo } from '../../config'
|
|
5
|
+
import { internalTxSourcesFromList } from '../../config'
|
|
6
|
+
import { createMockEvmContext } from '../../fixtures/context.fixtures'
|
|
7
|
+
import { createApi } from '../index'
|
|
8
|
+
|
|
9
|
+
// Alpen Testnet runs Blockscout v9.0.2: its v2 token transfers report the token standard only in
|
|
10
|
+
// `token.type`, not in `token_type`.
|
|
11
|
+
describe('EVM Alpen Testnet (blockscout-v2 explorer, Blockscout v9)', () => {
|
|
12
|
+
const config: Partial<EvmConfigInfo> = {
|
|
13
|
+
chainId: 20310,
|
|
14
|
+
node: { type: 'external', uri: 'https://alpen.testnet.alpen.org' },
|
|
15
|
+
explorer: { type: 'blockscout-v2', uri: 'https://explorer.testnet.alpen.org/api/v2' },
|
|
16
|
+
}
|
|
17
|
+
const module = createApi()
|
|
18
|
+
const context = createMockEvmContext(config)
|
|
19
|
+
|
|
20
|
+
const usdc = '0xd7cB0E0692f2D55A17bA81c1fE5501D66774fC4A'
|
|
21
|
+
|
|
22
|
+
it('listOperations lists the ERC-20 transfers with the block hash of getBlock', async () => {
|
|
23
|
+
const address = '0xDeaD1F5aF792afc125812E875A891b038f888258'
|
|
24
|
+
const height = 224172
|
|
25
|
+
const { items } = await module.listOperations(context, address, {
|
|
26
|
+
minHeight: 0,
|
|
27
|
+
cursor: String(height),
|
|
28
|
+
limit: 5,
|
|
29
|
+
order: 'desc',
|
|
30
|
+
})
|
|
31
|
+
const block = await module.getBlock(context, height)
|
|
32
|
+
|
|
33
|
+
expect(items.filter((o) => o.asset.type === 'erc20').length).toBeGreaterThan(0)
|
|
34
|
+
expect(
|
|
35
|
+
items.find(
|
|
36
|
+
(o) =>
|
|
37
|
+
o.tx.hash === '0xe27e595026596fb2b08bf2c4857817afab00a926483e2f16649dbb8749a34826' &&
|
|
38
|
+
o.asset.type === 'erc20'
|
|
39
|
+
)
|
|
40
|
+
).toMatchObject({
|
|
41
|
+
type: 'OUT',
|
|
42
|
+
value: 8_000_000n,
|
|
43
|
+
asset: { type: 'erc20', assetReference: usdc },
|
|
44
|
+
senders: [address],
|
|
45
|
+
recipients: ['0x25547a75818577AF0579308bDDC59Cb3E9E26d5b'],
|
|
46
|
+
tx: { block: { height, hash: block.info.hash } },
|
|
47
|
+
})
|
|
48
|
+
})
|
|
49
|
+
|
|
50
|
+
it('getBlock reads internal transactions from the Blockscout v2 API', async () => {
|
|
51
|
+
// Only the explorer source: the node refuses `trace_*` and `debug_*`
|
|
52
|
+
const explorerOnly = createMockEvmContext({
|
|
53
|
+
...config,
|
|
54
|
+
getBlockInternalTxsSources: internalTxSourcesFromList(['explorer']),
|
|
55
|
+
})
|
|
56
|
+
|
|
57
|
+
// Faucet call: the faucet contract sends 0.1 tBTC to the caller's recipient
|
|
58
|
+
const block = await module.getBlock(explorerOnly, 221244)
|
|
59
|
+
const operations = block.transactions.find(
|
|
60
|
+
(t) => t.hash === '0xd8e37946b7f290047ae751c09e12dd53468a5b25df188ce3fcaf1ab078daee4b'
|
|
61
|
+
)?.operations
|
|
62
|
+
|
|
63
|
+
expect(operations).toContainEqual(
|
|
64
|
+
expect.objectContaining({
|
|
65
|
+
type: 'transfer',
|
|
66
|
+
address: '0xe59fC04559382d8d22235Cf4C7766e1fff5850C2',
|
|
67
|
+
peer: '0xAd77b4f3A3eA33A0201754CCE8683704B4A10575',
|
|
68
|
+
asset: { type: 'native' },
|
|
69
|
+
amount: 100_000_000_000_000_000n,
|
|
70
|
+
})
|
|
71
|
+
)
|
|
72
|
+
})
|
|
73
|
+
})
|
|
@@ -809,7 +809,7 @@ describe.each([
|
|
|
809
809
|
type: 'send-legacy',
|
|
810
810
|
intentType: 'transaction',
|
|
811
811
|
amount: 1000000n, // 1 USDC (6 decimals)
|
|
812
|
-
sender: '
|
|
812
|
+
sender: '0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640', // Uniswap v3 USDC/WETH pool, always holds USDC
|
|
813
813
|
recipient: '0x7b2C7232f9E38F30E2868f0E5Bf311Cd83554b5A',
|
|
814
814
|
data: { type: 'buffer', value: Buffer.from([]) },
|
|
815
815
|
asset: {
|
|
@@ -829,6 +829,7 @@ describe.each([
|
|
|
829
829
|
type: 0,
|
|
830
830
|
},
|
|
831
831
|
})
|
|
832
|
+
expect(result.parameters?.gasLimit).toBeGreaterThan(0)
|
|
832
833
|
expect(result.value).toBeGreaterThan(0)
|
|
833
834
|
expect(result.parameters?.gasPrice).toBeGreaterThan(0)
|
|
834
835
|
})
|
|
@@ -838,7 +839,7 @@ describe.each([
|
|
|
838
839
|
type: 'send-eip1559',
|
|
839
840
|
intentType: 'transaction',
|
|
840
841
|
amount: 1000000n, // 1 USDC (6 decimals)
|
|
841
|
-
sender: '
|
|
842
|
+
sender: '0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640', // Uniswap v3 USDC/WETH pool, always holds USDC
|
|
842
843
|
recipient: '0x7b2C7232f9E38F30E2868f0E5Bf311Cd83554b5A',
|
|
843
844
|
data: { type: 'buffer', value: Buffer.from([]) },
|
|
844
845
|
asset: {
|
|
@@ -858,6 +859,7 @@ describe.each([
|
|
|
858
859
|
type: 2,
|
|
859
860
|
},
|
|
860
861
|
})
|
|
862
|
+
expect(result.parameters?.gasLimit).toBeGreaterThan(0)
|
|
861
863
|
expect(result.value).toBeGreaterThan(0)
|
|
862
864
|
expect(result.parameters?.maxFeePerGas).toBeGreaterThan(0)
|
|
863
865
|
expect(result.parameters?.maxPriorityFeePerGas).toBeGreaterThan(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,
|