signet-cold 0.7.2

Append-only cold storage for historical blockchain data
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

//! Unified receipt type for cold storage queries.

use alloy::{
    consensus::{Receipt as ConsensusReceipt, TxType},
    primitives::{Address, B256, BlockNumber},
};
use signet_storage_types::{IndexedReceipt, SealedHeader};

use crate::RpcLog;

/// A receipt with enriched RPC log metadata and block context.
///
/// This is the unified return type for all cold storage receipt queries.
/// It contains the consensus receipt with RPC-enriched logs (each log
/// carries block and transaction metadata), plus per-transaction fields
/// needed for RPC response assembly.
#[derive(Debug, Clone)]
pub struct ColdReceipt {
    /// The consensus receipt with RPC-enriched logs.
    pub receipt: ConsensusReceipt<RpcLog>,
    /// Transaction type (legacy, EIP-2930, EIP-1559, EIP-4844).
    pub tx_type: TxType,
    /// Hash of the transaction that produced this receipt.
    pub tx_hash: B256,
    /// Gas used by this transaction alone.
    pub gas_used: u64,
    /// Block number containing this receipt.
    pub block_number: BlockNumber,
    /// Hash of the block containing this receipt.
    pub block_hash: B256,
    /// Block timestamp.
    pub block_timestamp: u64,
    /// Index of this transaction within the block.
    pub transaction_index: u64,
    /// Address of the transaction sender.
    pub from: Address,
}

impl ColdReceipt {
    /// Build a [`ColdReceipt`] from an [`IndexedReceipt`], its containing
    /// [`SealedHeader`], and the transaction index within the block.
    ///
    /// Converts each consensus log into an [`RpcLog`] with full block and
    /// transaction metadata attached.
    pub fn new(ir: IndexedReceipt, header: &SealedHeader, transaction_index: u64) -> Self {
        let block_number = header.number;
        let block_hash = header.hash();
        let block_timestamp = header.timestamp;

        // Destructure to move fields instead of cloning logs.
        let IndexedReceipt { receipt: typed_receipt, tx_hash, first_log_index, gas_used, sender } =
            ir;
        let tx_type = typed_receipt.tx_type;
        let status = typed_receipt.inner.status;
        let cumulative_gas_used = typed_receipt.inner.cumulative_gas_used;

        let rpc_logs: Vec<RpcLog> = typed_receipt
            .inner
            .logs
            .into_iter()
            .enumerate()
            .map(|(log_idx, log)| RpcLog {
                inner: log,
                block_hash: Some(block_hash),
                block_number: Some(block_number),
                block_timestamp: Some(block_timestamp),
                transaction_hash: Some(tx_hash),
                transaction_index: Some(transaction_index),
                log_index: Some(first_log_index + log_idx as u64),
                removed: false,
            })
            .collect();

        let receipt = ConsensusReceipt { status, cumulative_gas_used, logs: rpc_logs };

        Self {
            receipt,
            tx_type,
            tx_hash,
            gas_used,
            block_number,
            block_hash,
            block_timestamp,
            transaction_index,
            from: sender,
        }
    }
}