@xoxno/sdk-js 1.0.228 → 1.0.230

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

@@ -62,7 +62,7 @@ export declare const STELLAR_NETWORKS: {
         readonly lendingPool: "CBSGF6QOQAMPFBEVSYPEQHSZRIHJ6RCGUPCRDMUX36DEKRWFAO2PZB5A";
         readonly aggregatorRouter: "CDNTWMWW2WGYTKIZTJYNGNVQQZI4KTC5BQRZ3275KESRX5T4O3AYECL5";
         readonly governance: "CDS33JDOYH3F3FL4QUQ6DV4WKHML2AKHF4LADTZ57FRUAEBTE7NMY5FQ";
-        readonly priceAggregator: "CAALOOTIDXCX7D7FMQIBSSAJLPKOM3GMXS4UUSTDIG42JCRRJHOPUHOP";
+        readonly priceAggregator: "CBMARXSYE56NPDLX42TTICM5GS5XQCYRD5VMCJME624TS6C2S53VETYU";
         readonly positionNftContract: "CDVN5JU675MEDPVRPCYC45AHFC275UH57WEU5OTFE4WFGZBNN7HTLPSY";
     };
 };
@@ -97,7 +97,7 @@ export declare const stellarNetworks: {
         readonly lendingPool: "CBSGF6QOQAMPFBEVSYPEQHSZRIHJ6RCGUPCRDMUX36DEKRWFAO2PZB5A";
         readonly aggregatorRouter: "CDNTWMWW2WGYTKIZTJYNGNVQQZI4KTC5BQRZ3275KESRX5T4O3AYECL5";
         readonly governance: "CDS33JDOYH3F3FL4QUQ6DV4WKHML2AKHF4LADTZ57FRUAEBTE7NMY5FQ";
-        readonly priceAggregator: "CAALOOTIDXCX7D7FMQIBSSAJLPKOM3GMXS4UUSTDIG42JCRRJHOPUHOP";
+        readonly priceAggregator: "CBMARXSYE56NPDLX42TTICM5GS5XQCYRD5VMCJME624TS6C2S53VETYU";
         readonly positionNftContract: "CDVN5JU675MEDPVRPCYC45AHFC275UH57WEU5OTFE4WFGZBNN7HTLPSY";
     };
 };

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

@@ -25,3 +25,4 @@ export * from './cctp.js';
 export * from './math/index.js';
 export type { StellarStrategySwapInput, StellarStrategySwapPathInput, StellarStrategySwapHopInput, } from './scval-encode.js';
 export { mapSorobanError } from '../../utils/soroban-errors.js';
+export type { MapSorobanErrorOptions } from '../../utils/soroban-errors.js';

package/dist/cjs/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/cjs/sdk/stellar/scval-encode.d.ts

@@ -10,7 +10,7 @@ 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 opcode table.
  */
-export declare const STELLAR_SWAP_VENUES: readonly ["Soroswap", "Aquarius", "Phoenix", "Sushi", "CometDex"];
+export declare const STELLAR_SWAP_VENUES: readonly ["Soroswap", "Aquarius", "Phoenix", "Sushi", "CometDex", "Curve"];
 export type StellarSwapVenue = (typeof STELLAR_SWAP_VENUES)[number];
 /**
  * Instruction opcode per venue. Part of the on-chain ABI — see

package/dist/cjs/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/dist/esm/sdk/stellar/contracts.js

@@ -32,7 +32,7 @@
         lendingPool: 'CBSGF6QOQAMPFBEVSYPEQHSZRIHJ6RCGUPCRDMUX36DEKRWFAO2PZB5A',
         aggregatorRouter: 'CDNTWMWW2WGYTKIZTJYNGNVQQZI4KTC5BQRZ3275KESRX5T4O3AYECL5',
         governance: 'CDS33JDOYH3F3FL4QUQ6DV4WKHML2AKHF4LADTZ57FRUAEBTE7NMY5FQ',
-        priceAggregator: 'CAALOOTIDXCX7D7FMQIBSSAJLPKOM3GMXS4UUSTDIG42JCRRJHOPUHOP',
+        priceAggregator: 'CBMARXSYE56NPDLX42TTICM5GS5XQCYRD5VMCJME624TS6C2S53VETYU',
         positionNftContract: 'CDVN5JU675MEDPVRPCYC45AHFC275UH57WEU5OTFE4WFGZBNN7HTLPSY'
     }
 };

package/dist/esm/sdk/stellar/events/decode.js

@@ -70,7 +70,8 @@ const POSITION_MODE = [
     'close_wd',
     'migrate',
     'rp_col_net',
-    'liq_credit'
+    'liq_credit',
+    'flash_pos'
 ];
 const positionMode = (v)=>POSITION_MODE[num(v)] ?? 'None';
 // Unknown discriminants surface as their decimal string instead of throwing.
@@ -195,9 +196,12 @@ const REGISTRY = {
                 marketAddress: str(d.market_address)
             }
         }),
+    // `hub_id` is required to tell same-token markets apart; the upstream DTO
+    // does not declare it yet, hence the cast.
     'market:params_update': (d)=>({
             topic: 'market:params_update',
             data: {
+                hubId: num(d.hub_id),
                 asset: str(d.asset),
                 maxBorrowRateRay: dec(d.max_borrow_rate),
                 baseBorrowRateRay: dec(d.base_borrow_rate),
@@ -303,12 +307,13 @@ const REGISTRY = {
                 totalCollateralUsdWad: dec(d.total_collateral_usd_wad)
             }
         }),
+    // The event carries `{ token, amount, account_id }` only. The upstream DTO
+    // still declares `usdValueWad`; it is left absent rather than fabricated.
     'strategy:initial_payment': (d)=>({
             topic: 'strategy:initial_payment',
             data: {
                 token: str(d.token),
                 amount: dec(d.amount),
-                usdValueWad: dec(d.usd_value_wad),
                 accountId: dec(d.account_id)
             }
         }),

package/dist/esm/sdk/stellar/lending.js

@@ -248,6 +248,51 @@ function encodeSpokeId(value) {
     }
     throw new Error(`Stellar builder: liquidate return value must be a u64, got ${typeof native}`);
 }
+/**
+ * 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 function buildStellarLiquidationEstimateTx(opts, args) {
+    return buildTx(opts, 'get_liquidation_estimate', [
+        u64(args.accountNonce),
+        tupleHubAssetAmountVec([
+            ...args.debtPayments
+        ]),
+        seizeMode(args.seizeMode ?? 'Transfer')
+    ]);
+}
+const paymentTuples = (v)=>(Array.isArray(v) ? v : []).map((p)=>{
+        const row = p;
+        return {
+            asset: String(row.asset),
+            amount: String(row.amount)
+        };
+    });
+/**
+ * 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 function decodeStellarLiquidationEstimate(returnValueB64) {
+    const native = scValToNative(xdr.ScVal.fromXDR(returnValueB64, 'base64'));
+    if (!native || typeof native !== 'object' || Array.isArray(native)) {
+        throw new Error('Stellar builder: liquidation estimate must be a struct');
+    }
+    return {
+        seizedCollaterals: paymentTuples(native.seized_collaterals),
+        protocolFees: paymentTuples(native.protocol_fees),
+        refunds: paymentTuples(native.refunds),
+        maxPaymentWad: String(native.max_payment_wad),
+        bonusRateBps: String(native.bonus_rate_bps)
+    };
+}
 /**
  * flash_loan(caller, asset: HubAssetKey, amount: i128, receiver, data: Bytes)
  * @param opts - Network, caller, current source sequence and deployment addresses.

package/dist/esm/sdk/stellar/route-verify.js

@@ -24,7 +24,7 @@ function _define_property(obj, key, value) {
  */ import { Address, Asset, scValToBigInt, StrKey, xdr } from "@stellar/stellar-sdk";
 import { STELLAR_NETWORK_PASSPHRASE } from "./contracts.js";
 import { xdrBytes, xdrField, xdrType } from "./xdr-compat.js";
-import { asStellarStrategySwapBytes, MAX_AMOUNTS, MAX_ASSETS, MAX_OPS, MAX_WEIGHTS, MODE_ALL, MODE_FIXED_BASE, MODE_PPM_BASE, MODE_PREV, OP_BURN, OP_MINT, PPM_DENOMINATOR, STELLAR_PROGRAM_VERSION, STELLAR_SWAP_VENUES } from "./scval-encode.js";
+import { asStellarStrategySwapBytes, MAX_AMOUNTS, MAX_ASSETS, MAX_OPS, MAX_WEIGHTS, MODE_ALL, MODE_FIXED_BASE, MODE_PPM_BASE, MODE_PREV, OP_BURN, OP_MINT, PPM_DENOMINATOR, STELLAR_PROGRAM_VERSION, STELLAR_SWAP_VENUES, STELLAR_SWAP_VENUE_OPCODE } from "./scval-encode.js";
 const HEADER_LEN = 10;
 const OP_LEN = 5;
 const WEIGHT_LEN = 3;
@@ -164,7 +164,10 @@ const readPayloadFields = (buf)=>{
         const idxA = byte(at + 2);
         const idxB = byte(at + 3);
         const idxC = byte(at + 4);
-        if (opcode > OP_MINT) fail('UNKNOWN_OPCODE', `instruction ${i} has opcode ${opcode}`);
+        const venue = STELLAR_SWAP_VENUES.find((value)=>STELLAR_SWAP_VENUE_OPCODE[value] === opcode);
+        if (!venue && opcode !== OP_BURN && opcode !== OP_MINT) {
+            fail('UNKNOWN_OPCODE', `instruction ${i} has opcode ${opcode}`);
+        }
         let mode;
         if (modeByte === MODE_ALL) {
             mode = {
@@ -208,7 +211,7 @@ const readPayloadFields = (buf)=>{
         if (idxB === idxC) fail('INVALID_STRUCTURE', `instruction ${i} swaps a token for itself`);
         decoded.push({
             kind: 'swap',
-            venue: STELLAR_SWAP_VENUES[opcode],
+            venue: venue,
             mode,
             pool,
             tokenIn: asset(idxB),

package/dist/esm/sdk/stellar/scval-encode.js

@@ -27,7 +27,8 @@ import { Buffer } from "buffer";
     'Aquarius',
     'Phoenix',
     'Sushi',
-    'CometDex'
+    'CometDex',
+    'Curve'
 ];
 /**
  * Instruction opcode per venue. Part of the on-chain ABI — see
@@ -37,7 +38,8 @@ import { Buffer } from "buffer";
     Aquarius: 1,
     Phoenix: 2,
     Sushi: 3,
-    CometDex: 4
+    CometDex: 4,
+    Curve: 7
 };
 /** Wire version of the packed program. Must match the contract's `VERSION`. */ export const STELLAR_PROGRAM_VERSION = 1;
 /** Split weights are parts per million. */ export const PPM_DENOMINATOR = 1000000;