@xoxno/sdk-js 1.0.213 → 1.0.215

package/README.md

@@ -8,14 +8,24 @@ npm install @xoxno/sdk-js
 
 ## Basic usage
 
+For Stellar lending, start with the [integration guide](md/stellar-lending.md)
+and [checked example](examples/stellar-lending.ts). They cover typed market
+discovery and unsigned XDR preparation, wallet signing, submission and confirmation.
+Generate focused API documentation with `npm run docs:stellar`.
+`XOXNOClient` requires an application-supplied `apiUrl`; the SDK does not read
+environment variables or select an API deployment for you.
+For Stellar infrastructure, use the exported `STELLAR_NETWORKS` manifest and
+pass its selected RPC, quote-server and contract values to your host clients.
+
 ```typescript
 import { cache } from 'react'
 
 import { buildSdk, XOXNOClient } from '@xoxno/sdk-js'
+const apiUrl = 'https://api.example.com'
 
 // You can safely call `getSdk()` wherever you need it
 export const getSdk = cache(() => {
-  return buildSdk(new XOXNOClient())
+  return buildSdk(new XOXNOClient({ apiUrl }))
 })
 ```
 
@@ -783,127 +793,133 @@ sdk.stellar.tokens(...); // TokenDataDocHydrated[]
 sdk.stellar.aggregator.quote(...); // SoroswapQuoteResponseDto
 
 // GET /stellar-lending/assets
-sdk.stellarLending.assets(...); // StellarAssetListItemDto[]
+sdk.stellarLending.assets(...); // Array<StellarApi.StellarAssetListItemDto>
 
 // GET /stellar-lending/context
-sdk.stellarLending.context(...); // StellarLendingContextDto
+sdk.stellarLending.context(...); // StellarApi.StellarLendingContextDto
 
 // GET /stellar-lending/live-state
-sdk.stellarLending.liveState(...); // StellarLendingLiveStateDto
+sdk.stellarLending.liveState(...); // StellarApi.StellarLendingLiveStateDto
 
 // GET /stellar-lending/markets/detailed
-sdk.stellarLending.markets.detailed(...); // StellarDetailedMarketDto[]
+sdk.stellarLending.markets.detailed(...); // Array<StellarApi.StellarDetailedMarketDto>
 
 // GET /stellar-lending/hubs
-sdk.stellarLending.hubs(...); // StellarHubListItemDto[]
+sdk.stellarLending.hubs(...); // Array<StellarApi.StellarHubListItemDto>
 
 // GET /stellar-lending/spokes
-sdk.stellarLending.spokes(...); // StellarSpokeListItemDto[]
+sdk.stellarLending.spokes(...); // Array<StellarApi.StellarSpokeListItemDto>
 
 // GET /stellar-lending/reserves
-sdk.stellarLending.reserves(...); // StellarReserveListItemDto[]
+sdk.stellarLending.reserves(...); // Array<StellarApi.StellarReserveListItemDto>
 
 // GET /stellar-lending/reserves/:spokeId/:hubId/:asset
-sdk.stellarLending.reserves.spokeId("...").hubId("...").asset("...")(...); // ReserveDto
+sdk.stellarLending.reserves.spokeId("...").hubId("...").asset("...")(...); // StellarApi.ReserveDto
 
 // GET /stellar-lending/reserves/:spokeId/:hubId/:asset/holders
-sdk.stellarLending.reserves.spokeId("...").hubId("...").asset("...").holders(...); // TopHoldersDto
+sdk.stellarLending.reserves.spokeId("...").hubId("...").asset("...").holders(...); // StellarApi.TopHoldersDto
 
 // GET /stellar-lending/hubs/:hubId/holders
-sdk.stellarLending.hubs.hubId("...").holders(...); // TopHoldersDto
+sdk.stellarLending.hubs.hubId("...").holders(...); // StellarApi.TopHoldersDto
 
 // GET /stellar-lending/spokes/:spokeId/holders
-sdk.stellarLending.spokes.spokeId("...").holders(...); // TopHoldersDto
+sdk.stellarLending.spokes.spokeId("...").holders(...); // StellarApi.TopHoldersDto
 
 // GET /stellar-lending/assets/:asset
-sdk.stellarLending.assets.asset("...")(...); // AssetDto
+sdk.stellarLending.assets.asset("...")(...); // StellarApi.AssetDto
 
 // GET /stellar-lending/assets/:asset/page
-sdk.stellarLending.assets.asset("...").page(...); // AssetPageDto
+sdk.stellarLending.assets.asset("...").page(...); // StellarApi.AssetPageDto
 
 // GET /stellar-lending/assets/:asset/markets
-sdk.stellarLending.assets.asset("...").markets(...); // AssetMarketDto[]
+sdk.stellarLending.assets.asset("...").markets(...); // Array<StellarApi.AssetMarketDto>
 
 // GET /stellar-lending/hubs/:hubId
-sdk.stellarLending.hubs.hubId("...")(...); // HubDto
+sdk.stellarLending.hubs.hubId("...")(...); // StellarApi.HubDto
 
 // GET /stellar-lending/spokes/:spokeId
-sdk.stellarLending.spokes.spokeId("...")(...); // SpokeDto
+sdk.stellarLending.spokes.spokeId("...")(...); // StellarApi.SpokeDto
 
 // GET /stellar-lending/users/:owner/positions
-sdk.stellarLending.users.owner("...").positions(...); // AccountPositionsDto
+sdk.stellarLending.users.owner("...").positions(...); // StellarApi.AccountPositionsDto
 
 // GET /stellar-lending/users/:owner/activity
-sdk.stellarLending.users.owner("...").activity(...); // StellarUserActivityItemDto[]
+sdk.stellarLending.users.owner("...").activity(...); // Array<StellarApi.StellarUserActivityItemDto>
 
 // GET /stellar-lending/accounts/:accountId/positions
-sdk.stellarLending.accounts.accountId("...").positions(...); // AccountPositionsDto
+sdk.stellarLending.accounts.accountId("...").positions(...); // StellarApi.AccountPositionsDto
 
 // GET /stellar-lending/governance/proposals
-sdk.stellarLending.governance.proposals(...); // GovernanceProposalsPageDto
+sdk.stellarLending.governance.proposals(...); // StellarApi.GovernanceProposalsPageDto
 
 // GET /stellar-lending/assets/:asset/graph
-sdk.stellarLending.assets.asset("...").graph(...); // MarketGraphDto
+sdk.stellarLending.assets.asset("...").graph(...); // StellarApi.MarketGraphDto
 
 // GET /stellar-lending/hubs/:hubId/graph
-sdk.stellarLending.hubs.hubId("...").graph(...); // MarketGraphDto
+sdk.stellarLending.hubs.hubId("...").graph(...); // StellarApi.MarketGraphDto
 
 // GET /stellar-lending/spokes/:spokeId/graph
-sdk.stellarLending.spokes.spokeId("...").graph(...); // SpokeGraphDto
+sdk.stellarLending.spokes.spokeId("...").graph(...); // StellarApi.SpokeGraphDto
 
 // GET /stellar-lending/reserves/:spokeId/:hubId/:asset/graph
-sdk.stellarLending.reserves.spokeId("...").hubId("...").asset("...").graph(...); // MarketGraphDto
+sdk.stellarLending.reserves.spokeId("...").hubId("...").asset("...").graph(...); // StellarApi.MarketGraphDto
 
 // GET /stellar-lending/stats/history
-sdk.stellarLending.stats.history(...); // StellarStatsHistoryDto
+sdk.stellarLending.stats.history(...); // StellarApi.StellarStatsHistoryDto
 
 // GET /stellar-lending/pnl
-sdk.stellarLending.pnl(...); // StellarPositionsPnlDto
+sdk.stellarLending.pnl(...); // StellarApi.StellarPositionsPnlDto
 
 // GET /stellar-lending/campaign/leaderboard
-sdk.stellarLending.campaign.leaderboard(...); // StellarCampaignLeaderboardDto
+sdk.stellarLending.campaign.leaderboard(...); // StellarApi.StellarCampaignLeaderboardDto
 
 // GET /stellar-lending/campaign/me
-sdk.stellarLending.campaign.me(...); // StellarCampaignMeDto
+sdk.stellarLending.campaign.me(...); // StellarApi.StellarCampaignMeDto
 
 // GET /stellar-lending/positions
-sdk.stellarLending.positions(...); // StellarPositionsRankDto
+sdk.stellarLending.positions(...); // StellarApi.StellarPositionsRankDto
 
 // GET /stellar-lending/users/:accountId/history
-sdk.stellarLending.users.accountId("...").history(...); // UserHistoryDto
+sdk.stellarLending.users.accountId("...").history(...); // StellarApi.UserHistoryDto
 
 // GET /stellar-lending/pnl/scope
-sdk.stellarLending.pnl.scope(...); // PnlByScopeDto
+sdk.stellarLending.pnl.scope(...); // StellarApi.PnlByScopeDto
 
 // GET /stellar-lending/revenue
-sdk.stellarLending.revenue(...); // RevenueSeriesDto
+sdk.stellarLending.revenue(...); // StellarApi.RevenueSeriesDto
 
 // GET /stellar-lending/revenue/fees
-sdk.stellarLending.revenue.fees(...); // FeeRevenueSeriesDto
+sdk.stellarLending.revenue.fees(...); // StellarApi.FeeRevenueSeriesDto
 
 // GET /stellar-lending/participants
-sdk.stellarLending.participants(...); // ParticipantCountsDto
+sdk.stellarLending.participants(...); // StellarApi.ParticipantCountsDto
 
 // GET /stellar-lending/liquidations
-sdk.stellarLending.liquidations(...); // LiquidationsSeriesDto
+sdk.stellarLending.liquidations(...); // StellarApi.LiquidationsSeriesDto
 
 // GET /stellar-lending/liquidations/leaderboard
-sdk.stellarLending.liquidations.leaderboard(...); // LiquidationsLeaderboardDto
+sdk.stellarLending.liquidations.leaderboard(...); // StellarApi.LiquidationsLeaderboardDto
 
 // GET /stellar-lending/volume
-sdk.stellarLending.volume(...); // VolumeSeriesDto
+sdk.stellarLending.volume(...); // StellarApi.VolumeSeriesDto
 
 // GET /stellar-lending/active-users
-sdk.stellarLending.activeUsers(...); // ActiveUsersSeriesDto
+sdk.stellarLending.activeUsers(...); // StellarApi.ActiveUsersSeriesDto
 
 // GET /stellar-lending/distribution
-sdk.stellarLending.distribution(...); // HolderDistributionDto
+sdk.stellarLending.distribution(...); // StellarApi.HolderDistributionDto
 
 // GET /stellar-lending/rate-spread
-sdk.stellarLending.rateSpread(...); // RateSpreadSeriesDto
+sdk.stellarLending.rateSpread(...); // StellarApi.RateSpreadSeriesDto
 
 // GET /stellar-lending/defillama
-sdk.stellarLending.defillama(...); // DefiLlamaDimensionsDto
+sdk.stellarLending.defillama(...); // StellarApi.DefiLlamaDimensionsDto
+
+// GET /stellar-lending/users/:owner/assets/:asset/balance
+sdk.stellarLending.users.owner("...").assets.asset("...").balance(...); // StellarApi.StellarWalletBalanceDto
+
+// GET /stellar-lending/users/:owner/activity/page
+sdk.stellarLending.users.owner("...").activity.page(...); // StellarApi.StellarActivityPageDto
 
 // GET /tokens
 sdk.tokens(...); // TokenDataDocHydrated[]

package/dist/cjs/index.d.ts

@@ -1,3 +1,3 @@
-export * from './utils/api';
-export * from './utils/regex';
-export * from './sdk';
+export * from './utils/api.js';
+export * from './utils/regex.js';
+export * from './sdk/index.js';

package/dist/cjs/sdk/index.d.ts

@@ -1,5 +1,5 @@
-import type { XOXNOClient } from '../utils/api';
-import type { SDK } from './types';
-export * from './stellar';
-export type { SDKTags } from './types';
+import type { XOXNOClient } from '../utils/api.js';
+import type { SDK } from './types.js';
+export * from './stellar/index.js';
+export type { SDKTags } from './types.js';
 export declare function buildSdk(client: XOXNOClient): SDK;

package/dist/cjs/sdk/stellar/__tests__/integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/sdk/stellar/admin.d.ts

@@ -11,7 +11,7 @@
  */
 import type { AssetOracleConfigInputDto, ConfigureAssetOracleArgsDto, EditOracleToleranceArgsDto, InterestRateModelDto, MarketParamsRawDto, PositionLimitsDto } from '@xoxno/types';
 import type { StellarAssetOracle, StellarPriceKey } from '@xoxno/types/stellar-lending';
-import { type BuiltStellarTx, type StellarBuilderOptions } from './lending';
+import { type BuiltStellarTx, type StellarLendingBuilderOptions } from './lending.js';
 import { xdr } from '@stellar/stellar-sdk';
 /** `InterestRateModel` — 8 RAY rates + reserve factor bps. */
 export declare const encodeInterestRateModel: (m: InterestRateModelDto) => xdr.ScVal;
@@ -60,50 +60,50 @@ export interface RewardEntry {
 }
 export interface UpdateAccountThresholdArgs {
     hasRisks: boolean;
-    accountNonces: number[];
+    accountNonces: Array<number | string>;
 }
 /** upgrade(new_wasm_hash: BytesN<32>) */
-export declare function buildStellarUpgradeControllerTx(opts: StellarBuilderOptions, args: {
+export declare function buildStellarUpgradeControllerTx(opts: StellarLendingBuilderOptions, args: {
     wasmHash: string;
 }): BuiltStellarTx;
 /** migrate(new_version: u32) */
-export declare function buildStellarMigrateTx(opts: StellarBuilderOptions, args: {
+export declare function buildStellarMigrateTx(opts: StellarLendingBuilderOptions, args: {
     newVersion: number;
 }): BuiltStellarTx;
 /** pause() */
-export declare function buildStellarPauseTx(opts: StellarBuilderOptions): BuiltStellarTx;
+export declare function buildStellarPauseTx(opts: StellarLendingBuilderOptions): BuiltStellarTx;
 /** unpause() */
-export declare function buildStellarUnpauseTx(opts: StellarBuilderOptions): BuiltStellarTx;
+export declare function buildStellarUnpauseTx(opts: StellarLendingBuilderOptions): BuiltStellarTx;
 /** grant_role(account: Address, role: Symbol) */
-export declare function buildStellarGrantRoleTx(opts: StellarBuilderOptions, args: RoleGrantArgs): BuiltStellarTx;
+export declare function buildStellarGrantRoleTx(opts: StellarLendingBuilderOptions, args: RoleGrantArgs): BuiltStellarTx;
 /** revoke_role(account: Address, role: Symbol) */
-export declare function buildStellarRevokeRoleTx(opts: StellarBuilderOptions, args: RoleGrantArgs): BuiltStellarTx;
+export declare function buildStellarRevokeRoleTx(opts: StellarLendingBuilderOptions, args: RoleGrantArgs): BuiltStellarTx;
 /** transfer_ownership(new_owner: Address, live_until_ledger: u32) */
-export declare function buildStellarTransferOwnershipTx(opts: StellarBuilderOptions, args: TransferOwnershipArgs): BuiltStellarTx;
+export declare function buildStellarTransferOwnershipTx(opts: StellarLendingBuilderOptions, args: TransferOwnershipArgs): BuiltStellarTx;
 /** accept_ownership() */
-export declare function buildStellarAcceptOwnershipTx(opts: StellarBuilderOptions): BuiltStellarTx;
+export declare function buildStellarAcceptOwnershipTx(opts: StellarLendingBuilderOptions): BuiltStellarTx;
 /** set_swap_aggregator(addr: Address) — #[only_owner] */
-export declare function buildStellarSetSwapAggregatorTx(opts: StellarBuilderOptions, args: {
+export declare function buildStellarSetSwapAggregatorTx(opts: StellarLendingBuilderOptions, args: {
     aggregator: string;
 }): BuiltStellarTx;
 /** set_price_aggregator(addr: Address) — #[only_owner] */
-export declare function buildStellarSetPriceAggregatorTx(opts: StellarBuilderOptions, args: {
+export declare function buildStellarSetPriceAggregatorTx(opts: StellarLendingBuilderOptions, args: {
     aggregator: string;
 }): BuiltStellarTx;
 /** @deprecated Use buildStellarSetSwapAggregatorTx. */
 export declare const buildStellarSetAggregatorTx: typeof buildStellarSetSwapAggregatorTx;
 /** set_accumulator(addr: Address) — #[only_owner] */
-export declare function buildStellarSetAccumulatorTx(opts: StellarBuilderOptions, args: {
+export declare function buildStellarSetAccumulatorTx(opts: StellarLendingBuilderOptions, args: {
     accumulator: string;
 }): BuiltStellarTx;
 /** set_position_limits(limits: PositionLimits) — #[only_owner] */
-export declare function buildStellarSetPositionLimitsTx(opts: StellarBuilderOptions, args: PositionLimitsDto): BuiltStellarTx;
+export declare function buildStellarSetPositionLimitsTx(opts: StellarLendingBuilderOptions, args: PositionLimitsDto): BuiltStellarTx;
 /** approve_blend_pool(pool: Address) — #[only_owner] */
-export declare function buildStellarApproveBlendPoolTx(opts: StellarBuilderOptions, args: {
+export declare function buildStellarApproveBlendPoolTx(opts: StellarLendingBuilderOptions, args: {
     pool: string;
 }): BuiltStellarTx;
 /** revoke_blend_pool(pool: Address) — #[only_owner] */
-export declare function buildStellarRevokeBlendPoolTx(opts: StellarBuilderOptions, args: {
+export declare function buildStellarRevokeBlendPoolTx(opts: StellarLendingBuilderOptions, args: {
     pool: string;
 }): BuiltStellarTx;
 /** @deprecated Use buildStellarApproveBlendPoolTx. */
@@ -115,11 +115,11 @@ export declare const buildStellarRevokeTokenTx: typeof buildStellarRevokeBlendPo
  * contract address as tx source after deploy). Prefer governance propose path
  * in production.
  */
-export declare function buildStellarSetOracleTx(opts: StellarBuilderOptions, args: ConfigureAssetOracleArgs): BuiltStellarTx;
+export declare function buildStellarSetOracleTx(opts: StellarLendingBuilderOptions, args: ConfigureAssetOracleArgs): BuiltStellarTx;
 /** @deprecated Use buildStellarSetOracleTx. */
 export declare const buildStellarSetMarketOracleConfigTx: typeof buildStellarSetOracleTx;
 /** price-aggregator `set_tolerance(key, OracleTolerance)` — owner only. */
-export declare function buildStellarSetOracleToleranceTx(opts: StellarBuilderOptions, args: EditOracleToleranceArgs & {
+export declare function buildStellarSetOracleToleranceTx(opts: StellarLendingBuilderOptions, args: EditOracleToleranceArgs & {
     upperRatioBps?: number;
     lowerRatioBps?: number;
 }): BuiltStellarTx;
@@ -130,7 +130,7 @@ export declare function buildStellarSetOracleToleranceTx(opts: StellarBuilderOpt
  * (`buildStellarGovernanceSetSpokeAssetFlagsImmediateTx`). Every flag is a
  * one-way ratchet here: clearing one requires the timelocked spoke-asset edit.
  */
-export declare function buildStellarSetSpokeAssetFlagsTx(opts: StellarBuilderOptions, args: {
+export declare function buildStellarSetSpokeAssetFlagsTx(opts: StellarLendingBuilderOptions, args: {
     spokeId: number;
     hubId: number;
     asset: string;
@@ -144,36 +144,36 @@ export declare function buildStellarSetSpokeAssetFlagsTx(opts: StellarBuilderOpt
  * Band-only oracle edit; production callers route through the ORACLE-gated
  * governance forwarder (`buildStellarGovernanceSetOracleSanityBoundsImmediateTx`).
  */
-export declare function buildStellarSetOracleSanityBoundsTx(opts: StellarBuilderOptions, args: {
+export declare function buildStellarSetOracleSanityBoundsTx(opts: StellarLendingBuilderOptions, args: {
     asset: string;
     minPriceWad: string;
     maxPriceWad: string;
 }): BuiltStellarTx;
 /** update_indexes(caller, assets: Vec<HubAssetKey>) */
-export declare function buildStellarUpdateIndexesTx(opts: StellarBuilderOptions, args: {
+export declare function buildStellarUpdateIndexesTx(opts: StellarLendingBuilderOptions, args: {
     assets: Array<{
         hubId: number;
         asset: string;
     }>;
 }): BuiltStellarTx;
 /** renew_account(caller, account_id: u64) */
-export declare function buildStellarRenewAccountTx(opts: StellarBuilderOptions, args: {
-    accountNonce: number;
+export declare function buildStellarRenewAccountTx(opts: StellarLendingBuilderOptions, args: {
+    accountNonce: number | string;
 }): BuiltStellarTx;
 /** create_liquidity_pool(hub_id, asset, params: MarketParamsRaw) -> Address — #[only_owner] */
-export declare function buildStellarCreateLiquidityPoolTx(opts: StellarBuilderOptions, args: CreateLiquidityPoolArgs): BuiltStellarTx;
+export declare function buildStellarCreateLiquidityPoolTx(opts: StellarLendingBuilderOptions, args: CreateLiquidityPoolArgs): BuiltStellarTx;
 /** upgrade_liquidity_pool_params(hub_asset: HubAssetKey, params) — #[only_owner] */
-export declare function buildStellarUpgradeLiquidityPoolParamsTx(opts: StellarBuilderOptions, args: UpgradeLiquidityPoolParamsArgs): BuiltStellarTx;
+export declare function buildStellarUpgradeLiquidityPoolParamsTx(opts: StellarLendingBuilderOptions, args: UpgradeLiquidityPoolParamsArgs): BuiltStellarTx;
 /** claim_revenue(caller, assets: Vec<HubAssetKey>) -> Vec<i128> */
-export declare function buildStellarClaimRevenueTx(opts: StellarBuilderOptions, args: {
+export declare function buildStellarClaimRevenueTx(opts: StellarLendingBuilderOptions, args: {
     assets: Array<{
         hubId: number;
         asset: string;
     }>;
 }): BuiltStellarTx;
 /** add_rewards(caller, rewards: Vec<(HubAssetKey, i128)>) */
-export declare function buildStellarAddRewardsTx(opts: StellarBuilderOptions, args: {
+export declare function buildStellarAddRewardsTx(opts: StellarLendingBuilderOptions, args: {
     rewards: RewardEntry[];
 }): BuiltStellarTx;
 /** update_account_threshold(caller, asset, has_risks, account_ids: Vec<u64>) — #[only_role(caller, "KEEPER")] */
-export declare function buildStellarUpdateAccountThresholdTx(opts: StellarBuilderOptions, args: UpdateAccountThresholdArgs): BuiltStellarTx;
+export declare function buildStellarUpdateAccountThresholdTx(opts: StellarLendingBuilderOptions, args: UpdateAccountThresholdArgs): BuiltStellarTx;

package/dist/cjs/sdk/stellar/cctp.d.ts

@@ -1,5 +1,5 @@
-import { type StellarNetwork } from './contracts';
-import type { BuiltStellarTx, StellarBuilderOptions } from './lending';
+import { type StellarNetwork } from './contracts.js';
+import type { BuiltStellarTx, StellarBuilderOptions } from './lending.js';
 export interface BuildStellarCctpForwardTxArgs extends StellarBuilderOptions {
     forwarderAddress: string;
     message: string;

package/dist/cjs/sdk/stellar/contracts.d.ts

@@ -1,70 +1,107 @@
-/**
- * Stellar Soroban contract addresses + Soroban RPC + quote-server config
- * per network.
- *
- * Addresses are env-sourced so ops can rotate mainnet/testnet deployments
- * without a code change. Defaults fall back to empty strings so a missing
- * env surfaces as a clear "not configured" error at call time rather than
- * silently pointing at the wrong contract.
- */
+/** Stellar network identifiers understood by the Soroban transaction builders. */
 export type StellarNetwork = 'mainnet' | 'testnet';
+/** Stable keys for the Stellar network deployment manifest. */
+export type StellarNetworkId = 'stellarMainnet' | 'stellarTestnet';
 /**
- * Stellar lending controller contract addresses per network.
- * Env vars:
- *   - STELLAR_LENDING_CONTROLLER_MAINNET
- *   - STELLAR_LENDING_CONTROLLER_TESTNET
- */
-export declare const STELLAR_LENDING_CONTROLLER: Record<StellarNetwork, string>;
-/**
- * Stellar aggregator router contract addresses per network.
- * Targets `execute_strategy(sender, total_in, swap_xdr)` for direct
- * (non-lending) swaps.
- * Env vars:
- *   - STELLAR_AGGREGATOR_ROUTER_MAINNET
- *   - STELLAR_AGGREGATOR_ROUTER_TESTNET
- */
-export declare const STELLAR_AGGREGATOR_ROUTER: Record<StellarNetwork, string>;
-/**
- * Stellar governance (timelock) contract addresses per network. Owns the
- * controller's admin surface: PROPOSER-gated `propose_*` scheduling and the
- * open `execute` / `execute_*` lifecycle.
- * Env vars:
- *   - STELLAR_GOVERNANCE_MAINNET
- *   - STELLAR_GOVERNANCE_TESTNET
- */
-export declare const STELLAR_GOVERNANCE: Record<StellarNetwork, string>;
-/**
- * Default Soroban RPC URLs per network.
- * Overridable at runtime via the `sorobanRpcUrl` option on each builder.
+ * Public XOXNO Stellar deployment metadata.
+ *
+ * The API URL is deliberately absent: it belongs to `XOXNOClientOptions` and
+ * may use a different host from the chain infrastructure. Consumers choose a
+ * manifest entry by network and may pass its addresses/URLs to their own
+ * transaction and RPC clients.
  */
-export declare const STELLAR_SOROBAN_RPC_URL: Record<StellarNetwork, string>;
+export interface StellarDeployment {
+    readonly name: StellarNetwork;
+    readonly passphrase: string;
+    readonly horizonUrl: string;
+    readonly sorobanRpcUrl: string;
+    readonly quoteUrl: string;
+    readonly explorerNetwork: 'public' | 'testnet';
+    readonly aquariusApiUrl: string;
+    readonly aquariusRouter: string;
+    readonly lendingController: string;
+    readonly aggregatorRouter: string;
+    readonly governance: string;
+    readonly priceAggregator: string;
+    readonly positionNftContract: string;
+}
 /**
- * Stellar aggregator quote-server base URLs per network. The quote server
- * exposes `GET /api/v1/tokens` and `GET /api/v1/quote`.
- *
- * Env vars:
- *   - STELLAR_QUOTE_URL_MAINNET
- *   - STELLAR_QUOTE_URL_TESTNET
+ * XOXNO's supported Stellar deployments. Keep this table in the SDK so UI
+ * and integrators use the same network, RPC, quote-server, and contract IDs.
+ * It contains no environment or runtime discovery logic.
  */
-export declare const STELLAR_QUOTE_URL: Record<StellarNetwork, string>;
+export declare const STELLAR_NETWORKS: {
+    readonly stellarMainnet: {
+        readonly name: "mainnet";
+        readonly passphrase: "Public Global Stellar Network ; September 2015";
+        readonly horizonUrl: "https://horizon.stellar.org";
+        readonly sorobanRpcUrl: "https://stellar-gateway.xoxno.com";
+        readonly quoteUrl: "https://stellar-swap.xoxno.com";
+        readonly explorerNetwork: "public";
+        readonly aquariusApiUrl: "https://amm-api.aqua.network";
+        readonly aquariusRouter: "CBQDHNBFBZYE4MKPWBSJOPIYLW4SFSXAXUTSXJN76GNKYVYPCKWC6QUK";
+        readonly lendingController: "CAUCMIN5KSXEVZ7NMXR3LZATGD5EFIEUI5XWTFLYRO2R5OTXI22WE5JX";
+        readonly aggregatorRouter: "CCVENFSVCBYDHVOACFZXMNNYVOZ3LKXPZYU5LUI4N7KTXOKRVYD7F3TR";
+        readonly governance: "CC44PEQW7HSEPKAZ5ZRPH2JS5M5KVJXCUBLJ2ZX4E3WCDKMNFILHC2AD";
+        readonly priceAggregator: "CBGUF2G2Q7HCVCWYISDXBHPVBGMYNXA7PG2VET66YBZX6IKOOV27NSMV";
+        readonly positionNftContract: "CAWCSG77AY2W24QZ6ZXLHZU4UXEFHZBM6EI4A4IF7JB5CTY4XND3TI6C";
+    };
+    readonly stellarTestnet: {
+        readonly name: "testnet";
+        readonly passphrase: "Test SDF Network ; September 2015";
+        readonly horizonUrl: "https://horizon-testnet.stellar.org";
+        readonly sorobanRpcUrl: "https://stellar-testnet-gateway.xoxno.com";
+        readonly quoteUrl: "https://testnet-stellar-swap.xoxno.com";
+        readonly explorerNetwork: "testnet";
+        readonly aquariusApiUrl: "https://amm-api-testnet.aqua.network";
+        readonly aquariusRouter: "CBCFTQSPDBAIZ6R6PJQKSQWKNKWH2QIV3I4J72SHWBIK3ADRRAM5A6GD";
+        readonly lendingController: "CCXRWJ6SIU2WPFEGLFGJVITPL57QAYIMIO6OAM2NBGNDQSSCK2FFV3F3";
+        readonly aggregatorRouter: "CDNTWMWW2WGYTKIZTJYNGNVQQZI4KTC5BQRZ3275KESRX5T4O3AYECL5";
+        readonly governance: "CDS33JDOYH3F3FL4QUQ6DV4WKHML2AKHF4LADTZ57FRUAEBTE7NMY5FQ";
+        readonly priceAggregator: "CAALOOTIDXCX7D7FMQIBSSAJLPKOM3GMXS4UUSTDIG42JCRRJHOPUHOP";
+        readonly positionNftContract: "CDVN5JU675MEDPVRPCYC45AHFC275UH57WEU5OTFE4WFGZBNN7HTLPSY";
+    };
+};
+/** Lowercase alias for consumers that prefer the UI's existing naming. */
+export declare const stellarNetworks: {
+    readonly stellarMainnet: {
+        readonly name: "mainnet";
+        readonly passphrase: "Public Global Stellar Network ; September 2015";
+        readonly horizonUrl: "https://horizon.stellar.org";
+        readonly sorobanRpcUrl: "https://stellar-gateway.xoxno.com";
+        readonly quoteUrl: "https://stellar-swap.xoxno.com";
+        readonly explorerNetwork: "public";
+        readonly aquariusApiUrl: "https://amm-api.aqua.network";
+        readonly aquariusRouter: "CBQDHNBFBZYE4MKPWBSJOPIYLW4SFSXAXUTSXJN76GNKYVYPCKWC6QUK";
+        readonly lendingController: "CAUCMIN5KSXEVZ7NMXR3LZATGD5EFIEUI5XWTFLYRO2R5OTXI22WE5JX";
+        readonly aggregatorRouter: "CCVENFSVCBYDHVOACFZXMNNYVOZ3LKXPZYU5LUI4N7KTXOKRVYD7F3TR";
+        readonly governance: "CC44PEQW7HSEPKAZ5ZRPH2JS5M5KVJXCUBLJ2ZX4E3WCDKMNFILHC2AD";
+        readonly priceAggregator: "CBGUF2G2Q7HCVCWYISDXBHPVBGMYNXA7PG2VET66YBZX6IKOOV27NSMV";
+        readonly positionNftContract: "CAWCSG77AY2W24QZ6ZXLHZU4UXEFHZBM6EI4A4IF7JB5CTY4XND3TI6C";
+    };
+    readonly stellarTestnet: {
+        readonly name: "testnet";
+        readonly passphrase: "Test SDF Network ; September 2015";
+        readonly horizonUrl: "https://horizon-testnet.stellar.org";
+        readonly sorobanRpcUrl: "https://stellar-testnet-gateway.xoxno.com";
+        readonly quoteUrl: "https://testnet-stellar-swap.xoxno.com";
+        readonly explorerNetwork: "testnet";
+        readonly aquariusApiUrl: "https://amm-api-testnet.aqua.network";
+        readonly aquariusRouter: "CBCFTQSPDBAIZ6R6PJQKSQWKNKWH2QIV3I4J72SHWBIK3ADRRAM5A6GD";
+        readonly lendingController: "CCXRWJ6SIU2WPFEGLFGJVITPL57QAYIMIO6OAM2NBGNDQSSCK2FFV3F3";
+        readonly aggregatorRouter: "CDNTWMWW2WGYTKIZTJYNGNVQQZI4KTC5BQRZ3275KESRX5T4O3AYECL5";
+        readonly governance: "CDS33JDOYH3F3FL4QUQ6DV4WKHML2AKHF4LADTZ57FRUAEBTE7NMY5FQ";
+        readonly priceAggregator: "CAALOOTIDXCX7D7FMQIBSSAJLPKOM3GMXS4UUSTDIG42JCRRJHOPUHOP";
+        readonly positionNftContract: "CDVN5JU675MEDPVRPCYC45AHFC275UH57WEU5OTFE4WFGZBNN7HTLPSY";
+    };
+};
+/** Resolve a deployment from the network name used by transaction builders. */
+export declare function getStellarDeployment(network: StellarNetwork): StellarDeployment;
 /**
  * Stellar network passphrases (Soroban tx signing domain separator).
  * These are fixed by the Stellar network itself and must not be overridden.
  */
-export declare const STELLAR_NETWORK_PASSPHRASE: Record<StellarNetwork, string>;
-/**
- * Assert a controller address is configured for the target network.
- * Throws early with a clear message rather than building an XDR that
- * points at `""`.
- */
-export declare function getStellarLendingController(network: StellarNetwork): string;
-/**
- * Assert an aggregator router address is configured for the target network.
- * Used by `buildStellarExecuteStrategyTx` for direct user -> router swaps.
- */
-export declare function getStellarAggregatorRouter(network: StellarNetwork): string;
-/**
- * Assert a governance address is configured for the target network. Used by
- * the governance `propose_*` / `execute` / `execute_*` builders.
- */
-export declare function getStellarGovernance(network: StellarNetwork): string;
+export declare const STELLAR_NETWORK_PASSPHRASE: {
+    readonly mainnet: "Public Global Stellar Network ; September 2015";
+    readonly testnet: "Test SDF Network ; September 2015";
+};

package/dist/cjs/sdk/stellar/events/index.d.ts

@@ -1,2 +1,2 @@
-export * from './decode';
-export * from './id';
+export * from './decode.js';
+export * from './id.js';