Comment on page
Transactions

In EVM-compatible chains, a Trasanction represents a change in the blockchain, such as ETH transfers or smart contract executions. In Substreams, transactions are abstracted by the TransactionTrace Protobuf model. Some of the most relevant fields and methods of the model are:
hash (property): hash of the transaction.
from (property): from field of the transaction.
to (property): to field of the transaction.
input: (property): input field of the transaction.
receipt: (property): TransactionReceipt struct representing the receipt of the transaction.
status() (method): TransactionTraceStatus enum struct representing the status of the transaction, with the following possible values: TransactionTraceStatus::Succeeded, TransactionTraceStatus::Failed, TransactionTraceStatus::Reverted, TransactionTraceStatus::Unknown.
EVM-compatible Protobuf Structure - TransactionTrace
Iterating over ALL Transactions
The block.transaction_traces property contains all transactions, regardless of their status.
use substreams::Hex;
use substreams_ethereum::pb::eth::v2::Block;
​
struct TransactionMeta {
    hash: String,
    from: String,
    to: String
}
​
fn all_transactions(blk: Block) -> Vec<TransactionMeta> {
    return blk.transaction_traces
            .iter()
            .map(|tx| TransactionMeta {
                hash: Hex::encode(tx.hash),
                from: Hex::encode(tx.from),
                to: Hex::encode(tx.to)
            })
            .collect();
}
Iterating over SUCCESSFUL Transactions
The transactions() method contains successful transactions.
use substreams::Hex;
use substreams_ethereum::pb::eth::v2::Block;
​
struct TransactionMeta {
    hash: String,
    from: String,
    to: String
}
​
fn successful_transactions(blk: Block) -> Vec<TransactionMeta> {
    return blk.transactions()
        .map(|tx| TransactionMeta {
            hash: Hex::encode(tx.hash),
            from: Hex::encode(tx.from),
            to: Hex::encode(tx.to)
        })
        .collect();
}
You can also iterate over all transactions and filter by their status (TransactionTraceStatus::Succeeded), .
use substreams::Hex;
use substreams_ethereum::pb::eth::v2::{Block, TransactionTraceStatus};
​
struct TransactionMeta {
    hash: String,
    from: String,
    to: String
}
​
fn successful_transactions(blk: Block) -> Vec<TransactionMeta> {
    return blk.transaction_traces.iter()
        .filter(|tx| tx.status() == TransactionTraceStatus::Succeeded)
        .map(|tx| TransactionMeta {
            hash: Hex::encode(tx.hash),
            from: Hex::encode(tx.from),
            to: Hex::encode(tx.to)
        })
        .collect();
}
Iterating over FAILED Transactions
Iterate over all transactions and filter by their status (TransactionTraceStatus::Failed), .
use substreams::Hex;
use substreams_ethereum::pb::eth::v2::{Block, TransactionTraceStatus};
​
struct TransactionMeta {
    hash: String,
    from: String,
    to: String
}
​
fn failed_transactions(blk: Block) -> Vec<TransactionMeta> {
    return blk.transaction_traces.iter()
        .filter(|tx| tx.status() == TransactionTraceStatus::Failed)
        .map(|tx| TransactionMeta {
            hash: Hex::encode(tx.hash),
            from: Hex::encode(tx.from),
            to: Hex::encode(tx.to)
        })
        .collect();
}
Iterating over REVERTED Transactions
Iterate over all transactions and filter by their status (TransactionTraceStatus::Reverted), .
use substreams::Hex;
use substreams_ethereum::pb::eth::v2::{Block, TransactionTraceStatus};
​
struct TransactionMeta {
    hash: String,
    from: String,
    to: String
}
​
fn failed_transactions(blk: Block) -> Vec<TransactionMeta> {
    return blk.transaction_traces.iter()
        .filter(|tx| tx.status() == TransactionTraceStatus::Reverted)
        .map(|tx| TransactionMeta {
            hash: Hex::encode(tx.hash),
            from: Hex::encode(tx.from),
            to: Hex::encode(tx.to)
        })
        .collect();
}
Blocks
Logs
Last modified 2mo ago