cairo-air 1.2.2

AIR (Algebraic Intermediate Representation) definitions for Cairo programs
Documentation
// This file was created by the AIR team.

use crate::components::prelude::*;
use crate::components::subroutines::decode_instruction_f1edd::DecodeInstructionF1Edd;
use crate::components::subroutines::read_positive_num_bits_29::ReadPositiveNumBits29;

pub const N_TRACE_COLUMNS: usize = 25;
pub const RELATION_USES_PER_ROW: [RelationUse; 4] = [
    RelationUse {
        relation_id: "MemoryAddressToId",
        uses: 3,
    },
    RelationUse {
        relation_id: "MemoryIdToBig",
        uses: 3,
    },
    RelationUse {
        relation_id: "Opcodes",
        uses: 1,
    },
    RelationUse {
        relation_id: "VerifyInstruction",
        uses: 1,
    },
];

pub struct Eval {
    pub claim: Claim,
    pub common_lookup_elements: relations::CommonLookupElements,
}

#[derive(Copy, Clone, Serialize, Deserialize, CairoSerialize, CairoDeserialize)]
pub struct Claim {
    pub log_size: u32,
}
impl Claim {
    pub fn log_sizes(&self) -> TreeVec<Vec<u32>> {
        let trace_log_sizes = vec![self.log_size; N_TRACE_COLUMNS];
        let interaction_log_sizes = vec![self.log_size; SECURE_EXTENSION_DEGREE * 5];
        TreeVec::new(vec![vec![], trace_log_sizes, interaction_log_sizes])
    }
}

#[derive(Copy, Clone, Serialize, Deserialize, CairoSerialize, CairoDeserialize)]
pub struct InteractionClaim {
    pub claimed_sum: SecureField,
}

pub type Component = FrameworkComponent<Eval>;

impl FrameworkEval for Eval {
    fn log_size(&self) -> u32 {
        self.claim.log_size
    }

    fn max_constraint_log_degree_bound(&self) -> u32 {
        self.log_size() + 1
    }

    #[allow(unused_parens)]
    #[allow(clippy::double_parens)]
    #[allow(non_snake_case)]
    fn evaluate<E: EvalAtRow>(&self, mut eval: E) -> E {
        let M31_1 = E::F::from(M31::from(1));
        let M31_134217728 = E::F::from(M31::from(134217728));
        let M31_2 = E::F::from(M31::from(2));
        let M31_262144 = E::F::from(M31::from(262144));
        let M31_428564188 = E::F::from(M31::from(428564188));
        let M31_512 = E::F::from(M31::from(512));
        let input_pc_col0 = eval.next_trace_mask();
        let input_ap_col1 = eval.next_trace_mask();
        let input_fp_col2 = eval.next_trace_mask();
        let offset2_col3 = eval.next_trace_mask();
        let op1_base_fp_col4 = eval.next_trace_mask();
        let stored_fp_id_col5 = eval.next_trace_mask();
        let stored_fp_limb_0_col6 = eval.next_trace_mask();
        let stored_fp_limb_1_col7 = eval.next_trace_mask();
        let stored_fp_limb_2_col8 = eval.next_trace_mask();
        let stored_fp_limb_3_col9 = eval.next_trace_mask();
        let partial_limb_msb_col10 = eval.next_trace_mask();
        let stored_ret_pc_id_col11 = eval.next_trace_mask();
        let stored_ret_pc_limb_0_col12 = eval.next_trace_mask();
        let stored_ret_pc_limb_1_col13 = eval.next_trace_mask();
        let stored_ret_pc_limb_2_col14 = eval.next_trace_mask();
        let stored_ret_pc_limb_3_col15 = eval.next_trace_mask();
        let partial_limb_msb_col16 = eval.next_trace_mask();
        let mem1_base_col17 = eval.next_trace_mask();
        let next_pc_id_col18 = eval.next_trace_mask();
        let next_pc_limb_0_col19 = eval.next_trace_mask();
        let next_pc_limb_1_col20 = eval.next_trace_mask();
        let next_pc_limb_2_col21 = eval.next_trace_mask();
        let next_pc_limb_3_col22 = eval.next_trace_mask();
        let partial_limb_msb_col23 = eval.next_trace_mask();
        let enabler_col24 = eval.next_trace_mask();

        #[allow(clippy::unused_unit)]
        #[allow(unused_variables)]
        let [decode_instruction_f1edd_output_tmp_32b66_4_offset2, decode_instruction_f1edd_output_tmp_32b66_4_op1_base_ap] =
            DecodeInstructionF1Edd::evaluate(
                [input_pc_col0.clone()],
                offset2_col3.clone(),
                op1_base_fp_col4.clone(),
                &self.common_lookup_elements,
                &mut eval,
            );
        ReadPositiveNumBits29::evaluate(
            [input_ap_col1.clone()],
            stored_fp_id_col5.clone(),
            stored_fp_limb_0_col6.clone(),
            stored_fp_limb_1_col7.clone(),
            stored_fp_limb_2_col8.clone(),
            stored_fp_limb_3_col9.clone(),
            partial_limb_msb_col10.clone(),
            &self.common_lookup_elements,
            &mut eval,
        );
        //[ap] = fp.
        eval.add_constraint(
            ((((stored_fp_limb_0_col6.clone()
                + (stored_fp_limb_1_col7.clone() * M31_512.clone()))
                + (stored_fp_limb_2_col8.clone() * M31_262144.clone()))
                + (stored_fp_limb_3_col9.clone() * M31_134217728.clone()))
                - input_fp_col2.clone()),
        );
        ReadPositiveNumBits29::evaluate(
            [(input_ap_col1.clone() + M31_1.clone())],
            stored_ret_pc_id_col11.clone(),
            stored_ret_pc_limb_0_col12.clone(),
            stored_ret_pc_limb_1_col13.clone(),
            stored_ret_pc_limb_2_col14.clone(),
            stored_ret_pc_limb_3_col15.clone(),
            partial_limb_msb_col16.clone(),
            &self.common_lookup_elements,
            &mut eval,
        );
        //[ap+1] = return_pc.
        eval.add_constraint(
            ((((stored_ret_pc_limb_0_col12.clone()
                + (stored_ret_pc_limb_1_col13.clone() * M31_512.clone()))
                + (stored_ret_pc_limb_2_col14.clone() * M31_262144.clone()))
                + (stored_ret_pc_limb_3_col15.clone() * M31_134217728.clone()))
                - (input_pc_col0.clone() + M31_1.clone())),
        );
        // mem1_base.
        eval.add_constraint(
            (mem1_base_col17.clone()
                - ((op1_base_fp_col4.clone() * input_fp_col2.clone())
                    + (decode_instruction_f1edd_output_tmp_32b66_4_op1_base_ap.clone()
                        * input_ap_col1.clone()))),
        );
        ReadPositiveNumBits29::evaluate(
            [(mem1_base_col17.clone()
                + decode_instruction_f1edd_output_tmp_32b66_4_offset2.clone())],
            next_pc_id_col18.clone(),
            next_pc_limb_0_col19.clone(),
            next_pc_limb_1_col20.clone(),
            next_pc_limb_2_col21.clone(),
            next_pc_limb_3_col22.clone(),
            partial_limb_msb_col23.clone(),
            &self.common_lookup_elements,
            &mut eval,
        );
        // Enabler is a bit.
        eval.add_constraint(
            ((enabler_col24.clone() * enabler_col24.clone()) - enabler_col24.clone()),
        );
        eval.add_to_relation(RelationEntry::new(
            &self.common_lookup_elements,
            E::EF::from(enabler_col24.clone()),
            &[
                M31_428564188.clone(),
                input_pc_col0.clone(),
                input_ap_col1.clone(),
                input_fp_col2.clone(),
            ],
        ));

        eval.add_to_relation(RelationEntry::new(
            &self.common_lookup_elements,
            -E::EF::from(enabler_col24.clone()),
            &[
                M31_428564188.clone(),
                (((next_pc_limb_0_col19.clone()
                    + (next_pc_limb_1_col20.clone() * M31_512.clone()))
                    + (next_pc_limb_2_col21.clone() * M31_262144.clone()))
                    + (next_pc_limb_3_col22.clone() * M31_134217728.clone())),
                (input_ap_col1.clone() + M31_2.clone()),
                (input_ap_col1.clone() + M31_2.clone()),
            ],
        ));

        eval.finalize_logup_in_pairs();
        eval
    }
}

#[cfg(test)]
mod tests {
    use num_traits::Zero;
    use rand::rngs::SmallRng;
    use rand::{Rng, SeedableRng};
    use stwo::core::fields::qm31::QM31;
    use stwo_constraint_framework::expr::ExprEvaluator;

    use super::*;
    use crate::components::constraints_regression_test_values::CALL_OPCODE_ABS;

    #[test]
    fn call_opcode_abs_constraints_regression() {
        let mut rng = SmallRng::seed_from_u64(0);
        let eval = Eval {
            claim: Claim { log_size: 4 },
            common_lookup_elements: relations::CommonLookupElements::dummy(),
        };
        let expr_eval = eval.evaluate(ExprEvaluator::new());
        let assignment = expr_eval.random_assignment();

        let mut sum = QM31::zero();
        for c in expr_eval.constraints {
            sum += c.assign(&assignment) * rng.gen::<QM31>();
        }

        CALL_OPCODE_ABS.assert_debug_eq(&sum);
    }
}