@lombard.finance/sdk 3.7.4 → 4.1.0

package/dist/chains/sui/actions/unstake/config/btc.d.ts

@@ -0,0 +1,18 @@
+/**
+ * BTC Destination Configuration for Sui Unstake
+ *
+ * Handles unstaking LBTC from Sui to BTC on Bitcoin.
+ *
+ * @module chains/sui/actions/unstake/config/btc
+ */
+import { Chain, Env } from '../../../../../core';
+import type { ChainConfig } from './types';
+/**
+ * Sui → BTC configuration
+ */
+export declare const suiToBtcConfig: ChainConfig;
+/**
+ * Check if unstake to BTC is supported from this Sui chain
+ */
+export declare function isBtcUnstakeSupported(sourceChain: Chain, env: Env): boolean;
+//# sourceMappingURL=btc.d.ts.map

package/dist/chains/sui/actions/unstake/config/btc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"btc.d.ts","sourceRoot":"","sources":["../../../../../../src/chains/sui/actions/unstake/config/btc.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,WAiB5B,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAK3E"}

package/dist/chains/sui/actions/unstake/config/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Sui Unstake Chain Configuration Registry
+ *
+ * @module chains/sui/actions/unstake/config
+ */
+export { isBtcUnstakeSupported, suiToBtcConfig } from './btc';
+export type { ChainConfig, RouteDefinition } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/chains/sui/actions/unstake/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/chains/sui/actions/unstake/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAC,cAAc,EAAE,MAAM,OAAO,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/dist/chains/sui/actions/unstake/config/sui.d.ts

@@ -0,0 +1,18 @@
+/**
+ * BTC Destination Configuration for Sui Unstake
+ *
+ * Handles unstaking LBTC from Sui to BTC on Bitcoin.
+ *
+ * @module chains/sui/actions/unstake/config/btc
+ */
+import { Chain, Env } from '../../../../../core';
+import type { ChainConfig } from './types';
+/**
+ * Sui → BTC configuration
+ */
+export declare const suiToBtcConfig: ChainConfig;
+/**
+ * Check if unstake to BTC is supported from this Sui chain
+ */
+export declare function isBtcUnstakeSupported(sourceChain: Chain, env: Env): boolean;
+//# sourceMappingURL=sui.d.ts.map

package/dist/chains/sui/actions/unstake/config/sui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui.d.ts","sourceRoot":"","sources":["../../../../../../src/chains/sui/actions/unstake/config/sui.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,WAiB5B,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAK3E"}

package/dist/chains/sui/actions/unstake/config/types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Sui Unstake Chain Configuration Types
+ *
+ * @module chains/sui/actions/unstake/config/types
+ */
+import type { z } from 'zod';
+import type { Chain, ChainType, Env } from '../../../../../core';
+/**
+ * Route definition for Sui unstake operations
+ */
+export interface RouteDefinition {
+    sourceChains: Chain[];
+    destChain: Chain;
+    envs: Env[];
+}
+/**
+ * Chain-specific configuration for Sui unstake operations
+ */
+export interface ChainConfig {
+    chainType: ChainType;
+    routes: RouteDefinition[];
+    recipientSchema: z.ZodType<string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/chains/sui/actions/unstake/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/chains/sui/actions/unstake/config/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,KAAK,EAAE,CAAC;IACtB,SAAS,EAAE,KAAK,CAAC;IACjB,IAAI,EAAE,GAAG,EAAE,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;CACpC"}

package/dist/chains/sui/actions/unstake/factory.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Sui Unstake Factory Functions
+ *
+ * @module chains/sui/actions/unstake/factory
+ */
+import type { LombardConfig } from '../../../../config/types';
+import type { SuiCoreContext } from '../../../../shared/context';
+import type { ISuiUnstake, SuiUnstakeParams } from './types';
+/**
+ * Create Sui unstake from context
+ */
+export declare function createSuiUnstake(ctx: SuiCoreContext, params: SuiUnstakeParams): ISuiUnstake;
+/**
+ * Create Sui unstake from config
+ */
+export declare function suiUnstake(_config: LombardConfig, _params: SuiUnstakeParams): ISuiUnstake;
+//# sourceMappingURL=factory.d.ts.map

package/dist/chains/sui/actions/unstake/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../src/chains/sui/actions/unstake/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAC,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE5D;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,gBAAgB,GACvB,WAAW,CAEb;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,gBAAgB,GACxB,WAAW,CAIb"}

package/dist/chains/sui/actions/unstake/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Sui Unstake Action
+ *
+ * @module chains/sui/actions/unstake
+ */
+export { createSuiUnstake, suiUnstake } from './factory';
+export { SuiUnstake } from './SuiUnstake';
+export type { ISuiUnstake, SuiUnstakeParams, SuiUnstakePrepareParams, SuiUnstakeProgress, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/chains/sui/actions/unstake/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/chains/sui/actions/unstake/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/chains/sui/actions/unstake/types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Sui Unstake Action Types
+ *
+ * @module chains/sui/actions/unstake/types
+ */
+import type { AssetId, Chain, StepStatus, StrategyProgress } from '../../../../core';
+import type { MonitorableAction } from '../../../../shared/actions/BaseAction';
+import type { NonEvmUnstakeStatus } from '../../../../shared/constants/statusConstants';
+/**
+ * Sui Unstake parameters
+ */
+export interface SuiUnstakeParams {
+    assetIn: AssetId;
+    assetOut: AssetId;
+    sourceChain: Chain;
+    destChain: Chain;
+}
+/**
+ * Sui Unstake progress
+ */
+export interface SuiUnstakeProgress extends StrategyProgress<NonEvmUnstakeStatus> {
+    status: NonEvmUnstakeStatus;
+    steps: {
+        burning: StepStatus;
+        releasing: StepStatus;
+    };
+    txHash?: string;
+}
+/**
+ * Sui Unstake prepare params
+ */
+export interface SuiUnstakePrepareParams {
+    amount: string;
+    recipient: string;
+}
+/**
+ * Sui Unstake interface
+ */
+export interface ISuiUnstake extends MonitorableAction {
+    readonly status: NonEvmUnstakeStatus;
+    readonly amount?: string;
+    readonly recipient?: string;
+    prepare(params: SuiUnstakePrepareParams): Promise<void>;
+    execute(): Promise<{
+        txHash: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/chains/sui/actions/unstake/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/chains/sui/actions/unstake/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,KAAK,EACL,UAAU,EACV,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,KAAK,CAAC;IACnB,SAAS,EAAE,KAAK,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBACf,SAAQ,gBAAgB,CAAC,mBAAmB,CAAC;IAC7C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE;QACL,OAAO,EAAE,UAAU,CAAC;QACpB,SAAS,EAAE,UAAU,CAAC;KACvB,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,iBAAiB;IACpD,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,OAAO,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxC"}

package/dist/chains/sui/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Sui Namespace
+ *
+ * @module chains/sui
+ */
+export * from './actions';
+export { SuiActions, suiActions } from './SuiActions';
+//# sourceMappingURL=index.d.ts.map

package/dist/chains/sui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/chains/sui/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/client/ApiNamespace.d.ts

@@ -0,0 +1,207 @@
+/**
+ * API Namespace
+ *
+ * Provides convenient access to Lombard API data-fetching operations,
+ * with environment pre-configured from SDK initialization.
+ *
+ * All API-related read operations are namespaced under `sdk.api.*`
+ *
+ * @example
+ * ```ts
+ * const sdk = new LombardSDK({ env: Env.prod, providers: {...} });
+ *
+ * // Fetch deposits for an address
+ * const deposits = await sdk.api.deposits('0x...');
+ *
+ * // Fetch unstakes with options
+ * const unstakes = await sdk.api.unstakes('0x...', { show_redeems: true });
+ *
+ * // Fetch points (defaults to current season)
+ * const points = await sdk.api.points('0x...');
+ *
+ * // Fetch LBTC exchange rate
+   * const rate = await sdk.api.exchangeRatio();
+ *
+ * // Get existing BTC deposit address
+ * const depositAddr = await sdk.api.depositAddress('0x...', ChainId.ethereum);
+ * ```
+ *
+ * @module client/ApiNamespace
+ */
+import { Env } from '@lombard.finance/sdk-common';
+import type BigNumber from 'bignumber.js';
+import { type Deposit } from '../api-functions/getDepositsByAddress/getDepositsByAddress';
+import { type IPointsByAddressSeason1, type IPointsByAddressSeason2 } from '../api-functions/getPointsByAddress/getPointsByAddress';
+import { type Unstake } from '../api-functions/getUnstakesByAddress/getUnstakesByAddress';
+import type { ChainId, SolanaChain, StarknetChainId, SuiChain } from '../common/chains';
+import type { Token } from '../tokens/token-addresses';
+/** Supported API versions (for future v2 migration) */
+export type ApiVersion = 'v1' | 'v2';
+/** Options for fetching unstakes */
+export interface UnstakeOptions {
+    /** Include redeem operations */
+    show_redeems?: boolean;
+    /** Include unstake operations */
+    show_unstakes?: boolean;
+    /** Filter for native chain redemptions */
+    to_native?: boolean;
+}
+/** Options for fetching exchange rate */
+export interface ExchangeRateOptions {
+    /** Chain ID (exchange rate is same for all chains, defaults to Ethereum) */
+    chainId?: ChainId;
+    /** Amount in satoshis to calculate exchange for */
+    amount?: BigNumber.Value;
+}
+/** Options for fetching deposit address */
+export interface DepositAddressOptions {
+    /** Partner ID for the deposit address */
+    partnerId?: string;
+    /** Token type (LBTC, BTCK, BTCb) */
+    token?: Token;
+}
+/** Destination chain types for deposit address */
+export type DestinationChain = ChainId | SuiChain | SolanaChain | StarknetChainId;
+/**
+ * API Namespace Class
+ *
+ * Provides convenient wrappers around Lombard API functions with
+ * environment pre-bound from SDK configuration.
+ *
+ * Designed for easy migration to API v2 when available (January 2025).
+ */
+export declare class ApiNamespace {
+    private readonly env;
+    /**
+     * Internal API version flag for future v2 migration.
+     * When v2 is ready, we can switch implementations transparently.
+     */
+    private readonly apiVersion;
+    constructor(env?: Env);
+    /**
+     * Fetch all deposits for an address.
+     *
+     * Returns deposits from both Direct BTC Deposits and Native Deposits APIs,
+     * unified into a single list sorted by block time (newest first).
+     *
+     * @param address - The EVM/BTC address to fetch deposits for
+     * @returns Promise resolving to array of Deposit objects
+     *
+     * @example
+     * ```ts
+     * const deposits = await sdk.api.deposits('0x1234...');
+     * deposits.forEach(d => {
+     *   console.log(`${d.amount} BTC deposited at block ${d.blockHeight}`);
+     * });
+     * ```
+     */
+    deposits(address: string): Promise<Deposit[]>;
+    /**
+     * Fetch all unstakes/redemptions for an address.
+     *
+     * Returns unstake records for both direct BTC unstakes and
+     * native blockchain redemptions.
+     *
+     * @param address - The address that initiated the unstakes
+     * @param options - Optional filters (show_redeems, show_unstakes, to_native)
+     * @returns Promise resolving to array of Unstake objects
+     *
+     * @example
+     * ```ts
+     * // Get all unstakes
+     * const unstakes = await sdk.api.unstakes('0x1234...');
+     *
+     * // Get only native chain redemptions
+     * const redeems = await sdk.api.unstakes('0x1234...', { to_native: true });
+     * ```
+     */
+    unstakes(address: string, options?: UnstakeOptions): Promise<Unstake[]>;
+    /**
+     * Fetch Lux points for an address (Season 1).
+     *
+     * @param address - The wallet address
+     * @param season - Season number (1)
+     * @returns Promise resolving to Season 1 points breakdown
+     */
+    points(address: string, season: 1): Promise<IPointsByAddressSeason1>;
+    /**
+     * Fetch Lux points for an address (Season 2).
+     *
+     * @param address - The wallet address
+     * @param season - Season number (2)
+     * @returns Promise resolving to Season 2 points breakdown
+     */
+    points(address: string, season: 2): Promise<IPointsByAddressSeason2>;
+    /**
+     * Fetch Lux points for an address (defaults to current season).
+     *
+     * @param address - The wallet address
+     * @param season - Optional season number (defaults to current)
+     * @returns Promise resolving to points breakdown
+     *
+     * @example
+     * ```ts
+     * // Get current season points
+     * const points = await sdk.api.points('0x1234...');
+     * console.log(`Total: ${points.totalPoints}, Holding: ${points.holdingPoints}`);
+     *
+     * // Get Season 1 points
+     * const s1 = await sdk.api.points('0x1234...', 1);
+     * ```
+     */
+    points(address: string, season?: number): Promise<IPointsByAddressSeason1 | IPointsByAddressSeason2>;
+    /**
+     * Fetch the current exchange ratios for all supported tokens.
+     *
+     * Returns Token:BTC and BTC:Token ratios for LBTC and other supported tokens.
+     * This is the recommended method for getting exchange rate information.
+     *
+     * @returns Promise resolving to exchange ratio info for each token
+     *
+     * @example
+     * ```ts
+     * const ratios = await sdk.api.exchangeRatio();
+     *
+     * // Access LBTC ratios
+     * const lbtcRatio = ratios.LBTC;
+     * console.log(`LBTC:BTC = ${lbtcRatio.tokenBTCRatio}`);  // How many LBTC per 1 BTC
+     * console.log(`BTC:LBTC = ${lbtcRatio.BTCTokenRatio}`);  // How many BTC per 1 LBTC
+     * ```
+     */
+    exchangeRatio(): Promise<{
+        LBTC: {
+            tokenBTCRatio: BigNumber;
+            BTCTokenRatio: BigNumber;
+        };
+    }>;
+    /**
+     * Get an existing BTC deposit address for a recipient.
+     *
+     * Returns the most recent non-deprecated deposit address for the
+     * given recipient address and destination chain.
+     *
+     * @param address - The destination address where LBTC will be claimed
+     * @param chainId - The destination chain
+     * @param options - Optional partner ID and token type
+     * @returns Promise resolving to the BTC deposit address
+     * @throws Error if no deposit address found
+     *
+     * @example
+     * ```ts
+     * try {
+     *   const btcAddr = await sdk.api.depositAddress('0x1234...', ChainId.ethereum);
+     *   console.log(`Send BTC to: ${btcAddr}`);
+     * } catch (e) {
+     *   console.log('No deposit address found - need to generate one');
+     * }
+     * ```
+     */
+    depositAddress(address: string, chainId: DestinationChain, options?: DepositAddressOptions): Promise<string>;
+    /**
+     * Get the current API version being used.
+     *
+     * @returns The API version string ('v1' or 'v2')
+     */
+    getApiVersion(): ApiVersion;
+}
+//# sourceMappingURL=ApiNamespace.d.ts.map

package/dist/client/ApiNamespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiNamespace.d.ts","sourceRoot":"","sources":["../../src/client/ApiNamespace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAe,GAAG,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,SAAS,MAAM,cAAc,CAAC;AAG1C,OAAO,EACL,KAAK,OAAO,EAEb,MAAM,4DAA4D,CAAC;AAEpE,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC7B,MAAM,wDAAwD,CAAC;AAChE,OAAO,EAEL,KAAK,OAAO,EACb,MAAM,4DAA4D,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACxF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAMvD,uDAAuD;AACvD,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC;AAErC,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iCAAiC;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,yCAAyC;AACzC,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,MAAM,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC;CAC1B;AAED,2CAA2C;AAC3C,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,kDAAkD;AAClD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,eAAe,CAAC;AAMlF;;;;;;;GAOG;AACH,qBAAa,YAAY;IAOX,OAAO,CAAC,QAAQ,CAAC,GAAG;IANhC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;gBAElB,GAAG,GAAE,GAAiB;IAMnD;;;;;;;;;;;;;;;;OAgBG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IASnD;;;;;;;;;;;;;;;;;;OAkBG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAS7E;;;;;;OAMG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CAAC,GACR,OAAO,CAAC,uBAAuB,CAAC;IAEnC;;;;;;OAMG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CAAC,GACR,OAAO,CAAC,uBAAuB,CAAC;IAEnC;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,uBAAuB,GAAG,uBAAuB,CAAC;IAc7D;;;;;;;;;;;;;;;;;OAiBG;IACG,aAAa;;;;;;IAQnB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,MAAM,CAAC;IAelB;;;;OAIG;IACH,aAAa,IAAI,UAAU;CAG5B"}

package/dist/client/AssetNamespace.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Asset Namespace
+ *
+ * Provides type-safe access to the asset catalog bound to an environment.
+ * All asset-related operations are namespaced under `sdk.assets.*`
+ *
+ * @example
+ * ```ts
+ * const sdk = createLombardSDK({ env: Env.prod });
+ *
+ * const address = sdk.assets.getAddress(AssetId.LBTC, Chain.ETHEREUM);
+ * const decimals = sdk.assets.getDecimals(AssetId.LBTC);
+ * const chains = sdk.assets.getChains(AssetId.LBTC);
+ * ```
+ */
+import { Env } from '@lombard.finance/sdk-common';
+import { type AssetCatalog, type AssetId, type Chain } from '../core';
+export declare class AssetNamespace {
+    private readonly env;
+    private readonly catalog;
+    constructor(env?: Env, catalog?: AssetCatalog);
+    /** Get token contract address */
+    getAddress(asset: AssetId, chain: Chain): string | undefined;
+    /** Get token decimals */
+    getDecimals(asset: AssetId): number;
+    /** Get asset metadata (decimals, symbol, name) */
+    getMetadata(asset: AssetId): {
+        decimals: number;
+        symbol: string;
+        name?: string;
+    } | undefined;
+    /** Check if asset uses an asset router contract */
+    usesAssetRouter(asset: AssetId, chain: Chain): boolean;
+    /** Get asset router contract address */
+    getAssetRouter(asset: AssetId, chain: Chain): string | undefined;
+    /** Get bridge adapter address */
+    getBridgeAdapter(asset: AssetId, chain: Chain): string | undefined;
+    /** Get public market maker address */
+    getPublicMarketMaker(asset: AssetId, chain: Chain): string | undefined;
+    /** Find asset by contract address (reverse lookup) */
+    getByAddress(address: string, chain: Chain): AssetId | undefined;
+    /** Check if asset is deployed on a chain */
+    isDeployed(asset: AssetId, chain: Chain): boolean;
+    /** Get all chains where asset is deployed */
+    getChains(asset: AssetId): Chain[];
+    /** Get all environments where asset is deployed on a chain */
+    getEnvironments(asset: AssetId, chain: Chain): Env[];
+    /** Get all supported assets */
+    getSupportedAssets(): AssetId[];
+    /** Direct access to the asset catalog */
+    getCatalog(): AssetCatalog;
+}
+//# sourceMappingURL=AssetNamespace.d.ts.map

package/dist/client/AssetNamespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetNamespace.d.ts","sourceRoot":"","sources":["../../src/client/AssetNamespace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAe,GAAG,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,KAAK,EAaX,MAAM,SAAS,CAAC;AAEjB,qBAAa,cAAc;IAIvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;gBAGpB,GAAG,GAAE,GAAiB,EACvC,OAAO,CAAC,EAAE,YAAY;IAKxB,iCAAiC;IACjC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS;IAI5D,yBAAyB;IACzB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAInC,kDAAkD;IAClD,WAAW,CAAC,KAAK,EAAE,OAAO;;;;;IAI1B,mDAAmD;IACnD,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO;IAItD,wCAAwC;IACxC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS;IAIhE,iCAAiC;IACjC,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS;IAIlE,sCAAsC;IACtC,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS;IAItE,sDAAsD;IACtD,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,GAAG,SAAS;IAIhE,4CAA4C;IAC5C,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO;IAIjD,6CAA6C;IAC7C,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,EAAE;IAIlC,8DAA8D;IAC9D,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,GAAG,EAAE;IAIpD,+BAA+B;IAC/B,kBAAkB,IAAI,OAAO,EAAE;IAI/B,yCAAyC;IACzC,UAAU,IAAI,YAAY;CAG3B"}

package/dist/client/LombardSDK.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Main Lombard SDK Class
+ *
+ * Entry point for all Lombard operations.
+ *
+ * @module client/LombardSDK
+ */
+import type { Env } from '@lombard.finance/sdk-common';
+import { BtcActions } from '../chains/btc/BtcActions';
+import { EvmActions } from '../chains/evm/EvmActions';
+import { SolanaActions } from '../chains/solana/SolanaActions';
+import { StarknetActions } from '../chains/starknet/StarknetActions';
+import { SuiActions } from '../chains/sui/SuiActions';
+import type { AnyProvider, BtcProvider, EvmProvider, SolanaProvider, StarknetProvider, SuiProvider } from '../config/providers';
+import type { ProviderGetters, ResolvedLombardConfig } from '../config/types';
+import { CapabilityRegistry } from '../modules/CapabilityRegistry';
+import { ReferralsClient } from '../referrals/ReferralsClient';
+import { ApiNamespace } from './ApiNamespace';
+import { AssetNamespace } from './AssetNamespace';
+import { PartnerConfiguration } from './PartnerConfiguration';
+type ProviderType = keyof ProviderGetters;
+/**
+ * Main Lombard SDK
+ *
+ * Provides access to all chain actions and features.
+ *
+ * **Important**: Use `createLombardSDK()` to create instances.
+ * Direct instantiation is not recommended.
+ *
+ * @example
+ * ```typescript
+ * // Recommended: Use the async factory
+ * const sdk = await createLombardSDK({
+ *   env: Env.prod,
+ *   providers: {
+ *     evm: (chain) => window.ethereum,
+ *   },
+ * });
+ *
+ * // Access chain actions
+ * const btcStake = sdk.chain.btc.stake({
+ *   assetOut: AssetId.LBTC,
+ *   destChain: Chain.ETHEREUM,
+ * });
+ * ```
+ */
+export declare class LombardSDK<E extends Env = Env> {
+    readonly config: ResolvedLombardConfig;
+    readonly env: Env;
+    /** Partner configuration manager */
+    private partnerConfig;
+    /** Provider cache */
+    private providerCache;
+    /**
+     * Chain actions (user-facing API)
+     *
+     * Access operations for each supported chain:
+     * - btc: Bitcoin operations (stake, stakeAndDeploy, deposit)
+     * - evm: EVM operations (deposit, stake, unstake, deploy, redeem)
+     * - solana: Solana operations (unstake)
+     * - sui: Sui operations (unstake)
+     * - starknet: Starknet operations (unstake)
+     */
+    readonly chain: {
+        btc: BtcActions;
+        evm: EvmActions;
+        solana: SolanaActions;
+        sui: SuiActions;
+        starknet: StarknetActions;
+    };
+    readonly assets: AssetNamespace;
+    /**
+     * API namespace for data-fetching operations
+     *
+     * Provides convenient access to Lombard API read operations:
+     * - deposits: Fetch deposit history
+     * - unstakes: Fetch unstake/redemption history
+     * - points: Fetch Lux points
+     * - exchangeRatio: Get exchange ratios for all supported tokens
+     * - depositAddress: Get existing BTC deposit address
+     */
+    readonly api: ApiNamespace;
+    /** Feature clients */
+    readonly referrals: ReferralsClient;
+    /** Capability registry (manages optional module services) */
+    readonly capabilities: CapabilityRegistry;
+    constructor(config: ResolvedLombardConfig);
+    /**
+     * Get a provider for a specific chain type
+     *
+     * Providers are lazily loaded and cached.
+     *
+     * @param type - Provider type ('evm', 'bitcoin', etc.)
+     * @returns Provider instance
+     * @throws LombardError if provider not configured
+     */
+    getProvider(type: 'evm'): Promise<EvmProvider>;
+    getProvider(type: 'bitcoin'): Promise<BtcProvider>;
+    getProvider(type: 'solana'): Promise<SolanaProvider>;
+    getProvider(type: 'sui'): Promise<SuiProvider>;
+    getProvider(type: 'starknet'): Promise<StarknetProvider>;
+    getProvider(type: ProviderType): Promise<AnyProvider>;
+    /**
+     * Configure partner settings
+     *
+     * @param config - Partner configuration
+     */
+    configure(config: Parameters<PartnerConfiguration['update']>[0]): void;
+    /**
+     * Register a custom asset
+     *
+     * TODO: Implement asset registration
+     */
+    registerAsset(_asset: unknown): void;
+    /**
+     * Get partner configuration
+     */
+    getPartnerConfig(): PartnerConfiguration;
+    getPartnerId(): string | undefined;
+}
+export {};
+//# sourceMappingURL=LombardSDK.d.ts.map

package/dist/client/LombardSDK.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LombardSDK.d.ts","sourceRoot":"","sources":["../../src/client/LombardSDK.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,6BAA6B,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,KAAK,YAAY,GAAG,MAAM,eAAe,CAAC;AAG1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,UAAU,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG;IACzC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAElB,oCAAoC;IACpC,OAAO,CAAC,aAAa,CAAuB;IAE5C,qBAAqB;IACrB,OAAO,CAAC,aAAa,CAA4B;IAEjD;;;;;;;;;OASG;IACH,SAAgB,KAAK,EAAE;QACrB,GAAG,EAAE,UAAU,CAAC;QAChB,GAAG,EAAE,UAAU,CAAC;QAChB,MAAM,EAAE,aAAa,CAAC;QACtB,GAAG,EAAE,UAAU,CAAC;QAChB,QAAQ,EAAE,eAAe,CAAC;KAC3B,CAAC;IAEF,SAAgB,MAAM,EAAE,cAAc,CAAC;IAEvC;;;;;;;;;OASG;IACH,SAAgB,GAAG,EAAE,YAAY,CAAC;IAElC,sBAAsB;IACtB,SAAgB,SAAS,EAAE,eAAe,CAAC;IAE3C,6DAA6D;IAC7D,SAAgB,YAAY,EAAE,kBAAkB,CAAC;gBAErC,MAAM,EAAE,qBAAqB;IAgCzC;;;;;;;;OAQG;IACG,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC;IAC9C,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAClD,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC;IACpD,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC;IAC9C,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC;IACxD,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IA6B3D;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAItE;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAIpC;;OAEG;IACH,gBAAgB,IAAI,oBAAoB;IAIxC,YAAY,IAAI,MAAM,GAAG,SAAS;CAGnC"}

package/dist/client/PartnerConfiguration.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Partner configuration management
+ *
+ * This module handles partner-specific configuration.
+ */
+import type { PartnerConfig } from '../config/types';
+/**
+ * Partner configuration manager
+ *
+ * Manages partner-specific settings.
+ */
+export declare class PartnerConfiguration {
+    private config;
+    constructor(config?: PartnerConfig);
+    /**
+     * Get partner ID
+     */
+    getPartnerId(): string | undefined;
+    /**
+     * Check if partner is configured
+     */
+    isConfigured(): boolean;
+    /**
+     * Update partner configuration
+     *
+     * @param config - New partner configuration
+     */
+    update(config: PartnerConfig): void;
+    /**
+     * Clear partner configuration
+     */
+    clear(): void;
+}
+//# sourceMappingURL=PartnerConfiguration.d.ts.map

package/dist/client/PartnerConfiguration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PartnerConfiguration.d.ts","sourceRoot":"","sources":["../../src/client/PartnerConfiguration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAA4B;gBAE9B,MAAM,CAAC,EAAE,aAAa;IAIlC;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAInC;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/client/createConfig.d.ts

@@ -0,0 +1,30 @@
+import type { CreateConfigOptions, LombardConfig } from '../config/types';
+/**
+ * Create SDK configuration
+ *
+ * This is a **synchronous** function that validates options and returns
+ * a configuration object. The config can be exported from a module and
+ * passed around as a plain object.
+ *
+ * The asset catalog is NOT fetched here - it's fetched asynchronously
+ * when createLombardSDK() is called. This keeps config creation simple
+ * and predictable.
+ *
+ * @param options - Configuration options
+ * @returns Validated SDK configuration
+ *
+ * @example
+ * ```typescript
+ * // lib/lombard.ts - Config is sync, can be exported directly
+ * export const config = createConfig({
+ *   env: Env.prod,
+ *   providers: { evm: () => window.ethereum },
+ * });
+ *
+ * // Usage - SDK creation is async
+ * import { config } from './lib/lombard';
+ * const sdk = await createLombardSDK(config);
+ * ```
+ */
+export declare function createConfig(options: CreateConfigOptions): LombardConfig;
+//# sourceMappingURL=createConfig.d.ts.map