solana-runtime 1.14.8

use {
    log::*,
    solana_sdk::{
        account::{AccountSharedData, ReadableAccount},
        pubkey::Pubkey,
        rent::Rent,
        transaction::{Result, TransactionError},
        transaction_context::TransactionContext,
    },
};

#[derive(Debug, PartialEq, Eq)]
pub(crate) enum RentState {
    /// account.lamports == 0
    Uninitialized,
    /// 0 < account.lamports < rent-exempt-minimum
    RentPaying {
        lamports: u64,    // account.lamports()
        data_size: usize, // account.data().len()
    },
    /// account.lamports >= rent-exempt-minimum
    RentExempt,
}

impl RentState {
    pub(crate) fn from_account(account: &AccountSharedData, rent: &Rent) -> Self {
        if account.lamports() == 0 {
            Self::Uninitialized
        } else if rent.is_exempt(account.lamports(), account.data().len()) {
            Self::RentExempt
        } else {
            Self::RentPaying {
                data_size: account.data().len(),
                lamports: account.lamports(),
            }
        }
    }

    pub(crate) fn transition_allowed_from(
        &self,
        pre_rent_state: &RentState,
        prevent_crediting_accounts_that_end_rent_paying: bool,
    ) -> bool {
        match self {
            Self::Uninitialized | Self::RentExempt => true,
            Self::RentPaying {
                data_size: post_data_size,
                lamports: post_lamports,
            } => {
                match pre_rent_state {
                    Self::Uninitialized | Self::RentExempt => false,
                    Self::RentPaying {
                        data_size: pre_data_size,
                        lamports: pre_lamports,
                    } => {
                        // Cannot remain RentPaying if resized
                        if post_data_size != pre_data_size {
                            false
                        } else if prevent_crediting_accounts_that_end_rent_paying {
                            // Cannot remain RentPaying if credited
                            post_lamports <= pre_lamports
                        } else {
                            true
                        }
                    }
                }
            }
        }
    }
}

pub(crate) fn submit_rent_state_metrics(pre_rent_state: &RentState, post_rent_state: &RentState) {
    match (pre_rent_state, post_rent_state) {
        (&RentState::Uninitialized, &RentState::RentPaying { .. }) => {
            inc_new_counter_info!("rent_paying_err-new_account", 1);
        }
        (&RentState::RentPaying { .. }, &RentState::RentPaying { .. }) => {
            inc_new_counter_info!("rent_paying_ok-legacy", 1);
        }
        (_, &RentState::RentPaying { .. }) => {
            inc_new_counter_info!("rent_paying_err-other", 1);
        }
        _ => {}
    }
}

pub(crate) fn check_rent_state(
    pre_rent_state: Option<&RentState>,
    post_rent_state: Option<&RentState>,
    transaction_context: &TransactionContext,
    index: usize,
    include_account_index_in_err: bool,
    prevent_crediting_accounts_that_end_rent_paying: bool,
) -> Result<()> {
    if let Some((pre_rent_state, post_rent_state)) = pre_rent_state.zip(post_rent_state) {
        let expect_msg = "account must exist at TransactionContext index if rent-states are Some";
        check_rent_state_with_account(
            pre_rent_state,
            post_rent_state,
            transaction_context
                .get_key_of_account_at_index(index)
                .expect(expect_msg),
            &transaction_context
                .get_account_at_index(index)
                .expect(expect_msg)
                .borrow(),
            include_account_index_in_err.then(|| index),
            prevent_crediting_accounts_that_end_rent_paying,
        )?;
    }
    Ok(())
}

pub(crate) fn check_rent_state_with_account(
    pre_rent_state: &RentState,
    post_rent_state: &RentState,
    address: &Pubkey,
    account_state: &AccountSharedData,
    account_index: Option<usize>,
    prevent_crediting_accounts_that_end_rent_paying: bool,
) -> Result<()> {
    submit_rent_state_metrics(pre_rent_state, post_rent_state);
    if !solana_sdk::incinerator::check_id(address)
        && !post_rent_state.transition_allowed_from(
            pre_rent_state,
            prevent_crediting_accounts_that_end_rent_paying,
        )
    {
        debug!(
            "Account {} not rent exempt, state {:?}",
            address, account_state,
        );
        if let Some(account_index) = account_index {
            let account_index = account_index as u8;
            Err(TransactionError::InsufficientFundsForRent { account_index })
        } else {
            Err(TransactionError::InvalidRentPayingAccount)
        }
    } else {
        Ok(())
    }
}

#[cfg(test)]
mod tests {
    use {super::*, solana_sdk::pubkey::Pubkey};

    #[test]
    fn test_from_account() {
        let program_id = Pubkey::new_unique();
        let uninitialized_account = AccountSharedData::new(0, 0, &Pubkey::default());

        let account_data_size = 100;

        let rent = Rent::free();
        let rent_exempt_account = AccountSharedData::new(1, account_data_size, &program_id); // if rent is free, all accounts with non-zero lamports and non-empty data are rent-exempt

        assert_eq!(
            RentState::from_account(&uninitialized_account, &rent),
            RentState::Uninitialized
        );
        assert_eq!(
            RentState::from_account(&rent_exempt_account, &rent),
            RentState::RentExempt
        );

        let rent = Rent::default();
        let rent_minimum_balance = rent.minimum_balance(account_data_size);
        let rent_paying_account = AccountSharedData::new(
            rent_minimum_balance.saturating_sub(1),
            account_data_size,
            &program_id,
        );
        let rent_exempt_account = AccountSharedData::new(
            rent.minimum_balance(account_data_size),
            account_data_size,
            &program_id,
        );

        assert_eq!(
            RentState::from_account(&uninitialized_account, &rent),
            RentState::Uninitialized
        );
        assert_eq!(
            RentState::from_account(&rent_paying_account, &rent),
            RentState::RentPaying {
                data_size: account_data_size,
                lamports: rent_paying_account.lamports(),
            }
        );
        assert_eq!(
            RentState::from_account(&rent_exempt_account, &rent),
            RentState::RentExempt
        );
    }

    #[test]
    fn test_transition_allowed_from() {
        check_transition_allowed_from(
            /*prevent_crediting_accounts_that_end_rent_paying:*/ false,
        );
        check_transition_allowed_from(
            /*prevent_crediting_accounts_that_end_rent_paying:*/ true,
        );
    }

    fn check_transition_allowed_from(prevent_crediting_accounts_that_end_rent_paying: bool) {
        let post_rent_state = RentState::Uninitialized;
        assert!(post_rent_state.transition_allowed_from(
            &RentState::Uninitialized,
            prevent_crediting_accounts_that_end_rent_paying
        ));
        assert!(post_rent_state.transition_allowed_from(
            &RentState::RentExempt,
            prevent_crediting_accounts_that_end_rent_paying
        ));
        assert!(post_rent_state.transition_allowed_from(
            &RentState::RentPaying {
                data_size: 0,
                lamports: 1,
            },
            prevent_crediting_accounts_that_end_rent_paying
        ));

        let post_rent_state = RentState::RentExempt;
        assert!(post_rent_state.transition_allowed_from(
            &RentState::Uninitialized,
            prevent_crediting_accounts_that_end_rent_paying
        ));
        assert!(post_rent_state.transition_allowed_from(
            &RentState::RentExempt,
            prevent_crediting_accounts_that_end_rent_paying
        ));
        assert!(post_rent_state.transition_allowed_from(
            &RentState::RentPaying {
                data_size: 0,
                lamports: 1,
            },
            prevent_crediting_accounts_that_end_rent_paying
        ));
        let post_rent_state = RentState::RentPaying {
            data_size: 2,
            lamports: 5,
        };
        assert!(!post_rent_state.transition_allowed_from(
            &RentState::Uninitialized,
            prevent_crediting_accounts_that_end_rent_paying
        ));
        assert!(!post_rent_state.transition_allowed_from(
            &RentState::RentExempt,
            prevent_crediting_accounts_that_end_rent_paying
        ));
        assert!(!post_rent_state.transition_allowed_from(
            &RentState::RentPaying {
                data_size: 3,
                lamports: 5
            },
            prevent_crediting_accounts_that_end_rent_paying
        ));
        assert!(!post_rent_state.transition_allowed_from(
            &RentState::RentPaying {
                data_size: 1,
                lamports: 5
            },
            prevent_crediting_accounts_that_end_rent_paying
        ));
        // Transition is always allowed if there is no account data resize or
        // change in account's lamports.
        assert!(post_rent_state.transition_allowed_from(
            &RentState::RentPaying {
                data_size: 2,
                lamports: 5
            },
            prevent_crediting_accounts_that_end_rent_paying
        ));
        // Transition is always allowed if there is no account data resize and
        // account's lamports is reduced.
        assert!(post_rent_state.transition_allowed_from(
            &RentState::RentPaying {
                data_size: 2,
                lamports: 7
            },
            prevent_crediting_accounts_that_end_rent_paying
        ));
        // Once the feature is activated, transition is not allowed if the
        // account is credited with more lamports and remains rent-paying.
        assert_eq!(
            post_rent_state.transition_allowed_from(
                &RentState::RentPaying {
                    data_size: 2,
                    lamports: 3
                },
                prevent_crediting_accounts_that_end_rent_paying
            ),
            !prevent_crediting_accounts_that_end_rent_paying
        );
    }
}