@aztec/archiver 0.0.1-commit.5daedc8 → 0.0.1-commit.6201a7b05

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 (218) hide show
  1. package/README.md +162 -22
  2. package/dest/archiver.d.ts +147 -0
  3. package/dest/archiver.d.ts.map +1 -0
  4. package/dest/archiver.js +788 -0
  5. package/dest/config.d.ts +32 -0
  6. package/dest/config.d.ts.map +1 -0
  7. package/dest/config.js +83 -0
  8. package/dest/errors.d.ts +92 -0
  9. package/dest/errors.d.ts.map +1 -0
  10. package/dest/errors.js +136 -0
  11. package/dest/factory.d.ts +8 -7
  12. package/dest/factory.d.ts.map +1 -1
  13. package/dest/factory.js +100 -15
  14. package/dest/index.d.ts +12 -4
  15. package/dest/index.d.ts.map +1 -1
  16. package/dest/index.js +10 -3
  17. package/dest/interfaces.d.ts +9 -0
  18. package/dest/interfaces.d.ts.map +1 -0
  19. package/dest/interfaces.js +3 -0
  20. package/dest/l1/bin/retrieve-calldata.d.ts +3 -0
  21. package/dest/l1/bin/retrieve-calldata.d.ts.map +1 -0
  22. package/dest/l1/bin/retrieve-calldata.js +152 -0
  23. package/dest/l1/calldata_retriever.d.ts +136 -0
  24. package/dest/l1/calldata_retriever.d.ts.map +1 -0
  25. package/dest/l1/calldata_retriever.js +408 -0
  26. package/dest/l1/data_retrieval.d.ts +97 -0
  27. package/dest/l1/data_retrieval.d.ts.map +1 -0
  28. package/dest/{archiver → l1}/data_retrieval.js +86 -165
  29. package/dest/l1/debug_tx.d.ts +19 -0
  30. package/dest/l1/debug_tx.d.ts.map +1 -0
  31. package/dest/l1/debug_tx.js +73 -0
  32. package/dest/l1/spire_proposer.d.ts +70 -0
  33. package/dest/l1/spire_proposer.d.ts.map +1 -0
  34. package/dest/l1/spire_proposer.js +149 -0
  35. package/dest/l1/trace_tx.d.ts +97 -0
  36. package/dest/l1/trace_tx.d.ts.map +1 -0
  37. package/dest/l1/trace_tx.js +91 -0
  38. package/dest/l1/types.d.ts +12 -0
  39. package/dest/l1/types.d.ts.map +1 -0
  40. package/dest/l1/types.js +3 -0
  41. package/dest/l1/validate_historical_logs.d.ts +23 -0
  42. package/dest/l1/validate_historical_logs.d.ts.map +1 -0
  43. package/dest/l1/validate_historical_logs.js +108 -0
  44. package/dest/l1/validate_trace.d.ts +32 -0
  45. package/dest/l1/validate_trace.d.ts.map +1 -0
  46. package/dest/l1/validate_trace.js +154 -0
  47. package/dest/modules/data_source_base.d.ts +95 -0
  48. package/dest/modules/data_source_base.d.ts.map +1 -0
  49. package/dest/modules/data_source_base.js +234 -0
  50. package/dest/modules/data_store_updater.d.ts +93 -0
  51. package/dest/modules/data_store_updater.d.ts.map +1 -0
  52. package/dest/modules/data_store_updater.js +345 -0
  53. package/dest/modules/instrumentation.d.ts +55 -0
  54. package/dest/modules/instrumentation.d.ts.map +1 -0
  55. package/dest/modules/instrumentation.js +143 -0
  56. package/dest/modules/l1_synchronizer.d.ts +77 -0
  57. package/dest/modules/l1_synchronizer.d.ts.map +1 -0
  58. package/dest/modules/l1_synchronizer.js +1265 -0
  59. package/dest/modules/validation.d.ts +18 -0
  60. package/dest/modules/validation.d.ts.map +1 -0
  61. package/dest/{archiver → modules}/validation.js +13 -7
  62. package/dest/store/block_store.d.ts +262 -0
  63. package/dest/store/block_store.d.ts.map +1 -0
  64. package/dest/store/block_store.js +1048 -0
  65. package/dest/store/contract_class_store.d.ts +17 -0
  66. package/dest/store/contract_class_store.d.ts.map +1 -0
  67. package/dest/store/contract_class_store.js +64 -0
  68. package/dest/store/contract_instance_store.d.ts +24 -0
  69. package/dest/store/contract_instance_store.d.ts.map +1 -0
  70. package/dest/{archiver/kv_archiver_store → store}/contract_instance_store.js +7 -3
  71. package/dest/store/kv_archiver_store.d.ts +401 -0
  72. package/dest/store/kv_archiver_store.d.ts.map +1 -0
  73. package/dest/store/kv_archiver_store.js +525 -0
  74. package/dest/store/l2_tips_cache.d.ts +20 -0
  75. package/dest/store/l2_tips_cache.d.ts.map +1 -0
  76. package/dest/store/l2_tips_cache.js +109 -0
  77. package/dest/store/log_store.d.ts +57 -0
  78. package/dest/store/log_store.d.ts.map +1 -0
  79. package/dest/store/log_store.js +531 -0
  80. package/dest/store/message_store.d.ts +44 -0
  81. package/dest/store/message_store.d.ts.map +1 -0
  82. package/dest/{archiver/kv_archiver_store → store}/message_store.js +36 -23
  83. package/dest/{archiver/structs → structs}/data_retrieval.d.ts +1 -1
  84. package/dest/structs/data_retrieval.d.ts.map +1 -0
  85. package/dest/structs/inbox_message.d.ts +15 -0
  86. package/dest/structs/inbox_message.d.ts.map +1 -0
  87. package/dest/{archiver/structs → structs}/inbox_message.js +6 -5
  88. package/dest/structs/published.d.ts +2 -0
  89. package/dest/structs/published.d.ts.map +1 -0
  90. package/dest/test/fake_l1_state.d.ts +214 -0
  91. package/dest/test/fake_l1_state.d.ts.map +1 -0
  92. package/dest/test/fake_l1_state.js +517 -0
  93. package/dest/test/index.d.ts +2 -1
  94. package/dest/test/index.d.ts.map +1 -1
  95. package/dest/test/index.js +4 -1
  96. package/dest/test/mock_archiver.d.ts +16 -8
  97. package/dest/test/mock_archiver.d.ts.map +1 -1
  98. package/dest/test/mock_archiver.js +19 -14
  99. package/dest/test/mock_l1_to_l2_message_source.d.ts +7 -6
  100. package/dest/test/mock_l1_to_l2_message_source.d.ts.map +1 -1
  101. package/dest/test/mock_l1_to_l2_message_source.js +23 -12
  102. package/dest/test/mock_l2_block_source.d.ts +68 -20
  103. package/dest/test/mock_l2_block_source.d.ts.map +1 -1
  104. package/dest/test/mock_l2_block_source.js +298 -85
  105. package/dest/test/mock_structs.d.ts +83 -4
  106. package/dest/test/mock_structs.d.ts.map +1 -1
  107. package/dest/test/mock_structs.js +157 -11
  108. package/dest/test/noop_l1_archiver.d.ts +26 -0
  109. package/dest/test/noop_l1_archiver.d.ts.map +1 -0
  110. package/dest/test/noop_l1_archiver.js +74 -0
  111. package/package.json +20 -20
  112. package/src/archiver.ts +566 -0
  113. package/src/{archiver/config.ts → config.ts} +51 -14
  114. package/src/errors.ts +213 -0
  115. package/src/factory.ts +155 -17
  116. package/src/index.ts +12 -3
  117. package/src/interfaces.ts +9 -0
  118. package/src/l1/README.md +55 -0
  119. package/src/l1/bin/retrieve-calldata.ts +194 -0
  120. package/src/l1/calldata_retriever.ts +523 -0
  121. package/src/{archiver → l1}/data_retrieval.ts +155 -247
  122. package/src/l1/debug_tx.ts +99 -0
  123. package/src/l1/spire_proposer.ts +152 -0
  124. package/src/l1/trace_tx.ts +128 -0
  125. package/src/l1/types.ts +13 -0
  126. package/src/l1/validate_historical_logs.ts +140 -0
  127. package/src/l1/validate_trace.ts +229 -0
  128. package/src/modules/data_source_base.ts +364 -0
  129. package/src/modules/data_store_updater.ts +465 -0
  130. package/src/modules/instrumentation.ts +204 -0
  131. package/src/modules/l1_synchronizer.ts +1126 -0
  132. package/src/{archiver → modules}/validation.ts +21 -15
  133. package/src/store/block_store.ts +1361 -0
  134. package/src/store/contract_class_store.ts +82 -0
  135. package/src/{archiver/kv_archiver_store → store}/contract_instance_store.ts +10 -7
  136. package/src/store/kv_archiver_store.ts +765 -0
  137. package/src/store/l2_tips_cache.ts +134 -0
  138. package/src/store/log_store.ts +733 -0
  139. package/src/{archiver/kv_archiver_store → store}/message_store.ts +48 -28
  140. package/src/{archiver/structs → structs}/inbox_message.ts +7 -7
  141. package/src/{archiver/structs → structs}/published.ts +0 -1
  142. package/src/test/fake_l1_state.ts +770 -0
  143. package/src/test/fixtures/debug_traceTransaction-multicall3.json +88 -0
  144. package/src/test/fixtures/debug_traceTransaction-multiplePropose.json +153 -0
  145. package/src/test/fixtures/debug_traceTransaction-proxied.json +122 -0
  146. package/src/test/fixtures/trace_transaction-multicall3.json +65 -0
  147. package/src/test/fixtures/trace_transaction-multiplePropose.json +319 -0
  148. package/src/test/fixtures/trace_transaction-proxied.json +128 -0
  149. package/src/test/fixtures/trace_transaction-randomRevert.json +216 -0
  150. package/src/test/index.ts +4 -0
  151. package/src/test/mock_archiver.ts +23 -16
  152. package/src/test/mock_l1_to_l2_message_source.ts +19 -11
  153. package/src/test/mock_l2_block_source.ts +367 -93
  154. package/src/test/mock_structs.ts +289 -13
  155. package/src/test/noop_l1_archiver.ts +117 -0
  156. package/dest/archiver/archiver.d.ts +0 -287
  157. package/dest/archiver/archiver.d.ts.map +0 -1
  158. package/dest/archiver/archiver.js +0 -1408
  159. package/dest/archiver/archiver_store.d.ts +0 -255
  160. package/dest/archiver/archiver_store.d.ts.map +0 -1
  161. package/dest/archiver/archiver_store.js +0 -4
  162. package/dest/archiver/archiver_store_test_suite.d.ts +0 -8
  163. package/dest/archiver/archiver_store_test_suite.d.ts.map +0 -1
  164. package/dest/archiver/archiver_store_test_suite.js +0 -1289
  165. package/dest/archiver/config.d.ts +0 -21
  166. package/dest/archiver/config.d.ts.map +0 -1
  167. package/dest/archiver/config.js +0 -55
  168. package/dest/archiver/data_retrieval.d.ts +0 -79
  169. package/dest/archiver/data_retrieval.d.ts.map +0 -1
  170. package/dest/archiver/errors.d.ts +0 -12
  171. package/dest/archiver/errors.d.ts.map +0 -1
  172. package/dest/archiver/errors.js +0 -17
  173. package/dest/archiver/index.d.ts +0 -7
  174. package/dest/archiver/index.d.ts.map +0 -1
  175. package/dest/archiver/index.js +0 -4
  176. package/dest/archiver/instrumentation.d.ts +0 -35
  177. package/dest/archiver/instrumentation.d.ts.map +0 -1
  178. package/dest/archiver/instrumentation.js +0 -140
  179. package/dest/archiver/kv_archiver_store/block_store.d.ts +0 -124
  180. package/dest/archiver/kv_archiver_store/block_store.d.ts.map +0 -1
  181. package/dest/archiver/kv_archiver_store/block_store.js +0 -370
  182. package/dest/archiver/kv_archiver_store/contract_class_store.d.ts +0 -18
  183. package/dest/archiver/kv_archiver_store/contract_class_store.d.ts.map +0 -1
  184. package/dest/archiver/kv_archiver_store/contract_class_store.js +0 -120
  185. package/dest/archiver/kv_archiver_store/contract_instance_store.d.ts +0 -24
  186. package/dest/archiver/kv_archiver_store/contract_instance_store.d.ts.map +0 -1
  187. package/dest/archiver/kv_archiver_store/kv_archiver_store.d.ts +0 -168
  188. package/dest/archiver/kv_archiver_store/kv_archiver_store.d.ts.map +0 -1
  189. package/dest/archiver/kv_archiver_store/kv_archiver_store.js +0 -296
  190. package/dest/archiver/kv_archiver_store/log_store.d.ts +0 -49
  191. package/dest/archiver/kv_archiver_store/log_store.d.ts.map +0 -1
  192. package/dest/archiver/kv_archiver_store/log_store.js +0 -336
  193. package/dest/archiver/kv_archiver_store/message_store.d.ts +0 -39
  194. package/dest/archiver/kv_archiver_store/message_store.d.ts.map +0 -1
  195. package/dest/archiver/structs/data_retrieval.d.ts.map +0 -1
  196. package/dest/archiver/structs/inbox_message.d.ts +0 -15
  197. package/dest/archiver/structs/inbox_message.d.ts.map +0 -1
  198. package/dest/archiver/structs/published.d.ts +0 -3
  199. package/dest/archiver/structs/published.d.ts.map +0 -1
  200. package/dest/archiver/validation.d.ts +0 -17
  201. package/dest/archiver/validation.d.ts.map +0 -1
  202. package/dest/rpc/index.d.ts +0 -9
  203. package/dest/rpc/index.d.ts.map +0 -1
  204. package/dest/rpc/index.js +0 -15
  205. package/src/archiver/archiver.ts +0 -1858
  206. package/src/archiver/archiver_store.ts +0 -305
  207. package/src/archiver/archiver_store_test_suite.ts +0 -1264
  208. package/src/archiver/errors.ts +0 -26
  209. package/src/archiver/index.ts +0 -6
  210. package/src/archiver/instrumentation.ts +0 -187
  211. package/src/archiver/kv_archiver_store/block_store.ts +0 -481
  212. package/src/archiver/kv_archiver_store/contract_class_store.ts +0 -176
  213. package/src/archiver/kv_archiver_store/kv_archiver_store.ts +0 -422
  214. package/src/archiver/kv_archiver_store/log_store.ts +0 -406
  215. package/src/rpc/index.ts +0 -16
  216. /package/dest/{archiver/structs → structs}/data_retrieval.js +0 -0
  217. /package/dest/{archiver/structs → structs}/published.js +0 -0
  218. /package/src/{archiver/structs → structs}/data_retrieval.ts +0 -0
@@ -0,0 +1,152 @@
1
+ #!/usr/bin/env node
2
+ import { CheckpointNumber } from '@aztec/foundation/branded-types';
3
+ import { EthAddress } from '@aztec/foundation/eth-address';
4
+ import { createLogger } from '@aztec/foundation/log';
5
+ import { RollupAbi } from '@aztec/l1-artifacts/RollupAbi';
6
+ import { createPublicClient, decodeEventLog, getAbiItem, http, toEventSelector } from 'viem';
7
+ import { mainnet } from 'viem/chains';
8
+ import { CalldataRetriever } from '../calldata_retriever.js';
9
+ const logger = createLogger('archiver:calldata-test');
10
+ function parseArgs() {
11
+ const args = process.argv.slice(2);
12
+ if (args.length < 2) {
13
+ // eslint-disable-next-line no-console
14
+ console.error('Usage: node index.js <rollup-address> <tx-hash> [target-committee-size]');
15
+ // eslint-disable-next-line no-console
16
+ console.error('');
17
+ // eslint-disable-next-line no-console
18
+ console.error('Environment variables:');
19
+ // eslint-disable-next-line no-console
20
+ console.error(' ETHEREUM_HOST or RPC_URL - Ethereum RPC endpoint');
21
+ // eslint-disable-next-line no-console
22
+ console.error('');
23
+ // eslint-disable-next-line no-console
24
+ console.error('Example:');
25
+ // eslint-disable-next-line no-console
26
+ console.error(' RPC_URL=https://eth-mainnet.g.alchemy.com/v2/YOUR-API-KEY \\');
27
+ // eslint-disable-next-line no-console
28
+ console.error(' node index.js 0x1234... 0xabcd... 32');
29
+ process.exit(1);
30
+ }
31
+ const rollupAddress = EthAddress.fromString(args[0]);
32
+ const txHash = args[1];
33
+ const targetCommitteeSize = args[2] ? parseInt(args[2], 10) : 24;
34
+ const rpcUrl = process.env.ETHEREUM_HOST || process.env.RPC_URL;
35
+ if (!rpcUrl) {
36
+ // eslint-disable-next-line no-console
37
+ console.error('Error: ETHEREUM_HOST or RPC_URL environment variable must be set');
38
+ process.exit(1);
39
+ }
40
+ if (targetCommitteeSize <= 0 || targetCommitteeSize > 256) {
41
+ // eslint-disable-next-line no-console
42
+ console.error('Error: target-committee-size must be between 1 and 256');
43
+ process.exit(1);
44
+ }
45
+ return {
46
+ rollupAddress,
47
+ txHash,
48
+ rpcUrl,
49
+ targetCommitteeSize
50
+ };
51
+ }
52
+ async function main() {
53
+ const { rollupAddress, txHash, rpcUrl, targetCommitteeSize } = parseArgs();
54
+ logger.info('Calldata Retriever Test Script');
55
+ logger.info('===============================');
56
+ logger.info(`Rollup Address: ${rollupAddress.toString()}`);
57
+ logger.info(`Transaction Hash: ${txHash}`);
58
+ logger.info(`RPC URL: ${rpcUrl}`);
59
+ logger.info(`Target Committee Size: ${targetCommitteeSize}`);
60
+ logger.info('');
61
+ try {
62
+ // Create viem public client
63
+ const publicClient = createPublicClient({
64
+ chain: mainnet,
65
+ transport: http(rpcUrl, {
66
+ batch: false
67
+ })
68
+ });
69
+ logger.info('Fetching transaction...');
70
+ const tx = await publicClient.getTransaction({
71
+ hash: txHash
72
+ });
73
+ if (!tx) {
74
+ throw new Error(`Transaction ${txHash} not found`);
75
+ }
76
+ logger.info(`Transaction found in block ${tx.blockNumber}`);
77
+ // Create CalldataRetriever
78
+ const retriever = new CalldataRetriever(publicClient, publicClient, targetCommitteeSize, undefined, logger, rollupAddress);
79
+ // Extract checkpoint number and hashes from transaction logs
80
+ logger.info('Decoding transaction to extract checkpoint number and hashes...');
81
+ const receipt = await publicClient.getTransactionReceipt({
82
+ hash: txHash
83
+ });
84
+ // Look for CheckpointProposed event
85
+ const checkpointProposedEventAbi = getAbiItem({
86
+ abi: RollupAbi,
87
+ name: 'CheckpointProposed'
88
+ });
89
+ const checkpointProposedLog = receipt.logs.find((log)=>{
90
+ try {
91
+ return log.address.toLowerCase() === rollupAddress.toString().toLowerCase() && log.topics[0] === toEventSelector(checkpointProposedEventAbi);
92
+ } catch {
93
+ return false;
94
+ }
95
+ });
96
+ if (!checkpointProposedLog || checkpointProposedLog.topics[1] === undefined) {
97
+ throw new Error(`Checkpoint proposed event not found`);
98
+ }
99
+ const checkpointNumber = CheckpointNumber.fromBigInt(BigInt(checkpointProposedLog.topics[1]));
100
+ // Decode the full event to extract attestationsHash and payloadDigest
101
+ const decodedEvent = decodeEventLog({
102
+ abi: RollupAbi,
103
+ data: checkpointProposedLog.data,
104
+ topics: checkpointProposedLog.topics
105
+ });
106
+ const eventArgs = decodedEvent.args;
107
+ if (!eventArgs.attestationsHash || !eventArgs.payloadDigest) {
108
+ throw new Error(`CheckpointProposed event missing attestationsHash or payloadDigest`);
109
+ }
110
+ const expectedHashes = {
111
+ attestationsHash: eventArgs.attestationsHash,
112
+ payloadDigest: eventArgs.payloadDigest
113
+ };
114
+ logger.info(`Checkpoint Number: ${checkpointNumber}`);
115
+ logger.info(`Attestations Hash: ${expectedHashes.attestationsHash}`);
116
+ logger.info(`Payload Digest: ${expectedHashes.payloadDigest}`);
117
+ logger.info('');
118
+ logger.info('Retrieving checkpoint from rollup transaction...');
119
+ logger.info('');
120
+ const result = await retriever.getCheckpointFromRollupTx(txHash, [], checkpointNumber, expectedHashes);
121
+ logger.info(' Successfully retrieved block header!');
122
+ logger.info('');
123
+ logger.info('Block Header Details:');
124
+ logger.info('====================');
125
+ logger.info(`Checkpoint Number: ${result.checkpointNumber}`);
126
+ logger.info(`Block Hash: ${result.blockHash}`);
127
+ logger.info(`Archive Root: ${result.archiveRoot.toString()}`);
128
+ logger.info('');
129
+ logger.info('Header:');
130
+ logger.info(` Slot Number: ${result.header.slotNumber.toString()}`);
131
+ logger.info(` Timestamp: ${result.header.timestamp.toString()}`);
132
+ logger.info(` Coinbase: ${result.header.coinbase.toString()}`);
133
+ logger.info(` Fee Recipient: ${result.header.feeRecipient.toString()}`);
134
+ logger.info(` Total Mana Used: ${result.header.totalManaUsed.toString()}`);
135
+ logger.info('');
136
+ logger.info('Attestations:');
137
+ logger.info(` Count: ${result.attestations.length}`);
138
+ logger.info(` Non-empty attestations: ${result.attestations.filter((a)=>!a.signature.isEmpty()).length}`);
139
+ process.exit(0);
140
+ } catch (error) {
141
+ logger.error('Error retrieving block header:');
142
+ logger.error(error instanceof Error ? error.message : String(error));
143
+ if (error instanceof Error && error.stack) {
144
+ logger.debug(error.stack);
145
+ }
146
+ process.exit(1);
147
+ }
148
+ }
149
+ // Only run if this is the main module
150
+ if (import.meta.url === `file://${process.argv[1]}`) {
151
+ void main();
152
+ }
@@ -0,0 +1,136 @@
1
+ import type { ViemPublicClient, ViemPublicDebugClient } from '@aztec/ethereum/types';
2
+ import { CheckpointNumber } from '@aztec/foundation/branded-types';
3
+ import { Fr } from '@aztec/foundation/curves/bn254';
4
+ import { EthAddress } from '@aztec/foundation/eth-address';
5
+ import type { Logger } from '@aztec/foundation/log';
6
+ import { CommitteeAttestation } from '@aztec/stdlib/block';
7
+ import { CheckpointHeader } from '@aztec/stdlib/rollup';
8
+ import { type Hex, type Transaction } from 'viem';
9
+ import type { ArchiverInstrumentation } from '../modules/instrumentation.js';
10
+ /** Decoded checkpoint data from a propose calldata. */
11
+ type CheckpointData = {
12
+ checkpointNumber: CheckpointNumber;
13
+ archiveRoot: Fr;
14
+ header: CheckpointHeader;
15
+ attestations: CommitteeAttestation[];
16
+ blockHash: string;
17
+ feeAssetPriceModifier: bigint;
18
+ };
19
+ /**
20
+ * Extracts calldata to the `propose` method of the rollup contract from an L1 transaction
21
+ * in order to reconstruct an L2 block header. Uses hash matching against expected hashes
22
+ * from the CheckpointProposed event to verify the correct propose calldata.
23
+ */
24
+ export declare class CalldataRetriever {
25
+ private readonly publicClient;
26
+ private readonly debugClient;
27
+ private readonly targetCommitteeSize;
28
+ private readonly instrumentation;
29
+ private readonly logger;
30
+ private readonly rollupAddress;
31
+ /** Tx hashes we've already logged for trace+debug failure (log once per tx per process). */
32
+ private static readonly traceFailureWarnedTxHashes;
33
+ /** Clears the trace-failure warned set. For testing only. */
34
+ static resetTraceFailureWarnedForTesting(): void;
35
+ constructor(publicClient: ViemPublicClient, debugClient: ViemPublicDebugClient, targetCommitteeSize: number, instrumentation: ArchiverInstrumentation | undefined, logger: Logger, rollupAddress: EthAddress);
36
+ private getSignatureContext;
37
+ /**
38
+ * Gets checkpoint header and metadata from the calldata of an L1 transaction.
39
+ * Tries multicall3 decoding, falls back to trace-based extraction.
40
+ * @param txHash - Hash of the tx that published it.
41
+ * @param blobHashes - Blob hashes for the checkpoint.
42
+ * @param checkpointNumber - Checkpoint number.
43
+ * @param expectedHashes - Expected hashes from the CheckpointProposed event for validation
44
+ * @returns Checkpoint header and metadata from the calldata, deserialized
45
+ */
46
+ getCheckpointFromRollupTx(txHash: `0x${string}`, _blobHashes: Buffer[], checkpointNumber: CheckpointNumber, expectedHashes: {
47
+ attestationsHash: Hex;
48
+ payloadDigest: Hex;
49
+ }): Promise<CheckpointData>;
50
+ /** Gets checkpoint data from a transaction by trying decode strategies then falling back to trace. */
51
+ protected getCheckpointFromTx(tx: Transaction, checkpointNumber: CheckpointNumber, expectedHashes: {
52
+ attestationsHash: Hex;
53
+ payloadDigest: Hex;
54
+ }): Promise<CheckpointData>;
55
+ /**
56
+ * Attempts to decode a transaction as a Spire Proposer multicall wrapper.
57
+ * If successful, iterates all wrapped calls and validates each as either multicall3
58
+ * or direct propose, verifying against expected hashes.
59
+ * @param tx - The transaction to decode
60
+ * @param expectedHashes - Expected hashes for hash-verified matching
61
+ * @param checkpointNumber - The checkpoint number
62
+ * @param blockHash - The L1 block hash
63
+ * @returns The checkpoint data if successfully decoded and validated, undefined otherwise
64
+ */
65
+ protected tryDecodeSpireProposer(tx: Transaction, expectedHashes: {
66
+ attestationsHash: Hex;
67
+ payloadDigest: Hex;
68
+ }, checkpointNumber: CheckpointNumber, blockHash: Hex): Promise<CheckpointData | undefined>;
69
+ /**
70
+ * Attempts to decode transaction input as multicall3 and extract propose calldata.
71
+ * Finds all calls matching the rollup address and propose selector, then decodes
72
+ * and verifies each candidate against expected hashes from the CheckpointProposed event.
73
+ * @param tx - The transaction-like object with to, input, and hash
74
+ * @param expectedHashes - Expected hashes from CheckpointProposed event
75
+ * @param checkpointNumber - The checkpoint number
76
+ * @param blockHash - The L1 block hash
77
+ * @returns The checkpoint data if successfully validated, undefined otherwise
78
+ */
79
+ protected tryDecodeMulticall3(tx: {
80
+ to: Hex | null | undefined;
81
+ input: Hex;
82
+ hash: Hex;
83
+ }, expectedHashes: {
84
+ attestationsHash: Hex;
85
+ payloadDigest: Hex;
86
+ }, checkpointNumber: CheckpointNumber, blockHash: Hex): CheckpointData | undefined;
87
+ /**
88
+ * Attempts to decode transaction as a direct propose call to the rollup contract.
89
+ * Decodes, verifies hashes, and builds checkpoint data in a single pass.
90
+ * @param tx - The transaction-like object with to, input, and hash
91
+ * @param expectedHashes - Expected hashes from CheckpointProposed event
92
+ * @param checkpointNumber - The checkpoint number
93
+ * @param blockHash - The L1 block hash
94
+ * @returns The checkpoint data if successfully validated, undefined otherwise
95
+ */
96
+ protected tryDecodeDirectPropose(tx: {
97
+ to: Hex | null | undefined;
98
+ input: Hex;
99
+ hash: Hex;
100
+ }, expectedHashes: {
101
+ attestationsHash: Hex;
102
+ payloadDigest: Hex;
103
+ }, checkpointNumber: CheckpointNumber, blockHash: Hex): CheckpointData | undefined;
104
+ /**
105
+ * Uses debug/trace RPC to extract the actual calldata from the successful propose call.
106
+ * This is the definitive fallback that works for any transaction pattern.
107
+ * Tries trace_transaction first, then falls back to debug_traceTransaction.
108
+ * @param txHash - The transaction hash to trace
109
+ * @returns The propose calldata from the successful call
110
+ */
111
+ protected extractCalldataViaTrace(txHash: Hex): Promise<Hex>;
112
+ /**
113
+ * Decodes propose calldata, verifies against expected hashes, and builds checkpoint data.
114
+ * Returns undefined on decode errors or hash mismatches (soft failure for try-based callers).
115
+ * @param proposeCalldata - The propose function calldata
116
+ * @param expectedHashes - Expected hashes from the CheckpointProposed event
117
+ * @param checkpointNumber - The checkpoint number
118
+ * @param blockHash - The L1 block hash
119
+ * @returns The decoded checkpoint data, or undefined on failure
120
+ */
121
+ protected tryDecodeAndVerifyPropose(proposeCalldata: Hex, expectedHashes: {
122
+ attestationsHash: Hex;
123
+ payloadDigest: Hex;
124
+ }, checkpointNumber: CheckpointNumber, blockHash: Hex): CheckpointData | undefined;
125
+ /** Computes the keccak256 hash of ABI-encoded CommitteeAttestations. */
126
+ private computeAttestationsHash;
127
+ /** Computes the keccak256 payload digest from the checkpoint header, archive root, and fee asset price modifier. */
128
+ private computePayloadDigest;
129
+ /**
130
+ * Extracts the CommitteeAttestations struct definition from RollupAbi.
131
+ * Finds the _attestations parameter by name in the propose function.
132
+ */
133
+ private getCommitteeAttestationsStructDef;
134
+ }
135
+ export {};
136
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2FsbGRhdGFfcmV0cmlldmVyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbDEvY2FsbGRhdGFfcmV0cmlldmVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sS0FBSyxFQUFFLGdCQUFnQixFQUFFLHFCQUFxQixFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFDckYsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFFbkUsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQ3BELE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUMzRCxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUVwRCxPQUFPLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUUzRCxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUV4RCxPQUFPLEVBRUwsS0FBSyxHQUFHLEVBQ1IsS0FBSyxXQUFXLEVBT2pCLE1BQU0sTUFBTSxDQUFDO0FBRWQsT0FBTyxLQUFLLEVBQUUsdUJBQXVCLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQU03RSx1REFBdUQ7QUFDdkQsS0FBSyxjQUFjLEdBQUc7SUFDcEIsZ0JBQWdCLEVBQUUsZ0JBQWdCLENBQUM7SUFDbkMsV0FBVyxFQUFFLEVBQUUsQ0FBQztJQUNoQixNQUFNLEVBQUUsZ0JBQWdCLENBQUM7SUFDekIsWUFBWSxFQUFFLG9CQUFvQixFQUFFLENBQUM7SUFDckMsU0FBUyxFQUFFLE1BQU0sQ0FBQztJQUNsQixxQkFBcUIsRUFBRSxNQUFNLENBQUM7Q0FDL0IsQ0FBQztBQUVGOzs7O0dBSUc7QUFDSCxxQkFBYSxpQkFBaUI7SUFVMUIsT0FBTyxDQUFDLFFBQVEsQ0FBQyxZQUFZO0lBQzdCLE9BQU8sQ0FBQyxRQUFRLENBQUMsV0FBVztJQUM1QixPQUFPLENBQUMs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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"calldata_retriever.d.ts","sourceRoot":"","sources":["../../src/l1/calldata_retriever.ts"],"names":[],"mappings":"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"}