godark 0.2.0

Rust SDK for GoDark DEX — encrypted trading over WebSocket
Documentation
// This file is @generated by prost-build.
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct OrderHeader {
    /// 16-byte RFC 4122 UUID (edge-authenticated user).
    #[prost(bytes = "vec", tag = "1")]
    pub user_uuid: ::prost::alloc::vec::Vec<u8>,
    #[prost(uint64, tag = "2")]
    pub symbol_id: u64,
    #[prost(enumeration = "super::super::common::v1::RequestType", tag = "3")]
    pub request_type: i32,
    #[prost(uint64, tag = "4")]
    pub nonce: u64,
    #[prost(uint32, tag = "5")]
    pub body_length: u32,
    /// Big-endian u128 for distributed tracing; empty means CorrelationId(0).
    #[prost(bytes = "vec", tag = "6")]
    pub correlation_id: ::prost::alloc::vec::Vec<u8>,
    /// Per-edge-connection id (HPKE session / fanout routing).
    #[prost(uint64, tag = "7")]
    pub conn_id: u64,
}
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct EncryptedEdgeRequest {
    #[prost(uint32, tag = "1")]
    pub version: u32,
    #[prost(message, optional, tag = "2")]
    pub header: ::core::option::Option<OrderHeader>,
    #[prost(bytes = "vec", tag = "3")]
    pub encrypted_body: ::prost::alloc::vec::Vec<u8>,
}
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct ResponseHeader {
    /// 16-byte RFC 4122 UUID (WebSocket fanout / edge routing key).
    #[prost(bytes = "vec", tag = "1")]
    pub user_uuid: ::prost::alloc::vec::Vec<u8>,
    #[prost(enumeration = "super::super::common::v1::ResponseMessageType", tag = "2")]
    pub message_type: i32,
    #[prost(uint32, tag = "3")]
    pub body_length: u32,
    #[prost(uint64, tag = "4")]
    pub nonce: u64,
    #[prost(uint64, tag = "5")]
    pub fencing_epoch: u64,
    /// Big-endian u128 tracing id echoed from the request; empty means CorrelationId(0).
    #[prost(bytes = "vec", tag = "6")]
    pub correlation_id: ::prost::alloc::vec::Vec<u8>,
    /// Monotonic per-edge-connection sequence for gap-free ack delivery (Stage 15).
    #[prost(uint64, tag = "7")]
    pub session_seq: u64,
    /// Per-edge-connection id (HPKE session / fanout routing).
    #[prost(uint64, tag = "8")]
    pub conn_id: u64,
}
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct EncryptedEdgeResponse {
    #[prost(uint32, tag = "1")]
    pub version: u32,
    #[prost(message, optional, tag = "2")]
    pub header: ::core::option::Option<ResponseHeader>,
    #[prost(bytes = "vec", tag = "3")]
    pub encrypted_body: ::prost::alloc::vec::Vec<u8>,
}
/// Stage 15d: edge reconnect resume — replay acks with session_seq > last_applied_seq.
#[derive(Clone, Copy, PartialEq, ::prost::Message)]
pub struct SessionControl {
    #[prost(uint64, tag = "1")]
    pub last_applied_seq: u64,
}
/// HPKE Base setup relay (edge stamps user_uuid + conn_id).
/// `encapped_key` is the 32-byte DHKEM(X25519) encapsulation.
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct HpkeSetup {
    /// 16-byte UUID
    #[prost(bytes = "vec", tag = "1")]
    pub user_uuid: ::prost::alloc::vec::Vec<u8>,
    #[prost(uint64, tag = "2")]
    pub conn_id: u64,
    /// opaque HPKE encapped key
    #[prost(bytes = "vec", tag = "3")]
    pub encapped_key: ::prost::alloc::vec::Vec<u8>,
}
#[derive(Clone, Copy, PartialEq, ::prost::Message)]
pub struct HpkeSetupReply {
    #[prost(uint64, tag = "1")]
    pub conn_id: u64,
    /// true when sealed session is ready
    #[prost(bool, tag = "3")]
    pub established: bool,
}
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct SessionClose {
    #[prost(bytes = "vec", tag = "1")]
    pub user_uuid: ::prost::alloc::vec::Vec<u8>,
    #[prost(uint64, tag = "2")]
    pub conn_id: u64,
}
/// REST one-shot HPKE (`info` = gdx-hpke/v1/rest\0 ‖ user_uuid ‖ request_id_be).
/// OrderHeader.conn_id MUST be 0.
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct RestEncryptedEdgeRequest {
    #[prost(uint32, tag = "1")]
    pub version: u32,
    #[prost(message, optional, tag = "2")]
    pub header: ::core::option::Option<OrderHeader>,
    #[prost(bytes = "vec", tag = "3")]
    pub encapped_key: ::prost::alloc::vec::Vec<u8>,
    #[prost(uint64, tag = "4")]
    pub request_id: u64,
    #[prost(bytes = "vec", tag = "5")]
    pub encrypted_body: ::prost::alloc::vec::Vec<u8>,
}
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct RestEncryptedEdgeResponse {
    #[prost(uint32, tag = "1")]
    pub version: u32,
    #[prost(message, optional, tag = "2")]
    pub header: ::core::option::Option<ResponseHeader>,
    #[prost(uint64, tag = "3")]
    pub request_id: u64,
    #[prost(bytes = "vec", tag = "4")]
    pub encrypted_body: ::prost::alloc::vec::Vec<u8>,
}
/// Client↔edge trading WebSocket binary frames (security-critical path).
/// Encrypted orders/pushes, HPKE setup, and session control MUST use this
/// frame (WS Message::Binary). Text JSON is only for control/market ops
/// (login, subscribe, ping, volume/OI/funding, etc.).
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct TradingWsBinaryFrame {
    /// Edge cleartext orders-stream stamps; 0 = absent.
    #[prost(uint64, tag = "10")]
    pub subscription_epoch: u64,
    #[prost(uint64, tag = "11")]
    pub stream_seq: u64,
    #[prost(oneof = "trading_ws_binary_frame::Body", tags = "1, 2, 3, 4, 5, 6")]
    pub body: ::core::option::Option<trading_ws_binary_frame::Body>,
}
/// Nested message and enum types in `TradingWsBinaryFrame`.
pub mod trading_ws_binary_frame {
    #[derive(Clone, PartialEq, ::prost::Oneof)]
    pub enum Body {
        #[prost(message, tag = "1")]
        EncryptedOrder(super::EncryptedEdgeRequest),
        #[prost(message, tag = "2")]
        EncryptedPush(super::EncryptedEdgeResponse),
        #[prost(message, tag = "3")]
        HpkeSetup(super::HpkeSetup),
        #[prost(message, tag = "4")]
        HpkeSetupReply(super::HpkeSetupReply),
        #[prost(message, tag = "5")]
        SessionClose(super::SessionClose),
        #[prost(message, tag = "6")]
        SessionControl(super::SessionControl),
    }
}
/// Edge ↔ sequencer hop: QUIC stream + u32 BE length + this oneof.
/// Same shape as lightweight QUIC RPC (qrpc): no HTTP/gRPC on this hop.
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct EdgeToSequencerFrame {
    #[prost(oneof = "edge_to_sequencer_frame::Body", tags = "1, 2, 3, 4, 5, 6, 7")]
    pub body: ::core::option::Option<edge_to_sequencer_frame::Body>,
}
/// Nested message and enum types in `EdgeToSequencerFrame`.
pub mod edge_to_sequencer_frame {
    #[derive(Clone, PartialEq, ::prost::Oneof)]
    pub enum Body {
        #[prost(message, tag = "1")]
        EncryptedRequest(super::EncryptedEdgeRequest),
        #[prost(message, tag = "2")]
        RestEncryptedRequest(super::RestEncryptedEdgeRequest),
        #[prost(message, tag = "3")]
        TradeQuery(super::super::super::sequencer::v1::EdgeSequencerRequest),
        #[prost(message, tag = "4")]
        AdminRequest(super::super::super::sequencer::v1::EdgeSequencerRequest),
        #[prost(message, tag = "5")]
        HpkeSetup(super::HpkeSetup),
        #[prost(message, tag = "6")]
        SessionClose(super::SessionClose),
        #[prost(message, tag = "7")]
        SessionControl(super::SessionControl),
    }
}
#[derive(Clone, PartialEq, ::prost::Message)]
pub struct SequencerToEdgeFrame {
    /// Used by `cleartext_push` only. 0 otherwise.
    #[prost(uint64, tag = "20")]
    pub fencing_epoch: u64,
    #[prost(
        oneof = "sequencer_to_edge_frame::Body",
        tags = "1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16"
    )]
    pub body: ::core::option::Option<sequencer_to_edge_frame::Body>,
}
/// Nested message and enum types in `SequencerToEdgeFrame`.
pub mod sequencer_to_edge_frame {
    #[derive(Clone, PartialEq, ::prost::Oneof)]
    pub enum Body {
        #[prost(message, tag = "1")]
        S2cReply(super::EncryptedEdgeResponse),
        #[prost(message, tag = "2")]
        Stream(super::EncryptedEdgeResponse),
        #[prost(message, tag = "3")]
        RestReply(super::RestEncryptedEdgeResponse),
        #[prost(message, tag = "4")]
        HpkeSetupReply(super::HpkeSetupReply),
        #[prost(message, tag = "5")]
        CleartextPush(super::super::super::sequencer::v1::SequencerToEdgeMessage),
        #[prost(message, tag = "6")]
        Ack(super::super::super::sequencer::v1::AckMessage),
        #[prost(message, tag = "7")]
        OpenOrders(super::super::super::sequencer::v1::OpenOrdersSnapshot),
        #[prost(message, tag = "8")]
        Positions(super::super::super::sequencer::v1::PositionsSnapshot),
        #[prost(message, tag = "9")]
        AccountMargin(super::super::super::sequencer::v1::AccountMarginUpdate),
        #[prost(message, tag = "10")]
        MassQuoteAck(super::super::super::sequencer::v1::MassQuoteAck),
        #[prost(message, tag = "11")]
        BatchCancelAck(super::super::super::sequencer::v1::BatchCancelAck),
        #[prost(message, tag = "12")]
        CancelAllAck(super::super::super::sequencer::v1::CancelAllAck),
        #[prost(message, tag = "13")]
        CloseAllAck(super::super::super::sequencer::v1::CloseAllAck),
        #[prost(message, tag = "14")]
        ReverseAck(super::super::super::sequencer::v1::ReverseAck),
        #[prost(message, tag = "15")]
        BatchModifyAck(super::super::super::sequencer::v1::BatchModifyAck),
        #[prost(message, tag = "16")]
        TpslAck(super::super::super::sequencer::v1::TpslAck),
    }
}