@lightconexyz/lightcone-sdk 0.6.1 → 0.7.1

package/README.md

@@ -218,7 +218,7 @@ Authentication is only required for user-specific endpoints. Authentication is s
 
 ### Cookie handling
 
-After login succeeds, the SDK stores the session token internally and attaches it as `Cookie: auth_token=…` on every authenticated request. Behaviour depends on the runtime:
+After login succeeds, the SDK stores the session token internally and attaches it as `Cookie: lightcone-token=…` on every authenticated request. Behaviour depends on the runtime:
 
 - **Node / non-browser**: token is stored on the `LightconeHttp` instance and added as a `Cookie` header per request.
 - **Browser**: requests use `credentials: "include"` and the runtime supplies the cookie automatically — the SDK's internal store is unused.
@@ -288,7 +288,7 @@ All examples are runnable with `npx tsx examples/<name>.ts`. Examples default to
 |---------|-------------|
 | [`markets`](examples/markets.ts) | Featured markets, paginated listing, fetch by pubkey, search, platform deposit assets via `globalDepositAssets()` |
 | [`orderbook`](examples/orderbook.ts) | Fetch orderbook depth (bids/asks) and decimal precision metadata |
-| [`trades`](examples/trades.ts) | Recent trade history with cursor-based pagination |
+| [`trades`](examples/trades.ts) | Recent trade history with cursor-based pagination (per-orderbook and market-wide) |
 | [`price_history`](examples/price_history.ts) | Historical candlestick data (OHLCV) at various resolutions |
 | [`positions`](examples/positions.ts) | User positions across all markets and per-market |
 
@@ -417,3 +417,7 @@ The SDK generates a UUID v4 `x-request-id` header on every HTTP request. On reje
 - **GET requests**: `RetryPolicy.Idempotent` - retries on transport failures and 502/503/504, backs off on 429 with exponential backoff + jitter.
 - **POST requests** (order submit, cancel, auth): `RetryPolicy.None` - no automatic retry. Non-idempotent actions are never retried to prevent duplicate side effects.
 - Customizable per-call with `RetryPolicy.custom(config)`.
+
+## Trigger Orders
+
+Trigger orders (stop-limit, take-profit-limit) are under development and not yet available. Internal types exist in the source for internal use only.

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

@@ -1 +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;IAmCV,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B7B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAavB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC,WAAW,IAAI,MAAM;IAIrB,WAAW,IAAI,eAAe,GAAG,SAAS;IAI1C,eAAe,IAAI,OAAO;CAO3B"}
+{"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;IAoCV,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IA+B7B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAavB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC,WAAW,IAAI,MAAM;IAIrB,WAAW,IAAI,eAAe,GAAG,SAAS;IAI1C,eAAe,IAAI,OAAO;CAO3B"}

package/dist/auth/client.js

@@ -39,6 +39,7 @@ class Auth {
             x_user_id: response.x_user_id,
             x_display_name: response.x_display_name,
             google_email: response.google_email,
+            auth_method: response.auth_method,
         };
     }
     async checkSession() {
@@ -66,6 +67,7 @@ class Auth {
             x_user_id: response.x_user_id,
             x_display_name: response.x_display_name,
             google_email: response.google_email,
+            auth_method: response.auth_method,
         };
     }
     async logout() {

package/dist/auth/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/auth/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { 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    const response = await this.client.http.post<LoginResponse, LoginRequest>(\n      url,\n      body,\n      RetryPolicy.None\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      google_email: response.google_email,\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      google_email: response.google_email,\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<{ success: boolean }, 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<{ success: boolean }, Record<string, never>>(url, {}, RetryPolicy.None);\n  }\n\n  connectXUrl(): string {\n    return `${this.client.http.baseUrl()}/api/auth/oauth/link/x`;\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"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/auth/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { 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    const response = await this.client.http.post<LoginResponse, LoginRequest>(\n      url,\n      body,\n      RetryPolicy.None\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      google_email: response.google_email,\n      auth_method: response.auth_method,\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      google_email: response.google_email,\n      auth_method: response.auth_method,\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<{ success: boolean }, 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<{ success: boolean }, Record<string, never>>(url, {}, RetryPolicy.None);\n  }\n\n  connectXUrl(): string {\n    return `${this.client.http.baseUrl()}/api/auth/oauth/link/x`;\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

@@ -11,6 +11,19 @@ export interface User {
     x_user_id?: string;
     x_display_name?: string;
     google_email?: string;
+    /**
+     * How this session authenticated. `Privy` ⇒ the embedded wallet is the
+     * trading identity; `Lightcone` ⇒ self-custody session, the linked wallet is.
+     */
+    auth_method: AuthMethod;
+}
+/**
+ * How a session authenticated, as reported by the backend (derived from which
+ * token verified the request).
+ */
+export declare enum AuthMethod {
+    Privy = "privy",
+    Lightcone = "lightcone"
 }
 export interface LinkedAccount {
     id: string;
@@ -56,6 +69,7 @@ export interface LoginResponse {
     x_user_id?: string;
     x_display_name?: string;
     google_email?: string;
+    auth_method: AuthMethod;
 }
 export interface MeResponse {
     user_id: string;
@@ -68,6 +82,7 @@ export interface MeResponse {
     x_display_name?: string;
     google_email?: string;
     expires_at: number;
+    auth_method: AuthMethod;
 }
 export interface NonceResponse {
     nonce: string;

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

@@ -1 +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;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;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,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;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;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,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf"}
+{"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;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,WAAW,EAAE,UAAU,CAAC;CACzB;AAED;;;GAGG;AACH,oBAAY,UAAU;IACpB,KAAK,UAAU;IACf,SAAS,cAAc;CACxB;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,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;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,UAAU,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,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/auth/index.js

@@ -14,11 +14,20 @@ 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.ChainType = exports.LinkedAccountType = exports.AuthMethod = void 0;
 exports.isAuthenticated = isAuthenticated;
 exports.generateSigninMessage = generateSigninMessage;
 __exportStar(require("./client"), exports);
 __exportStar(require("./native"), exports);
+/**
+ * How a session authenticated, as reported by the backend (derived from which
+ * token verified the request).
+ */
+var AuthMethod;
+(function (AuthMethod) {
+    AuthMethod["Privy"] = "privy";
+    AuthMethod["Lightcone"] = "lightcone";
+})(AuthMethod || (exports.AuthMethod = AuthMethod = {}));
 var LinkedAccountType;
 (function (LinkedAccountType) {
     LinkedAccountType["Wallet"] = "wallet";

package/dist/auth/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AA+CA,0CAKC;AAED,sDAEC;AAtDD,2CAAyB;AACzB,2CAAyB;AAqBzB,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  google_email?: 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  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  google_email?: 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  google_email?: string;\n  expires_at: number;\n}\n\nexport interface NonceResponse {\n  nonce: string;\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AA6DA,0CAKC;AAED,sDAEC;AApED,2CAAyB;AACzB,2CAAyB;AAmBzB;;;GAGG;AACH,IAAY,UAGX;AAHD,WAAY,UAAU;IACpB,6BAAe,CAAA;IACf,qCAAuB,CAAA;AACzB,CAAC,EAHW,UAAU,0BAAV,UAAU,QAGrB;AASD,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  google_email?: string;\n  /**\n   * How this session authenticated. `Privy` ⇒ the embedded wallet is the\n   * trading identity; `Lightcone` ⇒ self-custody session, the linked wallet is.\n   */\n  auth_method: AuthMethod;\n}\n\n/**\n * How a session authenticated, as reported by the backend (derived from which\n * token verified the request).\n */\nexport enum AuthMethod {\n  Privy = \"privy\",\n  Lightcone = \"lightcone\",\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  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  google_email?: string;\n  auth_method: AuthMethod;\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  google_email?: string;\n  expires_at: number;\n  auth_method: AuthMethod;\n}\n\nexport interface NonceResponse {\n  nonce: string;\n}\n"]}

package/dist/client.d.ts

@@ -16,6 +16,7 @@ import { LightconeHttp } from "./http";
 import { LightconeEnv } from "./env";
 import { Privy } from "./privy";
 import { Rpc } from "./rpc";
+import { RpcFailoverState } from "./rpcFailover";
 import { DepositSource, type PubkeyStr } from "./shared";
 import { type ExternalSigner, type SigningStrategy } from "./shared/signing";
 import { WsClient, type WsConfig } from "./ws";
@@ -29,17 +30,23 @@ declare class AuthState {
 export declare class LightconeClient implements ClientContext {
     readonly http: LightconeHttp;
     readonly programId: PublicKey;
-    readonly connection?: Connection;
+    readonly primaryConnection?: Connection;
+    readonly backupConnection?: Connection;
+    readonly rpcFailoverState: RpcFailoverState;
     private depositSourceValue;
     private signingStrategyValue?;
     private orderNonceValue;
     private readonly wsConfigValue;
     private readonly authStateStore;
+    /** @deprecated Use primaryConnection — kept for ClientContext compat. */
+    get connection(): Connection | undefined;
     constructor(params: {
         http: LightconeHttp;
         wsConfig: WsConfig;
         programId?: PublicKey;
-        connection?: Connection;
+        primaryConnection?: Connection;
+        backupConnection?: Connection;
+        rpcFailoverState?: RpcFailoverState;
         depositSource?: DepositSource;
         signingStrategy?: SigningStrategy;
         orderNonce?: number;
@@ -55,16 +62,16 @@ export declare class LightconeClient implements ClientContext {
     setOrderNonce(nonce: number): void;
     clearOrderNonce(): void;
     /**
-     * Get the current `auth_token` cookie value, if any. Populated by the SDK
+     * Get the current `lightcone-token` cookie value, if any. Populated by the SDK
      * after a successful login, then attached on every authed request. Useful
-     * for forwarding the token through the `*WithAuth` methods, or
+     * for forwarding the token through the `*WithCookies` methods, or
      * persisting the session across processes.
      */
     authToken(): Promise<string | undefined>;
     /**
-     * Clear the cached `auth_token`. Subsequent authed calls will go out
+     * Clear the cached `lightcone-token`. Subsequent authed calls will go out
      * without a `Cookie` header (and 401) unless they use a
-     * `*WithAuth` variant.
+     * `*WithCookies` variant.
      */
     clearAuthToken(): Promise<void>;
     signAndSubmitTx(tx: Transaction): Promise<string>;
@@ -106,7 +113,8 @@ export declare class LightconeClientBuilder {
     private programIdValue;
     private depositSourceValue;
     private signingStrategyValue?;
-    private rpcUrlValue?;
+    private primaryRpcUrlValue?;
+    private backupRpcUrlValue?;
     /**
      * Set the deployment environment. Configures the API URL, WebSocket URL,
      * RPC URL, and program ID for the given environment.
@@ -127,6 +135,8 @@ export declare class LightconeClientBuilder {
     externalSigner(signer: ExternalSigner): LightconeClientBuilder;
     privyWalletId(walletId: string): LightconeClientBuilder;
     rpcUrl(url: string): LightconeClientBuilder;
+    /** Set a backup Solana RPC URL for automatic failover. */
+    backupRpcUrl(url: string): LightconeClientBuilder;
     build(): LightconeClient;
 }
 export {};

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -18,6 +18,7 @@ const http_1 = require("./http");
 const env_1 = require("./env");
 const privy_1 = require("./privy");
 const rpc_1 = require("./rpc");
+const rpcFailover_1 = require("./rpcFailover");
 const shared_1 = require("./shared");
 const ws_1 = require("./ws");
 class AuthState {
@@ -38,16 +39,25 @@ class AuthState {
 class LightconeClient {
     http;
     programId;
-    connection;
+    primaryConnection;
+    backupConnection;
+    rpcFailoverState;
     depositSourceValue;
     signingStrategyValue;
     orderNonceValue;
     wsConfigValue;
     authStateStore;
+    /** @deprecated Use primaryConnection — kept for ClientContext compat. */
+    get connection() {
+        return this.primaryConnection;
+    }
     constructor(params) {
         this.http = params.http;
         this.programId = params.programId ?? (0, env_1.programId)(env_1.LightconeEnv.Prod);
-        this.connection = params.connection;
+        this.primaryConnection = params.primaryConnection;
+        this.backupConnection = params.backupConnection;
+        this.rpcFailoverState =
+            params.rpcFailoverState ?? new rpcFailover_1.RpcFailoverState();
         this.depositSourceValue = params.depositSource ?? shared_1.DepositSource.Global;
         this.signingStrategyValue = params.signingStrategy;
         this.orderNonceValue = params.orderNonce;
@@ -85,18 +95,18 @@ class LightconeClient {
     }
     // ── Auth token (cookie) ─────────────────────────────────────────────
     /**
-     * Get the current `auth_token` cookie value, if any. Populated by the SDK
+     * Get the current `lightcone-token` cookie value, if any. Populated by the SDK
      * after a successful login, then attached on every authed request. Useful
-     * for forwarding the token through the `*WithAuth` methods, or
+     * for forwarding the token through the `*WithCookies` methods, or
      * persisting the session across processes.
      */
     async authToken() {
         return this.http.authTokenRef()();
     }
     /**
-     * Clear the cached `auth_token`. Subsequent authed calls will go out
+     * Clear the cached `lightcone-token`. Subsequent authed calls will go out
      * without a `Cookie` header (and 401) unless they use a
-     * `*WithAuth` variant.
+     * `*WithCookies` variant.
      */
     async clearAuthToken() {
         await this.http.clearAuthToken();
@@ -178,9 +188,13 @@ class LightconeClient {
             http: this.http,
             wsConfig: { ...this.wsConfigValue },
             programId: this.programId,
-            connection: this.connection
-                ? new web3_js_1.Connection(this.connection.rpcEndpoint)
+            primaryConnection: this.primaryConnection
+                ? new web3_js_1.Connection(this.primaryConnection.rpcEndpoint, { commitment: "confirmed" })
+                : undefined,
+            backupConnection: this.backupConnection
+                ? new web3_js_1.Connection(this.backupConnection.rpcEndpoint, { commitment: "confirmed" })
                 : undefined,
+            rpcFailoverState: this.rpcFailoverState,
             depositSource: this.depositSourceValue,
             signingStrategy: this.signingStrategyValue,
             orderNonce: this.orderNonceValue,
@@ -196,7 +210,8 @@ class LightconeClientBuilder {
     programIdValue = (0, env_1.programId)(env_1.LightconeEnv.Prod);
     depositSourceValue = shared_1.DepositSource.Global;
     signingStrategyValue;
-    rpcUrlValue = (0, env_1.rpcUrl)(env_1.LightconeEnv.Prod);
+    primaryRpcUrlValue = (0, env_1.rpcUrl)(env_1.LightconeEnv.Prod);
+    backupRpcUrlValue;
     /**
      * Set the deployment environment. Configures the API URL, WebSocket URL,
      * RPC URL, and program ID for the given environment.
@@ -208,7 +223,7 @@ class LightconeClientBuilder {
         this.baseUrlValue = (0, env_1.apiUrl)(environment);
         this.wsUrlValue = (0, env_1.wsUrl)(environment);
         this.programIdValue = (0, env_1.programId)(environment);
-        this.rpcUrlValue = (0, env_1.rpcUrl)(environment);
+        this.primaryRpcUrlValue = (0, env_1.rpcUrl)(environment);
         return this;
     }
     baseUrl(url) {
@@ -253,7 +268,12 @@ class LightconeClientBuilder {
         return this;
     }
     rpcUrl(url) {
-        this.rpcUrlValue = url;
+        this.primaryRpcUrlValue = url;
+        return this;
+    }
+    /** Set a backup Solana RPC URL for automatic failover. */
+    backupRpcUrl(url) {
+        this.backupRpcUrlValue = url;
         return this;
     }
     build() {
@@ -270,8 +290,11 @@ class LightconeClientBuilder {
             programId: this.programIdValue,
             depositSource: this.depositSourceValue,
             signingStrategy: this.signingStrategyValue,
-            connection: this.rpcUrlValue
-                ? new web3_js_1.Connection(this.rpcUrlValue)
+            primaryConnection: this.primaryRpcUrlValue
+                ? new web3_js_1.Connection(this.primaryRpcUrlValue, { commitment: "confirmed" })
+                : undefined,
+            backupConnection: this.backupRpcUrlValue
+                ? new web3_js_1.Connection(this.backupRpcUrlValue, { commitment: "confirmed" })
                 : undefined,
             authCredentials: this.authCredentials,
         });

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { Connection, Keypair, PublicKey, Transaction } from \"@solana/web3.js\";\nimport { Auth, type AuthCredentials } from \"./auth\";\nimport type { ClientContext } from \"./context\";\nimport { signAndSubmitTx as signAndSubmitTxFn } from \"./context\";\nimport { Admin } from \"./domain/admin\";\nimport type { FaucetRequest, FaucetResponse } from \"./domain/faucet\";\nimport { Markets } from \"./domain/market\";\nimport { Metrics } from \"./domain/metrics\";\nimport { Notifications } from \"./domain/notification\";\nimport { Orders } from \"./domain/order\";\nimport { Orderbooks } from \"./domain/orderbook\";\nimport { Positions } from \"./domain/position\";\nimport { PriceHistoryClient } from \"./domain/price_history\";\nimport { Referrals } from \"./domain/referral\";\nimport { Trades } from \"./domain/trade\";\nimport { LightconeHttp, RetryPolicy } from \"./http\";\nimport { LightconeEnv, apiUrl, wsUrl, rpcUrl, programId as envProgramId } from \"./env\";\nimport { Privy } from \"./privy\";\nimport { Rpc } from \"./rpc\";\nimport { DepositSource, type PubkeyStr } from \"./shared\";\nimport { type ExternalSigner, type SigningStrategy } from \"./shared/signing\";\nimport { WsClient, type WsConfig } from \"./ws\";\n\nclass AuthState {\n  private credentialsValue: AuthCredentials | undefined;\n\n  constructor(initial?: AuthCredentials) {\n    this.credentialsValue = initial;\n  }\n\n  getCredentials(): AuthCredentials | undefined {\n    return this.credentialsValue;\n  }\n\n  setCredentials(credentials: AuthCredentials | undefined): void {\n    this.credentialsValue = credentials;\n  }\n\n  async clearCaches(): Promise<void> {\n    // No caches to clear — decimals are derived locally from orderbook metadata.\n  }\n}\n\nexport class LightconeClient implements ClientContext {\n  readonly http: LightconeHttp;\n  readonly programId: PublicKey;\n  readonly connection?: Connection;\n  private depositSourceValue: DepositSource;\n  private signingStrategyValue?: SigningStrategy;\n  private orderNonceValue: number | undefined;\n  private readonly wsConfigValue: WsConfig;\n  private readonly authStateStore: AuthState;\n\n  constructor(params: {\n    http: LightconeHttp;\n    wsConfig: WsConfig;\n    programId?: PublicKey;\n    connection?: Connection;\n    depositSource?: DepositSource;\n    signingStrategy?: SigningStrategy;\n    orderNonce?: number;\n    authCredentials?: AuthCredentials;\n    authState?: AuthState;\n  }) {\n    this.http = params.http;\n    this.programId = params.programId ?? envProgramId(LightconeEnv.Prod);\n    this.connection = params.connection;\n    this.depositSourceValue = params.depositSource ?? DepositSource.Global;\n    this.signingStrategyValue = params.signingStrategy;\n    this.orderNonceValue = params.orderNonce;\n    this.wsConfigValue = params.wsConfig;\n    this.authStateStore =\n      params.authState ??\n      new AuthState(params.authCredentials);\n  }\n\n  // ── Deposit source ──────────────────────────────────────────────────\n\n  get depositSource(): DepositSource {\n    return this.depositSourceValue;\n  }\n\n  setDepositSource(source: DepositSource): void {\n    this.depositSourceValue = source;\n  }\n\n  // ── Signing strategy ────────────────────────────────────────────────\n\n  get signingStrategy(): SigningStrategy | undefined {\n    return this.signingStrategyValue;\n  }\n\n  setSigningStrategy(strategy: SigningStrategy): void {\n    this.signingStrategyValue = strategy;\n  }\n\n  clearSigningStrategy(): void {\n    this.signingStrategyValue = undefined;\n  }\n\n  // ── Nonce cache ──────────────────────────────────────────────────────\n\n  orderNonce(): number | undefined {\n    return this.orderNonceValue;\n  }\n\n  setOrderNonce(nonce: number): void {\n    this.orderNonceValue = nonce;\n  }\n\n  clearOrderNonce(): void {\n    this.orderNonceValue = undefined;\n  }\n\n  // ── Auth token (cookie) ─────────────────────────────────────────────\n\n  /**\n   * Get the current `auth_token` cookie value, if any. Populated by the SDK\n   * after a successful login, then attached on every authed request. Useful\n   * for forwarding the token through the `*WithAuth` methods, or\n   * persisting the session across processes.\n   */\n  async authToken(): Promise<string | undefined> {\n    return this.http.authTokenRef()();\n  }\n\n  /**\n   * Clear the cached `auth_token`. Subsequent authed calls will go out\n   * without a `Cookie` header (and 401) unless they use a\n   * `*WithAuth` variant.\n   */\n  async clearAuthToken(): Promise<void> {\n    await this.http.clearAuthToken();\n  }\n\n  // ── Transaction signing + submission ────────────────────────────────\n\n  async signAndSubmitTx(tx: Transaction): Promise<string> {\n    return signAndSubmitTxFn(this, tx);\n  }\n\n  static builder(): LightconeClientBuilder {\n    return new LightconeClientBuilder();\n  }\n\n  // ── Sub-client accessors ─────────────────────────────────────────────\n\n  markets(): Markets {\n    return new Markets(this);\n  }\n\n  orderbooks(): Orderbooks {\n    return new Orderbooks(this);\n  }\n\n  orders(): Orders {\n    return new Orders(this);\n  }\n\n  positions(): Positions {\n    return new Positions(this);\n  }\n\n  trades(): Trades {\n    return new Trades(this);\n  }\n\n  priceHistory(): PriceHistoryClient {\n    return new PriceHistoryClient(this);\n  }\n\n  notifications(): Notifications {\n    return new Notifications(this);\n  }\n\n  /**\n   * Metrics sub-client — platform / market / orderbook / category / deposit-token\n   * volume metrics, market leaderboard, and time-series history.\n   */\n  metrics(): Metrics {\n    return new Metrics(this);\n  }\n\n  /**\n   * Request testnet SOL and whitelisted deposit tokens for a wallet.\n   *\n   * Only active on environments whose backend has the faucet enabled (typically\n   * local and staging).\n   *\n   * `POST /api/claim`\n   */\n  async claim(walletAddress: PubkeyStr): Promise<FaucetResponse> {\n    const url = `${this.http.baseUrl()}/api/claim`;\n    return this.http.post<FaucetResponse, FaucetRequest>(\n      url,\n      { wallet_address: walletAddress },\n      RetryPolicy.None\n    );\n  }\n\n  admin(): Admin {\n    return new Admin(this);\n  }\n\n  auth(): Auth {\n    return new Auth({\n      http: this.http,\n      authState: this.authStateStore,\n    });\n  }\n\n  privy(): Privy {\n    return new Privy(this);\n  }\n\n  referrals(): Referrals {\n    return new Referrals(this);\n  }\n\n  rpc(): Rpc {\n    return new Rpc(this);\n  }\n\n  wsConfig(): WsConfig {\n    return this.wsConfigValue;\n  }\n\n  ws(): WsClient {\n    return new WsClient(this.wsConfigValue, this.http.authTokenRef());\n  }\n\n  clone(): LightconeClient {\n    return new LightconeClient({\n      http: this.http,\n      wsConfig: { ...this.wsConfigValue },\n      programId: this.programId,\n      connection: this.connection\n        ? new Connection(this.connection.rpcEndpoint)\n        : undefined,\n      depositSource: this.depositSourceValue,\n      signingStrategy: this.signingStrategyValue,\n      orderNonce: this.orderNonceValue,\n      authState: this.authStateStore,\n    });\n  }\n}\n\nexport class LightconeClientBuilder {\n  private baseUrlValue: string = apiUrl(LightconeEnv.Prod);\n  private wsUrlValue: string = wsUrl(LightconeEnv.Prod);\n  private authCredentials?: AuthCredentials;\n  private programIdValue: PublicKey = envProgramId(LightconeEnv.Prod);\n  private depositSourceValue: DepositSource = DepositSource.Global;\n  private signingStrategyValue?: SigningStrategy;\n  private rpcUrlValue?: string = rpcUrl(LightconeEnv.Prod);\n\n  /**\n   * Set the deployment environment. Configures the API URL, WebSocket URL,\n   * RPC URL, and program ID for the given environment.\n   *\n   * Individual URL overrides (e.g. `.baseUrl()`) take precedence when\n   * called **after** `.env()`.\n   */\n  env(environment: LightconeEnv): LightconeClientBuilder {\n    this.baseUrlValue = apiUrl(environment);\n    this.wsUrlValue = wsUrl(environment);\n    this.programIdValue = envProgramId(environment);\n    this.rpcUrlValue = rpcUrl(environment);\n    return this;\n  }\n\n  baseUrl(url: string): LightconeClientBuilder {\n    return this.withBaseUrl(url);\n  }\n\n  withBaseUrl(url: string): LightconeClientBuilder {\n    this.baseUrlValue = url;\n    return this;\n  }\n\n  wsUrl(url: string): LightconeClientBuilder {\n    return this.withWsUrl(url);\n  }\n\n  withWsUrl(url: string): LightconeClientBuilder {\n    this.wsUrlValue = url;\n    return this;\n  }\n\n  auth(credentials: AuthCredentials): LightconeClientBuilder {\n    return this.withAuth(credentials);\n  }\n\n  withAuth(credentials: AuthCredentials): LightconeClientBuilder {\n    this.authCredentials = credentials;\n    return this;\n  }\n\n  programId(id: PublicKey): LightconeClientBuilder {\n    this.programIdValue = id;\n    return this;\n  }\n\n  depositSource(source: DepositSource): LightconeClientBuilder {\n    this.depositSourceValue = source;\n    return this;\n  }\n\n  nativeSigner(keypair: Keypair): LightconeClientBuilder {\n    this.signingStrategyValue = { type: \"native\", keypair };\n    return this;\n  }\n\n  externalSigner(signer: ExternalSigner): LightconeClientBuilder {\n    this.signingStrategyValue = { type: \"walletAdapter\", signer };\n    return this;\n  }\n\n  privyWalletId(walletId: string): LightconeClientBuilder {\n    this.signingStrategyValue = { type: \"privy\", walletId };\n    return this;\n  }\n\n  rpcUrl(url: string): LightconeClientBuilder {\n    this.rpcUrlValue = url;\n    return this;\n  }\n\n  build(): LightconeClient {\n    return new LightconeClient({\n      http: new LightconeHttp(this.baseUrlValue),\n      wsConfig: {\n        url: this.wsUrlValue,\n        reconnect: true,\n        maxReconnectAttempts: 10,\n        baseReconnectDelayMs: 1_000,\n        pingIntervalMs: 30_000,\n        pongTimeoutMs: 10_000,\n      },\n      programId: this.programIdValue,\n      depositSource: this.depositSourceValue,\n      signingStrategy: this.signingStrategyValue,\n      connection: this.rpcUrlValue\n        ? new Connection(this.rpcUrlValue)\n        : undefined,\n      authCredentials: this.authCredentials,\n    });\n  }\n}\n"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { Connection, Keypair, PublicKey, Transaction } from \"@solana/web3.js\";\nimport { Auth, type AuthCredentials } from \"./auth\";\nimport type { ClientContext } from \"./context\";\nimport { signAndSubmitTx as signAndSubmitTxFn } from \"./context\";\nimport { Admin } from \"./domain/admin\";\nimport type { FaucetRequest, FaucetResponse } from \"./domain/faucet\";\nimport { Markets } from \"./domain/market\";\nimport { Metrics } from \"./domain/metrics\";\nimport { Notifications } from \"./domain/notification\";\nimport { Orders } from \"./domain/order\";\nimport { Orderbooks } from \"./domain/orderbook\";\nimport { Positions } from \"./domain/position\";\nimport { PriceHistoryClient } from \"./domain/price_history\";\nimport { Referrals } from \"./domain/referral\";\nimport { Trades } from \"./domain/trade\";\nimport { LightconeHttp, RetryPolicy } from \"./http\";\nimport { LightconeEnv, apiUrl, wsUrl, rpcUrl, programId as envProgramId } from \"./env\";\nimport { Privy } from \"./privy\";\nimport { Rpc } from \"./rpc\";\nimport { RpcFailoverState } from \"./rpcFailover\";\nimport { DepositSource, type PubkeyStr } from \"./shared\";\nimport { type ExternalSigner, type SigningStrategy } from \"./shared/signing\";\nimport { WsClient, type WsConfig } from \"./ws\";\n\nclass AuthState {\n  private credentialsValue: AuthCredentials | undefined;\n\n  constructor(initial?: AuthCredentials) {\n    this.credentialsValue = initial;\n  }\n\n  getCredentials(): AuthCredentials | undefined {\n    return this.credentialsValue;\n  }\n\n  setCredentials(credentials: AuthCredentials | undefined): void {\n    this.credentialsValue = credentials;\n  }\n\n  async clearCaches(): Promise<void> {\n    // No caches to clear — decimals are derived locally from orderbook metadata.\n  }\n}\n\nexport class LightconeClient implements ClientContext {\n  readonly http: LightconeHttp;\n  readonly programId: PublicKey;\n  readonly primaryConnection?: Connection;\n  readonly backupConnection?: Connection;\n  readonly rpcFailoverState: RpcFailoverState;\n  private depositSourceValue: DepositSource;\n  private signingStrategyValue?: SigningStrategy;\n  private orderNonceValue: number | undefined;\n  private readonly wsConfigValue: WsConfig;\n  private readonly authStateStore: AuthState;\n\n  /** @deprecated Use primaryConnection — kept for ClientContext compat. */\n  get connection(): Connection | undefined {\n    return this.primaryConnection;\n  }\n\n  constructor(params: {\n    http: LightconeHttp;\n    wsConfig: WsConfig;\n    programId?: PublicKey;\n    primaryConnection?: Connection;\n    backupConnection?: Connection;\n    rpcFailoverState?: RpcFailoverState;\n    depositSource?: DepositSource;\n    signingStrategy?: SigningStrategy;\n    orderNonce?: number;\n    authCredentials?: AuthCredentials;\n    authState?: AuthState;\n  }) {\n    this.http = params.http;\n    this.programId = params.programId ?? envProgramId(LightconeEnv.Prod);\n    this.primaryConnection = params.primaryConnection;\n    this.backupConnection = params.backupConnection;\n    this.rpcFailoverState =\n      params.rpcFailoverState ?? new RpcFailoverState();\n    this.depositSourceValue = params.depositSource ?? DepositSource.Global;\n    this.signingStrategyValue = params.signingStrategy;\n    this.orderNonceValue = params.orderNonce;\n    this.wsConfigValue = params.wsConfig;\n    this.authStateStore =\n      params.authState ??\n      new AuthState(params.authCredentials);\n  }\n\n  // ── Deposit source ──────────────────────────────────────────────────\n\n  get depositSource(): DepositSource {\n    return this.depositSourceValue;\n  }\n\n  setDepositSource(source: DepositSource): void {\n    this.depositSourceValue = source;\n  }\n\n  // ── Signing strategy ────────────────────────────────────────────────\n\n  get signingStrategy(): SigningStrategy | undefined {\n    return this.signingStrategyValue;\n  }\n\n  setSigningStrategy(strategy: SigningStrategy): void {\n    this.signingStrategyValue = strategy;\n  }\n\n  clearSigningStrategy(): void {\n    this.signingStrategyValue = undefined;\n  }\n\n  // ── Nonce cache ──────────────────────────────────────────────────────\n\n  orderNonce(): number | undefined {\n    return this.orderNonceValue;\n  }\n\n  setOrderNonce(nonce: number): void {\n    this.orderNonceValue = nonce;\n  }\n\n  clearOrderNonce(): void {\n    this.orderNonceValue = undefined;\n  }\n\n  // ── Auth token (cookie) ─────────────────────────────────────────────\n\n  /**\n   * Get the current `lightcone-token` cookie value, if any. Populated by the SDK\n   * after a successful login, then attached on every authed request. Useful\n   * for forwarding the token through the `*WithCookies` methods, or\n   * persisting the session across processes.\n   */\n  async authToken(): Promise<string | undefined> {\n    return this.http.authTokenRef()();\n  }\n\n  /**\n   * Clear the cached `lightcone-token`. Subsequent authed calls will go out\n   * without a `Cookie` header (and 401) unless they use a\n   * `*WithCookies` variant.\n   */\n  async clearAuthToken(): Promise<void> {\n    await this.http.clearAuthToken();\n  }\n\n  // ── Transaction signing + submission ────────────────────────────────\n\n  async signAndSubmitTx(tx: Transaction): Promise<string> {\n    return signAndSubmitTxFn(this, tx);\n  }\n\n  static builder(): LightconeClientBuilder {\n    return new LightconeClientBuilder();\n  }\n\n  // ── Sub-client accessors ─────────────────────────────────────────────\n\n  markets(): Markets {\n    return new Markets(this);\n  }\n\n  orderbooks(): Orderbooks {\n    return new Orderbooks(this);\n  }\n\n  orders(): Orders {\n    return new Orders(this);\n  }\n\n  positions(): Positions {\n    return new Positions(this);\n  }\n\n  trades(): Trades {\n    return new Trades(this);\n  }\n\n  priceHistory(): PriceHistoryClient {\n    return new PriceHistoryClient(this);\n  }\n\n  notifications(): Notifications {\n    return new Notifications(this);\n  }\n\n  /**\n   * Metrics sub-client — platform / market / orderbook / category / deposit-token\n   * volume metrics, market leaderboard, and time-series history.\n   */\n  metrics(): Metrics {\n    return new Metrics(this);\n  }\n\n  /**\n   * Request testnet SOL and whitelisted deposit tokens for a wallet.\n   *\n   * Only active on environments whose backend has the faucet enabled (typically\n   * local and staging).\n   *\n   * `POST /api/claim`\n   */\n  async claim(walletAddress: PubkeyStr): Promise<FaucetResponse> {\n    const url = `${this.http.baseUrl()}/api/claim`;\n    return this.http.post<FaucetResponse, FaucetRequest>(\n      url,\n      { wallet_address: walletAddress },\n      RetryPolicy.None\n    );\n  }\n\n  admin(): Admin {\n    return new Admin(this);\n  }\n\n  auth(): Auth {\n    return new Auth({\n      http: this.http,\n      authState: this.authStateStore,\n    });\n  }\n\n  privy(): Privy {\n    return new Privy(this);\n  }\n\n  referrals(): Referrals {\n    return new Referrals(this);\n  }\n\n  rpc(): Rpc {\n    return new Rpc(this);\n  }\n\n  wsConfig(): WsConfig {\n    return this.wsConfigValue;\n  }\n\n  ws(): WsClient {\n    return new WsClient(this.wsConfigValue, this.http.authTokenRef());\n  }\n\n  clone(): LightconeClient {\n    return new LightconeClient({\n      http: this.http,\n      wsConfig: { ...this.wsConfigValue },\n      programId: this.programId,\n      primaryConnection: this.primaryConnection\n        ? new Connection(this.primaryConnection.rpcEndpoint, { commitment: \"confirmed\" })\n        : undefined,\n      backupConnection: this.backupConnection\n        ? new Connection(this.backupConnection.rpcEndpoint, { commitment: \"confirmed\" })\n        : undefined,\n      rpcFailoverState: this.rpcFailoverState,\n      depositSource: this.depositSourceValue,\n      signingStrategy: this.signingStrategyValue,\n      orderNonce: this.orderNonceValue,\n      authState: this.authStateStore,\n    });\n  }\n}\n\nexport class LightconeClientBuilder {\n  private baseUrlValue: string = apiUrl(LightconeEnv.Prod);\n  private wsUrlValue: string = wsUrl(LightconeEnv.Prod);\n  private authCredentials?: AuthCredentials;\n  private programIdValue: PublicKey = envProgramId(LightconeEnv.Prod);\n  private depositSourceValue: DepositSource = DepositSource.Global;\n  private signingStrategyValue?: SigningStrategy;\n  private primaryRpcUrlValue?: string = rpcUrl(LightconeEnv.Prod);\n  private backupRpcUrlValue?: string;\n\n  /**\n   * Set the deployment environment. Configures the API URL, WebSocket URL,\n   * RPC URL, and program ID for the given environment.\n   *\n   * Individual URL overrides (e.g. `.baseUrl()`) take precedence when\n   * called **after** `.env()`.\n   */\n  env(environment: LightconeEnv): LightconeClientBuilder {\n    this.baseUrlValue = apiUrl(environment);\n    this.wsUrlValue = wsUrl(environment);\n    this.programIdValue = envProgramId(environment);\n    this.primaryRpcUrlValue = rpcUrl(environment);\n    return this;\n  }\n\n  baseUrl(url: string): LightconeClientBuilder {\n    return this.withBaseUrl(url);\n  }\n\n  withBaseUrl(url: string): LightconeClientBuilder {\n    this.baseUrlValue = url;\n    return this;\n  }\n\n  wsUrl(url: string): LightconeClientBuilder {\n    return this.withWsUrl(url);\n  }\n\n  withWsUrl(url: string): LightconeClientBuilder {\n    this.wsUrlValue = url;\n    return this;\n  }\n\n  auth(credentials: AuthCredentials): LightconeClientBuilder {\n    return this.withAuth(credentials);\n  }\n\n  withAuth(credentials: AuthCredentials): LightconeClientBuilder {\n    this.authCredentials = credentials;\n    return this;\n  }\n\n  programId(id: PublicKey): LightconeClientBuilder {\n    this.programIdValue = id;\n    return this;\n  }\n\n  depositSource(source: DepositSource): LightconeClientBuilder {\n    this.depositSourceValue = source;\n    return this;\n  }\n\n  nativeSigner(keypair: Keypair): LightconeClientBuilder {\n    this.signingStrategyValue = { type: \"native\", keypair };\n    return this;\n  }\n\n  externalSigner(signer: ExternalSigner): LightconeClientBuilder {\n    this.signingStrategyValue = { type: \"walletAdapter\", signer };\n    return this;\n  }\n\n  privyWalletId(walletId: string): LightconeClientBuilder {\n    this.signingStrategyValue = { type: \"privy\", walletId };\n    return this;\n  }\n\n  rpcUrl(url: string): LightconeClientBuilder {\n    this.primaryRpcUrlValue = url;\n    return this;\n  }\n\n  /** Set a backup Solana RPC URL for automatic failover. */\n  backupRpcUrl(url: string): LightconeClientBuilder {\n    this.backupRpcUrlValue = url;\n    return this;\n  }\n\n  build(): LightconeClient {\n    return new LightconeClient({\n      http: new LightconeHttp(this.baseUrlValue),\n      wsConfig: {\n        url: this.wsUrlValue,\n        reconnect: true,\n        maxReconnectAttempts: 10,\n        baseReconnectDelayMs: 1_000,\n        pingIntervalMs: 30_000,\n        pongTimeoutMs: 10_000,\n      },\n      programId: this.programIdValue,\n      depositSource: this.depositSourceValue,\n      signingStrategy: this.signingStrategyValue,\n      primaryConnection: this.primaryRpcUrlValue\n        ? new Connection(this.primaryRpcUrlValue, { commitment: \"confirmed\" })\n        : undefined,\n      backupConnection: this.backupRpcUrlValue\n        ? new Connection(this.backupRpcUrlValue, { commitment: \"confirmed\" })\n        : undefined,\n      authCredentials: this.authCredentials,\n    });\n  }\n}\n"]}

package/dist/context.d.ts

@@ -2,16 +2,22 @@ import type { Connection, PublicKey } from "@solana/web3.js";
 import type { LightconeHttp } from "./http";
 import type { DepositSource } from "./shared";
 import type { SigningStrategy } from "./shared/signing";
+import { type RpcFailoverState } from "./rpcFailover";
 export interface ClientContext {
     readonly http: LightconeHttp;
     readonly programId: PublicKey;
-    readonly connection?: Connection;
+    readonly primaryConnection?: Connection;
+    readonly backupConnection?: Connection;
+    readonly rpcFailoverState: RpcFailoverState;
     readonly depositSource: DepositSource;
     readonly signingStrategy?: SigningStrategy;
     orderNonce?(): number | undefined;
     setOrderNonce?(nonce: number): void;
+    /** @deprecated Use primaryConnection — kept for backward compat in domain sub-clients. */
+    readonly connection?: Connection;
 }
 export declare function requireConnection(ctx: ClientContext): Connection;
+export declare function connectionWithFailover<T>(ctx: ClientContext, operation: (conn: Connection) => Promise<T>): Promise<T>;
 export declare function resolveDepositSource(ctx: ClientContext, overrideSource: DepositSource | undefined): DepositSource;
 export declare function requireSigningStrategy(ctx: ClientContext): SigningStrategy;
 export declare function signAndSubmitTx(ctx: ClientContext, tx: import("@solana/web3.js").Transaction): Promise<string>;

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;IAC3C,UAAU,CAAC,IAAI,MAAM,GAAG,SAAS,CAAC;IAClC,aAAa,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,CAOhE;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,aAAa,EAClB,cAAc,EAAE,aAAa,GAAG,SAAS,GACxC,aAAa,CAEf;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,eAAe,CAO1E;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,aAAa,EAClB,EAAE,EAAE,OAAO,iBAAiB,EAAE,WAAW,GACxC,OAAO,CAAC,MAAM,CAAC,CAsCjB"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAEL,KAAK,gBAAgB,EAItB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,UAAU,CAAC;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,UAAU,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;IAC3C,UAAU,CAAC,IAAI,MAAM,GAAG,SAAS,CAAC;IAClC,aAAa,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;CAClC;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,CAYhE;AAWD,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,GAAG,EAAE,aAAa,EAClB,SAAS,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC,CAAC,CAAC,CAwCZ;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,aAAa,EAClB,cAAc,EAAE,aAAa,GAAG,SAAS,GACxC,aAAa,CAEf;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,eAAe,CAO1E;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,aAAa,EAClB,EAAE,EAAE,OAAO,iBAAiB,EAAE,WAAW,GACxC,OAAO,CAAC,MAAM,CAAC,CA6CjB"}

package/dist/context.js

@@ -34,15 +34,69 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.requireConnection = requireConnection;
+exports.connectionWithFailover = connectionWithFailover;
 exports.resolveDepositSource = resolveDepositSource;
 exports.requireSigningStrategy = requireSigningStrategy;
 exports.signAndSubmitTx = signAndSubmitTx;
 const error_1 = require("./error");
+const rpcFailover_1 = require("./rpcFailover");
 function requireConnection(ctx) {
-    if (!ctx.connection) {
+    ctx.rpcFailoverState.maybeRecoverToPrimary();
+    const conn = ctx.rpcFailoverState.active === rpcFailover_1.ActiveRpc.Primary
+        ? ctx.primaryConnection
+        : ctx.backupConnection ?? ctx.primaryConnection;
+    if (!conn) {
         throw error_1.SdkError.validation("RPC client not configured — use .rpcUrl() on the builder");
     }
-    return ctx.connection;
+    return conn;
+}
+function resolveConnectionFor(ctx, target) {
+    return target === rpcFailover_1.ActiveRpc.Primary
+        ? ctx.primaryConnection
+        : ctx.backupConnection;
+}
+async function connectionWithFailover(ctx, operation) {
+    ctx.rpcFailoverState.maybeRecoverToPrimary();
+    const originalActive = ctx.rpcFailoverState.active;
+    const activeConn = requireConnection(ctx);
+    // First attempt.
+    try {
+        return await operation(activeConn);
+    }
+    catch (firstError) {
+        if (!(0, rpcFailover_1.isInfrastructureError)(firstError))
+            throw firstError;
+    }
+    // Fast retry on same connection.
+    await (0, rpcFailover_1.sleep)(rpcFailover_1.FAST_RETRY_DELAY_MS);
+    try {
+        return await operation(activeConn);
+    }
+    catch (retryError) {
+        if (!(0, rpcFailover_1.isInfrastructureError)(retryError))
+            throw retryError;
+        // Flip and try the other connection.
+        const otherTarget = originalActive === rpcFailover_1.ActiveRpc.Primary
+            ? rpcFailover_1.ActiveRpc.Backup
+            : rpcFailover_1.ActiveRpc.Primary;
+        const otherConn = resolveConnectionFor(ctx, otherTarget);
+        if (otherConn) {
+            try {
+                const result = await operation(otherConn);
+                if (otherTarget === rpcFailover_1.ActiveRpc.Primary) {
+                    ctx.rpcFailoverState.flipToPrimary();
+                }
+                else {
+                    ctx.rpcFailoverState.flipToBackup();
+                }
+                return result;
+            }
+            catch (bothError) {
+                throw bothError;
+            }
+        }
+        throw retryError;
+    }
 }
 function resolveDepositSource(ctx, overrideSource) {
     return overrideSource ?? ctx.depositSource;
@@ -58,13 +112,13 @@ async function signAndSubmitTx(ctx, tx) {
     const { SdkError } = await Promise.resolve().then(() => __importStar(require("./error")));
     const { RetryPolicy } = await Promise.resolve().then(() => __importStar(require("./http")));
     const strategy = requireSigningStrategy(ctx);
-    const connection = requireConnection(ctx);
-    const { blockhash } = await connection.getLatestBlockhash();
+    // Get blockhash with failover.
+    const { blockhash } = await connectionWithFailover(ctx, (conn) => conn.getLatestBlockhash());
     tx.recentBlockhash = blockhash;
     switch (strategy.type) {
         case "native": {
             tx.partialSign(strategy.keypair);
-            return connection.sendRawTransaction(tx.serialize());
+            return connectionWithFailover(ctx, (conn) => conn.sendRawTransaction(tx.serialize()));
         }
         case "walletAdapter": {
             const txBytes = tx.serialize({ requireAllSignatures: false });
@@ -76,7 +130,7 @@ async function signAndSubmitTx(ctx, tx) {
                     throw SdkError.userCancelled();
                 throw SdkError.signing(msg);
             });
-            return connection.sendRawTransaction(signedBytes);
+            return connectionWithFailover(ctx, (conn) => conn.sendRawTransaction(signedBytes));
         }
         case "privy": {
             const txBytes = tx.serialize({ requireAllSignatures: false });