@xoxno/types 1.0.391 → 1.0.393

package/dist/index.d.ts

@@ -185,6 +185,7 @@ export * from './entities/web2user-data/web2user.doc';
 export * from './entities/xoxno-liquid-egld-sc/provider.dto';
 export * from './requests/aggregator/arda-swap-result.dto';
 export * from './requests/aggregator/soroswap-quote.dto';
+export * from './requests/aggregator/stellar-aggregator.dto';
 export * from './requests/aggregator/swap';
 export * from './requests/bober-battle/analytics';
 export * from './requests/chat/chat-token';

package/dist/index.js

@@ -274,6 +274,7 @@ __exportStar(require("./enums/xoxno-egld-ls-activity.enum"), exports);
 __exportStar(require("./enums/xoxno-ls-activity.enum"), exports);
 __exportStar(require("./requests/aggregator/arda-swap-result.dto"), exports);
 __exportStar(require("./requests/aggregator/soroswap-quote.dto"), exports);
+__exportStar(require("./requests/aggregator/stellar-aggregator.dto"), exports);
 __exportStar(require("./requests/aggregator/swap"), exports);
 __exportStar(require("./requests/bober-battle/analytics"), exports);
 __exportStar(require("./requests/chat/chat-token"), exports);

package/dist/requests/aggregator/stellar-aggregator.dto.d.ts

@@ -0,0 +1,194 @@
+/**
+ * On-chain venue tag for a single hop. Matches the Soroban
+ * `SwapVenue` enum in `stellar-router-contract/src/types.rs` and
+ * `rs-lending-xlm/common/src/types.rs`.
+ */
+export declare const SWAP_VENUES: readonly ["Soroswap", "Aquarius", "Phoenix", "NativeAmm", "StaticBridge"];
+export type SwapVenue = (typeof SWAP_VENUES)[number];
+/**
+ * Single hop in an aggregator path. Field names use camelCase on the
+ * wire; the SDK encoder rewrites them to snake_case (`fee_bps`, `pool`,
+ * `token_in`, `token_out`, `venue`) when building the Soroban XDR so
+ * the bytes match the on-chain `SwapHop` struct exactly.
+ */
+export declare class SwapHopDto {
+    feeBps: number;
+    pool: string;
+    tokenIn: string;
+    tokenOut: string;
+    venue: SwapVenue;
+}
+/**
+ * One path in a (possibly multi-path) aggregator swap.
+ *
+ * `splitPpm` is parts-per-million of the batch's total input allocated
+ * to this path. The router computes `path_input = totalIn * splitPpm /
+ * 1_000_000`; the LAST path absorbs PPM rounding so the entire `totalIn`
+ * is consumed and no dust is left on the sender. Within a path, output
+ * of hop N feeds hop N+1 directly — there are no per-hop or per-path
+ * amount fields. The single `totalMinOut` guard at the batch level is
+ * the only slippage gate.
+ */
+export declare class SwapPathDto {
+    hops: SwapHopDto[];
+    splitPpm: number;
+}
+/**
+ * User-facing aggregator swap request as accepted by the Soroban
+ * lending controller's strategy methods (`multiply`, `swap_debt`,
+ * `swap_collateral`, `repay_debt_with_collateral`). The controller
+ * wraps this in `BatchSwap` (filling `sender = current_contract_address`
+ * and `totalIn = actual_withdrawn`) before forwarding to the aggregator
+ * router.
+ */
+export declare class AggregatorSwapDto {
+    paths: SwapPathDto[];
+    totalMinOut: string;
+}
+/**
+ * Full payload for the aggregator router's `batch_execute` entry point.
+ * Identical to `AggregatorSwapDto` plus an explicit `sender` (G or
+ * C strkey) whose SAC balance funds the swap (the router pulls
+ * `totalIn` once at the start) and receives the output.
+ *
+ * Lending callers never construct `BatchSwap` directly — the controller
+ * fills `sender` with `current_contract_address` and `totalIn` with the
+ * authoritative withdrawal delta so user funds remain under the
+ * controller's custody for the duration of the strategy.
+ */
+export declare class BatchSwapDto {
+    paths: SwapPathDto[];
+    sender: string;
+    totalIn: string;
+    totalMinOut: string;
+}
+/**
+ * Execution-plane filter for the quote server.
+ *   - `aggregator` (default): Soroban venues only (Soroswap + Aquarius +
+ *     Phoenix + static bridges). Produces a `batch_execute` envelope
+ *     safe for composable contract-to-contract use (Lending → Router).
+ *   - `sdex`: Stellar DEX (native AMM) only.
+ *   - `all`: runs both planes and returns the winner with the runner-up
+ *     attached as an alternative.
+ */
+export declare const STELLAR_QUOTE_PLATFORMS: readonly ["aggregator", "sdex", "all"];
+export type StellarQuotePlatform = (typeof STELLAR_QUOTE_PLATFORMS)[number];
+/**
+ * Token family resolved by the quote server\'s tokens endpoint.
+ *   - `native`: Stellar native lumens (XLM).
+ *   - `classic`: Stellar Classic asset (`CODE:GISSUER`).
+ *   - `soroban`: Soroban asset contract (`C…`).
+ */
+export type StellarTokenKind = 'native' | 'classic' | 'soroban';
+/**
+ * Query parameters for `GET /api/v1/quote` on the Stellar quote server.
+ *
+ * Exactly one of `amountIn` or `amountOut` must be provided. `router`
+ * + `sender` together populate `transaction.envelopeXdr` in the
+ * response with a ready-to-sign `batch_execute` envelope.
+ */
+export declare class StellarAggregatorQuoteRequestDto {
+    from: string;
+    to: string;
+    amountIn?: string;
+    amountOut?: string;
+    maxHops?: number;
+    maxSplits?: number;
+    slippage?: number;
+    includePaths?: boolean;
+    sender?: string;
+    router?: string;
+    platform?: StellarQuotePlatform;
+    fresh?: boolean;
+}
+/**
+ * Single hop entry on the quote response. The shape is wider than
+ * `SwapHopDto` because the server also returns metadata (`dex`, `kind`,
+ * `amountIn`/`amountOut` per hop, decimal-shifted display amounts) that
+ * the UI needs but the on-chain payload does not. The mapping
+ * quote-hop → contract-hop is:
+ *
+ * ```
+ * { feeBps, poolAddress → pool, from → tokenIn, to → tokenOut, dex → venue }
+ * ```
+ */
+export declare class StellarQuoteSwapHopDto {
+    dex: SwapVenue;
+    kind: string;
+    poolAddress: string;
+    feeBps: number;
+    from: string;
+    tokenInKind: StellarTokenKind;
+    to: string;
+    tokenOutKind: StellarTokenKind;
+    amountIn: string;
+    amountOut: string;
+    amountInShort: number;
+    amountOutShort: number;
+}
+/**
+ * Single allocated path in the quote response. Maps 1:1 to `SwapPathDto`
+ * (with field renames) when forwarded into the controller.
+ */
+export declare class StellarQuotePathDto {
+    amountIn: string;
+    amountOut: string;
+    amountInShort: number;
+    amountOutShort: number;
+    splitPpm: number;
+    swaps: StellarQuoteSwapHopDto[];
+}
+/**
+ * Unsigned Soroban transaction envelope returned when the quote
+ * request supplied both `sender` and `router`. The caller MUST:
+ *   1. Populate `seqNum` from the sender\'s account state.
+ *   2. Run `simulateTransaction` to attach Soroban resource fees.
+ *   3. Sign with the sender\'s key (Ed25519 / Stellar Wallets Kit).
+ *   4. Submit via `sendTransaction`.
+ */
+export declare class StellarQuoteTransactionPayloadDto {
+    envelopeXdr: string;
+    sourceAccount: string;
+    routerContract: string;
+    baseFee: number;
+    networkPassphrase: string;
+    notes: string;
+}
+/**
+ * Side-by-side comparison entry attached when `platform=all` is
+ * requested. Always a different `platform` value than the parent
+ * response; nesting is one level deep by construction.
+ */
+export declare class StellarQuoteAlternativeDto {
+    platform: StellarQuotePlatform;
+    quote: StellarAggregatorQuoteResponseDto;
+}
+/**
+ * Response DTO for `GET /api/v1/quote` on the Stellar quote server.
+ * Mirrors the Rust `QuoteResponse` in
+ * `arb-algo/stellar-indexer/src/quote/types.rs` exactly.
+ */
+export declare class StellarAggregatorQuoteResponseDto {
+    mode: 'forward' | 'reverse';
+    from: string;
+    tokenInKind: StellarTokenKind;
+    to: string;
+    tokenOutKind: StellarTokenKind;
+    amountIn: string;
+    amountOut: string;
+    amountInShort: number;
+    amountOutShort: number;
+    amountOutMin?: string;
+    amountOutMinShort?: number;
+    slippage?: number;
+    priceImpact?: number;
+    rate: number;
+    rateInverse: number;
+    decimalsIn: number;
+    decimalsOut: number;
+    hops: StellarQuoteSwapHopDto[];
+    paths?: StellarQuotePathDto[];
+    transaction?: StellarQuoteTransactionPayloadDto;
+    platform: StellarQuotePlatform;
+    alternatives?: StellarQuoteAlternativeDto[];
+}

package/dist/requests/aggregator/stellar-aggregator.dto.js

@@ -0,0 +1,698 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StellarAggregatorQuoteResponseDto = exports.StellarQuoteAlternativeDto = exports.StellarQuoteTransactionPayloadDto = exports.StellarQuotePathDto = exports.StellarQuoteSwapHopDto = exports.StellarAggregatorQuoteRequestDto = exports.STELLAR_QUOTE_PLATFORMS = exports.BatchSwapDto = exports.AggregatorSwapDto = exports.SwapPathDto = exports.SwapHopDto = exports.SWAP_VENUES = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * On-chain venue tag for a single hop. Matches the Soroban
+ * `SwapVenue` enum in `stellar-router-contract/src/types.rs` and
+ * `rs-lending-xlm/common/src/types.rs`.
+ */
+exports.SWAP_VENUES = [
+    'Soroswap',
+    'Aquarius',
+    'Phoenix',
+    'NativeAmm',
+    'StaticBridge',
+];
+/**
+ * Single hop in an aggregator path. Field names use camelCase on the
+ * wire; the SDK encoder rewrites them to snake_case (`fee_bps`, `pool`,
+ * `token_in`, `token_out`, `venue`) when building the Soroban XDR so
+ * the bytes match the on-chain `SwapHop` struct exactly.
+ */
+class SwapHopDto {
+}
+exports.SwapHopDto = SwapHopDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Pool fee in basis points (1 bps = 0.01%). Informational; the pool has authority over the fee actually applied.',
+        example: 30,
+    }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], SwapHopDto.prototype, "feeBps", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Pool contract address (Soroswap/Aquarius/Phoenix), LP account (NativeAmm), or zero bytes (StaticBridge).',
+        example: 'CATK7WRKPAMZKSTNZJ5J6MT7Q7I3DLYEBIAB4CA6Z6SY6LAD2ASQOHNN',
+    }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], SwapHopDto.prototype, "pool", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Soroban Asset Contract address of the input token.',
+        example: 'CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC',
+    }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], SwapHopDto.prototype, "tokenIn", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Soroban Asset Contract address of the output token.',
+        example: 'CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA',
+    }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], SwapHopDto.prototype, "tokenOut", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Which DEX/venue routes this hop.',
+        enum: exports.SWAP_VENUES,
+        example: 'Soroswap',
+    }),
+    (0, class_validator_1.IsIn)(exports.SWAP_VENUES),
+    __metadata("design:type", String)
+], SwapHopDto.prototype, "venue", void 0);
+/**
+ * One path in a (possibly multi-path) aggregator swap.
+ *
+ * `splitPpm` is parts-per-million of the batch's total input allocated
+ * to this path. The router computes `path_input = totalIn * splitPpm /
+ * 1_000_000`; the LAST path absorbs PPM rounding so the entire `totalIn`
+ * is consumed and no dust is left on the sender. Within a path, output
+ * of hop N feeds hop N+1 directly — there are no per-hop or per-path
+ * amount fields. The single `totalMinOut` guard at the batch level is
+ * the only slippage gate.
+ */
+class SwapPathDto {
+}
+exports.SwapPathDto = SwapPathDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Sequential hops executed within this path. Output of hop N flows directly into hop N+1.',
+        type: () => SwapHopDto,
+        isArray: true,
+    }),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => SwapHopDto),
+    __metadata("design:type", Array)
+], SwapPathDto.prototype, "hops", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Parts per million (ppm) of the batch total input to route through this path. Must be > 0; sum of all paths must equal 1_000_000.',
+        example: 1000000,
+    }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(1000000),
+    __metadata("design:type", Number)
+], SwapPathDto.prototype, "splitPpm", void 0);
+/**
+ * User-facing aggregator swap request as accepted by the Soroban
+ * lending controller's strategy methods (`multiply`, `swap_debt`,
+ * `swap_collateral`, `repay_debt_with_collateral`). The controller
+ * wraps this in `BatchSwap` (filling `sender = current_contract_address`
+ * and `totalIn = actual_withdrawn`) before forwarding to the aggregator
+ * router.
+ */
+class AggregatorSwapDto {
+}
+exports.AggregatorSwapDto = AggregatorSwapDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Parallel paths to execute. Length >= 1.',
+        type: () => SwapPathDto,
+        isArray: true,
+    }),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => SwapPathDto),
+    __metadata("design:type", Array)
+], AggregatorSwapDto.prototype, "paths", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: "Aggregate slippage guard across all paths' final output token (i128 decimal string). Must be > 0.",
+        example: '6679778663',
+    }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AggregatorSwapDto.prototype, "totalMinOut", void 0);
+/**
+ * Full payload for the aggregator router's `batch_execute` entry point.
+ * Identical to `AggregatorSwapDto` plus an explicit `sender` (G or
+ * C strkey) whose SAC balance funds the swap (the router pulls
+ * `totalIn` once at the start) and receives the output.
+ *
+ * Lending callers never construct `BatchSwap` directly — the controller
+ * fills `sender` with `current_contract_address` and `totalIn` with the
+ * authoritative withdrawal delta so user funds remain under the
+ * controller's custody for the duration of the strategy.
+ */
+class BatchSwapDto {
+}
+exports.BatchSwapDto = BatchSwapDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: () => SwapPathDto, isArray: true }),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => SwapPathDto),
+    __metadata("design:type", Array)
+], BatchSwapDto.prototype, "paths", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Account whose SAC balances fund the swap and receive the output. G-strkey for user-direct swaps, C-strkey when called by another contract.',
+        example: 'GDBBOILYIJBSUQKC3Z3USAW3DGPFHIGVKYA5T4ZUZBO56HBUPHJEN3FV',
+    }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], BatchSwapDto.prototype, "sender", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: "Total input amount the router will pull from `sender` once at the start of `batch_execute` (i128 decimal string). Per-path allocations come from the router's vault using each path's `splitPpm`.",
+        example: '1000000000',
+    }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], BatchSwapDto.prototype, "totalIn", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Aggregate slippage guard across all paths.',
+        example: '6679778663',
+    }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], BatchSwapDto.prototype, "totalMinOut", void 0);
+/**
+ * Execution-plane filter for the quote server.
+ *   - `aggregator` (default): Soroban venues only (Soroswap + Aquarius +
+ *     Phoenix + static bridges). Produces a `batch_execute` envelope
+ *     safe for composable contract-to-contract use (Lending → Router).
+ *   - `sdex`: Stellar DEX (native AMM) only.
+ *   - `all`: runs both planes and returns the winner with the runner-up
+ *     attached as an alternative.
+ */
+exports.STELLAR_QUOTE_PLATFORMS = ['aggregator', 'sdex', 'all'];
+/**
+ * Query parameters for `GET /api/v1/quote` on the Stellar quote server.
+ *
+ * Exactly one of `amountIn` or `amountOut` must be provided. `router`
+ * + `sender` together populate `transaction.envelopeXdr` in the
+ * response with a ready-to-sign `batch_execute` envelope.
+ */
+class StellarAggregatorQuoteRequestDto {
+}
+exports.StellarAggregatorQuoteRequestDto = StellarAggregatorQuoteRequestDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Input token. Accepts: `XLM`/`native`, `CODE` (first matching Classic), `CODE-SAC`, `XLM-SAC`, `CODE:GISSUER…`, or `C…` (56-char Soroban contract address).',
+        example: 'CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC',
+    }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarAggregatorQuoteRequestDto.prototype, "from", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Output token (same accepted forms as `from`).',
+        example: 'CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA',
+    }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarAggregatorQuoteRequestDto.prototype, "to", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Forward mode: input amount in raw atomic units (i128 decimal string). Mutually exclusive with `amountOut`.',
+        required: false,
+        example: '1000000000',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarAggregatorQuoteRequestDto.prototype, "amountIn", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Reverse mode: target output in raw atomic units. Server computes the minimum input that delivers at least this output.',
+        required: false,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarAggregatorQuoteRequestDto.prototype, "amountOut", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: "Maximum hops per path. Defaults to the server's built-in cap.",
+        required: false,
+        example: 4,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], StellarAggregatorQuoteRequestDto.prototype, "maxHops", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Maximum number of parallel paths the allocator may produce. Default 1 (no split).',
+        required: false,
+        example: 4,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], StellarAggregatorQuoteRequestDto.prototype, "maxSplits", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Slippage tolerance as a decimal (e.g. 0.01 = 1%). When set, the response populates `amountOutMin` at `amountOut * (1 - slippage)`.',
+        required: false,
+        example: 0.01,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(1),
+    __metadata("design:type", Number)
+], StellarAggregatorQuoteRequestDto.prototype, "slippage", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Force `paths[]` in the response even for single-path quotes. Mirrors MVX `includePaths=true` convention.',
+        required: false,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], StellarAggregatorQuoteRequestDto.prototype, "includePaths", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Sender G-strkey. When combined with `router`, the response contains `transaction.envelopeXdr` (an unsigned envelope ready to sign + submit).',
+        required: false,
+        example: 'GDBBOILYIJBSUQKC3Z3USAW3DGPFHIGVKYA5T4ZUZBO56HBUPHJEN3FV',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarAggregatorQuoteRequestDto.prototype, "sender", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Aggregator router C-strkey for envelope construction.',
+        required: false,
+        example: 'CDH6RRN5P6KUAMMTR3TKSX36PZTHMOIG3M3WWEGU2G5GSSSEAYTRU4OK',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarAggregatorQuoteRequestDto.prototype, "router", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Execution-plane filter.',
+        enum: exports.STELLAR_QUOTE_PLATFORMS,
+        required: false,
+        example: 'aggregator',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsIn)(exports.STELLAR_QUOTE_PLATFORMS),
+    __metadata("design:type", String)
+], StellarAggregatorQuoteRequestDto.prototype, "platform", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Reject the quote with HTTP 409 if the indexer snapshot is more than one ledger behind the live network. Costs one extra RPC round-trip.',
+        required: false,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], StellarAggregatorQuoteRequestDto.prototype, "fresh", void 0);
+/**
+ * Single hop entry on the quote response. The shape is wider than
+ * `SwapHopDto` because the server also returns metadata (`dex`, `kind`,
+ * `amountIn`/`amountOut` per hop, decimal-shifted display amounts) that
+ * the UI needs but the on-chain payload does not. The mapping
+ * quote-hop → contract-hop is:
+ *
+ * ```
+ * { feeBps, poolAddress → pool, from → tokenIn, to → tokenOut, dex → venue }
+ * ```
+ */
+class StellarQuoteSwapHopDto {
+}
+exports.StellarQuoteSwapHopDto = StellarQuoteSwapHopDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Venue label. One of the `SwapVenue` variants.',
+        enum: exports.SWAP_VENUES,
+        example: 'Soroswap',
+    }),
+    (0, class_validator_1.IsIn)(exports.SWAP_VENUES),
+    __metadata("design:type", String)
+], StellarQuoteSwapHopDto.prototype, "dex", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Pool shape: `ConstantProduct` | `Stable` | `Static`.',
+        example: 'ConstantProduct',
+    }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarQuoteSwapHopDto.prototype, "kind", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Canonical pool identifier. C-strkey for Soroban pools, L-strkey for native AMM pools.',
+    }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarQuoteSwapHopDto.prototype, "poolAddress", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Pool fee in basis points.', example: 30 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], StellarQuoteSwapHopDto.prototype, "feeBps", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Input token canonical id.' }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarQuoteSwapHopDto.prototype, "from", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Token family of the input token.',
+        enum: ['native', 'classic', 'soroban'],
+    }),
+    (0, class_validator_1.IsIn)(['native', 'classic', 'soroban']),
+    __metadata("design:type", String)
+], StellarQuoteSwapHopDto.prototype, "tokenInKind", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Output token canonical id.' }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarQuoteSwapHopDto.prototype, "to", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Token family of the output token.',
+        enum: ['native', 'classic', 'soroban'],
+    }),
+    (0, class_validator_1.IsIn)(['native', 'classic', 'soroban']),
+    __metadata("design:type", String)
+], StellarQuoteSwapHopDto.prototype, "tokenOutKind", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Input amount on this hop (i128 string).' }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarQuoteSwapHopDto.prototype, "amountIn", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Output amount on this hop (i128 string).' }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarQuoteSwapHopDto.prototype, "amountOut", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Display input amount (decimals applied; loses precision above 2^53).',
+    }),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], StellarQuoteSwapHopDto.prototype, "amountInShort", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Display output amount.' }),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], StellarQuoteSwapHopDto.prototype, "amountOutShort", void 0);
+/**
+ * Single allocated path in the quote response. Maps 1:1 to `SwapPathDto`
+ * (with field renames) when forwarded into the controller.
+ */
+class StellarQuotePathDto {
+}
+exports.StellarQuotePathDto = StellarQuotePathDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Input amount routed through this path.' }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarQuotePathDto.prototype, "amountIn", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Output amount produced by this path.' }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarQuotePathDto.prototype, "amountOut", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Display input amount.' }),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], StellarQuotePathDto.prototype, "amountInShort", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Display output amount.' }),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], StellarQuotePathDto.prototype, "amountOutShort", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Parts-per-million of total input routed through this path. 1_000_000 = 100%.',
+        example: 1000000,
+    }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], StellarQuotePathDto.prototype, "splitPpm", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: () => StellarQuoteSwapHopDto, isArray: true }),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => StellarQuoteSwapHopDto),
+    __metadata("design:type", Array)
+], StellarQuotePathDto.prototype, "swaps", void 0);
+/**
+ * Unsigned Soroban transaction envelope returned when the quote
+ * request supplied both `sender` and `router`. The caller MUST:
+ *   1. Populate `seqNum` from the sender\'s account state.
+ *   2. Run `simulateTransaction` to attach Soroban resource fees.
+ *   3. Sign with the sender\'s key (Ed25519 / Stellar Wallets Kit).
+ *   4. Submit via `sendTransaction`.
+ */
+class StellarQuoteTransactionPayloadDto {
+}
+exports.StellarQuoteTransactionPayloadDto = StellarQuoteTransactionPayloadDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Base64 XDR of the unsigned envelope.' }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarQuoteTransactionPayloadDto.prototype, "envelopeXdr", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Sender G-strkey (echo of request).' }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarQuoteTransactionPayloadDto.prototype, "sourceAccount", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Router contract C-strkey (echo of request).' }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarQuoteTransactionPayloadDto.prototype, "routerContract", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Placeholder base fee in stroops; caller adjusts post-simulation.',
+    }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], StellarQuoteTransactionPayloadDto.prototype, "baseFee", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Network passphrase the envelope is tied to.' }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarQuoteTransactionPayloadDto.prototype, "networkPassphrase", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Human-readable pre-signing checklist.' }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarQuoteTransactionPayloadDto.prototype, "notes", void 0);
+/**
+ * Side-by-side comparison entry attached when `platform=all` is
+ * requested. Always a different `platform` value than the parent
+ * response; nesting is one level deep by construction.
+ */
+class StellarQuoteAlternativeDto {
+}
+exports.StellarQuoteAlternativeDto = StellarQuoteAlternativeDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Platform that produced this alternative.',
+        enum: exports.STELLAR_QUOTE_PLATFORMS,
+    }),
+    (0, class_validator_1.IsIn)(exports.STELLAR_QUOTE_PLATFORMS),
+    __metadata("design:type", String)
+], StellarQuoteAlternativeDto.prototype, "platform", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Full alternative quote. Its own `alternatives` field is always omitted.',
+        type: () => StellarAggregatorQuoteResponseDto,
+    }),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => StellarAggregatorQuoteResponseDto),
+    __metadata("design:type", StellarAggregatorQuoteResponseDto)
+], StellarQuoteAlternativeDto.prototype, "quote", void 0);
+/**
+ * Response DTO for `GET /api/v1/quote` on the Stellar quote server.
+ * Mirrors the Rust `QuoteResponse` in
+ * `arb-algo/stellar-indexer/src/quote/types.rs` exactly.
+ */
+class StellarAggregatorQuoteResponseDto {
+}
+exports.StellarAggregatorQuoteResponseDto = StellarAggregatorQuoteResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ enum: ['forward', 'reverse'] }),
+    (0, class_validator_1.IsIn)(['forward', 'reverse']),
+    __metadata("design:type", String)
+], StellarAggregatorQuoteResponseDto.prototype, "mode", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Input token canonical id.' }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarAggregatorQuoteResponseDto.prototype, "from", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ enum: ['native', 'classic', 'soroban'] }),
+    (0, class_validator_1.IsIn)(['native', 'classic', 'soroban']),
+    __metadata("design:type", String)
+], StellarAggregatorQuoteResponseDto.prototype, "tokenInKind", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Output token canonical id.' }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarAggregatorQuoteResponseDto.prototype, "to", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ enum: ['native', 'classic', 'soroban'] }),
+    (0, class_validator_1.IsIn)(['native', 'classic', 'soroban']),
+    __metadata("design:type", String)
+], StellarAggregatorQuoteResponseDto.prototype, "tokenOutKind", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Input amount (i128 string).' }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarAggregatorQuoteResponseDto.prototype, "amountIn", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Output amount (i128 string).' }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarAggregatorQuoteResponseDto.prototype, "amountOut", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Display input amount.' }),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], StellarAggregatorQuoteResponseDto.prototype, "amountInShort", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Display output amount.' }),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], StellarAggregatorQuoteResponseDto.prototype, "amountOutShort", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Minimum output after slippage (i128 string).',
+        required: false,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarAggregatorQuoteResponseDto.prototype, "amountOutMin", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Display min-out.', required: false }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], StellarAggregatorQuoteResponseDto.prototype, "amountOutMinShort", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Slippage tolerance echoed from the request.',
+        required: false,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], StellarAggregatorQuoteResponseDto.prototype, "slippage", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Price impact as a decimal: `1 - executed_rate / spot_rate`. Absent when spot rate cannot be determined.',
+        required: false,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], StellarAggregatorQuoteResponseDto.prototype, "priceImpact", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Output per 1 unit of input.' }),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], StellarAggregatorQuoteResponseDto.prototype, "rate", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Input per 1 unit of output.' }),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], StellarAggregatorQuoteResponseDto.prototype, "rateInverse", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Decimals of the input token.', example: 7 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], StellarAggregatorQuoteResponseDto.prototype, "decimalsIn", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Decimals of the output token.', example: 7 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], StellarAggregatorQuoteResponseDto.prototype, "decimalsOut", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Flat hop list (concatenation of all paths when split). Useful for compact UI display.',
+        type: () => StellarQuoteSwapHopDto,
+        isArray: true,
+    }),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => StellarQuoteSwapHopDto),
+    __metadata("design:type", Array)
+], StellarAggregatorQuoteResponseDto.prototype, "hops", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Per-path breakdown. Populated when the allocator produced more than one path OR when `includePaths=true` was passed.',
+        required: false,
+        type: () => StellarQuotePathDto,
+        isArray: true,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => StellarQuotePathDto),
+    __metadata("design:type", Array)
+], StellarAggregatorQuoteResponseDto.prototype, "paths", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Unsigned envelope ready to sign + submit. Populated when both `sender` and `router` query params were provided.',
+        required: false,
+        type: () => StellarQuoteTransactionPayloadDto,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => StellarQuoteTransactionPayloadDto),
+    __metadata("design:type", StellarQuoteTransactionPayloadDto)
+], StellarAggregatorQuoteResponseDto.prototype, "transaction", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Execution plane that produced this quote.',
+        enum: exports.STELLAR_QUOTE_PLATFORMS,
+    }),
+    (0, class_validator_1.IsIn)(exports.STELLAR_QUOTE_PLATFORMS),
+    __metadata("design:type", String)
+], StellarAggregatorQuoteResponseDto.prototype, "platform", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Side-by-side comparison. Populated only when `platform=all` was requested AND a non-winning platform produced a quote.',
+        required: false,
+        type: () => StellarQuoteAlternativeDto,
+        isArray: true,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => StellarQuoteAlternativeDto),
+    __metadata("design:type", Array)
+], StellarAggregatorQuoteResponseDto.prototype, "alternatives", void 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xoxno/types",
-  "version": "1.0.391",
+  "version": "1.0.393",
   "description": "Shared types and utilities for XOXNO API.",
   "exports": {
     ".": {