Module plugin 

CtpPlugin —— ek-core 宿主注册的 CTP 网关插件。

谁发谁收:

• 发:驱动输出 → ctx.put 上总线(纯生产者:裸线键 eTick./eContract./ eOrder./eTrade./ePosition./eAccount./ ePositionDone./eLog;0.4.0 D-EMIT 起裸键,网关身份归载荷 gateway_name; 线值与 ek-oms 的 wire 模块同表同值)。
• 收:eTimer(ek-event 秒针,2s 轮转驱动 + 行情日期刷新)与自身寻址 eReq.<名>(订阅/发单/撤单三项服务,对齐 oms 的 ask 面形制)。

传输层(CtpTransport)是 native 桥的接缝:默认构建无传输(可测纯逻辑与 请求面),native 特性(0.2.0)以官方 SDK 二进制实现该接口。

约定:

• 原稿 CtpGateway.count(224-233 的 2 秒 gate)在此为插件内计数器;
• md.update_date 与查询轮转同 gate(共节拍);
• EVENT_POSITION_QUERY_DONE 落线值 ePositionDone.<gw>(与 ek-oms 相位门同表)。

Structs

CancelOrderReply

撤单回包。

CancelOrderReq

撤单请求。

ConfigureReply

配置回包(ok = 已应用并发起连接;false = 校验未过,msg 报字段)。

ConfigureReq

网关配置请求(插件自带配置面,2026-10-17 定盘:配置归插件自身, 界面/宿主手工输入经 ask 进来;插件永不读配置文件)。

CredentialEntry

凭据档位快照行(0.10.0;{gw}.credentials_state ask 回包的元素;运维窗用)。

CredentialStateReq

凭据状态请求(无载荷)。

CtpConfig

网关配置(对齐原稿 connect setting 141-171;地址补前缀由使用方完成—— 原稿在 connect 里对缺 “tcp://”/“ssl://” 的地址自动补 “tcp://”, 本 crate 要求调用方先行规整,保持驱动数据纯净)。

CtpPlugin

CTP 网关插件(纯生产者 + 自服务)。

DisconnectReply

断开回带(ok = 会话守卫已复位;msg 说明放掉了什么、保留了什么)。

DisconnectReq

主动断开请求(0.9.0 {gw}.disconnect;裁定 1「断开 = 停会话,实例与订阅保留」)。

GatewayStatus

网关状态读数(0.9.0 新增;{gw}.status 的返回体 = 界面状态机的唯一事实源)。

GatewayStatusEvent

状态变化事件(0.11.0 第3刀;线名 eStatus.<派生网关名>)。

QueryRateReply

费率查询回包(是否已交付 + RT 返回码文本)。

QueryRateReq

费率/保证金率查询请求(附加接口面,超出原稿)。

SendOrderReply

发单回包。

SendOrderReq

发单请求。

StatusReq

状态查询请求(0.9.0 {gw}.status;无参数,单位结构体只为契约类型名占位)。

SubscribeReply

订阅请求回包。

SubscribeReq

订阅行情请求。

Enums

GatewayChange

状态变化种类(0.11.0 第3刀):网关状态机里值得显形的那一刻。

Constants

CONTRACT_BATCH_ROWS

合约流分批上限(0.11.0 第4刀 R5):每 2000 行发一批,收尾发尾巴。

EVENT_CONTRACT_FINISH

合约流完成线(0.10.5;全局线,无 gw 后缀,载荷=网关名以便多源辨源,D-CFIN; 0.10.5 起导出单源常量 —— ui/station 等消费方一律改引,禁再造裸字面)。

EVENT_STATUS_PREFIX

状态变化线的前缀(线名 = eStatus.<派生网关名>,与 eReq. 同式后缀型)。

ROUTE_TIMER

ek-event 秒针广播键(引用共享常量,不再重复定义字面值)。 由 ek_event::EVENT_TIMER 单源提供。 定时事件类型串(与原版 EVENT_TIMER = "eTimer" 对齐)。

SVC_STATUS

网关通用状态面后缀(0.10.5 单源导出;{gw} 参数化面 —— 消费方按 skill §3 全名公式组 format!("{gw}.{SVC_STATUS}"),分隔符是语法非事实)。

Traits

CtpTransport

传输出口:驱动动作落到真实 CTP 会话(0.2.0 native 才有官方实现)。

Functions

derived_gateway_name

多账号面的注册名派生(界面唯一入口;配置面不存网关名)。

is_derived_gateway_name

注册名形状钉(0.10.4):命名实例只收派生名形状 —— ctp_<broker>_<账号>, 两段非空且仅 [0-9a-z],总长 ≤32,小写。宿主工厂面在收 svctl 命名请求时 以本口前置闸(任意名/变体名/超长名在源头拒,不再给出孤儿档案开口); 界面添加面走 derived_gateway_name,同样只产本形状。