context.hpp

Go to the documentation of this file.

#pragma once
 
#include <algorithm>
#include <cstdint>
#include <memory>
#include <span>
#include <utility>
#include <vector>
 
#include "barretenberg/vm2/common/aztec_types.hpp"
#include "barretenberg/vm2/common/field.hpp"
#include "barretenberg/vm2/common/memory_types.hpp"
#include "barretenberg/vm2/simulation/events/context_events.hpp"
#include "barretenberg/vm2/simulation/interfaces/bytecode_manager.hpp"
#include "barretenberg/vm2/simulation/interfaces/context.hpp"
#include "barretenberg/vm2/simulation/interfaces/db.hpp"
#include "barretenberg/vm2/simulation/interfaces/internal_call_stack_manager.hpp"
#include "barretenberg/vm2/simulation/interfaces/memory.hpp"
#include "barretenberg/vm2/simulation/interfaces/retrieved_bytecodes_tree_check.hpp"
#include "barretenberg/vm2/simulation/interfaces/written_public_data_slots_tree_check.hpp"
#include "barretenberg/vm2/simulation/lib/side_effect_tracker.hpp"
 
namespace bb::avm2::simulation {
 
// The context for a single nested call.
class BaseContext : public ContextInterface {
  public:
    BaseContext(uint32_t context_id,
                AztecAddress address,
                AztecAddress msg_sender,
                FF transaction_fee,
                bool is_static,
                Gas gas_limit,
                Gas gas_used,
                GlobalVariables globals,
                std::unique_ptr<BytecodeManagerInterface> bytecode,
                std::unique_ptr<MemoryInterface> memory,
                std::unique_ptr<InternalCallStackManagerInterface> internal_call_stack_manager,
                HighLevelMerkleDBInterface& merkle_db,
                WrittenPublicDataSlotsTreeCheckInterface& written_public_data_slots_tree,
                RetrievedBytecodesTreeCheckInterface& retrieved_bytecodes_tree,
                SideEffectTrackerInterface& side_effect_tracker,
                TransactionPhase phase)
        : merkle_db(merkle_db)
        , checkpoint_id_at_creation(merkle_db.get_checkpoint_id())
        , written_public_data_slots_tree(written_public_data_slots_tree)
        , retrieved_bytecodes_tree(retrieved_bytecodes_tree)
        , side_effect_tracker(side_effect_tracker)
        , address(address)
        , msg_sender(msg_sender)
        , transaction_fee(transaction_fee)
        , is_static(is_static)
        , globals(globals)
        , context_id(context_id)
        , gas_used(gas_used)
        , gas_limit(gas_limit)
        , bytecode(std::move(bytecode))
        , memory(std::move(memory))
        , internal_call_stack_manager(std::move(internal_call_stack_manager))
        , phase(phase)
    {}
 
    uint32_t get_last_child_id() const override;
 
    // Having getters and setters make it easier to mock the context.
    // Machine state.
    MemoryInterface& get_memory() override { return *memory; }
    const MemoryInterface& get_memory() const override { return *memory; }
    BytecodeManagerInterface& get_bytecode_manager() override { return *bytecode; }
    InternalCallStackManagerInterface& get_internal_call_stack_manager() override
    {
        return *internal_call_stack_manager;
    }
 
    PC get_pc() const override { return pc; }
    void set_pc(PC new_pc) override { pc = new_pc; }
    PC get_next_pc() const override { return next_pc; }
    void set_next_pc(PC new_next_pc) override { next_pc = new_next_pc; }
    bool halted() const override { return has_halted; }
    void halt() override { has_halted = true; }
 
    uint32_t get_context_id() const override { return context_id; }
 
    // Environment.
    const AztecAddress& get_address() const override { return address; }
    const AztecAddress& get_msg_sender() const override { return msg_sender; }
    const FF& get_transaction_fee() const override { return transaction_fee; }
    bool get_is_static() const override { return is_static; }
    SideEffectTrackerInterface& get_side_effect_tracker() override { return side_effect_tracker; }
 
    TransactionPhase get_phase() const override { return phase; }
 
    AppendOnlyTreeSnapshot get_written_public_data_slots_tree_snapshot() override
    {
        return written_public_data_slots_tree.get_snapshot();
    }
    const GlobalVariables& get_globals() const override { return globals; }
 
    ContextInterface& get_child_context() override { return *child_context; }
    const ContextInterface& get_child_context() const override { return *child_context; }
    void set_child_context(std::unique_ptr<ContextInterface> child_ctx) override
    {
        child_context = std::move(child_ctx);
    }
 
    MemoryAddress get_last_rd_addr() const override { return last_child_rd_addr; }
    void set_last_rd_addr(MemoryAddress rd_addr) override { last_child_rd_addr = rd_addr; }
 
    uint32_t get_last_rd_size() const override { return last_child_rd_size; }
    void set_last_rd_size(MemoryAddress rd_size) override { last_child_rd_size = rd_size; }
 
    bool get_last_success() const override { return last_child_success; }
    void set_last_success(bool success) override { last_child_success = success; }
 
    Gas get_gas_used() const override { return gas_used; }
    Gas get_gas_limit() const override { return gas_limit; }
 
    Gas gas_left() const override { return gas_limit - gas_used; }
 
    void set_gas_used(Gas gas_used) override { this->gas_used = gas_used; }
 
    uint32_t get_checkpoint_id_at_creation() const override { return checkpoint_id_at_creation; }
 
    // Input / Output
    std::vector<MemoryValue> get_returndata(uint32_t rd_offset, uint32_t rd_copy_size) const override;
 
  protected:
    HighLevelMerkleDBInterface& merkle_db;
    uint32_t checkpoint_id_at_creation; // DB id when the context was created.
    WrittenPublicDataSlotsTreeCheckInterface& written_public_data_slots_tree;
    RetrievedBytecodesTreeCheckInterface& retrieved_bytecodes_tree;
    SideEffectTrackerInterface& side_effect_tracker;
 
  private:
    // Environment.
    AztecAddress address;
    AztecAddress msg_sender;
    FF transaction_fee;
    bool is_static;
    GlobalVariables globals;
 
    uint32_t context_id;
 
    // Machine state.
    PC pc = 0;
    PC next_pc = 0;
    bool has_halted = false;
    Gas gas_used;
    Gas gas_limit;
    std::unique_ptr<BytecodeManagerInterface> bytecode;
    std::unique_ptr<MemoryInterface> memory;
    std::unique_ptr<InternalCallStackManagerInterface> internal_call_stack_manager;
 
    // Output
    std::unique_ptr<ContextInterface> child_context = nullptr;
    MemoryAddress last_child_rd_addr = 0;
    MemoryAddress last_child_rd_size = 0;
    bool last_child_success = false;
 
    TransactionPhase phase;
};
 
class EnqueuedCallContext : public BaseContext {
  public:
    EnqueuedCallContext(uint32_t context_id,
                        AztecAddress address,
                        AztecAddress msg_sender,
                        FF transaction_fee,
                        bool is_static,
                        Gas gas_limit,
                        Gas gas_used,
                        GlobalVariables globals,
                        std::unique_ptr<BytecodeManagerInterface> bytecode,
                        std::unique_ptr<MemoryInterface> memory,
                        std::unique_ptr<InternalCallStackManagerInterface> internal_call_stack_manager,
                        HighLevelMerkleDBInterface& merkle_db,
                        WrittenPublicDataSlotsTreeCheckInterface& written_public_data_slots_tree,
                        RetrievedBytecodesTreeCheckInterface& retrieved_bytecodes_tree,
                        SideEffectTrackerInterface& side_effect_tracker,
                        TransactionPhase phase,
                        std::span<const FF> calldata)
        : BaseContext(context_id,
                      address,
                      msg_sender,
                      transaction_fee,
                      is_static,
                      gas_limit,
                      gas_used,
                      globals,
                      std::move(bytecode),
                      std::move(memory),
                      std::move(internal_call_stack_manager),
                      merkle_db,
                      written_public_data_slots_tree,
                      retrieved_bytecodes_tree,
                      side_effect_tracker,
                      phase)
    {
        this->calldata.resize(calldata.size());
        std::ranges::transform(calldata.begin(),
                               calldata.end(),
                               this->calldata.begin(),
                               [](const FF& value) -> MemoryValue { return MemoryValue::from<FF>(value); });
    }
 
    uint32_t get_parent_id() const override { return 0; } // No parent context for the top-level context.
    bool has_parent() const override { return false; }
    // Event Emitting
    ContextEvent serialize_context_event() override;
 
    // Input / Output
    std::vector<MemoryValue> get_calldata(uint32_t cd_offset, uint32_t cd_copy_size) const override;
 
    Gas get_parent_gas_used() const override { return Gas{}; }
    Gas get_parent_gas_limit() const override { return Gas{}; }
 
    MemoryAddress get_parent_cd_addr() const override { return 0; }
    uint32_t get_parent_cd_size() const override { return static_cast<uint32_t>(calldata.size()); }
 
  private:
    std::vector<MemoryValue> calldata;
};
 
// Parameters for a nested call need to be changed
class NestedContext : public BaseContext {
  public:
    NestedContext(uint32_t context_id,
                  AztecAddress address,
                  AztecAddress msg_sender,
                  FF transaction_fee,
                  bool is_static,
                  Gas gas_limit,
                  GlobalVariables globals,
                  std::unique_ptr<BytecodeManagerInterface> bytecode,
                  std::unique_ptr<MemoryInterface> memory,
                  std::unique_ptr<InternalCallStackManagerInterface> internal_call_stack_manager,
                  HighLevelMerkleDBInterface& merkle_db,
                  WrittenPublicDataSlotsTreeCheckInterface& written_public_data_slots_tree,
                  RetrievedBytecodesTreeCheckInterface& retrieved_bytecodes_tree,
                  SideEffectTrackerInterface& side_effect_tracker,
                  TransactionPhase phase,
                  ContextInterface& parent_context,
                  MemoryAddress cd_offset_address, /* This is a direct mem address */
                  uint32_t cd_size)
        : BaseContext(context_id,
                      address,
                      msg_sender,
                      transaction_fee,
                      is_static,
                      gas_limit,
                      Gas{ 0, 0 },
                      globals,
                      std::move(bytecode),
                      std::move(memory),
                      std::move(internal_call_stack_manager),
                      merkle_db,
                      written_public_data_slots_tree,
                      retrieved_bytecodes_tree,
                      side_effect_tracker,
                      phase)
        , parent_cd_addr(cd_offset_address)
        , parent_cd_size(cd_size)
        , parent_context(parent_context)
    {}
 
    uint32_t get_parent_id() const override { return parent_context.get_context_id(); }
    bool has_parent() const override { return true; }
 
    Gas get_parent_gas_used() const override { return parent_context.get_gas_used(); }
    Gas get_parent_gas_limit() const override { return parent_context.get_gas_limit(); }
 
    // Event Emitting
    ContextEvent serialize_context_event() override;
 
    // Input / Output
    std::vector<MemoryValue> get_calldata(uint32_t cd_offset, uint32_t cd_copy_size) const override;
 
    MemoryAddress get_parent_cd_addr() const override { return parent_cd_addr; }
    uint32_t get_parent_cd_size() const override { return parent_cd_size; }
 
  private:
    // These are direct addresses to look up into the parent context during calldata copying
    MemoryAddress parent_cd_addr;
    MemoryAddress parent_cd_size;
 
    ContextInterface& parent_context;
};
 
} // namespace bb::avm2::simulation