@xoxno/sdk-js 1.0.118 → 1.0.120

package/dist/index.bundled.d.cts

@@ -1,7 +1,7 @@
 // Generated by dts-bundle-generator v9.5.1
 
 import { xdr } from '@stellar/stellar-sdk';
-import { ActivePerpAssetCtx, ActiveSpotAssetCtx, AggregatorSwapDto, AirdropDtoHydrated, AnalyticsMarketplaceUniqueUsers, AnalyticsVolumeDto, AnsweredQuestionWithDetails, AssetConfigRawDto, BageQRData, BarDto, BorrowArgs, ChatMessageDocHydrated, ChatMessagePaginated, CheckLikeStatusResponseDto, CollectionHoldersDto, CollectionHoldersExportDto, CollectionMintProfileDocHydrated, CollectionMintProfileDocWithStages, CollectionMintProfileFilter, CollectionMintProfilePaginated, CollectionOffersFilter, CollectionOwnerDto, CollectionPinnedStatusDto, CollectionProfileDoc, CollectionProfileEditDto, CollectionProfileFilter, CollectionProfilePaginated, CollectionRanksDTO, CollectionStatsDocHydrated, CollectionStatsFilter, CollectionStatsPaginated, CreatorDetailsDto, CreatorMarketingNotificationDto, CreatorProfileDoc, CreatorProfileDto, CreatorProfileEditDto, DelegationDataOutput, DiscountCodeValidationResponse, EventAcceptInvitation, EventCheckInQR, EventClaimInvitationDto, EventCountGroupedByCountry, EventGuestApproveDto, EventGuestExport, EventGuestFilter, EventGuestProfile, EventGuestProfileQuery, EventGuestRegistrationDto, EventInvitation, EventInvitationCreateDto, EventInvitationDoc, EventInvitationFilter, EventInvitationQuery, EventNotificationDto, EventProfile, EventProfileCreateDto, EventProfileEditDto, EventProfileFilter, EventProfileQuery, EventQuestionCreateDto, EventQuestionDoc, EventQuestionEditDto, EventReferralConfigCreateDto, EventReferralConfigDoc, EventReferralConfigEditDto, EventReferralConfigFilter, EventReferralConfigPaginated, EventReferralCreateDto, EventReferralDoc, EventReferralEditDto, EventReferralFilter, EventReferralPaginated, EventRegistrationResponseDto, EventStageProfileCreateDto, EventStageProfileDoc, EventStageProfileEditDto, EventTicketProfileCreateDto, EventTicketProfileDoc, EventTicketProfileEditDto, EventUserRole, EventUserRoleCreateDto, EventUserRoleDoc, EventUserRoleEditDto, EventVoucherCreateDto, EventVoucherDoc, EventVoucherEditDto, EventVoucherFilter, EventVoucherQuery, FilterQueryDto, FlashLoanArgs, FloorPriceDto, FollowCollectionDto, GlobalAnalyticsOverviewResponseDto, GlobalConversationSummaryDto, GlobalOfferPaginated, GlobalSearchResourcesPaginated, InterestRateModelDto, InventorySummaryDtoHydrated, L2BookPerpResponseSingle, LendingAccountPnl, LendingAccountProfile, LendingAccountSummary, LendingEModeCategoryProfile, LendingIndexesDto, LendingMarketAnalyticsGraph, LendingMarketAverageGraph, LendingMarketProfile, LendingMarketProfileFilter, LendingMarketProfileQuery, LendingNftAttributes, LendingOverallStats, LendingPositionStatus, LendingTokenPriceDto, LikeNftDto, LiquidateArgs, ListingsResponseDto, LoginAccessDto, LoginRequestDto, ManualCheckInDto, MarketOracleConfigInputDto, MarketParamsRawDto, MobileDeviceDoc, MobileDeviceRegistrationDto, MultiplyArgs, NativeWalletDto, NftActivityDocHydrated, NftActivityFilter, NftActivityPaginated, NftDocFilter, NftDocFull, NftDocHydrated, NftOfferDocFilter, NftOfferDocHydrated, NftOfferPaginated, NftPaginated, NotificationDoc, NotificationPaginated, NotificationPreferencesPostDto, NotificationSuccessResponseDto, OracleSourceConfigInputDto, OwnedCollectionsDto, OwnedServicesDto, PerpCoinExtended, PerpCoinExtendedSlim, PerpEvent, PerpLegalCheck, PerpOrderResponse, PerpSpotCoinExtended, PerpSpotCoinExtendedSlim, PinnedCollectionDto, PositionLimitsDto, ProtocolAprType, ProviderDto, PublicOnly, PushNotificationCountResponse, PushNotificationDoc, PushNotificationResponse, RateType, RepayArgs, RepayDebtWithCollateralArgs, SendChatMessageDto, SetEmailDto, SetPhoneDto, ShareholderDto, SignAcceptGlobalOfferDto, SignDataDto, SignMintDto, SignWithdrawDto, SoroswapQuoteResponseDto, StakingCreatorDoc, StakingEditDto, StakingExploreDtoHydrated, StakingPoolDoc, StakingSummary, StakingUserPoolNfts, StellarAggregatorQuoteRequestDto, StellarAggregatorQuoteResponseDto, StellarChallengeResponseDto, StellarLendingDecodedEvent, StellarTokenKind, SuccessDto, SuccessWithMessageDto, SupplyArgs, SwapCollateralArgs, SwapDebtArgs, SwapHopDto, SwapPathDto, SwapVenue, SwitchWalletDto, SymbolInfoDto, TicketCalculationRequestDto, TicketPricesResponse, TicketValidationResult, TokenDataDocHydrated, TradesPerpResponseSingle, TradesilvaniaSignature, TraitInfo, TransactionCostData, TransactionCreate, TransactionDetailed, TransactionProcessStatus, TransactionSendResult, UserAnalyticsDto, UserBillingDetails, UserBlockPaginated, UserConversationPaginated, UserFavoriteResponseDto, UserInfo, UserNetworkInfoDto, UserProfileDoc, UserProfileDto, UserProfileEditDto, UserSettingsDoc, UserStakingSummaryDto, UserStatsDto, UserTokenInventoryResponseDto, ValueFp, VerifyEmailDto, VolumeGraph, Web2UserDoc, Web2UserShardsDto, Web2WalletDto, WebSocketTokenDto, WithdrawArgs, XoxnoInfo, XoxnoLiquidStatsDto } from '@xoxno/types';
+import { ActivePerpAssetCtx, ActiveSpotAssetCtx, AirdropDtoHydrated, AnalyticsMarketplaceUniqueUsers, AnalyticsVolumeDto, AnsweredQuestionWithDetails, AssetConfigRawDto, BageQRData, BarDto, BorrowArgs, ChatMessageDocHydrated, ChatMessagePaginated, CheckLikeStatusResponseDto, CollectionHoldersDto, CollectionHoldersExportDto, CollectionMintProfileDocHydrated, CollectionMintProfileDocWithStages, CollectionMintProfileFilter, CollectionMintProfilePaginated, CollectionOffersFilter, CollectionOwnerDto, CollectionPinnedStatusDto, CollectionProfileDoc, CollectionProfileEditDto, CollectionProfileFilter, CollectionProfilePaginated, CollectionRanksDTO, CollectionStatsDocHydrated, CollectionStatsFilter, CollectionStatsPaginated, CreatorDetailsDto, CreatorMarketingNotificationDto, CreatorProfileDoc, CreatorProfileDto, CreatorProfileEditDto, DelegationDataOutput, DiscountCodeValidationResponse, EventAcceptInvitation, EventCheckInQR, EventClaimInvitationDto, EventCountGroupedByCountry, EventGuestApproveDto, EventGuestExport, EventGuestFilter, EventGuestProfile, EventGuestProfileQuery, EventGuestRegistrationDto, EventInvitation, EventInvitationCreateDto, EventInvitationDoc, EventInvitationFilter, EventInvitationQuery, EventNotificationDto, EventProfile, EventProfileCreateDto, EventProfileEditDto, EventProfileFilter, EventProfileQuery, EventQuestionCreateDto, EventQuestionDoc, EventQuestionEditDto, EventReferralConfigCreateDto, EventReferralConfigDoc, EventReferralConfigEditDto, EventReferralConfigFilter, EventReferralConfigPaginated, EventReferralCreateDto, EventReferralDoc, EventReferralEditDto, EventReferralFilter, EventReferralPaginated, EventRegistrationResponseDto, EventStageProfileCreateDto, EventStageProfileDoc, EventStageProfileEditDto, EventTicketProfileCreateDto, EventTicketProfileDoc, EventTicketProfileEditDto, EventUserRole, EventUserRoleCreateDto, EventUserRoleDoc, EventUserRoleEditDto, EventVoucherCreateDto, EventVoucherDoc, EventVoucherEditDto, EventVoucherFilter, EventVoucherQuery, FilterQueryDto, FlashLoanArgs, FloorPriceDto, FollowCollectionDto, GlobalAnalyticsOverviewResponseDto, GlobalConversationSummaryDto, GlobalOfferPaginated, GlobalSearchResourcesPaginated, InterestRateModelDto, InventorySummaryDtoHydrated, L2BookPerpResponseSingle, LendingAccountPnl, LendingAccountProfile, LendingAccountSummary, LendingEModeCategoryProfile, LendingIndexesDto, LendingMarketAnalyticsGraph, LendingMarketAverageGraph, LendingMarketProfile, LendingMarketProfileFilter, LendingMarketProfileQuery, LendingNftAttributes, LendingOverallStats, LendingPositionStatus, LendingTokenPriceDto, LikeNftDto, LiquidateArgs, ListingsResponseDto, LoginAccessDto, LoginRequestDto, ManualCheckInDto, MarketOracleConfigInputDto, MarketParamsRawDto, MobileDeviceDoc, MobileDeviceRegistrationDto, MultiplyArgs, NativeWalletDto, NftActivityDocHydrated, NftActivityFilter, NftActivityPaginated, NftDocFilter, NftDocFull, NftDocHydrated, NftOfferDocFilter, NftOfferDocHydrated, NftOfferPaginated, NftPaginated, NotificationDoc, NotificationPaginated, NotificationPreferencesPostDto, NotificationSuccessResponseDto, OracleSourceConfigInputDto, OwnedCollectionsDto, OwnedServicesDto, PerpCoinExtended, PerpCoinExtendedSlim, PerpEvent, PerpLegalCheck, PerpOrderResponse, PerpSpotCoinExtended, PerpSpotCoinExtendedSlim, PinnedCollectionDto, PositionLimitsDto, ProtocolAprType, ProviderDto, PublicOnly, PushNotificationCountResponse, PushNotificationDoc, PushNotificationResponse, RateType, RepayArgs, RepayDebtWithCollateralArgs, SendChatMessageDto, SetEmailDto, SetPhoneDto, ShareholderDto, SignAcceptGlobalOfferDto, SignDataDto, SignMintDto, SignWithdrawDto, SoroswapQuoteResponseDto, StakingCreatorDoc, StakingEditDto, StakingExploreDtoHydrated, StakingPoolDoc, StakingSummary, StakingUserPoolNfts, StellarAggregatorQuoteRequestDto, StellarAggregatorQuoteResponseDto, StellarChallengeResponseDto, StellarLendingDecodedEvent, StellarTokenKind, SuccessDto, SuccessWithMessageDto, SupplyArgs, SwapCollateralArgs, SwapDebtArgs, SwitchWalletDto, SymbolInfoDto, TicketCalculationRequestDto, TicketPricesResponse, TicketValidationResult, TokenDataDocHydrated, TradesPerpResponseSingle, TradesilvaniaSignature, TraitInfo, TransactionCostData, TransactionCreate, TransactionDetailed, TransactionProcessStatus, TransactionSendResult, UserAnalyticsDto, UserBillingDetails, UserBlockPaginated, UserConversationPaginated, UserFavoriteResponseDto, UserInfo, UserNetworkInfoDto, UserProfileDoc, UserProfileDto, UserProfileEditDto, UserSettingsDoc, UserStakingSummaryDto, UserStatsDto, UserTokenInventoryResponseDto, ValueFp, VerifyEmailDto, VolumeGraph, Web2UserDoc, Web2UserShardsDto, Web2WalletDto, WebSocketTokenDto, WithdrawArgs, XoxnoInfo, XoxnoLiquidStatsDto } from '@xoxno/types';
 import { ActivityChain, KustoOrderDirection, LendingPositionOrderByColumn, OfferType, StakingStatus, TokenCategory, UserStatsOrderByColumn } from '@xoxno/types/enums';
 
 export type SafeHeaders = Record<string, string> & {
@@ -2093,7 +2093,8 @@ export type StellarNetwork = "mainnet" | "testnet";
 export declare const STELLAR_LENDING_CONTROLLER: Record<StellarNetwork, string>;
 /**
  * Stellar aggregator router contract addresses per network.
- * Targets `batch_execute(BatchSwap)` for direct (non-lending) swaps.
+ * Targets `execute_strategy(sender, total_in, swap_xdr)` for direct
+ * (non-lending) swaps.
  * Env vars:
  *   - STELLAR_AGGREGATOR_ROUTER_MAINNET
  *   - STELLAR_AGGREGATOR_ROUTER_TESTNET
@@ -2126,9 +2127,42 @@ export declare const STELLAR_NETWORK_PASSPHRASE: Record<StellarNetwork, string>;
 export declare function getStellarLendingController(network: StellarNetwork): string;
 /**
  * Assert an aggregator router address is configured for the target network.
- * Used by `buildStellarBatchSwapTx` for direct user→router swaps.
+ * Used by `buildStellarExecuteStrategyTx` for direct user -> router swaps.
  */
 export declare function getStellarAggregatorRouter(network: StellarNetwork): string;
+declare const STELLAR_SWAP_VENUES: readonly [
+	"Soroswap",
+	"Aquarius",
+	"Phoenix",
+	"Sushi",
+	"CometDex"
+];
+export type StellarSwapVenue = (typeof STELLAR_SWAP_VENUES)[number];
+export interface StellarStrategySwapHopInput {
+	amountOut: string;
+	pool: string;
+	tokenIn: string;
+	tokenOut: string;
+	venue: StellarSwapVenue;
+}
+export interface StellarStrategySwapPathInput {
+	hops: StellarStrategySwapHopInput[];
+	splitPpm: number;
+}
+export interface StellarStrategyPayloadInput {
+	paths: StellarStrategySwapPathInput[];
+	referralId?: number | string;
+	tokenIn: string;
+	tokenOut: string;
+	totalMinOut: string;
+}
+export type StellarStrategySwapInput = string | Uint8Array | {
+	routeXdr: string;
+} | {
+	swapXdr: string;
+} | {
+	bytes: string | Uint8Array;
+} | StellarStrategyPayloadInput;
 /**
  * Stellar `G...` public key of the caller (tx source account).
  */
@@ -2163,14 +2197,15 @@ export interface BuiltStellarTx {
  * `MultiplyArgs.steps`, `SwapDebtArgs.steps`, `SwapCollateralArgs.steps`, and
  * `RepayDebtWithCollateralArgs.steps`.
  *
- * `@xoxno/types` declares `steps: unknown` on these DTOs so every chain owns its
- * own encoding. On Stellar, callers must pass an `AggregatorSwapDto`, which is
- * serialised into the Soroban `AggregatorSwap` struct.
+ * `@xoxno/types` declares `steps: unknown` on these DTOs so every chain owns
+ * its own encoding. On Stellar, callers pass opaque aggregator strategy bytes,
+ * normally the quote response `routeXdr` (base64 ScVal XDR) or `{ routeXdr }`.
+ * The lending controller forwards those bytes to the aggregator and does not
+ * decode the aggregator route.
  */
-export type StellarSwapStepsInput = AggregatorSwapDto;
-export type StellarSwapHopInput = SwapHopDto;
-export type StellarSwapPathInput = SwapPathDto;
-export type StellarSwapVenue = SwapVenue;
+export type StellarSwapStepsInput = StellarStrategySwapInput;
+export type StellarSwapHopInput = StellarStrategySwapHopInput;
+export type StellarSwapPathInput = StellarStrategySwapPathInput;
 /**
  * Assemble an unsigned XDR that invokes a single Soroban contract method.
  *
@@ -2209,8 +2244,8 @@ export declare function buildStellarFlashLoanTx(opts: StellarBuilderOptions, arg
 /**
  * multiply(caller, account_id, e_mode_category, collateral_token,
  *          debt_to_flash_loan: i128, debt_token, mode: PositionMode,
- *          swap: AggregatorSwap, initial_payment: Option<(Address, i128)>,
- *          convert_swap: Option<AggregatorSwap>) -> u64
+ *          swap: Bytes, initial_payment: Option<(Address, i128)>,
+ *          convert_swap: Option<Bytes>) -> u64
  *
  * `mode` is a repr(u32) `PositionMode` → encoded as `scvU32`. The two trailing
  * `Option`s seed an optional initial collateral payment and a secondary swap
@@ -2219,18 +2254,18 @@ export declare function buildStellarFlashLoanTx(opts: StellarBuilderOptions, arg
 export declare function buildStellarMultiplyTx(opts: StellarBuilderOptions, args: MultiplyArgs): BuiltStellarTx;
 /**
  * swap_debt(caller, account_id, existing_debt_token, new_debt_amount: i128,
- *           new_debt_token, steps: SwapSteps)
+ *           new_debt_token, steps: Bytes)
  */
 export declare function buildStellarSwapDebtTx(opts: StellarBuilderOptions, args: SwapDebtArgs): BuiltStellarTx;
 /**
  * swap_collateral(caller, account_id, current_collateral, from_amount: i128,
- *                 new_collateral, steps: SwapSteps)
+ *                 new_collateral, steps: Bytes)
  */
 export declare function buildStellarSwapCollateralTx(opts: StellarBuilderOptions, args: SwapCollateralArgs): BuiltStellarTx;
 /**
  * repay_debt_with_collateral(caller, account_id, collateral_token,
  *                            collateral_amount: i128, debt_token,
- *                            steps: SwapSteps, close_position: bool)
+ *                            steps: Bytes, close_position: bool)
  */
 export declare function buildStellarRepayDebtWithCollateralTx(opts: StellarBuilderOptions, args: RepayDebtWithCollateralArgs): BuiltStellarTx;
 /** `InterestRateModel` — 8 RAY rates + reserve factor bps. */
@@ -2500,46 +2535,61 @@ export declare function getStellarAggregatorQuote(request: StellarAggregatorQuot
  * pickers or validate that a user-supplied token has on-chain liquidity.
  */
 export declare function getStellarQuoteTokens(opts: StellarQuoteFetchOptions): Promise<StellarQuoteToken[]>;
-export interface StellarBatchSwapBuilderOptions extends StellarBuilderOptions {
+export type StellarStrategyPayload = StellarStrategyPayloadInput;
+export type StellarStrategySwap = StellarStrategySwapInput;
+export type StellarStrategySwapHop = StellarStrategySwapHopInput;
+export type StellarStrategySwapPath = StellarStrategySwapPathInput;
+export interface StellarExecuteStrategyBuilderOptions extends StellarBuilderOptions {
 	/**
 	 * Override the resolved aggregator router contract address. Normally
 	 * resolved from `STELLAR_AGGREGATOR_ROUTER[network]`.
 	 */
 	routerAddress?: string;
 	/**
-	 * Total input amount the router will pull from `caller` once at the
-	 * start of `batch_execute` (i128 decimal string). Per-path
-	 * allocations are derived inside the router from each path's
-	 * `splitPpm`. For a quote-derived swap, pass `quote.amountIn`.
+	 * Total input amount passed to `execute_strategy` (i128 decimal string).
+	 * For a quote-derived swap, pass `quote.amountIn`.
 	 */
 	totalIn: string;
 	/**
-	 * Referral identifier embedded into the BatchSwap. Defaults to `0`
-	 * (no referral / no fee — matches rs-aggregator MVX semantics).
-	 * Non-zero IDs MUST be registered on-chain via `add_referral` or the
-	 * router reverts at execution.
+	 * Referral identifier used only when the `swap` input is a decoded
+	 * `StrategyPayload` object and does not already include `referralId`.
+	 * Quote `routeXdr` already contains the referral chosen by the quote server.
 	 */
 	referralId?: number | string;
 }
+/** @deprecated Use `StellarExecuteStrategyBuilderOptions`. */
+export interface StellarBatchSwapBuilderOptions extends StellarExecuteStrategyBuilderOptions {
+}
+export declare const encodeStrategyPayloadToRouteXdr: (payload: StellarStrategyPayloadInput) => string;
 /**
- * Build an unsigned XDR for a direct user → aggregator router swap.
+ * Build an unsigned XDR for a direct user -> aggregator router swap.
  *
- * The `swap` payload (paths + total-min-out) comes straight from the
- * quote server; map a `StellarAggregatorQuoteResponseDto` to
- * `AggregatorSwapDto` via `mapQuoteResponseToAggregatorSwap` before
- * calling this. `opts.totalIn` is the authoritative input amount.
+ * Pass the quote response `routeXdr` string or `{ routeXdr }` directly when
+ * available. Decoded `StrategyPayload` objects are accepted for local tests and
+ * custom route builders.
  */
-export declare function buildStellarBatchSwapTx(opts: StellarBatchSwapBuilderOptions, swap: AggregatorSwapDto): BuiltStellarTx;
+export declare function buildStellarExecuteStrategyTx(opts: StellarExecuteStrategyBuilderOptions, swap: StellarStrategySwapInput): BuiltStellarTx;
 /**
- * Translate a quote-server response into the controller-facing
- * `AggregatorSwapDto`. Each path's `splitPpm` comes straight from the
- * server; the single-path fallback (when `paths` is omitted) gets the
- * full 1_000_000 weight.
- *
- * Throws if `amountOutMin` is missing — the controller refuses
- * unbounded swaps so the SDK rejects them at the boundary.
+ * @deprecated The router no longer exposes `batch_execute`; this wrapper now
+ * builds `execute_strategy(sender, total_in, swap_xdr)`.
  */
-export declare function mapQuoteResponseToAggregatorSwap(quote: StellarAggregatorQuoteResponseDto): AggregatorSwapDto;
+export declare function buildStellarBatchSwapTx(opts: StellarBatchSwapBuilderOptions, swap: StellarStrategySwapInput): BuiltStellarTx;
+/**
+ * Translate a quote-server response into the decoded `StrategyPayload` shape.
+ * Prefer `mapQuoteResponseToStrategySwap` when the quote includes `routeXdr`.
+ */
+export declare function mapQuoteResponseToStrategyPayload(quote: StellarAggregatorQuoteResponseDto, opts?: {
+	referralId?: number | string;
+}): StellarStrategyPayloadInput;
+/**
+ * Return the executable quote route when the API provided it; otherwise build
+ * the decoded fallback payload from hop/path fields.
+ */
+export declare function mapQuoteResponseToStrategySwap(quote: StellarAggregatorQuoteResponseDto, opts?: {
+	referralId?: number | string;
+}): StellarStrategySwapInput;
+/** @deprecated Use `mapQuoteResponseToStrategyPayload`. */
+export declare const mapQuoteResponseToAggregatorSwap: typeof mapQuoteResponseToStrategyPayload;
 export declare function buildSdk(client: XOXNOClient): SDK;
 
 export {};

package/dist/index.bundled.d.ts

@@ -1,7 +1,7 @@
 // Generated by dts-bundle-generator v9.5.1
 
 import { xdr } from '@stellar/stellar-sdk';
-import { ActivePerpAssetCtx, ActiveSpotAssetCtx, AggregatorSwapDto, AirdropDtoHydrated, AnalyticsMarketplaceUniqueUsers, AnalyticsVolumeDto, AnsweredQuestionWithDetails, AssetConfigRawDto, BageQRData, BarDto, BorrowArgs, ChatMessageDocHydrated, ChatMessagePaginated, CheckLikeStatusResponseDto, CollectionHoldersDto, CollectionHoldersExportDto, CollectionMintProfileDocHydrated, CollectionMintProfileDocWithStages, CollectionMintProfileFilter, CollectionMintProfilePaginated, CollectionOffersFilter, CollectionOwnerDto, CollectionPinnedStatusDto, CollectionProfileDoc, CollectionProfileEditDto, CollectionProfileFilter, CollectionProfilePaginated, CollectionRanksDTO, CollectionStatsDocHydrated, CollectionStatsFilter, CollectionStatsPaginated, CreatorDetailsDto, CreatorMarketingNotificationDto, CreatorProfileDoc, CreatorProfileDto, CreatorProfileEditDto, DelegationDataOutput, DiscountCodeValidationResponse, EventAcceptInvitation, EventCheckInQR, EventClaimInvitationDto, EventCountGroupedByCountry, EventGuestApproveDto, EventGuestExport, EventGuestFilter, EventGuestProfile, EventGuestProfileQuery, EventGuestRegistrationDto, EventInvitation, EventInvitationCreateDto, EventInvitationDoc, EventInvitationFilter, EventInvitationQuery, EventNotificationDto, EventProfile, EventProfileCreateDto, EventProfileEditDto, EventProfileFilter, EventProfileQuery, EventQuestionCreateDto, EventQuestionDoc, EventQuestionEditDto, EventReferralConfigCreateDto, EventReferralConfigDoc, EventReferralConfigEditDto, EventReferralConfigFilter, EventReferralConfigPaginated, EventReferralCreateDto, EventReferralDoc, EventReferralEditDto, EventReferralFilter, EventReferralPaginated, EventRegistrationResponseDto, EventStageProfileCreateDto, EventStageProfileDoc, EventStageProfileEditDto, EventTicketProfileCreateDto, EventTicketProfileDoc, EventTicketProfileEditDto, EventUserRole, EventUserRoleCreateDto, EventUserRoleDoc, EventUserRoleEditDto, EventVoucherCreateDto, EventVoucherDoc, EventVoucherEditDto, EventVoucherFilter, EventVoucherQuery, FilterQueryDto, FlashLoanArgs, FloorPriceDto, FollowCollectionDto, GlobalAnalyticsOverviewResponseDto, GlobalConversationSummaryDto, GlobalOfferPaginated, GlobalSearchResourcesPaginated, InterestRateModelDto, InventorySummaryDtoHydrated, L2BookPerpResponseSingle, LendingAccountPnl, LendingAccountProfile, LendingAccountSummary, LendingEModeCategoryProfile, LendingIndexesDto, LendingMarketAnalyticsGraph, LendingMarketAverageGraph, LendingMarketProfile, LendingMarketProfileFilter, LendingMarketProfileQuery, LendingNftAttributes, LendingOverallStats, LendingPositionStatus, LendingTokenPriceDto, LikeNftDto, LiquidateArgs, ListingsResponseDto, LoginAccessDto, LoginRequestDto, ManualCheckInDto, MarketOracleConfigInputDto, MarketParamsRawDto, MobileDeviceDoc, MobileDeviceRegistrationDto, MultiplyArgs, NativeWalletDto, NftActivityDocHydrated, NftActivityFilter, NftActivityPaginated, NftDocFilter, NftDocFull, NftDocHydrated, NftOfferDocFilter, NftOfferDocHydrated, NftOfferPaginated, NftPaginated, NotificationDoc, NotificationPaginated, NotificationPreferencesPostDto, NotificationSuccessResponseDto, OracleSourceConfigInputDto, OwnedCollectionsDto, OwnedServicesDto, PerpCoinExtended, PerpCoinExtendedSlim, PerpEvent, PerpLegalCheck, PerpOrderResponse, PerpSpotCoinExtended, PerpSpotCoinExtendedSlim, PinnedCollectionDto, PositionLimitsDto, ProtocolAprType, ProviderDto, PublicOnly, PushNotificationCountResponse, PushNotificationDoc, PushNotificationResponse, RateType, RepayArgs, RepayDebtWithCollateralArgs, SendChatMessageDto, SetEmailDto, SetPhoneDto, ShareholderDto, SignAcceptGlobalOfferDto, SignDataDto, SignMintDto, SignWithdrawDto, SoroswapQuoteResponseDto, StakingCreatorDoc, StakingEditDto, StakingExploreDtoHydrated, StakingPoolDoc, StakingSummary, StakingUserPoolNfts, StellarAggregatorQuoteRequestDto, StellarAggregatorQuoteResponseDto, StellarChallengeResponseDto, StellarLendingDecodedEvent, StellarTokenKind, SuccessDto, SuccessWithMessageDto, SupplyArgs, SwapCollateralArgs, SwapDebtArgs, SwapHopDto, SwapPathDto, SwapVenue, SwitchWalletDto, SymbolInfoDto, TicketCalculationRequestDto, TicketPricesResponse, TicketValidationResult, TokenDataDocHydrated, TradesPerpResponseSingle, TradesilvaniaSignature, TraitInfo, TransactionCostData, TransactionCreate, TransactionDetailed, TransactionProcessStatus, TransactionSendResult, UserAnalyticsDto, UserBillingDetails, UserBlockPaginated, UserConversationPaginated, UserFavoriteResponseDto, UserInfo, UserNetworkInfoDto, UserProfileDoc, UserProfileDto, UserProfileEditDto, UserSettingsDoc, UserStakingSummaryDto, UserStatsDto, UserTokenInventoryResponseDto, ValueFp, VerifyEmailDto, VolumeGraph, Web2UserDoc, Web2UserShardsDto, Web2WalletDto, WebSocketTokenDto, WithdrawArgs, XoxnoInfo, XoxnoLiquidStatsDto } from '@xoxno/types';
+import { ActivePerpAssetCtx, ActiveSpotAssetCtx, AirdropDtoHydrated, AnalyticsMarketplaceUniqueUsers, AnalyticsVolumeDto, AnsweredQuestionWithDetails, AssetConfigRawDto, BageQRData, BarDto, BorrowArgs, ChatMessageDocHydrated, ChatMessagePaginated, CheckLikeStatusResponseDto, CollectionHoldersDto, CollectionHoldersExportDto, CollectionMintProfileDocHydrated, CollectionMintProfileDocWithStages, CollectionMintProfileFilter, CollectionMintProfilePaginated, CollectionOffersFilter, CollectionOwnerDto, CollectionPinnedStatusDto, CollectionProfileDoc, CollectionProfileEditDto, CollectionProfileFilter, CollectionProfilePaginated, CollectionRanksDTO, CollectionStatsDocHydrated, CollectionStatsFilter, CollectionStatsPaginated, CreatorDetailsDto, CreatorMarketingNotificationDto, CreatorProfileDoc, CreatorProfileDto, CreatorProfileEditDto, DelegationDataOutput, DiscountCodeValidationResponse, EventAcceptInvitation, EventCheckInQR, EventClaimInvitationDto, EventCountGroupedByCountry, EventGuestApproveDto, EventGuestExport, EventGuestFilter, EventGuestProfile, EventGuestProfileQuery, EventGuestRegistrationDto, EventInvitation, EventInvitationCreateDto, EventInvitationDoc, EventInvitationFilter, EventInvitationQuery, EventNotificationDto, EventProfile, EventProfileCreateDto, EventProfileEditDto, EventProfileFilter, EventProfileQuery, EventQuestionCreateDto, EventQuestionDoc, EventQuestionEditDto, EventReferralConfigCreateDto, EventReferralConfigDoc, EventReferralConfigEditDto, EventReferralConfigFilter, EventReferralConfigPaginated, EventReferralCreateDto, EventReferralDoc, EventReferralEditDto, EventReferralFilter, EventReferralPaginated, EventRegistrationResponseDto, EventStageProfileCreateDto, EventStageProfileDoc, EventStageProfileEditDto, EventTicketProfileCreateDto, EventTicketProfileDoc, EventTicketProfileEditDto, EventUserRole, EventUserRoleCreateDto, EventUserRoleDoc, EventUserRoleEditDto, EventVoucherCreateDto, EventVoucherDoc, EventVoucherEditDto, EventVoucherFilter, EventVoucherQuery, FilterQueryDto, FlashLoanArgs, FloorPriceDto, FollowCollectionDto, GlobalAnalyticsOverviewResponseDto, GlobalConversationSummaryDto, GlobalOfferPaginated, GlobalSearchResourcesPaginated, InterestRateModelDto, InventorySummaryDtoHydrated, L2BookPerpResponseSingle, LendingAccountPnl, LendingAccountProfile, LendingAccountSummary, LendingEModeCategoryProfile, LendingIndexesDto, LendingMarketAnalyticsGraph, LendingMarketAverageGraph, LendingMarketProfile, LendingMarketProfileFilter, LendingMarketProfileQuery, LendingNftAttributes, LendingOverallStats, LendingPositionStatus, LendingTokenPriceDto, LikeNftDto, LiquidateArgs, ListingsResponseDto, LoginAccessDto, LoginRequestDto, ManualCheckInDto, MarketOracleConfigInputDto, MarketParamsRawDto, MobileDeviceDoc, MobileDeviceRegistrationDto, MultiplyArgs, NativeWalletDto, NftActivityDocHydrated, NftActivityFilter, NftActivityPaginated, NftDocFilter, NftDocFull, NftDocHydrated, NftOfferDocFilter, NftOfferDocHydrated, NftOfferPaginated, NftPaginated, NotificationDoc, NotificationPaginated, NotificationPreferencesPostDto, NotificationSuccessResponseDto, OracleSourceConfigInputDto, OwnedCollectionsDto, OwnedServicesDto, PerpCoinExtended, PerpCoinExtendedSlim, PerpEvent, PerpLegalCheck, PerpOrderResponse, PerpSpotCoinExtended, PerpSpotCoinExtendedSlim, PinnedCollectionDto, PositionLimitsDto, ProtocolAprType, ProviderDto, PublicOnly, PushNotificationCountResponse, PushNotificationDoc, PushNotificationResponse, RateType, RepayArgs, RepayDebtWithCollateralArgs, SendChatMessageDto, SetEmailDto, SetPhoneDto, ShareholderDto, SignAcceptGlobalOfferDto, SignDataDto, SignMintDto, SignWithdrawDto, SoroswapQuoteResponseDto, StakingCreatorDoc, StakingEditDto, StakingExploreDtoHydrated, StakingPoolDoc, StakingSummary, StakingUserPoolNfts, StellarAggregatorQuoteRequestDto, StellarAggregatorQuoteResponseDto, StellarChallengeResponseDto, StellarLendingDecodedEvent, StellarTokenKind, SuccessDto, SuccessWithMessageDto, SupplyArgs, SwapCollateralArgs, SwapDebtArgs, SwitchWalletDto, SymbolInfoDto, TicketCalculationRequestDto, TicketPricesResponse, TicketValidationResult, TokenDataDocHydrated, TradesPerpResponseSingle, TradesilvaniaSignature, TraitInfo, TransactionCostData, TransactionCreate, TransactionDetailed, TransactionProcessStatus, TransactionSendResult, UserAnalyticsDto, UserBillingDetails, UserBlockPaginated, UserConversationPaginated, UserFavoriteResponseDto, UserInfo, UserNetworkInfoDto, UserProfileDoc, UserProfileDto, UserProfileEditDto, UserSettingsDoc, UserStakingSummaryDto, UserStatsDto, UserTokenInventoryResponseDto, ValueFp, VerifyEmailDto, VolumeGraph, Web2UserDoc, Web2UserShardsDto, Web2WalletDto, WebSocketTokenDto, WithdrawArgs, XoxnoInfo, XoxnoLiquidStatsDto } from '@xoxno/types';
 import { ActivityChain, KustoOrderDirection, LendingPositionOrderByColumn, OfferType, StakingStatus, TokenCategory, UserStatsOrderByColumn } from '@xoxno/types/enums';
 
 export type SafeHeaders = Record<string, string> & {
@@ -2093,7 +2093,8 @@ export type StellarNetwork = "mainnet" | "testnet";
 export declare const STELLAR_LENDING_CONTROLLER: Record<StellarNetwork, string>;
 /**
  * Stellar aggregator router contract addresses per network.
- * Targets `batch_execute(BatchSwap)` for direct (non-lending) swaps.
+ * Targets `execute_strategy(sender, total_in, swap_xdr)` for direct
+ * (non-lending) swaps.
  * Env vars:
  *   - STELLAR_AGGREGATOR_ROUTER_MAINNET
  *   - STELLAR_AGGREGATOR_ROUTER_TESTNET
@@ -2126,9 +2127,42 @@ export declare const STELLAR_NETWORK_PASSPHRASE: Record<StellarNetwork, string>;
 export declare function getStellarLendingController(network: StellarNetwork): string;
 /**
  * Assert an aggregator router address is configured for the target network.
- * Used by `buildStellarBatchSwapTx` for direct user→router swaps.
+ * Used by `buildStellarExecuteStrategyTx` for direct user -> router swaps.
  */
 export declare function getStellarAggregatorRouter(network: StellarNetwork): string;
+declare const STELLAR_SWAP_VENUES: readonly [
+	"Soroswap",
+	"Aquarius",
+	"Phoenix",
+	"Sushi",
+	"CometDex"
+];
+export type StellarSwapVenue = (typeof STELLAR_SWAP_VENUES)[number];
+export interface StellarStrategySwapHopInput {
+	amountOut: string;
+	pool: string;
+	tokenIn: string;
+	tokenOut: string;
+	venue: StellarSwapVenue;
+}
+export interface StellarStrategySwapPathInput {
+	hops: StellarStrategySwapHopInput[];
+	splitPpm: number;
+}
+export interface StellarStrategyPayloadInput {
+	paths: StellarStrategySwapPathInput[];
+	referralId?: number | string;
+	tokenIn: string;
+	tokenOut: string;
+	totalMinOut: string;
+}
+export type StellarStrategySwapInput = string | Uint8Array | {
+	routeXdr: string;
+} | {
+	swapXdr: string;
+} | {
+	bytes: string | Uint8Array;
+} | StellarStrategyPayloadInput;
 /**
  * Stellar `G...` public key of the caller (tx source account).
  */
@@ -2163,14 +2197,15 @@ export interface BuiltStellarTx {
  * `MultiplyArgs.steps`, `SwapDebtArgs.steps`, `SwapCollateralArgs.steps`, and
  * `RepayDebtWithCollateralArgs.steps`.
  *
- * `@xoxno/types` declares `steps: unknown` on these DTOs so every chain owns its
- * own encoding. On Stellar, callers must pass an `AggregatorSwapDto`, which is
- * serialised into the Soroban `AggregatorSwap` struct.
+ * `@xoxno/types` declares `steps: unknown` on these DTOs so every chain owns
+ * its own encoding. On Stellar, callers pass opaque aggregator strategy bytes,
+ * normally the quote response `routeXdr` (base64 ScVal XDR) or `{ routeXdr }`.
+ * The lending controller forwards those bytes to the aggregator and does not
+ * decode the aggregator route.
  */
-export type StellarSwapStepsInput = AggregatorSwapDto;
-export type StellarSwapHopInput = SwapHopDto;
-export type StellarSwapPathInput = SwapPathDto;
-export type StellarSwapVenue = SwapVenue;
+export type StellarSwapStepsInput = StellarStrategySwapInput;
+export type StellarSwapHopInput = StellarStrategySwapHopInput;
+export type StellarSwapPathInput = StellarStrategySwapPathInput;
 /**
  * Assemble an unsigned XDR that invokes a single Soroban contract method.
  *
@@ -2209,8 +2244,8 @@ export declare function buildStellarFlashLoanTx(opts: StellarBuilderOptions, arg
 /**
  * multiply(caller, account_id, e_mode_category, collateral_token,
  *          debt_to_flash_loan: i128, debt_token, mode: PositionMode,
- *          swap: AggregatorSwap, initial_payment: Option<(Address, i128)>,
- *          convert_swap: Option<AggregatorSwap>) -> u64
+ *          swap: Bytes, initial_payment: Option<(Address, i128)>,
+ *          convert_swap: Option<Bytes>) -> u64
  *
  * `mode` is a repr(u32) `PositionMode` → encoded as `scvU32`. The two trailing
  * `Option`s seed an optional initial collateral payment and a secondary swap
@@ -2219,18 +2254,18 @@ export declare function buildStellarFlashLoanTx(opts: StellarBuilderOptions, arg
 export declare function buildStellarMultiplyTx(opts: StellarBuilderOptions, args: MultiplyArgs): BuiltStellarTx;
 /**
  * swap_debt(caller, account_id, existing_debt_token, new_debt_amount: i128,
- *           new_debt_token, steps: SwapSteps)
+ *           new_debt_token, steps: Bytes)
  */
 export declare function buildStellarSwapDebtTx(opts: StellarBuilderOptions, args: SwapDebtArgs): BuiltStellarTx;
 /**
  * swap_collateral(caller, account_id, current_collateral, from_amount: i128,
- *                 new_collateral, steps: SwapSteps)
+ *                 new_collateral, steps: Bytes)
  */
 export declare function buildStellarSwapCollateralTx(opts: StellarBuilderOptions, args: SwapCollateralArgs): BuiltStellarTx;
 /**
  * repay_debt_with_collateral(caller, account_id, collateral_token,
  *                            collateral_amount: i128, debt_token,
- *                            steps: SwapSteps, close_position: bool)
+ *                            steps: Bytes, close_position: bool)
  */
 export declare function buildStellarRepayDebtWithCollateralTx(opts: StellarBuilderOptions, args: RepayDebtWithCollateralArgs): BuiltStellarTx;
 /** `InterestRateModel` — 8 RAY rates + reserve factor bps. */
@@ -2500,46 +2535,61 @@ export declare function getStellarAggregatorQuote(request: StellarAggregatorQuot
  * pickers or validate that a user-supplied token has on-chain liquidity.
  */
 export declare function getStellarQuoteTokens(opts: StellarQuoteFetchOptions): Promise<StellarQuoteToken[]>;
-export interface StellarBatchSwapBuilderOptions extends StellarBuilderOptions {
+export type StellarStrategyPayload = StellarStrategyPayloadInput;
+export type StellarStrategySwap = StellarStrategySwapInput;
+export type StellarStrategySwapHop = StellarStrategySwapHopInput;
+export type StellarStrategySwapPath = StellarStrategySwapPathInput;
+export interface StellarExecuteStrategyBuilderOptions extends StellarBuilderOptions {
 	/**
 	 * Override the resolved aggregator router contract address. Normally
 	 * resolved from `STELLAR_AGGREGATOR_ROUTER[network]`.
 	 */
 	routerAddress?: string;
 	/**
-	 * Total input amount the router will pull from `caller` once at the
-	 * start of `batch_execute` (i128 decimal string). Per-path
-	 * allocations are derived inside the router from each path's
-	 * `splitPpm`. For a quote-derived swap, pass `quote.amountIn`.
+	 * Total input amount passed to `execute_strategy` (i128 decimal string).
+	 * For a quote-derived swap, pass `quote.amountIn`.
 	 */
 	totalIn: string;
 	/**
-	 * Referral identifier embedded into the BatchSwap. Defaults to `0`
-	 * (no referral / no fee — matches rs-aggregator MVX semantics).
-	 * Non-zero IDs MUST be registered on-chain via `add_referral` or the
-	 * router reverts at execution.
+	 * Referral identifier used only when the `swap` input is a decoded
+	 * `StrategyPayload` object and does not already include `referralId`.
+	 * Quote `routeXdr` already contains the referral chosen by the quote server.
 	 */
 	referralId?: number | string;
 }
+/** @deprecated Use `StellarExecuteStrategyBuilderOptions`. */
+export interface StellarBatchSwapBuilderOptions extends StellarExecuteStrategyBuilderOptions {
+}
+export declare const encodeStrategyPayloadToRouteXdr: (payload: StellarStrategyPayloadInput) => string;
 /**
- * Build an unsigned XDR for a direct user → aggregator router swap.
+ * Build an unsigned XDR for a direct user -> aggregator router swap.
  *
- * The `swap` payload (paths + total-min-out) comes straight from the
- * quote server; map a `StellarAggregatorQuoteResponseDto` to
- * `AggregatorSwapDto` via `mapQuoteResponseToAggregatorSwap` before
- * calling this. `opts.totalIn` is the authoritative input amount.
+ * Pass the quote response `routeXdr` string or `{ routeXdr }` directly when
+ * available. Decoded `StrategyPayload` objects are accepted for local tests and
+ * custom route builders.
  */
-export declare function buildStellarBatchSwapTx(opts: StellarBatchSwapBuilderOptions, swap: AggregatorSwapDto): BuiltStellarTx;
+export declare function buildStellarExecuteStrategyTx(opts: StellarExecuteStrategyBuilderOptions, swap: StellarStrategySwapInput): BuiltStellarTx;
 /**
- * Translate a quote-server response into the controller-facing
- * `AggregatorSwapDto`. Each path's `splitPpm` comes straight from the
- * server; the single-path fallback (when `paths` is omitted) gets the
- * full 1_000_000 weight.
- *
- * Throws if `amountOutMin` is missing — the controller refuses
- * unbounded swaps so the SDK rejects them at the boundary.
+ * @deprecated The router no longer exposes `batch_execute`; this wrapper now
+ * builds `execute_strategy(sender, total_in, swap_xdr)`.
  */
-export declare function mapQuoteResponseToAggregatorSwap(quote: StellarAggregatorQuoteResponseDto): AggregatorSwapDto;
+export declare function buildStellarBatchSwapTx(opts: StellarBatchSwapBuilderOptions, swap: StellarStrategySwapInput): BuiltStellarTx;
+/**
+ * Translate a quote-server response into the decoded `StrategyPayload` shape.
+ * Prefer `mapQuoteResponseToStrategySwap` when the quote includes `routeXdr`.
+ */
+export declare function mapQuoteResponseToStrategyPayload(quote: StellarAggregatorQuoteResponseDto, opts?: {
+	referralId?: number | string;
+}): StellarStrategyPayloadInput;
+/**
+ * Return the executable quote route when the API provided it; otherwise build
+ * the decoded fallback payload from hop/path fields.
+ */
+export declare function mapQuoteResponseToStrategySwap(quote: StellarAggregatorQuoteResponseDto, opts?: {
+	referralId?: number | string;
+}): StellarStrategySwapInput;
+/** @deprecated Use `mapQuoteResponseToStrategyPayload`. */
+export declare const mapQuoteResponseToAggregatorSwap: typeof mapQuoteResponseToStrategyPayload;
 export declare function buildSdk(client: XOXNOClient): SDK;
 
 export {};