@xoxno/sdk-js 1.0.221 → 1.0.223

package/dist/sdk/stellar/quote.d.ts

@@ -11,25 +11,78 @@
  * the wire shape is camelCase, the Soroban contract receives snake_case
  * after the SDK encoder rewrites field names.
  */
-import type { StellarAggregatorQuoteRequestDto, StellarAggregatorQuoteResponseDto, StellarTokenKind } from '@xoxno/types';
+import type { StellarAggregatorQuoteRequestDto, StellarAggregatorQuoteResponseDto, StellarQuoteTransactionPayloadDto } from '@xoxno/types';
 import type { StellarNetwork } from './contracts.js';
 /**
- * Resolved token entry returned by the quote server's tokens endpoint.
- * Mirrors the indexer's `TokenEntry` JSON exactly.
+ * Token entry returned by `GET /api/v1/tokens`. Mirrors the service's
+ * `TokenEntry` schema exactly.
  */
 export interface StellarQuoteToken {
-    /** Canonical token id. `C…` for Soroban contracts; `CODE:GISSUER…`
-     *  for Classic; `XLM` for native. */
+    /** Canonical Soroban token contract id (`C…`). `XLM` and `CODE:ISSUER`
+     *  forms are rejected by the service. */
     id: string;
-    kind: StellarTokenKind;
+    /** Decimal places: divide atomic amounts by 10^decimals for display. */
     decimals: number;
-    /** Soroban Asset Contract peer for Classic assets (null otherwise). */
-    sacPeer: string | null;
-    /** Classic asset code (for Classic / SAC entries; null for Soroban). */
-    code: string | null;
-    /** Number of pools touching this token in the current snapshot. */
-    degree: number;
+    /** `true` for a pool share token; quoting from/to it is a liquidity route. */
+    lp: boolean;
+    /** Venues the token appears on, sorted. For an LP token, the issuing venue. */
+    dexes: string[];
+    /** LP only: the pool contract that issued the shares. */
+    pool?: string | null;
+    /** LP only: constituent token ids in pool order. */
+    assets?: string[] | null;
 }
+/** Liquidity snapshot the route was searched against. */
+export interface StellarQuoteSnapshot {
+    ledger: number;
+    ageSeconds: number;
+    /** Live ledger compared against; present only when `fresh=true`. */
+    checkedLiveLedger?: number | null;
+}
+/** Set when the route was reduced to fit the simulation budget. */
+export interface StellarQuoteDegraded {
+    requestedMaxSplits: number;
+    effectiveMaxSplits: number;
+    requestedMaxHops: number;
+    effectiveMaxHops: number;
+    fallbackAttempts: number;
+    reason: string;
+}
+export interface StellarQuoteLpConstituent {
+    token: string;
+    tokenKind: string;
+    /** Raw u128 amount as a string. */
+    amount: string;
+    amountShort: number;
+}
+/** Liquidity breakdown for add/remove/convert-liquidity quotes. Informational. */
+export interface StellarQuoteLp {
+    pool: string;
+    dex: string;
+    kind: string;
+    feeBps: number;
+    shareToken: string;
+    amounts: StellarQuoteLpConstituent[];
+    refunded?: StellarQuoteLpConstituent[];
+    preSwap?: unknown;
+}
+/**
+ * Quote response as the service returns it. Extends the `@xoxno/types` DTO with
+ * fields the DTO does not yet declare. `alternatives` is still on the DTO but
+ * the service no longer returns it.
+ */
+export type StellarQuoteResponse = StellarAggregatorQuoteResponseDto & {
+    snapshot?: StellarQuoteSnapshot | null;
+    degraded?: StellarQuoteDegraded | null;
+    lp?: StellarQuoteLp | null;
+    /** Ordered LP-conversion steps; mutually exclusive with `transaction`. */
+    transactions?: StellarQuoteTransactionPayloadDto[] | null;
+};
+/** Quote request; adds `simulate`, which the DTO does not yet declare. */
+export type StellarQuoteRequest = StellarAggregatorQuoteRequestDto & {
+    /** With `sender`: simulate and prepare resource data (service default `true`). */
+    simulate?: boolean;
+};
 export interface StellarQuoteFetchOptions {
     /** Quote-server base URL selected by the host application. */
     baseUrl: string;
@@ -49,14 +102,17 @@ export interface StellarQuoteFetchOptions {
  * `steps`. Amounts are token base-unit decimal strings. Requote after changes
  * to amount, direction or slippage; preparation is the execution check.
  *
- * Passing both `sender` (G...) and `router` (C...) may return a direct-swap
- * envelope under `transaction.envelopeXdr`. Prepare it before wallet signing.
+ * Passing `sender` (G...) together with `slippage` returns a direct-swap
+ * envelope under `transaction.envelopeXdr`. The router comes from the service's
+ * `/api/v1/config`; the `router` request field is ignored by the service and is
+ * no longer sent. Prepare the envelope before wallet signing unless
+ * `transaction.simulated` is true.
  * @param request - Exactly one of amountIn or amountOut; optional referralId is forwarded unchanged.
  * @param opts - Quote-server URL and optional fetch options supplied by the host.
  * @returns Quote estimates and opaque route bytes; does not execute a swap.
  * @category Strategy quotes
  */
-export declare function getStellarAggregatorQuote(request: StellarAggregatorQuoteRequestDto, opts: StellarQuoteFetchOptions): Promise<StellarAggregatorQuoteResponseDto>;
+export declare function getStellarAggregatorQuote(request: StellarQuoteRequest, opts: StellarQuoteFetchOptions): Promise<StellarQuoteResponse>;
 /**
  * List tokens currently indexed by the quote server. Useful to populate
  * pickers or validate that a user-supplied token has on-chain liquidity.

package/dist/sdk/stellar/scval-encode.d.ts

@@ -161,8 +161,6 @@ export declare const scStruct: (fields: Record<string, xdr.ScVal>) => xdr.ScVal;
  * callers that construct routes locally.
  */
 export declare const encodeStrategyPayload: (payload: StellarStrategyPayloadInput) => xdr.ScVal;
-/** @deprecated Use `encodeStrategyPayload`. */
-export declare const encodeAggregatorSwap: (payload: StellarStrategyPayloadInput) => xdr.ScVal;
 export declare const encodeStrategyPayloadToBytes: (payload: StellarStrategyPayloadInput) => xdr.ScVal;
 /**
  * Validate the untyped `steps` field and narrow it to `StrategyPayload`.
@@ -185,8 +183,6 @@ export declare const emptyStrategySwapBytes: () => xdr.ScVal;
  *   - decoded `StrategyPayload` object
  */
 export declare const asStellarStrategySwapBytes: (steps: unknown) => xdr.ScVal;
-/** @deprecated Use `asStellarStrategyPayload` or `asStellarStrategySwapBytes`. */
-export declare const asStellarSwapSteps: (steps: unknown) => StellarStrategyPayloadInput;
 /**
  * Validate the untyped `data` field on FlashLoanArgs and narrow it to
  * Buffer / hex string for Soroban `Bytes` encoding.

package/dist/sdk/stellar/swap.d.ts

@@ -53,9 +53,6 @@ export interface StellarExecuteStrategyBuilderOptions extends StellarBuilderOpti
      */
     referralId?: number | string;
 }
-/** @deprecated Use `StellarExecuteStrategyBuilderOptions`. */
-export interface StellarBatchSwapBuilderOptions extends StellarExecuteStrategyBuilderOptions {
-}
 export declare const encodeStrategyPayloadToRouteXdr: (payload: StellarStrategyPayloadInput) => string;
 /**
  * Build an unsigned XDR for a direct user -> aggregator router swap.
@@ -65,11 +62,6 @@ export declare const encodeStrategyPayloadToRouteXdr: (payload: StellarStrategyP
  * custom route builders.
  */
 export declare function buildStellarExecuteStrategyTx(opts: StellarExecuteStrategyBuilderOptions, swap: StellarStrategySwapInput): BuiltStellarTx;
-/**
- * @deprecated The router no longer exposes `batch_execute`; this wrapper now
- * builds `execute_strategy(sender, total_in, swap_xdr)`.
- */
-export declare function buildStellarBatchSwapTx(opts: StellarBatchSwapBuilderOptions, swap: StellarStrategySwapInput): BuiltStellarTx;
 /**
  * Translate a quote-server response into the decoded `StrategyPayload` shape.
  * Prefer `mapQuoteResponseToStrategySwap` when the quote includes `routeXdr`.
@@ -85,5 +77,3 @@ export declare function mapQuoteResponseToStrategyPayload(quote: StellarAggregat
  * @throws StellarRouteVerificationError — never sign a quote that throws here.
  */
 export declare function mapQuoteResponseToStrategySwap(quote: StellarAggregatorQuoteResponseDto, opts?: StellarQuoteMapOptions): StellarStrategySwapInput;
-/** @deprecated Use `mapQuoteResponseToStrategyPayload`. */
-export declare const mapQuoteResponseToAggregatorSwap: typeof mapQuoteResponseToStrategyPayload;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xoxno/sdk-js",
-  "version": "1.0.221",
+  "version": "1.0.223",
   "description": "The SDK to interact with the XOXNO Protocol!",
   "type": "module",
   "exports": {