@lightconexyz/lightcone-sdk 0.1.0

package/dist/auth.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Authentication module for Lightcone.
+ *
+ * Provides functionality for authenticating with the Lightcone API.
+ * Used by both the REST API client and WebSocket client.
+ *
+ * # Authentication Flow
+ *
+ * 1. Generate a sign-in message with timestamp
+ * 2. Sign the message with an Ed25519 keypair
+ * 3. POST to the authentication endpoint
+ * 4. Extract token from JSON response
+ */
+import { Keypair } from "@solana/web3.js";
+/**
+ * Auth error variants (mirrors Rust's AuthError enum).
+ */
+export type AuthErrorVariant = "SystemTime" | "HttpError" | "AuthenticationFailed";
+/**
+ * Authentication error class.
+ */
+export declare class AuthError extends Error {
+    readonly variant: AuthErrorVariant;
+    constructor(variant: AuthErrorVariant, message: string);
+    static systemTime(message: string): AuthError;
+    static httpError(message: string): AuthError;
+    static authenticationFailed(message: string): AuthError;
+}
+/**
+ * Authentication credentials returned after successful login.
+ */
+export interface AuthCredentials {
+    /** The authentication token to use for WebSocket connection */
+    authToken: string;
+    /** The user's public key (Base58 encoded) */
+    userPubkey: string;
+    /** The user's ID */
+    userId: string;
+    /** Token expiration timestamp (Unix seconds) */
+    expiresAt: number;
+}
+/**
+ * Generate the sign-in message with current timestamp.
+ *
+ * @returns The message to be signed
+ */
+export declare function generateSigninMessage(): string;
+/**
+ * Generate the sign-in message with a specific timestamp.
+ *
+ * @param timestampMs - Unix timestamp in milliseconds
+ * @returns The message to be signed
+ */
+export declare function generateSigninMessageWithTimestamp(timestampMs: number): string;
+/**
+ * Authenticate with Lightcone and obtain credentials using a Solana Keypair.
+ *
+ * @param keypair - The Solana Keypair for authentication
+ * @returns AuthCredentials containing the auth token and user public key
+ *
+ * @example
+ * ```typescript
+ * import { Keypair } from "@solana/web3.js";
+ * import { auth } from "@lightcone/sdk";
+ *
+ * const keypair = Keypair.generate();
+ * const credentials = await auth.authenticate(keypair);
+ * console.log("Auth token:", credentials.authToken);
+ * ```
+ */
+export declare function authenticate(keypair: Keypair): Promise<AuthCredentials>;
+/**
+ * Sign a message with a Solana Keypair.
+ *
+ * @param message - The message to sign
+ * @param keypair - The Solana Keypair
+ * @returns The Base58-encoded signature
+ */
+export declare function signMessage(message: string, keypair: Keypair): string;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAQ1C;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,WAAW,GACX,sBAAsB,CAAC;AAE3B;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;gBAEvB,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM;IAMtD,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAI7C,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAI5C,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;CAGxD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;CACnB;AA4BD;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAG9C;AAED;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,eAAe,CAAC,CA8D1B;AAGD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAIrE"}

package/dist/auth.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * Authentication module for Lightcone.
+ *
+ * Provides functionality for authenticating with the Lightcone API.
+ * Used by both the REST API client and WebSocket client.
+ *
+ * # Authentication Flow
+ *
+ * 1. Generate a sign-in message with timestamp
+ * 2. Sign the message with an Ed25519 keypair
+ * 3. POST to the authentication endpoint
+ * 4. Extract token from JSON response
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthError = void 0;
+exports.generateSigninMessage = generateSigninMessage;
+exports.generateSigninMessageWithTimestamp = generateSigninMessageWithTimestamp;
+exports.authenticate = authenticate;
+exports.signMessage = signMessage;
+const bs58_1 = __importDefault(require("bs58"));
+const tweetnacl_1 = __importDefault(require("tweetnacl"));
+const network_1 = require("./network");
+/** Authentication timeout in milliseconds */
+const AUTH_TIMEOUT_MS = 10000;
+/**
+ * Authentication error class.
+ */
+class AuthError extends Error {
+    variant;
+    constructor(variant, message) {
+        super(message);
+        this.name = "AuthError";
+        this.variant = variant;
+    }
+    static systemTime(message) {
+        return new AuthError("SystemTime", `System time error: ${message}`);
+    }
+    static httpError(message) {
+        return new AuthError("HttpError", `HTTP error: ${message}`);
+    }
+    static authenticationFailed(message) {
+        return new AuthError("AuthenticationFailed", `Authentication failed: ${message}`);
+    }
+}
+exports.AuthError = AuthError;
+/**
+ * Generate the sign-in message with current timestamp.
+ *
+ * @returns The message to be signed
+ */
+function generateSigninMessage() {
+    const timestampMs = Date.now();
+    return `Sign in to Lightcone\n\nTimestamp: ${timestampMs}`;
+}
+/**
+ * Generate the sign-in message with a specific timestamp.
+ *
+ * @param timestampMs - Unix timestamp in milliseconds
+ * @returns The message to be signed
+ */
+function generateSigninMessageWithTimestamp(timestampMs) {
+    return `Sign in to Lightcone\n\nTimestamp: ${timestampMs}`;
+}
+/**
+ * Authenticate with Lightcone and obtain credentials using a Solana Keypair.
+ *
+ * @param keypair - The Solana Keypair for authentication
+ * @returns AuthCredentials containing the auth token and user public key
+ *
+ * @example
+ * ```typescript
+ * import { Keypair } from "@solana/web3.js";
+ * import { auth } from "@lightcone/sdk";
+ *
+ * const keypair = Keypair.generate();
+ * const credentials = await auth.authenticate(keypair);
+ * console.log("Auth token:", credentials.authToken);
+ * ```
+ */
+async function authenticate(keypair) {
+    // Generate the message
+    const message = generateSigninMessage();
+    // Sign the message
+    const messageBytes = new TextEncoder().encode(message);
+    const signature = tweetnacl_1.default.sign.detached(messageBytes, keypair.secretKey);
+    const signatureB58 = bs58_1.default.encode(signature);
+    // Get the public key
+    const publicKeyB58 = keypair.publicKey.toBase58();
+    // Create the request body
+    const request = {
+        pubkey_bytes: Array.from(keypair.publicKey.toBytes()),
+        message,
+        signature_bs58: signatureB58,
+    };
+    // Send the authentication request with timeout
+    const url = `${network_1.DEFAULT_API_URL}/auth/login_or_register_with_message`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), AUTH_TIMEOUT_MS);
+    let response;
+    try {
+        response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(request),
+            signal: controller.signal,
+        });
+    }
+    catch (error) {
+        clearTimeout(timeoutId);
+        if (error instanceof Error && error.name === "AbortError") {
+            throw AuthError.authenticationFailed("Authentication request timed out");
+        }
+        throw AuthError.httpError(error instanceof Error ? error.message : String(error));
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+    // Check for HTTP errors
+    if (!response.ok) {
+        throw AuthError.httpError(`HTTP ${response.status}`);
+    }
+    // Parse the response body
+    const loginResponse = (await response.json());
+    return {
+        authToken: loginResponse.token,
+        userPubkey: publicKeyB58,
+        userId: loginResponse.user_id,
+        expiresAt: loginResponse.expires_at,
+    };
+}
+/**
+ * Sign a message with a Solana Keypair.
+ *
+ * @param message - The message to sign
+ * @param keypair - The Solana Keypair
+ * @returns The Base58-encoded signature
+ */
+function signMessage(message, keypair) {
+    const messageBytes = new TextEncoder().encode(message);
+    const signature = tweetnacl_1.default.sign.detached(messageBytes, keypair.secretKey);
+    return bs58_1.default.encode(signature);
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Authentication module for Lightcone.\n *\n * Provides functionality for authenticating with the Lightcone API.\n * Used by both the REST API client and WebSocket client.\n *\n * # Authentication Flow\n *\n * 1. Generate a sign-in message with timestamp\n * 2. Sign the message with an Ed25519 keypair\n * 3. POST to the authentication endpoint\n * 4. Extract token from JSON response\n */\n\nimport { Keypair } from \"@solana/web3.js\";\nimport bs58 from \"bs58\";\nimport nacl from \"tweetnacl\";\nimport { DEFAULT_API_URL } from \"./network\";\n\n/** Authentication timeout in milliseconds */\nconst AUTH_TIMEOUT_MS = 10000;\n\n/**\n * Auth error variants (mirrors Rust's AuthError enum).\n */\nexport type AuthErrorVariant =\n  | \"SystemTime\"\n  | \"HttpError\"\n  | \"AuthenticationFailed\";\n\n/**\n * Authentication error class.\n */\nexport class AuthError extends Error {\n  readonly variant: AuthErrorVariant;\n\n  constructor(variant: AuthErrorVariant, message: string) {\n    super(message);\n    this.name = \"AuthError\";\n    this.variant = variant;\n  }\n\n  static systemTime(message: string): AuthError {\n    return new AuthError(\"SystemTime\", `System time error: ${message}`);\n  }\n\n  static httpError(message: string): AuthError {\n    return new AuthError(\"HttpError\", `HTTP error: ${message}`);\n  }\n\n  static authenticationFailed(message: string): AuthError {\n    return new AuthError(\"AuthenticationFailed\", `Authentication failed: ${message}`);\n  }\n}\n\n/**\n * Authentication credentials returned after successful login.\n */\nexport interface AuthCredentials {\n  /** The authentication token to use for WebSocket connection */\n  authToken: string;\n  /** The user's public key (Base58 encoded) */\n  userPubkey: string;\n  /** The user's ID */\n  userId: string;\n  /** Token expiration timestamp (Unix seconds) */\n  expiresAt: number;\n}\n\n/**\n * Request body for login endpoint.\n */\ninterface LoginRequest {\n  /** Raw 32-byte public key as array */\n  pubkey_bytes: number[];\n  /** The message that was signed */\n  message: string;\n  /** Base58 encoded signature */\n  signature_bs58: string;\n}\n\n/**\n * Response from login endpoint.\n */\ninterface LoginResponse {\n  /** The authentication token */\n  token: string;\n  /** The user's ID */\n  user_id: string;\n  /** The user's wallet address */\n  wallet_address: string;\n  /** Token expiration timestamp (Unix seconds) */\n  expires_at: number;\n}\n\n/**\n * Generate the sign-in message with current timestamp.\n *\n * @returns The message to be signed\n */\nexport function generateSigninMessage(): string {\n  const timestampMs = Date.now();\n  return `Sign in to Lightcone\\n\\nTimestamp: ${timestampMs}`;\n}\n\n/**\n * Generate the sign-in message with a specific timestamp.\n *\n * @param timestampMs - Unix timestamp in milliseconds\n * @returns The message to be signed\n */\nexport function generateSigninMessageWithTimestamp(timestampMs: number): string {\n  return `Sign in to Lightcone\\n\\nTimestamp: ${timestampMs}`;\n}\n\n/**\n * Authenticate with Lightcone and obtain credentials using a Solana Keypair.\n *\n * @param keypair - The Solana Keypair for authentication\n * @returns AuthCredentials containing the auth token and user public key\n *\n * @example\n * ```typescript\n * import { Keypair } from \"@solana/web3.js\";\n * import { auth } from \"@lightcone/sdk\";\n *\n * const keypair = Keypair.generate();\n * const credentials = await auth.authenticate(keypair);\n * console.log(\"Auth token:\", credentials.authToken);\n * ```\n */\nexport async function authenticate(\n  keypair: Keypair\n): Promise<AuthCredentials> {\n  // Generate the message\n  const message = generateSigninMessage();\n\n  // Sign the message\n  const messageBytes = new TextEncoder().encode(message);\n  const signature = nacl.sign.detached(messageBytes, keypair.secretKey);\n  const signatureB58 = bs58.encode(signature);\n\n  // Get the public key\n  const publicKeyB58 = keypair.publicKey.toBase58();\n\n  // Create the request body\n  const request: LoginRequest = {\n    pubkey_bytes: Array.from(keypair.publicKey.toBytes()),\n    message,\n    signature_bs58: signatureB58,\n  };\n\n  // Send the authentication request with timeout\n  const url = `${DEFAULT_API_URL}/auth/login_or_register_with_message`;\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), AUTH_TIMEOUT_MS);\n\n  let response: Response;\n  try {\n    response = await fetch(url, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify(request),\n      signal: controller.signal,\n    });\n  } catch (error) {\n    clearTimeout(timeoutId);\n    if (error instanceof Error && error.name === \"AbortError\") {\n      throw AuthError.authenticationFailed(\n        \"Authentication request timed out\"\n      );\n    }\n    throw AuthError.httpError(\n      error instanceof Error ? error.message : String(error)\n    );\n  } finally {\n    clearTimeout(timeoutId);\n  }\n\n  // Check for HTTP errors\n  if (!response.ok) {\n    throw AuthError.httpError(`HTTP ${response.status}`);\n  }\n\n  // Parse the response body\n  const loginResponse = (await response.json()) as LoginResponse;\n\n  return {\n    authToken: loginResponse.token,\n    userPubkey: publicKeyB58,\n    userId: loginResponse.user_id,\n    expiresAt: loginResponse.expires_at,\n  };\n}\n\n\n/**\n * Sign a message with a Solana Keypair.\n *\n * @param message - The message to sign\n * @param keypair - The Solana Keypair\n * @returns The Base58-encoded signature\n */\nexport function signMessage(message: string, keypair: Keypair): string {\n  const messageBytes = new TextEncoder().encode(message);\n  const signature = nacl.sign.detached(messageBytes, keypair.secretKey);\n  return bs58.encode(signature);\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Lightcone SDK - TypeScript SDK for the Lightcone protocol on Solana.
+ *
+ * This SDK provides three main modules:
+ * - `program`: On-chain program interaction (smart contract)
+ * - `api`: REST API client for market data, orders, and positions
+ * - `websocket`: Real-time data streaming for orderbooks, trades, and user events
+ *
+ * @example
+ * ```typescript
+ * import { LightconePinocchioClient, PROGRAM_ID, api, websocket } from "@lightcone/sdk";
+ *
+ * // On-chain program interaction
+ * const programClient = new LightconePinocchioClient(connection, payer);
+ *
+ * // REST API client
+ * const apiClient = new api.LightconeApiClient();
+ * const markets = await apiClient.getMarkets();
+ *
+ * // WebSocket client for real-time data
+ * const wsClient = await websocket.LightconeWebSocketClient.connectDefault();
+ * await wsClient.subscribeBookUpdates(["market1:ob1"]);
+ * ```
+ */
+/**
+ * On-chain program interaction module.
+ * Contains the client and utilities for interacting with the Lightcone smart contract.
+ */
+export * from "./program";
+/**
+ * Network URL constants (API and WebSocket endpoints).
+ */
+export { DEFAULT_API_URL, DEFAULT_WS_URL } from "./network";
+/**
+ * Shared utilities, types, and constants.
+ * Used across all SDK modules.
+ */
+export * from "./shared";
+/**
+ * REST API client module.
+ * Provides HTTP client functionality for market data, orders, and positions.
+ */
+export * as api from "./api";
+/**
+ * WebSocket client module.
+ * Provides real-time data streaming for orderbooks, trades, and user events.
+ */
+export * as websocket from "./websocket";
+/**
+ * Authentication module.
+ * Provides authentication functionality shared by API and WebSocket clients.
+ */
+export * as auth from "./auth";
+export { PublicKey, Connection, Keypair, Transaction, TransactionInstruction, } from "@solana/web3.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH;;;GAGG;AACH,cAAc,WAAW,CAAC;AAE1B;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE5D;;;GAGG;AACH,cAAc,UAAU,CAAC;AAEzB;;;GAGG;AACH,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAE7B;;;GAGG;AACH,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAK/B,OAAO,EACL,SAAS,EACT,UAAU,EACV,OAAO,EACP,WAAW,EACX,sBAAsB,GACvB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * Lightcone SDK - TypeScript SDK for the Lightcone protocol on Solana.
+ *
+ * This SDK provides three main modules:
+ * - `program`: On-chain program interaction (smart contract)
+ * - `api`: REST API client for market data, orders, and positions
+ * - `websocket`: Real-time data streaming for orderbooks, trades, and user events
+ *
+ * @example
+ * ```typescript
+ * import { LightconePinocchioClient, PROGRAM_ID, api, websocket } from "@lightcone/sdk";
+ *
+ * // On-chain program interaction
+ * const programClient = new LightconePinocchioClient(connection, payer);
+ *
+ * // REST API client
+ * const apiClient = new api.LightconeApiClient();
+ * const markets = await apiClient.getMarkets();
+ *
+ * // WebSocket client for real-time data
+ * const wsClient = await websocket.LightconeWebSocketClient.connectDefault();
+ * await wsClient.subscribeBookUpdates(["market1:ob1"]);
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionInstruction = exports.Transaction = exports.Keypair = exports.Connection = exports.PublicKey = exports.auth = exports.websocket = exports.api = exports.DEFAULT_WS_URL = exports.DEFAULT_API_URL = void 0;
+// ============================================================================
+// MODULE EXPORTS
+// ============================================================================
+/**
+ * On-chain program interaction module.
+ * Contains the client and utilities for interacting with the Lightcone smart contract.
+ */
+__exportStar(require("./program"), exports);
+/**
+ * Network URL constants (API and WebSocket endpoints).
+ */
+var network_1 = require("./network");
+Object.defineProperty(exports, "DEFAULT_API_URL", { enumerable: true, get: function () { return network_1.DEFAULT_API_URL; } });
+Object.defineProperty(exports, "DEFAULT_WS_URL", { enumerable: true, get: function () { return network_1.DEFAULT_WS_URL; } });
+/**
+ * Shared utilities, types, and constants.
+ * Used across all SDK modules.
+ */
+__exportStar(require("./shared"), exports);
+/**
+ * REST API client module.
+ * Provides HTTP client functionality for market data, orders, and positions.
+ */
+exports.api = __importStar(require("./api"));
+/**
+ * WebSocket client module.
+ * Provides real-time data streaming for orderbooks, trades, and user events.
+ */
+exports.websocket = __importStar(require("./websocket"));
+/**
+ * Authentication module.
+ * Provides authentication functionality shared by API and WebSocket clients.
+ */
+exports.auth = __importStar(require("./auth"));
+// ============================================================================
+// RE-EXPORTS FROM DEPENDENCIES
+// ============================================================================
+var web3_js_1 = require("@solana/web3.js");
+Object.defineProperty(exports, "PublicKey", { enumerable: true, get: function () { return web3_js_1.PublicKey; } });
+Object.defineProperty(exports, "Connection", { enumerable: true, get: function () { return web3_js_1.Connection; } });
+Object.defineProperty(exports, "Keypair", { enumerable: true, get: function () { return web3_js_1.Keypair; } });
+Object.defineProperty(exports, "Transaction", { enumerable: true, get: function () { return web3_js_1.Transaction; } });
+Object.defineProperty(exports, "TransactionInstruction", { enumerable: true, get: function () { return web3_js_1.TransactionInstruction; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;GAGG;AACH,4CAA0B;AAE1B;;GAEG;AACH,qCAA4D;AAAnD,0GAAA,eAAe,OAAA;AAAE,yGAAA,cAAc,OAAA;AAExC;;;GAGG;AACH,2CAAyB;AAEzB;;;GAGG;AACH,6CAA6B;AAE7B;;;GAGG;AACH,yDAAyC;AAEzC;;;GAGG;AACH,+CAA+B;AAE/B,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAC/E,2CAMyB;AALvB,oGAAA,SAAS,OAAA;AACT,qGAAA,UAAU,OAAA;AACV,kGAAA,OAAO,OAAA;AACP,sGAAA,WAAW,OAAA;AACX,iHAAA,sBAAsB,OAAA","sourcesContent":["/**\n * Lightcone SDK - TypeScript SDK for the Lightcone protocol on Solana.\n *\n * This SDK provides three main modules:\n * - `program`: On-chain program interaction (smart contract)\n * - `api`: REST API client for market data, orders, and positions\n * - `websocket`: Real-time data streaming for orderbooks, trades, and user events\n *\n * @example\n * ```typescript\n * import { LightconePinocchioClient, PROGRAM_ID, api, websocket } from \"@lightcone/sdk\";\n *\n * // On-chain program interaction\n * const programClient = new LightconePinocchioClient(connection, payer);\n *\n * // REST API client\n * const apiClient = new api.LightconeApiClient();\n * const markets = await apiClient.getMarkets();\n *\n * // WebSocket client for real-time data\n * const wsClient = await websocket.LightconeWebSocketClient.connectDefault();\n * await wsClient.subscribeBookUpdates([\"market1:ob1\"]);\n * ```\n */\n\n// ============================================================================\n// MODULE EXPORTS\n// ============================================================================\n\n/**\n * On-chain program interaction module.\n * Contains the client and utilities for interacting with the Lightcone smart contract.\n */\nexport * from \"./program\";\n\n/**\n * Network URL constants (API and WebSocket endpoints).\n */\nexport { DEFAULT_API_URL, DEFAULT_WS_URL } from \"./network\";\n\n/**\n * Shared utilities, types, and constants.\n * Used across all SDK modules.\n */\nexport * from \"./shared\";\n\n/**\n * REST API client module.\n * Provides HTTP client functionality for market data, orders, and positions.\n */\nexport * as api from \"./api\";\n\n/**\n * WebSocket client module.\n * Provides real-time data streaming for orderbooks, trades, and user events.\n */\nexport * as websocket from \"./websocket\";\n\n/**\n * Authentication module.\n * Provides authentication functionality shared by API and WebSocket clients.\n */\nexport * as auth from \"./auth\";\n\n// ============================================================================\n// RE-EXPORTS FROM DEPENDENCIES\n// ============================================================================\nexport {\n  PublicKey,\n  Connection,\n  Keypair,\n  Transaction,\n  TransactionInstruction,\n} from \"@solana/web3.js\";\n"]}

package/dist/network.d.ts

@@ -0,0 +1,5 @@
+/** Default REST API base URL for Lightcone. */
+export declare const DEFAULT_API_URL = "https://tapi.lightcone.xyz/api";
+/** Default WebSocket URL for Lightcone. */
+export declare const DEFAULT_WS_URL = "wss://ws.lightcone.xyz/ws";
+//# sourceMappingURL=network.d.ts.map

package/dist/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,eAAO,MAAM,eAAe,mCAAmC,CAAC;AAEhE,2CAA2C;AAC3C,eAAO,MAAM,cAAc,8BAA8B,CAAC"}

package/dist/network.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_WS_URL = exports.DEFAULT_API_URL = void 0;
+/** Default REST API base URL for Lightcone. */
+exports.DEFAULT_API_URL = "https://tapi.lightcone.xyz/api";
+/** Default WebSocket URL for Lightcone. */
+exports.DEFAULT_WS_URL = "wss://ws.lightcone.xyz/ws";
+//# sourceMappingURL=network.js.map

package/dist/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":";;;AAAA,+CAA+C;AAClC,QAAA,eAAe,GAAG,gCAAgC,CAAC;AAEhE,2CAA2C;AAC9B,QAAA,cAAc,GAAG,2BAA2B,CAAC","sourcesContent":["/** Default REST API base URL for Lightcone. */\nexport const DEFAULT_API_URL = \"https://tapi.lightcone.xyz/api\";\n\n/** Default WebSocket URL for Lightcone. */\nexport const DEFAULT_WS_URL = \"wss://ws.lightcone.xyz/ws\";\n"]}

package/dist/program/accounts.d.ts

@@ -0,0 +1,98 @@
+import { Exchange, Market, OrderStatus, UserNonce, Position, Orderbook } from "./types";
+/**
+ * Check if a buffer has a valid Exchange discriminator
+ */
+export declare function isExchangeAccount(data: Buffer): boolean;
+/**
+ * Check if a buffer has a valid Market discriminator
+ */
+export declare function isMarketAccount(data: Buffer): boolean;
+/**
+ * Check if a buffer has a valid OrderStatus discriminator
+ */
+export declare function isOrderStatusAccount(data: Buffer): boolean;
+/**
+ * Check if a buffer has a valid UserNonce discriminator
+ */
+export declare function isUserNonceAccount(data: Buffer): boolean;
+/**
+ * Check if a buffer has a valid Position discriminator
+ */
+export declare function isPositionAccount(data: Buffer): boolean;
+/**
+ * Check if a buffer has a valid Orderbook discriminator
+ */
+export declare function isOrderbookAccount(data: Buffer): boolean;
+/**
+ * Deserialize Exchange account data
+ *
+ * Layout (88 bytes):
+ * - discriminator: [u8; 8]
+ * - authority: Pubkey (32 bytes)
+ * - operator: Pubkey (32 bytes)
+ * - market_count: u64 (8 bytes)
+ * - paused: u8 (1 byte)
+ * - bump: u8 (1 byte)
+ * - _padding: [u8; 6]
+ */
+export declare function deserializeExchange(data: Buffer): Exchange;
+/**
+ * Deserialize Market account data
+ *
+ * Layout (120 bytes):
+ * - discriminator: [u8; 8]
+ * - market_id: u64 (8 bytes)
+ * - num_outcomes: u8 (1 byte)
+ * - status: u8 (1 byte)
+ * - winning_outcome: u8 (1 byte)
+ * - has_winning_outcome: u8 (1 byte)
+ * - bump: u8 (1 byte)
+ * - _padding: [u8; 3]
+ * - oracle: Pubkey (32 bytes)
+ * - question_id: [u8; 32]
+ * - condition_id: [u8; 32]
+ */
+export declare function deserializeMarket(data: Buffer): Market;
+/**
+ * Deserialize OrderStatus account data
+ *
+ * Layout (24 bytes):
+ * - discriminator: [u8; 8]
+ * - remaining: u64 (8 bytes)
+ * - is_cancelled: u8 (1 byte)
+ * - _padding: [u8; 7]
+ */
+export declare function deserializeOrderStatus(data: Buffer): OrderStatus;
+/**
+ * Deserialize UserNonce account data
+ *
+ * Layout (16 bytes):
+ * - discriminator: [u8; 8]
+ * - nonce: u64 (8 bytes)
+ */
+export declare function deserializeUserNonce(data: Buffer): UserNonce;
+/**
+ * Deserialize Position account data
+ *
+ * Layout (80 bytes):
+ * - discriminator: [u8; 8]
+ * - owner: Pubkey (32 bytes)
+ * - market: Pubkey (32 bytes)
+ * - bump: u8 (1 byte)
+ * - _padding: [u8; 7]
+ */
+export declare function deserializePosition(data: Buffer): Position;
+/**
+ * Deserialize Orderbook account data
+ *
+ * Layout (144 bytes):
+ * - discriminator: [u8; 8]
+ * - market: Pubkey (32 bytes)
+ * - mint_a: Pubkey (32 bytes)
+ * - mint_b: Pubkey (32 bytes)
+ * - lookup_table: Pubkey (32 bytes)
+ * - bump: u8 (1 byte)
+ * - _padding: [u8; 7]
+ */
+export declare function deserializeOrderbook(data: Buffer): Orderbook;
+//# sourceMappingURL=accounts.d.ts.map

package/dist/program/accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../src/program/accounts.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,QAAQ,EACR,MAAM,EAEN,WAAW,EACX,SAAS,EACT,QAAQ,EACR,SAAS,EACV,MAAM,SAAS,CAAC;AAuBjB;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGxD;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAuC1D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2EtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CA2BhE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAqB5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CA+B1D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAuC5D"}