Transaction datalake (1/3)

[rkdud007]

#48

/// [`TransactionsDatalake`] is a struct that represents a transactions datalake.
///
/// It can represent a transactions datalake for a specific address as sender.
///
/// example 1: from_base_nonce is 0, to_base_nonce is 3 increment is 1
/// target nonce [0, 1, 2, 3]
/// - transaction 1 (nonce 0 -> 1)
/// - transaction 2 (nonce 1 -> 2)
/// - transaction 3 (nonce 2 -> 3)
/// - transaction 4 (nonce 3 -> 4)
///
/// example 2: from_base_nonce is 0, to_base_nonce is 3 increment is 2
/// target nonce [0, 2]
/// - transaction 1 (nonce 0 -> 1)
/// - transaction 2 (nonce 2 -> 3)
///
/// example 3: from_base_nonce is 0, to_base_nonce is 3 increment is 3
/// target nonce [0, 3]
/// - transaction 1 (nonce 0 -> 1)
/// - transaction 2 (nonce 3 -> 4)
///
/// example 4: from_base_nonce is 0, to_base_nonce is 5 increment is 2
/// target nonce [0, 2, 4]
/// - transaction 1 (nonce 0 -> 1)
/// - transaction 2 (nonce 2 -> 3)
/// - transaction 3 (nonce 4 -> 5)
#[derive(Debug, Clone, PartialEq)]
pub struct TransactionsDatalake {
    pub address: Address,
    // start of nonce range the first transaction base on
    pub from_base_nonce: u64,
    // end of nonce range the last transaction base on
    pub to_base_nonce: u64,
    // ex. "tx.to" , "tx.gas_price" or "tx_receipt.success", "tx_receipt.cumulative_gas_used"
    pub sampled_property: TransactionsCollection,
    // increment of nonce range
    pub increment: u64,
}