Lightcone TypeScript SDK v2

TypeScript SDK v2 for the Lightcone protocol, rebuilt to mirror the Rust v2 layered architecture.

Installation

npm install @lightconexyz/lightcone-sdk

Architecture

The SDK is organized in 5 layers:

1. shared, domain, program, error, network
2. auth, privy
3. http
4. ws
5. client (LightconeClient)

Quick Start

import { LightconeClient, Resolution } from "@lightconexyz/lightcone-sdk";

const client = LightconeClient.builder()
  .baseUrl("https://tapi.lightcone.xyz")
  .wsUrl("wss://tws.lightcone.xyz/ws")
  .build();

const markets = await client.markets().get(undefined, 20);
const orderbook = await client.orderbooks().get("orderbook_id", 20);
const trades = await client.trades().get("orderbook_id", 50);
const candles = await client.priceHistory().get("orderbook_id", Resolution.Minute1);

Main Entry Points

• LightconeClient + LightconeClientBuilder
• client.markets(), client.orderbooks(), client.orders(), client.positions()
• client.trades(), client.priceHistory(), client.admin(), client.auth(), client.privy(), client.referrals()
• client.ws() for WebSocket streaming with typed subscribe/unsubscribe payloads

Program Module

program/ remains the on-chain toolkit (PDAs, instructions, account deserialization, order utilities), with v2 envelope builders now exposed:

• LimitOrderEnvelope
• TriggerOrderEnvelope

Notes

• Browser cookie-based auth is supported via credentials: "include".
• Native/Node auth token injection uses Cookie: auth_token=... internally.
• Orderbook decimals are memoized in the high-level client cache.

License

MIT