@xoxno/types 1.0.393 → 1.0.395

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

@@ -58,6 +58,7 @@ export declare class AggregatorSwapDto {
  */
 export declare class BatchSwapDto {
     paths: SwapPathDto[];
+    referralId?: number;
     sender: string;
     totalIn: string;
     totalMinOut: string;
@@ -98,6 +99,7 @@ export declare class StellarAggregatorQuoteRequestDto {
     includePaths?: boolean;
     sender?: string;
     router?: string;
+    referralId?: number;
     platform?: StellarQuotePlatform;
     fresh?: boolean;
 }
@@ -115,7 +117,7 @@ export declare class StellarAggregatorQuoteRequestDto {
 export declare class StellarQuoteSwapHopDto {
     dex: SwapVenue;
     kind: string;
-    poolAddress: string;
+    address: string;
     feeBps: number;
     from: string;
     tokenInKind: StellarTokenKind;
@@ -191,4 +193,11 @@ export declare class StellarAggregatorQuoteResponseDto {
     transaction?: StellarQuoteTransactionPayloadDto;
     platform: StellarQuotePlatform;
     alternatives?: StellarQuoteAlternativeDto[];
+    feeBps?: number;
+    feeAmount?: string;
+    feeAmountShort?: number;
+    feeOnInput?: boolean;
+    amountInUsd?: number;
+    amountOutUsd?: number;
+    amountOutMinUsd?: number;
 }

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

@@ -165,6 +165,17 @@ __decorate([
     (0, class_transformer_1.Type)(() => SwapPathDto),
     __metadata("design:type", Array)
 ], BatchSwapDto.prototype, "paths", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Referral identifier. `0` (or omitted) means no referral and no fee — matches rs-aggregator MVX semantics. Non-zero IDs MUST be registered on-chain via `add_referral`; the router rejects unknown IDs at execution.',
+        example: 0,
+        required: false,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], BatchSwapDto.prototype, "referralId", 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.',
@@ -307,6 +318,17 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], StellarAggregatorQuoteRequestDto.prototype, "router", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Referral identifier embedded into the envelope. `0` (default) means no referral / no fee. Non-zero IDs must be registered on-chain via `add_referral` or the contract reverts.',
+        required: false,
+        example: 0,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], StellarAggregatorQuoteRequestDto.prototype, "referralId", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'Execution-plane filter.',
@@ -360,11 +382,11 @@ __decorate([
 ], 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.',
+        description: 'Canonical pool identifier. C-strkey for Soroban pools, L-strkey for native AMM pools. Field name `address` mirrors MVX QuoteSwapResponse exactly so chain-agnostic clients can iterate hops without branching on chain.',
     }),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
-], StellarQuoteSwapHopDto.prototype, "poolAddress", void 0);
+], StellarQuoteSwapHopDto.prototype, "address", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({ description: 'Pool fee in basis points.', example: 30 }),
     (0, class_validator_1.IsInt)(),
@@ -696,3 +718,68 @@ __decorate([
     (0, class_transformer_1.Type)(() => StellarQuoteAlternativeDto),
     __metadata("design:type", Array)
 ], StellarAggregatorQuoteResponseDto.prototype, "alternatives", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Combined static + referral fee in basis points (1 bps = 0.01%) the router will charge for this swap. Absent when `referralId == 0` (no fee — matches rs-aggregator MVX semantics).',
+        required: false,
+        example: 30,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], StellarAggregatorQuoteResponseDto.prototype, "feeBps", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Fee amount the router will deduct (i128 string). Charged on the input token when `feeOnInput=true`, otherwise on the output token. The `amountOut` / `amountOutMin` fields already reflect this deduction.',
+        required: false,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StellarAggregatorQuoteResponseDto.prototype, "feeAmount", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Display value of `feeAmount` (decimals applied; loses precision above 2^53).',
+        required: false,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], StellarAggregatorQuoteResponseDto.prototype, "feeAmountShort", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: '`true` if the fee is charged on the input token, `false` if charged on the output. Mirrors the contract\'s `fee_on_input = !out_whitelisted || in_whitelisted` rule.',
+        required: false,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], StellarAggregatorQuoteResponseDto.prototype, "feeOnInput", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'USD value of `amountIn`. Absent when the input token has no Reflector oracle price on the active network.',
+        required: false,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], StellarAggregatorQuoteResponseDto.prototype, "amountInUsd", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'USD value of `amountOut`.',
+        required: false,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], StellarAggregatorQuoteResponseDto.prototype, "amountOutUsd", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'USD value of `amountOutMin` (only set when `slippage` was requested and the output token has a price).',
+        required: false,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], StellarAggregatorQuoteResponseDto.prototype, "amountOutMinUsd", void 0);

package/package.json

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