@aztec/sequencer-client 0.0.1-commit.2448fdb → 0.0.1-commit.2606882

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 (118) hide show
  1. package/README.md +281 -21
  2. package/dest/client/sequencer-client.d.ts +4 -3
  3. package/dest/client/sequencer-client.d.ts.map +1 -1
  4. package/dest/client/sequencer-client.js +11 -11
  5. package/dest/config.d.ts +4 -1
  6. package/dest/config.d.ts.map +1 -1
  7. package/dest/config.js +35 -14
  8. package/dest/global_variable_builder/fee_predictor.d.ts +37 -0
  9. package/dest/global_variable_builder/fee_predictor.d.ts.map +1 -0
  10. package/dest/global_variable_builder/fee_predictor.js +128 -0
  11. package/dest/global_variable_builder/fee_provider.d.ts +21 -0
  12. package/dest/global_variable_builder/fee_provider.d.ts.map +1 -0
  13. package/dest/global_variable_builder/fee_provider.js +58 -0
  14. package/dest/global_variable_builder/global_builder.d.ts +4 -10
  15. package/dest/global_variable_builder/global_builder.d.ts.map +1 -1
  16. package/dest/global_variable_builder/global_builder.js +5 -40
  17. package/dest/global_variable_builder/index.d.ts +3 -1
  18. package/dest/global_variable_builder/index.d.ts.map +1 -1
  19. package/dest/global_variable_builder/index.js +2 -0
  20. package/dest/index.d.ts +2 -2
  21. package/dest/index.d.ts.map +1 -1
  22. package/dest/index.js +1 -1
  23. package/dest/publisher/config.d.ts +19 -3
  24. package/dest/publisher/config.d.ts.map +1 -1
  25. package/dest/publisher/config.js +25 -5
  26. package/dest/publisher/index.d.ts +2 -1
  27. package/dest/publisher/index.d.ts.map +1 -1
  28. package/dest/publisher/l1_tx_failed_store/factory.d.ts +11 -0
  29. package/dest/publisher/l1_tx_failed_store/factory.d.ts.map +1 -0
  30. package/dest/publisher/l1_tx_failed_store/factory.js +22 -0
  31. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts +58 -0
  32. package/dest/publisher/l1_tx_failed_store/failed_tx_store.d.ts.map +1 -0
  33. package/dest/publisher/l1_tx_failed_store/failed_tx_store.js +1 -0
  34. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts +15 -0
  35. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.d.ts.map +1 -0
  36. package/dest/publisher/l1_tx_failed_store/file_store_failed_tx_store.js +34 -0
  37. package/dest/publisher/l1_tx_failed_store/index.d.ts +4 -0
  38. package/dest/publisher/l1_tx_failed_store/index.d.ts.map +1 -0
  39. package/dest/publisher/l1_tx_failed_store/index.js +2 -0
  40. package/dest/publisher/sequencer-bundle-simulator.d.ts +96 -0
  41. package/dest/publisher/sequencer-bundle-simulator.d.ts.map +1 -0
  42. package/dest/publisher/sequencer-bundle-simulator.js +198 -0
  43. package/dest/publisher/sequencer-publisher-factory.d.ts +3 -5
  44. package/dest/publisher/sequencer-publisher-factory.d.ts.map +1 -1
  45. package/dest/publisher/sequencer-publisher-factory.js +16 -3
  46. package/dest/publisher/sequencer-publisher.d.ts +77 -66
  47. package/dest/publisher/sequencer-publisher.d.ts.map +1 -1
  48. package/dest/publisher/sequencer-publisher.js +410 -398
  49. package/dest/sequencer/automine/automine_factory.d.ts +54 -0
  50. package/dest/sequencer/automine/automine_factory.d.ts.map +1 -0
  51. package/dest/sequencer/automine/automine_factory.js +84 -0
  52. package/dest/sequencer/automine/automine_sequencer.d.ts +151 -0
  53. package/dest/sequencer/automine/automine_sequencer.d.ts.map +1 -0
  54. package/dest/sequencer/automine/automine_sequencer.js +509 -0
  55. package/dest/sequencer/chain_state_overrides.d.ts +61 -0
  56. package/dest/sequencer/chain_state_overrides.d.ts.map +1 -0
  57. package/dest/sequencer/chain_state_overrides.js +98 -0
  58. package/dest/sequencer/checkpoint_proposal_job.d.ts +58 -10
  59. package/dest/sequencer/checkpoint_proposal_job.d.ts.map +1 -1
  60. package/dest/sequencer/checkpoint_proposal_job.js +736 -191
  61. package/dest/sequencer/checkpoint_proposal_job_metrics.d.ts +34 -0
  62. package/dest/sequencer/checkpoint_proposal_job_metrics.d.ts.map +1 -0
  63. package/dest/sequencer/checkpoint_proposal_job_metrics.js +72 -0
  64. package/dest/sequencer/events.d.ts +48 -2
  65. package/dest/sequencer/events.d.ts.map +1 -1
  66. package/dest/sequencer/index.d.ts +3 -1
  67. package/dest/sequencer/index.d.ts.map +1 -1
  68. package/dest/sequencer/index.js +2 -0
  69. package/dest/sequencer/metrics.d.ts +13 -10
  70. package/dest/sequencer/metrics.d.ts.map +1 -1
  71. package/dest/sequencer/metrics.js +45 -20
  72. package/dest/sequencer/sequencer.d.ts +59 -12
  73. package/dest/sequencer/sequencer.d.ts.map +1 -1
  74. package/dest/sequencer/sequencer.js +344 -105
  75. package/dest/sequencer/timetable.d.ts +11 -1
  76. package/dest/sequencer/timetable.d.ts.map +1 -1
  77. package/dest/sequencer/timetable.js +41 -36
  78. package/dest/sequencer/types.d.ts +2 -2
  79. package/dest/sequencer/types.d.ts.map +1 -1
  80. package/dest/test/mock_checkpoint_builder.d.ts +1 -1
  81. package/dest/test/mock_checkpoint_builder.d.ts.map +1 -1
  82. package/dest/test/mock_checkpoint_builder.js +0 -2
  83. package/dest/test/utils.d.ts +1 -1
  84. package/dest/test/utils.d.ts.map +1 -1
  85. package/dest/test/utils.js +7 -6
  86. package/package.json +27 -28
  87. package/src/client/sequencer-client.ts +19 -20
  88. package/src/config.ts +40 -11
  89. package/src/global_variable_builder/README.md +44 -0
  90. package/src/global_variable_builder/fee_predictor.ts +172 -0
  91. package/src/global_variable_builder/fee_provider.ts +75 -0
  92. package/src/global_variable_builder/global_builder.ts +10 -46
  93. package/src/global_variable_builder/index.ts +2 -0
  94. package/src/index.ts +10 -1
  95. package/src/publisher/config.ts +49 -6
  96. package/src/publisher/index.ts +3 -0
  97. package/src/publisher/l1_tx_failed_store/factory.ts +32 -0
  98. package/src/publisher/l1_tx_failed_store/failed_tx_store.ts +57 -0
  99. package/src/publisher/l1_tx_failed_store/file_store_failed_tx_store.ts +46 -0
  100. package/src/publisher/l1_tx_failed_store/index.ts +3 -0
  101. package/src/publisher/sequencer-bundle-simulator.ts +254 -0
  102. package/src/publisher/sequencer-publisher-factory.ts +18 -6
  103. package/src/publisher/sequencer-publisher.ts +485 -474
  104. package/src/sequencer/README.md +162 -450
  105. package/src/sequencer/automine/README.md +46 -0
  106. package/src/sequencer/automine/automine_factory.ts +145 -0
  107. package/src/sequencer/automine/automine_sequencer.ts +595 -0
  108. package/src/sequencer/chain_state_overrides.ts +162 -0
  109. package/src/sequencer/checkpoint_proposal_job.ts +857 -201
  110. package/src/sequencer/checkpoint_proposal_job_metrics.ts +128 -0
  111. package/src/sequencer/events.ts +51 -2
  112. package/src/sequencer/index.ts +2 -0
  113. package/src/sequencer/metrics.ts +57 -24
  114. package/src/sequencer/sequencer.ts +421 -118
  115. package/src/sequencer/timetable.ts +49 -44
  116. package/src/sequencer/types.ts +1 -1
  117. package/src/test/mock_checkpoint_builder.ts +0 -2
  118. package/src/test/utils.ts +28 -10
@@ -28,21 +28,37 @@ export type PublisherConfig = L1TxUtilsConfig & BlobClientConfig & {
28
28
  fishermanMode?: boolean;
29
29
  /** Address of the forwarder contract to wrap all L1 transactions through (for testing purposes only) */
30
30
  publisherForwarderAddress?: EthAddress;
31
+ /** Store for failed L1 transaction inputs (test networks only). Format: gs://bucket/path */
32
+ l1TxFailedStore?: string;
33
+ /** Min ETH balance below which a publisher gets funded. Undefined = funding disabled. */
34
+ publisherFundingThreshold?: bigint;
35
+ /** Amount of ETH to send when funding a publisher. Undefined = funding disabled. */
36
+ publisherFundingAmount?: bigint;
31
37
  };
32
38
  export type ProverPublisherConfig = L1TxUtilsConfig & BlobClientConfig & {
33
39
  fishermanMode?: boolean;
34
40
  proverPublisherAllowInvalidStates?: boolean;
35
41
  proverPublisherForwarderAddress?: EthAddress;
42
+ /** Min ETH balance below which a publisher gets funded. Undefined = funding disabled. */
43
+ publisherFundingThreshold?: bigint;
44
+ /** Amount of ETH to send when funding a publisher. Undefined = funding disabled. */
45
+ publisherFundingAmount?: bigint;
36
46
  };
37
47
  export type SequencerPublisherConfig = L1TxUtilsConfig & BlobClientConfig & {
38
48
  fishermanMode?: boolean;
39
49
  sequencerPublisherAllowInvalidStates?: boolean;
40
50
  sequencerPublisherForwarderAddress?: EthAddress;
51
+ /** Store for failed L1 transaction inputs (test networks only). Format: gs://bucket/path */
52
+ l1TxFailedStore?: string;
53
+ /** Min ETH balance below which a publisher gets funded. Undefined = funding disabled. */
54
+ publisherFundingThreshold?: bigint;
55
+ /** Amount of ETH to send when funding a publisher. Undefined = funding disabled. */
56
+ publisherFundingAmount?: bigint;
41
57
  };
42
58
  export declare function getPublisherConfigFromProverConfig(config: ProverPublisherConfig): PublisherConfig;
43
59
  export declare function getPublisherConfigFromSequencerConfig(config: SequencerPublisherConfig): PublisherConfig;
44
- export declare const proverTxSenderConfigMappings: ConfigMappingsType<Omit<ProverTxSenderConfig, 'l1Contracts'>>;
45
- export declare const sequencerTxSenderConfigMappings: ConfigMappingsType<Omit<SequencerTxSenderConfig, 'l1Contracts'>>;
60
+ export declare const proverTxSenderConfigMappings: ConfigMappingsType<ProverTxSenderConfig>;
61
+ export declare const sequencerTxSenderConfigMappings: ConfigMappingsType<SequencerTxSenderConfig>;
46
62
  export declare const sequencerPublisherConfigMappings: ConfigMappingsType<SequencerPublisherConfig & L1TxUtilsConfig>;
47
63
  export declare const proverPublisherConfigMappings: ConfigMappingsType<ProverPublisherConfig & L1TxUtilsConfig>;
48
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvcHVibGlzaGVyL2NvbmZpZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsS0FBSyxnQkFBZ0IsRUFBMkIsTUFBTSxrQ0FBa0MsQ0FBQztBQUNsRyxPQUFPLEVBQUUsS0FBSyxjQUFjLEVBQTBCLE1BQU0sMkJBQTJCLENBQUM7QUFDeEYsT0FBTyxFQUFFLEtBQUssZUFBZSxFQUEyQixNQUFNLG9DQUFvQyxDQUFDO0FBQ25HLE9BQU8sRUFBRSxLQUFLLGtCQUFrQixFQUFFLFdBQVcsRUFBdUIsTUFBTSwwQkFBMEIsQ0FBQztBQUNyRyxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFFM0Qsa0RBQWtEO0FBQ2xELE1BQU0sTUFBTSxjQUFjLEdBQUcsY0FBYyxHQUFHO0lBQzVDLG1EQUFtRDtJQUNuRCxvQkFBb0IsQ0FBQyxFQUFFLFdBQVcsQ0FBQyxLQUFLLE1BQU0sRUFBRSxDQUFDLEVBQUUsQ0FBQztJQUVwRCwwREFBMEQ7SUFDMUQsa0JBQWtCLENBQUMsRUFBRSxVQUFVLEVBQUUsQ0FBQztDQUNuQyxDQUFDO0FBRUYsTUFBTSxNQUFNLG9CQUFvQixHQUFHLGNBQWMsR0FBRztJQUNsRCwwQkFBMEIsQ0FBQyxFQUFFLFdBQVcsQ0FBQyxLQUFLLE1BQU0sRUFBRSxDQUFDLEVBQUUsQ0FBQztJQUMxRCx3QkFBd0IsQ0FBQyxFQUFFLFVBQVUsRUFBRSxDQUFDO0NBQ3pDLENBQUM7QUFFRixNQUFNLE1BQU0sdUJBQXVCLEdBQUcsY0FBYyxHQUFHO0lBQ3JELDZCQUE2QixDQUFDLEVBQUUsV0FBVyxDQUFDLEtBQUssTUFBTSxFQUFFLENBQUMsRUFBRSxDQUFDO0lBQzdELDJCQUEyQixDQUFDLEVBQUUsVUFBVSxFQUFFLENBQUM7Q0FDNUMsQ0FBQztBQUVGLHdCQUFnQixpQ0FBaUMsQ0FBQyxNQUFNLEVBQUUsb0JBQW9CLEdBQUcsY0FBYyxDQU05RjtBQUVELHdCQUFnQixvQ0FBb0MsQ0FBQyxNQUFNLEVBQUUsdUJBQXVCLEdBQUcsY0FBYyxDQU1wRztBQUVELHdDQUF3QztBQUN4QyxNQUFNLE1BQU0sZUFBZSxHQUFHLGVBQWUsR0FDM0MsZ0JBQWdCLEdBQUc7SUFDakIsb0dBQW9HO0lBQ3BHLDJCQUEyQixDQUFDLEVBQUUsT0FBTyxDQUFDO0lBQ3RDLDRHQUE0RztJQUM1RyxhQUFhLENBQUMsRUFBRSxPQUFPLENBQUM7SUFDeEIsd0dBQXdHO0lBQ3hHLHlCQUF5QixDQUFDLEVBQUUsVUFBVSxDQUFDO0NBQ3hDLENBQUM7QUFFSixNQUFNLE1BQU0scUJBQXFCLEdBQUcsZUFBZSxHQUNqRCxnQkFBZ0IsR0FBRztJQUNqQixhQUFhLENBQUMsRUFBRSxPQUFPLENBQUM7SUFDeEIsaUNBQWlDLENBQUMsRUFBRSxPQUFPLENBQUM7SUFDNUMsK0JBQStCLENBQUMsRUFBRSxVQUFVLENBQUM7Q0FDOUMsQ0FBQztBQUVKLE1BQU0sTUFBTSx3QkFBd0IsR0FBRyxlQUFlLEdBQ3BELGdCQUFnQixHQUFHO0lBQ2pCLGFBQWEsQ0FBQyxFQUFFLE9BQU8sQ0FBQztJQUN4QixvQ0FBb0MsQ0FBQyxFQUFFLE9BQU8sQ0FBQztJQUMvQyxrQ0FBa0MsQ0FBQyxFQUFFLFVBQVUsQ0FBQztDQUNqRCxDQUFDO0FBRUosd0JBQWdCLGtDQUFrQyxDQUFDLE1BQU0sRUFBRSxxQkFBcUIsR0FBRyxlQUFlLENBTWpHO0FBRUQsd0JBQWdCLHFDQUFxQyxDQUFDLE1BQU0sRUFBRSx3QkFBd0IsR0FBRyxlQUFlLENBTXZHO0FBRUQsZUFBTyxNQUFNLDRCQUE0QixFQUFFLGtCQUFrQixDQUFDLElBQUksQ0FBQyxvQkFBb0IsRUFBRSxhQUFhLENBQUMsQ0FldEcsQ0FBQztBQUVGLGVBQU8sTUFBTSwrQkFBK0IsRUFBRSxrQkFBa0IsQ0FBQyxJQUFJLENBQUMsdUJBQXVCLEVBQUUsYUFBYSxDQUFDLENBZTVHLENBQUM7QUFFRixlQUFPLE1BQU0sZ0NBQWdDLEVBQUUsa0JBQWtCLENBQUMsd0JBQXdCLEdBQUcsZUFBZSxDQW1CM0csQ0FBQztBQUVGLGVBQU8sTUFBTSw2QkFBNkIsRUFBRSxrQkFBa0IsQ0FBQyxxQkFBcUIsR0FBRyxlQUFlLENBbUJyRyxDQUFDIn0=
64
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvcHVibGlzaGVyL2NvbmZpZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsS0FBSyxnQkFBZ0IsRUFBMkIsTUFBTSxrQ0FBa0MsQ0FBQztBQUNsRyxPQUFPLEVBQUUsS0FBSyxjQUFjLEVBQTBCLE1BQU0sMkJBQTJCLENBQUM7QUFDeEYsT0FBTyxFQUFFLEtBQUssZUFBZSxFQUEyQixNQUFNLG9DQUFvQyxDQUFDO0FBQ25HLE9BQU8sRUFBRSxLQUFLLGtCQUFrQixFQUFFLFdBQVcsRUFBdUIsTUFBTSwwQkFBMEIsQ0FBQztBQUNyRyxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFJM0Qsa0RBQWtEO0FBQ2xELE1BQU0sTUFBTSxjQUFjLEdBQUcsY0FBYyxHQUFHO0lBQzVDLG1EQUFtRDtJQUNuRCxvQkFBb0IsQ0FBQyxFQUFFLFdBQVcsQ0FBQyxLQUFLLE1BQU0sRUFBRSxDQUFDLEVBQUUsQ0FBQztJQUVwRCwwREFBMEQ7SUFDMUQsa0JBQWtCLENBQUMsRUFBRSxVQUFVLEVBQUUsQ0FBQztDQUNuQyxDQUFDO0FBRUYsTUFBTSxNQUFNLG9CQUFvQixHQUFHLGNBQWMsR0FBRztJQUNsRCwwQkFBMEIsQ0FBQyxFQUFFLFdBQVcsQ0FBQyxLQUFLLE1BQU0sRUFBRSxDQUFDLEVBQUUsQ0FBQztJQUMxRCx3QkFBd0IsQ0FBQyxFQUFFLFVBQVUsRUFBRSxDQUFDO0NBQ3pDLENBQUM7QUFFRixNQUFNLE1BQU0sdUJBQXVCLEdBQUcsY0FBYyxHQUFHO0lBQ3JELDZCQUE2QixDQUFDLEVBQUUsV0FBVyxDQUFDLEtBQUssTUFBTSxFQUFFLENBQUMsRUFBRSxDQUFDO0lBQzdELDJCQUEyQixDQUFDLEVBQUUsVUFBVSxFQUFFLENBQUM7Q0FDNUMsQ0FBQztBQUVGLHdCQUFnQixpQ0FBaUMsQ0FBQyxNQUFNLEVBQUUsb0JBQW9CLEdBQUcsY0FBYyxDQU05RjtBQUVELHdCQUFnQixvQ0FBb0MsQ0FBQyxNQUFNLEVBQUUsdUJBQXVCLEdBQUcsY0FBYyxDQU1wRztBQUVELHdDQUF3QztBQUN4QyxNQUFNLE1BQU0sZUFBZSxHQUFHLGVBQWUsR0FDM0MsZ0JBQWdCLEdBQUc7SUFDakIsb0dBQW9HO0lBQ3BHLDJCQUEyQixDQUFDLEVBQUUsT0FBTyxDQUFDO0lBQ3RDLDRHQUE0RztJQUM1RyxhQUFhLENBQUMsRUFBRSxPQUFPLENBQUM7SUFDeEIsd0dBQXdHO0lBQ3hHLHlCQUF5QixDQUFDLEVBQUUsVUFBVSxDQUFDO0lBQ3ZDLDRGQUE0RjtJQUM1RixlQUFlLENBQUMsRUFBRSxNQUFNLENBQUM7SUFDekIseUZBQXlGO0lBQ3pGLHlCQUF5QixDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ25DLG9GQUFvRjtJQUNwRixzQkFBc0IsQ0FBQyxFQUFFLE1BQU0sQ0FBQztDQUNqQyxDQUFDO0FBa0JKLE1BQU0sTUFBTSxxQkFBcUIsR0FBRyxlQUFlLEdBQ2pELGdCQUFnQixHQUFHO0lBQ2pCLGFBQWEsQ0FBQyxFQUFFLE9BQU8sQ0FBQztJQUN4QixpQ0FBaUMsQ0FBQyxFQUFFLE9BQU8sQ0FBQztJQUM1QywrQkFBK0IsQ0FBQyxFQUFFLFVBQVUsQ0FBQztJQUM3Qyx5RkFBeUY7SUFDekYseUJBQXlCLENBQUMsRUFBRSxNQUFNLENBQUM7SUFDbkMsb0ZBQW9GO0lBQ3BGLHNCQUFzQixDQUFDLEVBQUUsTUFBTSxDQUFDO0NBQ2pDLENBQUM7QUFFSixNQUFNLE1BQU0sd0JBQXdCLEdBQUcsZUFBZSxHQUNwRCxnQkFBZ0IsR0FBRztJQUNqQixhQUFhLENBQUMsRUFBRSxPQUFPLENBQUM7SUFDeEIsb0NBQW9DLENBQUMsRUFBRSxPQUFPLENBQUM7SUFDL0Msa0NBQWtDLENBQUMsRUFBRSxVQUFVLENBQUM7SUFDaEQsNEZBQTRGO0lBQzVGLGVBQWUsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUN6Qix5RkFBeUY7SUFDekYseUJBQXlCLENBQUMsRUFBRSxNQUFNLENBQUM7SUFDbkMsb0ZBQW9GO0lBQ3BGLHNCQUFzQixDQUFDLEVBQUUsTUFBTSxDQUFDO0NBQ2pDLENBQUM7QUFFSix3QkFBZ0Isa0NBQWtDLENBQUMsTUFBTSxFQUFFLHFCQUFxQixHQUFHLGVBQWUsQ0FNakc7QUFFRCx3QkFBZ0IscUNBQXFDLENBQUMsTUFBTSxFQUFFLHdCQUF3QixHQUFHLGVBQWUsQ0FPdkc7QUFFRCxlQUFPLE1BQU0sNEJBQTRCLEVBQUUsa0JBQWtCLENBQUMsb0JBQW9CLENBZ0JqRixDQUFDO0FBRUYsZUFBTyxNQUFNLCtCQUErQixFQUFFLGtCQUFrQixDQUFDLHVCQUF1QixDQWdCdkYsQ0FBQztBQUVGLGVBQU8sTUFBTSxnQ0FBZ0MsRUFBRSxrQkFBa0IsQ0FBQyx3QkFBd0IsR0FBRyxlQUFlLENBd0IzRyxDQUFDO0FBRUYsZUFBTyxNQUFNLDZCQUE2QixFQUFFLGtCQUFrQixDQUFDLHFCQUFxQixHQUFHLGVBQWUsQ0FvQnJHLENBQUMifQ==
@@ -1 +1 @@
1
- {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/publisher/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAA2B,MAAM,kCAAkC,CAAC;AAClG,OAAO,EAAE,KAAK,cAAc,EAA0B,MAAM,2BAA2B,CAAC;AACxF,OAAO,EAAE,KAAK,eAAe,EAA2B,MAAM,oCAAoC,CAAC;AACnG,OAAO,EAAE,KAAK,kBAAkB,EAAE,WAAW,EAAuB,MAAM,0BAA0B,CAAC;AACrG,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAE3D,kDAAkD;AAClD,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG;IAC5C,mDAAmD;IACnD,oBAAoB,CAAC,EAAE,WAAW,CAAC,KAAK,MAAM,EAAE,CAAC,EAAE,CAAC;IAEpD,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,UAAU,EAAE,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG;IAClD,0BAA0B,CAAC,EAAE,WAAW,CAAC,KAAK,MAAM,EAAE,CAAC,EAAE,CAAC;IAC1D,wBAAwB,CAAC,EAAE,UAAU,EAAE,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,cAAc,GAAG;IACrD,6BAA6B,CAAC,EAAE,WAAW,CAAC,KAAK,MAAM,EAAE,CAAC,EAAE,CAAC;IAC7D,2BAA2B,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5C,CAAC;AAEF,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAM9F;AAED,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,uBAAuB,GAAG,cAAc,CAMpG;AAED,wCAAwC;AACxC,MAAM,MAAM,eAAe,GAAG,eAAe,GAC3C,gBAAgB,GAAG;IACjB,oGAAoG;IACpG,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,4GAA4G;IAC5G,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wGAAwG;IACxG,yBAAyB,CAAC,EAAE,UAAU,CAAC;CACxC,CAAC;AAEJ,MAAM,MAAM,qBAAqB,GAAG,eAAe,GACjD,gBAAgB,GAAG;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iCAAiC,CAAC,EAAE,OAAO,CAAC;IAC5C,+BAA+B,CAAC,EAAE,UAAU,CAAC;CAC9C,CAAC;AAEJ,MAAM,MAAM,wBAAwB,GAAG,eAAe,GACpD,gBAAgB,GAAG;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oCAAoC,CAAC,EAAE,OAAO,CAAC;IAC/C,kCAAkC,CAAC,EAAE,UAAU,CAAC;CACjD,CAAC;AAEJ,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe,CAMjG;AAED,wBAAgB,qCAAqC,CAAC,MAAM,EAAE,wBAAwB,GAAG,eAAe,CAMvG;AAED,eAAO,MAAM,4BAA4B,EAAE,kBAAkB,CAAC,IAAI,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAetG,CAAC;AAEF,eAAO,MAAM,+BAA+B,EAAE,kBAAkB,CAAC,IAAI,CAAC,uBAAuB,EAAE,aAAa,CAAC,CAe5G,CAAC;AAEF,eAAO,MAAM,gCAAgC,EAAE,kBAAkB,CAAC,wBAAwB,GAAG,eAAe,CAmB3G,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,kBAAkB,CAAC,qBAAqB,GAAG,eAAe,CAmBrG,CAAC"}
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/publisher/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAA2B,MAAM,kCAAkC,CAAC;AAClG,OAAO,EAAE,KAAK,cAAc,EAA0B,MAAM,2BAA2B,CAAC;AACxF,OAAO,EAAE,KAAK,eAAe,EAA2B,MAAM,oCAAoC,CAAC;AACnG,OAAO,EAAE,KAAK,kBAAkB,EAAE,WAAW,EAAuB,MAAM,0BAA0B,CAAC;AACrG,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAI3D,kDAAkD;AAClD,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG;IAC5C,mDAAmD;IACnD,oBAAoB,CAAC,EAAE,WAAW,CAAC,KAAK,MAAM,EAAE,CAAC,EAAE,CAAC;IAEpD,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,UAAU,EAAE,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG;IAClD,0BAA0B,CAAC,EAAE,WAAW,CAAC,KAAK,MAAM,EAAE,CAAC,EAAE,CAAC;IAC1D,wBAAwB,CAAC,EAAE,UAAU,EAAE,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,cAAc,GAAG;IACrD,6BAA6B,CAAC,EAAE,WAAW,CAAC,KAAK,MAAM,EAAE,CAAC,EAAE,CAAC;IAC7D,2BAA2B,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5C,CAAC;AAEF,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAM9F;AAED,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,uBAAuB,GAAG,cAAc,CAMpG;AAED,wCAAwC;AACxC,MAAM,MAAM,eAAe,GAAG,eAAe,GAC3C,gBAAgB,GAAG;IACjB,oGAAoG;IACpG,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,4GAA4G;IAC5G,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wGAAwG;IACxG,yBAAyB,CAAC,EAAE,UAAU,CAAC;IACvC,4FAA4F;IAC5F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yFAAyF;IACzF,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,oFAAoF;IACpF,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAkBJ,MAAM,MAAM,qBAAqB,GAAG,eAAe,GACjD,gBAAgB,GAAG;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iCAAiC,CAAC,EAAE,OAAO,CAAC;IAC5C,+BAA+B,CAAC,EAAE,UAAU,CAAC;IAC7C,yFAAyF;IACzF,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,oFAAoF;IACpF,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEJ,MAAM,MAAM,wBAAwB,GAAG,eAAe,GACpD,gBAAgB,GAAG;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oCAAoC,CAAC,EAAE,OAAO,CAAC;IAC/C,kCAAkC,CAAC,EAAE,UAAU,CAAC;IAChD,4FAA4F;IAC5F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yFAAyF;IACzF,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,oFAAoF;IACpF,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEJ,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe,CAMjG;AAED,wBAAgB,qCAAqC,CAAC,MAAM,EAAE,wBAAwB,GAAG,eAAe,CAOvG;AAED,eAAO,MAAM,4BAA4B,EAAE,kBAAkB,CAAC,oBAAoB,CAgBjF,CAAC;AAEF,eAAO,MAAM,+BAA+B,EAAE,kBAAkB,CAAC,uBAAuB,CAgBvF,CAAC;AAEF,eAAO,MAAM,gCAAgC,EAAE,kBAAkB,CAAC,wBAAwB,GAAG,eAAe,CAwB3G,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,kBAAkB,CAAC,qBAAqB,GAAG,eAAe,CAoBrG,CAAC"}
@@ -3,6 +3,7 @@ import { l1ReaderConfigMappings } from '@aztec/ethereum/l1-reader';
3
3
  import { l1TxUtilsConfigMappings } from '@aztec/ethereum/l1-tx-utils/config';
4
4
  import { SecretValue, booleanConfigHelper } from '@aztec/foundation/config';
5
5
  import { EthAddress } from '@aztec/foundation/eth-address';
6
+ import { parseEther } from 'viem';
6
7
  export function getTxSenderConfigFromProverConfig(config) {
7
8
  return {
8
9
  ...config,
@@ -17,6 +18,18 @@ export function getTxSenderConfigFromSequencerConfig(config) {
17
18
  publisherAddresses: config.sequencerPublisherAddresses
18
19
  };
19
20
  }
21
+ /** Shared config mappings for publisher funding, used by both sequencer and prover publisher configs. */ const publisherFundingConfigMappings = {
22
+ publisherFundingThreshold: {
23
+ env: 'PUBLISHER_FUNDING_THRESHOLD',
24
+ description: 'Min ETH balance below which a publisher gets funded. Specified in ether (e.g. 0.1). Unset = funding disabled.',
25
+ parseEnv: (val)=>parseEther(val)
26
+ },
27
+ publisherFundingAmount: {
28
+ env: 'PUBLISHER_FUNDING_AMOUNT',
29
+ description: 'Amount of ETH to send when funding a publisher. Specified in ether (e.g. 0.5). Unset = funding disabled.',
30
+ parseEnv: (val)=>parseEther(val)
31
+ }
32
+ };
20
33
  export function getPublisherConfigFromProverConfig(config) {
21
34
  return {
22
35
  ...config,
@@ -28,7 +41,8 @@ export function getPublisherConfigFromSequencerConfig(config) {
28
41
  return {
29
42
  ...config,
30
43
  publisherAllowInvalidStates: config.sequencerPublisherAllowInvalidStates,
31
- publisherForwarderAddress: config.sequencerPublisherForwarderAddress
44
+ publisherForwarderAddress: config.sequencerPublisherForwarderAddress,
45
+ l1TxFailedStore: config.l1TxFailedStore
32
46
  };
33
47
  }
34
48
  export const proverTxSenderConfigMappings = {
@@ -83,8 +97,13 @@ export const sequencerPublisherConfigMappings = {
83
97
  sequencerPublisherForwarderAddress: {
84
98
  env: `SEQ_PUBLISHER_FORWARDER_ADDRESS`,
85
99
  description: 'Address of the forwarder contract to wrap all L1 transactions through (for testing purposes only)',
86
- parseEnv: (val)=>val ? EthAddress.fromString(val) : undefined
87
- }
100
+ parseEnv: (val)=>EthAddress.fromString(val)
101
+ },
102
+ l1TxFailedStore: {
103
+ env: 'L1_TX_FAILED_STORE',
104
+ description: 'Store for failed L1 transaction inputs (test networks only). Format: gs://bucket/path'
105
+ },
106
+ ...publisherFundingConfigMappings
88
107
  };
89
108
  export const proverPublisherConfigMappings = {
90
109
  ...l1TxUtilsConfigMappings,
@@ -102,6 +121,7 @@ export const proverPublisherConfigMappings = {
102
121
  proverPublisherForwarderAddress: {
103
122
  env: `PROVER_PUBLISHER_FORWARDER_ADDRESS`,
104
123
  description: 'Address of the forwarder contract to wrap all L1 transactions through (for testing purposes only)',
105
- parseEnv: (val)=>val ? EthAddress.fromString(val) : undefined
106
- }
124
+ parseEnv: (val)=>EthAddress.fromString(val)
125
+ },
126
+ ...publisherFundingConfigMappings
107
127
  };
@@ -1,4 +1,5 @@
1
1
  export { SequencerPublisher } from './sequencer-publisher.js';
2
2
  export { SequencerPublisherFactory } from './sequencer-publisher-factory.js';
3
3
  export { SequencerPublisherMetrics } from './sequencer-publisher-metrics.js';
4
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9wdWJsaXNoZXIvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDOUQsT0FBTyxFQUFFLHlCQUF5QixFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFHN0UsT0FBTyxFQUFFLHlCQUF5QixFQUFFLE1BQU0sa0NBQWtDLENBQUMifQ==
4
+ export { type FailedL1Tx, type FailedL1TxUri, type L1TxFailedStore } from './l1_tx_failed_store/index.js';
5
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9wdWJsaXNoZXIvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDOUQsT0FBTyxFQUFFLHlCQUF5QixFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFHN0UsT0FBTyxFQUFFLHlCQUF5QixFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFHN0UsT0FBTyxFQUFFLEtBQUssVUFBVSxFQUFFLEtBQUssYUFBYSxFQUFFLEtBQUssZUFBZSxFQUFFLE1BQU0sK0JBQStCLENBQUMifQ==
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/publisher/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAG7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/publisher/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAG7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAG7E,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC"}
@@ -0,0 +1,11 @@
1
+ import { type Logger } from '@aztec/foundation/log';
2
+ import type { L1TxFailedStore } from './failed_tx_store.js';
3
+ /**
4
+ * Creates an L1TxFailedStore from a config string.
5
+ * Supports any backend that FileStore supports (GCS, S3, R2, local filesystem).
6
+ * @param config - Config string (e.g., 'gs://bucket/path', 's3://bucket/path', 'file:///path'). If undefined, returns undefined.
7
+ * @param logger - Optional logger.
8
+ * @returns The store instance, or undefined if config is not provided.
9
+ */
10
+ export declare function createL1TxFailedStore(config: string | undefined, logger?: Logger): Promise<L1TxFailedStore | undefined>;
11
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFjdG9yeS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3B1Ymxpc2hlci9sMV90eF9mYWlsZWRfc3RvcmUvZmFjdG9yeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsS0FBSyxNQUFNLEVBQWdCLE1BQU0sdUJBQXVCLENBQUM7QUFHbEUsT0FBTyxLQUFLLEVBQUUsZUFBZSxFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFHNUQ7Ozs7OztHQU1HO0FBQ0gsd0JBQXNCLHFCQUFxQixDQUN6QyxNQUFNLEVBQUUsTUFBTSxHQUFHLFNBQVMsRUFDMUIsTUFBTSxHQUFFLE1BQXFELEdBQzVELE9BQU8sQ0FBQyxlQUFlLEdBQUcsU0FBUyxDQUFDLENBZXRDIn0=
@@ -0,0 +1 @@
1
+ {"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/publisher/l1_tx_failed_store/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AAGlE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,GAAE,MAAqD,GAC5D,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAetC"}
@@ -0,0 +1,22 @@
1
+ import { createLogger } from '@aztec/foundation/log';
2
+ import { createFileStore } from '@aztec/stdlib/file-store';
3
+ import { FileStoreL1TxFailedStore } from './file_store_failed_tx_store.js';
4
+ /**
5
+ * Creates an L1TxFailedStore from a config string.
6
+ * Supports any backend that FileStore supports (GCS, S3, R2, local filesystem).
7
+ * @param config - Config string (e.g., 'gs://bucket/path', 's3://bucket/path', 'file:///path'). If undefined, returns undefined.
8
+ * @param logger - Optional logger.
9
+ * @returns The store instance, or undefined if config is not provided.
10
+ */ export async function createL1TxFailedStore(config, logger = createLogger('sequencer:l1-tx-failed-store')) {
11
+ if (!config) {
12
+ return undefined;
13
+ }
14
+ const fileStore = await createFileStore(config, logger);
15
+ if (!fileStore) {
16
+ throw new Error(`Failed to create file store from config: '${config}'. ` + `Supported formats: 'gs://bucket/path', 's3://bucket/path', 'file:///path'.`);
17
+ }
18
+ logger.info(`Created L1 tx failed store`, {
19
+ config
20
+ });
21
+ return new FileStoreL1TxFailedStore(fileStore, logger);
22
+ }
@@ -0,0 +1,58 @@
1
+ import type { Branded } from '@aztec/foundation/branded-types';
2
+ import type { Hex } from 'viem';
3
+ /** URI pointing to a stored failed L1 transaction. */
4
+ export type FailedL1TxUri = Branded<string, 'FailedL1TxUri'>;
5
+ /** A failed L1 transaction captured for debugging and replay. */
6
+ export type FailedL1Tx = {
7
+ /** Tx hash (for reverts) or keccak256(request.data) (for simulation/send failures). */
8
+ id: Hex;
9
+ /** Unix timestamp (ms) when failure occurred. */
10
+ timestamp: number;
11
+ /** Whether the failure was during simulation or after sending. */
12
+ failureType: 'simulation' | 'revert' | 'send-error';
13
+ /** The actual L1 transaction for replay (multicall-encoded for bundled txs). */
14
+ request: {
15
+ to: Hex;
16
+ data: Hex;
17
+ value?: string;
18
+ };
19
+ /** Raw blob data as hex for replay. */
20
+ blobData?: Hex[];
21
+ /** L1 block number at time of failure (simulation target or receipt block). */
22
+ l1BlockNumber: string;
23
+ /** Receipt info (present only for on-chain reverts). */
24
+ receipt?: {
25
+ transactionHash: Hex;
26
+ blockNumber: string;
27
+ gasUsed: string;
28
+ status: 'reverted';
29
+ };
30
+ /** Error information. */
31
+ error: {
32
+ message: string;
33
+ /** Decoded error name (e.g., 'Rollup__InvalidProposer'). */
34
+ name?: string;
35
+ };
36
+ /** Context metadata. */
37
+ context: {
38
+ /** Actions involved (e.g., ['propose', 'governance-signal']). */
39
+ actions: string[];
40
+ /** Individual request data for each action (metadata, not used for replay). */
41
+ requests?: Array<{
42
+ action: string;
43
+ to: Hex;
44
+ data: Hex;
45
+ }>;
46
+ checkpointNumber?: number;
47
+ slot?: number;
48
+ sender: Hex;
49
+ };
50
+ };
51
+ /** Store for failed L1 transactions for debugging purposes. */
52
+ export interface L1TxFailedStore {
53
+ /** Saves a failed transaction and returns its URI. */
54
+ saveFailedTx(tx: FailedL1Tx): Promise<FailedL1TxUri>;
55
+ /** Retrieves a failed transaction by its URI. */
56
+ getFailedTx(uri: FailedL1TxUri): Promise<FailedL1Tx>;
57
+ }
58
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFpbGVkX3R4X3N0b3JlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvcHVibGlzaGVyL2wxX3R4X2ZhaWxlZF9zdG9yZS9mYWlsZWRfdHhfc3RvcmUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFFL0QsT0FBTyxLQUFLLEVBQUUsR0FBRyxFQUFFLE1BQU0sTUFBTSxDQUFDO0FBRWhDLHNEQUFzRDtBQUN0RCxNQUFNLE1BQU0sYUFBYSxHQUFHLE9BQU8sQ0FBQyxNQUFNLEVBQUUsZUFBZSxDQUFDLENBQUM7QUFFN0QsaUVBQWlFO0FBQ2pFLE1BQU0sTUFBTSxVQUFVLEdBQUc7SUFDdkIsdUZBQXVGO0lBQ3ZGLEVBQUUsRUFBRSxHQUFHLENBQUM7SUFDUixpREFBaUQ7SUFDakQsU0FBUyxFQUFFLE1BQU0sQ0FBQztJQUNsQixrRUFBa0U7SUFDbEUsV0FBVyxFQUFFLFlBQVksR0FBRyxRQUFRLEdBQUcsWUFBWSxDQUFDO0lBQ3BELGdGQUFnRjtJQUNoRixPQUFPLEVBQUU7UUFDUCxFQUFFLEVBQUUsR0FBRyxDQUFDO1FBQ1IsSUFBSSxFQUFFLEdBQUcsQ0FBQztRQUNWLEtBQUssQ0FBQyxFQUFFLE1BQU0sQ0FBQztLQUNoQixDQUFDO0lBQ0YsdUNBQXVDO0lBQ3ZDLFFBQVEsQ0FBQyxFQUFFLEdBQUcsRUFBRSxDQUFDO0lBQ2pCLCtFQUErRTtJQUMvRSxhQUFhLEVBQUUsTUFBTSxDQUFDO0lBQ3RCLHdEQUF3RDtJQUN4RCxPQUFPLENBQUMsRUFBRTtRQUNSLGVBQWUsRUFBRSxHQUFHLENBQUM7UUFDckIsV0FBVyxFQUFFLE1BQU0sQ0FBQztRQUNwQixPQUFPLEVBQUUsTUFBTSxDQUFDO1FBQ2hCLE1BQU0sRUFBRSxVQUFVLENBQUM7S0FDcEIsQ0FBQztJQUNGLHlCQUF5QjtJQUN6QixLQUFLLEVBQUU7UUFDTCxPQUFPLEVBQUUsTUFBTSxDQUFDO1FBQ2hCLDREQUE0RDtRQUM1RCxJQUFJLENBQUMsRUFBRSxNQUFNLENBQUM7S0FDZixDQUFDO0lBQ0Ysd0JBQXdCO0lBQ3hCLE9BQU8sRUFBRTtRQUNQLGlFQUFpRTtRQUNqRSxPQUFPLEVBQUUsTUFBTSxFQUFFLENBQUM7UUFDbEIsK0VBQStFO1FBQy9FLFFBQVEsQ0FBQyxFQUFFLEtBQUssQ0FBQztZQUFFLE1BQU0sRUFBRSxNQUFNLENBQUM7WUFBQyxFQUFFLEVBQUUsR0FBRyxDQUFDO1lBQUMsSUFBSSxFQUFFLEdBQUcsQ0FBQTtTQUFFLENBQUMsQ0FBQztRQUN6RCxnQkFBZ0IsQ0FBQyxFQUFFLE1BQU0sQ0FBQztRQUMxQixJQUFJLENBQUMsRUFBRSxNQUFNLENBQUM7UUFDZCxNQUFNLEVBQUUsR0FBRyxDQUFDO0tBQ2IsQ0FBQztDQUNILENBQUM7QUFFRiwrREFBK0Q7QUFDL0QsTUFBTSxXQUFXLGVBQWU7SUFDOUIsc0RBQXNEO0lBQ3RELFlBQVksQ0FBQyxFQUFFLEVBQUUsVUFBVSxHQUFHLE9BQU8sQ0FBQyxhQUFhLENBQUMsQ0FBQztJQUNyRCxpREFBaUQ7SUFDakQsV0FBVyxDQUFDLEdBQUcsRUFBRSxhQUFhLEdBQUcsT0FBTyxDQUFDLFVBQVUsQ0FBQyxDQUFDO0NBQ3REIn0=
@@ -0,0 +1 @@
1
+ {"version":3,"file":"failed_tx_store.d.ts","sourceRoot":"","sources":["../../../src/publisher/l1_tx_failed_store/failed_tx_store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAE/D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEhC,sDAAsD;AACtD,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE7D,iEAAiE;AACjE,MAAM,MAAM,UAAU,GAAG;IACvB,uFAAuF;IACvF,EAAE,EAAE,GAAG,CAAC;IACR,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,WAAW,EAAE,YAAY,GAAG,QAAQ,GAAG,YAAY,CAAC;IACpD,gFAAgF;IAChF,OAAO,EAAE;QACP,EAAE,EAAE,GAAG,CAAC;QACR,IAAI,EAAE,GAAG,CAAC;QACV,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,uCAAuC;IACvC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;IACjB,+EAA+E;IAC/E,aAAa,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,OAAO,CAAC,EAAE;QACR,eAAe,EAAE,GAAG,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,UAAU,CAAC;KACpB,CAAC;IACF,yBAAyB;IACzB,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,4DAA4D;QAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,wBAAwB;IACxB,OAAO,EAAE;QACP,iEAAiE;QACjE,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,+EAA+E;QAC/E,QAAQ,CAAC,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,GAAG,CAAC;YAAC,IAAI,EAAE,GAAG,CAAA;SAAE,CAAC,CAAC;QACzD,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,GAAG,CAAC;KACb,CAAC;CACH,CAAC;AAEF,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,YAAY,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACrD,iDAAiD;IACjD,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACtD"}
@@ -0,0 +1 @@
1
+ /** Store for failed L1 transactions for debugging purposes. */ export { };
@@ -0,0 +1,15 @@
1
+ import { type Logger } from '@aztec/foundation/log';
2
+ import type { FileStore } from '@aztec/stdlib/file-store';
3
+ import type { FailedL1Tx, FailedL1TxUri, L1TxFailedStore } from './failed_tx_store.js';
4
+ /**
5
+ * L1TxFailedStore implementation using the FileStore abstraction.
6
+ * Supports any backend that FileStore supports (GCS, S3, R2, local filesystem).
7
+ */
8
+ export declare class FileStoreL1TxFailedStore implements L1TxFailedStore {
9
+ private readonly fileStore;
10
+ private readonly log;
11
+ constructor(fileStore: FileStore, logger?: Logger);
12
+ saveFailedTx(tx: FailedL1Tx): Promise<FailedL1TxUri>;
13
+ getFailedTx(uri: FailedL1TxUri): Promise<FailedL1Tx>;
14
+ }
15
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmlsZV9zdG9yZV9mYWlsZWRfdHhfc3RvcmUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9wdWJsaXNoZXIvbDFfdHhfZmFpbGVkX3N0b3JlL2ZpbGVfc3RvcmVfZmFpbGVkX3R4X3N0b3JlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxLQUFLLE1BQU0sRUFBZ0IsTUFBTSx1QkFBdUIsQ0FBQztBQUNsRSxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUUxRCxPQUFPLEtBQUssRUFBRSxVQUFVLEVBQUUsYUFBYSxFQUFFLGVBQWUsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBRXZGOzs7R0FHRztBQUNILHFCQUFhLHdCQUF5QixZQUFXLGVBQWU7SUFJNUQsT0FBTyxDQUFDLFFBQVEsQ0FBQyxTQUFTO0lBSDVCLE9BQU8sQ0FBQyxRQUFRLENBQUMsR0FBRyxDQUFTO0lBRTdCLFlBQ21CLFNBQVMsRUFBRSxTQUFTLEVBQ3JDLE1BQU0sQ0FBQyxFQUFFLE1BQU0sRUFHaEI7SUFFWSxZQUFZLENBQUMsRUFBRSxFQUFFLFVBQVUsR0FBRyxPQUFPLENBQUMsYUFBYSxDQUFDLENBb0JoRTtJQUVZLFdBQVcsQ0FBQyxHQUFHLEVBQUUsYUFBYSxHQUFHLE9BQU8sQ0FBQyxVQUFVLENBQUMsQ0FHaEU7Q0FDRiJ9
@@ -0,0 +1 @@
1
+ {"version":3,"file":"file_store_failed_tx_store.d.ts","sourceRoot":"","sources":["../../../src/publisher/l1_tx_failed_store/file_store_failed_tx_store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvF;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,eAAe;IAI5D,OAAO,CAAC,QAAQ,CAAC,SAAS;IAH5B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAE7B,YACmB,SAAS,EAAE,SAAS,EACrC,MAAM,CAAC,EAAE,MAAM,EAGhB;IAEY,YAAY,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAoBhE;IAEY,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAGhE;CACF"}
@@ -0,0 +1,34 @@
1
+ import { createLogger } from '@aztec/foundation/log';
2
+ /**
3
+ * L1TxFailedStore implementation using the FileStore abstraction.
4
+ * Supports any backend that FileStore supports (GCS, S3, R2, local filesystem).
5
+ */ export class FileStoreL1TxFailedStore {
6
+ fileStore;
7
+ log;
8
+ constructor(fileStore, logger){
9
+ this.fileStore = fileStore;
10
+ this.log = logger ?? createLogger('sequencer:l1-tx-failed-store');
11
+ }
12
+ async saveFailedTx(tx) {
13
+ const prefix = tx.receipt ? 'tx' : 'data';
14
+ const path = `${tx.failureType}/${prefix}-${tx.id}.json`;
15
+ const json = JSON.stringify(tx, null, 2);
16
+ const uri = await this.fileStore.save(path, Buffer.from(json), {
17
+ metadata: {
18
+ 'content-type': 'application/json',
19
+ actions: tx.context.actions.join(','),
20
+ 'failure-type': tx.failureType
21
+ }
22
+ });
23
+ this.log.info(`Saved failed L1 tx to ${uri}`, {
24
+ id: tx.id,
25
+ failureType: tx.failureType,
26
+ actions: tx.context.actions.join(',')
27
+ });
28
+ return uri;
29
+ }
30
+ async getFailedTx(uri) {
31
+ const data = await this.fileStore.read(uri);
32
+ return JSON.parse(data.toString());
33
+ }
34
+ }
@@ -0,0 +1,4 @@
1
+ export { type FailedL1Tx, type FailedL1TxUri, type L1TxFailedStore } from './failed_tx_store.js';
2
+ export { createL1TxFailedStore } from './factory.js';
3
+ export { FileStoreL1TxFailedStore } from './file_store_failed_tx_store.js';
4
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9wdWJsaXNoZXIvbDFfdHhfZmFpbGVkX3N0b3JlL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxLQUFLLFVBQVUsRUFBRSxLQUFLLGFBQWEsRUFBRSxLQUFLLGVBQWUsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBQ2pHLE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxNQUFNLGNBQWMsQ0FBQztBQUNyRCxPQUFPLEVBQUUsd0JBQXdCLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQyJ9
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/publisher/l1_tx_failed_store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACjG,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { createL1TxFailedStore } from './factory.js';
2
+ export { FileStoreL1TxFailedStore } from './file_store_failed_tx_store.js';
@@ -0,0 +1,96 @@
1
+ import type { EpochCache } from '@aztec/epoch-cache';
2
+ import { type RollupContract } from '@aztec/ethereum/contracts';
3
+ import { type L1TxUtils } from '@aztec/ethereum/l1-tx-utils';
4
+ import type { SlotNumber } from '@aztec/foundation/branded-types';
5
+ import { type Logger } from '@aztec/foundation/log';
6
+ import type { Hex } from 'viem';
7
+ import type { RequestWithExpiry } from './sequencer-publisher.js';
8
+ /** A request that was dropped by bundle simulation, with the decoded revert reason. */
9
+ export type DroppedRequest = {
10
+ request: RequestWithExpiry;
11
+ revertReason: string | undefined;
12
+ returnData: Hex | undefined;
13
+ };
14
+ /**
15
+ * Result of {@link SequencerBundleSimulator.simulate}.
16
+ *
17
+ * - `success`: simulation succeeded. `requests` is the filtered survivor list, `gasLimit` is
18
+ * the bumped gas limit derived from `gasUsed` (plus blob evaluation gas). `droppedRequests`
19
+ * lists the entries that were observed to revert in simulation.
20
+ * - `fallback`: the node does not support eth_simulateV1 (or the simulate call threw). The
21
+ * caller should send `requests` as-is with a safe gas limit (e.g. {@link MAX_L1_TX_LIMIT}).
22
+ * `droppedRequests` carries any entries that the first pass already proved reverted, so the
23
+ * caller does not re-include them when the second pass falls back.
24
+ * - `aborted`: the bundle cannot be sent. `droppedRequests` contains only entries that were
25
+ * actually observed to revert (so they can be reported as simulation failures); it is empty
26
+ * when the abort was caused by an empty input bundle.
27
+ */
28
+ export type BundleSimulateResult = {
29
+ kind: 'success';
30
+ requests: RequestWithExpiry[];
31
+ gasLimit: bigint;
32
+ droppedRequests: DroppedRequest[];
33
+ } | {
34
+ kind: 'fallback';
35
+ requests: RequestWithExpiry[];
36
+ droppedRequests: DroppedRequest[];
37
+ } | {
38
+ kind: 'aborted';
39
+ reason: AbortReason;
40
+ droppedRequests: DroppedRequest[];
41
+ };
42
+ export type AbortReason = 'empty-bundle' | 'all-reverted' | 'second-pass-reverts';
43
+ /**
44
+ * Bundle-level simulator for the aggregate3 payload that `SequencerPublisher` is about to send.
45
+ *
46
+ * Runs `eth_simulateV1` against `Multicall3.aggregate3`, drops entries that revert, and returns
47
+ * a gasLimit for the survivors. When `eth_simulateV1` is unavailable, signals fallback to the
48
+ * caller so it can send the bundle as-is with a conservative gas limit.
49
+ */
50
+ export declare class SequencerBundleSimulator {
51
+ private readonly deps;
52
+ private readonly log;
53
+ constructor(deps: {
54
+ getL1TxUtils: () => L1TxUtils;
55
+ rollupContract: RollupContract;
56
+ epochCache: EpochCache;
57
+ log?: Logger;
58
+ });
59
+ /**
60
+ * Simulates the given bundle near the end of the target slot and filters out entries
61
+ * that revert.
62
+ *
63
+ * - If all entries pass on the first pass, returns `success` with the gasLimit.
64
+ * - If some entries revert, re-simulates the survivors. If the second pass is clean, returns
65
+ * `success` with the survivors and dropped entries. If the second pass surfaces any revert,
66
+ * returns `aborted` — we refuse to send a bundle whose composition still has internal
67
+ * reverts after one round of filtering.
68
+ * - If eth_simulateV1 is unavailable, returns `fallback`. The caller is expected to send the
69
+ * bundle as-is with a safe gas limit.
70
+ *
71
+ * The simulation `block.timestamp` is the last L1 slot timestamp inside the target L2 slot.
72
+ * This still maps to the target L2 slot for propose's `validateHeader` and EIP-712 signature
73
+ * checks, while avoiding eth_simulateV1 rejecting a child block whose timestamp is not strictly
74
+ * greater than the current L1 head.
75
+ *
76
+ * Known limitation: on networks where L1 is mining behind cadence (missed L1 slots, anvil with
77
+ * overridden timestamps), the actual `block.timestamp` at send time can land in the prior L2
78
+ * slot. In that case `propose` would revert silently inside the multicall. The simulator does
79
+ * not detect this case because it simulates inside the target slot — the prior implementation
80
+ * used `min(predictedNextL1Ts, targetTimestamp)` to surface this failure mode at simulate time.
81
+ */
82
+ simulate(validRequests: RequestWithExpiry[], targetSlot: SlotNumber): Promise<BundleSimulateResult>;
83
+ private buildSuccessResult;
84
+ /**
85
+ * `gasLimit = bumpGasLimit(ceil(gasUsed * 64 / 63))`, plus blob evaluation gas if a propose
86
+ * survived, capped at the L1 block gas limit.
87
+ */
88
+ private computeGasLimit;
89
+ /**
90
+ * eth_simulateV1 cannot carry blob sidecar data, so disable the rollup's on-chain blob check
91
+ * when a propose is in the bundle.
92
+ */
93
+ private buildStateOverrides;
94
+ private simulateAndDecode;
95
+ }
96
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VxdWVuY2VyLWJ1bmRsZS1zaW11bGF0b3IuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9wdWJsaXNoZXIvc2VxdWVuY2VyLWJ1bmRsZS1zaW11bGF0b3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFDckQsT0FBTyxFQUFjLEtBQUssY0FBYyxFQUF5QyxNQUFNLDJCQUEyQixDQUFDO0FBQ25ILE9BQU8sRUFBRSxLQUFLLFNBQVMsRUFBbUIsTUFBTSw2QkFBNkIsQ0FBQztBQUU5RSxPQUFPLEtBQUssRUFBRSxVQUFVLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNsRSxPQUFPLEVBQUUsS0FBSyxNQUFNLEVBQWdCLE1BQU0sdUJBQXVCLENBQUM7QUFHbEUsT0FBTyxLQUFLLEVBQUUsR0FBRyxFQUFpQixNQUFNLE1BQU0sQ0FBQztBQUUvQyxPQUFPLEtBQUssRUFBRSxpQkFBaUIsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBRWxFLHVGQUF1RjtBQUN2RixNQUFNLE1BQU0sY0FBYyxHQUFHO0lBQzNCLE9BQU8sRUFBRSxpQkFBaUIsQ0FBQztJQUMzQixZQUFZLEVBQUUsTUFBTSxHQUFHLFNBQVMsQ0FBQztJQUNqQyxVQUFVLEVBQUUsR0FBRyxHQUFHLFNBQVMsQ0FBQztDQUM3QixDQUFDO0FBRUY7Ozs7Ozs7Ozs7Ozs7R0FhRztBQUNILE1BQU0sTUFBTSxvQkFBb0IsR0FDNUI7SUFBRSxJQUFJLEVBQUUsU0FBUyxDQUFDO0lBQUMsUUFBUSxFQUFFLGlCQUFpQixFQUFFLENBQUM7SUFBQyxRQUFRLEVBQUUsTUFBTSxDQUFDO0lBQUMsZUFBZSxFQUFFLGNBQWMsRUFBRSxDQUFBO0NBQUUsR0FDdkc7SUFBRSxJQUFJLEVBQUUsVUFBVSxDQUFDO0lBQUMsUUFBUSxFQUFFLGlCQUFpQixFQUFFLENBQUM7SUFBQyxlQUFlLEVBQUUsY0FBYyxFQUFFLENBQUE7Q0FBRSxHQUN0RjtJQUFFLElBQUksRUFBRSxTQUFTLENBQUM7SUFBQyxNQUFNLEVBQUUsV0FBVyxDQUFDO0lBQUMsZUFBZSxFQUFFLGNBQWMsRUFBRSxDQUFBO0NBQUUsQ0FBQztBQUVoRixNQUFNLE1BQU0sV0FBVyxHQUFHLGNBQWMsR0FBRyxjQUFjLEdBQUcscUJBQXFCLENBQUM7QUFNbEY7Ozs7OztHQU1HO0FBQ0gscUJBQWEsd0JBQXdCO0lBSWpDLE9BQU8sQ0FBQyxRQUFRLENBQUMsSUFBSTtJQUh2QixPQUFPLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBUztJQUU3QixZQUNtQixJQUFJLEVBQUU7UUFDckIsWUFBWSxFQUFFLE1BQU0sU0FBUyxDQUFDO1FBQzlCLGNBQWMsRUFBRSxjQUFjLENBQUM7UUFDL0IsVUFBVSxFQUFFLFVBQVUsQ0FBQztRQUN2QixHQUFHLENBQUMsRUFBRSxNQUFNLENBQUM7S0FDZCxFQUdGO0lBRUQ7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7T0FzQkc7SUFDVSxRQUFRLENBQUMsYUFBYSxFQUFFLGlCQUFpQixFQUFFLEVBQUUsVUFBVSxFQUFFLFVBQVUsR0FBRyxPQUFPLENBQUMsb0JBQW9CLENBQUMsQ0E2RS9HO0lBRUQsT0FBTyxDQUFDLGtCQUFrQjtJQW1CMUI7OztPQUdHO0lBQ0gsT0FBTyxDQUFDLGVBQWU7SUFNdkI7OztPQUdHO0lBQ0gsT0FBTyxDQUFDLG1CQUFtQjtZQU9iLGlCQUFpQjtDQThDaEMifQ==
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sequencer-bundle-simulator.d.ts","sourceRoot":"","sources":["../../src/publisher/sequencer-bundle-simulator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAc,KAAK,cAAc,EAAyC,MAAM,2BAA2B,CAAC;AACnH,OAAO,EAAE,KAAK,SAAS,EAAmB,MAAM,6BAA6B,CAAC;AAE9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AAGlE,OAAO,KAAK,EAAE,GAAG,EAAiB,MAAM,MAAM,CAAC;AAE/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,uFAAuF;AACvF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,UAAU,EAAE,GAAG,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,cAAc,EAAE,CAAA;CAAE,GACvG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAAC,eAAe,EAAE,cAAc,EAAE,CAAA;CAAE,GACtF;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,eAAe,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC;AAEhF,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,cAAc,GAAG,qBAAqB,CAAC;AAMlF;;;;;;GAMG;AACH,qBAAa,wBAAwB;IAIjC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAE7B,YACmB,IAAI,EAAE;QACrB,YAAY,EAAE,MAAM,SAAS,CAAC;QAC9B,cAAc,EAAE,cAAc,CAAC;QAC/B,UAAU,EAAE,UAAU,CAAC;QACvB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,EAGF;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACU,QAAQ,CAAC,aAAa,EAAE,iBAAiB,EAAE,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA6E/G;IAED,OAAO,CAAC,kBAAkB;IAmB1B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAMvB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;YAOb,iBAAiB;CA8ChC"}
@@ -0,0 +1,198 @@
1
+ import { Multicall3, buildSimulationOverridesStateOverride } from '@aztec/ethereum/contracts';
2
+ import { MAX_L1_TX_LIMIT } from '@aztec/ethereum/l1-tx-utils';
3
+ import { formatViemError } from '@aztec/ethereum/utils';
4
+ import { createLogger } from '@aztec/foundation/log';
5
+ import { getLastL1SlotTimestampForL2Slot } from '@aztec/stdlib/epoch-helpers';
6
+ /**
7
+ * Bundle-level simulator for the aggregate3 payload that `SequencerPublisher` is about to send.
8
+ *
9
+ * Runs `eth_simulateV1` against `Multicall3.aggregate3`, drops entries that revert, and returns
10
+ * a gasLimit for the survivors. When `eth_simulateV1` is unavailable, signals fallback to the
11
+ * caller so it can send the bundle as-is with a conservative gas limit.
12
+ */ export class SequencerBundleSimulator {
13
+ deps;
14
+ log;
15
+ constructor(deps){
16
+ this.deps = deps;
17
+ this.log = deps.log ?? createLogger('sequencer:publisher:bundle-simulator');
18
+ }
19
+ /**
20
+ * Simulates the given bundle near the end of the target slot and filters out entries
21
+ * that revert.
22
+ *
23
+ * - If all entries pass on the first pass, returns `success` with the gasLimit.
24
+ * - If some entries revert, re-simulates the survivors. If the second pass is clean, returns
25
+ * `success` with the survivors and dropped entries. If the second pass surfaces any revert,
26
+ * returns `aborted` — we refuse to send a bundle whose composition still has internal
27
+ * reverts after one round of filtering.
28
+ * - If eth_simulateV1 is unavailable, returns `fallback`. The caller is expected to send the
29
+ * bundle as-is with a safe gas limit.
30
+ *
31
+ * The simulation `block.timestamp` is the last L1 slot timestamp inside the target L2 slot.
32
+ * This still maps to the target L2 slot for propose's `validateHeader` and EIP-712 signature
33
+ * checks, while avoiding eth_simulateV1 rejecting a child block whose timestamp is not strictly
34
+ * greater than the current L1 head.
35
+ *
36
+ * Known limitation: on networks where L1 is mining behind cadence (missed L1 slots, anvil with
37
+ * overridden timestamps), the actual `block.timestamp` at send time can land in the prior L2
38
+ * slot. In that case `propose` would revert silently inside the multicall. The simulator does
39
+ * not detect this case because it simulates inside the target slot — the prior implementation
40
+ * used `min(predictedNextL1Ts, targetTimestamp)` to surface this failure mode at simulate time.
41
+ */ async simulate(validRequests, targetSlot) {
42
+ if (validRequests.length === 0) {
43
+ return {
44
+ kind: 'aborted',
45
+ reason: 'empty-bundle',
46
+ droppedRequests: []
47
+ };
48
+ }
49
+ // Pin the publisher we'll use across the whole simulate call so that the publisher's rotation
50
+ // can't change l1TxUtils mid-flight.
51
+ const l1TxUtils = this.deps.getL1TxUtils();
52
+ const proposeRequest = validRequests.find((r)=>r.action === 'propose');
53
+ const simulateTimestamp = getLastL1SlotTimestampForL2Slot(targetSlot, this.deps.epochCache.getL1Constants());
54
+ const firstPassOverrides = await this.buildStateOverrides(!!proposeRequest);
55
+ const firstPass = await this.simulateAndDecode(l1TxUtils, validRequests, simulateTimestamp, firstPassOverrides);
56
+ if (firstPass.kind === 'fallback') {
57
+ this.log.warn('Bundle simulate fallback (eth_simulateV1 unavailable); caller will send bundle as-is', {
58
+ actions: validRequests.map((r)=>r.action)
59
+ });
60
+ return {
61
+ kind: 'fallback',
62
+ requests: validRequests,
63
+ droppedRequests: []
64
+ };
65
+ }
66
+ if (firstPass.survivors.length === 0) {
67
+ this.log.warn('All bundle entries dropped in simulation; aborting send', {
68
+ actions: validRequests.map((r)=>r.action)
69
+ });
70
+ return {
71
+ kind: 'aborted',
72
+ reason: 'all-reverted',
73
+ droppedRequests: firstPass.droppedRequests
74
+ };
75
+ }
76
+ if (firstPass.droppedRequests.length === 0) {
77
+ return this.buildSuccessResult(l1TxUtils, firstPass.survivors, [], firstPass.gasUsed, proposeRequest);
78
+ }
79
+ this.log.warn('Some bundle entries reverted; re-simulating reduced bundle', {
80
+ droppedActions: firstPass.droppedRequests.map((d)=>d.request.action),
81
+ remainingActions: firstPass.survivors.map((r)=>r.action)
82
+ });
83
+ // Rebuild overrides for the reduced bundle: if propose was dropped, we no longer need the blob-check override
84
+ const proposeSurvived = proposeRequest !== undefined && firstPass.survivors.includes(proposeRequest);
85
+ const secondPassOverrides = proposeSurvived ? firstPassOverrides : await this.buildStateOverrides(false);
86
+ const secondPass = await this.simulateAndDecode(l1TxUtils, firstPass.survivors, simulateTimestamp, secondPassOverrides);
87
+ if (secondPass.kind === 'fallback') {
88
+ this.log.warn('Bundle simulate errored on second pass (eth_simulateV1 unavailable); sending first-pass survivors as-is', {
89
+ actions: firstPass.survivors.map((r)=>r.action),
90
+ droppedActions: firstPass.droppedRequests.map((d)=>d.request.action)
91
+ });
92
+ return {
93
+ kind: 'fallback',
94
+ requests: firstPass.survivors,
95
+ droppedRequests: firstPass.droppedRequests
96
+ };
97
+ }
98
+ // We refuse to chase reverts through repeated trimming: anything other than a clean second pass aborts the whole send
99
+ if (secondPass.droppedRequests.length > 0) {
100
+ this.log.error('Re-simulate surfaced reverts; aborting send', {
101
+ secondPassDroppedActions: secondPass.droppedRequests.map((d)=>d.request.action)
102
+ });
103
+ return {
104
+ kind: 'aborted',
105
+ reason: 'second-pass-reverts',
106
+ droppedRequests: [
107
+ ...firstPass.droppedRequests,
108
+ ...secondPass.droppedRequests
109
+ ]
110
+ };
111
+ }
112
+ return this.buildSuccessResult(l1TxUtils, secondPass.survivors, firstPass.droppedRequests, secondPass.gasUsed, proposeRequest);
113
+ }
114
+ buildSuccessResult(l1TxUtils, survivors, droppedRequests, bundleGasUsed, proposeRequest) {
115
+ const proposeSurvived = proposeRequest !== undefined && survivors.includes(proposeRequest);
116
+ const blobEvaluationGas = proposeSurvived ? proposeRequest?.blobEvaluationGas ?? 0n : 0n;
117
+ const gasLimit = this.computeGasLimit(l1TxUtils, bundleGasUsed, blobEvaluationGas);
118
+ this.log.debug('Bundle simulate complete', {
119
+ survivingRequests: survivors.length,
120
+ bundleGasUsed,
121
+ gasLimit,
122
+ actions: survivors.map((r)=>r.action)
123
+ });
124
+ return {
125
+ kind: 'success',
126
+ requests: survivors,
127
+ gasLimit,
128
+ droppedRequests
129
+ };
130
+ }
131
+ /**
132
+ * `gasLimit = bumpGasLimit(ceil(gasUsed * 64 / 63))`, plus blob evaluation gas if a propose
133
+ * survived, capped at the L1 block gas limit.
134
+ */ computeGasLimit(l1TxUtils, bundleGasUsed, blobEvaluationGas) {
135
+ const gasUsedWithEip150 = (bundleGasUsed * 64n + 62n) / 63n;
136
+ const gasLimit = l1TxUtils.bumpGasLimit(gasUsedWithEip150) + blobEvaluationGas;
137
+ return gasLimit > MAX_L1_TX_LIMIT ? MAX_L1_TX_LIMIT : gasLimit;
138
+ }
139
+ /**
140
+ * eth_simulateV1 cannot carry blob sidecar data, so disable the rollup's on-chain blob check
141
+ * when a propose is in the bundle.
142
+ */ buildStateOverrides(hasProposeAction) {
143
+ return buildSimulationOverridesStateOverride(this.deps.rollupContract, hasProposeAction ? {
144
+ disableBlobCheck: true
145
+ } : undefined);
146
+ }
147
+ async simulateAndDecode(l1TxUtils, requests, simulateTimestamp, stateOverrides) {
148
+ let simResult;
149
+ try {
150
+ simResult = await Multicall3.simulateAggregate3(requests.map((r)=>({
151
+ to: r.request.to,
152
+ data: r.request.data,
153
+ abi: r.request.abi
154
+ })), l1TxUtils, {
155
+ blockOverrides: {
156
+ time: simulateTimestamp,
157
+ gasLimit: MAX_L1_TX_LIMIT * 2n
158
+ },
159
+ stateOverrides,
160
+ gas: MAX_L1_TX_LIMIT,
161
+ fallbackGasEstimate: MAX_L1_TX_LIMIT
162
+ });
163
+ } catch (err) {
164
+ this.log.warn('Bundle simulate threw; treating as fallback', {
165
+ err: formatViemError(err),
166
+ actions: requests.map((r)=>r.action)
167
+ });
168
+ return {
169
+ kind: 'fallback'
170
+ };
171
+ }
172
+ if (simResult.kind === 'fallback') {
173
+ return {
174
+ kind: 'fallback'
175
+ };
176
+ }
177
+ const survivors = [];
178
+ const droppedRequests = [];
179
+ for(let i = 0; i < requests.length; i++){
180
+ const entry = simResult.entries[i];
181
+ if (entry.success) {
182
+ survivors.push(requests[i]);
183
+ continue;
184
+ }
185
+ droppedRequests.push({
186
+ request: requests[i],
187
+ revertReason: entry.revertReason,
188
+ returnData: entry.returnData
189
+ });
190
+ }
191
+ return {
192
+ kind: 'decoded',
193
+ survivors,
194
+ droppedRequests,
195
+ gasUsed: simResult.gasUsed
196
+ };
197
+ }
198
+ }