Struct FutuServer 

pub struct FutuServer {
    pub state: ServerState,
}

Fields

state: ServerState

Implementations

impl FutuServer

pub fn new(state: ServerState) -> Self

fn err(msg: impl Display) -> String

fn wrap<E: Display>(res: Result<String, E>) -> String

async fn client_or_err(&self) -> Result<Arc<FutuClient>, String>

fn require_tool_scope(&self, tool: &'static str) -> Option<String>

只读工具的 scope 守卫（基于中央注册表 guard::scope_for_tool）； 若 tool 未登记则 fail-closed 拒绝。返回 Some(错误 JSON) 表示被拒绝。

fn require_trading( &self, tool: &'static str, env: &str, ctx: Option<CheckCtx>, override_key: Option<&str>, ) -> Option<String>

交易写守卫；ctx=Some 时同时做限额检查；override_key=Some 时优先用该 plaintext

fn current_key_id(&self, override_key: Option<&str>) -> Option<String>

当前请求的 key_id（legacy 模式返回 None）。 override_key：per-call api_key 参数；若命中一个有效 key，返回其 id； 若为 None 或未命中，回落到 startup 捕获的 state.authed_key.id。

impl FutuServer

pub fn futu_ping_tool_attr() -> Tool

Generated tool metadata function for futu_ping

fn futu_ping(&self) -> Pin<Box<dyn Future<Output = String> + Send + '_>>

pub fn futu_get_quote_tool_attr() -> Tool

Generated tool metadata function for futu_get_quote

fn futu_get_quote( &self, Parameters: Parameters<SymbolReq>, ) -> Pin<Box<dyn Future<Output = String> + Send + '_>>

pub fn futu_get_snapshot_tool_attr() -> Tool

Generated tool metadata function for futu_get_snapshot

fn futu_get_snapshot( &self, Parameters: Parameters<SymbolReq>, ) -> Pin<Box<dyn Future<Output = String> + Send + '_>>

pub fn futu_get_kline_tool_attr() -> Tool

Generated tool metadata function for futu_get_kline

fn futu_get_kline( &self, Parameters: Parameters<KLineReq>, ) -> Pin<Box<dyn Future<Output = String> + Send + '_>>

pub fn futu_get_orderbook_tool_attr() -> Tool

Generated tool metadata function for futu_get_orderbook

fn futu_get_orderbook( &self, Parameters: Parameters<OrderBookReq>, ) -> Pin<Box<dyn Future<Output = String> + Send + '_>>

pub fn futu_get_ticker_tool_attr() -> Tool

Generated tool metadata function for futu_get_ticker

fn futu_get_ticker( &self, Parameters: Parameters<TickerReq>, ) -> Pin<Box<dyn Future<Output = String> + Send + '_>>

pub fn futu_get_rt_tool_attr() -> Tool

Generated tool metadata function for futu_get_rt

fn futu_get_rt( &self, Parameters: Parameters<SymbolReq>, ) -> Pin<Box<dyn Future<Output = String> + Send + '_>>

pub fn futu_get_static_tool_attr() -> Tool

Generated tool metadata function for futu_get_static

fn futu_get_static( &self, Parameters: Parameters<SymbolListReq>, ) -> Pin<Box<dyn Future<Output = String> + Send + '_>>

pub fn futu_get_broker_tool_attr() -> Tool

Generated tool metadata function for futu_get_broker

fn futu_get_broker( &self, Parameters: Parameters<SymbolReq>, ) -> Pin<Box<dyn Future<Output = String> + Send + '_>>

pub fn futu_list_plates_tool_attr() -> Tool

Generated tool metadata function for futu_list_plates

fn futu_list_plates( &self, Parameters: Parameters<PlateListReq>, ) -> Pin<Box<dyn Future<Output = String> + Send + '_>>

pub fn futu_plate_stocks_tool_attr() -> Tool

Generated tool metadata function for futu_plate_stocks

fn futu_plate_stocks( &self, Parameters: Parameters<PlateStocksReq>, ) -> Pin<Box<dyn Future<Output = String> + Send + '_>>

pub fn futu_list_accounts_tool_attr() -> Tool

Generated tool metadata function for futu_list_accounts

fn futu_list_accounts( &self, ) -> Pin<Box<dyn Future<Output = String> + Send + '_>>

pub fn futu_get_funds_tool_attr() -> Tool

Generated tool metadata function for futu_get_funds

fn futu_get_funds( &self, Parameters: Parameters<TrdAccReq>, ) -> Pin<Box<dyn Future<Output = String> + Send + '_>>

pub fn futu_get_positions_tool_attr() -> Tool

Generated tool metadata function for futu_get_positions

fn futu_get_positions( &self, Parameters: Parameters<TrdAccReq>, ) -> Pin<Box<dyn Future<Output = String> + Send + '_>>

pub fn futu_get_orders_tool_attr() -> Tool

Generated tool metadata function for futu_get_orders

fn futu_get_orders( &self, Parameters: Parameters<TrdAccReq>, ) -> Pin<Box<dyn Future<Output = String> + Send + '_>>

pub fn futu_get_deals_tool_attr() -> Tool

Generated tool metadata function for futu_get_deals

fn futu_get_deals( &self, Parameters: Parameters<TrdAccReq>, ) -> Pin<Box<dyn Future<Output = String> + Send + '_>>

pub fn futu_place_order_tool_attr() -> Tool

Generated tool metadata function for futu_place_order

fn futu_place_order( &self, Parameters: Parameters<PlaceOrderReq>, req_ctx: RequestContext<RoleServer>, ) -> Pin<Box<dyn Future<Output = String> + Send + '_>>

pub fn futu_modify_order_tool_attr() -> Tool

Generated tool metadata function for futu_modify_order

fn futu_modify_order( &self, Parameters: Parameters<ModifyOrderReq>, req_ctx: RequestContext<RoleServer>, ) -> Pin<Box<dyn Future<Output = String> + Send + '_>>

pub fn futu_cancel_order_tool_attr() -> Tool

Generated tool metadata function for futu_cancel_order

fn futu_cancel_order( &self, Parameters: Parameters<CancelOrderReq>, req_ctx: RequestContext<RoleServer>, ) -> Pin<Box<dyn Future<Output = String> + Send + '_>>

fn tool_router() -> ToolRouter<Self>

Trait Implementations

impl Clone for FutuServer

fn clone(&self) -> FutuServer

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl ServerHandler for FutuServer

async fn call_tool( &self, request: CallToolRequestParams, context: RequestContext<RoleServer>, ) -> Result<CallToolResult, ErrorData>

async fn list_tools( &self, _request: Option<PaginatedRequestParams>, _context: RequestContext<RoleServer>, ) -> Result<ListToolsResult, ErrorData>

fn get_tool(&self, name: &str) -> Option<Tool>

Get a tool definition by name.

fn get_info(&self) -> ServerInfo

fn enqueue_task( &self, _request: CallToolRequestParams, _context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<CreateTaskResult, ErrorData>> + MaybeSendFuture

fn ping( &self, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + MaybeSendFuture

fn initialize( &self, request: InitializeRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<InitializeResult, ErrorData>> + MaybeSendFuture

fn complete( &self, request: CompleteRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<CompleteResult, ErrorData>> + MaybeSendFuture

fn set_level( &self, request: SetLevelRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + MaybeSendFuture

fn get_prompt( &self, request: GetPromptRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<GetPromptResult, ErrorData>> + MaybeSendFuture

fn list_prompts( &self, request: Option<PaginatedRequestParams>, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<ListPromptsResult, ErrorData>> + MaybeSendFuture

fn list_resources( &self, request: Option<PaginatedRequestParams>, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<ListResourcesResult, ErrorData>> + MaybeSendFuture

fn list_resource_templates( &self, request: Option<PaginatedRequestParams>, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<ListResourceTemplatesResult, ErrorData>> + MaybeSendFuture

fn read_resource( &self, request: ReadResourceRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<ReadResourceResult, ErrorData>> + MaybeSendFuture

fn subscribe( &self, request: SubscribeRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + MaybeSendFuture

fn unsubscribe( &self, request: UnsubscribeRequestParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + MaybeSendFuture

fn on_custom_request( &self, request: CustomRequest, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<CustomResult, ErrorData>> + MaybeSendFuture

fn on_cancelled( &self, notification: CancelledNotificationParam, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + MaybeSendFuture

fn on_progress( &self, notification: ProgressNotificationParam, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + MaybeSendFuture

fn on_initialized( &self, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + MaybeSendFuture

fn on_roots_list_changed( &self, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + MaybeSendFuture

fn on_custom_notification( &self, notification: CustomNotification, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + MaybeSendFuture

fn list_tasks( &self, request: Option<PaginatedRequestParams>, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<ListTasksResult, ErrorData>> + MaybeSendFuture

fn get_task_info( &self, request: GetTaskInfoParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<GetTaskResult, ErrorData>> + MaybeSendFuture

fn get_task_result( &self, request: GetTaskResultParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<GetTaskPayloadResult, ErrorData>> + MaybeSendFuture

fn cancel_task( &self, request: CancelTaskParams, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<CancelTaskResult, ErrorData>> + MaybeSendFuture