@xoxno/sdk-js 1.0.201 → 1.0.203

package/dist/cjs/sdk/stellar/__tests__/strategy-program.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Cross-language wire-format check for the aggregator's packed strategy program.
+ *
+ * The same fixtures are asserted byte-for-byte in
+ * `contracts/swap-aggregator/tests/unit/payload_wire_format.rs` and
+ * `arb-algo/stellar-indexer/src/transaction/abi.rs`. If this file and those
+ * diverge, routes built by this SDK will be rejected on-chain.
+ */
+export {};

package/dist/cjs/sdk/stellar/lending-read-types.d.ts

@@ -211,3 +211,66 @@ export interface StellarMarketGraphQuery {
     /** Bin width as a timespan string (e.g. `1h`, `1d`). */
     bin: string;
 }
+/**
+ * Config and admin state for one deployed contract, event-sourced by the
+ * indexer from that contract's own config, pause, ownership and admin events.
+ *
+ * Every field is optional-by-absence: a contract only populates what its own
+ * events carry, so a governance row leaves the controller fields null and vice
+ * versa. `paused` is null until a pause or unpause has actually been observed,
+ * which is materially different from a confirmed `false`.
+ */
+export interface StellarContractConfig {
+    contractAddress: string;
+    wasmHash: string | null;
+    accumulator: string | null;
+    swapAggregator: string | null;
+    priceAggregator: string | null;
+    maxSupplyPositions: number | null;
+    maxBorrowPositions: number | null;
+    /** Raw 18-decimal WAD. */
+    minBorrowCollateralUsdWad: string | null;
+    paused: boolean | null;
+    /** Governance timelock delay, in ledgers. */
+    minDelayLedgers: number | null;
+    owner: string | null;
+    pendingOwner: string | null;
+    admin: string | null;
+    pendingAdmin: string | null;
+    pendingAdminLiveUntilLedger: number | null;
+    ledger: number;
+    updatedAt: number;
+}
+/**
+ * One access-control grant. Revocation flips `granted` rather than removing the
+ * row, so a revoked grant stays queryable.
+ */
+export interface StellarContractRole {
+    contractAddress: string;
+    /** On-chain role symbol, e.g. `ORACLE`, `PROPOSER`. */
+    role: string;
+    account: string;
+    granted: boolean;
+    caller: string | null;
+    ledger: number;
+    updatedAt: number;
+}
+/**
+ * One position-authorization grant. A delegate may act on the owner's position,
+ * so this is security-relevant state rather than display metadata.
+ */
+export interface StellarAccountDelegate {
+    accountId: number;
+    owner: string;
+    delegate: string;
+    granted: boolean;
+    ledger: number;
+    updatedAt: number;
+}
+/** Approval state for one Blend pool, kept after revocation as `approved: false`. */
+export interface StellarBlendPool {
+    pool: string;
+    approved: boolean;
+    ledger: number;
+    updatedAt: number;
+}

package/dist/cjs/sdk/stellar/lending-read.d.ts

@@ -13,7 +13,7 @@
  */
 import type { StellarAssetListItem, StellarAssetPage, StellarHubListItem, StellarLendingLiveStateDto, StellarReserveListItem, StellarSpokeListItem, StellarUserActivityItem } from '@xoxno/types/stellar-lending';
 import type { OurRequestInit, XOXNOClient } from '../../utils/api';
-import type { StellarAccountPositions, StellarAsset, StellarAssetMarket, StellarGovernanceProposalsPage, StellarHub, StellarLendingHoldersSide, StellarLendingContext, StellarLendingMarketSide, StellarMarketGraph, StellarMarketGraphQuery, StellarReserve, StellarSpoke, StellarTopHolders } from './lending-read-types';
+import type { StellarAccountDelegate, StellarAccountPositions, StellarAsset, StellarAssetMarket, StellarBlendPool, StellarContractConfig, StellarContractRole, StellarGovernanceProposalsPage, StellarHub, StellarLendingHoldersSide, StellarLendingContext, StellarLendingMarketSide, StellarMarketGraph, StellarMarketGraphQuery, StellarReserve, StellarSpoke, StellarTopHolders } from './lending-read-types';
 type StellarReservesParams = {
     hubId?: number;
     spokeId?: number;
@@ -82,9 +82,34 @@ export declare const getStellarReserveGraph: (client: XOXNOClient, spokeId: numb
  * sites read `read.reserve(spokeId, hubId, asset)` instead of threading the
  * client through every call.
  */
+/**
+ * Config and admin state for every watched contract, or for one address.
+ *
+ * Event-sourced by the indexer rather than read live from the chain, so this is
+ * also where `minBorrowCollateralUsdWad`, position limits and the aggregator
+ * addresses come from — `liveState` no longer needs an RPC round-trip for them.
+ */
+export declare const getStellarProtocolConfig: (client: XOXNOClient, init?: OurRequestInit) => Promise<StellarContractConfig[]>;
+/** Config and admin state for a single contract address. */
+export declare const getStellarContractConfig: (client: XOXNOClient, contractAddress: string, init?: OurRequestInit) => Promise<StellarContractConfig>;
+/**
+ * Access-control grants, optionally narrowed to one contract. Revoked grants
+ * are included with `granted: false` — filter client-side when only current
+ * holders matter.
+ */
+export declare const getStellarContractRoles: (client: XOXNOClient, contractAddress?: string, init?: OurRequestInit) => Promise<StellarContractRole[]>;
+/** Position-authorization grants for one account, including revoked ones. */
+export declare const getStellarAccountDelegates: (client: XOXNOClient, accountId: number, init?: OurRequestInit) => Promise<StellarAccountDelegate[]>;
+/** Blend pool approval state, including pools whose approval was revoked. */
+export declare const getStellarBlendPools: (client: XOXNOClient, init?: OurRequestInit) => Promise<StellarBlendPool[]>;
 export declare const stellarLendingRead: (client: XOXNOClient) => {
     context: (init?: OurRequestInit) => Promise<StellarLendingContext>;
     liveState: (init?: OurRequestInit) => Promise<StellarLendingLiveStateDto>;
+    protocolConfig: (init?: OurRequestInit) => Promise<StellarContractConfig[]>;
+    contractConfig: (contractAddress: string, init?: OurRequestInit) => Promise<StellarContractConfig>;
+    contractRoles: (contractAddress?: string, init?: OurRequestInit) => Promise<StellarContractRole[]>;
+    accountDelegates: (accountId: number, init?: OurRequestInit) => Promise<StellarAccountDelegate[]>;
+    blendPools: (init?: OurRequestInit) => Promise<StellarBlendPool[]>;
     assets: (init?: OurRequestInit) => Promise<StellarAssetListItem[]>;
     hubs: (init?: OurRequestInit) => Promise<StellarHubListItem[]>;
     spokes: (init?: OurRequestInit) => Promise<StellarSpokeListItem[]>;

package/dist/cjs/sdk/stellar/scval-encode.d.ts

@@ -8,12 +8,22 @@
 import { xdr } from '@stellar/stellar-sdk';
 /**
  * On-chain swap venues, validated at runtime for a caller-supplied venue.
- * Mirrors the Soroban-only aggregator router's `SwapVenue` enum.
+ * Mirrors the Soroban-only aggregator router's opcode table.
  */
 export declare const STELLAR_SWAP_VENUES: readonly ["Soroswap", "Aquarius", "Phoenix", "Sushi", "CometDex"];
 export type StellarSwapVenue = (typeof STELLAR_SWAP_VENUES)[number];
+/**
+ * Instruction opcode per venue. Part of the on-chain ABI — see
+ * `contracts/swap-aggregator/src/program.rs`.
+ */
+export declare const STELLAR_SWAP_VENUE_OPCODE: Record<StellarSwapVenue, number>;
+/** Wire version of the packed program. Must match the contract's `VERSION`. */
+export declare const STELLAR_PROGRAM_VERSION = 1;
+/** Split weights are parts per million. */
+export declare const PPM_DENOMINATOR = 1000000;
 export interface StellarStrategySwapHopInput {
-    amountOut: string;
+    /** Quote-side estimate; not carried on the wire. */
+    amountOut?: string;
     pool: string;
     tokenIn: string;
     tokenOut: string;
@@ -21,10 +31,25 @@ export interface StellarStrategySwapHopInput {
 }
 export interface StellarStrategySwapPathInput {
     hops: StellarStrategySwapHopInput[];
+    /** Absolute share of this path's starting-token balance, in ppm. */
     splitPpm: number;
 }
 export interface StellarStrategyPayloadInput {
+    /** Aquarius pool whose LP shares (`tokenIn`) are burned before routing. */
+    burnPool?: string;
+    /** Per-constituent floors for the burn, in the pool's own token order. */
+    burnMinAmounts?: string[];
+    /** Aquarius pool that mints `tokenOut` from the routed constituents. */
+    mintPool?: string;
+    /** Minimum LP shares the mint must deliver. */
+    mintMinShares?: string;
+    /** Constituents of `mintPool`, in pool order. Required with `preSwapAmount`. */
+    mintPoolTokens?: string[];
     paths: StellarStrategySwapPathInput[];
+    /** Caller-solved amount that balances a lopsided mint before the deposit. */
+    preSwapAmount?: string;
+    /** Pre-swap direction: pool token A into B when true, B into A when false. */
+    preSwapFromA?: boolean;
     referralId?: number | string;
     tokenIn: string;
     tokenOut: string;
@@ -99,13 +124,8 @@ export declare const tupleHubAssetAmountVec: (entries: Array<{
  */
 export declare const scStruct: (fields: Record<string, xdr.ScVal>) => xdr.ScVal;
 /**
- * Encode a Soroban `enum SwapVenue` (tag-only / unit variant). At the XDR level
- * a unit variant is `scvVec([symbol_name])`.
- */
-export declare const encodeSwapVenue: (venue: StellarSwapVenue) => xdr.ScVal;
-/**
- * Encode the aggregator router's decoded `StrategyPayload` struct. The caller
- * usually receives this as quote `routeXdr`; this helper is for tests and for
+ * Encode the aggregator router's `StrategyPayload`. The caller usually receives
+ * this already encoded as quote `routeXdr`; this helper is for tests and for
  * callers that construct routes locally.
  */
 export declare const encodeStrategyPayload: (payload: StellarStrategyPayloadInput) => xdr.ScVal;