@lightconexyz/lightcone-sdk 0.8.1-rc.8 → 0.8.2

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { Connection, Keypair, PublicKey, Transaction } from \"@solana/web3.js\";\nimport { Auth, type AuthCredentials } from \"./auth\";\nimport type { ClientContext } from \"./context\";\nimport { signAndSubmitTx as signAndSubmitTxFn } from \"./context\";\nimport type { FaucetRequest, FaucetResponse } from \"./domain/faucet\";\nimport { Markets } from \"./domain/market\";\nimport { Metrics } from \"./domain/metrics\";\nimport { Notifications } from \"./domain/notification\";\nimport { Orders } from \"./domain/order\";\nimport { Orderbooks } from \"./domain/orderbook\";\nimport { Positions } from \"./domain/position\";\nimport { PriceHistoryClient } from \"./domain/price_history\";\nimport { Referrals } from \"./domain/referral\";\nimport { Trades } from \"./domain/trade\";\nimport { LightconeHttp, RetryPolicy } from \"./http\";\nimport { LightconeEnv, apiUrl, wsUrl, rpcUrl, programId as envProgramId } from \"./env\";\nimport { Privy } from \"./privy\";\nimport { Rpc } from \"./rpc\";\nimport { RpcFailoverState } from \"./rpcFailover\";\nimport { DepositSource, type PubkeyStr } from \"./shared\";\nimport { type ExternalSigner, type SigningStrategy } from \"./shared/signing\";\nimport { WsClient, type WsConfig } from \"./ws\";\n\nclass AuthState {\n  private credentialsValue: AuthCredentials | undefined;\n\n  constructor(initial?: AuthCredentials) {\n    this.credentialsValue = initial;\n  }\n\n  getCredentials(): AuthCredentials | undefined {\n    return this.credentialsValue;\n  }\n\n  setCredentials(credentials: AuthCredentials | undefined): void {\n    this.credentialsValue = credentials;\n  }\n\n  async clearCaches(): Promise<void> {\n    // No caches to clear — decimals are derived locally from orderbook metadata.\n  }\n}\n\nexport class LightconeClient implements ClientContext {\n  readonly http: LightconeHttp;\n  readonly programId: PublicKey;\n  readonly primaryConnection?: Connection;\n  readonly backupConnection?: Connection;\n  readonly rpcFailoverState: RpcFailoverState;\n  private depositSourceValue: DepositSource;\n  private signingStrategyValue?: SigningStrategy;\n  private orderNonceValue: number | undefined;\n  private readonly wsConfigValue: WsConfig;\n  private readonly authStateStore: AuthState;\n\n  /** @deprecated Use primaryConnection — kept for ClientContext compat. */\n  get connection(): Connection | undefined {\n    return this.primaryConnection;\n  }\n\n  constructor(params: {\n    http: LightconeHttp;\n    wsConfig: WsConfig;\n    programId?: PublicKey;\n    primaryConnection?: Connection;\n    backupConnection?: Connection;\n    rpcFailoverState?: RpcFailoverState;\n    depositSource?: DepositSource;\n    signingStrategy?: SigningStrategy;\n    orderNonce?: number;\n    authCredentials?: AuthCredentials;\n    authState?: AuthState;\n  }) {\n    this.http = params.http;\n    this.programId = params.programId ?? envProgramId(LightconeEnv.Prod);\n    this.primaryConnection = params.primaryConnection;\n    this.backupConnection = params.backupConnection;\n    this.rpcFailoverState =\n      params.rpcFailoverState ?? new RpcFailoverState();\n    this.depositSourceValue = params.depositSource ?? DepositSource.Global;\n    this.signingStrategyValue = params.signingStrategy;\n    this.orderNonceValue = params.orderNonce;\n    this.wsConfigValue = params.wsConfig;\n    this.authStateStore =\n      params.authState ??\n      new AuthState(params.authCredentials);\n  }\n\n  // ── Deposit source ──────────────────────────────────────────────────\n\n  get depositSource(): DepositSource {\n    return this.depositSourceValue;\n  }\n\n  setDepositSource(source: DepositSource): void {\n    this.depositSourceValue = source;\n  }\n\n  // ── Signing strategy ────────────────────────────────────────────────\n\n  get signingStrategy(): SigningStrategy | undefined {\n    return this.signingStrategyValue;\n  }\n\n  setSigningStrategy(strategy: SigningStrategy): void {\n    this.signingStrategyValue = strategy;\n  }\n\n  clearSigningStrategy(): void {\n    this.signingStrategyValue = undefined;\n  }\n\n  // ── Nonce cache ──────────────────────────────────────────────────────\n\n  orderNonce(): number | undefined {\n    return this.orderNonceValue;\n  }\n\n  setOrderNonce(nonce: number): void {\n    this.orderNonceValue = nonce;\n  }\n\n  clearOrderNonce(): void {\n    this.orderNonceValue = undefined;\n  }\n\n  // ── Auth token (cookie) ─────────────────────────────────────────────\n\n  /**\n   * Get the current `lightcone-token` cookie value, if any. Populated by the SDK\n   * after a successful login, then attached on every authed request. Useful\n   * for forwarding the token through the `*WithCookies` methods, or\n   * persisting the session across processes.\n   */\n  async authToken(): Promise<string | undefined> {\n    return this.http.authTokenRef()();\n  }\n\n  /**\n   * Clear the cached `lightcone-token`. Subsequent authed calls will go out\n   * without a `Cookie` header (and 401) unless they use a\n   * `*WithCookies` variant.\n   */\n  async clearAuthToken(): Promise<void> {\n    await this.http.clearAuthToken();\n  }\n\n  // ── Transaction signing + submission ────────────────────────────────\n\n  async signAndSubmitTx(tx: Transaction): Promise<string> {\n    return signAndSubmitTxFn(this, tx);\n  }\n\n  static builder(): LightconeClientBuilder {\n    return new LightconeClientBuilder();\n  }\n\n  // ── Sub-client accessors ─────────────────────────────────────────────\n\n  markets(): Markets {\n    return new Markets(this);\n  }\n\n  orderbooks(): Orderbooks {\n    return new Orderbooks(this);\n  }\n\n  orders(): Orders {\n    return new Orders(this);\n  }\n\n  positions(): Positions {\n    return new Positions(this);\n  }\n\n  trades(): Trades {\n    return new Trades(this);\n  }\n\n  priceHistory(): PriceHistoryClient {\n    return new PriceHistoryClient(this);\n  }\n\n  notifications(): Notifications {\n    return new Notifications(this);\n  }\n\n  /**\n   * Metrics sub-client — platform / market / orderbook / category / deposit-token\n   * volume metrics, market leaderboard, and time-series history.\n   */\n  metrics(): Metrics {\n    return new Metrics(this);\n  }\n\n  /**\n   * Request testnet SOL and whitelisted deposit tokens for a wallet.\n   *\n   * Only active on environments whose backend has the faucet enabled (typically\n   * local and staging).\n   *\n   * `POST /api/claim`\n   */\n  async claim(walletAddress: PubkeyStr): Promise<FaucetResponse> {\n    const url = `${this.http.baseUrl()}/api/claim`;\n    return this.http.post<FaucetResponse, FaucetRequest>(\n      url,\n      { wallet_address: walletAddress },\n      RetryPolicy.None\n    );\n  }\n\n  auth(): Auth {\n    return new Auth({\n      http: this.http,\n      authState: this.authStateStore,\n    });\n  }\n\n  privy(): Privy {\n    return new Privy(this);\n  }\n\n  referrals(): Referrals {\n    return new Referrals(this);\n  }\n\n  rpc(): Rpc {\n    return new Rpc(this);\n  }\n\n  wsConfig(): WsConfig {\n    return this.wsConfigValue;\n  }\n\n  ws(): WsClient {\n    return new WsClient(this.wsConfigValue, this.http.authTokenRef());\n  }\n\n  clone(): LightconeClient {\n    return new LightconeClient({\n      http: this.http,\n      wsConfig: { ...this.wsConfigValue },\n      programId: this.programId,\n      primaryConnection: this.primaryConnection\n        ? new Connection(this.primaryConnection.rpcEndpoint, { commitment: \"confirmed\" })\n        : undefined,\n      backupConnection: this.backupConnection\n        ? new Connection(this.backupConnection.rpcEndpoint, { commitment: \"confirmed\" })\n        : undefined,\n      rpcFailoverState: this.rpcFailoverState,\n      depositSource: this.depositSourceValue,\n      signingStrategy: this.signingStrategyValue,\n      orderNonce: this.orderNonceValue,\n      authState: this.authStateStore,\n    });\n  }\n}\n\nexport class LightconeClientBuilder {\n  private baseUrlValue: string = apiUrl(LightconeEnv.Prod);\n  private wsUrlValue: string = wsUrl(LightconeEnv.Prod);\n  private authCredentials?: AuthCredentials;\n  private programIdValue: PublicKey = envProgramId(LightconeEnv.Prod);\n  private depositSourceValue: DepositSource = DepositSource.Global;\n  private signingStrategyValue?: SigningStrategy;\n  private primaryRpcUrlValue?: string = rpcUrl(LightconeEnv.Prod);\n  private backupRpcUrlValue?: string;\n\n  /**\n   * Set the deployment environment. Configures the API URL, WebSocket URL,\n   * RPC URL, and program ID for the given environment.\n   *\n   * Individual URL overrides (e.g. `.baseUrl()`) take precedence when\n   * called **after** `.env()`.\n   */\n  env(environment: LightconeEnv): LightconeClientBuilder {\n    this.baseUrlValue = apiUrl(environment);\n    this.wsUrlValue = wsUrl(environment);\n    this.programIdValue = envProgramId(environment);\n    this.primaryRpcUrlValue = rpcUrl(environment);\n    return this;\n  }\n\n  baseUrl(url: string): LightconeClientBuilder {\n    return this.withBaseUrl(url);\n  }\n\n  withBaseUrl(url: string): LightconeClientBuilder {\n    this.baseUrlValue = url;\n    return this;\n  }\n\n  wsUrl(url: string): LightconeClientBuilder {\n    return this.withWsUrl(url);\n  }\n\n  withWsUrl(url: string): LightconeClientBuilder {\n    this.wsUrlValue = url;\n    return this;\n  }\n\n  auth(credentials: AuthCredentials): LightconeClientBuilder {\n    return this.withAuth(credentials);\n  }\n\n  withAuth(credentials: AuthCredentials): LightconeClientBuilder {\n    this.authCredentials = credentials;\n    return this;\n  }\n\n  programId(id: PublicKey): LightconeClientBuilder {\n    this.programIdValue = id;\n    return this;\n  }\n\n  depositSource(source: DepositSource): LightconeClientBuilder {\n    this.depositSourceValue = source;\n    return this;\n  }\n\n  nativeSigner(keypair: Keypair): LightconeClientBuilder {\n    this.signingStrategyValue = { type: \"native\", keypair };\n    return this;\n  }\n\n  externalSigner(signer: ExternalSigner): LightconeClientBuilder {\n    this.signingStrategyValue = { type: \"walletAdapter\", signer };\n    return this;\n  }\n\n  privyWalletId(walletId: string): LightconeClientBuilder {\n    this.signingStrategyValue = { type: \"privy\", walletId };\n    return this;\n  }\n\n  rpcUrl(url: string): LightconeClientBuilder {\n    this.primaryRpcUrlValue = url;\n    return this;\n  }\n\n  /** Set a backup Solana RPC URL for automatic failover. */\n  backupRpcUrl(url: string): LightconeClientBuilder {\n    this.backupRpcUrlValue = url;\n    return this;\n  }\n\n  build(): LightconeClient {\n    return new LightconeClient({\n      http: new LightconeHttp(this.baseUrlValue),\n      wsConfig: {\n        url: this.wsUrlValue,\n        reconnect: true,\n        maxReconnectAttempts: 10,\n        baseReconnectDelayMs: 1_000,\n        pingIntervalMs: 30_000,\n        pongTimeoutMs: 10_000,\n      },\n      programId: this.programIdValue,\n      depositSource: this.depositSourceValue,\n      signingStrategy: this.signingStrategyValue,\n      primaryConnection: this.primaryRpcUrlValue\n        ? new Connection(this.primaryRpcUrlValue, { commitment: \"confirmed\" })\n        : undefined,\n      backupConnection: this.backupRpcUrlValue\n        ? new Connection(this.backupRpcUrlValue, { commitment: \"confirmed\" })\n        : undefined,\n      authCredentials: this.authCredentials,\n    });\n  }\n}\n"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAAA,6CAA8E;AAC9E,iCAAoD;AAEpD,uCAKmB;AAGnB,4CAA0C;AAC1C,8CAA2C;AAC3C,wDAAsD;AACtD,0CAAwC;AACxC,kDAAgD;AAChD,gDAA8C;AAC9C,0DAA4D;AAC5D,gDAA8C;AAC9C,0CAAwC;AACxC,iCAA6E;AAC7E,+BAAuF;AACvF,mCAAgC;AAChC,+BAA4B;AAC5B,+CAAiD;AACjD,qCAA8E;AAE9E,6BAA+C;AAE/C,MAAM,SAAS;IACL,gBAAgB,CAA8B;IAEtD,YAAY,OAAyB;QACnC,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC;IAClC,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,cAAc,CAAC,WAAwC;QACrD,IAAI,CAAC,gBAAgB,GAAG,WAAW,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,WAAW;QACf,6EAA6E;IAC/E,CAAC;CACF;AAED,MAAa,eAAe;IACjB,IAAI,CAAgB;IACpB,SAAS,CAAY;IACrB,iBAAiB,CAAc;IAC/B,gBAAgB,CAAc;IAC9B,gBAAgB,CAAmB;IACpC,kBAAkB,CAAgB;IAClC,oBAAoB,CAAmB;IACvC,kCAAkC,CAAU;IAC5C,eAAe,CAAqB;IAC3B,aAAa,CAAW;IACxB,cAAc,CAAY;IAClC,mBAAmB,CAAuC;IAEnE,yEAAyE;IACzE,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAED,YAAY,MAcX;QACC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAA,eAAY,EAAC,kBAAY,CAAC,IAAI,CAAC,CAAC;QACrE,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,CAAC;QAClD,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;QAChD,IAAI,CAAC,gBAAgB;YACnB,MAAM,CAAC,gBAAgB,IAAI,IAAI,8BAAgB,EAAE,CAAC;QACpD,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,aAAa,IAAI,sBAAa,CAAC,MAAM,CAAC;QACvE,IAAI,CAAC,oBAAoB,GAAG,MAAM,CAAC,eAAe,CAAC;QACnD,IAAI,CAAC,kCAAkC;YACrC,MAAM,CAAC,6BAA6B,IAAI,KAAK,CAAC;QAChD,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,UAAU,CAAC;QACzC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC;QACrC,IAAI,CAAC,cAAc;YACjB,MAAM,CAAC,SAAS;gBAChB,IAAI,SAAS,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACxC,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,IAAI,IAAI,GAAG,EAAE,CAAC;IACrE,CAAC;IAED,uEAAuE;IAEvE,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED,gBAAgB,CAAC,MAAqB;QACpC,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC;IACnC,CAAC;IAED,uEAAuE;IAEvE,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,cAAc,CAAC,cAAc,EAAE,CAAC;IAC9C,CAAC;IAED,kBAAkB,CAAC,QAAyB;QAC1C,IAAI,CAAC,oBAAoB,GAAG,QAAQ,CAAC;IACvC,CAAC;IAED,oBAAoB;QAClB,IAAI,CAAC,oBAAoB,GAAG,SAAS,CAAC;IACxC,CAAC;IAED,mFAAmF;IACnF,IAAI,6BAA6B;QAC/B,OAAO,IAAI,CAAC,kCAAkC,CAAC;IACjD,CAAC;IAED,iFAAiF;IACjF,gCAAgC,CAAC,OAAgB;QAC/C,IAAI,CAAC,kCAAkC,GAAG,OAAO,CAAC;IACpD,CAAC;IAED,wEAAwE;IAExE,UAAU;QACR,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,aAAa,CAAC,KAAa;QACzB,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;IAC/B,CAAC;IAED,eAAe;QACb,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;IACnC,CAAC;IAED,uEAAuE;IAEvE;;;;;OAKG;IACH,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc;QAClB,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;IACnC,CAAC;IAED;;;;;;;;;OASG;IACH,qBAAqB,CAAC,QAA4B;QAChD,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,4EAA4E;IAC5E,uBAAuB;QACrB,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,CAAC;IACtC,CAAC;IAED,uEAAuE;IAEvE,KAAK,CAAC,eAAe,CAAC,EAAe;QACnC,OAAO,IAAA,yBAAiB,EAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,wBAAwB,CAAC,EAAe;QAC5C,OAAO,IAAA,kCAA0B,EAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,gCAAgC,CACpC,EAAe;QAEf,OAAO,IAAA,0CAAkC,EAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,wCAAwC,CAC5C,EAAe;QAEf,OAAO,IAAA,kDAA0C,EAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,CAAC,OAAO;QACZ,OAAO,IAAI,sBAAsB,EAAE,CAAC;IACtC,CAAC;IAED,wEAAwE;IAExE,OAAO;QACL,OAAO,IAAI,gBAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,UAAU;QACR,OAAO,IAAI,sBAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,cAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,SAAS;QACP,OAAO,IAAI,oBAAS,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,cAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,YAAY;QACV,OAAO,IAAI,kCAAkB,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,aAAa;QACX,OAAO,IAAI,4BAAa,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,OAAO,IAAI,iBAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,CAAC,aAAwB;QAClC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC;QAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,GAAG,EACH,EAAE,cAAc,EAAE,aAAa,EAAE,EACjC,kBAAW,CAAC,IAAI,CACjB,CAAC;IACJ,CAAC;IAED,IAAI;QACF,OAAO,IAAI,WAAI,CAAC;YACd,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,cAAc;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,KAAK;QACH,OAAO,IAAI,aAAK,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,oBAAS,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG;QACD,OAAO,IAAI,SAAG,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,EAAE;QACA,OAAO,IAAI,aAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,OAAO,IAAI,eAAe,CAAC;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,aAAa,EAAE;YACnC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;gBACvC,CAAC,CAAC,IAAI,oBAAU,CAAC,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;gBACjF,CAAC,CAAC,SAAS;YACb,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;gBACrC,CAAC,CAAC,IAAI,oBAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;gBAChF,CAAC,CAAC,SAAS;YACb,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,aAAa,EAAE,IAAI,CAAC,kBAAkB;YACtC,eAAe,EAAE,IAAI,CAAC,oBAAoB;YAC1C,6BAA6B,EAAE,IAAI,CAAC,kCAAkC;YACtE,UAAU,EAAE,IAAI,CAAC,eAAe;YAChC,SAAS,EAAE,IAAI,CAAC,cAAc;YAC9B,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;SAC9C,CAAC,CAAC;IACL,CAAC;CACF;AAjSD,0CAiSC;AAED,MAAa,sBAAsB;IACzB,YAAY,GAAW,IAAA,YAAM,EAAC,kBAAY,CAAC,IAAI,CAAC,CAAC;IACjD,UAAU,GAAW,IAAA,WAAK,EAAC,kBAAY,CAAC,IAAI,CAAC,CAAC;IAC9C,eAAe,CAAmB;IAClC,cAAc,GAAc,IAAA,eAAY,EAAC,kBAAY,CAAC,IAAI,CAAC,CAAC;IAC5D,kBAAkB,GAAkB,sBAAa,CAAC,MAAM,CAAC;IACzD,oBAAoB,CAAmB;IACvC,kCAAkC,GAAG,KAAK,CAAC;IAC3C,kBAAkB,GAAY,IAAA,YAAM,EAAC,kBAAY,CAAC,IAAI,CAAC,CAAC;IACxD,iBAAiB,CAAU;IAEnC;;;;;;OAMG;IACH,GAAG,CAAC,WAAyB;QAC3B,IAAI,CAAC,YAAY,GAAG,IAAA,YAAM,EAAC,WAAW,CAAC,CAAC;QACxC,IAAI,CAAC,UAAU,GAAG,IAAA,WAAK,EAAC,WAAW,CAAC,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,IAAA,eAAY,EAAC,WAAW,CAAC,CAAC;QAChD,IAAI,CAAC,kBAAkB,GAAG,IAAA,YAAM,EAAC,WAAW,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,GAAW;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,WAAW,CAAC,GAAW;QACrB,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,GAAW;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,SAAS,CAAC,GAAW;QACnB,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,WAA4B;QAC/B,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC;IAED,QAAQ,CAAC,WAA4B;QACnC,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,EAAa;QACrB,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa,CAAC,MAAqB;QACjC,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,CAAC,OAAgB;QAC3B,IAAI,CAAC,oBAAoB,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc,CAAC,MAAsB;QACnC,IAAI,CAAC,oBAAoB,GAAG,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa,CACX,QAAgB,EAChB,aAAsB;QAEtB,IAAI,CAAC,oBAAoB,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qFAAqF;IACrF,sBAAsB,CAAC,OAAgB;QACrC,IAAI,CAAC,kCAAkC,GAAG,OAAO,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,kBAAkB,GAAG,GAAG,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0DAA0D;IAC1D,YAAY,CAAC,GAAW;QACtB,IAAI,CAAC,iBAAiB,GAAG,GAAG,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,OAAO,IAAI,eAAe,CAAC;YACzB,IAAI,EAAE,IAAI,oBAAa,CAAC,IAAI,CAAC,YAAY,CAAC;YAC1C,QAAQ,EAAE;gBACR,GAAG,EAAE,IAAI,CAAC,UAAU;gBACpB,SAAS,EAAE,IAAI;gBACf,oBAAoB,EAAE,EAAE;gBACxB,oBAAoB,EAAE,KAAK;gBAC3B,cAAc,EAAE,MAAM;gBACtB,aAAa,EAAE,MAAM;aACtB;YACD,SAAS,EAAE,IAAI,CAAC,cAAc;YAC9B,aAAa,EAAE,IAAI,CAAC,kBAAkB;YACtC,eAAe,EAAE,IAAI,CAAC,oBAAoB;YAC1C,6BAA6B,EAAE,IAAI,CAAC,kCAAkC;YACtE,iBAAiB,EAAE,IAAI,CAAC,kBAAkB;gBACxC,CAAC,CAAC,IAAI,oBAAU,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;gBACtE,CAAC,CAAC,SAAS;YACb,gBAAgB,EAAE,IAAI,CAAC,iBAAiB;gBACtC,CAAC,CAAC,IAAI,oBAAU,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;gBACrE,CAAC,CAAC,SAAS;YACb,eAAe,EAAE,IAAI,CAAC,eAAe;SACtC,CAAC,CAAC;IACL,CAAC;CACF;AA1HD,wDA0HC","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 { DepositSource } from "./shared";
-import type { SigningStrategy } from "./shared/signing";
+import type { AuthCredentials } from "./auth";
+import type { DepositSource, OrderbookRules } from "./shared";
+import { type SigningStrategy } from "./shared/signing";
 import { type RpcFailoverState } from "./rpcFailover";
 export interface ClientContext {
     readonly http: LightconeHttp;
@@ -11,8 +12,13 @@ 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>>;
     /** @deprecated Use primaryConnection — kept for backward compat in domain sub-clients. */
     readonly connection?: Connection;
 }
@@ -20,5 +26,55 @@ export declare function requireConnection(ctx: ClientContext): Connection;
 export declare function connectionWithFailover<T>(ctx: ClientContext, operation: (conn: Connection) => Promise<T>): Promise<T>;
 export declare function resolveDepositSource(ctx: ClientContext, overrideSource: DepositSource | undefined): DepositSource;
 export declare function requireSigningStrategy(ctx: ClientContext): SigningStrategy;
+/**
+ * Sign and submit a transaction using the client's signing strategy.
+ *
+ * Fetches a recent blockhash automatically. Returns as soon as the RPC
+ * 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>;
+/**
+ * Sign and submit a transaction, then wait until it reaches `confirmed`
+ * commitment on-chain.
+ *
+ * Sequential flows should prefer this over {@link signAndSubmitTx}: a
+ * transaction that depends on a prior transaction's state is only safe to
+ * send once that prior transaction has confirmed. See `Rpc.confirmSignature`
+ * for the terminal error taxonomy.
+ *
+ * Expiry (`"TransactionExpired"`) is only ever reported when the submitted
+ * transaction provably still carries the blockhash this function fetched:
+ * always true for `native`, verified against the signed bytes for
+ * `walletAdapter`, and never assumed for `privy` (the backend signs and
+ * submits out of the SDK's sight) — those cases end in
+ * `"ConfirmationTimeout"` at the poll cap instead.
+ */
+export declare function signAndSubmitTxConfirmed(ctx: ClientContext, tx: import("@solana/web3.js").Transaction): Promise<string>;
+export interface ConfirmedTransaction {
+    signature: string;
+    slot: number;
+}
+/**
+ * Sign and submit a transaction, wait for confirmed commitment, and return
+ * 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,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAEL,KAAK,gBAAgB,EAItB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,UAAU,CAAC;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,UAAU,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;IAC3C,UAAU,CAAC,IAAI,MAAM,GAAG,SAAS,CAAC;IAClC,aAAa,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;CAClC;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,CAYhE;AAWD,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,GAAG,EAAE,aAAa,EAClB,SAAS,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC,CAAC,CAAC,CAwCZ;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,aAAa,EAClB,cAAc,EAAE,aAAa,GAAG,SAAS,GACxC,aAAa,CAEf;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,eAAe,CAO1E;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,aAAa,EAClB,EAAE,EAAE,OAAO,iBAAiB,EAAE,WAAW,GACxC,OAAO,CAAC,MAAM,CAAC,CA6CjB"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAC1B,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,2FAA2F;IAC3F,QAAQ,CAAC,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACjD,qFAAqF;IACrF,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;AAwID;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,aAAa,EAClB,EAAE,EAAE,OAAO,iBAAiB,EAAE,WAAW,GACxC,OAAO,CAAC,MAAM,CAAC,CAIjB;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,CAQ/B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,wCAAwC,CAC5D,GAAG,EAAE,aAAa,EAClB,EAAE,EAAE,OAAO,iBAAiB,EAAE,WAAW,GACxC,OAAO,CAAC,oBAAoB,CAAC,CAwB/B;AAED,0FAA0F;AAC1F,wBAAsB,qCAAqC,CACzD,GAAG,EAAE,aAAa,EAClB,EAAE,EAAE,OAAO,iBAAiB,EAAE,WAAW,EACzC,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,CAAC,CASjB"}

package/dist/context.js

@@ -38,7 +38,13 @@ exports.connectionWithFailover = connectionWithFailover;
 exports.resolveDepositSource = resolveDepositSource;
 exports.requireSigningStrategy = requireSigningStrategy;
 exports.signAndSubmitTx = signAndSubmitTx;
+exports.signAndSubmitTxConfirmed = signAndSubmitTxConfirmed;
+exports.signAndSubmitTxConfirmedWithSlot = signAndSubmitTxConfirmedWithSlot;
+exports.signAndSubmitPreparedTxConfirmedWithSlot = signAndSubmitPreparedTxConfirmedWithSlot;
+exports.signAndSubmitTxConfirmedUsingStrategy = signAndSubmitTxConfirmedUsingStrategy;
+const web3_js_1 = require("@solana/web3.js");
 const error_1 = require("./error");
+const signing_1 = require("./shared/signing");
 const rpcFailover_1 = require("./rpcFailover");
 function requireConnection(ctx) {
     ctx.rpcFailoverState.maybeRecoverToPrimary();
@@ -107,20 +113,226 @@ function requireSigningStrategy(ctx) {
     }
     return ctx.signingStrategy;
 }
+/** Capture one signer and sponsorship assertion before transaction work can yield. */
+function requireTransactionSigningContext(ctx) {
+    return {
+        strategy: requireSigningStrategy(ctx),
+        sponsorshipEnabled: ctx.transactionSponsorshipEnabled ?? false,
+    };
+}
+/**
+ * Reject invalid payer and sponsorship combinations before submission can yield.
+ * Unsponsored known signers must control the payer being classified; sponsored
+ * external flows may intentionally use a different payer, while native sponsorship
+ * is rejected before blockhash RPC or caller-transaction mutation.
+ */
+function validateTransactionFeeFundingContext(tx, strategy, sponsorshipEnabled) {
+    if (!tx.feePayer) {
+        throw error_1.SdkError.validation("transaction is missing a declared fee payer");
+    }
+    if (sponsorshipEnabled) {
+        if (strategy.type === "native") {
+            throw error_1.SdkError.validation("transaction sponsorship is not supported with local-keypair signing");
+        }
+        return;
+    }
+    const signingAddress = (0, signing_1.signingStrategyWalletAddress)(strategy);
+    if (signingAddress && signingAddress !== tx.feePayer.toBase58()) {
+        throw error_1.SdkError.validation("signing strategy does not control transaction fee payer");
+    }
+}
+/**
+ * Own the transaction message before asynchronous submission work begins.
+ * A placeholder blockhash exists only long enough to serialize an ordinary
+ * transaction that has not received its fresh blockhash yet.
+ */
+function snapshotTransaction(tx) {
+    if (tx.recentBlockhash || tx.nonceInfo) {
+        return web3_js_1.Transaction.from(tx.serialize({ requireAllSignatures: false, verifySignatures: false }));
+    }
+    const serializable = new web3_js_1.Transaction({
+        feePayer: tx.feePayer,
+        blockhash: "11111111111111111111111111111111",
+        lastValidBlockHeight: tx.lastValidBlockHeight ?? 0,
+        signatures: tx.signatures,
+    });
+    serializable.instructions = tx.instructions;
+    const snapshot = web3_js_1.Transaction.from(serializable.serialize({ requireAllSignatures: false, verifySignatures: false }));
+    snapshot.recentBlockhash = undefined;
+    snapshot.lastValidBlockHeight = undefined;
+    return snapshot;
+}
+/** Publish local signatures only when the caller still holds the submitted message. */
+function copySignaturesIfMessageUnchanged(signed, callerTransaction) {
+    try {
+        if (!Buffer.from(signed.serializeMessage()).equals(Buffer.from(callerTransaction.serializeMessage()))) {
+            return;
+        }
+    }
+    catch {
+        return;
+    }
+    callerTransaction.signatures = signed.signatures.map(({ publicKey, signature }) => ({
+        publicKey,
+        signature: signature ? Buffer.from(signature) : null,
+    }));
+}
+/**
+ * Reject proven fee shortfalls before signing while preserving submission on unknown evidence.
+ *
+ * The transaction's prepared message supplies the exact fee and declared fee
+ * payer. Fee or balance lookup failure is deliberately best-effort; planner-owned
+ * SOL admission remains fail-closed before reaching this shared boundary. The
+ * signer and sponsorship value were captured together before RPC work.
+ */
+async function preflightTransactionFeeFunding(ctx, tx, strategy, sponsorshipEnabled) {
+    validateTransactionFeeFundingContext(tx, strategy, sponsorshipEnabled);
+    if (sponsorshipEnabled)
+        return;
+    const feePayer = tx.feePayer;
+    if (!feePayer) {
+        throw error_1.SdkError.validation("transaction is missing a declared fee payer");
+    }
+    const { Rpc } = await Promise.resolve().then(() => __importStar(require("./rpc")));
+    const rpc = new Rpc(ctx);
+    let requiredLamports;
+    try {
+        requiredLamports = await rpc.estimatePreparedTransactionFee(tx);
+    }
+    catch {
+        return;
+    }
+    let availableLamports;
+    try {
+        availableLamports = await rpc.balanceLamports(feePayer);
+    }
+    catch {
+        return;
+    }
+    if (availableLamports < requiredLamports) {
+        throw error_1.SdkError.insufficientSolForTransactionFees(availableLamports, requiredLamports);
+    }
+}
+/**
+ * Sign and submit a transaction using the client's signing strategy.
+ *
+ * Fetches a recent blockhash automatically. Returns as soon as the RPC
+ * 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.
+ */
 async function signAndSubmitTx(ctx, tx) {
+    const { strategy, sponsorshipEnabled } = requireTransactionSigningContext(ctx);
+    const { signature } = await signAndSubmitTxInner(ctx, tx, strategy, sponsorshipEnabled);
+    return signature;
+}
+/**
+ * Sign and submit a transaction, then wait until it reaches `confirmed`
+ * commitment on-chain.
+ *
+ * Sequential flows should prefer this over {@link signAndSubmitTx}: a
+ * transaction that depends on a prior transaction's state is only safe to
+ * send once that prior transaction has confirmed. See `Rpc.confirmSignature`
+ * for the terminal error taxonomy.
+ *
+ * Expiry (`"TransactionExpired"`) is only ever reported when the submitted
+ * transaction provably still carries the blockhash this function fetched:
+ * always true for `native`, verified against the signed bytes for
+ * `walletAdapter`, and never assumed for `privy` (the backend signs and
+ * submits out of the SDK's sight) — those cases end in
+ * `"ConfirmationTimeout"` at the poll cap instead.
+ */
+async function signAndSubmitTxConfirmed(ctx, tx) {
+    const confirmed = await signAndSubmitTxConfirmedWithSlot(ctx, tx);
+    return confirmed.signature;
+}
+/**
+ * Sign and submit a transaction, wait for confirmed commitment, and return
+ * both its signature and processing slot.
+ */
+async function signAndSubmitTxConfirmedWithSlot(ctx, tx) {
+    const { strategy, sponsorshipEnabled } = requireTransactionSigningContext(ctx);
+    return signAndSubmitTxConfirmedWithSlotUsingStrategy(ctx, tx, strategy, sponsorshipEnabled);
+}
+/**
+ * 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.
+ */
+async function signAndSubmitPreparedTxConfirmedWithSlot(ctx, tx) {
+    if (!tx.recentBlockhash) {
+        throw error_1.SdkError.validation("prepared transaction is missing a recent blockhash");
+    }
+    const { strategy, sponsorshipEnabled } = requireTransactionSigningContext(ctx);
+    if (!tx.feePayer) {
+        throw error_1.SdkError.validation("prepared transaction is missing a fee payer");
+    }
+    validateTransactionFeeFundingContext(tx, strategy, sponsorshipEnabled);
+    if (!sponsorshipEnabled && !(0, signing_1.signingStrategyWalletAddress)(strategy)) {
+        throw error_1.SdkError.validation("signing strategy wallet identity is required");
+    }
+    const callerTransaction = tx;
+    tx = snapshotTransaction(tx);
+    await preflightTransactionFeeFunding(ctx, tx, strategy, sponsorshipEnabled);
+    const signature = await signAndSubmitPreparedTxInner(ctx, tx, strategy, callerTransaction);
+    const { Rpc } = await Promise.resolve().then(() => __importStar(require("./rpc")));
+    const status = await new Rpc(ctx).confirmSignatureStatus(signature, null);
+    return { signature, slot: status.slot };
+}
+/** @internal Submit with a strategy already validated for an identity-bound operation. */
+async function signAndSubmitTxConfirmedUsingStrategy(ctx, tx, strategy) {
+    const sponsorshipEnabled = ctx.transactionSponsorshipEnabled ?? false;
+    const confirmed = await signAndSubmitTxConfirmedWithSlotUsingStrategy(ctx, tx, strategy, sponsorshipEnabled);
+    return confirmed.signature;
+}
+async function signAndSubmitTxConfirmedWithSlotUsingStrategy(ctx, tx, strategy, sponsorshipEnabled) {
+    const { signature, lastValidBlockHeight } = await signAndSubmitTxInner(ctx, tx, strategy, sponsorshipEnabled);
+    const { Rpc } = await Promise.resolve().then(() => __importStar(require("./rpc")));
+    const status = await new Rpc(ctx).confirmSignatureStatus(signature, lastValidBlockHeight);
+    return { signature, slot: status.slot };
+}
+/**
+ * Prepare funding evidence, sign, send, and return the signature and expiry bound.
+ *
+ * The fresh blockhash feeds best-effort fee preflight before any signer runs.
+ * Submission operates on a pre-await snapshot. The fresh blockhash is copied to
+ * the caller transaction; local signatures follow only if its message still matches.
+ * `lastValidBlockHeight` is `null` when the submitted wire bytes cannot be proven
+ * to retain that blockhash because an external signer replaced it or the final
+ * bytes were never visible to the SDK.
+ */
+async function signAndSubmitTxInner(ctx, tx, strategy, sponsorshipEnabled) {
+    validateTransactionFeeFundingContext(tx, strategy, sponsorshipEnabled);
+    const callerTransaction = tx;
+    tx = snapshotTransaction(tx);
     const { isUserCancellation } = await Promise.resolve().then(() => __importStar(require("./shared/signing")));
     const { SdkError } = await Promise.resolve().then(() => __importStar(require("./error")));
     const { RetryPolicy } = await Promise.resolve().then(() => __importStar(require("./http")));
-    const strategy = requireSigningStrategy(ctx);
-    // Get blockhash with failover.
-    const { blockhash } = await connectionWithFailover(ctx, (conn) => conn.getLatestBlockhash());
+    // Get blockhash with failover, at `confirmed` commitment (pinned, not the
+    // Connection's default — matching the Rust and Python SDKs).
+    const { blockhash, lastValidBlockHeight } = await connectionWithFailover(ctx, (conn) => conn.getLatestBlockhash("confirmed"));
     tx.recentBlockhash = blockhash;
+    tx.lastValidBlockHeight = lastValidBlockHeight;
+    callerTransaction.recentBlockhash = blockhash;
+    callerTransaction.lastValidBlockHeight = lastValidBlockHeight;
+    await preflightTransactionFeeFunding(ctx, tx, strategy, sponsorshipEnabled);
     switch (strategy.type) {
         case "native": {
             tx.partialSign(strategy.keypair);
-            return connectionWithFailover(ctx, (conn) => conn.sendRawTransaction(tx.serialize()));
+            copySignaturesIfMessageUnchanged(tx, callerTransaction);
+            const signature = await connectionWithFailover(ctx, (conn) => conn.sendRawTransaction(tx.serialize()));
+            return { signature, lastValidBlockHeight };
         }
         case "walletAdapter": {
+            const expectedMessage = tx.serializeMessage();
             const txBytes = tx.serialize({ requireAllSignatures: false });
             const signedBytes = await strategy.signer
                 .signTransaction(txBytes)
@@ -130,15 +342,100 @@ async function signAndSubmitTx(ctx, tx) {
                     throw SdkError.userCancelled();
                 throw SdkError.signing(msg);
             });
-            return connectionWithFailover(ctx, (conn) => conn.sendRawTransaction(signedBytes));
+            const signedBlockhashIsUnchanged = await validateOrdinarySignedTransaction(signedBytes, expectedMessage, blockhash);
+            const signature = await connectionWithFailover(ctx, (conn) => conn.sendRawTransaction(signedBytes));
+            return {
+                signature,
+                lastValidBlockHeight: signedBlockhashIsUnchanged
+                    ? lastValidBlockHeight
+                    : null,
+            };
         }
         case "privy": {
             const txBytes = tx.serialize({ requireAllSignatures: false });
             const base64Tx = Buffer.from(txBytes).toString("base64");
             const url = `${ctx.http.baseUrl()}/api/privy/sign_and_send_tx`;
             const result = await ctx.http.post(url, { wallet_id: strategy.walletId, base64_tx: base64Tx }, RetryPolicy.None);
-            return result.hash;
+            // The backend signs and submits server-side; the SDK never sees the
+            // final wire bytes, so the blockhash it set cannot be trusted for
+            // expiry detection.
+            return { signature: result.hash, lastValidBlockHeight: null };
+        }
+    }
+}
+/**
+ * Sign and submit once without replacing the planner's prepared blockhash.
+ *
+ * Native signing preserves the message by construction. Wallet-adapter bytes are
+ * compared with the prepared message before submission. Privy is excluded because
+ * this SDK cannot inspect its final wire message. The native signature is published
+ * to an unchanged caller message before the one-shot send so an uncertain outcome
+ * remains reconcilable. Both admitted strategies use the active connection directly.
+ */
+async function signAndSubmitPreparedTxInner(ctx, tx, strategy, callerTransaction) {
+    const { isUserCancellation } = await Promise.resolve().then(() => __importStar(require("./shared/signing")));
+    switch (strategy.type) {
+        case "native":
+            tx.partialSign(strategy.keypair);
+            copySignaturesIfMessageUnchanged(tx, callerTransaction);
+            return requireConnection(ctx).sendRawTransaction(tx.serialize());
+        case "walletAdapter": {
+            const expectedMessage = tx.serializeMessage();
+            const txBytes = tx.serialize({ requireAllSignatures: false });
+            const signedBytes = await strategy.signer
+                .signTransaction(txBytes)
+                .catch((error) => {
+                const message = error instanceof Error ? error.message : String(error);
+                if (isUserCancellation(message))
+                    throw error_1.SdkError.userCancelled();
+                throw error_1.SdkError.signing(message);
+            });
+            await assertPreparedSignedMessage(signedBytes, expectedMessage);
+            return requireConnection(ctx).sendRawTransaction(signedBytes);
         }
+        case "privy":
+            throw error_1.SdkError.validation("prepared transaction submission cannot verify a Privy-signed message");
+    }
+}
+/**
+ * Enforce the fee-preflight authority boundary after wallet-adapter signing.
+ * Signatures may change, but any account, instruction, fee payer, or blockhash
+ * change rejects the bytes before they reach RPC.
+ */
+async function assertPreparedSignedMessage(signedBytes, expectedMessage) {
+    const { Transaction } = await Promise.resolve().then(() => __importStar(require("@solana/web3.js")));
+    let signedMessage;
+    try {
+        signedMessage = Transaction.from(signedBytes).serializeMessage();
+    }
+    catch (error) {
+        throw error_1.SdkError.signing(`signed transaction is invalid: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (!Buffer.from(signedMessage).equals(Buffer.from(expectedMessage))) {
+        throw error_1.SdkError.validation("wallet changed the fee-prepared transaction message");
+    }
+}
+/**
+ * Allow an external signer to replace only the ordinary transaction blockhash.
+ *
+ * Fee payer, accounts, and instructions are the authority used by fee preflight
+ * and must survive signing. A replacement blockhash remains allowed, but its
+ * original expiry bound is discarded.
+ */
+async function validateOrdinarySignedTransaction(signedBytes, expectedMessage, expectedBlockhash) {
+    const { Transaction } = await Promise.resolve().then(() => __importStar(require("@solana/web3.js")));
+    let signed;
+    try {
+        signed = Transaction.from(signedBytes);
+    }
+    catch (error) {
+        throw error_1.SdkError.signing(`signed transaction is invalid: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const blockhashUnchanged = signed.recentBlockhash === expectedBlockhash;
+    signed.recentBlockhash = expectedBlockhash;
+    if (!Buffer.from(signed.serializeMessage()).equals(Buffer.from(expectedMessage))) {
+        throw error_1.SdkError.validation("wallet changed the transaction message beyond recent blockhash");
     }
+    return blockhashUnchanged;
 }
 //# sourceMappingURL=context.js.map