guilder-abstraction

Auto-generated trading traits for the guilder multi-exchange crypto trading library.

This crate defines the interface contract that every exchange client implements. Strategies coded against these traits work on any exchange — Binance, Hyperliquid, or any future integration — with zero code changes.

Traits

All traits are async. Subscription methods return BoxStream<Result<T, String>> for object safety.

Key types

Structs

Enums

Stream type

pub type BoxStream<T> = Pin<Box<dyn Stream<Item = T> + Send + 'static>>;

Usage

[dependencies]
guilder-abstraction = "0.1"

Implementing a client

use guilder_abstraction::{GetMarketData, L2Update};

pub struct MyExchangeClient { /* ... */ }

impl GetMarketData for MyExchangeClient {
    async fn get_symbol(&self) -> Result<Vec<String>, String> {
        // call your exchange's REST API
    }

    async fn get_l2_orderbook(&self, symbol: String) -> Result<Vec<L2Update>, String> {
        // fetch L2 snapshot
    }

    // ... other methods
}

Writing exchange-agnostic code

use guilder_abstraction::GetMarketData;

async fn print_symbols(client: &impl GetMarketData) {
    let symbols = client.get_symbol().await.unwrap();
    println!("{:?}", symbols);
}

How it's generated

This crate is auto-generated from trading.yaml — a language-neutral DSL that defines traits, structs, and enums using only primitives and self-referencing types. The codegen produces idiomatic code for each target language.

Do not edit the generated source directly. Edit trading.yaml and regenerate:

cd abstraction/codegen && cargo run

Design rules

• trading.yaml uses only primitives and types defined within the YAML — no external crate types
• Generated code depends only on the standard library (plus futures-core for Stream)
• Subscription methods return BoxStream, not async fn — keeping traits object-safe

Exchange clients

Implement these traits for your exchange:

Find all clients: crates.io/search?q=guilder-client

Part of guilder

trading.yaml → guilder-abstraction → guilder-core → your strategy
                                   ↗
              guilder-client-* ────

See the guilder repository for the full architecture.