semioscan 0.15.1

Production-grade Rust library for blockchain analytics: gas calculation, price extraction, and block window calculations for EVM chains
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

// SPDX-FileCopyrightText: 2025 Semiotic AI, Inc.
//
// SPDX-License-Identifier: Apache-2.0

//! Core gas calculation logic

use alloy_eips::Typed2718;
use alloy_primitives::{Address, U256};
use alloy_rpc_types::{Filter, TransactionTrait};
use alloy_sol_types::SolEvent;

use crate::events::definitions::Transfer;
use crate::gas::transaction;

/// Core gas calculation logic
pub struct GasCalculationCore;

impl GasCalculationCore {
    pub(crate) fn calculate_blob_gas_cost<T>(transaction: &T) -> U256
    where
        T: TransactionTrait + Typed2718,
    {
        transaction::blob_gas_cost(transaction)
    }

    pub(crate) fn gas_price_override<T>(transaction: &T) -> Option<U256>
    where
        T: TransactionTrait + Typed2718,
    {
        transaction::gas_price_override(transaction)
    }

    /// Build a Transfer-event filter template (no block range).
    ///
    /// [`crate::scan::LogScanner`] stamps each chunk's `from_block`/`to_block`
    /// onto a clone of this template, so the block range is intentionally
    /// omitted here.
    pub(crate) fn create_transfer_filter(
        token_address: Address,
        from_address: Address, // topic1
        to_address: Address,   // topic2
    ) -> Filter {
        let transfer_topic_hash = Transfer::SIGNATURE_HASH;
        Filter::new()
            .address(token_address)
            .event_signature(transfer_topic_hash)
            .topic1(from_address)
            .topic2(to_address)
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use alloy_primitives::{address, Address};

    #[test]
    fn create_transfer_filter_does_not_set_block_range() {
        let token = address!("A0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48");
        let from = address!("1111111111111111111111111111111111111111");
        let to = address!("2222222222222222222222222222222222222222");

        let filter = GasCalculationCore::create_transfer_filter(token, from, to);

        // The template intentionally omits block range; LogScanner stamps each
        // chunk's range onto a clone.
        assert_eq!(filter.get_from_block(), None);
        assert_eq!(filter.get_to_block(), None);
    }

    #[test]
    fn create_transfer_filter_sets_correct_addresses() {
        let token = address!("A0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48");
        let from = address!("1111111111111111111111111111111111111111");
        let to = address!("2222222222222222222222222222222222222222");

        let filter = GasCalculationCore::create_transfer_filter(token, from, to);

        let _ = filter;
    }

    #[test]
    fn create_transfer_filter_includes_transfer_event_signature() {
        let token = address!("A0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48");
        let from = Address::ZERO;
        let to = Address::ZERO;

        let filter = GasCalculationCore::create_transfer_filter(token, from, to);

        let _ = filter;
    }
}