@kasufinance/kasu-sdk 1.0.4 → 2.2.0

package/dist/facade/chain-configs.d.ts

@@ -0,0 +1,11 @@
+import { ChainConfigEntry } from './types';
+/**
+ * Built-in chain configurations for Kasu-supported networks.
+ *
+ * Usage:
+ * ```ts
+ * import { CHAIN_CONFIGS } from '@kasufinance/kasu-sdk';
+ * const base = CHAIN_CONFIGS.base;
+ * ```
+ */
+export declare const CHAIN_CONFIGS: Record<'base' | 'xdc' | 'plume', ChainConfigEntry>;

package/dist/facade/chain-configs.js

@@ -0,0 +1,84 @@
+/**
+ * Built-in chain configurations for Kasu-supported networks.
+ *
+ * Usage:
+ * ```ts
+ * import { CHAIN_CONFIGS } from '@kasufinance/kasu-sdk';
+ * const base = CHAIN_CONFIGS.base;
+ * ```
+ */
+export const CHAIN_CONFIGS = {
+    base: {
+        chainId: 8453,
+        name: 'Base Mainnet',
+        isLiteDeployment: false,
+        contracts: {
+            KSUToken: '0x5D9b878744dbe721a3f33A60a6b102E289CeADBA',
+            IKSULocking: '0xB145C061684C701c2C018A3f322aa14F5A553CE1',
+            IKSULockBonus: '0xEEDE30AcF16caFf49c1a48F75185C67Be2e20B40',
+            LendingPoolManager: '0xE1Be322323a412579b4A09fB08ff4bfcA12096B5',
+            UserManager: '0x5Dc8D315a80fd99AbEF0f327B9a52a3FBC3C93f3',
+            KasuAllowList: '0x807A7e119EBf0282420b5Ca0e0056c0525cBf8BB',
+            SystemVariables: '0x193Bb02A24F5562b58fEB86550e6f09Bb6c41f69',
+            KsuPrice: '0x221a54CbbD5f490Bd8e77CF36acBA4B1304E5c1b',
+            UserLoyaltyRewards: '0xB4784f69Bb1F1076F50907cB0a815908a719D635',
+            ClearingCoordinator: '0x2cF12A6d91fa4bEB5a4C17589a03e78F88f57DE2',
+            KasuNFTs: '0x4946fF5f1a6550524C425479022D50446AA2968E',
+            ExternalTVL: '0x662379FEBb3e4F91400B5f7d4f7F7ce4699F3c9F',
+        },
+        subgraphUrl: 'https://api.goldsky.com/api/public/project_cmgzlpxm300765np2a19421om/subgraphs/kasu-base/v1.0.13/gn',
+        directusUrl: 'https://kasu-finance.directus.app/',
+        unusedPoolIds: [],
+        poolMetadataMapping: undefined,
+    },
+    xdc: {
+        chainId: 50,
+        name: 'XDC Mainnet',
+        isLiteDeployment: true,
+        contracts: {
+            // No KSUToken on Lite deployments
+            IKSULocking: '0x7fF469f8c5fba92A9051B8D28794CBb891760e81',
+            IKSULockBonus: '0x7cc1434EfA50301Fdd56B7c5c6fF7e30Dc20C55c',
+            LendingPoolManager: '0xa46143db92aBe5bB1f61d13d8C1cCd50fc40Ca10',
+            UserManager: '0x9b57dF89e59235f0481A5Fae942302c8831e1B81',
+            KasuAllowList: '0x32c1Ff5FbBe6D28503ddc46E5001C0D13d6E9B2A',
+            SystemVariables: '0x34d17c9DD1f31Fb34757DE923EC083601d0eDFFe',
+            KsuPrice: '0x666b589933965bF8B378eD973f0404b6cae0eb52',
+            UserLoyaltyRewards: '0xb95834C5610A178be9065Dd1EF78258D29879CDb',
+            ClearingCoordinator: '0xAF0a66953Eba1c5353eB7425b398B213Bb2c6121',
+            // No KasuNFTs on Lite deployments
+            ExternalTVL: '0xCCB4156964377CF36441f3775A2A800dbeCB8094',
+        },
+        subgraphUrl: 'https://api.goldsky.com/api/public/project_cmgzlpxm300765np2a19421om/subgraphs/kasu-xdc/v1.0.0/gn',
+        directusUrl: 'https://kasu-finance.directus.app/',
+        unusedPoolIds: [],
+        poolMetadataMapping: {
+            '0x20f42fb45f91657acf9528b99a5a16d0229c7800': '0xc987350716fe4a7d674c3591c391d29eba26b8ce',
+            '0x3b7cb493aa22f731db2ab424d918e7375e00f6a9': '0x03f93c8caa9a82e000d35673ba34a4c0e6e117a2',
+            '0xeda50c91a8c4ca8a83652b8542c0b3bd00a71fad': '0xc347a9e4aec8c8d11a149d2907deb2bf23b81c6f',
+        },
+    },
+    plume: {
+        chainId: 98866,
+        name: 'Plume Mainnet',
+        isLiteDeployment: true,
+        contracts: {
+            // Placeholder — update when Plume contracts are deployed
+            IKSULocking: '',
+            IKSULockBonus: '',
+            LendingPoolManager: '',
+            UserManager: '',
+            KasuAllowList: '',
+            SystemVariables: '',
+            KsuPrice: '',
+            UserLoyaltyRewards: '',
+            ClearingCoordinator: '',
+            ExternalTVL: '',
+        },
+        subgraphUrl: 'https://api.goldsky.com/api/public/project_cmgzlpxm300765np2a19421om/subgraphs/kasu-plume/prod',
+        directusUrl: 'https://kasu-finance.directus.app/',
+        unusedPoolIds: [],
+        poolMetadataMapping: undefined,
+    },
+};
+//# sourceMappingURL=chain-configs.js.map

package/dist/facade/chain-configs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-configs.js","sourceRoot":"","sources":["../../src/facade/chain-configs.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAuD;IAC7E,IAAI,EAAE;QACF,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,cAAc;QACpB,gBAAgB,EAAE,KAAK;QACvB,SAAS,EAAE;YACP,QAAQ,EAAE,4CAA4C;YACtD,WAAW,EAAE,4CAA4C;YACzD,aAAa,EAAE,4CAA4C;YAC3D,kBAAkB,EAAE,4CAA4C;YAChE,WAAW,EAAE,4CAA4C;YACzD,aAAa,EAAE,4CAA4C;YAC3D,eAAe,EAAE,4CAA4C;YAC7D,QAAQ,EAAE,4CAA4C;YACtD,kBAAkB,EAAE,4CAA4C;YAChE,mBAAmB,EAAE,4CAA4C;YACjE,QAAQ,EAAE,4CAA4C;YACtD,WAAW,EAAE,4CAA4C;SAC5D;QACD,WAAW,EACP,qGAAqG;QACzG,WAAW,EAAE,oCAAoC;QACjD,aAAa,EAAE,EAAE;QACjB,mBAAmB,EAAE,SAAS;KACjC;IAED,GAAG,EAAE;QACD,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,aAAa;QACnB,gBAAgB,EAAE,IAAI;QACtB,SAAS,EAAE;YACP,kCAAkC;YAClC,WAAW,EAAE,4CAA4C;YACzD,aAAa,EAAE,4CAA4C;YAC3D,kBAAkB,EAAE,4CAA4C;YAChE,WAAW,EAAE,4CAA4C;YACzD,aAAa,EAAE,4CAA4C;YAC3D,eAAe,EAAE,4CAA4C;YAC7D,QAAQ,EAAE,4CAA4C;YACtD,kBAAkB,EAAE,4CAA4C;YAChE,mBAAmB,EAAE,4CAA4C;YACjE,kCAAkC;YAClC,WAAW,EAAE,4CAA4C;SAC5D;QACD,WAAW,EACP,mGAAmG;QACvG,WAAW,EAAE,oCAAoC;QACjD,aAAa,EAAE,EAAE;QACjB,mBAAmB,EAAE;YACjB,4CAA4C,EACxC,4CAA4C;YAChD,4CAA4C,EACxC,4CAA4C;YAChD,4CAA4C,EACxC,4CAA4C;SACnD;KACJ;IAED,KAAK,EAAE;QACH,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,eAAe;QACrB,gBAAgB,EAAE,IAAI;QACtB,SAAS,EAAE;YACP,yDAAyD;YACzD,WAAW,EAAE,EAAE;YACf,aAAa,EAAE,EAAE;YACjB,kBAAkB,EAAE,EAAE;YACtB,WAAW,EAAE,EAAE;YACf,aAAa,EAAE,EAAE;YACjB,eAAe,EAAE,EAAE;YACnB,QAAQ,EAAE,EAAE;YACZ,kBAAkB,EAAE,EAAE;YACtB,mBAAmB,EAAE,EAAE;YACvB,WAAW,EAAE,EAAE;SAClB;QACD,WAAW,EACP,gGAAgG;QACpG,WAAW,EAAE,oCAAoC;QACjD,aAAa,EAAE,EAAE;QACjB,mBAAmB,EAAE,SAAS;KACjC;CACJ,CAAC"}

package/dist/facade/deposits.d.ts

@@ -0,0 +1,56 @@
+import { ContractTransaction } from 'ethers';
+import { UserLending } from '../services/UserLending/user-lending';
+import { DepositParams, KycParams, WithdrawParams } from './types';
+/**
+ * High-level facade for deposit and withdrawal operations.
+ *
+ * Integrators use this to submit on-chain transactions without
+ * worrying about internal encoding details.
+ */
+export declare class DepositsFacade {
+    private _userLending;
+    private _chainId;
+    constructor(_userLending: UserLending, _chainId: string);
+    /**
+     * Submit a deposit request.
+     *
+     * The integrator must first obtain a KYC signature via the Nexera flow
+     * using the params from `buildKycParams()`.
+     *
+     * ```ts
+     * const kycParams = kasu.deposits.buildKycParams('0xUser...');
+     * // ... obtain kycSignature from your backend via Nexera ...
+     * const tx = await kasu.deposits.deposit({
+     *   poolId: '0x...',
+     *   trancheId: '0x...',
+     *   amount: parseUnits('1000', 6), // 6 decimals for USDC/AUDD; use token's actual decimals
+     *   kycSignature: { blockExpiration, signature },
+     * });
+     * ```
+     */
+    deposit(params: DepositParams): Promise<ContractTransaction>;
+    /**
+     * Submit a withdrawal request for a specific stable asset amount.
+     */
+    withdraw(params: WithdrawParams): Promise<ContractTransaction>;
+    /**
+     * Withdraw the entire balance from a tranche.
+     */
+    withdrawMax(poolId: string, trancheId: string, userAddress: string): Promise<ContractTransaction>;
+    /**
+     * Build KYC signature parameters for the Nexera verification flow.
+     *
+     * The integrator is responsible for sending these to their backend,
+     * which obtains the signature from Nexera's signing service.
+     */
+    buildKycParams(userAddress: `0x${string}`): KycParams;
+    /**
+     * Check whether the pool is currently in a clearing period
+     * (deposits/withdrawals are temporarily paused).
+     */
+    isClearingPending(poolId: string): Promise<boolean>;
+    /**
+     * Get the current epoch number.
+     */
+    getCurrentEpoch(): Promise<string>;
+}

package/dist/facade/deposits.js

@@ -0,0 +1,87 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/**
+ * High-level facade for deposit and withdrawal operations.
+ *
+ * Integrators use this to submit on-chain transactions without
+ * worrying about internal encoding details.
+ */
+export class DepositsFacade {
+    constructor(_userLending, _chainId) {
+        this._userLending = _userLending;
+        this._chainId = _chainId;
+    }
+    /**
+     * Submit a deposit request.
+     *
+     * The integrator must first obtain a KYC signature via the Nexera flow
+     * using the params from `buildKycParams()`.
+     *
+     * ```ts
+     * const kycParams = kasu.deposits.buildKycParams('0xUser...');
+     * // ... obtain kycSignature from your backend via Nexera ...
+     * const tx = await kasu.deposits.deposit({
+     *   poolId: '0x...',
+     *   trancheId: '0x...',
+     *   amount: parseUnits('1000', 6), // 6 decimals for USDC/AUDD; use token's actual decimals
+     *   kycSignature: { blockExpiration, signature },
+     * });
+     * ```
+     */
+    deposit(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            return yield this._userLending.requestDepositWithKyc(params.poolId, params.trancheId, params.amount, (_a = params.swapData) !== null && _a !== void 0 ? _a : '0x', (_b = params.fixedTermConfigId) !== null && _b !== void 0 ? _b : 0, (_c = params.depositData) !== null && _c !== void 0 ? _c : '0x', params.kycSignature, (_d = params.ethValue) !== null && _d !== void 0 ? _d : '0');
+        });
+    }
+    /**
+     * Submit a withdrawal request for a specific stable asset amount.
+     */
+    withdraw(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this._userLending.requestWithdrawalInAsset(params.poolId, params.trancheId, params.amount);
+        });
+    }
+    /**
+     * Withdraw the entire balance from a tranche.
+     */
+    withdrawMax(poolId, trancheId, userAddress) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this._userLending.requestWithdrawalMax(poolId, trancheId, userAddress);
+        });
+    }
+    /**
+     * Build KYC signature parameters for the Nexera verification flow.
+     *
+     * The integrator is responsible for sending these to their backend,
+     * which obtains the signature from Nexera's signing service.
+     */
+    buildKycParams(userAddress) {
+        return this._userLending.buildKycSignatureParams(userAddress, this._chainId);
+    }
+    /**
+     * Check whether the pool is currently in a clearing period
+     * (deposits/withdrawals are temporarily paused).
+     */
+    isClearingPending(poolId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this._userLending.isClearingPending(poolId);
+        });
+    }
+    /**
+     * Get the current epoch number.
+     */
+    getCurrentEpoch() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this._userLending.getCurrentEpoch();
+        });
+    }
+}
+//# sourceMappingURL=deposits.js.map

package/dist/facade/deposits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deposits.js","sourceRoot":"","sources":["../../src/facade/deposits.ts"],"names":[],"mappings":";;;;;;;;;AAMA;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IACvB,YACY,YAAyB,EACzB,QAAgB;QADhB,iBAAY,GAAZ,YAAY,CAAa;QACzB,aAAQ,GAAR,QAAQ,CAAQ;IACzB,CAAC;IAEJ;;;;;;;;;;;;;;;;OAgBG;IACG,OAAO,CAAC,MAAqB;;;YAC/B,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,qBAAqB,CAChD,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,MAAM,EACb,MAAA,MAAM,CAAC,QAAQ,mCAAI,IAAI,EACvB,MAAA,MAAM,CAAC,iBAAiB,mCAAI,CAAC,EAC7B,MAAA,MAAM,CAAC,WAAW,mCAAI,IAAI,EAC1B,MAAM,CAAC,YAAY,EACnB,MAAA,MAAM,CAAC,QAAQ,mCAAI,GAAG,CACzB,CAAC;QACN,CAAC;KAAA;IAED;;OAEG;IACG,QAAQ,CAAC,MAAsB;;YACjC,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,wBAAwB,CACnD,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,MAAM,CAChB,CAAC;QACN,CAAC;KAAA;IAED;;OAEG;IACG,WAAW,CACb,MAAc,EACd,SAAiB,EACjB,WAAmB;;YAEnB,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,oBAAoB,CAC/C,MAAM,EACN,SAAS,EACT,WAAW,CACd,CAAC;QACN,CAAC;KAAA;IAED;;;;;OAKG;IACH,cAAc,CAAC,WAA0B;QACrC,OAAO,IAAI,CAAC,YAAY,CAAC,uBAAuB,CAC5C,WAAW,EACX,IAAI,CAAC,QAAQ,CAChB,CAAC;IACN,CAAC;IAED;;;OAGG;IACG,iBAAiB,CAAC,MAAc;;YAClC,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC7D,CAAC;KAAA;IAED;;OAEG;IACG,eAAe;;YACjB,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC;QACrD,CAAC;KAAA;CACJ"}

package/dist/facade/index.d.ts

@@ -0,0 +1,6 @@
+export { Kasu } from './kasu';
+export { StrategiesFacade } from './strategies';
+export { DepositsFacade } from './deposits';
+export { PortfolioFacade } from './user-portfolio';
+export { CHAIN_CONFIGS } from './chain-configs';
+export type { SupportedChain, ChainConfigEntry, KasuOptions, Strategy, StrategyTranche, FixedTermOption, DepositParams, WithdrawParams, DepositLimits, KycParams, UserPositions, PlatformStats, } from './types';

package/dist/facade/index.js

@@ -0,0 +1,9 @@
+// Main entry point
+export { Kasu } from './kasu';
+// Individual facades (for advanced composition)
+export { StrategiesFacade } from './strategies';
+export { DepositsFacade } from './deposits';
+export { PortfolioFacade } from './user-portfolio';
+// Chain configurations
+export { CHAIN_CONFIGS } from './chain-configs';
+//# sourceMappingURL=index.js.map

package/dist/facade/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/facade/index.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,gDAAgD;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,uBAAuB;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/facade/kasu.d.ts

@@ -0,0 +1,71 @@
+import { KasuSdk } from '../kasu-sdk';
+import { DepositsFacade } from './deposits';
+import { StrategiesFacade } from './strategies';
+import { ChainConfigEntry, KasuOptions } from './types';
+import { PortfolioFacade } from './user-portfolio';
+/**
+ * High-level entry point for external integrators.
+ *
+ * Provides three domain facades — `strategies`, `deposits`, `portfolio` — and
+ * exposes the underlying `KasuSdk` services via `.services` for power-users.
+ *
+ * ```ts
+ * import { Kasu } from '@kasufinance/kasu-sdk';
+ *
+ * const kasu = Kasu.create({ chain: 'base', signerOrProvider: provider });
+ *
+ * // Browse strategies
+ * const strategies = await kasu.strategies.getAll();
+ *
+ * // Deposit
+ * const tx = await kasu.deposits.deposit({ poolId, trancheId, amount, kycSignature });
+ *
+ * // User positions
+ * const positions = await kasu.portfolio.getPositions(userAddress);
+ * ```
+ */
+export declare class Kasu {
+    /** Browse lending strategies, APY, capacity. */
+    readonly strategies: StrategiesFacade;
+    /** Deposit, withdraw, KYC helpers. */
+    readonly deposits: DepositsFacade;
+    /** User positions, yields, transaction history. */
+    readonly portfolio: PortfolioFacade;
+    private readonly _sdk;
+    private readonly _chainConfig;
+    private constructor();
+    /**
+     * Create a Kasu instance with built-in chain config.
+     *
+     * ```ts
+     * // Minimal setup — uses built-in Base mainnet config
+     * const kasu = Kasu.create({ chain: 'base', signerOrProvider: provider });
+     *
+     * // Custom config override
+     * const kasu = Kasu.create({
+     *   chain: 'base',
+     *   signerOrProvider: signer,
+     *   configOverrides: { UNUSED_LENDING_POOL_IDS: ['0x...'] },
+     * });
+     *
+     * // Fully custom chain
+     * const kasu = Kasu.create({
+     *   chain: { chainId: 123, name: 'MyChain', ... },
+     *   signerOrProvider: provider,
+     * });
+     * ```
+     */
+    static create(options: KasuOptions): Kasu;
+    /**
+     * Access the underlying `KasuSdk` services for advanced use cases.
+     *
+     * ```ts
+     * const locks = await kasu.services.Locking.getUserLocks(address);
+     * ```
+     */
+    get services(): KasuSdk;
+    /** The resolved chain configuration. */
+    get chainConfig(): ChainConfigEntry;
+    /** Whether this deployment has KSU token / locking features. */
+    get isLiteDeployment(): boolean;
+}

package/dist/facade/kasu.js

@@ -0,0 +1,101 @@
+import { KasuSdk } from '../kasu-sdk';
+import { SdkConfig } from '../sdk-config';
+import { CHAIN_CONFIGS } from './chain-configs';
+import { DepositsFacade } from './deposits';
+import { StrategiesFacade } from './strategies';
+import { PortfolioFacade } from './user-portfolio';
+/**
+ * High-level entry point for external integrators.
+ *
+ * Provides three domain facades — `strategies`, `deposits`, `portfolio` — and
+ * exposes the underlying `KasuSdk` services via `.services` for power-users.
+ *
+ * ```ts
+ * import { Kasu } from '@kasufinance/kasu-sdk';
+ *
+ * const kasu = Kasu.create({ chain: 'base', signerOrProvider: provider });
+ *
+ * // Browse strategies
+ * const strategies = await kasu.strategies.getAll();
+ *
+ * // Deposit
+ * const tx = await kasu.deposits.deposit({ poolId, trancheId, amount, kycSignature });
+ *
+ * // User positions
+ * const positions = await kasu.portfolio.getPositions(userAddress);
+ * ```
+ */
+export class Kasu {
+    constructor(sdk, chainConfig) {
+        this._sdk = sdk;
+        this._chainConfig = chainConfig;
+        this.strategies = new StrategiesFacade(sdk.DataService, sdk.UserLending);
+        this.deposits = new DepositsFacade(sdk.UserLending, chainConfig.chainId.toString());
+        this.portfolio = new PortfolioFacade(sdk.DataService, sdk.UserLending, sdk.Portfolio);
+    }
+    /**
+     * Create a Kasu instance with built-in chain config.
+     *
+     * ```ts
+     * // Minimal setup — uses built-in Base mainnet config
+     * const kasu = Kasu.create({ chain: 'base', signerOrProvider: provider });
+     *
+     * // Custom config override
+     * const kasu = Kasu.create({
+     *   chain: 'base',
+     *   signerOrProvider: signer,
+     *   configOverrides: { UNUSED_LENDING_POOL_IDS: ['0x...'] },
+     * });
+     *
+     * // Fully custom chain
+     * const kasu = Kasu.create({
+     *   chain: { chainId: 123, name: 'MyChain', ... },
+     *   signerOrProvider: provider,
+     * });
+     * ```
+     */
+    static create(options) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const chainConfig = resolveChainConfig(options.chain);
+        const overrides = (_a = options.configOverrides) !== null && _a !== void 0 ? _a : {};
+        const sdkConfig = new SdkConfig({
+            subgraphUrl: (_b = overrides.subgraphUrl) !== null && _b !== void 0 ? _b : chainConfig.subgraphUrl,
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+            contracts: (_c = overrides.contracts) !== null && _c !== void 0 ? _c : chainConfig.contracts,
+            directusUrl: (_d = overrides.directusUrl) !== null && _d !== void 0 ? _d : chainConfig.directusUrl,
+            UNUSED_LENDING_POOL_IDS: (_e = overrides.UNUSED_LENDING_POOL_IDS) !== null && _e !== void 0 ? _e : chainConfig.unusedPoolIds,
+            isLiteDeployment: (_f = overrides.isLiteDeployment) !== null && _f !== void 0 ? _f : chainConfig.isLiteDeployment,
+            poolMetadataMapping: (_g = overrides.poolMetadataMapping) !== null && _g !== void 0 ? _g : chainConfig.poolMetadataMapping,
+        });
+        const sdk = new KasuSdk(sdkConfig, options.signerOrProvider);
+        return new Kasu(sdk, chainConfig);
+    }
+    /**
+     * Access the underlying `KasuSdk` services for advanced use cases.
+     *
+     * ```ts
+     * const locks = await kasu.services.Locking.getUserLocks(address);
+     * ```
+     */
+    get services() {
+        return this._sdk;
+    }
+    /** The resolved chain configuration. */
+    get chainConfig() {
+        return this._chainConfig;
+    }
+    /** Whether this deployment has KSU token / locking features. */
+    get isLiteDeployment() {
+        return this._chainConfig.isLiteDeployment;
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function resolveChainConfig(chain) {
+    if (typeof chain === 'string') {
+        return CHAIN_CONFIGS[chain];
+    }
+    return chain;
+}
+//# sourceMappingURL=kasu.js.map

package/dist/facade/kasu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kasu.js","sourceRoot":"","sources":["../../src/facade/kasu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,IAAI;IAWb,YACI,GAAY,EACZ,WAA6B;QAE7B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAEhC,IAAI,CAAC,UAAU,GAAG,IAAI,gBAAgB,CAClC,GAAG,CAAC,WAAW,EACf,GAAG,CAAC,WAAW,CAClB,CAAC;QAEF,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAC9B,GAAG,CAAC,WAAW,EACf,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,CACjC,CAAC;QAEF,IAAI,CAAC,SAAS,GAAG,IAAI,eAAe,CAChC,GAAG,CAAC,WAAW,EACf,GAAG,CAAC,WAAW,EACf,GAAG,CAAC,SAAS,CAChB,CAAC;IACN,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,MAAM,CAAC,OAAoB;;QAC9B,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,MAAA,OAAO,CAAC,eAAe,mCAAI,EAAE,CAAC;QAEhD,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC;YAC5B,WAAW,EAAE,MAAA,SAAS,CAAC,WAAW,mCAAI,WAAW,CAAC,WAAW;YAC7D,mEAAmE;YACnE,SAAS,EAAE,MAAA,SAAS,CAAC,SAAS,mCAAI,WAAW,CAAC,SAAS;YACvD,WAAW,EACP,MAAA,SAAS,CAAC,WAAW,mCAAI,WAAW,CAAC,WAAW;YACpD,uBAAuB,EACnB,MAAA,SAAS,CAAC,uBAAuB,mCACjC,WAAW,CAAC,aAAa;YAC7B,gBAAgB,EACZ,MAAA,SAAS,CAAC,gBAAgB,mCAAI,WAAW,CAAC,gBAAgB;YAC9D,mBAAmB,EACf,MAAA,SAAS,CAAC,mBAAmB,mCAC7B,WAAW,CAAC,mBAAmB;SACtC,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC7D,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,wCAAwC;IACxC,IAAI,WAAW;QACX,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED,gEAAgE;IAChE,IAAI,gBAAgB;QAChB,OAAO,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC;IAC9C,CAAC;CACJ;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,kBAAkB,CACvB,KAAwC;IAExC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/facade/strategies.d.ts

@@ -0,0 +1,37 @@
+import { DataService } from '../services/DataService/data-service';
+import { UserLending } from '../services/UserLending/user-lending';
+import { DepositLimits, PlatformStats, Strategy, StrategyTranche } from './types';
+/**
+ * High-level facade for browsing Kasu lending strategies (pools).
+ *
+ * Handles epoch fetching internally so callers never need to know about epochs.
+ */
+export declare class StrategiesFacade {
+    private _dataService;
+    private _userLending;
+    constructor(_dataService: DataService, _userLending: UserLending);
+    /**
+     * Fetch all active lending strategies.
+     *
+     * ```ts
+     * const strategies = await kasu.strategies.getAll();
+     * ```
+     */
+    getAll(poolIds?: string[]): Promise<Strategy[]>;
+    /**
+     * Fetch a single strategy by pool ID. Returns `null` if not found.
+     */
+    getById(poolId: string): Promise<Strategy | null>;
+    /**
+     * Aggregate platform statistics (TVL, loans, yield, loss rate).
+     */
+    getPlatformStats(): Promise<PlatformStats>;
+    /**
+     * Calculate deposit limits for a specific tranche.
+     *
+     * @param tranche - A `StrategyTranche` from `getAll()` or `getById()`.
+     * @returns min/max/capacity in ether-formatted USDC strings.
+     */
+    calculateDepositLimits(tranche: StrategyTranche): DepositLimits;
+    private mapPoolToStrategy;
+}

package/dist/facade/strategies.js

@@ -0,0 +1,112 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/**
+ * High-level facade for browsing Kasu lending strategies (pools).
+ *
+ * Handles epoch fetching internally so callers never need to know about epochs.
+ */
+export class StrategiesFacade {
+    constructor(_dataService, _userLending) {
+        this._dataService = _dataService;
+        this._userLending = _userLending;
+    }
+    /**
+     * Fetch all active lending strategies.
+     *
+     * ```ts
+     * const strategies = await kasu.strategies.getAll();
+     * ```
+     */
+    getAll(poolIds) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const epochId = yield this._userLending.getCurrentEpoch();
+            const pools = yield this._dataService.getPoolOverview(epochId, poolIds);
+            return pools.map((pool) => this.mapPoolToStrategy(pool));
+        });
+    }
+    /**
+     * Fetch a single strategy by pool ID. Returns `null` if not found.
+     */
+    getById(poolId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const results = yield this.getAll([poolId]);
+            return (_a = results[0]) !== null && _a !== void 0 ? _a : null;
+        });
+    }
+    /**
+     * Aggregate platform statistics (TVL, loans, yield, loss rate).
+     */
+    getPlatformStats() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const epochId = yield this._userLending.getCurrentEpoch();
+            const pools = yield this._dataService.getPoolOverview(epochId);
+            return yield this._dataService.getLendingTotals(pools);
+        });
+    }
+    /**
+     * Calculate deposit limits for a specific tranche.
+     *
+     * @param tranche - A `StrategyTranche` from `getAll()` or `getById()`.
+     * @returns min/max/capacity in ether-formatted USDC strings.
+     */
+    calculateDepositLimits(tranche) {
+        const raw = tranche._raw;
+        const min = parseFloat(raw.minimumDeposit) < 1
+            ? '1'
+            : raw.minimumDeposit;
+        const max = parseFloat(raw.maximumDeposit) > parseFloat(raw.poolCapacity)
+            ? raw.poolCapacity
+            : raw.maximumDeposit;
+        return {
+            min,
+            max,
+            availableCapacity: raw.poolCapacity,
+        };
+    }
+    // ------------------------------------------------------------------
+    // Private helpers
+    // ------------------------------------------------------------------
+    mapPoolToStrategy(pool) {
+        const tranches = pool.tranches.map((t) => ({
+            id: t.id,
+            name: t.name,
+            apy: parseFloat(t.apy),
+            minApy: parseFloat(t.minApy),
+            maxApy: parseFloat(t.maxApy),
+            minimumDeposit: t.minimumDeposit,
+            maximumDeposit: t.maximumDeposit,
+            availableCapacity: t.poolCapacity,
+            fixedTermOptions: t.fixedTermConfig.map((ftd) => ({
+                configId: ftd.configId,
+                apy: parseFloat(ftd.apy),
+                epochLockDuration: ftd.epochLockDuration,
+            })),
+            _raw: t,
+        }));
+        return {
+            id: pool.id,
+            name: pool.poolName,
+            description: pool.description,
+            isActive: pool.isActive,
+            apy: pool.apy,
+            tvl: pool.totalValueLocked,
+            availableCapacity: pool.poolCapacity,
+            capacityUtilisation: pool.poolCapacityPercentage,
+            tranches,
+            assetClass: pool.assetClass,
+            apyStructure: pool.poolApyStructure,
+            thumbnailUrl: pool.thumbnailImageUrl,
+            bannerUrl: pool.bannerImageUrl,
+            _raw: pool,
+        };
+    }
+}
+//# sourceMappingURL=strategies.js.map

package/dist/facade/strategies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategies.js","sourceRoot":"","sources":["../../src/facade/strategies.ts"],"names":[],"mappings":"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"}