ave-core 0.11.0

Averiun Ledger core runtime and node API
Documentation
use std::{collections::VecDeque, sync::Arc, time::Duration};

use crate::{
    ActorMessage, NetworkMessage,
    approval::types::VotationType,
    helpers::network::service::NetworkSender,
    model::{
        common::emit_fail,
        network::{RetryNetwork, TimeOut},
    },
};
use async_trait::async_trait;
use ave_actors::{
    Actor, ActorContext, ActorError, ActorPath, ChildAction,
    CustomIntervalStrategy, Handler, Message, NotPersistentActor, RetryActor,
    RetryMessage, Strategy,
};
use ave_common::identity::{
    DigestIdentifier, HashAlgorithm, PublicKey, Signed, TimeStamp,
};
use ave_network::ComunicateInfo;
use tracing::{Span, debug, error, info_span, warn};

use super::{
    Approval, ApprovalMessage, request::ApprovalReq, response::ApprovalRes,
};

#[derive(Clone, Debug)]
pub struct ApprLight {
    network: Arc<NetworkSender>,
    node_key: PublicKey,
    request_id: DigestIdentifier,
    version: u64,
}

impl ApprLight {
    pub const fn new(
        network: Arc<NetworkSender>,
        node_key: PublicKey,
        request_id: DigestIdentifier,
        version: u64,
    ) -> Self {
        Self {
            network,
            node_key,
            request_id,
            version,
        }
    }
}

pub struct InitApprLight {
    pub request_id: DigestIdentifier,
    pub version: u64,
    pub our_key: Arc<PublicKey>,
    pub node_key: PublicKey,
    pub subject_id: String,
    pub pass_votation: VotationType,
    pub hash: HashAlgorithm,
    pub network: Arc<NetworkSender>,
}

#[derive(Debug, Clone)]
pub enum ApprLightMessage {
    EndRetry,
    // Lanza los retries y envía la petición a la network(exponencial)
    NetworkApproval {
        approval_req: Signed<ApprovalReq>,
    },
    // Finaliza los retries y recibe la respuesta de la network
    NetworkResponse {
        approval_res: Signed<ApprovalRes>,
        request_id: String,
        version: u64,
        sender: PublicKey,
    },
}

impl Message for ApprLightMessage {}

#[async_trait]
impl Actor for ApprLight {
    type Event = ();
    type Message = ApprLightMessage;
    type Response = ();

    fn get_span(id: &str, parent_span: Option<Span>) -> tracing::Span {
        parent_span.map_or_else(
            || info_span!("ApprLight", id),
            |parent_span| info_span!(parent: parent_span, "ApprLight", id),
        )
    }
}

#[async_trait]
impl Handler<Self> for ApprLight {
    async fn handle_message(
        &mut self,
        _sender: ActorPath,
        msg: ApprLightMessage,
        ctx: &mut ActorContext<Self>,
    ) -> Result<(), ActorError> {
        match msg {
            ApprLightMessage::EndRetry => {
                debug!(
                    node_key = %self.node_key,
                    "Retry exhausted, notifying parent and stopping"
                );

                match ctx.get_parent::<Approval>().await {
                    Ok(approval_actor) => {
                        if let Err(e) = approval_actor
                            .tell(ApprovalMessage::Response {
                                approval_res: ApprovalRes::TimeOut(TimeOut {
                                    re_trys: 3,
                                    timestamp: TimeStamp::now(),
                                    who: self.node_key.clone(),
                                }),
                                sender: self.node_key.clone(),
                                signature: None,
                            })
                            .await
                        {
                            error!(
                                error = %e,
                                "Failed to send timeout response to approval actor"
                            );
                            emit_fail(ctx, e).await;
                        }

                        debug!(
                            request_id = %self.request_id,
                            version = self.version,
                            node_key = %self.node_key,
                            "Timeout response sent to approval actor"
                        );
                    }
                    Err(e) => {
                        error!(
                            error = %e,
                            path = %ctx.path().parent(),
                            "Approval actor not found"
                        );
                        emit_fail(ctx, e).await;
                    }
                }

                ctx.stop(None).await;
            }
            ApprLightMessage::NetworkApproval { approval_req } => {
                // Solo admitimos eventos FACT
                let subject_id = approval_req.content().subject_id.clone();

                let receiver_actor = format!(
                    "/user/node/subject_manager/{}/approver",
                    subject_id
                );

                let message = NetworkMessage {
                    info: ComunicateInfo {
                        request_id: self.request_id.to_string(),
                        version: self.version,
                        receiver: self.node_key.clone(),
                        receiver_actor,
                    },
                    message: ActorMessage::ApprovalReq { req: approval_req },
                };

                let target = RetryNetwork::new(self.network.clone());

                let strategy = Strategy::CustomIntervalStrategy(
                    CustomIntervalStrategy::new(VecDeque::from([
                        Duration::from_hours(4),
                        Duration::from_hours(8),
                        Duration::from_hours(16),
                    ])),
                );

                let retry_actor = RetryActor::new_with_parent_message::<Self>(
                    target,
                    message,
                    strategy,
                    ApprLightMessage::EndRetry,
                );

                let retry = match ctx
                    .create_child::<RetryActor<RetryNetwork>, _>(
                        "retry",
                        retry_actor,
                    )
                    .await
                {
                    Ok(retry) => retry,
                    Err(e) => {
                        error!(
                            msg_type = "NetworkApproval",
                            error = %e,
                            "Failed to create retry actor"
                        );
                        return Err(emit_fail(ctx, e).await);
                    }
                };

                if let Err(e) = retry.tell(RetryMessage::Retry).await {
                    error!(
                        msg_type = "NetworkApproval",
                        error = %e,
                        "Failed to send retry message"
                    );
                    return Err(emit_fail(ctx, e).await);
                };

                debug!(
                    msg_type = "NetworkApproval",
                    request_id = %self.request_id,
                    version = self.version,
                    "Retry actor created and started"
                );
            }
            // Finaliza los retries
            ApprLightMessage::NetworkResponse {
                approval_res,
                request_id,
                version,
                sender,
            } => {
                if request_id == self.request_id.to_string()
                    && version == self.version
                {
                    if self.node_key != sender
                        || sender != approval_res.signature().signer
                    {
                        error!(
                            msg_type = "NetworkResponse",
                            expected_node = %self.node_key,
                            received_sender = %sender,
                            "Unexpected approval sender"
                        );
                        return Ok(());
                    }

                    if let Err(e) = approval_res.verify() {
                        error!(
                            msg_type = "NetworkResponse",
                            error = %e,
                            "Invalid approval signature"
                        );
                        return Ok(());
                    }

                    match ctx.get_parent::<Approval>().await {
                        Ok(approval_actor) => {
                            if let Err(e) = approval_actor
                                .tell(ApprovalMessage::Response {
                                    approval_res: approval_res
                                        .content()
                                        .clone(),
                                    sender: self.node_key.clone(),
                                    signature: Some(
                                        approval_res.signature().clone(),
                                    ),
                                })
                                .await
                            {
                                error!(
                                    msg_type = "NetworkResponse",
                                    error = %e,
                                    "Failed to send response to approval actor"
                                );
                                return Err(emit_fail(ctx, e).await);
                            }
                        }
                        Err(e) => {
                            error!(
                                msg_type = "NetworkResponse",
                                path = %ctx.path().parent(),
                                "Approval actor not found"
                            );
                            return Err(emit_fail(ctx, e).await);
                        }
                    };

                    'retry: {
                        let Ok(retry) = ctx
                            .get_child::<RetryActor<RetryNetwork>>("retry")
                            .await
                        else {
                            break 'retry;
                        };

                        if let Err(e) = retry.tell(RetryMessage::End).await {
                            error!(
                                msg_type = "NetworkResponse",
                                error = %e,
                                "Failed to send end message to retry actor"
                            );
                            break 'retry;
                        };
                    }

                    debug!(
                        msg_type = "NetworkResponse",
                        request_id = %request_id,
                        version = version,
                        "Approval response processed successfully"
                    );

                    ctx.stop(None).await;
                } else {
                    warn!(
                        msg_type = "NetworkResponse",
                        expected_request_id = %self.request_id,
                        received_request_id = %request_id,
                        expected_version = self.version,
                        received_version = version,
                        "Mismatched request id or version"
                    );
                }
            }
        }
        Ok(())
    }

    async fn on_child_fault(
        &mut self,
        error: ActorError,
        ctx: &mut ActorContext<Self>,
    ) -> ChildAction {
        error!(
            request_id = %self.request_id,
            version = self.version,
            node_key = %self.node_key,
            error = %error,
            "Child fault in approval light actor"
        );
        emit_fail(ctx, error).await;
        ChildAction::Stop
    }
}

impl NotPersistentActor for ApprLight {}