@xoxno/types 1.0.392 → 1.0.393

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

@@ -19,41 +19,47 @@ export declare class SwapHopDto {
     venue: SwapVenue;
 }
 /**
- * One allocated path in a (possibly multi-path) aggregator swap.
+ * One path in a (possibly multi-path) aggregator swap.
  *
- * `amountIn` is the slice of the user's total input routed through this
- * path. `minAmountOut` is the per-path slippage guard on the last hop's
- * output token — it lets the contract reject one branch being executed
- * at a worse rate even if the aggregate `totalMinOut` is still satisfied.
+ * `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 {
-    amountIn: string;
     hops: SwapHopDto[];
-    minAmountOut: string;
+    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`)
- * before forwarding to the aggregator router.
+ * 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.
+ * Full payload for the aggregator router's `batch_execute` entry point.
  * Identical to `AggregatorSwapDto` plus an explicit `sender` (G or
- * C strkey) whose SAC balances fund the swap and receive the output.
+ * 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` so user funds remain
- * under the controller\'s custody for the duration of the strategy.
+ * 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;
 }
 /**

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

@@ -77,27 +77,22 @@ __decorate([
     __metadata("design:type", String)
 ], SwapHopDto.prototype, "venue", void 0);
 /**
- * One allocated path in a (possibly multi-path) aggregator swap.
+ * One path in a (possibly multi-path) aggregator swap.
  *
- * `amountIn` is the slice of the user's total input routed through this
- * path. `minAmountOut` is the per-path slippage guard on the last hop's
- * output token — it lets the contract reject one branch being executed
- * at a worse rate even if the aggregate `totalMinOut` is still satisfied.
+ * `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: 'Input amount for this path as an i128 decimal string.',
-        example: '1000000000',
-    }),
-    (0, class_validator_1.IsString)(),
-    __metadata("design:type", String)
-], SwapPathDto.prototype, "amountIn", void 0);
-__decorate([
-    (0, swagger_1.ApiProperty)({
-        description: 'Sequential hops executed within this path.',
+        description: 'Sequential hops executed within this path. Output of hop N flows directly into hop N+1.',
         type: () => SwapHopDto,
         isArray: true,
     }),
@@ -109,18 +104,21 @@ __decorate([
 ], SwapPathDto.prototype, "hops", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: "Minimum acceptable output for THIS path on the final hop's output token (i128 decimal string). Enforced per-path on-chain.",
-        example: '6679778663',
+        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.IsString)(),
-    __metadata("design:type", String)
-], SwapPathDto.prototype, "minAmountOut", void 0);
+    (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`)
- * before forwarding to the aggregator router.
+ * wraps this in `BatchSwap` (filling `sender = current_contract_address`
+ * and `totalIn = actual_withdrawn`) before forwarding to the aggregator
+ * router.
  */
 class AggregatorSwapDto {
 }
@@ -139,20 +137,22 @@ __decorate([
 ], AggregatorSwapDto.prototype, "paths", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: "Aggregate slippage guard across all paths' final output token (i128 decimal string).",
+        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.
+ * Full payload for the aggregator router's `batch_execute` entry point.
  * Identical to `AggregatorSwapDto` plus an explicit `sender` (G or
- * C strkey) whose SAC balances fund the swap and receive the output.
+ * 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` so user funds remain
- * under the controller\'s custody for the duration of the strategy.
+ * 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 {
 }
@@ -173,6 +173,14 @@ __decorate([
     (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.',

package/package.json

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