Files
sol-trade-sdk/src/swqos/lunarlander.rs
T
Joe Abbey 70d1da0b13 feat(swqos): add Lunar Lander (HelloMoon) provider with binary HTTP and QUIC support
- HTTP binary mode: POST /send-bin with bincode body, x-api-key header, keepalive ping
- QUIC mode: port 16888 via lunar-lander-quic-client crate, fire-and-forget uni streams
- Dual transport: SwqosConfig::LunarLander(key, region, url, transport) like Astralane
- 10 moon-prefix tip accounts, 0.001 SOL minimum tip
- Regional endpoints: NYC, Frankfurt, Amsterdam, Ashburn, Tokyo
2026-03-30 13:43:26 -04:00

291 lines
10 KiB
Rust

use crate::swqos::common::{default_http_client_builder, poll_transaction_confirmation};
use rand::seq::IndexedRandom;
use reqwest::Client;
use std::{sync::Arc, time::Instant};
use crate::swqos::SwqosClientTrait;
use crate::swqos::{SwqosType, TradeType};
use anyhow::Result;
use bincode::serialize as bincode_serialize;
use solana_sdk::transaction::VersionedTransaction;
use std::time::Duration;
use crate::{common::SolanaRpcClient, constants::swqos::LUNARLANDER_TIP_ACCOUNTS};
use std::sync::atomic::{AtomicBool, Ordering};
use tokio::task::JoinHandle;
use lunar_lander_quic_client::LunarLanderQuicClient;
use tokio::sync::Mutex;
#[derive(Clone)]
pub enum LunarLanderBackend {
Http {
endpoint: String,
auth_token: String,
http_client: Client,
ping_handle: Arc<tokio::sync::Mutex<Option<JoinHandle<()>>>>,
stop_ping: Arc<AtomicBool>,
},
Quic(Arc<Mutex<LunarLanderQuicClient>>),
}
#[derive(Clone)]
pub struct LunarLanderClient {
pub rpc_client: Arc<SolanaRpcClient>,
backend: LunarLanderBackend,
}
#[async_trait::async_trait]
impl SwqosClientTrait for LunarLanderClient {
async fn send_transaction(
&self,
trade_type: TradeType,
transaction: &VersionedTransaction,
wait_confirmation: bool,
) -> Result<()> {
self.send_transaction_impl(trade_type, transaction, wait_confirmation).await
}
async fn send_transactions(
&self,
trade_type: TradeType,
transactions: &Vec<VersionedTransaction>,
wait_confirmation: bool,
) -> Result<()> {
for transaction in transactions {
self.send_transaction_impl(trade_type, transaction, wait_confirmation).await?;
}
Ok(())
}
fn get_tip_account(&self) -> Result<String> {
let tip_account = *LUNARLANDER_TIP_ACCOUNTS
.choose(&mut rand::rng())
.or_else(|| LUNARLANDER_TIP_ACCOUNTS.first())
.unwrap();
Ok(tip_account.to_string())
}
fn get_swqos_type(&self) -> SwqosType {
SwqosType::LunarLander
}
}
impl LunarLanderClient {
/// Create an HTTP binary client (POST /send-bin with bincode body).
pub fn new(rpc_url: String, endpoint: String, auth_token: String) -> Self {
let rpc_client = SolanaRpcClient::new(rpc_url);
let http_client = default_http_client_builder().build().unwrap();
let ping_handle = Arc::new(tokio::sync::Mutex::new(None));
let stop_ping = Arc::new(AtomicBool::new(false));
let client = Self {
rpc_client: Arc::new(rpc_client),
backend: LunarLanderBackend::Http {
endpoint,
auth_token,
http_client,
ping_handle,
stop_ping,
},
};
let client_clone = client.clone();
tokio::spawn(async move {
client_clone.start_ping_task().await;
});
client
}
/// Create a QUIC client (port 16888, cert CN = api_key, fire-and-forget unidirectional streams).
pub async fn new_quic(rpc_url: String, quic_endpoint: &str, api_key: String) -> Result<Self> {
let rpc_client = SolanaRpcClient::new(rpc_url);
let quic_client = LunarLanderQuicClient::connect(quic_endpoint, &api_key).await?;
Ok(Self {
rpc_client: Arc::new(rpc_client),
backend: LunarLanderBackend::Quic(Arc::new(Mutex::new(quic_client))),
})
}
async fn start_ping_task(&self) {
match &self.backend {
LunarLanderBackend::Http {
endpoint,
auth_token,
http_client,
ping_handle,
stop_ping,
} => {
let endpoint = endpoint.clone();
let auth_token = auth_token.clone();
let http_client = http_client.clone();
let ping_handle = ping_handle.clone();
let stop_ping = stop_ping.clone();
let handle = tokio::spawn(async move {
// Immediate first ping to warm connection
let _ = Self::send_ping_request(&http_client, &endpoint, &auth_token).await;
let mut interval = tokio::time::interval(Duration::from_secs(30));
loop {
interval.tick().await;
if stop_ping.load(Ordering::Relaxed) {
break;
}
if let Err(e) =
Self::send_ping_request(&http_client, &endpoint, &auth_token).await
{
if crate::common::sdk_log::sdk_log_enabled() {
eprintln!("LunarLander ping request failed: {}", e);
}
}
}
});
let mut guard = ping_handle.lock().await;
if let Some(old) = guard.as_ref() {
old.abort();
}
*guard = Some(handle);
}
LunarLanderBackend::Quic(_) => {}
}
}
/// GET {endpoint}/ping for HTTP keepalive.
async fn send_ping_request(
http_client: &Client,
endpoint: &str,
auth_token: &str,
) -> Result<()> {
let url = format!("{}/ping", endpoint);
let response = http_client
.get(&url)
.header("x-api-key", auth_token)
.timeout(Duration::from_millis(1500))
.send()
.await?;
let _ = response.bytes().await;
Ok(())
}
async fn send_transaction_impl(
&self,
trade_type: TradeType,
transaction: &VersionedTransaction,
wait_confirmation: bool,
) -> Result<()> {
let start_time = Instant::now();
let signature = transaction.signatures[0];
let body_bytes = bincode_serialize(transaction)
.map_err(|e| anyhow::anyhow!("LunarLander binary serialize failed: {}", e))?;
match &self.backend {
LunarLanderBackend::Http { endpoint, auth_token, http_client, .. } => {
let url = format!("{}/send-bin", endpoint);
let response = http_client
.post(&url)
.header("x-api-key", auth_token)
.header("Content-Type", "application/octet-stream")
.body(body_bytes)
.send()
.await?;
let status = response.status();
let _ = response.bytes().await;
if status.is_success() {
if crate::common::sdk_log::sdk_log_enabled() {
crate::common::sdk_log::log_swqos_submitted(
"LunarLander",
trade_type,
start_time.elapsed(),
);
}
} else {
if crate::common::sdk_log::sdk_log_enabled() {
crate::common::sdk_log::log_swqos_submission_failed(
"LunarLander",
trade_type,
start_time.elapsed(),
format!("status {}", status),
);
}
return Err(anyhow::anyhow!("LunarLander sendTransaction failed: {}", status));
}
}
LunarLanderBackend::Quic(quic) => {
let send_result = {
let client = quic.lock().await;
client.send_transaction(&body_bytes).await
};
if let Err(e) = send_result {
// Attempt reconnect on failure
let mut client = quic.lock().await;
if let Err(re) = client.reconnect().await {
if crate::common::sdk_log::sdk_log_enabled() {
crate::common::sdk_log::log_swqos_submission_failed(
"LunarLander",
trade_type,
start_time.elapsed(),
format!("QUIC send failed: {}, reconnect failed: {}", e, re),
);
}
}
return Err(anyhow::anyhow!("LunarLander QUIC send failed: {}", e));
}
if crate::common::sdk_log::sdk_log_enabled() {
crate::common::sdk_log::log_swqos_submitted(
"LunarLander",
trade_type,
start_time.elapsed(),
);
}
}
}
let start_time = Instant::now();
match poll_transaction_confirmation(&self.rpc_client, signature, wait_confirmation).await {
Ok(_) => (),
Err(e) => {
if crate::common::sdk_log::sdk_log_enabled() {
println!(" signature: {:?}", signature);
println!(
" [{:width$}] {} confirmation failed: {:?}",
"LunarLander",
trade_type,
start_time.elapsed(),
width = crate::common::sdk_log::SWQOS_LABEL_WIDTH
);
}
return Err(e);
}
}
if wait_confirmation && crate::common::sdk_log::sdk_log_enabled() {
println!(" signature: {:?}", signature);
println!(
" [{:width$}] {} confirmed: {:?}",
"LunarLander",
trade_type,
start_time.elapsed(),
width = crate::common::sdk_log::SWQOS_LABEL_WIDTH
);
}
Ok(())
}
}
impl Drop for LunarLanderClient {
fn drop(&mut self) {
match &self.backend {
LunarLanderBackend::Http { stop_ping, ping_handle, .. } => {
stop_ping.store(true, Ordering::Relaxed);
let ping_handle = ping_handle.clone();
tokio::spawn(async move {
let mut guard = ping_handle.lock().await;
if let Some(handle) = guard.as_ref() {
handle.abort();
}
*guard = None;
});
}
LunarLanderBackend::Quic(_) => {}
}
}
}