@kasufinance/kasu-sdk 1.0.3 → 2.1.0

package/dist/tests/facade.test.js

@@ -0,0 +1,196 @@
+import { CHAIN_CONFIGS } from '../facade/chain-configs';
+import { DepositsFacade } from '../facade/deposits';
+import { Kasu } from '../facade/kasu';
+import { StrategiesFacade } from '../facade/strategies';
+import { PortfolioFacade } from '../facade/user-portfolio';
+// ---------------------------------------------------------------------------
+// Chain configs
+// ---------------------------------------------------------------------------
+describe('CHAIN_CONFIGS', () => {
+    it('should have base, xdc, and plume entries', () => {
+        expect(CHAIN_CONFIGS).toHaveProperty('base');
+        expect(CHAIN_CONFIGS).toHaveProperty('xdc');
+        expect(CHAIN_CONFIGS).toHaveProperty('plume');
+    });
+    it('base should be a full deployment', () => {
+        const base = CHAIN_CONFIGS.base;
+        expect(base.chainId).toBe(8453);
+        expect(base.isLiteDeployment).toBe(false);
+        expect(base.contracts.KSUToken).toBeDefined();
+        expect(base.contracts.KasuNFTs).toBeDefined();
+    });
+    it('xdc should be a lite deployment without KSU token', () => {
+        const xdc = CHAIN_CONFIGS.xdc;
+        expect(xdc.chainId).toBe(50);
+        expect(xdc.isLiteDeployment).toBe(true);
+        expect(xdc.contracts.KSUToken).toBeUndefined();
+        expect(xdc.contracts.KasuNFTs).toBeUndefined();
+    });
+    it('plume should be a lite deployment', () => {
+        const plume = CHAIN_CONFIGS.plume;
+        expect(plume.chainId).toBe(98866);
+        expect(plume.isLiteDeployment).toBe(true);
+    });
+    it('all chains should have required contract addresses', () => {
+        for (const [, config] of Object.entries(CHAIN_CONFIGS)) {
+            expect(config.contracts.LendingPoolManager).toBeDefined();
+            expect(config.contracts.UserManager).toBeDefined();
+            expect(config.contracts.KasuAllowList).toBeDefined();
+            expect(config.contracts.SystemVariables).toBeDefined();
+            expect(config.subgraphUrl).toContain('goldsky.com');
+        }
+    });
+    it('xdc should have poolMetadataMapping', () => {
+        const mapping = CHAIN_CONFIGS.xdc.poolMetadataMapping;
+        expect(mapping).toBeDefined();
+        expect(Object.keys(mapping !== null && mapping !== void 0 ? mapping : {}).length).toBeGreaterThan(0);
+    });
+});
+// ---------------------------------------------------------------------------
+// Kasu.create()
+// ---------------------------------------------------------------------------
+describe('Kasu.create()', () => {
+    // Mock provider — enough to construct the SDK without network calls
+    const mockProvider = {
+        getNetwork: jest.fn().mockResolvedValue({ chainId: 8453, name: 'base' }),
+        call: jest.fn(),
+        estimateGas: jest.fn(),
+        getBlockNumber: jest.fn(),
+        getBlock: jest.fn(),
+        getTransaction: jest.fn(),
+        getTransactionReceipt: jest.fn(),
+        getLogs: jest.fn(),
+        on: jest.fn(),
+        once: jest.fn(),
+        off: jest.fn(),
+        removeAllListeners: jest.fn(),
+        _isProvider: true,
+    };
+    it('should create an instance from a chain name', () => {
+        const kasu = Kasu.create({
+            chain: 'base',
+            signerOrProvider: mockProvider,
+        });
+        expect(kasu).toBeInstanceOf(Kasu);
+        expect(kasu.strategies).toBeInstanceOf(StrategiesFacade);
+        expect(kasu.deposits).toBeInstanceOf(DepositsFacade);
+        expect(kasu.portfolio).toBeInstanceOf(PortfolioFacade);
+    });
+    it('should expose chainConfig for the selected chain', () => {
+        const kasu = Kasu.create({
+            chain: 'xdc',
+            signerOrProvider: mockProvider,
+        });
+        expect(kasu.chainConfig.chainId).toBe(50);
+        expect(kasu.isLiteDeployment).toBe(true);
+    });
+    it('should accept a custom ChainConfigEntry', () => {
+        const custom = Object.assign(Object.assign({}, CHAIN_CONFIGS.base), { chainId: 999, name: 'CustomChain' });
+        const kasu = Kasu.create({
+            chain: custom,
+            signerOrProvider: mockProvider,
+        });
+        expect(kasu.chainConfig.chainId).toBe(999);
+        expect(kasu.chainConfig.name).toBe('CustomChain');
+    });
+    it('should accept configOverrides', () => {
+        const kasu = Kasu.create({
+            chain: 'base',
+            signerOrProvider: mockProvider,
+            configOverrides: {
+                UNUSED_LENDING_POOL_IDS: ['0xdead'],
+            },
+        });
+        expect(kasu).toBeInstanceOf(Kasu);
+    });
+    it('should expose the underlying KasuSdk via .services', () => {
+        const kasu = Kasu.create({
+            chain: 'base',
+            signerOrProvider: mockProvider,
+        });
+        expect(kasu.services).toBeDefined();
+        expect(kasu.services.DataService).toBeDefined();
+        expect(kasu.services.UserLending).toBeDefined();
+        expect(kasu.services.Locking).toBeDefined();
+        expect(kasu.services.Portfolio).toBeDefined();
+    });
+});
+// ---------------------------------------------------------------------------
+// StrategiesFacade.calculateDepositLimits()
+// ---------------------------------------------------------------------------
+describe('StrategiesFacade.calculateDepositLimits()', () => {
+    // We can test this pure function without network calls by constructing
+    // a StrategiesFacade with null services and calling calculateDepositLimits directly.
+    const facade = new StrategiesFacade(null, null);
+    it('should enforce minimum of 1 USDC', () => {
+        const tranche = makeTranche({
+            minimumDeposit: '0.5',
+            maximumDeposit: '10000',
+            poolCapacity: '50000',
+        });
+        const limits = facade.calculateDepositLimits(tranche);
+        expect(limits.min).toBe('1');
+        expect(limits.max).toBe('10000');
+        expect(limits.availableCapacity).toBe('50000');
+    });
+    it('should pass through minimum when >= 1', () => {
+        const tranche = makeTranche({
+            minimumDeposit: '100',
+            maximumDeposit: '10000',
+            poolCapacity: '50000',
+        });
+        const limits = facade.calculateDepositLimits(tranche);
+        expect(limits.min).toBe('100');
+    });
+    it('should cap max at pool capacity when capacity is lower', () => {
+        const tranche = makeTranche({
+            minimumDeposit: '100',
+            maximumDeposit: '50000',
+            poolCapacity: '10000',
+        });
+        const limits = facade.calculateDepositLimits(tranche);
+        expect(limits.max).toBe('10000');
+    });
+    it('should use maximumDeposit when capacity is higher', () => {
+        const tranche = makeTranche({
+            minimumDeposit: '100',
+            maximumDeposit: '5000',
+            poolCapacity: '50000',
+        });
+        const limits = facade.calculateDepositLimits(tranche);
+        expect(limits.max).toBe('5000');
+    });
+});
+// ---------------------------------------------------------------------------
+// Type exports — verify key facade types are importable
+// ---------------------------------------------------------------------------
+describe('Type re-exports', () => {
+    it('should export facade classes from the main entry', () => {
+        // Verify the barrel exports resolve — these would fail at compile time
+        // if the re-exports were broken.
+        expect(Kasu).toBeDefined();
+        expect(CHAIN_CONFIGS).toBeDefined();
+        expect(StrategiesFacade).toBeDefined();
+        expect(DepositsFacade).toBeDefined();
+        expect(PortfolioFacade).toBeDefined();
+    });
+});
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
+function makeTranche(raw) {
+    return {
+        id: '0xtest',
+        name: 'Test Tranche',
+        apy: 0.08,
+        minApy: 0.06,
+        maxApy: 0.10,
+        minimumDeposit: raw.minimumDeposit,
+        maximumDeposit: raw.maximumDeposit,
+        availableCapacity: raw.poolCapacity,
+        fixedTermOptions: [],
+        _raw: Object.assign(Object.assign({}, raw), { id: '0xtest', name: 'Test Tranche', apy: '0.08', minApy: '0.06', maxApy: '0.10', fixedTermConfig: [] }),
+    };
+}
+//# sourceMappingURL=facade.test.js.map

package/dist/tests/facade.test.js.map

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

package/dist/tests/sample.test.js

@@ -13,20 +13,26 @@ import { SdkConfig } from '../sdk-config';
 test('subgraphCall', () => __awaiter(void 0, void 0, void 0, function* () {
     const provider = new ethers.providers.JsonRpcProvider('https://sepolia.base.org');
     const wallet = new ethers.Wallet('dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd', provider);
-    const config = new SdkConfig('https://api.studio.thegraph.com/query/63245/kasu-wip-sepolia/version/latest', 'https://api.goldsky.com/api/public/project_cm9t3064xeuyn01tgctdo3c17/subgraphs/kasu-plume/prod/gn', {
-        IKSULocking: '0x529A81c11ab6176c5E88670d293BB771800066a2',
-        IKSULockBonus: '0xBBfFd5F744156FFc526df12F5e09dC7b208Be740',
-        KSUToken: '0xa0f698Feb9Bc2BeA6E85eb071D5E3F59dc5bC56b',
-        UserManager: '0xA788e9223fDd7c9Db91Ef133BbeB73515c174773',
-        LendingPoolManager: '0xc074Aaf2565aae18db2c7498ee1387610a809F40',
-        KasuAllowList: '0xaE94F9D187c9eA649ADd4966340831F7cc62B69c',
-        SystemVariables: '0xB174a3240B23e595e90bC2736A5b8ec674Cba73A',
-        UserLoyaltyRewards: '0x259631CE76FD9F65296549Cd81232aa59D53Dd0c',
-        KsuPrice: '0x2027192aCFB4810Ad734A212F19d7030F698aCE3',
-        ClearingCoordinator: '0x2027192aCFB4810Ad734A212F19d7030F698aCE3',
-        KasuNFTs: '0x0000000000000000000000000000000000000000',
-        ExternalTVL: '0x0000000000000000000000000000000000000000',
-    }, 'https://kasu-finance.directus.app', ['']);
+    const config = new SdkConfig({
+        subgraphUrl: 'https://api.studio.thegraph.com/query/63245/kasu-wip-sepolia/version/latest',
+        contracts: {
+            IKSULocking: '0x529A81c11ab6176c5E88670d293BB771800066a2',
+            IKSULockBonus: '0xBBfFd5F744156FFc526df12F5e09dC7b208Be740',
+            KSUToken: '0xa0f698Feb9Bc2BeA6E85eb071D5E3F59dc5bC56b',
+            UserManager: '0xA788e9223fDd7c9Db91Ef133BbeB73515c174773',
+            LendingPoolManager: '0xc074Aaf2565aae18db2c7498ee1387610a809F40',
+            KasuAllowList: '0xaE94F9D187c9eA649ADd4966340831F7cc62B69c',
+            SystemVariables: '0xB174a3240B23e595e90bC2736A5b8ec674Cba73A',
+            UserLoyaltyRewards: '0x259631CE76FD9F65296549Cd81232aa59D53Dd0c',
+            KsuPrice: '0x2027192aCFB4810Ad734A212F19d7030F698aCE3',
+            ClearingCoordinator: '0x2027192aCFB4810Ad734A212F19d7030F698aCE3',
+            KasuNFTs: '0x0000000000000000000000000000000000000000',
+            ExternalTVL: '0x0000000000000000000000000000000000000000',
+        },
+        directusUrl: 'https://kasu-finance.directus.app',
+        UNUSED_LENDING_POOL_IDS: [''],
+    });
     const sdk = new KasuSdk(config, wallet);
     console.log(yield sdk.UserLending.getUserApyBonus('0xef38c432682ab49095e00442aaa354e955ac03a5'));
 }));
+//# sourceMappingURL=sample.test.js.map

package/dist/tests/sample.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.test.js","sourceRoot":"","sources":["../../src/tests/sample.test.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,IAAI,CAAC,cAAc,EAAE,GAAS,EAAE;IAC5B,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,eAAe,CACjD,0BAA0B,CAC7B,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAC5B,kEAAkE,EAClE,QAAQ,CACX,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QACzB,WAAW,EACP,6EAA6E;QACjF,SAAS,EAAE;YACP,WAAW,EAAE,4CAA4C;YACzD,aAAa,EAAE,4CAA4C;YAC3D,QAAQ,EAAE,4CAA4C;YACtD,WAAW,EAAE,4CAA4C;YACzD,kBAAkB,EAAE,4CAA4C;YAChE,aAAa,EAAE,4CAA4C;YAC3D,eAAe,EAAE,4CAA4C;YAC7D,kBAAkB,EAAE,4CAA4C;YAChE,QAAQ,EAAE,4CAA4C;YACtD,mBAAmB,EAAE,4CAA4C;YACjE,QAAQ,EAAE,4CAA4C;YACtD,WAAW,EAAE,4CAA4C;SAC5D;QACD,WAAW,EAAE,mCAAmC;QAChD,uBAAuB,EAAE,CAAC,EAAE,CAAC;KAChC,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC,OAAO,CAAC,GAAG,CACP,MAAM,GAAG,CAAC,WAAW,CAAC,eAAe,CACjC,4CAA4C,CAC/C,CACJ,CAAC;AACN,CAAC,CAAA,CAAC,CAAC"}

package/dist/utils/deployment-mode.d.ts

@@ -0,0 +1,6 @@
+import { SdkConfig } from '../sdk-config';
+/**
+ * Check if the SDK is configured for a Lite deployment.
+ * Lite deployments don't have KSU token, locking, or loyalty features.
+ */
+export declare function isLiteDeployment(config: SdkConfig): boolean;

package/dist/utils/deployment-mode.js

@@ -0,0 +1,8 @@
+/**
+ * Check if the SDK is configured for a Lite deployment.
+ * Lite deployments don't have KSU token, locking, or loyalty features.
+ */
+export function isLiteDeployment(config) {
+    return config.isLiteDeployment;
+}
+//# sourceMappingURL=deployment-mode.js.map

package/dist/utils/deployment-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-mode.js","sourceRoot":"","sources":["../../src/utils/deployment-mode.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAC9C,OAAO,MAAM,CAAC,gBAAgB,CAAC;AACnC,CAAC"}

package/package.json

@@ -1,14 +1,15 @@
 {
     "name": "@kasufinance/kasu-sdk",
-    "version": "1.0.3",
+    "version": "2.1.0",
     "description": "",
     "main": "dist/bundle.cjs.js",
     "module": "dist/bundle.esm.js",
-    "types": "dist/types/index.d.ts",
+    "types": "dist/index.d.ts",
     "scripts": {
         "test": "jest --config=jest-config.ts",
         "build-tc": "typechain --target ethers-v5 --out-dir src/contracts './abis/*.json'",
         "build": "eslint . && tsc --build --force tsconfig.json",
+        "build:watch": "npx tsc -b --force --watch",
         "rollup-build": "rollup -c",
         "lint": "eslint . --fix"
     },

package/src/facade/chain-configs.ts

@@ -0,0 +1,93 @@
+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 const CHAIN_CONFIGS: Record<'base' | 'xdc' | 'plume', ChainConfigEntry> = {
+    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,
+    },
+};

package/src/facade/deposits.ts

@@ -0,0 +1,102 @@
+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 class DepositsFacade {
+    constructor(
+        private _userLending: UserLending,
+        private _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),
+     *   kycSignature: { blockExpiration, signature },
+     * });
+     * ```
+     */
+    async deposit(params: DepositParams): Promise<ContractTransaction> {
+        return await this._userLending.requestDepositWithKyc(
+            params.poolId,
+            params.trancheId,
+            params.amount,
+            params.swapData ?? '0x',
+            params.fixedTermConfigId ?? 0,
+            params.depositData ?? '0x',
+            params.kycSignature,
+            params.ethValue ?? '0',
+        );
+    }
+
+    /**
+     * Submit a withdrawal request for a specific USDC amount.
+     */
+    async withdraw(params: WithdrawParams): Promise<ContractTransaction> {
+        return await this._userLending.requestWithdrawalInUSDC(
+            params.poolId,
+            params.trancheId,
+            params.amount,
+        );
+    }
+
+    /**
+     * Withdraw the entire balance from a tranche.
+     */
+    async withdrawMax(
+        poolId: string,
+        trancheId: string,
+        userAddress: string,
+    ): Promise<ContractTransaction> {
+        return await 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: `0x${string}`): KycParams {
+        return this._userLending.buildKycSignatureParams(
+            userAddress,
+            this._chainId,
+        );
+    }
+
+    /**
+     * Check whether the pool is currently in a clearing period
+     * (deposits/withdrawals are temporarily paused).
+     */
+    async isClearingPending(poolId: string): Promise<boolean> {
+        return await this._userLending.isClearingPending(poolId);
+    }
+
+    /**
+     * Get the current epoch number.
+     */
+    async getCurrentEpoch(): Promise<string> {
+        return await this._userLending.getCurrentEpoch();
+    }
+}

package/src/facade/index.ts

@@ -0,0 +1,26 @@
+// 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';
+
+// All facade types
+export type {
+    SupportedChain,
+    ChainConfigEntry,
+    KasuOptions,
+    Strategy,
+    StrategyTranche,
+    FixedTermOption,
+    DepositParams,
+    WithdrawParams,
+    DepositLimits,
+    KycParams,
+    UserPositions,
+    PlatformStats,
+} from './types';

package/src/facade/kasu.ts

@@ -0,0 +1,144 @@
+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 { ChainConfigEntry, KasuOptions, SupportedChain } 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 class Kasu {
+    /** Browse lending strategies, APY, capacity. */
+    public readonly strategies: StrategiesFacade;
+    /** Deposit, withdraw, KYC helpers. */
+    public readonly deposits: DepositsFacade;
+    /** User positions, yields, transaction history. */
+    public readonly portfolio: PortfolioFacade;
+
+    private readonly _sdk: KasuSdk;
+    private readonly _chainConfig: ChainConfigEntry;
+
+    private constructor(
+        sdk: KasuSdk,
+        chainConfig: ChainConfigEntry,
+    ) {
+        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: KasuOptions): Kasu {
+        const chainConfig = resolveChainConfig(options.chain);
+        const overrides = options.configOverrides ?? {};
+
+        const sdkConfig = new SdkConfig({
+            subgraphUrl: overrides.subgraphUrl ?? chainConfig.subgraphUrl,
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+            contracts: overrides.contracts ?? chainConfig.contracts,
+            directusUrl:
+                overrides.directusUrl ?? chainConfig.directusUrl,
+            UNUSED_LENDING_POOL_IDS:
+                overrides.UNUSED_LENDING_POOL_IDS ??
+                chainConfig.unusedPoolIds,
+            isLiteDeployment:
+                overrides.isLiteDeployment ?? chainConfig.isLiteDeployment,
+            poolMetadataMapping:
+                overrides.poolMetadataMapping ??
+                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(): KasuSdk {
+        return this._sdk;
+    }
+
+    /** The resolved chain configuration. */
+    get chainConfig(): ChainConfigEntry {
+        return this._chainConfig;
+    }
+
+    /** Whether this deployment has KSU token / locking features. */
+    get isLiteDeployment(): boolean {
+        return this._chainConfig.isLiteDeployment;
+    }
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function resolveChainConfig(
+    chain: SupportedChain | ChainConfigEntry,
+): ChainConfigEntry {
+    if (typeof chain === 'string') {
+        return CHAIN_CONFIGS[chain];
+    }
+    return chain;
+}