@xoxno/sdk-js 1.0.104 → 1.0.106

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

@@ -1,24 +1,42 @@
 /**
- * Stellar lending controller contract addresses + Soroban RPC config per network.
+ * Stellar Soroban contract addresses + Soroban RPC + quote-server config
+ * per network.
  *
- * Addresses are env-sourced so ops can rotate mainnet/testnet deployments without
- * a code change. Defaults fall back to empty string so a missing env surfaces as a
- * clear "controller address not configured" error at builder call time rather than
+ * Addresses are env-sourced so ops can rotate mainnet/testnet deployments
+ * without a code change. Defaults fall back to empty strings so a missing
+ * env surfaces as a clear "not configured" error at call time rather than
  * silently pointing at the wrong contract.
  */
 export type StellarNetwork = 'mainnet' | 'testnet';
 /**
- * Stellar controller contract addresses per network.
+ * Stellar lending controller contract addresses per network.
  * Env vars:
  *   - STELLAR_LENDING_CONTROLLER_MAINNET
  *   - STELLAR_LENDING_CONTROLLER_TESTNET
  */
 export declare const STELLAR_LENDING_CONTROLLER: Record<StellarNetwork, string>;
+/**
+ * Stellar aggregator router contract addresses per network.
+ * Targets `batch_execute(BatchSwap)` for direct (non-lending) swaps.
+ * Env vars:
+ *   - STELLAR_AGGREGATOR_ROUTER_MAINNET
+ *   - STELLAR_AGGREGATOR_ROUTER_TESTNET
+ */
+export declare const STELLAR_AGGREGATOR_ROUTER: Record<StellarNetwork, string>;
 /**
  * Default Soroban RPC URLs per network.
  * Overridable at runtime via the `sorobanRpcUrl` option on each builder.
  */
 export declare const STELLAR_SOROBAN_RPC_URL: Record<StellarNetwork, string>;
+/**
+ * Stellar aggregator quote-server base URLs per network. The quote server
+ * exposes `GET /api/v1/tokens` and `GET /api/v1/quote`.
+ *
+ * Env vars:
+ *   - STELLAR_QUOTE_URL_MAINNET
+ *   - STELLAR_QUOTE_URL_TESTNET
+ */
+export declare const STELLAR_QUOTE_URL: Record<StellarNetwork, string>;
 /**
  * Stellar network passphrases (Soroban tx signing domain separator).
  * These are fixed by the Stellar network itself and must not be overridden.
@@ -26,6 +44,12 @@ export declare const STELLAR_SOROBAN_RPC_URL: Record<StellarNetwork, string>;
 export declare const STELLAR_NETWORK_PASSPHRASE: Record<StellarNetwork, string>;
 /**
  * Assert a controller address is configured for the target network.
- * Throws early with a clear message rather than building an XDR that points at `""`.
+ * Throws early with a clear message rather than building an XDR that
+ * points at `""`.
  */
 export declare function getStellarLendingController(network: StellarNetwork): string;
+/**
+ * Assert an aggregator router address is configured for the target network.
+ * Used by `buildStellarBatchSwapTx` for direct user→router swaps.
+ */
+export declare function getStellarAggregatorRouter(network: StellarNetwork): string;

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

@@ -1,2 +1,4 @@
 export * from './contracts';
 export * from './lending';
+export * from './quote';
+export * from './swap';

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

@@ -36,7 +36,7 @@
  * (which handles simulation + Soroban footprint/auth/resource fee) before
  * handing the XDR to the wallet to sign.
  */
-import type { BorrowArgs, FlashLoanArgs, LiquidateArgs, MultiplyArgs, RepayArgs, RepayDebtWithCollateralArgs, SupplyArgs, SwapCollateralArgs, SwapDebtArgs, WithdrawArgs } from '@xoxno/types';
+import type { AggregatorSwapDto, BorrowArgs, FlashLoanArgs, LiquidateArgs, MultiplyArgs, RepayArgs, RepayDebtWithCollateralArgs, SupplyArgs, SwapCollateralArgs, SwapDebtArgs, SwapHopDto, SwapPathDto, SwapVenue, WithdrawArgs } from '@xoxno/types';
 import { type StellarNetwork } from './contracts';
 /**
  * Stellar `G...` public key of the caller (tx source account).
@@ -68,32 +68,42 @@ export interface BuiltStellarTx {
     xdr: string;
 }
 /**
- * Input shape for the Stellar-specific `SwapSteps` payload carried on
+ * Input shape for the Stellar-specific `swap` payload carried on
  * `MultiplyArgs.steps`, `SwapDebtArgs.steps`, `SwapCollateralArgs.steps`,
  * `RepayDebtWithCollateralArgs.steps`.
  *
  * @xoxno/types declares `steps: unknown` on the Wave 0 DTOs so every chain
- * owns its own encoding. On Stellar, this is what callers MUST pass,
- * which is serialised to a Soroban `Vec<SwapHop>` struct matching
- * rs-lending/stellar/common/src/types.rs:
+ * owns its own encoding. On Stellar, callers MUST pass an
+ * `AggregatorSwapDto` which is serialised into the Soroban
+ * `AggregatorSwap` struct from `rs-lending-xlm common/src/types.rs`:
  *
  *   pub struct SwapHop {
- *       pub pool_address: Address,
+ *       pub fee_bps: u32,
+ *       pub pool: Address,
  *       pub token_in: Address,
  *       pub token_out: Address,
+ *       pub venue: SwapVenue,   // tag-only enum
+ *   }
+ *   pub struct SwapPath {
+ *       pub amount_in: i128,
+ *       pub hops: Vec<SwapHop>,
  *       pub min_amount_out: i128,
  *   }
+ *   pub struct AggregatorSwap {  // controller payload
+ *       pub paths: Vec<SwapPath>,
+ *       pub total_min_out: i128,
+ *   }
+ *
+ * The controller wraps `AggregatorSwap` in `BatchSwap` (filling
+ * `sender = current_contract_address`) before forwarding to the router.
+ *
+ * Re-exported from this module so consumers can `import { StellarSwapStepsInput }`
+ * and get the canonical typed shape without reaching into `@xoxno/types`.
  */
-export interface StellarSwapStepsInput {
-    hops: StellarSwapHopInput[];
-}
-export interface StellarSwapHopInput {
-    poolAddress: string;
-    tokenIn: string;
-    tokenOut: string;
-    /** Decimal string i128. */
-    minAmountOut: string;
-}
+export type StellarSwapStepsInput = AggregatorSwapDto;
+export type StellarSwapHopInput = SwapHopDto;
+export type StellarSwapPathInput = SwapPathDto;
+export type StellarSwapVenue = SwapVenue;
 /**
  * supply(caller, account_id: u64, e_mode_category: u32, assets: Vec<(Address, i128)>)
  * @xoxno/types `SupplyArgs` is a single-asset shape; the Stellar contract

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

@@ -0,0 +1,58 @@
+/**
+ * Typed client for the Stellar aggregator quote server
+ * (`GET /api/v1/quote`, `GET /api/v1/tokens`).
+ *
+ * The quote server is a standalone Rust service (deployed independently
+ * of the main XOXNO API), so this module hits its base URL directly
+ * rather than routing through the swagger-driven endpoints map.
+ *
+ * All response shapes are mirrored 1:1 by `@xoxno/types` DTOs
+ * (`StellarAggregatorQuoteResponseDto`, `StellarQuotePathDto`, etc.) —
+ * 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 StellarNetwork } from './contracts';
+/**
+ * Resolved token entry returned by the quote server's tokens endpoint.
+ * Mirrors the indexer's `TokenEntry` JSON exactly.
+ */
+export interface StellarQuoteToken {
+    /** Canonical token id. `C…` for Soroban contracts; `CODE:GISSUER…`
+     *  for Classic; `XLM` for native. */
+    id: string;
+    kind: StellarTokenKind;
+    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;
+}
+export interface StellarQuoteFetchOptions {
+    /** Network selects which base URL to hit. */
+    network: StellarNetwork;
+    /** Override the resolved base URL (useful for tests / preview). */
+    baseUrl?: string;
+    /** Per-call fetch options (signal, headers, etc.). */
+    fetchOptions?: RequestInit;
+}
+/**
+ * Fetch a route quote from the Stellar aggregator quote server.
+ *
+ * Forward mode: pass `amountIn` to compute the maximum reachable
+ * `amountOut`. Reverse mode: pass `amountOut` to compute the minimum
+ * `amountIn` that delivers at least that output.
+ *
+ * Pass both `sender` (G-strkey) and `router` (C-strkey) to receive a
+ * ready-to-sign envelope under `transaction.envelopeXdr`. The caller
+ * must still run `simulateTransaction` to attach Soroban resource fees
+ * before signing.
+ */
+export declare function getStellarAggregatorQuote(request: StellarAggregatorQuoteRequestDto, opts: StellarQuoteFetchOptions): Promise<StellarAggregatorQuoteResponseDto>;
+/**
+ * List tokens currently indexed by the quote server. Useful to populate
+ * pickers or validate that a user-supplied token has on-chain liquidity.
+ */
+export declare function getStellarQuoteTokens(opts: StellarQuoteFetchOptions): Promise<StellarQuoteToken[]>;

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

@@ -0,0 +1,41 @@
+/**
+ * Stellar aggregator router direct-call transaction builder.
+ *
+ * Builds an unsigned XDR for `router.batch_execute(BatchSwap)` so a
+ * user can swap A → B without involving the lending controller. The
+ * `BatchSwap.sender` is filled with the caller's G-strkey (the user's
+ * own SAC balances fund the swap and receive the output).
+ *
+ * For lending strategies (multiply / swap_debt / swap_collateral /
+ * repay_debt_with_collateral) the controller wraps the same payload
+ * itself and sets `sender = current_contract_address` — those flows
+ * use the strategy builders in `./lending.ts`, NOT this builder.
+ */
+import type { AggregatorSwapDto, StellarAggregatorQuoteResponseDto } from '@xoxno/types';
+import type { BuiltStellarTx, StellarBuilderOptions } from './lending';
+export interface StellarBatchSwapBuilderOptions extends StellarBuilderOptions {
+    /**
+     * Override the resolved aggregator router contract address. Normally
+     * resolved from `STELLAR_AGGREGATOR_ROUTER[network]`.
+     */
+    routerAddress?: string;
+}
+/**
+ * Build an unsigned XDR for a direct user → aggregator router swap.
+ *
+ * The `swap` payload (paths + per-path min-outs + total-min-out) comes
+ * straight from the quote server; map a
+ * `StellarAggregatorQuoteResponseDto` to `AggregatorSwapDto` via
+ * `mapQuoteResponseToAggregatorSwap` before calling this.
+ */
+export declare function buildStellarBatchSwapTx(opts: StellarBatchSwapBuilderOptions, swap: AggregatorSwapDto): BuiltStellarTx;
+/**
+ * Translate a quote-server response into the controller-facing
+ * `AggregatorSwapDto`. The mapping is purely a key rename plus the
+ * fallback for single-path quotes that omit `paths` (we wrap the flat
+ * `hops` list as a single path).
+ *
+ * Throws if `amountOutMin` is missing — the controller refuses
+ * unbounded swaps so the SDK rejects them at the boundary.
+ */
+export declare function mapQuoteResponseToAggregatorSwap(quote: StellarAggregatorQuoteResponseDto): AggregatorSwapDto;

package/dist/sdk/swagger.d.ts

@@ -398,6 +398,7 @@ export declare const endpoints: {
     readonly "/user/lending/image/:nonce": {
         readonly input: {
             isStatic: boolean;
+            chain?: ActivityChain[];
         };
         readonly output: string;
     };
@@ -430,6 +431,7 @@ export declare const endpoints: {
             orderBy?: LendingPositionOrderByColumn;
             orderDirection?: KustoOrderDirection;
             token?: string;
+            chain?: ActivityChain[];
         };
         readonly output: LendingPositionStatus[];
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xoxno/sdk-js",
-  "version": "1.0.104",
+  "version": "1.0.106",
   "description": "The SDK to interact with the XOXNO Protocol!",
   "type": "module",
   "exports": {
@@ -94,6 +94,6 @@
     "@multiversx/sdk-core": "^15.3.2",
     "@multiversx/sdk-network-providers": "^2.9.3",
     "@stellar/stellar-sdk": "^15.0.1",
-    "@xoxno/types": "^1.0.389"
+    "@xoxno/types": "^1.0.392"
   }
 }