@lightconexyz/lightcone-sdk 0.8.1 → 0.8.2

package/dist/domain/orderbook/wire.js.map

@@ -1 +1 @@
-{"version":3,"file":"wire.js","sourceRoot":"","sources":["../../../src/domain/orderbook/wire.ts"],"names":[],"mappings":";;AAkFA,oDA0BC;AAED,wDAkBC;AA9CD,SAAgB,oBAAoB,CAAC,IAAsB;IACzD,IACE,CAAC,IAAI;QACL,CAAC,wBAAwB,CAAC,IAAI,CAAC,kBAAkB,CAAC;QAClD,CAAC,wBAAwB,CAAC,IAAI,CAAC,kBAAkB,CAAC;QAClD,CAAC,wBAAwB,CAAC,IAAI,CAAC,6BAA6B,CAAC;QAC7D,OAAO,IAAI,CAAC,6BAA6B,KAAK,SAAS;QACvD,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ;QACtC,OAAO,IAAI,CAAC,iBAAiB,KAAK,QAAQ;QAC1C,OAAO,IAAI,CAAC,iBAAiB,KAAK,QAAQ;QAC1C,OAAO,IAAI,CAAC,qBAAqB,KAAK,QAAQ;QAC9C,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC;QACrC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,EACzC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO;QACL,gBAAgB,EAAE,IAAI,CAAC,kBAAkB;QACzC,gBAAgB,EAAE,IAAI,CAAC,kBAAkB;QACzC,0BAA0B,EAAE,IAAI,CAAC,6BAA6B;QAC9D,0BAA0B,EAAE,IAAI,CAAC,6BAA6B;QAC9D,YAAY,EAAE,IAAI,CAAC,aAAa;QAChC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC;QAC/C,eAAe,EAAE,IAAI,CAAC,iBAAiB;QACvC,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,SAAgB,sBAAsB,CAAC,IAAsB;IAC3D,IACE,CAAC,IAAI;QACL,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ;QACrC,CAAC,wBAAwB,CAAC,IAAI,CAAC,aAAa,CAAC;QAC7C,CAAC,wBAAwB,CAAC,IAAI,CAAC,cAAc,CAAC;QAC9C,CAAC,wBAAwB,CAAC,IAAI,CAAC,cAAc,CAAC;QAC9C,CAAC,IAAI,CAAC,aAAa,EACnB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,YAAY;QAC9B,YAAY,EAAE,IAAI,CAAC,aAAa;QAChC,aAAa,EAAE,IAAI,CAAC,cAAc;QAClC,aAAa,EAAE,IAAI,CAAC,cAAc;QAClC,YAAY,EAAE,oBAAoB,CAAC,IAAI,CAAC,aAAa,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAc;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAChF,CAAC","sourcesContent":["import type { OrderBookId, OrderbookRules, Side, TradingRules } from \"../../shared\";\n\nexport interface TradingRulesWire {\n  base_size_decimals: number;\n  max_price_decimals: number;\n  max_price_significant_figures: number;\n  integer_prices_always_allowed: boolean;\n  price_quantum: string;\n  price_quantum_raw: string;\n  base_size_quantum: string;\n  base_size_quantum_raw: string;\n}\n\nexport interface OrderbookResponse {\n  id: number;\n  market_pubkey: string;\n  orderbook_id: string;\n  base_token: string;\n  quote_token: string;\n  outcome_index?: number;\n  tick_size: number;\n  total_bids: number;\n  total_asks: number;\n  last_trade_price?: string;\n  last_trade_time?: string;\n  active: boolean;\n  created_at: string;\n  updated_at: string;\n}\n\nexport interface OrderbooksResponse {\n  orderbooks: OrderbookResponse[];\n  total: number;\n}\n\nexport interface RestBookLevel {\n  price: string;\n  size: string;\n  orders?: number;\n}\n\n/**\n * REST depth response. Depth is capped server-side at 20 levels per side.\n */\nexport interface OrderbookDepthResponse {\n  orderbook_id: OrderBookId;\n  market_pubkey?: string;\n  best_bid?: string;\n  best_ask?: string;\n  spread?: string;\n  /** Deprecated backend alias; never use for order admission. */\n  tick_size?: string;\n  price_quantum: string;\n  /** Parsed exact rules; raw quantum strings are exposed as bigint values. */\n  trading_rules: TradingRules;\n  bids_truncated: boolean;\n  asks_truncated: boolean;\n  revision: bigint;\n  captured_at_ms: bigint;\n  bids: RestBookLevel[];\n  asks: RestBookLevel[];\n  /** Required display decimals; size is base-token on-chain precision. */\n  decimals: OrderbookDepthDecimals;\n}\n\n/**\n * Price/size display decimals from the depth endpoint. Distinct from\n * `DecimalsResponse` (the `/decimals` endpoint).\n */\nexport interface OrderbookDepthDecimals {\n  price: number;\n  size: number;\n}\n\nexport interface DecimalsResponse {\n  orderbook_id: string;\n  base_decimals: number;\n  quote_decimals: number;\n  price_decimals: number;\n  trading_rules: TradingRulesWire;\n}\n\nexport function tradingRulesFromWire(wire: TradingRulesWire): TradingRules {\n  if (\n    !wire ||\n    !isNonNegativeSafeInteger(wire.base_size_decimals) ||\n    !isNonNegativeSafeInteger(wire.max_price_decimals) ||\n    !isNonNegativeSafeInteger(wire.max_price_significant_figures) ||\n    typeof wire.integer_prices_always_allowed !== \"boolean\" ||\n    typeof wire.price_quantum !== \"string\" ||\n    typeof wire.base_size_quantum !== \"string\" ||\n    typeof wire.price_quantum_raw !== \"string\" ||\n    typeof wire.base_size_quantum_raw !== \"string\" ||\n    !/^\\d+$/.test(wire.price_quantum_raw) ||\n    !/^\\d+$/.test(wire.base_size_quantum_raw)\n  ) {\n    throw new Error(\"invalid trading_rules response\");\n  }\n  return {\n    baseSizeDecimals: wire.base_size_decimals,\n    maxPriceDecimals: wire.max_price_decimals,\n    maxPriceSignificantFigures: wire.max_price_significant_figures,\n    integerPricesAlwaysAllowed: wire.integer_prices_always_allowed,\n    priceQuantum: wire.price_quantum,\n    priceQuantumRaw: BigInt(wire.price_quantum_raw),\n    baseSizeQuantum: wire.base_size_quantum,\n    baseSizeQuantumRaw: BigInt(wire.base_size_quantum_raw),\n  };\n}\n\nexport function orderbookRulesFromWire(wire: DecimalsResponse): OrderbookRules {\n  if (\n    !wire ||\n    typeof wire.orderbook_id !== \"string\" ||\n    !isNonNegativeSafeInteger(wire.base_decimals) ||\n    !isNonNegativeSafeInteger(wire.quote_decimals) ||\n    !isNonNegativeSafeInteger(wire.price_decimals) ||\n    !wire.trading_rules\n  ) {\n    throw new Error(\"invalid orderbook decimals response\");\n  }\n  return {\n    orderbookId: wire.orderbook_id,\n    baseDecimals: wire.base_decimals,\n    quoteDecimals: wire.quote_decimals,\n    priceDecimals: wire.price_decimals,\n    tradingRules: tradingRulesFromWire(wire.trading_rules),\n  };\n}\n\nfunction isNonNegativeSafeInteger(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n}\n\nexport interface WsBookLevel {\n  side: Side;\n  price: string;\n  size: string;\n}\n\n/**\n * WS orderbook snapshot frame.\n *\n * The stream is snapshot-only: every data frame carries the full top-20\n * levels per side and replaces the previous book wholesale. `seq` is the\n * engine depth revision and is monotonic only within one subscription generation.\n */\nexport interface OrderBook {\n  orderbook_id: OrderBookId;\n  is_snapshot?: boolean;\n  seq: bigint;\n  resync?: boolean;\n  timestamp?: string;\n  bids: WsBookLevel[];\n  asks: WsBookLevel[];\n  bids_truncated?: boolean;\n  asks_truncated?: boolean;\n  /**\n   * Aggregation tags echoed by the backend (omitted = full precision).\n   * Always normalized server-side ((5, none) arrives as (5, 1)). Use\n   * `aggregationFromFrame(book.n_sig_figs, book.mantissa)` to key\n   * per-`(orderbook, aggregation)` book state.\n   */\n  n_sig_figs?: number;\n  mantissa?: number;\n}\n\nexport interface WsTickerData {\n  orderbook_id: OrderBookId;\n  best_bid?: string;\n  best_ask?: string;\n  mid?: string;\n  timestamp?: string;\n}\n"]}
+{"version":3,"file":"wire.js","sourceRoot":"","sources":["../../../src/domain/orderbook/wire.ts"],"names":[],"mappings":";;AAkFA,oDA0BC;AAED,wDAkBC;AA9CD,SAAgB,oBAAoB,CAAC,IAAsB;IACzD,IACE,CAAC,IAAI;QACL,CAAC,wBAAwB,CAAC,IAAI,CAAC,kBAAkB,CAAC;QAClD,CAAC,wBAAwB,CAAC,IAAI,CAAC,kBAAkB,CAAC;QAClD,CAAC,wBAAwB,CAAC,IAAI,CAAC,6BAA6B,CAAC;QAC7D,OAAO,IAAI,CAAC,6BAA6B,KAAK,SAAS;QACvD,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ;QACtC,OAAO,IAAI,CAAC,iBAAiB,KAAK,QAAQ;QAC1C,OAAO,IAAI,CAAC,iBAAiB,KAAK,QAAQ;QAC1C,OAAO,IAAI,CAAC,qBAAqB,KAAK,QAAQ;QAC9C,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC;QACrC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,EACzC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO;QACL,gBAAgB,EAAE,IAAI,CAAC,kBAAkB;QACzC,gBAAgB,EAAE,IAAI,CAAC,kBAAkB;QACzC,0BAA0B,EAAE,IAAI,CAAC,6BAA6B;QAC9D,0BAA0B,EAAE,IAAI,CAAC,6BAA6B;QAC9D,YAAY,EAAE,IAAI,CAAC,aAAa;QAChC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC;QAC/C,eAAe,EAAE,IAAI,CAAC,iBAAiB;QACvC,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,SAAgB,sBAAsB,CAAC,IAAsB;IAC3D,IACE,CAAC,IAAI;QACL,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ;QACrC,CAAC,wBAAwB,CAAC,IAAI,CAAC,aAAa,CAAC;QAC7C,CAAC,wBAAwB,CAAC,IAAI,CAAC,cAAc,CAAC;QAC9C,CAAC,wBAAwB,CAAC,IAAI,CAAC,cAAc,CAAC;QAC9C,CAAC,IAAI,CAAC,aAAa,EACnB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,YAAY;QAC9B,YAAY,EAAE,IAAI,CAAC,aAAa;QAChC,aAAa,EAAE,IAAI,CAAC,cAAc;QAClC,aAAa,EAAE,IAAI,CAAC,cAAc;QAClC,YAAY,EAAE,oBAAoB,CAAC,IAAI,CAAC,aAAa,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAc;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAChF,CAAC","sourcesContent":["import type { OrderBookId, OrderbookRules, Side, TradingRules } from \"../../shared\";\n\nexport interface TradingRulesWire {\n  base_size_decimals: number;\n  max_price_decimals: number;\n  max_price_significant_figures: number;\n  integer_prices_always_allowed: boolean;\n  price_quantum: string;\n  price_quantum_raw: string;\n  base_size_quantum: string;\n  base_size_quantum_raw: string;\n}\n\nexport interface OrderbookResponse {\n  id: number;\n  market_pubkey: string;\n  orderbook_id: string;\n  base_token: string;\n  quote_token: string;\n  outcome_index?: number;\n  tick_size: number;\n  total_bids: number;\n  total_asks: number;\n  last_trade_price?: string;\n  last_trade_time?: string;\n  active: boolean;\n  created_at: string;\n  updated_at: string;\n}\n\nexport interface OrderbooksResponse {\n  orderbooks: OrderbookResponse[];\n  total: number;\n}\n\nexport interface RestBookLevel {\n  price: string;\n  size: string;\n  orders?: number;\n}\n\n/**\n * REST depth response. Depth is capped server-side at 20 levels per side.\n */\nexport interface OrderbookDepthResponse {\n  orderbook_id: OrderBookId;\n  market_pubkey?: string;\n  best_bid?: string;\n  best_ask?: string;\n  spread?: string;\n  /** Deprecated backend alias; never use for order admission. */\n  tick_size?: string;\n  price_quantum: string;\n  /** Parsed exact rules; raw quantum strings are exposed as bigint values. */\n  trading_rules: TradingRules;\n  bids_truncated: boolean;\n  asks_truncated: boolean;\n  revision: bigint;\n  captured_at_ms: bigint;\n  bids: RestBookLevel[];\n  asks: RestBookLevel[];\n  /** Required display decimals; size is base-token on-chain precision. */\n  decimals: OrderbookDepthDecimals;\n}\n\n/**\n * Price/size display decimals from the depth endpoint. Distinct from\n * `DecimalsResponse` (the `/decimals` endpoint).\n */\nexport interface OrderbookDepthDecimals {\n  price: number;\n  size: number;\n}\n\nexport interface DecimalsResponse {\n  orderbook_id: string;\n  base_decimals: number;\n  quote_decimals: number;\n  price_decimals: number;\n  trading_rules: TradingRulesWire;\n}\n\nexport function tradingRulesFromWire(wire: TradingRulesWire): TradingRules {\n  if (\n    !wire ||\n    !isNonNegativeSafeInteger(wire.base_size_decimals) ||\n    !isNonNegativeSafeInteger(wire.max_price_decimals) ||\n    !isNonNegativeSafeInteger(wire.max_price_significant_figures) ||\n    typeof wire.integer_prices_always_allowed !== \"boolean\" ||\n    typeof wire.price_quantum !== \"string\" ||\n    typeof wire.base_size_quantum !== \"string\" ||\n    typeof wire.price_quantum_raw !== \"string\" ||\n    typeof wire.base_size_quantum_raw !== \"string\" ||\n    !/^\\d+$/.test(wire.price_quantum_raw) ||\n    !/^\\d+$/.test(wire.base_size_quantum_raw)\n  ) {\n    throw new Error(\"invalid trading_rules response\");\n  }\n  return {\n    baseSizeDecimals: wire.base_size_decimals,\n    maxPriceDecimals: wire.max_price_decimals,\n    maxPriceSignificantFigures: wire.max_price_significant_figures,\n    integerPricesAlwaysAllowed: wire.integer_prices_always_allowed,\n    priceQuantum: wire.price_quantum,\n    priceQuantumRaw: BigInt(wire.price_quantum_raw),\n    baseSizeQuantum: wire.base_size_quantum,\n    baseSizeQuantumRaw: BigInt(wire.base_size_quantum_raw),\n  };\n}\n\nexport function orderbookRulesFromWire(wire: DecimalsResponse): OrderbookRules {\n  if (\n    !wire ||\n    typeof wire.orderbook_id !== \"string\" ||\n    !isNonNegativeSafeInteger(wire.base_decimals) ||\n    !isNonNegativeSafeInteger(wire.quote_decimals) ||\n    !isNonNegativeSafeInteger(wire.price_decimals) ||\n    !wire.trading_rules\n  ) {\n    throw new Error(\"invalid orderbook decimals response\");\n  }\n  return {\n    orderbookId: wire.orderbook_id,\n    baseDecimals: wire.base_decimals,\n    quoteDecimals: wire.quote_decimals,\n    priceDecimals: wire.price_decimals,\n    tradingRules: tradingRulesFromWire(wire.trading_rules),\n  };\n}\n\nfunction isNonNegativeSafeInteger(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n}\n\nexport interface WsBookLevel {\n  side: Side;\n  price: string;\n  size: string;\n  /**\n   * Exact quote-token amount represented by the underlying maker orders.\n   * For grouped books this is independent of the displayed bucket price.\n   */\n  quote_notional: string;\n}\n\n/**\n * WS orderbook snapshot frame.\n *\n * The stream is snapshot-only: every data frame carries the full top-20\n * levels per side and replaces the previous book wholesale. `seq` is the\n * engine depth revision and is monotonic only within one subscription generation.\n */\nexport interface OrderBook {\n  orderbook_id: OrderBookId;\n  is_snapshot?: boolean;\n  seq: bigint;\n  resync?: boolean;\n  timestamp?: string;\n  bids: WsBookLevel[];\n  asks: WsBookLevel[];\n  bids_truncated?: boolean;\n  asks_truncated?: boolean;\n  /**\n   * Aggregation tags echoed by the backend (omitted = full precision).\n   * Always normalized server-side ((5, none) arrives as (5, 1)). Use\n   * `aggregationFromFrame(book.n_sig_figs, book.mantissa)` to key\n   * per-`(orderbook, aggregation)` book state.\n   */\n  n_sig_figs?: number;\n  mantissa?: number;\n}\n\nexport interface WsTickerData {\n  orderbook_id: OrderBookId;\n  best_bid?: string;\n  best_ask?: string;\n  mid?: string;\n  timestamp?: string;\n}\n"]}

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

@@ -1,9 +1,57 @@
 import { PublicKey, Transaction, type TransactionInstruction } from "@solana/web3.js";
 import type { ClientContext } from "../../context";
 import type { Position as ProgramPosition, RedeemWinningsParams, WithdrawConditionalFromPositionParams, WithdrawFromPositionParams, InitPositionTokensParams, ExtendPositionTokensParams, DepositToGlobalParams, DepositToGlobalAltContext, GlobalToMarketDepositParams, WithdrawFromGlobalParams, ClosePositionAltParams, ClosePositionTokenAccountsParams } from "../../program/types";
+import type { Market } from "../market";
 import type { DepositTokenBalancesSnapshot } from "./index";
+import { type SolActionCosts, type SolBalanceAvailability, type WalletDepositBalancesState } from "./state";
 import type { MarketPositionsResponse, PositionsResponse } from "./wire";
 import { DepositBuilder, MergeBuilder, WithdrawBuilder, RedeemWinningsBuilder, WithdrawFromPositionBuilder, InitPositionTokensBuilder, ExtendPositionTokensBuilder, DepositToGlobalBuilder, WithdrawFromGlobalBuilder, GlobalToMarketDepositBuilder } from "./builders";
+/**
+ * Identifies the SOL-aware operation represented by an action plan.
+ *
+ * `wrap` and `unwrapAll` identify explicit native-keypair conversion plans.
+ * Ordinary plan kinds do not call those planners or include canonical-account
+ * closure.
+ */
+export type SolActionKind = "split" | "merge" | "redeem" | "nativeWithdraw" | "wrap" | "unwrapAll";
+/** Expected changes to the separately authoritative SOL components. */
+export interface SolComponentDelta {
+    /** System-account change in lamports, including unsponsored costs. */
+    nativeLamports: bigint;
+    /** Persistent canonical WSOL ATA change in lamports. */
+    canonicalWsolLamports: bigint;
+}
+/** Unsigned prepared transaction plus the exact preflight facts authorizing it. */
+export interface SolActionPlan {
+    /** Operation whose balance semantics produced this plan. */
+    kind: SolActionKind;
+    /** Fee-prepared message that submission must preserve exactly. */
+    transaction: Transaction;
+    /** Live fee/rent observations and explicit sponsorship capability. */
+    costs: SolActionCosts;
+    /** Component totals after action-specific native reserve. */
+    availability: SolBalanceAvailability;
+    /** Component-wise projection that does not replace authoritative state. */
+    expectedDelta: SolComponentDelta;
+}
+/**
+ * Derive the cross-SDK temporary-account seed for native withdrawal.
+ *
+ * SHA-256 receives the ASCII domain `lightcone:wsol-withdraw:v1`, one zero byte,
+ * raw 32-byte blockhash, wallet, and recipient keys, the amount as unsigned
+ * eight-byte big-endian lamports, then the one-byte attempt. The first 16 digest
+ * bytes become 32 lowercase hexadecimal ASCII characters for Solana's seed limit.
+ */
+export declare function nativeWithdrawSeed(recentBlockhash: string, wallet: PublicKey, recipient: PublicKey, amountLamports: bigint, attempt: number): string;
+/**
+ * Plans position operations and explicit canonical WSOL conversions.
+ *
+ * Explicit conversion state flows as follows: complete matching wallet state and
+ * native keypair -> live account and cost reads -> signer, account, reserve, and
+ * amount guards -> fee-prepared plan -> unchanged prepared submission -> complete
+ * snapshot covering the confirmed slot. An uncertain submission returns control
+ * to the caller, which refreshes authoritative state before planning again.
+ */
 export declare class Positions {
     private readonly client;
     constructor(client: ClientContext);
@@ -43,9 +91,12 @@ export declare class Positions {
      */
     positionsForMarketWithCookies(marketPubkey: string, cookieHeader: string): Promise<MarketPositionsResponse>;
     /**
-     * Get a confirmed-slot snapshot of the authenticated user's deposit-token
-     * balances. When supplied, `minContextSlot` prevents an older cached
-     * snapshot from satisfying the request.
+     * Fetch a complete authenticated SPL and native-SOL balance snapshot.
+     *
+     * `minContextSlot` lower-bounds the cross-component 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.
      */
     depositTokenBalances(minContextSlot?: number): Promise<DepositTokenBalancesSnapshot>;
     /**
@@ -54,11 +105,116 @@ export declare class Positions {
      *
      * Intended for server-side cookie forwarding (SSR / server functions)
      * where the per-request browser cookie can't propagate to the shared
-     * client. In a browser context this is equivalent to
+     * client. The complete response has the same separate, exact native-SOL
+     * contract as {@link depositTokenBalances}. In a browser this is equivalent to
      * {@link depositTokenBalances} because the runtime is already attaching
      * the cookie via `credentials: "include"`.
      */
     depositTokenBalancesWithCookies(minContextSlot: number | undefined, cookieHeader: string): Promise<DepositTokenBalancesSnapshot>;
+    /**
+     * Return a fee-prepared plan for an exact canonical WSOL wrap.
+     *
+     * The authenticated Trading Wallet must have a local native keypair and complete
+     * balance state. Live canonical account data must match that state. An existing
+     * account must have account lamports equal to its token amount plus native
+     * reserve. Otherwise a later `SyncNative` instruction would recalculate the WSOL
+     * token amount from account lamports and wrap donated excess beyond
+     * `amountLamports`. The returned transaction contains strict Tokenkeg ATA
+     * creation only when the account is absent. It then contains the exact transfer
+     * 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
+     * slot. An uncertain outcome requires authoritative refresh before another plan.
+     */
+    planWrapSol(amountLamports: bigint, state: WalletDepositBalancesState): Promise<SolActionPlan>;
+    /**
+     * Return a fee-prepared plan for closing the complete canonical WSOL account.
+     *
+     * The Trading Wallet must have a local native keypair. Canonical WSOL in the
+     * complete balance state must be positive and equal the live token amount. The
+     * returned transaction contains one `CloseAccount` instruction whose authority,
+     * destination, and fee payer are that wallet. If submitted successfully, the
+     * instruction transfers the complete account balance, including rent and donated
+     * lamports. The returned costs contain only the fresh fee. Availability requires
+     * 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
+     * slot. Signing, submission, or confirmation uncertainty requires authoritative
+     * refresh and does not authorize automatic resubmission.
+     */
+    planUnwrapWsolAll(state: WalletDepositBalancesState): Promise<SolActionPlan>;
+    /**
+     * Plan one atomic split that consumes canonical WSOL before wrapping a shortfall.
+     * Amounts and live costs are lamports; unavailable account, fee, or rent reads
+     * fail closed, and sponsored planning is rejected until a sponsor owns costs.
+     */
+    planSolSplit(market: Market, amountLamports: bigint, state: WalletDepositBalancesState, sponsored: boolean): Promise<SolActionPlan>;
+    /**
+     * Plan a merge that leaves returned WSOL in the persistent canonical ATA.
+     * The prepared transaction does not mutate cached state; refresh authority
+     * after confirmed submission.
+     */
+    planSolMerge(market: Market, amountLamports: bigint, state: WalletDepositBalancesState, sponsored: boolean): Promise<SolActionPlan>;
+    /**
+     * Plan a redemption that leaves returned WSOL in the persistent canonical ATA.
+     * `amountLamports` is exact collateral scale; `outcomeIndex` is validated
+     * against the supplied authoritative `numOutcomes`.
+     */
+    planSolRedeem(market: PublicKey, amountLamports: bigint, outcomeIndex: number, numOutcomes: number, state: WalletDepositBalancesState, sponsored: boolean): Promise<SolActionPlan>;
+    /**
+     * Plan exact native SOL delivery without closing the canonical WSOL ATA.
+     *
+     * Native funds are preferred. A shortfall uses a bounded seeded Tokenkeg
+       * account whose rent returns on close; all account, rent, and fee reads fail
+       * closed. At most eight blockhash-scoped candidates bound RPC latency while
+       * making accidental exhaustion negligible. The returned transaction already
+       * carries its prepared message.
+     */
+    planNativeSolWithdrawal(recipient: PublicKey, amountLamports: bigint, state: WalletDepositBalancesState, sponsored: boolean): Promise<SolActionPlan>;
+    /** Resolve the authenticated wallet only from fresh matching cached authority. */
+    private planningWallet;
+    /**
+     * Return the authenticated Trading Wallet after native-keypair validation.
+     *
+     * Complete wallet state and identity are validated by `planningWallet`. This
+     * additional guard rejects wallet-adapter and Privy strategies before conversion
+     * RPC reads. Ordinary planners do not call this method.
+     */
+    private conversionPlanningWallet;
+    /**
+     * Return an unsigned wrap transaction with exact instruction ordering.
+     *
+     * When planning observed no canonical ATA, the first instruction is strict ATA
+     * creation. A concurrently created ATA therefore makes execution fail instead of
+     * using account state that was absent from the plan. The transfer and `SyncNative`
+     * instructions follow. Fee preparation later attaches the live blockhash.
+     */
+    private buildWrapSolTransaction;
+    /**
+     * Return an unsigned transaction containing one canonical `CloseAccount`.
+     *
+     * The Trading Wallet is the fee payer, close authority, and destination. A later
+     * successful submission transfers the complete account balance to that wallet.
+     */
+    private buildUnwrapWsolAllTransaction;
+    /**
+     * Build idempotent creation of the persistent Tokenkeg WSOL ATA.
+     * Tokenkeg is Solana's legacy SPL Token Program; canonical native-mint ATA
+     * derivation is pinned to it rather than Token-2022 across the protocol.
+     */
+    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. */
+    private finishReceivePlan;
+    /**
+     * Build the sole WSOL-to-native path without closing canonical authority.
+     * The temporary Tokenkeg account is initialized, funded, and closed back to
+     * the wallet before the exact recipient transfer in the same transaction.
+     */
+    private buildTemporaryNativeWithdrawal;
     redeemWinningsIx(params: RedeemWinningsParams, outcomeIndex: number): TransactionInstruction;
     withdrawConditionalFromPositionIx(params: WithdrawConditionalFromPositionParams): TransactionInstruction;
     withdrawFromPositionIx(params: WithdrawFromPositionParams): TransactionInstruction;

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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"}