@lightconexyz/lightcone-sdk 0.8.1 → 0.8.2

package/dist/auth/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PubkeyStr } from \"../shared\";\nimport { shorten } from \"../shared/fmt/str\";\n\nexport * from \"./client\";\nexport * from \"./native\";\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 enum ChainType {\n  Solana = \"solana\",\n  Ethereum = \"ethereum\",\n}\n\n/** A Privy-managed embedded wallet. */\nexport interface PrivyEmbeddedWallet {\n  privy_id: string;\n  chain: ChainType;\n  address: string;\n}\n\n/** Privy account data attached to an identity. */\nexport interface UserPrivyData {\n  /** The Privy DID (`did:privy:...`). */\n  id: string;\n  /**\n   * Always present: Privy registration provisions the embedded wallet in the\n   * same transaction that creates the user.\n   */\n  wallet: PrivyEmbeddedWallet;\n}\n\n/**\n * X account data — the same shape whether X is the login identity or a\n * connected account on a Google/wallet identity.\n */\nexport interface XAccountData {\n  /** X numeric user id (Privy `subject`); absent on legacy rows. */\n  user_id?: string;\n  username: string;\n  display_name?: string;\n  avatar_url?: string;\n}\n\n/** Google account data for a Google login identity. */\nexport interface GoogleAccountData {\n  email: string;\n  name?: string;\n  given_name?: string;\n  family_name?: string;\n  avatar_url?: string;\n}\n\n/**\n * The login identity — how the user authenticates. `type` narrows the variant.\n *\n * Privy data lives on the variant because its presence is determined by the\n * identity type: Google/X login only exists via Privy OAuth (guaranteed DID +\n * embedded wallet), while wallet users opt into Privy (SIWS) or stay\n * self-custody.\n */\nexport type UserIdentity =\n  | { type: \"google\"; account: GoogleAccountData; privy: UserPrivyData }\n  | { type: \"x\"; account: XAccountData; privy: UserPrivyData }\n  | { type: \"wallet\"; address: string; chain: ChainType; privy?: UserPrivyData };\n\n/** Full user profile — the `user` object of {@link SessionResponse}. */\nexport interface User {\n  user_id: string;\n  identity: UserIdentity;\n  /** X account connected by a non-X-identity user; absent when identity is X. */\n  connected_x?: XAccountData;\n}\n\n/**\n * Session envelope returned by `loginWithMessage`, `register-privy`, and\n * `GET /api/auth/me`. There is no `wallet_address` field — derive the\n * session's trading wallet with {@link tradingWallet}.\n */\nexport interface SessionResponse {\n  user: User;\n  expires_at: number;\n  auth_method: AuthMethod;\n  is_beta: boolean;\n}\n\n/** Human-readable login-method label (\"Google\" / \"X\" / \"Solana\"). */\nexport function identityText(identity: UserIdentity): \"Google\" | \"X\" | \"Solana\" {\n  switch (identity.type) {\n    case \"google\":\n      return \"Google\";\n    case \"x\":\n      return \"X\";\n    case \"wallet\":\n      return \"Solana\";\n    default: {\n      const exhaustive: never = identity;\n      throw new Error(`Unknown identity: ${JSON.stringify(exhaustive)}`);\n    }\n  }\n}\n\n/** Privy account data, regardless of identity type. */\nexport function userPrivy(user: User): UserPrivyData | undefined {\n  switch (user.identity.type) {\n    case \"google\":\n    case \"x\":\n      return user.identity.privy;\n    case \"wallet\":\n      return user.identity.privy;\n  }\n}\n\n/** The X account, whether it is the login identity or a connected account. */\nexport function userXAccount(user: User): XAccountData | undefined {\n  return user.identity.type === \"x\" ? user.identity.account : user.connected_x;\n}\n\n/**\n * The wallet a session operates as.\n *\n * Google/X identities only exist via Privy registration, which always\n * provisions an embedded wallet — that wallet is the answer regardless of\n * auth method. Wallet identities depend on the session: a Privy (SIWS)\n * session trades via the embedded wallet, a Lightcone session trades via the\n * wallet that signed in.\n */\nexport function tradingWallet(user: User, authMethod: AuthMethod): string {\n  switch (user.identity.type) {\n    case \"google\":\n    case \"x\":\n      return user.identity.privy.wallet.address;\n    case \"wallet\":\n      return authMethod === AuthMethod.Privy\n        ? (user.identity.privy?.wallet.address ?? user.identity.address)\n        : user.identity.address;\n  }\n}\n\n/** Short display label for the wallet a session operates as. */\nexport function walletDisplayName(user: User, authMethod: AuthMethod): string {\n  return shorten(tradingWallet(user, authMethod), 8);\n}\n\n/**\n * Best display name for the user. Google: `name`, falling back to the email;\n * X: `display_name`, falling back to the username; wallet identities show the\n * shortened address (`FRGk...WcPR`).\n */\nexport function displayName(user: User): string {\n  switch (user.identity.type) {\n    case \"google\":\n      return user.identity.account.name ?? user.identity.account.email;\n    case \"x\":\n      return user.identity.account.display_name ?? user.identity.account.username;\n    case \"wallet\":\n      return shorten(user.identity.address, 8);\n  }\n}\n\n/** Avatar URL from the login identity's OAuth provider, if any. */\nexport function avatarUrl(user: User): string | undefined {\n  switch (user.identity.type) {\n    case \"google\":\n    case \"x\":\n      return user.identity.account.avatar_url;\n    case \"wallet\":\n      return undefined;\n  }\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 NonceResponse {\n  nonce: string;\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PubkeyStr } from \"../shared\";\nimport { shorten } from \"../shared/fmt/str\";\n\nexport * from \"./client\";\nexport * from \"./native\";\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 enum ChainType {\n  Solana = \"solana\",\n  Ethereum = \"ethereum\",\n}\n\n/** A Privy-managed embedded wallet. */\nexport interface PrivyEmbeddedWallet {\n  privy_id: string;\n  chain: ChainType;\n  address: string;\n}\n\n/** Privy account data attached to an identity. */\nexport interface UserPrivyData {\n  /** The Privy DID (`did:privy:...`). */\n  id: string;\n  /**\n   * Always present: Privy registration provisions the embedded wallet in the\n   * same transaction that creates the user.\n   */\n  wallet: PrivyEmbeddedWallet;\n}\n\n/**\n * X account data — the same shape whether X is the login identity or a\n * connected account on a Google/wallet identity.\n */\nexport interface XAccountData {\n  /** X numeric user id (Privy `subject`); absent on legacy rows. */\n  user_id?: string;\n  username: string;\n  display_name?: string;\n  avatar_url?: string;\n}\n\n/** Google account data for a Google login identity. */\nexport interface GoogleAccountData {\n  email: string;\n  name?: string;\n  given_name?: string;\n  family_name?: string;\n  avatar_url?: string;\n}\n\n/** Canonical address for a passwordless Email login identity. */\nexport interface EmailAccountData {\n  email: string;\n}\n\n/** Public login-method names exposed in profiles and bounded conflicts. */\nexport type LinkedIdentityType = \"email\" | \"google\" | \"x\" | \"wallet\";\n\n/** Connected Login Identity without repeated Account-level Privy wallet data. */\nexport type LinkedIdentity =\n  | { type: \"email\"; account: EmailAccountData }\n  | { type: \"google\"; account: GoogleAccountData }\n  | { type: \"x\"; account: XAccountData }\n  | { type: \"wallet\"; address: string; chain: ChainType };\n\n/** Verified method and canonical identifier that initiated Privy authentication. */\nexport type LinkedIdentitySelector =\n  | { type: \"email\"; email: string }\n  | { type: \"google\"; email: string }\n  | { type: \"x\"; username: string }\n  | { type: \"wallet\"; address: string; chain: ChainType };\n\n/** Register-or-sync request naming the verified attempted identity. */\nexport interface RegisterPrivyRequest {\n  attempted_identity: LinkedIdentitySelector;\n}\n\n/**\n * The login identity — how the user authenticates. `type` narrows the variant.\n *\n * Privy data lives on the variant because its presence is determined by the\n * identity type: Google/X login only exists via Privy OAuth (guaranteed DID +\n * embedded wallet), while wallet users opt into Privy (SIWS) or stay\n * self-custody.\n */\nexport type UserIdentity =\n  | { type: \"email\"; account: EmailAccountData; privy: UserPrivyData }\n  | { type: \"google\"; account: GoogleAccountData; privy: UserPrivyData }\n  | { type: \"x\"; account: XAccountData; privy: UserPrivyData }\n  | {\n      type: \"wallet\";\n      address: string;\n      chain: ChainType;\n      privy?: UserPrivyData;\n    };\n\n/** Full user profile — the `user` object of {@link SessionResponse}. */\nexport interface User {\n  user_id: string;\n  identity: UserIdentity;\n  /** Every verified login identity connected to the Account, primary first. */\n  linked_identities?: LinkedIdentity[];\n  /** Remembered account-wide percentage below 10%; null until one is stored. */\n  max_slippage_preference: string | null;\n  /** X account connected by a non-X-identity user; absent when identity is X. */\n  connected_x?: XAccountData;\n}\n\n/**\n * Session envelope returned by `loginWithMessage`, `register-privy`, and\n * `GET /api/auth/me`. There is no `wallet_address` field — derive the\n * session's trading wallet with {@link tradingWallet}.\n */\nexport interface SessionResponse {\n  user: User;\n  expires_at: number;\n  auth_method: AuthMethod;\n  is_beta: boolean;\n}\n\n/** Exact decimal-string body used to update and return max slippage. */\nexport interface MaxSlippagePreferenceBody {\n  max_slippage_preference: string;\n}\n\n/** Human-readable login-method label (\"Email\" / \"Google\" / \"X\" / \"Solana\"). */\nexport function identityText(\n  identity: UserIdentity,\n): \"Email\" | \"Google\" | \"X\" | \"Solana\" {\n  switch (identity.type) {\n    case \"email\":\n      return \"Email\";\n    case \"google\":\n      return \"Google\";\n    case \"x\":\n      return \"X\";\n    case \"wallet\":\n      return \"Solana\";\n    default: {\n      const exhaustive: never = identity;\n      throw new Error(`Unknown identity: ${JSON.stringify(exhaustive)}`);\n    }\n  }\n}\n\n/** Privy account data, regardless of identity type. */\nexport function userPrivy(user: User): UserPrivyData | undefined {\n  switch (user.identity.type) {\n    case \"email\":\n    case \"google\":\n    case \"x\":\n      return user.identity.privy;\n    case \"wallet\":\n      return user.identity.privy;\n  }\n}\n\n/** The X account, whether it is the login identity or a connected account. */\nexport function userXAccount(user: User): XAccountData | undefined {\n  return user.identity.type === \"x\" ? user.identity.account : user.connected_x;\n}\n\n/**\n * The wallet a session operates as.\n *\n * Google/X identities only exist via Privy registration, which always\n * provisions an embedded wallet — that wallet is the answer regardless of\n * auth method. Wallet identities depend on the session: a Privy (SIWS)\n * session trades via the embedded wallet, a Lightcone session trades via the\n * wallet that signed in.\n */\nexport function tradingWallet(user: User, authMethod: AuthMethod): string {\n  switch (user.identity.type) {\n    case \"email\":\n    case \"google\":\n    case \"x\":\n      return user.identity.privy.wallet.address;\n    case \"wallet\":\n      return authMethod === AuthMethod.Privy\n        ? (user.identity.privy?.wallet.address ?? user.identity.address)\n        : user.identity.address;\n  }\n}\n\n/** Short display label for the wallet a session operates as. */\nexport function walletDisplayName(user: User, authMethod: AuthMethod): string {\n  return shorten(tradingWallet(user, authMethod), 8);\n}\n\n/** Keeps Email labels compact while preserving the recognizable address ends. */\nfunction emailDisplayName(email: string): string {\n  const maxChars = 20;\n  const chars = [...email];\n  if (chars.length <= maxChars) {\n    return email;\n  }\n\n  const visibleChars = maxChars - 3;\n  const prefixChars = Math.floor(visibleChars / 2);\n  return `${chars.slice(0, prefixChars).join(\"\")}...${chars\n    .slice(-(visibleChars - prefixChars))\n    .join(\"\")}`;\n}\n\n/**\n * Best display name for the user. Email addresses are limited to 20 characters;\n * Google uses `name` with an email fallback; X uses `display_name` with a\n * username fallback; wallet identities show the shortened address (`FRGk...WcPR`).\n */\nexport function displayName(user: User): string {\n  switch (user.identity.type) {\n    case \"email\":\n      return emailDisplayName(user.identity.account.email);\n    case \"google\":\n      return user.identity.account.name ?? user.identity.account.email;\n    case \"x\":\n      return (\n        user.identity.account.display_name ?? user.identity.account.username\n      );\n    case \"wallet\":\n      return shorten(user.identity.address, 8);\n  }\n}\n\n/** Avatar URL from the login identity's OAuth provider, if any. */\nexport function avatarUrl(user: User): string | undefined {\n  switch (user.identity.type) {\n    case \"email\":\n      return undefined;\n    case \"google\":\n    case \"x\":\n      return user.identity.account.avatar_url;\n    case \"wallet\":\n      return undefined;\n  }\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 NonceResponse {\n  nonce: string;\n}\n"]}

package/dist/client.d.ts

@@ -35,6 +35,7 @@ export declare class LightconeClient implements ClientContext {
     readonly rpcFailoverState: RpcFailoverState;
     private depositSourceValue;
     private signingStrategyValue?;
+    private transactionSponsorshipEnabledValue;
     private orderNonceValue;
     private readonly wsConfigValue;
     private readonly authStateStore;
@@ -50,6 +51,7 @@ export declare class LightconeClient implements ClientContext {
         rpcFailoverState?: RpcFailoverState;
         depositSource?: DepositSource;
         signingStrategy?: SigningStrategy;
+        transactionSponsorshipEnabled?: boolean;
         orderNonce?: number;
         authCredentials?: AuthCredentials;
         authState?: AuthState;
@@ -58,8 +60,19 @@ export declare class LightconeClient implements ClientContext {
     get depositSource(): DepositSource;
     setDepositSource(source: DepositSource): void;
     get signingStrategy(): SigningStrategy | undefined;
+    /**
+     * Cached authenticated identity shared by domain sub-clients.
+     *
+     * This is distinct from the HTTP cookie token and may be expired; fund-moving
+     * operations must re-check its lifetime and wallet before signing.
+     */
+    get authCredentials(): AuthCredentials | undefined;
     setSigningStrategy(strategy: SigningStrategy): void;
     clearSigningStrategy(): void;
+    /** Return the client-wide trusted assertion that an external sponsor pays fees. */
+    get transactionSponsorshipEnabled(): boolean;
+    /** Replace the Transaction Sponsorship Capability for subsequent submissions. */
+    setTransactionSponsorshipEnabled(enabled: boolean): void;
     orderNonce(): number | undefined;
     setOrderNonce(nonce: number): void;
     clearOrderNonce(): void;
@@ -98,6 +111,8 @@ export declare class LightconeClient implements ClientContext {
     signAndSubmitTxConfirmed(tx: Transaction): Promise<string>;
     /** Sign, submit, confirm, and return the transaction's processing slot. */
     signAndSubmitTxConfirmedWithSlot(tx: Transaction): Promise<ConfirmedTransaction>;
+    /** Confirm a fee-prepared transaction without replacing its message. */
+    signAndSubmitPreparedTxConfirmedWithSlot(tx: Transaction): Promise<ConfirmedTransaction>;
     static builder(): LightconeClientBuilder;
     markets(): Markets;
     orderbooks(): Orderbooks;
@@ -126,6 +141,10 @@ export declare class LightconeClient implements ClientContext {
     rpc(): Rpc;
     wsConfig(): WsConfig;
     ws(): WsClient;
+    /**
+     * Return a client whose Transaction Sponsorship Capability starts at this value.
+     * Later runtime changes remain local to each clone, matching other mutable settings.
+     */
     clone(): LightconeClient;
 }
 export declare class LightconeClientBuilder {
@@ -135,6 +154,7 @@ export declare class LightconeClientBuilder {
     private programIdValue;
     private depositSourceValue;
     private signingStrategyValue?;
+    private transactionSponsorshipEnabledValue;
     private primaryRpcUrlValue?;
     private backupRpcUrlValue?;
     /**
@@ -155,7 +175,9 @@ export declare class LightconeClientBuilder {
     depositSource(source: DepositSource): LightconeClientBuilder;
     nativeSigner(keypair: Keypair): LightconeClientBuilder;
     externalSigner(signer: ExternalSigner): LightconeClientBuilder;
-    privyWalletId(walletId: string): LightconeClientBuilder;
+    privyWalletId(walletId: string, walletAddress?: string): LightconeClientBuilder;
+    /** Set the initial trusted Transaction Sponsorship Capability; defaults to false. */
+    transactionSponsorship(enabled: boolean): LightconeClientBuilder;
     rpcUrl(url: string): LightconeClientBuilder;
     /** Set a backup Solana RPC URL for automatic failover. */
     backupRpcUrl(url: string): LightconeClientBuilder;

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

@@ -43,6 +43,7 @@ class LightconeClient {
     rpcFailoverState;
     depositSourceValue;
     signingStrategyValue;
+    transactionSponsorshipEnabledValue;
     orderNonceValue;
     wsConfigValue;
     authStateStore;
@@ -60,6 +61,8 @@ class LightconeClient {
             params.rpcFailoverState ?? new rpcFailover_1.RpcFailoverState();
         this.depositSourceValue = params.depositSource ?? shared_1.DepositSource.Global;
         this.signingStrategyValue = params.signingStrategy;
+        this.transactionSponsorshipEnabledValue =
+            params.transactionSponsorshipEnabled ?? false;
         this.orderNonceValue = params.orderNonce;
         this.wsConfigValue = params.wsConfig;
         this.authStateStore =
@@ -78,12 +81,29 @@ class LightconeClient {
     get signingStrategy() {
         return this.signingStrategyValue;
     }
+    /**
+     * Cached authenticated identity shared by domain sub-clients.
+     *
+     * This is distinct from the HTTP cookie token and may be expired; fund-moving
+     * operations must re-check its lifetime and wallet before signing.
+     */
+    get authCredentials() {
+        return this.authStateStore.getCredentials();
+    }
     setSigningStrategy(strategy) {
         this.signingStrategyValue = strategy;
     }
     clearSigningStrategy() {
         this.signingStrategyValue = undefined;
     }
+    /** Return the client-wide trusted assertion that an external sponsor pays fees. */
+    get transactionSponsorshipEnabled() {
+        return this.transactionSponsorshipEnabledValue;
+    }
+    /** Replace the Transaction Sponsorship Capability for subsequent submissions. */
+    setTransactionSponsorshipEnabled(enabled) {
+        this.transactionSponsorshipEnabledValue = enabled;
+    }
     // ── Nonce cache ──────────────────────────────────────────────────────
     orderNonce() {
         return this.orderNonceValue;
@@ -145,6 +165,10 @@ class LightconeClient {
     async signAndSubmitTxConfirmedWithSlot(tx) {
         return (0, context_1.signAndSubmitTxConfirmedWithSlot)(this, tx);
     }
+    /** Confirm a fee-prepared transaction without replacing its message. */
+    async signAndSubmitPreparedTxConfirmedWithSlot(tx) {
+        return (0, context_1.signAndSubmitPreparedTxConfirmedWithSlot)(this, tx);
+    }
     static builder() {
         return new LightconeClientBuilder();
     }
@@ -210,6 +234,10 @@ class LightconeClient {
     ws() {
         return new ws_1.WsClient(this.wsConfigValue, this.http.authTokenRef());
     }
+    /**
+     * Return a client whose Transaction Sponsorship Capability starts at this value.
+     * Later runtime changes remain local to each clone, matching other mutable settings.
+     */
     clone() {
         return new LightconeClient({
             http: this.http,
@@ -224,6 +252,7 @@ class LightconeClient {
             rpcFailoverState: this.rpcFailoverState,
             depositSource: this.depositSourceValue,
             signingStrategy: this.signingStrategyValue,
+            transactionSponsorshipEnabled: this.transactionSponsorshipEnabledValue,
             orderNonce: this.orderNonceValue,
             authState: this.authStateStore,
             orderbookRulesCache: this.orderbookRulesCache,
@@ -238,6 +267,7 @@ class LightconeClientBuilder {
     programIdValue = (0, env_1.programId)(env_1.LightconeEnv.Prod);
     depositSourceValue = shared_1.DepositSource.Global;
     signingStrategyValue;
+    transactionSponsorshipEnabledValue = false;
     primaryRpcUrlValue = (0, env_1.rpcUrl)(env_1.LightconeEnv.Prod);
     backupRpcUrlValue;
     /**
@@ -291,8 +321,13 @@ class LightconeClientBuilder {
         this.signingStrategyValue = { type: "walletAdapter", signer };
         return this;
     }
-    privyWalletId(walletId) {
-        this.signingStrategyValue = { type: "privy", walletId };
+    privyWalletId(walletId, walletAddress) {
+        this.signingStrategyValue = { type: "privy", walletId, walletAddress };
+        return this;
+    }
+    /** Set the initial trusted Transaction Sponsorship Capability; defaults to false. */
+    transactionSponsorship(enabled) {
+        this.transactionSponsorshipEnabledValue = enabled;
         return this;
     }
     rpcUrl(url) {
@@ -318,6 +353,7 @@ class LightconeClientBuilder {
             programId: this.programIdValue,
             depositSource: this.depositSourceValue,
             signingStrategy: this.signingStrategyValue,
+            transactionSponsorshipEnabled: this.transactionSponsorshipEnabledValue,
             primaryConnection: this.primaryRpcUrlValue
                 ? new web3_js_1.Connection(this.primaryRpcUrlValue, { commitment: "confirmed" })
                 : undefined,

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 {\n  signAndSubmitTx as signAndSubmitTxFn,\n  signAndSubmitTxConfirmed as signAndSubmitTxConfirmedFn,\n  signAndSubmitTxConfirmedWithSlot as signAndSubmitTxConfirmedWithSlotFn,\n} from \"./context\";\nimport type { ConfirmedTransaction } from \"./context\";\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, type CredentialRestorer } 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 OrderbookRules, 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  readonly orderbookRulesCache: Map<string, Promise<OrderbookRules>>;\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    orderbookRulesCache?: Map<string, Promise<OrderbookRules>>;\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    this.orderbookRulesCache = params.orderbookRulesCache ?? new Map();\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  /**\n   * Register the credential restorer consulted when a request fails with\n   * HTTP 401: it attempts to restore credentials (e.g. refresh the app's\n   * auth session so the auth cookie is valid again); on success the\n   * transport replays the request once IF it declared itself retry-safe\n   * (RetryPolicy.None mutations are never auto-replayed). See {@link CredentialRestorer}.\n   * Without a restorer, 401s propagate to callers unchanged.\n   *\n   * Common use: set once at app startup, alongside the signing strategy.\n   */\n  setCredentialRestorer(restorer: CredentialRestorer): void {\n    this.http.setCredentialRestorer(restorer);\n  }\n\n  /** Remove the credential restorer (e.g. in tests); 401s propagate again. */\n  clearCredentialRestorer(): void {\n    this.http.clearCredentialRestorer();\n  }\n\n  // ── Transaction signing + submission ────────────────────────────────\n\n  async signAndSubmitTx(tx: Transaction): Promise<string> {\n    return signAndSubmitTxFn(this, tx);\n  }\n\n  /**\n   * Sign and submit a transaction, then wait until it reaches `confirmed`\n   * commitment on-chain. Prefer this over {@link signAndSubmitTx} when a\n   * follow-up transaction depends on this one's state.\n   */\n  async signAndSubmitTxConfirmed(tx: Transaction): Promise<string> {\n    return signAndSubmitTxConfirmedFn(this, tx);\n  }\n\n  /** Sign, submit, confirm, and return the transaction's processing slot. */\n  async signAndSubmitTxConfirmedWithSlot(\n    tx: Transaction\n  ): Promise<ConfirmedTransaction> {\n    return signAndSubmitTxConfirmedWithSlotFn(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  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      orderbookRulesCache: this.orderbookRulesCache,\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"]}
+{"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 {\n  signAndSubmitTx as signAndSubmitTxFn,\n  signAndSubmitTxConfirmed as signAndSubmitTxConfirmedFn,\n  signAndSubmitTxConfirmedWithSlot as signAndSubmitTxConfirmedWithSlotFn,\n  signAndSubmitPreparedTxConfirmedWithSlot as signAndSubmitPreparedTxConfirmedWithSlotFn,\n} from \"./context\";\nimport type { ConfirmedTransaction } from \"./context\";\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, type CredentialRestorer } 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 OrderbookRules, 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 transactionSponsorshipEnabledValue: boolean;\n  private orderNonceValue: number | undefined;\n  private readonly wsConfigValue: WsConfig;\n  private readonly authStateStore: AuthState;\n  readonly orderbookRulesCache: Map<string, Promise<OrderbookRules>>;\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    transactionSponsorshipEnabled?: boolean;\n    orderNonce?: number;\n    authCredentials?: AuthCredentials;\n    authState?: AuthState;\n    orderbookRulesCache?: Map<string, Promise<OrderbookRules>>;\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.transactionSponsorshipEnabledValue =\n      params.transactionSponsorshipEnabled ?? false;\n    this.orderNonceValue = params.orderNonce;\n    this.wsConfigValue = params.wsConfig;\n    this.authStateStore =\n      params.authState ??\n      new AuthState(params.authCredentials);\n    this.orderbookRulesCache = params.orderbookRulesCache ?? new Map();\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  /**\n   * Cached authenticated identity shared by domain sub-clients.\n   *\n   * This is distinct from the HTTP cookie token and may be expired; fund-moving\n   * operations must re-check its lifetime and wallet before signing.\n   */\n  get authCredentials(): AuthCredentials | undefined {\n    return this.authStateStore.getCredentials();\n  }\n\n  setSigningStrategy(strategy: SigningStrategy): void {\n    this.signingStrategyValue = strategy;\n  }\n\n  clearSigningStrategy(): void {\n    this.signingStrategyValue = undefined;\n  }\n\n  /** Return the client-wide trusted assertion that an external sponsor pays fees. */\n  get transactionSponsorshipEnabled(): boolean {\n    return this.transactionSponsorshipEnabledValue;\n  }\n\n  /** Replace the Transaction Sponsorship Capability for subsequent submissions. */\n  setTransactionSponsorshipEnabled(enabled: boolean): void {\n    this.transactionSponsorshipEnabledValue = enabled;\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  /**\n   * Register the credential restorer consulted when a request fails with\n   * HTTP 401: it attempts to restore credentials (e.g. refresh the app's\n   * auth session so the auth cookie is valid again); on success the\n   * transport replays the request once IF it declared itself retry-safe\n   * (RetryPolicy.None mutations are never auto-replayed). See {@link CredentialRestorer}.\n   * Without a restorer, 401s propagate to callers unchanged.\n   *\n   * Common use: set once at app startup, alongside the signing strategy.\n   */\n  setCredentialRestorer(restorer: CredentialRestorer): void {\n    this.http.setCredentialRestorer(restorer);\n  }\n\n  /** Remove the credential restorer (e.g. in tests); 401s propagate again. */\n  clearCredentialRestorer(): void {\n    this.http.clearCredentialRestorer();\n  }\n\n  // ── Transaction signing + submission ────────────────────────────────\n\n  async signAndSubmitTx(tx: Transaction): Promise<string> {\n    return signAndSubmitTxFn(this, tx);\n  }\n\n  /**\n   * Sign and submit a transaction, then wait until it reaches `confirmed`\n   * commitment on-chain. Prefer this over {@link signAndSubmitTx} when a\n   * follow-up transaction depends on this one's state.\n   */\n  async signAndSubmitTxConfirmed(tx: Transaction): Promise<string> {\n    return signAndSubmitTxConfirmedFn(this, tx);\n  }\n\n  /** Sign, submit, confirm, and return the transaction's processing slot. */\n  async signAndSubmitTxConfirmedWithSlot(\n    tx: Transaction\n  ): Promise<ConfirmedTransaction> {\n    return signAndSubmitTxConfirmedWithSlotFn(this, tx);\n  }\n\n  /** Confirm a fee-prepared transaction without replacing its message. */\n  async signAndSubmitPreparedTxConfirmedWithSlot(\n    tx: Transaction\n  ): Promise<ConfirmedTransaction> {\n    return signAndSubmitPreparedTxConfirmedWithSlotFn(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  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  /**\n   * Return a client whose Transaction Sponsorship Capability starts at this value.\n   * Later runtime changes remain local to each clone, matching other mutable settings.\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      transactionSponsorshipEnabled: this.transactionSponsorshipEnabledValue,\n      orderNonce: this.orderNonceValue,\n      authState: this.authStateStore,\n      orderbookRulesCache: this.orderbookRulesCache,\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 transactionSponsorshipEnabledValue = false;\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(\n    walletId: string,\n    walletAddress?: string\n  ): LightconeClientBuilder {\n    this.signingStrategyValue = { type: \"privy\", walletId, walletAddress };\n    return this;\n  }\n\n  /** Set the initial trusted Transaction Sponsorship Capability; defaults to false. */\n  transactionSponsorship(enabled: boolean): LightconeClientBuilder {\n    this.transactionSponsorshipEnabledValue = enabled;\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      transactionSponsorshipEnabled: this.transactionSponsorshipEnabledValue,\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

@@ -1,7 +1,8 @@
-import type { Connection, PublicKey } from "@solana/web3.js";
+import { type Connection, type PublicKey } from "@solana/web3.js";
 import type { LightconeHttp } from "./http";
+import type { AuthCredentials } from "./auth";
 import type { DepositSource, OrderbookRules } from "./shared";
-import type { SigningStrategy } from "./shared/signing";
+import { type SigningStrategy } from "./shared/signing";
 import { type RpcFailoverState } from "./rpcFailover";
 export interface ClientContext {
     readonly http: LightconeHttp;
@@ -11,6 +12,10 @@ export interface ClientContext {
     readonly rpcFailoverState: RpcFailoverState;
     readonly depositSource: DepositSource;
     readonly signingStrategy?: SigningStrategy;
+    /** Trusted application assertion that an external sponsor pays fees; omission is false. */
+    readonly transactionSponsorshipEnabled?: boolean;
+    /** Optional cached identity for auth-bound operations; callers must check expiry. */
+    readonly authCredentials?: AuthCredentials;
     orderNonce?(): number | undefined;
     setOrderNonce?(nonce: number): void;
     readonly orderbookRulesCache?: Map<string, Promise<OrderbookRules>>;
@@ -28,6 +33,8 @@ export declare function requireSigningStrategy(ctx: ClientContext): SigningStrat
  * accepts the transaction — inclusion is not awaited. When follow-up work
  * depends on this transaction's on-chain effects, use
  * {@link signAndSubmitTxConfirmed} instead.
+ * Unsponsored submission checks exact fee funding before signing when both
+ * required RPC observations are available.
  */
 export declare function signAndSubmitTx(ctx: ClientContext, tx: import("@solana/web3.js").Transaction): Promise<string>;
 /**
@@ -56,4 +63,18 @@ export interface ConfirmedTransaction {
  * both its signature and processing slot.
  */
 export declare function signAndSubmitTxConfirmedWithSlot(ctx: ClientContext, tx: import("@solana/web3.js").Transaction): Promise<ConfirmedTransaction>;
+/**
+ * Sign, submit once, and confirm a transaction whose message was fee-estimated.
+ *
+ * This function preserves the prepared blockhash. A wallet adapter may add
+ * signatures but may not replace any message field. Signed bytes are sent once to
+ * the active RPC because a transport failure may occur after acceptance.
+ * The unchanged message receives the same best-effort fee-funding preflight as an
+ * ordinary transaction before the signer runs. A sponsored external signer may
+ * differ from the declared fee payer. The caller-owned transaction is snapshotted
+ * before the first await so later caller mutation cannot change fee authority.
+ */
+export declare function signAndSubmitPreparedTxConfirmedWithSlot(ctx: ClientContext, tx: import("@solana/web3.js").Transaction): Promise<ConfirmedTransaction>;
+/** @internal Submit with a strategy already validated for an identity-bound operation. */
+export declare function signAndSubmitTxConfirmedUsingStrategy(ctx: ClientContext, tx: import("@solana/web3.js").Transaction, strategy: SigningStrategy): Promise<string>;
 //# sourceMappingURL=context.d.ts.map

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,cAAc,EAAE,MAAM,UAAU,CAAC;AAC9D,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;IACpC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;IAEpE,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;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,aAAa,EAClB,EAAE,EAAE,OAAO,iBAAiB,EAAE,WAAW,GACxC,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,aAAa,EAClB,EAAE,EAAE,OAAO,iBAAiB,EAAE,WAAW,GACxC,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,gCAAgC,CACpD,GAAG,EAAE,aAAa,EAClB,EAAE,EAAE,OAAO,iBAAiB,EAAE,WAAW,GACxC,OAAO,CAAC,oBAAoB,CAAC,CAY/B"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}