@xoxno/sdk-js 1.0.229 → 1.0.231

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

@@ -1,8 +1,9 @@
 /** Typed Stellar lending reads. Configure the API deployment with XOXNOClient.apiUrl.
  * These cached HTTP reads do not simulate transactions or authorize spending.
  */
-import type { OurRequestInit, XOXNOClient } from '../../utils/api.js';
+import { type OurRequestInit, type XOXNOClient } from '../../utils/api.js';
 import type * as Api from './lending-api-types.js';
+import type { UserTokenInventoryResponseDto } from '@xoxno/types';
 import type { StellarLendingMarketSide, StellarLendingHoldersSide, StellarMarketGraphQuery, StellarReservesParams, StellarActivityQuery, StellarActivityPageQuery, StellarGovernanceQuery, StellarPositionsQuery, StellarRevenueQuery, StellarFeeRevenueQuery, StellarParticipantsQuery, StellarLiquidationsQuery, StellarLiquidationsLeaderboardQuery, StellarVolumeQuery, StellarDistributionQuery, StellarRateSpreadQuery } from './lending-read-types.js';
 /** Load assets, hubs, spokes, reserves and keyed reserve details in one response.
  * @category Stellar lending reads
@@ -56,7 +57,18 @@ export declare const getStellarUserPositions: (client: XOXNOClient, owner: strin
  * @category Stellar lending reads
  */
 export declare const getStellarAccountPositions: (client: XOXNOClient, accountId: string, init?: OurRequestInit) => Promise<Api.AccountPositionsDto>;
-/** Read exact token base-unit holdings for a G or C wallet. Holdings may exceed spendable funds. Requires the API release exposing this route; older deployments return 404.
+/** Read a G or C wallet's token holdings from `/user/{owner}/token-inventory`:
+ * Horizon balances (native XLM and classic assets, keyed by their SAC id) plus
+ * indexed Soroban tokens, cached for about 10 seconds. Each token's
+ * `identifier` is its contract id and `balance` is base units as a decimal
+ * string. Tokens without a balance or trustline are absent.
+ * @category Stellar lending reads
+ */
+export declare const getStellarWalletTokens: (client: XOXNOClient, owner: string, init?: OurRequestInit) => Promise<UserTokenInventoryResponseDto>;
+/** Read exact token base-unit holdings of one asset for a G or C wallet, from
+ * {@link getStellarWalletTokens}. An asset the wallet does not hold returns
+ * `amount: '0'`, with decimals read from the lending asset. Holdings may exceed
+ * spendable funds (reserves, liabilities).
  * @category Stellar lending reads
  */
 export declare const getStellarWalletBalance: (client: XOXNOClient, owner: string, asset: string, init?: OurRequestInit) => Promise<Api.StellarWalletBalanceDto>;
@@ -218,6 +230,8 @@ export declare const stellarLendingRead: (client: XOXNOClient) => {
     userPositions: (owner: string, init?: OurRequestInit) => Promise<Api.AccountPositionsDto>;
     /** {@inheritDoc getStellarAccountPositions} */
     accountPositions: (accountId: string, init?: OurRequestInit) => Promise<Api.AccountPositionsDto>;
+    /** {@inheritDoc getStellarWalletTokens} */
+    walletTokens: (owner: string, init?: OurRequestInit) => Promise<UserTokenInventoryResponseDto>;
     /** {@inheritDoc getStellarWalletBalance} */
     walletBalance: (owner: string, asset: string, init?: OurRequestInit) => Promise<Api.StellarWalletBalanceDto>;
     /** {@inheritDoc getStellarAssetPage} */

package/dist/sdk/stellar/lending.d.ts

@@ -299,6 +299,40 @@ export declare function buildStellarLiquidateTx(opts: StellarLendingBuilderOptio
  * `decodeStellarLendingEvent`. Hold a parsed ScVal? Pass `toBase64Xdr(scv)`.
  */
 export declare function decodeStellarLiquidateReturn(returnValueB64: string): string;
+/**
+ * get_liquidation_estimate(account_id: u64, debt_payments: Vec<(HubAssetKey, i128)>,
+ *                          seize_mode: SeizeMode) -> LiquidationEstimate
+ *
+ * Read-only view: simulate the built transaction (`server.simulateTransaction`)
+ * and decode `result.retval` with `decodeStellarLiquidationEstimate`. Takes the
+ * same args as `buildStellarLiquidateTx`, so an estimate and the real call stay
+ * encoded identically. Never submit this transaction.
+ * @param opts - Network, caller (any account; it is only the simulation source), sequence and controller.
+ * @param args - The liquidation you intend to send.
+ * @returns Unsigned XDR to simulate.
+ * @category Lending transactions
+ */
+export declare function buildStellarLiquidationEstimateTx(opts: StellarLendingBuilderOptions, args: StellarLiquidateArgs): BuiltStellarTx;
+/** One `PaymentTuple`: a token amount without a hub id. */
+export interface StellarPaymentTuple {
+    asset: string;
+    /** Token base units for Transfer legs; RAY-scaled supply shares for Credit seizure. */
+    amount: string;
+}
+/** Decoded `LiquidationEstimate`; i128 fields as decimal strings. */
+export interface StellarLiquidationEstimate {
+    seizedCollaterals: StellarPaymentTuple[];
+    protocolFees: StellarPaymentTuple[];
+    refunds: StellarPaymentTuple[];
+    maxPaymentWad: string;
+    bonusRateBps: string;
+}
+/**
+ * Decode `get_liquidation_estimate`'s return value from base64 XDR (Soroban
+ * RPC `result.retval`). Tuples carry token addresses without hub ids; match
+ * them to the target's `(hub_id, asset)` positions yourself.
+ */
+export declare function decodeStellarLiquidationEstimate(returnValueB64: string): StellarLiquidationEstimate;
 /**
  * flash_loan(caller, asset: HubAssetKey, amount: i128, receiver, data: Bytes)
  * @param opts - Network, caller, current source sequence and deployment addresses.

package/dist/utils/soroban-errors.d.ts

@@ -1,10 +1,27 @@
+export interface MapSorobanErrorOptions {
+    /**
+     * Accept only an error emitted by one of these contract IDs (`C…`), for
+     * example the lending controller and pool. The emitter is read from the
+     * diagnostic event log, or from the `[xoxno-invoked:<id>]` tag that
+     * `prepareStellarTxXdr` adds when the string has no event log.
+     *
+     * RPC simulation errors usually carry only the top-level code
+     * (`HostError: Error(Contract, #N)`). With only the tag, a code raised by a
+     * nested contract (for example the swap aggregator) cannot be told apart;
+     * read the simulation's diagnostic events when that matters.
+     */
+    contracts?: readonly string[];
+}
 /**
  * Extracts a `Error(Contract, #N)` code from a raw Soroban simulation/RPC error
  * string and resolves it against the rs-lending-xlm catalog. Matches only the
  * exact `Error(Contract, #N)` pattern — never loose digits, since raw error
  * strings can contain unrelated numbers (fees, ledgers, sequence numbers).
+ *
+ * Without `opts.contracts` it maps the first code in the string, whichever
+ * contract emitted it.
  */
-export declare function mapSorobanError(raw: string): {
+export declare function mapSorobanError(raw: string, opts?: MapSorobanErrorOptions): {
     code: number;
     name: string;
     message: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xoxno/sdk-js",
-  "version": "1.0.229",
+  "version": "1.0.231",
   "description": "The SDK to interact with the XOXNO Protocol!",
   "type": "module",
   "exports": {
@@ -140,7 +140,7 @@
   "dependencies": {
     "@multiversx/sdk-core": "^15.3.2",
     "@multiversx/sdk-network-providers": "^2.9.3",
-    "@xoxno/types": "1.0.500",
+    "@xoxno/types": "1.0.501",
     "buffer": "^6.0.3"
   },
   "peerDependencies": {