@lightconexyz/lightcone-sdk 0.8.2 → 0.8.3-rc.44

package/README.md

@@ -229,12 +229,15 @@ signed-64-bit admission rules; no tick or size normalization is implicit.
 `native_sol_balance` alongside the separate mint-keyed SPL map. Initialize
 `WalletDepositBalancesState` with `applyRestSnapshot(wallet, snapshot)` and feed
 the outer `wallet_deposit_balances` channel's nested snapshot, absolute SPL,
-absolute native-SOL, and status events to `applyEvent()`. Complete snapshots
-replace state even after a higher component slot; status and wrong-wallet events
-do not mutate it, pre-baseline component updates are ignored, and explicit-zero
-SPL updates remove their mint. Matching SPL updates with invalid or negative
+absolute native-SOL, and status events to `applyEvent()`. Both methods accept an
+optional minimum snapshot slot; only a complete snapshot below that floor is
+ignored without mutation, while an equal slot and every balance/status event
+keep their existing behavior. Without a floor, complete snapshots replace state
+even after a higher incremental-update slot. Status and wrong-wallet events do not mutate
+it, pre-baseline balance updates are ignored, and explicit-zero SPL updates
+remove their mint. Matching SPL updates with invalid or negative
 idle balances return `rejected` without mutation. `contextSlot` records the latest accepted
-component observation rather than enforcing global monotonic ordering.
+balance observation rather than enforcing global monotonic ordering.
 `combinedSolBalance()` sums native SOL and canonical WSOL with `bigint` precision
 while retaining both stored values. REST response types are trusted rather than
 runtime-decoded; WebSocket frames are validated strictly, while malformed REST
@@ -281,7 +284,7 @@ Unwrap-all accepts no partial amount and closes the entire positive canonical
 account back to the same wallet. Its `SolActionCosts` fields contain the fresh fee, zero
 upfront rent, no account creation, and no sponsorship. Availability reserves
 only that fee rather than the ordinary persistent-account floor;
-`unwrapAllSolBalanceAvailability(components, costs)` validates that complete
+`unwrapAllSolBalanceAvailability(breakdown, costs)` validates that complete
 cost tuple before deriving fee-only fields. The
 native delta credits every live account lamport, including refunded rent or
 direct donations, minus the fee and removes the full canonical token amount.
@@ -500,7 +503,7 @@ excluded from routine example runs.
 |---------|-------------|
 | [`ws_book_and_trades`](examples/ws_book_and_trades.ts) | Live orderbook depth with `OrderbookState` state + rolling `TradeHistory` buffer |
 | [`ws_ticker_and_prices`](examples/ws_ticker_and_prices.ts) | Best bid/ask ticker + price history candles with `PriceHistoryState` |
-| [`ws_user_and_market`](examples/ws_user_and_market.ts) | Authenticated user stream (orders, balances) + market lifecycle events |
+| [`ws_user_and_market`](examples/ws_user_and_market.ts) | Read-only authenticated user/market subscriptions plus one reduced Trading Wallet balance snapshot |
 
 ## Error Handling
 

package/dist/domain/position/client.d.ts

@@ -14,8 +14,8 @@ import { DepositBuilder, MergeBuilder, WithdrawBuilder, RedeemWinningsBuilder, W
  * closure.
  */
 export type SolActionKind = "split" | "merge" | "redeem" | "nativeWithdraw" | "wrap" | "unwrapAll";
-/** Expected changes to the separately authoritative SOL components. */
-export interface SolComponentDelta {
+/** Expected changes to the separately authoritative SOL balances. */
+export interface SolBalanceDelta {
     /** System-account change in lamports, including unsponsored costs. */
     nativeLamports: bigint;
     /** Persistent canonical WSOL ATA change in lamports. */
@@ -29,10 +29,10 @@ export interface SolActionPlan {
     transaction: Transaction;
     /** Live fee/rent observations and explicit sponsorship capability. */
     costs: SolActionCosts;
-    /** Component totals after action-specific native reserve. */
+    /** Balance totals after action-specific native reserve. */
     availability: SolBalanceAvailability;
-    /** Component-wise projection that does not replace authoritative state. */
-    expectedDelta: SolComponentDelta;
+    /** Balance projection that does not replace authoritative state. */
+    expectedDelta: SolBalanceDelta;
 }
 /**
  * Derive the cross-SDK temporary-account seed for native withdrawal.
@@ -93,7 +93,7 @@ export declare class Positions {
     /**
      * Fetch a complete authenticated SPL and native-SOL balance snapshot.
      *
-     * `minContextSlot` lower-bounds the cross-component snapshot. Native SOL is
+     * `minContextSlot` lower-bounds the complete balance snapshot. Native SOL is
      * required canonical nine-decimal text and remains outside the SPL map. The
      * generic HTTP layer trusts that shape at runtime; WebSocket frames are decoded
      * strictly, while malformed REST exact values fail later when state scales them.
@@ -124,7 +124,7 @@ export declare class Positions {
      * and `SyncNative`. Availability uses the ordinary reserve floor.
      *
      * Callers rebuild immediately before prepared submission. They retain the
-     * returned component projection until a complete snapshot covers the confirmed
+     * returned balance projection until a complete snapshot covers the confirmed
      * slot. An uncertain outcome requires authoritative refresh before another plan.
      */
     planWrapSol(amountLamports: bigint, state: WalletDepositBalancesState): Promise<SolActionPlan>;
@@ -140,7 +140,7 @@ export declare class Positions {
      * native SOL to fund that fee without relying on the later account transfer.
      *
      * Callers rebuild immediately before prepared submission. They retain the
-     * returned component projection until a complete snapshot covers the confirmed
+     * returned balance projection until a complete snapshot covers the confirmed
      * slot. Signing, submission, or confirmation uncertainty requires authoritative
      * refresh and does not authorize automatic resubmission.
      */
@@ -207,7 +207,7 @@ export declare class Positions {
     private createCanonicalWsolAccount;
     /** Read canonical-account existence and upfront rent for merge/redeem plans. */
     private receivePlanContext;
-    /** Finish merge/redeem planning with live fee authority and component deltas. */
+    /** Finish merge/redeem planning with live fee authority and balance deltas. */
     private finishReceivePlan;
     /**
      * Build the sole WSOL-to-native path without closing canonical authority.

package/dist/domain/position/client.d.ts.map

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

package/dist/domain/position/client.js

@@ -152,7 +152,7 @@ class Positions {
     /**
      * Fetch a complete authenticated SPL and native-SOL balance snapshot.
      *
-     * `minContextSlot` lower-bounds the cross-component snapshot. Native SOL is
+     * `minContextSlot` lower-bounds the complete balance snapshot. Native SOL is
      * required canonical nine-decimal text and remains outside the SPL map. The
      * generic HTTP layer trusts that shape at runtime; WebSocket frames are decoded
      * strictly, while malformed REST exact values fail later when state scales them.
@@ -195,21 +195,21 @@ class Positions {
      * and `SyncNative`. Availability uses the ordinary reserve floor.
      *
      * Callers rebuild immediately before prepared submission. They retain the
-     * returned component projection until a complete snapshot covers the confirmed
+     * returned balance projection until a complete snapshot covers the confirmed
      * slot. An uncertain outcome requires authoritative refresh before another plan.
      */
     async planWrapSol(amountLamports, state) {
         assertSolActionAmount(amountLamports, "wrap");
         const wallet = this.conversionPlanningWallet(state);
-        const components = state.solComponents();
+        const breakdown = state.solBalanceBreakdown();
         const rpc = new rpc_1.Rpc(this.client);
         const canonical = (0, spl_token_1.getAssociatedTokenAddressSync)(spl_token_1.NATIVE_MINT, wallet);
         const account = await rpc.canonicalWsolAccountInfo(canonical, wallet);
-        if (!account && components.canonicalWsolLamports > 0n) {
+        if (!account && breakdown.canonicalWsolLamports > 0n) {
             throw error_1.SdkError.validation("canonical WSOL balance is positive but its account is unavailable");
         }
         if (account &&
-            account.tokenAmountLamports !== components.canonicalWsolLamports) {
+            account.tokenAmountLamports !== breakdown.canonicalWsolLamports) {
             throw error_1.SdkError.validation("live canonical WSOL amount does not match wallet balance state");
         }
         if (account &&
@@ -234,12 +234,12 @@ class Positions {
             createsCanonicalWsolAccount,
             sponsored: false,
         };
-        const availability = (0, state_1.solBalanceAvailability)(components, costs);
+        const availability = (0, state_1.solBalanceAvailability)(breakdown, costs);
         const requiredNativeLamports = amountLamports + availability.reserveLamports;
         if (requiredNativeLamports > MAX_U64) {
             throw error_1.SdkError.validation("wrap amount and transaction reserve exceed u64 lamports");
         }
-        if (components.nativeLamports < requiredNativeLamports) {
+        if (breakdown.nativeLamports < requiredNativeLamports) {
             throw error_1.SdkError.validation("native SOL cannot fund the wrap amount and transaction reserve");
         }
         return {
@@ -265,14 +265,14 @@ class Positions {
      * native SOL to fund that fee without relying on the later account transfer.
      *
      * Callers rebuild immediately before prepared submission. They retain the
-     * returned component projection until a complete snapshot covers the confirmed
+     * returned balance projection until a complete snapshot covers the confirmed
      * slot. Signing, submission, or confirmation uncertainty requires authoritative
      * refresh and does not authorize automatic resubmission.
      */
     async planUnwrapWsolAll(state) {
         const wallet = this.conversionPlanningWallet(state);
-        const components = state.solComponents();
-        if (components.canonicalWsolLamports === 0n) {
+        const breakdown = state.solBalanceBreakdown();
+        if (breakdown.canonicalWsolLamports === 0n) {
             throw error_1.SdkError.validation("unwrap-all requires a positive canonical WSOL balance");
         }
         const rpc = new rpc_1.Rpc(this.client);
@@ -281,7 +281,7 @@ class Positions {
         if (!account) {
             throw error_1.SdkError.validation("canonical WSOL account is required for unwrap-all");
         }
-        if (account.tokenAmountLamports !== components.canonicalWsolLamports) {
+        if (account.tokenAmountLamports !== breakdown.canonicalWsolLamports) {
             throw error_1.SdkError.validation("live canonical WSOL amount does not match wallet balance state");
         }
         const transaction = this.buildUnwrapWsolAllTransaction(wallet);
@@ -294,8 +294,8 @@ class Positions {
         };
         // Unwrap-all removes the persistent account, so its availability validates
         // SolActionCosts and reserves the fee without the ordinary account floor.
-        const availability = (0, state_1.unwrapAllSolBalanceAvailability)(components, costs);
-        const projectedNativeLamports = components.nativeLamports + account.accountLamports - feeLamports;
+        const availability = (0, state_1.unwrapAllSolBalanceAvailability)(breakdown, costs);
+        const projectedNativeLamports = breakdown.nativeLamports + account.accountLamports - feeLamports;
         if (projectedNativeLamports > MAX_U64) {
             throw error_1.SdkError.validation("unwrap-all projected native SOL exceeds the transaction u64 range");
         }
@@ -306,7 +306,7 @@ class Positions {
             availability,
             expectedDelta: {
                 nativeLamports: account.accountLamports - feeLamports,
-                canonicalWsolLamports: -components.canonicalWsolLamports,
+                canonicalWsolLamports: -breakdown.canonicalWsolLamports,
             },
         };
     }
@@ -319,15 +319,15 @@ class Positions {
         assertUnsponsoredPlan(sponsored);
         assertSolActionAmount(amountLamports, "split");
         const wallet = this.planningWallet(state);
-        const components = state.solComponents();
+        const breakdown = state.solBalanceBreakdown();
         const rpc = new rpc_1.Rpc(this.client);
         const canonical = (0, spl_token_1.getAssociatedTokenAddressSync)(spl_token_1.NATIVE_MINT, wallet);
         const canonicalExists = await rpc.canonicalWsolAccountExists(canonical, wallet);
-        if (components.canonicalWsolLamports > 0n && !canonicalExists) {
+        if (breakdown.canonicalWsolLamports > 0n && !canonicalExists) {
             throw error_1.SdkError.validation("canonical WSOL balance is positive but its account is unavailable");
         }
-        const shortfall = amountLamports > components.canonicalWsolLamports
-            ? amountLamports - components.canonicalWsolLamports
+        const shortfall = amountLamports > breakdown.canonicalWsolLamports
+            ? amountLamports - breakdown.canonicalWsolLamports
             : 0n;
         const upfrontRentLamports = canonicalExists
             ? 0n
@@ -352,11 +352,11 @@ class Positions {
             createsCanonicalWsolAccount: !canonicalExists,
             sponsored,
         };
-        const availability = (0, state_1.solBalanceAvailability)(components, costs);
+        const availability = (0, state_1.solBalanceAvailability)(breakdown, costs);
         if (amountLamports > availability.spendableLamports) {
             throw error_1.SdkError.validation("split amount exceeds spendable SOL after transaction reserve");
         }
-        if (shortfall + availability.reserveLamports > components.nativeLamports) {
+        if (shortfall + availability.reserveLamports > breakdown.nativeLamports) {
             throw error_1.SdkError.validation("native SOL cannot fund the wrap shortfall and transaction reserve");
         }
         const walletCosts = sponsored ? 0n : feeLamports + upfrontRentLamports;
@@ -381,7 +381,7 @@ class Positions {
         assertSolActionAmount(amountLamports, "merge");
         const wallet = this.planningWallet(state);
         const transaction = new web3_js_1.Transaction({ feePayer: wallet });
-        const { rpc, components, canonicalExists, upfrontRentLamports } = await this.receivePlanContext(wallet, state);
+        const { rpc, breakdown, canonicalExists, upfrontRentLamports } = await this.receivePlanContext(wallet, state);
         if (!canonicalExists) {
             transaction.add(this.createCanonicalWsolAccount(wallet));
         }
@@ -391,7 +391,7 @@ class Positions {
             depositMint: spl_token_1.NATIVE_MINT,
             amount: amountLamports,
         }, market.numOutcomes, this.client.programId));
-        return this.finishReceivePlan("merge", amountLamports, transaction, rpc, components, upfrontRentLamports, !canonicalExists, sponsored);
+        return this.finishReceivePlan("merge", amountLamports, transaction, rpc, breakdown, upfrontRentLamports, !canonicalExists, sponsored);
     }
     /**
      * Plan a redemption that leaves returned WSOL in the persistent canonical ATA.
@@ -405,7 +405,7 @@ class Positions {
         (0, utils_1.validateOutcomeIndex)(outcomeIndex, numOutcomes);
         const wallet = this.planningWallet(state);
         const transaction = new web3_js_1.Transaction({ feePayer: wallet });
-        const { rpc, components, canonicalExists, upfrontRentLamports } = await this.receivePlanContext(wallet, state);
+        const { rpc, breakdown, canonicalExists, upfrontRentLamports } = await this.receivePlanContext(wallet, state);
         if (!canonicalExists) {
             transaction.add(this.createCanonicalWsolAccount(wallet));
         }
@@ -415,7 +415,7 @@ class Positions {
             depositMint: spl_token_1.NATIVE_MINT,
             amount: amountLamports,
         }, outcomeIndex, this.client.programId));
-        return this.finishReceivePlan("redeem", amountLamports, transaction, rpc, components, upfrontRentLamports, !canonicalExists, sponsored);
+        return this.finishReceivePlan("redeem", amountLamports, transaction, rpc, breakdown, upfrontRentLamports, !canonicalExists, sponsored);
     }
     /**
      * Plan exact native SOL delivery without closing the canonical WSOL ATA.
@@ -430,7 +430,7 @@ class Positions {
         assertUnsponsoredPlan(sponsored);
         assertSolActionAmount(amountLamports, "withdraw");
         const wallet = this.planningWallet(state);
-        const components = state.solComponents();
+        const breakdown = state.solBalanceBreakdown();
         const rpc = new rpc_1.Rpc(this.client);
         const direct = new web3_js_1.Transaction({ feePayer: wallet }).add(web3_js_1.SystemProgram.transfer({ fromPubkey: wallet, toPubkey: recipient, lamports: amountLamports }));
         const directFee = await rpc.prepareAndEstimateTransactionFee(direct);
@@ -440,11 +440,11 @@ class Positions {
             createsCanonicalWsolAccount: false,
             sponsored,
         };
-        const directAvailability = (0, state_1.solBalanceAvailability)(components, directCosts);
+        const directAvailability = (0, state_1.solBalanceAvailability)(breakdown, directCosts);
         if (amountLamports > directAvailability.spendableLamports) {
             throw error_1.SdkError.validation("withdraw amount exceeds spendable SOL after transaction reserve");
         }
-        if (components.nativeLamports >=
+        if (breakdown.nativeLamports >=
             amountLamports + directAvailability.reserveLamports) {
             return {
                 kind: "nativeWithdraw",
@@ -488,12 +488,12 @@ class Positions {
             createsCanonicalWsolAccount: false,
             sponsored,
         };
-        const initialAvailability = (0, state_1.solBalanceAvailability)(components, initialCosts);
+        const initialAvailability = (0, state_1.solBalanceAvailability)(breakdown, initialCosts);
         const initialRequired = amountLamports + initialAvailability.reserveLamports;
-        if (initialRequired < components.nativeLamports) {
+        if (initialRequired < breakdown.nativeLamports) {
             throw error_1.SdkError.validation("invalid temporary withdrawal requirement");
         }
-        const initialTransfer = initialRequired - components.nativeLamports;
+        const initialTransfer = initialRequired - breakdown.nativeLamports;
         transaction = this.buildTemporaryNativeWithdrawal(wallet, recipient, amountLamports, initialTransfer, temporaryRent, seed, temporary);
         transaction.recentBlockhash = blockhash;
         transaction.lastValidBlockHeight = lastValidBlockHeight;
@@ -504,13 +504,13 @@ class Positions {
             createsCanonicalWsolAccount: false,
             sponsored,
         };
-        const availability = (0, state_1.solBalanceAvailability)(components, costs);
+        const availability = (0, state_1.solBalanceAvailability)(breakdown, costs);
         const finalRequired = amountLamports + availability.reserveLamports;
-        if (finalRequired < components.nativeLamports) {
+        if (finalRequired < breakdown.nativeLamports) {
             throw error_1.SdkError.validation("invalid temporary withdrawal requirement");
         }
-        const canonicalTransfer = finalRequired - components.nativeLamports;
-        if (canonicalTransfer > components.canonicalWsolLamports) {
+        const canonicalTransfer = finalRequired - breakdown.nativeLamports;
+        if (canonicalTransfer > breakdown.canonicalWsolLamports) {
             throw error_1.SdkError.validation("canonical WSOL cannot fund the native withdrawal shortfall");
         }
         if (canonicalTransfer !== initialTransfer) {
@@ -631,21 +631,21 @@ class Positions {
         const rpc = new rpc_1.Rpc(this.client);
         const canonical = (0, spl_token_1.getAssociatedTokenAddressSync)(spl_token_1.NATIVE_MINT, wallet);
         const canonicalExists = await rpc.canonicalWsolAccountExists(canonical, wallet);
-        const components = state.solComponents();
-        if (components.canonicalWsolLamports > 0n && !canonicalExists) {
+        const breakdown = state.solBalanceBreakdown();
+        if (breakdown.canonicalWsolLamports > 0n && !canonicalExists) {
             throw error_1.SdkError.validation("canonical WSOL balance is positive but its account is unavailable");
         }
         return {
             rpc,
-            components,
+            breakdown,
             canonicalExists,
             upfrontRentLamports: canonicalExists
                 ? 0n
                 : await rpc.minimumBalanceForRentExemption(TOKEN_ACCOUNT_SPACE),
         };
     }
-    /** Finish merge/redeem planning with live fee authority and component deltas. */
-    async finishReceivePlan(kind, amountLamports, transaction, rpc, components, upfrontRentLamports, createsCanonicalWsolAccount, sponsored) {
+    /** Finish merge/redeem planning with live fee authority and balance deltas. */
+    async finishReceivePlan(kind, amountLamports, transaction, rpc, breakdown, upfrontRentLamports, createsCanonicalWsolAccount, sponsored) {
         const feeLamports = await rpc.prepareAndEstimateTransactionFee(transaction);
         const costs = {
             feeLamports,
@@ -653,7 +653,7 @@ class Positions {
             createsCanonicalWsolAccount,
             sponsored,
         };
-        const availability = (0, state_1.solBalanceAvailability)(components, costs);
+        const availability = (0, state_1.solBalanceAvailability)(breakdown, costs);
         const walletCosts = sponsored ? 0n : feeLamports + upfrontRentLamports;
         return {
             kind,