Kona Node의 Derivation

​

개요

​

주요 구성 요소

• DerivationActor: derivation 파이프라인을 실행하는 주 actor
• OnlinePipeline: 온라인 provider를 사용하는 derivation 파이프라인의 구체적인 구현
• DerivationStateMachine: derivation이 허용되는 시점을 관리하고 확인된 safe head를 추적
• L2Finalizer: 최종 확정(finalization)을 기다리는 derive된 L2 블록을 추적
• Signal System: 파이프라인 리셋, 하드포크 활성화, 오류 상황을 처리

​

아키텍처

​

DerivationActor

pub struct DerivationActor<DerivationEngineClient_, PipelineSignalReceiver>
where
    DerivationEngineClient_: DerivationEngineClient,
    PipelineSignalReceiver: Pipeline + SignalReceiver,
{
    /// The channel on which all inbound requests are received by the actor.
    inbound_request_rx: mpsc::Receiver<DerivationActorRequest>,
    /// The Engine client used to interact with the engine.
    engine_client: DerivationEngineClient_,
    /// The derivation pipeline.
    pipeline: PipelineSignalReceiver,
    /// The state machine controlling when derivation can occur.
    derivation_state_machine: DerivationStateMachine,
    /// The L2Finalizer tracks derived L2 blocks awaiting finalization.
    finalizer: L2Finalizer,
}

• Engine Actor: 실행할 payload attributes를 받고, safe head 업데이트와 파이프라인 시그널을 다시 보냅니다
• L1 Watcher Actor: L1 체인의 L1 head 및 최종 확정 블록 업데이트를 보냅니다

​

파이프라인 구성

OnlinePipeline::new_polled(
    self.config.clone(),
    self.l1_config.chain_config.clone(),
    OnlineBlobProvider::init(self.l1_config.beacon_client.clone()).await,
    l1_derivation_provider,
    l2_derivation_provider,
    self.dependency_set.clone(),
)

​

Provider 구성

• AlloyChainProvider: 캐시 크기를 구성할 수 있는 L1 블록체인 데이터를 제공합니다
• AlloyL2ChainProvider: L2 블록체인 데이터와 시스템 구성을 제공합니다
• OnlineBlobProvider: 4844 이후 트랜잭션을 위해 beacon chain에서 blob 데이터를 가져옵니다

const DERIVATION_PROVIDER_CACHE_SIZE: usize = 1024;

​

파이프라인 동작

​

메인 처리 루프

1. 종료 시그널: 취소 토큰이 트리거되면 정상 종료(graceful shutdown)합니다
2. L1 head 업데이트: 새 L1 블록을 사용할 수 있게 되면 derivation을 트리거합니다
3. Safe head 업데이트: L2 safe head가 진행되면 derivation을 트리거합니다
4. 파이프라인 시그널: 리셋, 하드포크 활성화, 채널 flush를 처리합니다

​

스테핑 로직

async fn produce_next_attributes(
    &mut self,
) -> Result<OpAttributesWithParent, DerivationError>

1. derivation 상태 머신에서 마지막으로 확인된 L2 safe head로 파이프라인을 한 단계 진행합니다
2. 단계 결과를 처리합니다.
   • PreparedAttributes: attributes를 소비할 준비가 되었습니다
   • AdvancedOrigin: 파이프라인이 다음 L1 블록으로 진행했습니다
   • OriginAdvanceErr/StepFailed: 다양한 오류 상황을 처리합니다
3. attributes를 사용할 수 있으면 attributes를 반환합니다

​

오류 처리

​

일시적 오류

• PipelineError::NotEnoughData: 더 많은 데이터를 사용할 수 있게 될 수 있으므로 계속 진행합니다
• PipelineError::Eof: 양보(yield)하고 더 많은 L1 데이터를 기다립니다

​

리셋 오류

• ResetError::HoloceneActivation: 파이프라인에 ActivationSignal을 보내고 계속 진행합니다
• ResetError::ReorgDetected를 포함한 그 밖의 모든 리셋 오류: 엔진에 리셋 요청을 보낸 다음, 계속하기 전에 엔진의 시그널을 기다립니다. ReorgDetected는 추가로 L1_REORG_COUNT 메트릭을 증가시킵니다.

​

치명적 오류

• derivation 프로세스를 종료시키는 복구 불가능한 오류입니다
• 메트릭 카운터를 증가시키고 오류를 상위로 전파합니다

​

시그널 처리

• ResetSignal: 새 L1 origin과 시스템 구성으로 파이프라인 상태를 리셋합니다
• ActivationSignal: 하드포크 활성화(예: Holocene)를 처리합니다
• FlushChannel: deposit 전용 블록을 위해 현재 채널 데이터를 무효화합니다

​

구성

​

Rollup 구성

• 체인 매개변수(체인 ID, 블록 시간 등)
• 하드포크 활성화 높이
• 시스템 구성 주소
• 배치 및 채널 매개변수

​

런타임 구성

• Provider 캐시 크기
• L1 데이터 폴링 간격
• 메트릭 수집 설정

​

통합 패턴

​

Engine Actor와의 통합

// Send payload attributes out for processing.
self.engine_client
    .send_safe_l2_signal(payload_attributes.into())
    .await

​

L1 Watcher와의 통합

​

RPC 계층과의 통합

​

메트릭 및 관측 가능성

• DERIVATION_L1_ORIGIN: 현재 L1 origin 블록 번호
• DERIVATION_CRITICAL_ERROR: 치명적 derivation 오류 횟수
• L1_REORG_COUNT: 감지된 L1 재구성(reorg) 횟수

​

관련 문서

• kona-derive crate 소스
• docs.rs의 kona-derive API 문서
• derivation 파이프라인 사양