@xoxno/types 1.0.477 → 1.0.479

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -94,7 +94,7 @@ __decorate([
94
94
  ], LendingTokenEModeProfileDoc.prototype, "liquidationBonus", void 0);
95
95
  __decorate([
96
96
  (0, swagger_1.ApiProperty)({
97
- description: 'Spoke supply cap in asset-native units (0 = uncapped). Stellar e-mode only.',
97
+ description: 'Spoke supply cap in asset-native units. Always an enforced ceiling; 0 means the asset accepts no new supply in this spoke (there is no unlimited sentinel). Stellar e-mode only.',
98
98
  required: false,
99
99
  example: '100000000000000',
100
100
  }),
@@ -102,7 +102,7 @@ __decorate([
102
102
  ], LendingTokenEModeProfileDoc.prototype, "supplyCap", void 0);
103
103
  __decorate([
104
104
  (0, swagger_1.ApiProperty)({
105
- description: 'Spoke borrow cap in asset-native units (0 = uncapped). Stellar e-mode only.',
105
+ description: 'Spoke borrow cap in asset-native units. Always an enforced ceiling; 0 means the asset accepts no new borrows in this spoke (there is no unlimited sentinel). Stellar e-mode only.',
106
106
  required: false,
107
107
  example: '100000000000000',
108
108
  }),
@@ -21,11 +21,12 @@ export declare class SwapHopDto {
21
21
  /**
22
22
  * One path in a (possibly multi-path) aggregator swap.
23
23
  *
24
- * `splitPpm` is parts-per-million of the batch's total input allocated
25
- * to this path. The router computes the input for each path from
26
- * `totalIn` and the ppm split; the last path absorbs PPM rounding. Within
27
- * a path, output of hop N feeds hop N+1 directly. The single
28
- * `totalMinOut` guard at the payload level is the final slippage gate.
24
+ * `splitPpm` is parts-per-million of the balance of this path's *starting*
25
+ * token allocated to the path. Paths that start from the same token form one
26
+ * group whose weights may not exceed 1_000_000; when a group routes its whole
27
+ * balance, the encoder lets the final leg sweep the remainder so ppm rounding
28
+ * strands nothing. Within a path, output of hop N feeds hop N+1 directly. The
29
+ * single `totalMinOut` guard at the payload level is the final slippage gate.
29
30
  */
30
31
  export declare class SwapPathDto {
31
32
  hops: SwapHopDto[];
@@ -46,9 +47,11 @@ export declare class StrategyPayloadDto {
46
47
  totalMinOut: string;
47
48
  }
48
49
  /**
49
- * Opaque strategy swap payload as returned by the quote server. `routeXdr`
50
- * is the base64 ScVal XDR for `StrategyPayloadDto`; callers pass the
51
- * decoded bytes to `execute_strategy` or to a lending strategy method.
50
+ * Opaque strategy swap payload as returned by the quote server. `routeXdr` is
51
+ * the base64 ScVal XDR of the router's compact wire form — an address registry,
52
+ * an amount registry, and a packed instruction stream that `StrategyPayloadDto`
53
+ * is lowered into. Callers pass the decoded bytes to `execute_strategy` or to a
54
+ * lending strategy method; they never build the wire form by hand.
52
55
  */
53
56
  export declare class StrategySwapDto {
54
57
  routeXdr: string;
@@ -78,11 +78,12 @@ __decorate([
78
78
  /**
79
79
  * One path in a (possibly multi-path) aggregator swap.
80
80
  *
81
- * `splitPpm` is parts-per-million of the batch's total input allocated
82
- * to this path. The router computes the input for each path from
83
- * `totalIn` and the ppm split; the last path absorbs PPM rounding. Within
84
- * a path, output of hop N feeds hop N+1 directly. The single
85
- * `totalMinOut` guard at the payload level is the final slippage gate.
81
+ * `splitPpm` is parts-per-million of the balance of this path's *starting*
82
+ * token allocated to the path. Paths that start from the same token form one
83
+ * group whose weights may not exceed 1_000_000; when a group routes its whole
84
+ * balance, the encoder lets the final leg sweep the remainder so ppm rounding
85
+ * strands nothing. Within a path, output of hop N feeds hop N+1 directly. The
86
+ * single `totalMinOut` guard at the payload level is the final slippage gate.
86
87
  */
87
88
  class SwapPathDto {
88
89
  }
@@ -101,7 +102,7 @@ __decorate([
101
102
  ], SwapPathDto.prototype, "hops", void 0);
102
103
  __decorate([
103
104
  (0, swagger_1.ApiProperty)({
104
- 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.',
105
+ description: 'Parts per million (ppm) of the starting token balance to route through this path. Must be > 0; weights for paths sharing a starting token must not exceed 1_000_000, and must sum to exactly 1_000_000 unless the payload has a mint leg that consumes the remainder.',
105
106
  example: 1000000,
106
107
  }),
107
108
  (0, class_validator_1.IsInt)(),
@@ -167,16 +168,18 @@ __decorate([
167
168
  __metadata("design:type", String)
168
169
  ], StrategyPayloadDto.prototype, "totalMinOut", void 0);
169
170
  /**
170
- * Opaque strategy swap payload as returned by the quote server. `routeXdr`
171
- * is the base64 ScVal XDR for `StrategyPayloadDto`; callers pass the
172
- * decoded bytes to `execute_strategy` or to a lending strategy method.
171
+ * Opaque strategy swap payload as returned by the quote server. `routeXdr` is
172
+ * the base64 ScVal XDR of the router's compact wire form — an address registry,
173
+ * an amount registry, and a packed instruction stream that `StrategyPayloadDto`
174
+ * is lowered into. Callers pass the decoded bytes to `execute_strategy` or to a
175
+ * lending strategy method; they never build the wire form by hand.
173
176
  */
174
177
  class StrategySwapDto {
175
178
  }
176
179
  exports.StrategySwapDto = StrategySwapDto;
177
180
  __decorate([
178
181
  (0, swagger_1.ApiProperty)({
179
- description: 'Base64 ScVal XDR of `StrategyPayloadDto`, passed as Soroban `Bytes` to `execute_strategy(sender, total_in, swap_xdr)`.',
182
+ description: 'Base64 ScVal XDR of the lowered `StrategyPayloadDto`, passed as Soroban `Bytes` to `execute_strategy(sender, total_in, swap_xdr)`.',
180
183
  example: 'AAAA...',
181
184
  }),
182
185
  (0, class_validator_1.IsString)(),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xoxno/types",
3
- "version": "1.0.477",
3
+ "version": "1.0.479",
4
4
  "description": "Shared types and utilities for XOXNO API.",
5
5
  "exports": {
6
6
  ".": {