starktop 0.8.1

A TUI block explorer for the Starknet blockchain
Documentation
use std::collections::HashMap;

use serde::Deserialize;
use starknet::core::types::Felt;
use tracing::{debug, warn};

use crate::error::Result;

#[derive(Debug, Clone, Deserialize)]
pub struct KnownAddressEntry {
    pub name: String,
    #[serde(default)]
    pub r#type: String,
    #[serde(default)]
    pub verified: bool,
    #[serde(default)]
    pub source: String,
    #[serde(default)]
    pub decimals: Option<u8>,
}

#[derive(Debug, Default, Deserialize)]
pub struct KnownAddressesFile {
    #[serde(default)]
    pub addresses: HashMap<String, KnownAddressEntry>,
}

#[derive(Debug, Clone)]
pub struct KnownAddress {
    pub address: Felt,
    pub name: String,
    pub addr_type: String,
    pub verified: bool,
    pub source: String,
    pub decimals: Option<u8>,
}

/// Load known addresses from the bundled baseline.
pub fn load_known_addresses() -> Result<Vec<KnownAddress>> {
    let content = BUNDLED_KNOWN_ADDRESSES;

    let file: KnownAddressesFile = toml::from_str(content)?;
    let mut addresses = Vec::new();

    for (hex, entry) in &file.addresses {
        let felt = match Felt::from_hex(hex) {
            Ok(f) => f,
            Err(e) => {
                warn!(address = hex, error = %e, "Invalid address in known addresses, skipping");
                continue;
            }
        };
        addresses.push(KnownAddress {
            address: felt,
            name: entry.name.clone(),
            addr_type: entry.r#type.clone(),
            verified: entry.verified,
            source: entry.source.clone(),
            decimals: entry.decimals,
        });
    }

    debug!(count = addresses.len(), "Loaded known addresses");
    Ok(addresses)
}

/// Bundled baseline of well-known Starknet mainnet addresses.
const BUNDLED_KNOWN_ADDRESSES: &str = r#"
[addresses]
# Tokens
"0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7" = { name = "ETH", type = "ERC20", verified = true, source = "bundled", decimals = 18 }
"0x053c91253bc9682c04929ca02ed00b3e423f6710d2ee7e0d5ebb06f3ecf368a8" = { name = "USDC (bridged)", type = "ERC20", verified = true, source = "bundled", decimals = 6 }
"0x033068f6539f8e6e6b131e6b2b814e6c34a5224bc66947c47dab9dfee93b35fb" = { name = "USDC (native)", type = "ERC20", verified = true, source = "bundled", decimals = 6 }
"0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d" = { name = "STRK", type = "ERC20", verified = true, source = "bundled", decimals = 18 }
"0x068f5c6a61780768455de69077e07e89787839bf8166decfbf92b645209c0fb8" = { name = "USDT", type = "ERC20", verified = true, source = "bundled", decimals = 6 }
"0x00da114221cb83fa859dbdb4c44beeaa0bb37c7537ad5ae66fe5e0efd20e6eb3" = { name = "DAI", type = "ERC20", verified = true, source = "bundled", decimals = 18 }
"0x03fe2b97c1fd336e750087d68b9b867997fd64a2661ff3ca5a7c771641e8e7ac" = { name = "wBTC", type = "ERC20", verified = true, source = "bundled", decimals = 8 }
"0x0057912720381af14b0e5c87aa4718ed5e527eab60b3801ebf702ab09139e38b" = { name = "wstETH", type = "ERC20", verified = true, source = "bundled", decimals = 18 }
"0x075afe6402ad5a5c20dd25e10ec3b3986acaa647b77e4ae24b0cbc9a54a27a87" = { name = "EKUBO", type = "ERC20", verified = true, source = "bundled", decimals = 18 }
"0x04daa17763b286d1e59b97c283c0b8c949994c361e426a28f743c67bdfe9a32f" = { name = "tBTC", type = "ERC20", verified = true, source = "bundled", decimals = 18 }
"0x028d709c875c0ceac3dce7065bec5328186dc89fe254527084d1689910954b0a" = { name = "xSTRK", type = "ERC20", verified = true, source = "bundled", decimals = 18 }
"0x042b8f0484674ca266ac5d08e4ac6a3fe65bd3129795def2dca5c34ecc5f96d2" = { name = "nstSTRK", type = "ERC20", verified = true, source = "bundled", decimals = 18 }
"0x02019e47a0bc54ea6b4853c6123ffc8158ea3ae2af4166928b0de6e89f06de6c" = { name = "Relend Network USDC", type = "ERC20", verified = true, source = "bundled", decimals = 6 }
"0x036834a40984312f7f7de8d31e3f6305b325389eaeea5b1c0664b2fb936461a4" = { name = "LBTC", type = "ERC20", verified = true, source = "bundled", decimals = 8 }
"0x0787150e306e6eae6e3f79dea881770e8bbff2c1b8eb490f969669ee945b3135" = { name = "strkBTC", type = "ERC20", verified = true, source = "bundled", decimals = 8 }
"0x05ce53b9b68fb8e9ecab9283a96d97948914733fd6ed8d9a53a276a419497841" = { name = "ZEC", type = "ERC20", verified = true, source = "bundled", decimals = 8 }

# DEXes
"0x00000005dd3d2f4429af886cd1a3b08289dbcea99a294197e9eb43b0e0325b4b" = { name = "Ekubo Core", type = "DEX", verified = true, source = "bundled" }
"0x02e0af29598b407c8716b17f6d2795eca1b471413fa03fb145a5e33722184067" = { name = "Ekubo Positions", type = "DEX", verified = true, source = "bundled" }
"0x0199741822c2dc722f6f605204f35e56dbc23bceed54818168c4c49e4fb8737e" = { name = "Ekubo Router", type = "DEX", verified = true, source = "bundled" }
"0x041fd22b238fa21cfcf5dd45a8548974d8263b3a531a60388411c5e230f97023" = { name = "Jediswap Router", type = "DEX", verified = true, source = "bundled" }
"0x010884171baf1914edc28d7afb619b40a4051cfae78a094a55d230f19e944a28" = { name = "MySwap", type = "DEX", verified = true, source = "bundled" }
"0x01b5bd713e72fdc5d63ffd83762f81297f6175a5e0a4771cdadbc1dd5fe72cb1" = { name = "10KSwap Router", type = "DEX", verified = true, source = "bundled" }

# Aggregators
"0x04270219d365d6b017231b52e92b3fb5d7c8378b05e9abc97724537a80e93b0f" = { name = "AVNU Exchange", type = "DEX Aggregator", verified = true, source = "bundled" }
"0x06a09ccb1caaecf3d9683efe335a667b2169a409d19c589ba1eb771cd210af75" = { name = "Fibrous Finance", type = "DEX Aggregator", verified = true, source = "bundled" }

# AVNU internals
"0x06cad934ec5c48d9cdebe63e3139017fa01af101b4c5eff49f30fd6d57d3eebe" = { name = "AVNU Owner", type = "Account", verified = true, source = "bundled" }
"0x0360fb3a51bd291e5db0892b6249918a5689bc61760adcb350fe39cd725e1d22" = { name = "AVNU Fee Recipient", type = "Account", verified = true, source = "bundled" }
"0x0127021a1b5a52d3174c2ab077c2b043c80369250d29428cee956d76ee51584f" = { name = "AVNU Forwarder", type = "Paymaster", verified = true, source = "bundled" }

# Lending
"0x02545b2e5d519fc230e9cd781046d3a64e092114f07e44771e0d719d148571e3" = { name = "Vesu Singleton", type = "Lending", verified = true, source = "bundled" }
# Vesu V1 Singleton — alternate deployment, same V1 class hash
# (`0x62c6e1d…25750ee`). Padded to 64 hex chars with leading zeros for canonical form.
"0x000d8d6dfec4d33bfb6895de9f3852143a17c6f92fd2a21da3d6924d34870160" = { name = "Vesu V1 Singleton", type = "Lending", verified = true, source = "bundled" }
"0x07e2a13b40fc1119ec55e0bcf9428eedaa581ab3c924561ad4e955f95da63138" = { name = "Zklend Market", type = "Lending", verified = true, source = "bundled" }

# Staking
"0x00ca1702e64c81d9a07b86bd2c540188d92a2c73cf5cc0e508d949015e7e84a7" = { name = "Staking Contract", type = "Staking", verified = true, source = "bundled" }

# Bridges
"0x073314940630fd6dcda0d772d4c972c4e0a9946bef9dabf4ef84eda8ef542b82" = { name = "StarkGate ETH Bridge", type = "Bridge", verified = true, source = "bundled" }
"0x05cd48fccbfd8aa2773fe22c217e808319ffcc1c5a6a463f7d8fa2da48218196" = { name = "StarkGate USDC Bridge", type = "Bridge", verified = true, source = "bundled" }

# Infrastructure
"0x01176a1bd84444c89232ec27754698e5d2e7e1a7f1539f12027f28b23ec9f3d8" = { name = "Starknet Sequencer", type = "Sequencer", verified = true, source = "bundled" }
"0x041a78e741e5af2fec34b695679bc6891742439f7afb8484ecd7766661ad02bf" = { name = "UDC", type = "Infrastructure", verified = true, source = "bundled" }
"0x02ceed65a4bd731034c01113685c831b01c15d7d432f71afb1cf1634b53a2125" = { name = "UDC v2", type = "Infrastructure", verified = true, source = "bundled" }
"0x0243eed6e2b2b02a24e249f2b39ef9e5bc8bc32b252174d1c0961a458640ed8a" = { name = "Pragma Oracle", type = "Oracle", verified = true, source = "bundled" }

# Known exchanges/wallets
"0x0620102ea610be8518125cf2de850d0c4f5d0c5d81f969cff666fb53b05042d2" = { name = "Kraken Hot Wallet", type = "Exchange", verified = true, source = "bundled" }

# Privacy
"0x040337b1af3c663e86e333bab5a4b28da8d4652a15a69beee2b677776ffe812a" = { name = "Privacy Pool", type = "Privacy", verified = true, source = "bundled" }
# Privacy Pool's Ekubo swap helper (deployed instance of class
# `0x61047c2...061dc`). Called by the pool's `InvokeExternal` action when
# a user swaps private funds via Ekubo: pool withdraws to this helper,
# helper executes the Ekubo swap, helper deposits the proceeds back into
# the pool as an OpenNote. Identified via getClassHashAt against tx
# 0x90304ef5b180c520ce866161c0a14618a72af5aa841fe38a243220aa05bfa2.
"0x00389e0930f2bcf14221adefb71007ca71cec4cd4f64f321836392d2748a14c6" = { name = "Ekubo Anonymizer", type = "Privacy", verified = true, source = "bundled" }
# Privacy Pool's Vesu lending helper (class
# `0x2fec72887f6431e4a66090bec49ecf8bde30cf39a7045e4ed6ce57447704b24`,
# ABI interface `IVesuLendingHelper`). Mirrors the Ekubo helper pattern
# for Vesu deposits/redeems: wraps ETH ↔ vETH (and analogous yield
# tokens) on behalf of the pool so private positions can earn lending
# yield without revealing identity.
"0x028b49bc7a48b92d06d436d90e889729d7161dfc2fef3f16b674029bf7abc336" = { name = "Vesu Anonymizer", type = "Privacy", verified = true, source = "bundled" }
"#;