@lightconexyz/lightcone-sdk 0.1.0 → 0.2.1

package/README.md

@@ -1,231 +1,58 @@
-# Lightcone TypeScript SDK
+# Lightcone TypeScript SDK v2
 
-TypeScript SDK for the Lightcone protocol on Solana.
+TypeScript SDK v2 for the Lightcone protocol, rebuilt to mirror the Rust v2 layered architecture.
 
 ## Installation
 
 ```bash
-npm install @lightcone/sdk
+npm install @lightconexyz/lightcone-sdk
 ```
 
-## Modules
+## Architecture
 
-| Module | Description |
-|--------|-------------|
-| [`program`](src/program/README.md) | On-chain Solana program interaction (accounts, transactions, orders, Ed25519 verification) |
-| [`api`](src/api/README.md) | REST API client for market data and order management |
-| [`websocket`](src/websocket/README.md) | Real-time data streaming via WebSocket |
-| [`shared`](src/shared/README.md) | Shared utilities (Resolution, constants, decimal helpers) |
+The SDK is organized in 5 layers:
 
-## Quick Start
-
-```typescript
-import { LightconePinocchioClient, PROGRAM_ID, api, websocket } from "@lightcone/sdk";
-```
-
-### REST API
-
-Query markets, submit orders, and manage positions via the REST API.
-
-```typescript
-import { api } from "@lightcone/sdk";
-
-const client = new api.LightconeApiClient();
-
-// Get markets
-const markets = await client.getMarkets();
-console.log(`Found ${markets.total} markets`);
-
-// Get orderbook depth
-const orderbook = await client.getOrderbook("orderbook_id", 10);
-console.log(`Best bid: ${orderbook.best_bid}`);
-console.log(`Best ask: ${orderbook.best_ask}`);
+1. `shared`, `domain`, `program`, `error`, `network`
+2. `auth`, `privy`
+3. `http`
+4. `ws`
+5. `client` (`LightconeClient`)
 
-// Get user positions
-const positions = await client.getUserPositions("user_pubkey");
-```
-
-### On-Chain Program
-
-Build transactions for on-chain operations: minting positions, matching orders, redeeming winnings.
-
-```typescript
-import { Connection, Keypair } from "@solana/web3.js";
-import { LightconePinocchioClient, BidOrderParams } from "@lightcone/sdk";
-
-const connection = new Connection("https://api.devnet.solana.com");
-const client = new LightconePinocchioClient(connection);
-
-// Fetch account state
-const exchange = await client.getExchange();
-const market = await client.getMarket(0n);
-console.log(`Market status: ${market.status}`);
-
-// Create a signed order
-const keypair = Keypair.generate();
-const nonce = await client.getNextNonce(keypair.publicKey);
-
-const order = client.signFullOrder(
-  client.createBidOrder({
-    nonce,
-    maker: keypair.publicKey,
-    market: client.pda.getMarketPda(0n, client.programId)[0],
-    baseMint: conditionalTokenMint,
-    quoteMint: usdcMint,
-    makerAmount: 1_000_000n, // 1 USDC
-    takerAmount: 500_000n,   // 0.5 outcome tokens
-    expiration: 0n,
-  }),
-  keypair
-);
-```
-
-### WebSocket
-
-Stream real-time orderbook updates, trades, and user events.
-
-```typescript
-import { websocket } from "@lightcone/sdk";
-
-const client = await websocket.LightconeWebSocketClient.connectDefault();
-
-// Subscribe to orderbook updates
-client.subscribeBookUpdates(["market:orderbook"]);
-
-// Register event handler
-client.on((event) => {
-  if (event.type === "BookUpdate") {
-    const book = client.getOrderbook(event.orderbookId);
-    if (book) {
-      console.log(`Best bid: ${book.bestBid()}`);
-      console.log(`Best ask: ${book.bestAsk()}`);
-    }
-  } else if (event.type === "Trade") {
-    console.log(`Trade: ${event.trade.size} @ ${event.trade.price}`);
-  } else if (event.type === "Disconnected") {
-    console.log(`Disconnected: ${event.reason}`);
-  }
-});
-```
-
-## Module Overview
-
-### Program Module
-
-Direct interaction with the Lightcone Solana program:
-
-- **Account Types**: Exchange, Market, Position, OrderStatus, UserNonce
-- **Transaction Builders**: All 14 instructions (mint, merge, match, settle, etc.)
-- **PDA Derivation**: 8 PDA functions with seeds
-- **Order Types**: FullOrder (225 bytes), CompactOrder (65 bytes)
-- **Ed25519 Verification**: Three strategies (individual, batch, cross-reference)
-
-```typescript
-import {
-  LightconePinocchioClient,
-  createBidOrder,
-  signOrderFull,
-  hashOrder,
-} from "@lightcone/sdk";
-
-// Create and sign an order
-const order = signOrderFull(
-  createBidOrder({
-    nonce: 1n,
-    maker: pubkey,
-    market: marketPda,
-    baseMint: yesToken,
-    quoteMint: noToken,
-    makerAmount: 100_000n,
-    takerAmount: 50_000n,
-    expiration: 0n,
-  }),
-  keypair
-);
-const orderHash = hashOrder(order);
-```
-
-### API Module
-
-REST API client with typed requests and responses:
-
-- **Markets**: getMarkets, getMarket, getMarketBySlug
-- **Orderbooks**: getOrderbook with depth parameter
-- **Orders**: submitOrder, cancelOrder, cancelAllOrders
-- **Positions**: getUserPositions, getUserMarketPositions
-- **Trades**: getTrades with filters
-- **Price History**: getPriceHistory with OHLCV
+## Quick Start
 
 ```typescript
-import { api } from "@lightcone/sdk";
-
-const client = new api.LightconeApiClient();
-const response = await client.submitOrder({
-  maker: "pubkey",
-  nonce: 1,
-  market_pubkey: "market",
-  base_token: "base",
-  quote_token: "quote",
-  side: 0, // BID
-  maker_amount: 1000000,
-  taker_amount: 500000,
-  expiration: 0,
-  signature: "hex_signature",
-  orderbook_id: "orderbook",
-});
-```
-
-### WebSocket Module
-
-Real-time streaming with automatic state management:
+import { LightconeClient, Resolution } from "@lightconexyz/lightcone-sdk";
 
-- **Subscriptions**: book_updates, trades, user, price_history, market
-- **State Management**: LocalOrderbook, UserState, PriceHistory
-- **Authentication**: Ed25519 sign-in for user streams
-- **Auto-Reconnect**: Configurable reconnection with exponential backoff and jitter
+const client = LightconeClient.builder()
+  .baseUrl("https://tapi.lightcone.xyz")
+  .wsUrl("wss://tws.lightcone.xyz/ws")
+  .build();
 
-```typescript
-import { websocket } from "@lightcone/sdk";
-import { Keypair } from "@solana/web3.js";
-
-// Authenticated connection for user streams
-const keypair = Keypair.generate();
-const client = await websocket.LightconeWebSocketClient.connectAuthenticated(keypair);
-client.subscribeUser(keypair.publicKey.toBase58());
-
-// Access maintained state
-const state = client.getUserState(keypair.publicKey.toBase58());
-if (state) {
-  console.log(`Open orders: ${state.orderCount()}`);
-}
+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);
 ```
 
-### Shared Module
-
-Common utilities used across modules:
+## Main Entry Points
 
-- **Resolution**: Candle intervals (1m, 5m, 15m, 1h, 4h, 1d)
-- **Constants**: Program IDs, seeds, discriminators, sizes
-- **Types**: MarketStatus, OrderSide, account data interfaces
+- `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
 
-```typescript
-import { Resolution, PROGRAM_ID } from "@lightcone/sdk";
-
-const res = Resolution.OneHour; // "1h"
-console.log(res); // "1h"
-```
+## Program Module
 
-## Features
+`program/` remains the on-chain toolkit (PDAs, instructions, account deserialization, order utilities), with v2 envelope builders now exposed:
 
-- **Full TypeScript support**: Comprehensive types for all APIs
-- **Zero-copy serialization**: Efficient binary order formats
-- **Cross-instruction Ed25519**: Optimized transaction sizes
-- **Automatic reconnection**: Jittered exponential backoff
-- **State management**: Local orderbook and user state tracking
+- `LimitOrderEnvelope`
+- `TriggerOrderEnvelope`
 
-## Program ID
+## Notes
 
-**Mainnet/Devnet**: `EfRvELrn4b5aJRwddD1VUrqzsfm1pewBLPebq3iMPDp2`
+- 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
 

package/dist/auth/client.d.ts

@@ -0,0 +1,25 @@
+import { type LightconeHttp } from "../http";
+import type { AuthCredentials, User } from "./index";
+interface AuthState {
+    getCredentials(): AuthCredentials | undefined;
+    setCredentials(credentials: AuthCredentials | undefined): void;
+    clearCaches(): Promise<void>;
+}
+interface ClientContext {
+    http: LightconeHttp;
+    authState: AuthState;
+}
+export declare class Auth {
+    private readonly client;
+    constructor(client: ClientContext);
+    getNonce(): Promise<string>;
+    loginWithMessage(message: string, signatureBs58: string, pubkeyBytes: Uint8Array, useEmbeddedWallet?: boolean): Promise<User>;
+    checkSession(): Promise<User>;
+    logout(): Promise<void>;
+    disconnectX(): Promise<void>;
+    connectX(xUserId: string, xUsername: string, xDisplayName?: string): Promise<void>;
+    credentials(): AuthCredentials | undefined;
+    isAuthenticated(): boolean;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/auth/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/auth/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAE1D,OAAO,KAAK,EAAE,eAAe,EAA0D,IAAI,EAAE,MAAM,SAAS,CAAC;AAE7G,UAAU,SAAS;IACjB,cAAc,IAAI,eAAe,GAAG,SAAS,CAAC;IAC9C,cAAc,CAAC,WAAW,EAAE,eAAe,GAAG,SAAS,GAAG,IAAI,CAAC;IAC/D,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,qBAAa,IAAI;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAE5C,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAM3B,gBAAgB,CACpB,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,UAAU,EACvB,iBAAiB,CAAC,EAAE,OAAO,GAC1B,OAAO,CAAC,IAAI,CAAC;IA2CV,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B7B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAavB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;IAahB,WAAW,IAAI,eAAe,GAAG,SAAS;IAI1C,eAAe,IAAI,OAAO;CAO3B"}

package/dist/auth/client.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Auth = void 0;
+const error_1 = require("../error");
+const http_1 = require("../http");
+const shared_1 = require("../shared");
+class Auth {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async getNonce() {
+        const url = `${this.client.http.baseUrl()}/api/auth/nonce`;
+        const response = await this.client.http.get(url, http_1.RetryPolicy.None);
+        return response.nonce;
+    }
+    async loginWithMessage(message, signatureBs58, pubkeyBytes, useEmbeddedWallet) {
+        const url = `${this.client.http.baseUrl()}/api/auth/login_or_register_with_message`;
+        const body = {
+            message,
+            signature_bs58: signatureBs58,
+            pubkey_bytes: Array.from(pubkeyBytes),
+            use_embedded_wallet: useEmbeddedWallet,
+        };
+        let response;
+        try {
+            response = await this.client.http.post(url, body, http_1.RetryPolicy.None);
+        }
+        catch (error) {
+            throw error_1.SdkError.from(new error_1.AuthError("LoginFailed", error instanceof Error ? error.message : String(error)));
+        }
+        if (response.token) {
+            await this.client.http.setAuthToken(response.token);
+        }
+        const credentials = {
+            user_id: response.user_id,
+            wallet_address: (0, shared_1.asPubkeyStr)(response.wallet_address),
+            expires_at: parseExpiry(response.expires_at),
+        };
+        this.client.authState.setCredentials(credentials);
+        return {
+            id: response.user_id,
+            wallet_address: response.wallet_address,
+            linked_account: response.linked_account,
+            privy_id: response.privy_id,
+            embedded_wallet: response.embedded_wallet,
+            x_username: response.x_username,
+            x_user_id: response.x_user_id,
+            x_display_name: response.x_display_name,
+        };
+    }
+    async checkSession() {
+        const url = `${this.client.http.baseUrl()}/api/auth/me`;
+        let response;
+        try {
+            response = await this.client.http.get(url, http_1.RetryPolicy.Idempotent);
+        }
+        catch (error) {
+            this.client.authState.setCredentials(undefined);
+            throw error_1.SdkError.from(error);
+        }
+        this.client.authState.setCredentials({
+            user_id: response.user_id,
+            wallet_address: (0, shared_1.asPubkeyStr)(response.wallet_address),
+            expires_at: parseExpiry(response.expires_at),
+        });
+        return {
+            id: response.user_id,
+            wallet_address: response.wallet_address,
+            linked_account: response.linked_account,
+            privy_id: response.privy_id,
+            embedded_wallet: response.embedded_wallet,
+            x_username: response.x_username,
+            x_user_id: response.x_user_id,
+            x_display_name: response.x_display_name,
+        };
+    }
+    async logout() {
+        const url = `${this.client.http.baseUrl()}/api/auth/logout`;
+        try {
+            await this.client.http.post(url, {}, http_1.RetryPolicy.None);
+        }
+        catch {
+            // Backend cookie clear can fail in local/dev setups; still clear local state.
+        }
+        await this.client.http.clearAuthToken();
+        this.client.authState.setCredentials(undefined);
+        await this.client.authState.clearCaches();
+    }
+    async disconnectX() {
+        const url = `${this.client.http.baseUrl()}/api/auth/disconnect_x`;
+        await this.client.http.post(url, {}, http_1.RetryPolicy.None);
+    }
+    async connectX(xUserId, xUsername, xDisplayName) {
+        const url = `${this.client.http.baseUrl()}/api/auth/connect_x`;
+        await this.client.http.post(url, {
+            x_user_id: xUserId,
+            x_username: xUsername,
+            x_display_name: xDisplayName,
+        }, http_1.RetryPolicy.None);
+    }
+    credentials() {
+        return this.client.authState.getCredentials();
+    }
+    isAuthenticated() {
+        const credentials = this.credentials();
+        if (!credentials) {
+            return false;
+        }
+        return Date.now() < credentials.expires_at.getTime();
+    }
+}
+exports.Auth = Auth;
+function parseExpiry(timestamp) {
+    if (timestamp > 1_000_000_000_000) {
+        return new Date(timestamp);
+    }
+    return new Date(timestamp * 1000);
+}
+//# sourceMappingURL=client.js.map

package/dist/auth/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/auth/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { AuthError, SdkError } from \"../error\";\nimport { RetryPolicy, type LightconeHttp } from \"../http\";\nimport { asPubkeyStr } from \"../shared\";\nimport type { AuthCredentials, LoginRequest, LoginResponse, MeResponse, NonceResponse, User } from \"./index\";\n\ninterface AuthState {\n  getCredentials(): AuthCredentials | undefined;\n  setCredentials(credentials: AuthCredentials | undefined): void;\n  clearCaches(): Promise<void>;\n}\n\ninterface ClientContext {\n  http: LightconeHttp;\n  authState: AuthState;\n}\n\nexport class Auth {\n  constructor(private readonly client: ClientContext) {}\n\n  async getNonce(): Promise<string> {\n    const url = `${this.client.http.baseUrl()}/api/auth/nonce`;\n    const response = await this.client.http.get<NonceResponse>(url, RetryPolicy.None);\n    return response.nonce;\n  }\n\n  async loginWithMessage(\n    message: string,\n    signatureBs58: string,\n    pubkeyBytes: Uint8Array,\n    useEmbeddedWallet?: boolean\n  ): Promise<User> {\n    const url = `${this.client.http.baseUrl()}/api/auth/login_or_register_with_message`;\n    const body: LoginRequest = {\n      message,\n      signature_bs58: signatureBs58,\n      pubkey_bytes: Array.from(pubkeyBytes),\n      use_embedded_wallet: useEmbeddedWallet,\n    };\n\n    let response: LoginResponse;\n    try {\n      response = await this.client.http.post<LoginResponse, LoginRequest>(\n        url,\n        body,\n        RetryPolicy.None\n      );\n    } catch (error) {\n      throw SdkError.from(new AuthError(\"LoginFailed\", error instanceof Error ? error.message : String(error)));\n    }\n\n    if (response.token) {\n      await this.client.http.setAuthToken(response.token);\n    }\n\n    const credentials: AuthCredentials = {\n      user_id: response.user_id,\n      wallet_address: asPubkeyStr(response.wallet_address),\n      expires_at: parseExpiry(response.expires_at),\n    };\n    this.client.authState.setCredentials(credentials);\n\n    return {\n      id: response.user_id,\n      wallet_address: response.wallet_address,\n      linked_account: response.linked_account,\n      privy_id: response.privy_id,\n      embedded_wallet: response.embedded_wallet,\n      x_username: response.x_username,\n      x_user_id: response.x_user_id,\n      x_display_name: response.x_display_name,\n    };\n  }\n\n  async checkSession(): Promise<User> {\n    const url = `${this.client.http.baseUrl()}/api/auth/me`;\n\n    let response: MeResponse;\n    try {\n      response = await this.client.http.get<MeResponse>(url, RetryPolicy.Idempotent);\n    } catch (error) {\n      this.client.authState.setCredentials(undefined);\n      throw SdkError.from(error);\n    }\n\n    this.client.authState.setCredentials({\n      user_id: response.user_id,\n      wallet_address: asPubkeyStr(response.wallet_address),\n      expires_at: parseExpiry(response.expires_at),\n    });\n\n    return {\n      id: response.user_id,\n      wallet_address: response.wallet_address,\n      linked_account: response.linked_account,\n      privy_id: response.privy_id,\n      embedded_wallet: response.embedded_wallet,\n      x_username: response.x_username,\n      x_user_id: response.x_user_id,\n      x_display_name: response.x_display_name,\n    };\n  }\n\n  async logout(): Promise<void> {\n    const url = `${this.client.http.baseUrl()}/api/auth/logout`;\n    try {\n      await this.client.http.post<unknown, Record<string, never>>(url, {}, RetryPolicy.None);\n    } catch {\n      // Backend cookie clear can fail in local/dev setups; still clear local state.\n    }\n\n    await this.client.http.clearAuthToken();\n    this.client.authState.setCredentials(undefined);\n    await this.client.authState.clearCaches();\n  }\n\n  async disconnectX(): Promise<void> {\n    const url = `${this.client.http.baseUrl()}/api/auth/disconnect_x`;\n    await this.client.http.post<unknown, Record<string, never>>(url, {}, RetryPolicy.None);\n  }\n\n  async connectX(\n    xUserId: string,\n    xUsername: string,\n    xDisplayName?: string\n  ): Promise<void> {\n    const url = `${this.client.http.baseUrl()}/api/auth/connect_x`;\n    await this.client.http.post<unknown, { x_user_id: string; x_username: string; x_display_name?: string }>(\n      url,\n      {\n        x_user_id: xUserId,\n        x_username: xUsername,\n        x_display_name: xDisplayName,\n      },\n      RetryPolicy.None\n    );\n  }\n\n  credentials(): AuthCredentials | undefined {\n    return this.client.authState.getCredentials();\n  }\n\n  isAuthenticated(): boolean {\n    const credentials = this.credentials();\n    if (!credentials) {\n      return false;\n    }\n    return Date.now() < credentials.expires_at.getTime();\n  }\n}\n\nfunction parseExpiry(timestamp: number): Date {\n  if (timestamp > 1_000_000_000_000) {\n    return new Date(timestamp);\n  }\n  return new Date(timestamp * 1000);\n}\n"]}

package/dist/auth/index.d.ts

@@ -0,0 +1,73 @@
+import type { PubkeyStr } from "../shared";
+export * from "./client";
+export * from "./native";
+export interface User {
+    id: string;
+    wallet_address: string;
+    linked_account: LinkedAccount;
+    privy_id?: string;
+    embedded_wallet?: EmbeddedWallet;
+    x_username?: string;
+    x_user_id?: string;
+    x_display_name?: string;
+}
+export interface LinkedAccount {
+    id: string;
+    type: LinkedAccountType;
+    chain?: ChainType;
+    address: string;
+}
+export declare enum LinkedAccountType {
+    Wallet = "wallet",
+    TwitterOauth = "twitter_oauth",
+    GoogleOauth = "google_oauth"
+}
+export declare enum ChainType {
+    Solana = "solana",
+    Ethereum = "ethereum"
+}
+export interface EmbeddedWallet {
+    privy_id: string;
+    chain: ChainType;
+    address: string;
+}
+export interface AuthCredentials {
+    user_id: string;
+    wallet_address: PubkeyStr;
+    expires_at: Date;
+}
+export declare function isAuthenticated(credentials?: AuthCredentials): boolean;
+export declare function generateSigninMessage(nonce: string): Uint8Array;
+export interface LoginRequest {
+    message: string;
+    signature_bs58: string;
+    pubkey_bytes: number[];
+    use_embedded_wallet?: boolean;
+}
+export interface LoginResponse {
+    token: string;
+    user_id: string;
+    wallet_address: string;
+    expires_at: number;
+    linked_account: LinkedAccount;
+    privy_id?: string;
+    embedded_wallet?: EmbeddedWallet;
+    x_username?: string;
+    x_user_id?: string;
+    x_display_name?: string;
+}
+export interface MeResponse {
+    user_id: string;
+    wallet_address: string;
+    linked_account: LinkedAccount;
+    privy_id?: string;
+    embedded_wallet?: EmbeddedWallet;
+    x_username?: string;
+    x_user_id?: string;
+    x_display_name?: string;
+    expires_at: number;
+}
+export interface NonceResponse {
+    nonce: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AAEzB,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oBAAY,iBAAiB;IAC3B,MAAM,WAAW;IACjB,YAAY,kBAAkB;IAC9B,WAAW,iBAAiB;CAC7B;AAED,oBAAY,SAAS;IACnB,MAAM,WAAW;IACjB,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,SAAS,CAAC;IAC1B,UAAU,EAAE,IAAI,CAAC;CAClB;AAED,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,eAAe,GAAG,OAAO,CAKtE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAE/D;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/auth/index.js

@@ -0,0 +1,42 @@
+"use strict";
+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 __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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChainType = exports.LinkedAccountType = void 0;
+exports.isAuthenticated = isAuthenticated;
+exports.generateSigninMessage = generateSigninMessage;
+__exportStar(require("./client"), exports);
+__exportStar(require("./native"), exports);
+var LinkedAccountType;
+(function (LinkedAccountType) {
+    LinkedAccountType["Wallet"] = "wallet";
+    LinkedAccountType["TwitterOauth"] = "twitter_oauth";
+    LinkedAccountType["GoogleOauth"] = "google_oauth";
+})(LinkedAccountType || (exports.LinkedAccountType = LinkedAccountType = {}));
+var ChainType;
+(function (ChainType) {
+    ChainType["Solana"] = "solana";
+    ChainType["Ethereum"] = "ethereum";
+})(ChainType || (exports.ChainType = ChainType = {}));
+function isAuthenticated(credentials) {
+    if (!credentials) {
+        return false;
+    }
+    return Date.now() < credentials.expires_at.getTime();
+}
+function generateSigninMessage(nonce) {
+    return new TextEncoder().encode(`Sign in to Lightcone\nNonce: ${nonce}`);
+}
+//# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AA8CA,0CAKC;AAED,sDAEC;AArDD,2CAAyB;AACzB,2CAAyB;AAoBzB,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IAC3B,sCAAiB,CAAA;IACjB,mDAA8B,CAAA;IAC9B,iDAA4B,CAAA;AAC9B,CAAC,EAJW,iBAAiB,iCAAjB,iBAAiB,QAI5B;AAED,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,8BAAiB,CAAA;IACjB,kCAAqB,CAAA;AACvB,CAAC,EAHW,SAAS,yBAAT,SAAS,QAGpB;AAcD,SAAgB,eAAe,CAAC,WAA6B;IAC3D,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;AACvD,CAAC;AAED,SAAgB,qBAAqB,CAAC,KAAa;IACjD,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;AAC3E,CAAC","sourcesContent":["import type { PubkeyStr } from \"../shared\";\n\nexport * from \"./client\";\nexport * from \"./native\";\n\nexport interface User {\n  id: string;\n  wallet_address: string;\n  linked_account: LinkedAccount;\n  privy_id?: string;\n  embedded_wallet?: EmbeddedWallet;\n  x_username?: string;\n  x_user_id?: string;\n  x_display_name?: string;\n}\n\nexport interface LinkedAccount {\n  id: string;\n  type: LinkedAccountType;\n  chain?: ChainType;\n  address: string;\n}\n\nexport enum LinkedAccountType {\n  Wallet = \"wallet\",\n  TwitterOauth = \"twitter_oauth\",\n  GoogleOauth = \"google_oauth\",\n}\n\nexport enum ChainType {\n  Solana = \"solana\",\n  Ethereum = \"ethereum\",\n}\n\nexport interface EmbeddedWallet {\n  privy_id: string;\n  chain: ChainType;\n  address: string;\n}\n\nexport interface AuthCredentials {\n  user_id: string;\n  wallet_address: PubkeyStr;\n  expires_at: Date;\n}\n\nexport function isAuthenticated(credentials?: AuthCredentials): boolean {\n  if (!credentials) {\n    return false;\n  }\n  return Date.now() < credentials.expires_at.getTime();\n}\n\nexport function generateSigninMessage(nonce: string): Uint8Array {\n  return new TextEncoder().encode(`Sign in to Lightcone\\nNonce: ${nonce}`);\n}\n\nexport interface LoginRequest {\n  message: string;\n  signature_bs58: string;\n  pubkey_bytes: number[];\n  use_embedded_wallet?: boolean;\n}\n\nexport interface LoginResponse {\n  token: string;\n  user_id: string;\n  wallet_address: string;\n  expires_at: number;\n  linked_account: LinkedAccount;\n  privy_id?: string;\n  embedded_wallet?: EmbeddedWallet;\n  x_username?: string;\n  x_user_id?: string;\n  x_display_name?: string;\n}\n\nexport interface MeResponse {\n  user_id: string;\n  wallet_address: string;\n  linked_account: LinkedAccount;\n  privy_id?: string;\n  embedded_wallet?: EmbeddedWallet;\n  x_username?: string;\n  x_user_id?: string;\n  x_display_name?: string;\n  expires_at: number;\n}\n\nexport interface NonceResponse {\n  nonce: string;\n}\n"]}

package/dist/auth/native.d.ts

@@ -0,0 +1,8 @@
+import { Keypair } from "@solana/web3.js";
+export interface SignedLogin {
+    message: string;
+    signature_bs58: string;
+    pubkey_bytes: Uint8Array;
+}
+export declare function signLoginMessage(keypair: Keypair, nonce: string): SignedLogin;
+//# sourceMappingURL=native.d.ts.map

package/dist/auth/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../src/auth/native.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAK1C,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,UAAU,CAAC;CAC1B;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAS7E"}

package/dist/auth/native.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signLoginMessage = signLoginMessage;
+const bs58_1 = __importDefault(require("bs58"));
+const tweetnacl_1 = __importDefault(require("tweetnacl"));
+const index_1 = require("./index");
+function signLoginMessage(keypair, nonce) {
+    const messageBytes = (0, index_1.generateSigninMessage)(nonce);
+    const signature = tweetnacl_1.default.sign.detached(messageBytes, keypair.secretKey);
+    return {
+        message: new TextDecoder().decode(messageBytes),
+        signature_bs58: bs58_1.default.encode(signature),
+        pubkey_bytes: keypair.publicKey.toBytes(),
+    };
+}
+//# sourceMappingURL=native.js.map

package/dist/auth/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../../src/auth/native.ts"],"names":[],"mappings":";;;;;AAWA,4CASC;AAnBD,gDAAwB;AACxB,0DAA6B;AAC7B,mCAAgD;AAQhD,SAAgB,gBAAgB,CAAC,OAAgB,EAAE,KAAa;IAC9D,MAAM,YAAY,GAAG,IAAA,6BAAqB,EAAC,KAAK,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,mBAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAEtE,OAAO;QACL,OAAO,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC;QAC/C,cAAc,EAAE,cAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QACtC,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE;KAC1C,CAAC;AACJ,CAAC","sourcesContent":["import { Keypair } from \"@solana/web3.js\";\nimport bs58 from \"bs58\";\nimport nacl from \"tweetnacl\";\nimport { generateSigninMessage } from \"./index\";\n\nexport interface SignedLogin {\n  message: string;\n  signature_bs58: string;\n  pubkey_bytes: Uint8Array;\n}\n\nexport function signLoginMessage(keypair: Keypair, nonce: string): SignedLogin {\n  const messageBytes = generateSigninMessage(nonce);\n  const signature = nacl.sign.detached(messageBytes, keypair.secretKey);\n\n  return {\n    message: new TextDecoder().decode(messageBytes),\n    signature_bs58: bs58.encode(signature),\n    pubkey_bytes: keypair.publicKey.toBytes(),\n  };\n}\n"]}