@kasufinance/kasu-sdk 1.0.4 → 2.1.0

package/dist/bundle.cjs.js

@@ -15616,14 +15616,6 @@ function filterArray(array, id_in) {
     }
 }
 
-const getPlumeTvl = gql `
-    {
-        lendingPools {
-            id
-            balance
-        }
-    }
-`;
 const getPoolOverviewQuery = (ids) => gql `
     query getAllPoolOverview($epochId: String!, $unusedPools: [String]!) {
         lendingPools(
@@ -15777,17 +15769,36 @@ const getLendingPoolWithdrawalAndDepositsQuery = gql `
 class DataService {
     constructor(_kasuConfig, signerOrProvider) {
         this._kasuConfig = _kasuConfig;
-        this._plumeTvl = new Map();
         this._externalTvlAbi = KasuPoolExternalTVLAbi__factory.connect(_kasuConfig.contracts.ExternalTVL, signerOrProvider);
         this._graph = new GraphQLClient(_kasuConfig.subgraphUrl);
-        this._plumeGraph = new GraphQLClient(_kasuConfig.plumeSubgraphUrl);
-        this._directus = le(_kasuConfig.directusUrl)
-            .with(ne())
-            .with(Zp());
+        if (_kasuConfig.directusUrl) {
+            this._directus = le(_kasuConfig.directusUrl)
+                .with(ne())
+                .with(Zp());
+        }
+        else {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-explicit-any
+            this._directus = null;
+        }
     }
     getUrlFromFile(fileName) {
         return `${this._kasuConfig.directusUrl}assets/${fileName}`;
     }
+    /**
+     * Maps a pool ID to its metadata source pool ID.
+     * Used for chains (XDC, Plume) that share Directus metadata with Base pools.
+     */
+    getMetadataPoolId(poolId) {
+        var _a;
+        const normalizedId = poolId.toLowerCase();
+        return (_a = this._kasuConfig.poolMetadataMapping[normalizedId]) !== null && _a !== void 0 ? _a : normalizedId;
+    }
+    /**
+     * Maps an array of pool IDs to their metadata source pool IDs.
+     */
+    getMetadataPoolIds(poolIds) {
+        return poolIds.map((id) => this.getMetadataPoolId(id));
+    }
     calculatePoolCapacity(poolCapacities, poolCapacityPercentages, index, spillOver, lendingPoolSubgraph, lendingPoolConfig) {
         const desiredDrawAmount = lendingPoolConfig.desiredDrawAmount; // subgraph
         const desiredTrancheRatio = lendingPoolConfig.tranchesConfig[index].desiredRatio;
@@ -15845,7 +15856,7 @@ class DataService {
     }
     getPoolOverview(epochId, id_in) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c;
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
             const trancheNames = [
                 ['Senior'],
                 ['Junior', 'Senior'],
@@ -15855,29 +15866,39 @@ class DataService {
                 unusedPools: this._kasuConfig.UNUSED_LENDING_POOL_IDS,
                 epochId,
             });
-            if (!this._plumeTvl.size) {
-                const plumeResults = yield this._plumeGraph.request(getPlumeTvl);
-                for (const pool of plumeResults.lendingPools) {
-                    this._plumeTvl.set(pool.id, pool.balance);
-                }
-            }
             if (!this._directusPoolOverview) {
-                this._directusPoolOverview = yield this._directus.request(bs('PoolOverview', {
-                    filter: {
-                        enabled: {
-                            _eq: true,
-                        },
-                    },
-                }));
+                if (this._kasuConfig.directusUrl) {
+                    try {
+                        this._directusPoolOverview = yield this._directus.request(bs('PoolOverview', {
+                            filter: {
+                                enabled: {
+                                    _eq: true,
+                                },
+                            },
+                        }));
+                    }
+                    catch (error) {
+                        console.warn('Directus fetch failed, falling back to on-chain data only:', error);
+                        this._directusPoolOverview = [];
+                    }
+                }
+                else {
+                    this._directusPoolOverview = [];
+                }
             }
             const offchainTvlMap = yield this.getOffChainTvl(poolOverviewResults.lendingPools.map(({ id }) => id));
             const retn = [];
             for (const lendingPoolSubgraph of poolOverviewResults.lendingPools) {
-                const lendingPoolDirectus = this._directusPoolOverview.find((r) => r.id.toLowerCase() == lendingPoolSubgraph.id);
+                // Use metadata mapping if available (for XDC/Plume pools that share metadata with Base)
+                const metadataPoolId = (_a = this._kasuConfig.poolMetadataMapping[lendingPoolSubgraph.id]) !== null && _a !== void 0 ? _a : lendingPoolSubgraph.id;
+                const lendingPoolDirectus = this._directusPoolOverview.find((r) => r.id.toLowerCase() === metadataPoolId);
                 const lendingPoolConfig = lendingPoolSubgraph.configuration;
                 if (!lendingPoolDirectus) {
-                    console.warn("Couldn't find directus pool for id: ", lendingPoolSubgraph.id);
-                    continue;
+                    console.warn("Couldn't find directus pool for id: ", lendingPoolSubgraph.id, metadataPoolId !== lendingPoolSubgraph.id
+                        ? `(mapped from ${metadataPoolId})`
+                        : '');
+                    // When Directus is unavailable or pool has no CMS entry,
+                    // use a fallback so the pool is still returned with on-chain data.
                 }
                 const poolCapacities = this.calculatePoolCapacity([], [], 0, 0, lendingPoolSubgraph, lendingPoolConfig);
                 const tranches = lendingPoolSubgraph.tranches
@@ -15944,49 +15965,50 @@ class DataService {
                         : parseFloat(tranche.balance) / trancheBalanceSum;
                     averageApy += parseFloat(trancheData.averageApy) * weight;
                 }
-                const plumeTvl = lendingPoolDirectus.plumeStrategy &&
-                    this._plumeTvl.has(lendingPoolDirectus.plumeStrategy)
-                    ? (_a = this._plumeTvl.get(lendingPoolDirectus.plumeStrategy)) !== null && _a !== void 0 ? _a : '0'
-                    : '0';
                 const offChainTvl = (_b = offchainTvlMap.get(lendingPoolSubgraph.id)) !== null && _b !== void 0 ? _b : '0';
                 const poolOverview = {
                     id: lendingPoolSubgraph.id,
-                    security: lendingPoolDirectus.security,
-                    enabled: lendingPoolDirectus.enabled,
-                    isOversubscribed: lendingPoolDirectus.oversubscribed,
+                    security: (_c = lendingPoolDirectus === null || lendingPoolDirectus === void 0 ? void 0 : lendingPoolDirectus.security) !== null && _c !== void 0 ? _c : [],
+                    enabled: (_d = lendingPoolDirectus === null || lendingPoolDirectus === void 0 ? void 0 : lendingPoolDirectus.enabled) !== null && _d !== void 0 ? _d : true,
+                    isOversubscribed: (_e = lendingPoolDirectus === null || lendingPoolDirectus === void 0 ? void 0 : lendingPoolDirectus.oversubscribed) !== null && _e !== void 0 ? _e : false,
                     apy: averageApy,
-                    description: lendingPoolDirectus.description,
-                    liteDescription: lendingPoolDirectus.liteDescription,
-                    thumbnailImageUrl: this.getUrlFromFile(lendingPoolDirectus.thumbnailImage),
-                    bannerImageUrl: this.getUrlFromFile(lendingPoolDirectus.bannerImage),
-                    strategyDeckUrl: this.getUrlFromFile(lendingPoolDirectus.strategyDeck),
-                    assetClass: lendingPoolDirectus.assetClass,
-                    industryExposure: lendingPoolDirectus.industryExposure,
-                    poolApyStructure: lendingPoolDirectus.poolApyStructure,
-                    apyExpiryDate: lendingPoolDirectus.apyExpiryDate,
-                    poolInvestmentTerm: lendingPoolDirectus.poolInvestmentTerm,
-                    loanStructure: lendingPoolDirectus.loanStructure,
-                    poolName: (_c = lendingPoolDirectus.poolName) !== null && _c !== void 0 ? _c : lendingPoolSubgraph.name,
-                    subheading: lendingPoolDirectus.subheading,
+                    description: (_f = lendingPoolDirectus === null || lendingPoolDirectus === void 0 ? void 0 : lendingPoolDirectus.description) !== null && _f !== void 0 ? _f : '',
+                    liteDescription: (_g = lendingPoolDirectus === null || lendingPoolDirectus === void 0 ? void 0 : lendingPoolDirectus.liteDescription) !== null && _g !== void 0 ? _g : '',
+                    thumbnailImageUrl: (lendingPoolDirectus === null || lendingPoolDirectus === void 0 ? void 0 : lendingPoolDirectus.thumbnailImage)
+                        ? this.getUrlFromFile(lendingPoolDirectus.thumbnailImage)
+                        : '',
+                    bannerImageUrl: (lendingPoolDirectus === null || lendingPoolDirectus === void 0 ? void 0 : lendingPoolDirectus.bannerImage)
+                        ? this.getUrlFromFile(lendingPoolDirectus.bannerImage)
+                        : '',
+                    strategyDeckUrl: (lendingPoolDirectus === null || lendingPoolDirectus === void 0 ? void 0 : lendingPoolDirectus.strategyDeck)
+                        ? this.getUrlFromFile(lendingPoolDirectus.strategyDeck)
+                        : '',
+                    assetClass: (_h = lendingPoolDirectus === null || lendingPoolDirectus === void 0 ? void 0 : lendingPoolDirectus.assetClass) !== null && _h !== void 0 ? _h : '',
+                    industryExposure: (_j = lendingPoolDirectus === null || lendingPoolDirectus === void 0 ? void 0 : lendingPoolDirectus.industryExposure) !== null && _j !== void 0 ? _j : '',
+                    poolApyStructure: (_k = lendingPoolDirectus === null || lendingPoolDirectus === void 0 ? void 0 : lendingPoolDirectus.poolApyStructure) !== null && _k !== void 0 ? _k : 'Variable',
+                    apyExpiryDate: (_l = lendingPoolDirectus === null || lendingPoolDirectus === void 0 ? void 0 : lendingPoolDirectus.apyExpiryDate) !== null && _l !== void 0 ? _l : null,
+                    poolInvestmentTerm: (_m = lendingPoolDirectus === null || lendingPoolDirectus === void 0 ? void 0 : lendingPoolDirectus.poolInvestmentTerm) !== null && _m !== void 0 ? _m : '',
+                    loanStructure: (_o = lendingPoolDirectus === null || lendingPoolDirectus === void 0 ? void 0 : lendingPoolDirectus.loanStructure) !== null && _o !== void 0 ? _o : '',
+                    poolName: (_p = lendingPoolDirectus === null || lendingPoolDirectus === void 0 ? void 0 : lendingPoolDirectus.poolName) !== null && _p !== void 0 ? _p : lendingPoolSubgraph.name,
+                    subheading: lendingPoolDirectus === null || lendingPoolDirectus === void 0 ? void 0 : lendingPoolDirectus.subheading,
                     totalValueLocked: {
                         total: (parseFloat(lendingPoolSubgraph.balance) +
-                            parseFloat(plumeTvl) +
                             parseFloat(offChainTvl)).toString(),
                         offchain: offChainTvl,
-                        plume: plumeTvl,
                     },
-                    loansUnderManagement: lendingPoolDirectus.loansUnderManagement,
+                    loansUnderManagement: (_q = lendingPoolDirectus === null || lendingPoolDirectus === void 0 ? void 0 : lendingPoolDirectus.loansUnderManagement) !== null && _q !== void 0 ? _q : '0',
                     yieldEarned: lendingPoolSubgraph.totalUserInterestAmount,
                     poolCapacity: poolCapacitySum.toString(),
                     poolCapacityPercentage: poolCapacityPercentageSum.toString(),
-                    activeLoans: lendingPoolDirectus.activeLoans,
-                    loanFundsOriginated: lendingPoolDirectus.loanFundsOriginated,
+                    activeLoans: (_r = lendingPoolDirectus === null || lendingPoolDirectus === void 0 ? void 0 : lendingPoolDirectus.activeLoans) !== null && _r !== void 0 ? _r : '0',
+                    loanFundsOriginated: (_s = lendingPoolDirectus === null || lendingPoolDirectus === void 0 ? void 0 : lendingPoolDirectus.loanFundsOriginated) !== null && _s !== void 0 ? _s : '0',
                     tranches: tranches,
                     isActive: !lendingPoolSubgraph.isStopped,
                     requestEpochsInAdvance: lendingPoolSubgraph.configuration
                         .lendingPoolWithdrawalConfig.requestEpochsInAdvance,
                 };
-                // show only enabled pools from cms
+                // When Directus is available, show only enabled pools.
+                // When Directus is unavailable, include all pools.
                 if (poolOverview.enabled) {
                     retn.push(poolOverview);
                 }
@@ -16206,7 +16228,11 @@ class DataService {
             const lendingPoolsWithdrawalsAndDepositsSubgraph = yield this._graph.request(getLendingPoolWithdrawalAndDepositsQuery, { unusedPools: this._kasuConfig.UNUSED_LENDING_POOL_IDS });
             const retn = [];
             for (const data of poolRepaymentDirectus) {
-                const lendingPoolSubgraph = lendingPoolsWithdrawalsAndDepositsSubgraph.lendingPools.find((pool) => pool.id == data.poolIdFK);
+                // Find subgraph pool that maps to this Directus pool
+                // On non-Base chains, subgraph pool IDs are different from Directus poolIdFK
+                // Use getMetadataPoolId to map subgraph pool ID -> Directus/Base pool ID
+                const lendingPoolSubgraph = lendingPoolsWithdrawalsAndDepositsSubgraph.lendingPools.find((pool) => this.getMetadataPoolId(pool.id) ===
+                    data.poolIdFK.toLowerCase());
                 if (lendingPoolSubgraph === undefined) {
                     continue;
                 }
@@ -16295,9 +16321,13 @@ class DataService {
                 retn.totalYieldEarned += parseFloat(poolOverview.yieldEarned);
             }
             for (const poolOverview of poolOverviews) {
-                const riskManagement = riskManagements.find((rm) => rm.poolIdFK.toLowerCase() === poolOverview.id.toLowerCase());
+                // Map to metadata pool ID for Directus lookup (XDC pools → Base pools)
+                const metadataPoolId = this.getMetadataPoolId(poolOverview.id);
+                const riskManagement = riskManagements.find((rm) => rm.poolIdFK.toLowerCase() === metadataPoolId.toLowerCase());
                 if (!riskManagement) {
-                    console.warn("Couldn't find risk management for id: ", poolOverview.id);
+                    console.warn("Couldn't find risk management for id: ", poolOverview.id, metadataPoolId !== poolOverview.id
+                        ? `(mapped to ${metadataPoolId})`
+                        : '');
                     continue;
                 }
                 const weight = retn.totalLoanFundsOriginated === 0
@@ -16335,14 +16365,18 @@ class DataService {
 }
 
 class KSULocking {
-    /**
-     *
-     */
     constructor(_kasuConfig, signerOrProvider) {
         this._kasuConfig = _kasuConfig;
         this.apyBonuses = [0, 0.001, 0.002];
+        this._isLiteDeployment = _kasuConfig.isLiteDeployment;
         this._contractAbi = IKSULockingAbi__factory.connect(_kasuConfig.contracts.IKSULocking, signerOrProvider);
-        this._kasuToken = IERC20MetadataAbi__factory.connect(_kasuConfig.contracts.KSUToken, signerOrProvider);
+        // Only initialize KSU token contract if not a Lite deployment and address is provided
+        if (!this._isLiteDeployment && _kasuConfig.contracts.KSUToken) {
+            this._kasuToken = IERC20MetadataAbi__factory.connect(_kasuConfig.contracts.KSUToken, signerOrProvider);
+        }
+        else {
+            this._kasuToken = null;
+        }
         this._userManagerAbi = IUserManagerAbi__factory.connect(_kasuConfig.contracts.UserManager, signerOrProvider);
         this._systemVariablesAbi = ISystemVariablesAbi__factory.connect(_kasuConfig.contracts.SystemVariables, signerOrProvider);
         this._ksuPriceAbi = IKsuPriceAbi__factory.connect(_kasuConfig.contracts.KsuPrice, signerOrProvider);
@@ -16350,13 +16384,25 @@ class KSULocking {
         this._graph = new GraphQLClient(_kasuConfig.subgraphUrl);
         this._userLoyaltyRewardsAbi = IUserLoyaltyRewardsAbi__factory.connect(_kasuConfig.contracts.UserLoyaltyRewards, signerOrProvider);
     }
+    /**
+     * Check if this is a Lite deployment (no KSU token functionality)
+     */
+    get isLiteDeployment() {
+        return this._isLiteDeployment;
+    }
     lockKSUTokens(amount, lockPeriod) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._isLiteDeployment) {
+                throw new Error('Locking is not available on Lite deployments');
+            }
             return this._contractAbi.lock(amount, lockPeriod);
         });
     }
     lockKSUWithPermit(amount, lockPeriod, permit) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._isLiteDeployment) {
+                throw new Error('Locking is not available on Lite deployments');
+            }
             const amountBN = ethers.BigNumber.from(amount);
             const lockPeriodBN = ethers.BigNumber.from(lockPeriod);
             const ksuPermit = {
@@ -16371,16 +16417,29 @@ class KSULocking {
     }
     unlockKSU(amount, userLockId) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._isLiteDeployment) {
+                throw new Error('Locking is not available on Lite deployments');
+            }
             return this._contractAbi.unlock(amount, userLockId);
         });
     }
     claimFees() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._isLiteDeployment) {
+                throw new Error('Fee claiming is not available on Lite deployments');
+            }
             return yield this._contractAbi.claimFees();
         });
     }
     lockDetails(lockPeriod) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._isLiteDeployment) {
+                return {
+                    rKsuMultiplier: 0,
+                    ksuBonusMultiplier: 0,
+                    isActive: false,
+                };
+            }
             const result = yield this._contractAbi.lockDetails(lockPeriod);
             return {
                 rKsuMultiplier: result[0].toNumber(),
@@ -16391,12 +16450,15 @@ class KSULocking {
     }
     userTotalDeposits(userAddress) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._isLiteDeployment) {
+                return ethers.BigNumber.from(0);
+            }
             return yield this._contractAbi.userTotalDeposits(userAddress);
         });
     }
     calculateUserLockProjectedProtocolFeeRewards(epochId, KSULocked, lockPeriod) {
         return __awaiter(this, void 0, void 0, function* () {
-            if (KSULocked === 0) {
+            if (this._isLiteDeployment || KSULocked === 0) {
                 return 0;
             }
             const lockingSummarySubgraph = yield this._graph.request(lockingSummariesQuery);
@@ -16442,6 +16504,9 @@ class KSULocking {
     }
     getUserLocks(userAddress) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._isLiteDeployment) {
+                return [];
+            }
             const result = yield this._graph.request(userLocksQuery, {
                 userAddress: userAddress.toLowerCase(),
             });
@@ -16467,8 +16532,14 @@ class KSULocking {
     }
     getUserBonusData(userAddress) {
         return __awaiter(this, void 0, void 0, function* () {
-            // TODO this userLocks query is kinda bad -> change to userLocksDepositInfo as u never need user locks by themselves
-            // whole function takes between 500 - 800ms
+            if (this._isLiteDeployment) {
+                return {
+                    ksuBonusAndRewards: '0',
+                    ksuBonusAndRewardsLifetime: '0',
+                    protocolFeesEarned: '0',
+                    totalLockedAmount: '0',
+                };
+            }
             const DECIMALS = 18;
             // Normalized user address
             const normalizedAddress = userAddress.toLowerCase();
@@ -16501,6 +16572,10 @@ class KSULocking {
         });
     }
     getLoyaltyLevelAndApyBonusFromRatio(rKSUtoUSDCRatio) {
+        // On Lite deployments, always return level 0 with no bonus
+        if (this._isLiteDeployment) {
+            return { loyaltyLevel: 0, apyBonus: 0 };
+        }
         if (rKSUtoUSDCRatio < 0.01) {
             return { loyaltyLevel: 0, apyBonus: this.apyBonuses[0] };
         }
@@ -16511,6 +16586,9 @@ class KSULocking {
     }
     getRKSUvsUSDCRatio(rKSUAmount, userAddress) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._isLiteDeployment) {
+                return 0;
+            }
             const [depositedAmount, pendingAmount] = yield this._userManagerAbi.userTotalPendingAndActiveDepositedAmountForCurrentEpoch(userAddress);
             const ksuPrice = yield this._systemVariablesAbi.ksuEpochTokenPrice();
             const rKSUAmountBignumber = ethers.ethers.utils.parseUnits(rKSUAmount, 18);
@@ -16524,6 +16602,9 @@ class KSULocking {
     }
     getClaimableRewards(userAddress) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._isLiteDeployment) {
+                return ethers.BigNumber.from(0);
+            }
             const result = yield this._contractAbi.rewards(userAddress);
             return result;
         });
@@ -16531,6 +16612,7 @@ class KSULocking {
     getKasuTokenPrice() {
         return __awaiter(this, void 0, void 0, function* () {
             const decimals = 18;
+            // Price can still be queried on Lite deployments (set to 0 or configured value)
             return Promise.resolve({
                 price: yield this._ksuPriceAbi.ksuTokenPrice(),
                 decimals,
@@ -16549,6 +16631,9 @@ class KSULocking {
     getLifetimeRewards(userAddress, rewardDecimals, claimableRewards) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b;
+            if (this._isLiteDeployment) {
+                return ethers.BigNumber.from(0);
+            }
             const result = yield this._graph.request(claimedFeesQuery, {
                 userAddress: userAddress.toLowerCase(),
             });
@@ -16560,6 +16645,9 @@ class KSULocking {
         });
     }
     getLaunchBonusAmount(lockAmount, bonusMultiplier, bonusTokensLeft) {
+        if (this._isLiteDeployment) {
+            return ethers.BigNumber.from(0);
+        }
         const bonusMultiplierBN = ethers.ethers.utils.parseUnits(bonusMultiplier.toFixed(2), 2);
         const projectedBonus = lockAmount.mul(bonusMultiplierBN).div(100);
         if (bonusTokensLeft.gt(projectedBonus)) {
@@ -16571,6 +16659,9 @@ class KSULocking {
     }
     getUserStakedKsu(userAddress) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._isLiteDeployment) {
+                return '0';
+            }
             const result = yield this._graph.request(userStakedKsuQuery, {
                 userAddress: userAddress.toLowerCase(),
             });
@@ -16582,6 +16673,9 @@ class KSULocking {
     }
     getUserEarnedrKsu(userAddress) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._isLiteDeployment) {
+                return '0';
+            }
             const result = yield this._graph.request(userEarnedrKsuQuery, {
                 userAddress: userAddress.toLowerCase(),
             });
@@ -16593,6 +16687,9 @@ class KSULocking {
     }
     getUserTotalBonusAmount(userAddress) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._isLiteDeployment) {
+                return '0';
+            }
             const result = yield this._graph.request(userTotalBonusAmountQuery, {
                 userAddress: userAddress.toLowerCase(),
             });
@@ -16604,6 +16701,12 @@ class KSULocking {
     }
     getLockingRewards(userAddress) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._isLiteDeployment) {
+                return {
+                    claimableRewards: '0',
+                    lifeTimeRewards: '0',
+                };
+            }
             const rewardDecimals = 6;
             const claimableRewards = yield this.getClaimableRewards(userAddress);
             const lifeTimeRewards = yield this.getLifetimeRewards(userAddress, rewardDecimals, claimableRewards);
@@ -16620,12 +16723,18 @@ class KSULocking {
     }
     getAvailableKsuBonus() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._isLiteDeployment || !this._kasuToken) {
+                return '0';
+            }
             const amount = yield this._kasuToken.balanceOf(this._kasuBonusAddress);
             return utils$2.formatEther(amount);
         });
     }
     getUserKsuBalance(userAddress) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._isLiteDeployment || !this._kasuToken) {
+                return '0';
+            }
             const balance = yield this._kasuToken.balanceOf(userAddress.toLowerCase());
             return utils$2.formatEther(balance);
         });
@@ -16652,6 +16761,9 @@ class KSULocking {
     }
     getActiveLockPeriods() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._isLiteDeployment) {
+                return [];
+            }
             const data = yield this._graph.request(lockingPeriodsQuery);
             return data.lockPeriods;
         });
@@ -16664,6 +16776,14 @@ class KSULocking {
     }
 }
 
+/**
+ * Check if the SDK is configured for a Lite deployment.
+ * Lite deployments don't have KSU token, locking, or loyalty features.
+ */
+function isLiteDeployment(config) {
+    return config.isLiteDeployment;
+}
+
 const USER_REQUEST_EVENT_MAP = {
     DepositAccepted: 'Accepted',
     DepositCancelled: 'Cancelled',
@@ -17516,7 +17636,10 @@ class Portfolio {
         this._systemVariablesAbi = ISystemVariablesAbi__factory.connect(_kasuConfig.contracts.SystemVariables, signerOrProvider);
         this._userLoyaltyRewardsAbi = IUserLoyaltyRewardsAbi__factory.connect(_kasuConfig.contracts.UserLoyaltyRewards, signerOrProvider);
         this._userLendingService = new UserLending(_kasuConfig, signerOrProvider);
-        this._kasuNftContract = IKasuNFTsAbi__factory.connect(_kasuConfig.contracts.KasuNFTs, signerOrProvider);
+        this._isLiteDeployment = isLiteDeployment(_kasuConfig);
+        this._kasuNftContract = _kasuConfig.contracts.KasuNFTs
+            ? IKasuNFTsAbi__factory.connect(_kasuConfig.contracts.KasuNFTs, signerOrProvider)
+            : null;
         this._graph = new GraphQLClient(_kasuConfig.subgraphUrl);
     }
     computeYieldMetrics(portfolioLendingPools) {
@@ -17644,6 +17767,10 @@ class Portfolio {
     }
     getUserNfts(userAddress) {
         return __awaiter(this, void 0, void 0, function* () {
+            // NFTs are not available on Lite deployments
+            if (this._isLiteDeployment || !this._kasuNftContract) {
+                return [];
+            }
             const usernfts = yield this._kasuNftContract.tokensOfOwner(userAddress);
             return usernfts.map((nft) => nft.toNumber());
         });
@@ -21744,4 +21871,426 @@ class KasuSdk {
     }
 }
 
+class SdkConfig {
+    constructor(options) {
+        var _a, _b, _c;
+        this.subgraphUrl = options.subgraphUrl;
+        this.contracts = options.contracts;
+        this.directusUrl = (_a = options.directusUrl) !== null && _a !== void 0 ? _a : '';
+        this.UNUSED_LENDING_POOL_IDS = options.UNUSED_LENDING_POOL_IDS;
+        this.isLiteDeployment = (_b = options.isLiteDeployment) !== null && _b !== void 0 ? _b : false;
+        this.poolMetadataMapping = (_c = options.poolMetadataMapping) !== null && _c !== void 0 ? _c : {};
+    }
+}
+
+/**
+ * Built-in chain configurations for Kasu-supported networks.
+ *
+ * Usage:
+ * ```ts
+ * import { CHAIN_CONFIGS } from '@kasufinance/kasu-sdk';
+ * const base = CHAIN_CONFIGS.base;
+ * ```
+ */
+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,
+    },
+};
+
+/**
+ * High-level facade for deposit and withdrawal operations.
+ *
+ * Integrators use this to submit on-chain transactions without
+ * worrying about internal encoding details.
+ */
+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),
+     *   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 USDC amount.
+     */
+    withdraw(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this._userLending.requestWithdrawalInUSDC(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();
+        });
+    }
+}
+
+/**
+ * High-level facade for browsing Kasu lending strategies (pools).
+ *
+ * Handles epoch fetching internally so callers never need to know about epochs.
+ */
+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,
+        };
+    }
+}
+
+/**
+ * High-level facade for querying a user's portfolio, positions, and history.
+ *
+ * Orchestrates DataService, UserLending, and Portfolio services so the caller
+ * only needs to provide a wallet address.
+ */
+class PortfolioFacade {
+    constructor(_dataService, _userLending, _portfolio) {
+        this._dataService = _dataService;
+        this._userLending = _userLending;
+        this._portfolio = _portfolio;
+    }
+    /**
+     * Fetch a user's complete portfolio: per-pool positions and aggregate summary.
+     *
+     * ```ts
+     * const positions = await kasu.portfolio.getPositions('0xUser...');
+     * console.log(positions.summary.current.totalLendingPoolInvestments);
+     * ```
+     *
+     * @param userAddress - Wallet address.
+     * @param provider    - Optional separate provider for balance queries (useful when the
+     *                      SDK was initialised with a Signer but you need a read-only provider).
+     */
+    getPositions(userAddress, provider) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const currentEpoch = yield this._userLending.getCurrentEpoch();
+            const poolOverviews = yield this._dataService.getPoolOverview(currentEpoch);
+            const pools = yield this._portfolio.getPortfolioLendingData(userAddress, poolOverviews, currentEpoch, provider);
+            const summary = yield this._portfolio.getPortfolioSummary(userAddress, pools, currentEpoch);
+            return { pools, summary };
+        });
+    }
+    /**
+     * Fetch a user's full transaction history (deposits, withdrawals, cancellations).
+     */
+    getTransactionHistory(userAddress) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const currentEpoch = yield this._userLending.getCurrentEpoch();
+            return yield this._userLending.getUserRequests(userAddress, currentEpoch);
+        });
+    }
+}
+
+/**
+ * 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);
+ * ```
+ */
+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;
+}
+
+exports.CHAIN_CONFIGS = CHAIN_CONFIGS;
+exports.DepositsFacade = DepositsFacade;
+exports.Kasu = Kasu;
 exports.KasuSdk = KasuSdk;
+exports.PortfolioFacade = PortfolioFacade;
+exports.SdkConfig = SdkConfig;
+exports.StrategiesFacade = StrategiesFacade;