Skip to content
This repository has been archived by the owner on Aug 21, 2024. It is now read-only.

Commit

Permalink
reformat(execution): bouncer update function
Browse files Browse the repository at this point in the history
  • Loading branch information
Yael-Starkware committed Mar 7, 2024
1 parent 8a08095 commit 9765169
Show file tree
Hide file tree
Showing 4 changed files with 124 additions and 15 deletions.
7 changes: 7 additions & 0 deletions crates/blockifier/src/blockifier/block.rs
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ use starknet_api::hash::StarkFelt;
use starknet_api::state::StorageKey;

use crate::abi::constants;
use crate::bouncer::BouncerWeights;
use crate::context::{BlockContext, ChainInfo};
use crate::state::errors::StateError;
use crate::state::state_api::{State, StateResult};
Expand All @@ -27,6 +28,12 @@ pub struct BlockInfo {
pub use_kzg_da: bool,
}

#[derive(Clone, Debug)]
pub struct BouncerConfig {
pub block_max_capacity: BouncerWeights,
pub block_max_capacity_with_keccak: BouncerWeights,
}

#[derive(Clone, Debug)]
pub struct GasPrices {
pub eth_l1_gas_price: NonZeroU128, // In wei.
Expand Down
122 changes: 110 additions & 12 deletions crates/blockifier/src/bouncer.rs
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,15 @@ use serde::Deserialize;
use starknet_api::core::ClassHash;

use crate::abi::constants;
use crate::blockifier::block::BouncerConfig;
use crate::blockifier::transaction_executor::{
get_casm_hash_calculation_resources, get_particia_update_resources, TransactionExecutorResult,
};
use crate::execution::call_info::{CallInfo, MessageL1CostInfo};
use crate::fee::gas_usage::{get_onchain_data_segment_length, get_starknet_gas_usage};
use crate::state::cached_state::{StateChangesKeys, StorageEntry, TransactionalState};
use crate::state::state_api::StateReader;
use crate::transaction::errors::TransactionExecutionError;
use crate::transaction::objects::TransactionExecutionInfo;
use crate::utils::usize_from_u128;

Expand Down Expand Up @@ -83,6 +85,17 @@ impl BouncerWeights {
n_steps,
state_diff_size
);

pub fn create_for_testing(with_keccak: bool) -> Self {
Self {
gas: 2500000,
n_steps: 2500000,
message_segment_length: 3750,
state_diff_size: 20000,
n_events: 10000,
builtin_count: BuiltinCount::create_for_testing(with_keccak),
}
}
}

#[derive(
Expand Down Expand Up @@ -120,24 +133,40 @@ impl From<HashMapWrapper> for BuiltinCount {

impl BuiltinCount {
impl_checked_sub!(bitwise, ecdsa, ec_op, keccak, pedersen, poseidon, range_check);

pub fn create_for_testing(with_keccak: bool) -> Self {
Self {
bitwise: 39062,
ecdsa: 1220,
ec_op: 2441,
keccak: {
if with_keccak { 0 } else { 1220 }
},
pedersen: 78125,
poseidon: 78125,
range_check: 156250,
}
}
}

#[derive(Clone)]
pub struct Bouncer {
pub executed_class_hashes: HashSet<ClassHash>,
pub visited_storage_entries: HashSet<StorageEntry>,
pub state_changes_keys: StateChangesKeys,
pub block_contains_keccak: bool,
// The capacity is calculated based of the values of the other Bouncer fields.
capacity: BouncerWeights,
available_capacity: BouncerWeights,
}

impl Bouncer {
pub fn new(capacity: BouncerWeights) -> Self {
pub fn new(capacity: BouncerWeights, block_contains_keccak: bool) -> Self {
Bouncer {
executed_class_hashes: HashSet::new(),
state_changes_keys: StateChangesKeys::default(),
visited_storage_entries: HashSet::new(),
capacity,
available_capacity: capacity,
block_contains_keccak,
}
}

Expand All @@ -149,25 +178,94 @@ impl Bouncer {
self.executed_class_hashes.extend(other.executed_class_hashes);
self.state_changes_keys.extend(&other.state_changes_keys);
self.visited_storage_entries.extend(other.visited_storage_entries);
self.capacity = other.capacity;
self.block_contains_keccak = other.block_contains_keccak;
self.available_capacity = other.available_capacity;
}
}

#[derive(Clone)]
pub struct TransactionalBouncer {
// The parent bouncer can be modified only through the merge method.
// The block bouncer can be modified only through the merge method.
block: Bouncer,
// The transactional bouncer can be modified only through the update method.
// The transaction bouncer can be modified only through the update method.
transaction: Bouncer,
}

impl TransactionalBouncer {
pub fn new(parent: Bouncer) -> TransactionalBouncer {
let capacity = parent.capacity;
TransactionalBouncer { block: parent, transaction: Bouncer::new(capacity) }
pub fn new(block_bouncer: Bouncer) -> TransactionalBouncer {
let transactional =
Bouncer::new(block_bouncer.available_capacity, block_bouncer.block_contains_keccak);
TransactionalBouncer { block: block_bouncer, transaction: transactional }
}

// TODO update function (in the next PRs)
pub fn update<S: StateReader>(
&mut self,
bouncer_config: &BouncerConfig,
state: &mut TransactionalState<'_, S>,
tx_execution_info: &TransactionExecutionInfo,
l1_handler_payload_size: Option<usize>,
) -> TransactionExecutorResult<()> {
self.update_used_state_entries_sets(state, tx_execution_info)?;
self.update_capacity(bouncer_config, state, tx_execution_info, l1_handler_payload_size)?;

Ok(())
}

fn update_capacity<S: StateReader>(
&mut self,
bouncer_config: &BouncerConfig,
state: &mut TransactionalState<'_, S>,
tx_execution_info: &TransactionExecutionInfo,
l1_handler_payload_size: Option<usize>,
) -> TransactionExecutorResult<()> {
let tx_weights = self.get_tx_weights(state, tx_execution_info, l1_handler_payload_size)?;

if !self.transaction.block_contains_keccak && tx_weights.builtin_count.keccak > 0 {
self.update_available_capacity_with_keccak(bouncer_config)?;
}

// Check if the transaction is too large to fit any block.
let mut max_capacity = bouncer_config.block_max_capacity;
if self.transaction.block_contains_keccak {
max_capacity = bouncer_config.block_max_capacity_with_keccak;
}
max_capacity.checked_sub(tx_weights).ok_or(TransactionExecutionError::TxTooLarge)?;

// Check if the transaction can fit the current block available capacity.
self.transaction.available_capacity = self
.transaction
.available_capacity
.checked_sub(tx_weights)
.ok_or(TransactionExecutionError::BlockFull)?;
Ok(())
}

fn update_available_capacity_with_keccak(
&mut self,
bouncer_config: &BouncerConfig,
) -> TransactionExecutorResult<()> {
// First zero the keccak capacity to be able to subtract the max_capacity_with_keccak from
// max_capacity (that is without keccak).
let mut max_capacity_with_keccak_tmp = bouncer_config.block_max_capacity_with_keccak;
max_capacity_with_keccak_tmp.builtin_count.keccak = 0;
// compute the diff between the max_capacity and the max_capacity_with_keccak.
let max_capacity_with_keccak_diff = bouncer_config
.block_max_capacity
.checked_sub(max_capacity_with_keccak_tmp)
.expect("max_capacity_with_keccak should be smaller than max_capacity");
// Subtract the diff from the available capacity.
self.transaction.available_capacity = self
.transaction
.available_capacity
.checked_sub(max_capacity_with_keccak_diff)
.ok_or(TransactionExecutionError::BlockFull)?;
// Add back the keccack capacity that was reset at the beggining.
self.transaction.available_capacity.builtin_count.keccak =
bouncer_config.block_max_capacity_with_keccak.builtin_count.keccak;
// Mark this block as contains keccak.
self.transaction.block_contains_keccak = true;
Ok(())
}

pub fn get_tx_weights<S: StateReader>(
&mut self,
Expand Down Expand Up @@ -220,8 +318,8 @@ impl TransactionalBouncer {

pub fn update_used_state_entries_sets<S: StateReader>(
&mut self,
tx_execution_info: &TransactionExecutionInfo,
state: &mut TransactionalState<'_, S>,
tx_execution_info: &TransactionExecutionInfo,
) -> TransactionExecutorResult<()> {
let tx_execution_summary = tx_execution_info.summarize();
self.transaction.executed_class_hashes.extend(tx_execution_summary.executed_class_hashes);
Expand All @@ -244,7 +342,7 @@ impl TransactionalBouncer {
}

pub fn capacity(&mut self) -> &mut BouncerWeights {
&mut self.transaction.capacity
&mut self.transaction.available_capacity
}
}

Expand Down
6 changes: 3 additions & 3 deletions crates/blockifier/src/bouncer_test.rs
Original file line number Diff line number Diff line change
Expand Up @@ -100,15 +100,15 @@ fn test_transactional_bouncer() {
state_diff_size: 2,
};

let bouncer = Bouncer::new(initial_bouncer_weights);
let bouncer = Bouncer::new(initial_bouncer_weights, true);
let mut transactional_bouncer = bouncer.create_transactional();
*transactional_bouncer.capacity() = weights_to_commit;

// Test transactional bouncer abort
let final_weights = transactional_bouncer.clone().abort();
assert!(final_weights.capacity == initial_bouncer_weights);
assert!(final_weights.available_capacity == initial_bouncer_weights);

// Test transactional bouncer commit
let final_weights = transactional_bouncer.commit();
assert!(final_weights.capacity == weights_to_commit);
assert!(final_weights.available_capacity == weights_to_commit);
}
4 changes: 4 additions & 0 deletions crates/blockifier/src/transaction/errors.rs
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,8 @@ pub enum TransactionFeeError {

#[derive(Debug, Error)]
pub enum TransactionExecutionError {
#[error("Transaction cannot be added to the current block, block capacity reached.")]
BlockFull,
#[error(
"Declare transaction version {declare_version:?} must have a contract class of Cairo \
version {cairo_version:?}."
Expand Down Expand Up @@ -88,6 +90,8 @@ pub enum TransactionExecutionError {
UnexpectedHoles { object: String, order: usize },
#[error(transparent)]
TryFromIntError(#[from] std::num::TryFromIntError),
#[error("Transaction size exceeds the maximum block capacity.")]
TxTooLarge,
#[error("Transaction validation has failed: {0}")]
ValidateTransactionError(#[source] EntryPointExecutionError),
#[error(
Expand Down

0 comments on commit 9765169

Please sign in to comment.