Struct OrderBuilder 

pub struct OrderBuilder { /* private fields */ }

Builder for creating orders with a fluent API.

Provides a convenient way to construct, sign, and convert orders for API submission in a single chain of method calls.

Example

use lightcone_sdk::prelude::*;

let request = OrderBuilder::new()
    .maker(maker_pubkey)
    .market(market_pubkey)
    .base_mint(yes_token)
    .quote_mint(usdc)
    .bid()
    .nonce(5)
    .maker_amount(1_000_000)
    .taker_amount(500_000)
    .build_and_sign(&keypair)
    .to_submit_request("orderbook_id");

Implementations

impl OrderBuilder

pub fn new() -> Self

Create a new order builder.

pub fn nonce(self, nonce: u64) -> Self

Set the nonce (required).

The nonce must be >= the user’s on-chain nonce for the order to be valid.

pub fn maker(self, maker: Pubkey) -> Self

Set the maker pubkey (required).

This is the public key of the order creator.

pub fn market(self, market: Pubkey) -> Self

Set the market pubkey (required).

pub fn base_mint(self, base_mint: Pubkey) -> Self

Set the base mint / token being bought or sold (required).

pub fn quote_mint(self, quote_mint: Pubkey) -> Self

Set the quote mint / payment token (required).

pub fn bid(self) -> Self

Set as a bid order (buy base with quote).

pub fn ask(self) -> Self

Set as an ask order (sell base for quote).

pub fn side(self, side: OrderSide) -> Self

Set the side directly.

pub fn maker_amount(self, amount: u64) -> Self

Set the amount the maker gives.

pub fn taker_amount(self, amount: u64) -> Self

Set the amount the maker wants to receive.

pub fn expiration(self, expiration: i64) -> Self

Set expiration timestamp (0 = no expiration).

pub fn build(self) -> FullOrder

Build an unsigned FullOrder.

The returned order has an all-zero signature and must be signed before submission.

Panics

Panics if required fields are missing.

pub fn build_and_sign(self, keypair: &Keypair) -> FullOrder

Build and sign the order with the given keypair.

Returns a signed FullOrder ready for API submission.

Panics

Panics if required fields are missing.

pub fn to_submit_request( self, keypair: &Keypair, orderbook_id: impl Into<String>, ) -> SubmitOrderRequest

Build, sign, and convert directly to a SubmitOrderRequest.

Arguments

• keypair - Keypair to sign the order with
• orderbook_id - Target orderbook ID

Panics

Panics if required fields are missing.

Trait Implementations

impl Clone for OrderBuilder

fn clone(&self) -> OrderBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OrderBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for OrderBuilder

fn default() -> OrderBuilder

Returns the “default value” for a type.