Skip to main content

cripsy_binary_api/broker/
config.rs

1//! Configuración de conexión.
2
3use serde::{Deserialize, Serialize};
4
5/// Elección de cuenta al conectar.
6#[derive(Debug, Clone, Copy, PartialEq, Eq, Default, Serialize, Deserialize)]
7pub enum AccountSelection {
8    /// El bróker decide (IQ Option: demo, type 4).
9    #[default]
10    Default,
11    Practice,
12    Real,
13}
14
15/// Configuración del adaptador IQ Option.
16#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
17pub struct IqOptionConfig {
18    pub email: String,
19    pub password: String,
20    /// Host de autenticación (login HTTP).
21    pub auth_host: String,
22    /// Host de la API.
23    pub api_host: String,
24    /// Host del WebSocket.
25    pub ws_host: String,
26    pub timeout_secs: u64,
27    pub account: AccountSelection,
28    pub transport: TransportConfig,
29}
30
31impl Default for IqOptionConfig {
32    fn default() -> Self {
33        Self {
34            email: String::new(),
35            password: String::new(),
36            auth_host: "auth.iqoption.com".into(),
37            api_host: "iqoption.com".into(),
38            ws_host: "iqoption.com".into(),
39            timeout_secs: 30,
40            account: AccountSelection::Default,
41            transport: TransportConfig::default(),
42        }
43    }
44}
45
46/// Configuración de la capa de transporte (común a todos los brókers).
47#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
48pub struct TransportConfig {
49    pub connect_timeout_secs: u64,
50    pub request_timeout_secs: u64,
51    pub max_retries: u32,
52    pub backoff_base_ms: u64,
53    pub backoff_max_ms: u64,
54    /// Capacidad de la cola de salida del socket.
55    ///
56    /// Acotada a propósito: si el bróker no consume, el productor espera (o
57    /// falla) en vez de acumular órdenes en memoria.
58    pub cola_salida: usize,
59    /// Verificación TLS real; `false` solo para pruebas documentadas.
60    pub verify_tls: bool,
61    pub proxy: Option<String>,
62    /// User-Agent opcional. Verificado en vivo 2026-10-28: el bróker **no
63    /// filtra por User-Agent** (login y WSS funcionan igual con UA propio, de
64    /// navegador o ajeno). Se expone solo por compatibilidad; cambiar el UA no
65    /// aporta protección alguna contra baneos.
66    pub user_agent: Option<String>,
67}
68
69impl Default for TransportConfig {
70    fn default() -> Self {
71        Self {
72            connect_timeout_secs: 10,
73            request_timeout_secs: 30,
74            max_retries: 5,
75            backoff_base_ms: 250,
76            backoff_max_ms: 8_000,
77            cola_salida: 256,
78            verify_tls: true,
79            proxy: None,
80            user_agent: None,
81        }
82    }
83}
84
85/// Parámetros de conexión type-erased (requisito de object-safety).
86#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
87pub enum BrokerParams {
88    IqOption(IqOptionConfig),
89    /// Deriv (API moderna). Disponible con el núcleo async.
90    #[cfg(feature = "async")]
91    Deriv(crate::broker::deriv::DerivConfig),
92}