anvil_zksync_l1_sidecar/
l1_executor.rs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
use crate::commitment_generator::CommitmentGenerator;
use crate::l1_sender::L1SenderHandle;
use std::time::Duration;
use tokio::sync::watch;
use zksync_types::L1BatchNumber;

#[derive(Debug, Clone)]
pub struct L1Executor {
    mode: L1ExecutorMode,
}

impl L1Executor {
    /// Batches will not be executed on L1 unless requested manually through JSON RPC API.
    pub fn manual() -> Self {
        Self {
            mode: L1ExecutorMode::Manual,
        }
    }

    /// Batches will be executed on L1 shortly after they get sealed.
    pub fn auto(
        commitment_generator: CommitmentGenerator,
        l1_sender_handle: L1SenderHandle,
    ) -> Self {
        Self {
            mode: L1ExecutorMode::Auto(L1ExecutorModeAuto {
                last_executed_batch: L1BatchNumber(0),
                commitment_generator,
                l1_sender_handle,
            }),
        }
    }

    pub async fn run(self, stop_receiver: &mut watch::Receiver<bool>) -> anyhow::Result<()> {
        match self.mode {
            L1ExecutorMode::Manual => {
                stop_receiver.changed().await?;
                Ok(())
            }
            L1ExecutorMode::Auto(executor) => executor.run(stop_receiver).await,
        }
    }
}

#[derive(Debug, Clone)]
enum L1ExecutorMode {
    Manual,
    Auto(L1ExecutorModeAuto),
}

#[derive(Debug, Clone)]
struct L1ExecutorModeAuto {
    last_executed_batch: L1BatchNumber,
    commitment_generator: CommitmentGenerator,
    l1_sender_handle: L1SenderHandle,
}

impl L1ExecutorModeAuto {
    async fn run(mut self, stop_receiver: &mut watch::Receiver<bool>) -> anyhow::Result<()> {
        const POLL_INTERVAL: Duration = Duration::from_millis(100);

        loop {
            if *stop_receiver.borrow() {
                tracing::info!("automatic L1 executor was interrupted");
                return Ok(());
            }
            let next_batch = self.last_executed_batch + 1;
            let Some(batch_with_metadata) = self
                .commitment_generator
                .get_or_generate_metadata(next_batch)
                .await
            else {
                tracing::trace!(batch_number=%next_batch, "batch is not ready to be executed yet");
                tokio::time::timeout(POLL_INTERVAL, stop_receiver.changed())
                    .await
                    .ok();
                continue;
            };
            self.l1_sender_handle
                .commit_sync(batch_with_metadata.clone())
                .await?;
            self.l1_sender_handle
                .prove_sync(batch_with_metadata.clone())
                .await?;
            self.l1_sender_handle
                .execute_sync(batch_with_metadata)
                .await?;
            tracing::debug!(batch_number=%next_batch, "batch has been automatically executed on L1");
            self.last_executed_batch = next_batch;
        }
    }
}