API: TVL in native and USD

Cargo.toml

@@ -1,6 +1,7 @@
 [workspace]
 members = [
     "account_traits_derive",
+    "api",
     "bytemuck",
     "cli",
     "clients/rust/restaking_client",
@@ -41,6 +42,7 @@ readme = "README.md"
 anchor-lang = { version = "0.30.1", features = ["idl-build"] }
 anyhow = "1.0.86"
 assert_matches = "1.5.0"
+axum = "0.6.2"
 borsh = { version = "0.10.3" }
 bytemuck = { version = "1.16.3", features = ["min_const_generics"] }
 cfg-if = "1.0.0"
@@ -52,6 +54,7 @@ dotenv = "0.15.0"
 envfile = "0.2.1"
 env_logger = "0.10.2"
 futures = "0.3.31"
+http = "0.2.1" 
 jito-bytemuck = { path = "bytemuck", version = "=0.0.3" }
 jito-account-traits-derive = { path = "account_traits_derive", version = "=0.0.3" }
 jito-jsm-core = { path = "core", version = "=0.0.3" }
@@ -69,7 +72,9 @@ num-derive = "0.4.2"
 num-traits = "0.2.19"
 proc-macro2 = "1.0.86"
 quote = "1.0.36"
+reqwest = "0.11.27"
 serde = { version = "^1.0", features = ["derive"] }
+serde_json = "1.0.102"
 serde_with = "3.9.0"
 shank = "0.4.2"
 shank_idl = "0.4.2"
@@ -89,3 +94,8 @@ syn = "2.0.72"
 test-case = "3.3.1"
 thiserror = "1.0.57"
 tokio = { version = "1.36.0", features = ["full"] }
+tower = { version = "0.4.13", features = ["limit", "buffer", "timeout", "load-shed"] }
+tower-http = { version = "0.4.0", features = ["trace"] }
+tracing = { version = "0.1.37" }
+tracing-core = "0.1.32"
+tracing-subscriber = { version = "0.3.17", features = ["env-filter"] }

api/Cargo.toml

@@ -0,0 +1,37 @@
+[package]
+name = "jito-restaking-api"
+description = "Jito Restaking API"
+version = { workspace = true }
+authors = { workspace = true }
+repository = { workspace = true }
+homepage = { workspace = true }
+license = { workspace = true }
+edition = { workspace = true }
+readme = { workspace = true }
+
+[[bin]]
+name = "jito-restaking-api"
+path = "src/bin/main.rs"
+
+[dependencies]
+anchor-lang = { workspace = true }
+axum = { workspace = true }
+clap = { workspace = true }
+http = { workspace = true }
+jito-bytemuck = { workspace = true }
+jito-vault-client = { workspace = true, features = ["serde"] }
+jito-vault-core = { workspace = true }
+reqwest = { workspace = true }
+serde = { workspace = true }
+serde_json = { workspace = true }
+solana-account-decoder = { workspace = true }
+solana-program = { workspace = true }
+solana-rpc-client = { workspace = true }
+solana-rpc-client-api = { workspace = true }
+thiserror = { workspace = true }
+tokio = { workspace = true }
+tower = { workspace = true }
+tower-http = { workspace = true }
+tracing = { workspace = true }
+tracing-core = { workspace = true }
+tracing-subscriber = { workspace = true }

api/README.md

@@ -0,0 +1,175 @@
+# Jito Restaking API
+
+# StakeNet API
+
+## Overview
+
+This API allows users to:
+
+- Retrieve TVL for each vault in native and USD vaules.
+- List all vaults with their details.
+
+## Endpoints
+
+1. Get TVL for All Vaults
+
+Fetches TVL for each vault in **native unit** and USD.
+
+Endpoint:
+
+```http
+GET api/v1/vaults/tvl
+```
+
+Response:
+
+```json
+[
+    {
+        "vault_pubkey":"CugziSqZXcUStNPXbtRmq6atsrHqWY2fH2tAhsyApQrV",
+        "supported_mint":"J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn",
+        "native_unit_tvl":291871.554825083,
+        "native_unit_symbol":"JITOSOL",
+        "usd_tvl":82042175.34578258
+    },
+    {
+        "vault_pubkey":"CQpvXgoaaawDCLh8FwMZEwQqnPakRUZ5BnzhjnEBPJv",
+        "supported_mint":"J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn",
+        "native_unit_tvl":134310.541925135,
+        "native_unit_symbol":"JITOSOL",
+        "usd_tvl":37753350.229736194
+    },
+]
+```
+
+2. Get TVL for a Specific Vault
+
+Fetches TVL for a single vault.
+
+Endpoint:
+
+```http
+GET api/v1/vaults/{vault_pubkey}/tvl/
+```
+
+Response:
+
+```json
+{
+    "vault_pubkey":"CugziSqZXcUStNPXbtRmq6atsrHqWY2fH2tAhsyApQrV",
+    "supported_mint":"J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn",
+    "native_unit_tvl":291871.554825083,
+    "native_unit_symbol":"JITOSOL",
+    "usd_tvl":82042175.34578258
+}
+```
+
+3. List All Vaults
+
+Retrieves all vaults with details.
+
+Endpoint:
+
+```http
+GET api/v1/vaults
+```
+
+Response:
+
+```json
+[
+    {
+        "discriminator":2,
+        "base":"AbH5RtAgpnxyRuT9LqXR9ye4JuuJoHs6E5ENPvCnSRDk",
+        "vrt_mint":"CtJcH6BeUPKEfBNaUoPjmEc88E4aLuEJZU4NkuSdnpZo",
+        "supported_mint":"J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn",
+        "vrt_supply":9306868868,
+        "tokens_deposited":9306868868,
+        "deposit_capacity":680411000000000,
+        "delegation_state":
+            {
+                "staked_amount":0,
+                "enqueued_for_cooldown_amount":0,
+                "cooling_down_amount":0,
+                ...
+            }
+        ...
+    }
+...
+]
+```
+
+4. Get Vault Details
+
+Retrieves details of a specific vault.
+
+Endpoint:
+
+```http
+GET api/v1/vaults/{vault_pubkey}
+```
+
+Response:
+
+```json
+{
+    "discriminator":2,
+    "base":"AbH5RtAgpnxyRuT9LqXR9ye4JuuJoHs6E5ENPvCnSRDk",
+    "vrt_mint":"CtJcH6BeUPKEfBNaUoPjmEc88E4aLuEJZU4NkuSdnpZo",
+    "supported_mint":"J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn",
+    "vrt_supply":9306868868,
+    "tokens_deposited":9306868868,
+    "deposit_capacity":680411000000000,
+    "delegation_state":
+        {
+            "staked_amount":0,
+            "enqueued_for_cooldown_amount":0,
+            "cooling_down_amount":0,
+            ...
+        }
+    ...
+}
+```
+
+
+## Build
+
+### Prerequisites
+
+- [Solana's RPC Client](https://docs.rs/solana-rpc-client/latest/solana_rpc_client/)
+- [Axum](https://docs.rs/axum/latest/axum/)
+
+### Build for release
+
+To build the API for release, run the following command:
+
+```bash
+cargo b --release --bin jito-restaking-api
+```
+
+### Check available options
+
+To view the options available for configuring the API:
+
+```bash
+./target/release/jito-restaking-api --help
+
+# Jito Restaking API
+# 
+# Usage: jito-restaking-api [OPTIONS]
+# 
+# Options:
+#       --bind-addr <BIND_ADDR>  Bind address for the server [env: BIND_ADDR=] [default: 0.0.0.0:7001]
+#       --rpc-url <RPC_URL>      RPC url [env: RPC_URL=] [default: https://api.mainnet-beta.solana.com]
+#   -h, --help                   Print help
+#   -V, --version                Print version
+```
+
+### Running the API
+
+Once built, run the API using the following command:
+
+```bash
+./target/release/jito-restaking-api -- --rpc-url "your-rpc-url"
+```
+

api/src/bin/main.rs

@@ -0,0 +1,42 @@
+use std::{net::SocketAddr, str::FromStr, sync::Arc};
+
+use clap::Parser;
+use solana_rpc_client::nonblocking::rpc_client::RpcClient;
+use tracing::{info, instrument};
+
+#[derive(Parser, Debug)]
+#[clap(author, version, about, long_about = None)]
+pub struct Args {
+    /// Bind address for the server
+    #[arg(long, env, default_value_t = SocketAddr::from_str("0.0.0.0:7001").unwrap())]
+    pub bind_addr: SocketAddr,
+
+    /// RPC url
+    #[arg(long, env, default_value = "https://api.mainnet-beta.solana.com")]
+    pub rpc_url: String,
+}
+
+#[tokio::main]
+#[instrument]
+async fn main() -> Result<(), Box<dyn std::error::Error>> {
+    let args = Args::parse();
+
+    tracing_subscriber::fmt().init();
+
+    info!("args: {:?}", args);
+
+    info!("starting server at {}", args.bind_addr);
+
+    let rpc_client = RpcClient::new(args.rpc_url.clone());
+    info!("started rpc client at {}", args.rpc_url);
+
+    let state = Arc::new(jito_restaking_api::router::RouterState { rpc_client });
+
+    let app = jito_restaking_api::router::get_routes(state);
+
+    axum::Server::bind(&args.bind_addr)
+        .serve(app.into_make_service_with_connect_info::<SocketAddr>())
+        .await?;
+
+    Ok(())
+}