@xoxno/sdk-js 1.0.229 → 1.0.230

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.230",
   "description": "The SDK to interact with the XOXNO Protocol!",
   "type": "module",
   "exports": {