scope-bca 0.7.0

Scope Blockchain Analysis - A production-grade tool for blockchain data analysis, address management, and transaction investigation
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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

//! Venue listing API handler.
//!
//! GET /api/venues — Returns every market venue (`MarketVenue::listings`):
//! registry venues with their capabilities, then DEX venues (`kind: "dex"`).

use axum::Json;
use axum::response::IntoResponse;
use scope::market::{MarketVenue, VenueRegistry};

use super::{error_response, status_for};

/// GET /api/venues — List available exchange venues.
pub async fn handle() -> impl IntoResponse {
    let registry = match VenueRegistry::load() {
        Ok(r) => r,
        Err(e) => {
            return error_response(
                status_for(&e),
                format!("Failed to load venue registry: {e}"),
            );
        }
    };

    // One list: registry venues, then DEX venues, each with its `kind`.
    let venues = MarketVenue::listings(&registry);
    let output = serde_json::json!({
        "total": venues.len(),
        "venues": venues,
        "user_venues_dir": VenueRegistry::user_venues_dir().display().to_string(),
    });

    Json(output).into_response()
}

#[cfg(test)]
mod tests {
    use super::*;
    use axum::response::IntoResponse;

    #[tokio::test]
    async fn test_handle_venues() {
        let response = handle().await.into_response();
        let status = response.status();
        assert!(status.is_success());
    }

    #[tokio::test]
    async fn test_handle_venues_returns_all_built_in() {
        let response = handle().await.into_response();
        let status = response.status();
        assert!(status.is_success());

        // Extract body and verify structure
        let body = axum::body::to_bytes(response.into_body(), 1024 * 1024)
            .await
            .unwrap();
        let json: serde_json::Value = serde_json::from_slice(&body).unwrap();
        assert!(json["total"].as_u64().unwrap() >= 11);
        assert!(json["venues"].is_array());
        let venues = json["venues"].as_array().unwrap();
        assert!(venues.iter().any(|v| v["id"] == "binance"));
        assert!(venues.iter().any(|v| v["id"] == "kraken"));
        // Verify each venue has expected fields
        for venue in venues {
            assert!(venue["id"].is_string());
            assert!(venue["name"].is_string());
            // Only a registry (CEX) venue has an API base URL.
            assert_eq!(venue["base_url"].is_string(), venue["kind"] == "cex");
            assert!(venue["capabilities"].is_array());
        }
    }

    #[tokio::test]
    async fn test_handle_venues_response_structure() {
        let response = handle().await.into_response();
        assert!(response.status().is_success());
        let body = axum::body::to_bytes(response.into_body(), 1024 * 1024)
            .await
            .unwrap();
        let json: serde_json::Value = serde_json::from_slice(&body).unwrap();
        assert!(json["total"].as_u64().unwrap() >= 11);
        let venues = json["venues"].as_array().unwrap();
        for v in venues {
            assert!(v["id"].is_string());
            assert!(v["name"].is_string());
            assert!(v["capabilities"].is_array());
        }
        assert!(json["user_venues_dir"].is_string());
    }

    /// The UI reads DEX venues from here instead of hard-coding them.
    #[tokio::test]
    async fn test_handle_venues_lists_dex_venues() {
        let response = handle().await.into_response();
        let body = axum::body::to_bytes(response.into_body(), 1024 * 1024)
            .await
            .unwrap();
        let json: serde_json::Value = serde_json::from_slice(&body).unwrap();
        let dex: Vec<&serde_json::Value> = json["venues"]
            .as_array()
            .unwrap()
            .iter()
            .filter(|v| v["kind"] == "dex")
            .collect();
        let ids: Vec<&str> = dex.iter().map(|v| v["id"].as_str().unwrap()).collect();
        assert_eq!(ids, ["ethereum", "solana"]);
        assert_eq!(dex[1]["name"], "Solana DEX");
        assert_eq!(dex[1]["chain"], "solana");
    }
}