@xoxno/types 1.0.478 → 1.0.480

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

@@ -21,11 +21,12 @@ export declare class SwapHopDto {
 /**
  * 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 the input for each path from
- * `totalIn` and the ppm split; the last path absorbs PPM rounding. Within
- * a path, output of hop N feeds hop N+1 directly. The single
- * `totalMinOut` guard at the payload level is the final slippage gate.
+ * `splitPpm` is parts-per-million of the balance of this path's *starting*
+ * token allocated to the path. Paths that start from the same token form one
+ * group whose weights may not exceed 1_000_000; when a group routes its whole
+ * balance, the encoder lets the final leg sweep the remainder so ppm rounding
+ * strands nothing. Within a path, output of hop N feeds hop N+1 directly. The
+ * single `totalMinOut` guard at the payload level is the final slippage gate.
  */
 export declare class SwapPathDto {
     hops: SwapHopDto[];
@@ -46,9 +47,11 @@ export declare class StrategyPayloadDto {
     totalMinOut: string;
 }
 /**
- * Opaque strategy swap payload as returned by the quote server. `routeXdr`
- * is the base64 ScVal XDR for `StrategyPayloadDto`; callers pass the
- * decoded bytes to `execute_strategy` or to a lending strategy method.
+ * Opaque strategy swap payload as returned by the quote server. `routeXdr` is
+ * the base64 ScVal XDR of the router's compact wire form — an address registry,
+ * an amount registry, and a packed instruction stream that `StrategyPayloadDto`
+ * is lowered into. Callers pass the decoded bytes to `execute_strategy` or to a
+ * lending strategy method; they never build the wire form by hand.
  */
 export declare class StrategySwapDto {
     routeXdr: string;

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

@@ -78,11 +78,12 @@ __decorate([
 /**
  * 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 the input for each path from
- * `totalIn` and the ppm split; the last path absorbs PPM rounding. Within
- * a path, output of hop N feeds hop N+1 directly. The single
- * `totalMinOut` guard at the payload level is the final slippage gate.
+ * `splitPpm` is parts-per-million of the balance of this path's *starting*
+ * token allocated to the path. Paths that start from the same token form one
+ * group whose weights may not exceed 1_000_000; when a group routes its whole
+ * balance, the encoder lets the final leg sweep the remainder so ppm rounding
+ * strands nothing. Within a path, output of hop N feeds hop N+1 directly. The
+ * single `totalMinOut` guard at the payload level is the final slippage gate.
  */
 class SwapPathDto {
 }
@@ -101,7 +102,7 @@ __decorate([
 ], 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.',
+        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.',
         example: 1000000,
     }),
     (0, class_validator_1.IsInt)(),
@@ -167,16 +168,18 @@ __decorate([
     __metadata("design:type", String)
 ], StrategyPayloadDto.prototype, "totalMinOut", void 0);
 /**
- * Opaque strategy swap payload as returned by the quote server. `routeXdr`
- * is the base64 ScVal XDR for `StrategyPayloadDto`; callers pass the
- * decoded bytes to `execute_strategy` or to a lending strategy method.
+ * Opaque strategy swap payload as returned by the quote server. `routeXdr` is
+ * the base64 ScVal XDR of the router's compact wire form — an address registry,
+ * an amount registry, and a packed instruction stream that `StrategyPayloadDto`
+ * is lowered into. Callers pass the decoded bytes to `execute_strategy` or to a
+ * lending strategy method; they never build the wire form by hand.
  */
 class StrategySwapDto {
 }
 exports.StrategySwapDto = StrategySwapDto;
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Base64 ScVal XDR of `StrategyPayloadDto`, passed as Soroban `Bytes` to `execute_strategy(sender, total_in, swap_xdr)`.',
+        description: 'Base64 ScVal XDR of the lowered `StrategyPayloadDto`, passed as Soroban `Bytes` to `execute_strategy(sender, total_in, swap_xdr)`.',
         example: 'AAAA...',
     }),
     (0, class_validator_1.IsString)(),

package/dist/stellar-lending/list.d.ts

@@ -38,7 +38,21 @@ export interface StellarAssetListItem {
     hubCount: number;
     /** Number of reserves (spoke,hub) for this asset. */
     marketCount: number;
+    /**
+     * The two underlying token SACs when this asset is an AMM LP share, so
+     * clients can render the pair (both leg logos) instead of one unresolvable
+     * logo for the share itself.
+     *
+     * Projected from the asset's indexed `LpShare` price source
+     * (`StellarAssetOracle.sources[]`). Present only when BOTH legs are
+     * `{ Token }` price keys — a `{ Ref }` leg is registry-only and has no SAC,
+     * so there is nothing to render. Consumers may therefore treat "present" as
+     * "renderable pair" with no partial case to handle.
+     */
+    lpUnderlying?: StellarLpUnderlying;
 }
+/** The two leg SACs of an LP share, in the pool's `[keyA, keyB]` order. */
+export type StellarLpUnderlying = [tokenA: string, tokenB: string];
 /** One (spoke, hub) market row for an asset detail page. */
 export interface StellarAssetPageMarket {
     spokeId: number;

package/package.json

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