@curvefi/llamalend-api 1.0.30 → 1.0.32

package/README.md

@@ -891,6 +891,45 @@ import llamalend from "@curvefi/llamalend-api";
 })()
 ```
 
+### Force Update User State for lendMarket
+
+After executing certain transactions, it's recommended to force update the user's state in the cache to ensure data consistency:
+
+```ts
+// Methods after which you should call forceUpdateUserState:
+// - createLoan()
+// - leverage.createLoan()
+// - borrowMore()
+// - partialSelfLiquidate()
+// - repay()
+
+// Basic usage (after successful transaction):
+const txHash = await lendMarket.createLoan(0.5, 1000, 5);
+// Wait for transaction to be mined and confirmed
+await lendMarket.forceUpdateUserState(txHash);
+
+// With specific user address:
+await lendMarket.forceUpdateUserState(txHash, "0x123...");
+
+// The method sends a request with new_tx parameter and clears the cache
+// to get fresh user state data
+// Important: Only call after successful transaction confirmation
+```
+
+**Why use forceUpdateUserState?**
+- Ensures data consistency after successful transactions
+- Clears cached user state data
+- Forces fresh API request with transaction hash
+- Prevents stale data issues
+- **Important**: Only call after transaction is successfully mined and confirmed
+
+**When to use:**
+- After `createLoan()` - when creating a new loan
+- After `leverage.createLoan()` - when creating a leveraged position
+- After `borrowMore()` - when increasing loan amount
+- After `partialSelfLiquidate()` - when partially liquidating position
+- After `repay()` - when repaying loan
+
 ### User loss for lendMarket
 ```ts
 (async () => {
@@ -2360,4 +2399,5 @@ import llamalend from "@curvefi/llamalend-api";
     //
     //     '50': [ '759.898822708156242647', '1560.282492846180089068' ]
     // }
-```
+```
+

package/lib/external-api.d.ts

@@ -11,6 +11,7 @@ type UserCollateral = {
     total_deposit_from_user_usd_value: number;
 };
 export declare const _getUserCollateral: ((network: INetworkName, controller: string, user: string) => Promise<UserCollateral>) & memoize.Memoized<(network: INetworkName, controller: string, user: string) => Promise<UserCollateral>>;
+export declare const _getUserCollateralForce: (network: INetworkName, controller: string, user: string, newTx: string) => Promise<void>;
 export declare const _getUserCollateralCrvUsd: ((network: INetworkName, controller: string, user: string) => Promise<string>) & memoize.Memoized<(network: INetworkName, controller: string, user: string) => Promise<string>>;
 export declare const _getMarketsData: ((network: INetworkName) => Promise<IMarketData>) & memoize.Memoized<(network: INetworkName) => Promise<IMarketData>>;
 export declare function _getQuoteOdos(this: Llamalend, fromToken: string, toToken: string, _amount: bigint, blacklist: string, pathVizImage: boolean, slippage?: number): Promise<IQuoteOdos>;

package/lib/external-api.js

@@ -124,6 +124,10 @@ export const _getUserCollateral = memoize((network, controller, user) => __await
     promise: true,
     maxAge: 60 * 1000, // 1m
 });
+export const _getUserCollateralForce = (network, controller, user, newTx) => __awaiter(void 0, void 0, void 0, function* () {
+    yield fetch(`https://prices.curve.finance/v1/lending/collateral_events/${network}/${controller}/${user}?new_tx=${newTx}`);
+    _getUserCollateral.delete(network, controller, user);
+});
 export const _getUserCollateralCrvUsd = memoize((network, controller, user) => __awaiter(void 0, void 0, void 0, function* () {
     const url = `https://prices.curve.finance/v1/crvusd/collateral_events/${network}/${controller}/${user}`;
     const response = yield fetch(url);

package/lib/lendMarkets/LendMarketTemplate.d.ts

@@ -519,4 +519,5 @@ export declare class LendMarketTemplate {
     currentLeverage(userAddress?: string): Promise<string>;
     currentPnL(userAddress?: string): Promise<Record<string, string>>;
     userBoost(address?: string): Promise<string>;
+    forceUpdateUserState(newTx: string, userAddress?: string): Promise<void>;
 }

package/lib/lendMarkets/LendMarketTemplate.js

@@ -10,7 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import memoize from "memoizee";
 import BigNumber from "bignumber.js";
 import { _getAddress, parseUnits, BN, toBN, fromBN, getBalances, _ensureAllowance, ensureAllowance, hasAllowance, ensureAllowanceEstimateGas, _cutZeros, formatUnits, formatNumber, MAX_ALLOWANCE, MAX_ACTIVE_BAND, _mulBy1_3, _getUsdRate, DIGas, smartNumber, } from "../utils.js";
-import { _getExpectedOdos, _getQuoteOdos, _assembleTxOdos, _getUserCollateral, _getMarketsData } from "../external-api.js";
+import { _getExpectedOdos, _getQuoteOdos, _assembleTxOdos, _getUserCollateral, _getUserCollateralForce, _getMarketsData } from "../external-api.js";
 import ERC20Abi from '../constants/abis/ERC20.json' with { type: 'json' };
 import { cacheKey, cacheStats } from "../cache/index.js";
 const DAY = 86400;
@@ -2799,4 +2799,12 @@ export class LendMarketTemplate {
             return boostBN.toFixed(4).replace(/([0-9])0+$/, '$1');
         });
     }
+    forceUpdateUserState(newTx, userAddress) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const address = userAddress || this.llamalend.signerAddress;
+            if (!address)
+                throw Error("Need to connect wallet or pass address into args");
+            yield _getUserCollateralForce(this.llamalend.constants.NETWORK_NAME, this.addresses.controller, address, newTx);
+        });
+    }
 }

package/lib/lendMarkets/lendMarketConstructor.js

@@ -1,5 +1,10 @@
 import { LendMarketTemplate } from "./LendMarketTemplate.js";
 export const getLendMarket = function (lendMarketId) {
-    const marketData = this.constants.ONE_WAY_MARKETS[lendMarketId];
-    return new LendMarketTemplate(lendMarketId, marketData, this);
+    if (!(lendMarketId in this.lendMarkets)) {
+        const marketData = this.constants.ONE_WAY_MARKETS[lendMarketId];
+        if (!marketData)
+            throw new Error(`Lend market with id ${lendMarketId} not found`);
+        this.lendMarkets[lendMarketId] = new LendMarketTemplate(lendMarketId, marketData, this);
+    }
+    return this.lendMarkets[lendMarketId];
 };

package/lib/llamalend.d.ts

@@ -1,6 +1,8 @@
 import { ethers, Networkish, BigNumberish, Numeric } from "ethers";
 import { Provider as MulticallProvider } from '@curvefi/ethcall';
 import { IChainId, ILlamalend, ILlamma, IDict, INetworkName, ICurveContract, IOneWayMarket, ICoin } from "./interfaces.js";
+import { MintMarketTemplate } from "./mintMarkets";
+import { LendMarketTemplate } from "./lendMarkets";
 export declare const NETWORK_CONSTANTS: {
     [index: number]: any;
 };
@@ -15,6 +17,12 @@ declare class Llamalend implements ILlamalend {
     contracts: {
         [index: string]: ICurveContract;
     };
+    mintMarkets: {
+        [addres: string]: MintMarketTemplate;
+    };
+    lendMarkets: {
+        [addres: string]: LendMarketTemplate;
+    };
     feeData: {
         gasPrice?: number;
         maxFeePerGas?: number;

package/lib/llamalend.js

@@ -352,6 +352,8 @@ class Llamalend {
         this.chainId = 1;
         this.multicallProvider = null;
         this.contracts = {};
+        this.mintMarkets = {};
+        this.lendMarkets = {};
         this.feeData = {};
         this.constantOptions = { gasLimit: 12000000 };
         this.options = {};

package/lib/mintMarkets/MintMarketTemplate.d.ts

@@ -1,6 +1,6 @@
 import memoize from "memoizee";
 import type { Llamalend } from "../llamalend.js";
-import { IDict, TGas } from "../interfaces";
+import { IDict, ILlamma, TGas } from "../interfaces";
 import { ILeverageV2 } from "./interfaces/leverage.js";
 export declare class MintMarketTemplate {
     private llamalend;
@@ -132,7 +132,7 @@ export declare class MintMarketTemplate {
             repay: (collateral: number | string, slippage?: number) => Promise<number>;
         };
     };
-    constructor(id: string, llamalend: Llamalend);
+    constructor(id: string, llammaData: ILlamma, llamalend: Llamalend);
     statsParameters: (() => Promise<{
         fee: string;
         admin_fee: string;

package/lib/mintMarkets/MintMarketTemplate.js

@@ -13,7 +13,7 @@ import { _getAddress, parseUnits, BN, toBN, fromBN, getBalances, ensureAllowance
 import { _getUserCollateralCrvUsd } from "../external-api.js";
 import { LeverageV2Module } from "./modules";
 export class MintMarketTemplate {
-    constructor(id, llamalend) {
+    constructor(id, llammaData, llamalend) {
         var _a;
         // ---------------- STATS ----------------
         this.statsParameters = memoize(() => __awaiter(this, void 0, void 0, function* () {
@@ -237,7 +237,6 @@ export class MintMarketTemplate {
             maxAge: 5 * 60 * 1000, // 5m
         });
         this.llamalend = llamalend;
-        const llammaData = this.llamalend.constants.LLAMMAS[id];
         this.id = id;
         this.address = llammaData.amm_address;
         this.controller = llammaData.controller_address;

package/lib/mintMarkets/mintMarketConstructor.js

@@ -1,4 +1,10 @@
 import { MintMarketTemplate } from "./MintMarketTemplate";
 export const getMintMarket = function (mintMarketId) {
-    return new MintMarketTemplate(mintMarketId, this);
+    if (!(mintMarketId in this.mintMarkets)) {
+        const llammaData = this.constants.LLAMMAS[mintMarketId];
+        if (!llammaData)
+            throw new Error(`No market with id ${mintMarketId} found`);
+        this.mintMarkets[mintMarketId] = new MintMarketTemplate(mintMarketId, llammaData, this);
+    }
+    return this.mintMarkets[mintMarketId];
 };

package/lib/mintMarkets/modules/leverageV2.js

@@ -93,7 +93,7 @@ export class LeverageV2Module {
             const key = `${inputCoinAddress}-${_amount}`;
             if (!(key in this.swapDataCache))
                 throw Error("You must call corresponding `expected` method first " +
-                    "(leverage.createLoanExpectedCollateral, leverage.borrowMoreExpectedCollateral or leverage.repayExpectedBorrowed)");
+                    "(leverageV2.createLoanExpectedCollateral, leverageV2.borrowMoreExpectedCollateral or leverageV2.repayExpectedBorrowed)");
             return this.swapDataCache[key];
         };
         this._leverageExpectedCollateral = (userCollateral, userBorrowed, debt, user) => __awaiter(this, void 0, void 0, function* () {
@@ -471,7 +471,7 @@ export class LeverageV2Module {
             const _debt = parseUnits(debt, this.market.coinDecimals[0]);
             const swapData = this._getSwapDataFromCache(this.market.coinAddresses[0], _debt + _userBorrowed);
             if (slippage !== swapData.slippage)
-                throw Error(`You must call leverage.createLoanExpectedCollateral() with slippage=${slippage} first`);
+                throw Error(`You must call leverageV2.createLoanExpectedCollateral() with slippage=${slippage} first`);
             const calldata = yield _assembleTxOdos.call(this.llamalend, swapData.pathId);
             const contract = this.llamalend.contracts[this.market.controller].contract;
             const gas = yield contract.create_loan_extended.estimateGas(_userCollateral, _debt, range, this.llamalend.constants.ALIASES.leverage_zap, [1, parseUnits(this._getMarketId(), 0), _userBorrowed], calldata, Object.assign({}, this.llamalend.constantOptions));
@@ -616,7 +616,7 @@ export class LeverageV2Module {
             const _debt = parseUnits(debt, this.market.coinDecimals[0]);
             const swapData = this._getSwapDataFromCache(this.market.coinAddresses[0], _debt + _userBorrowed);
             if (slippage !== swapData.slippage)
-                throw Error(`You must call leverage.borrowMoreExpectedCollateral() with slippage=${slippage} first`);
+                throw Error(`You must call leverageV2.borrowMoreExpectedCollateral() with slippage=${slippage} first`);
             const calldata = yield _assembleTxOdos.call(this.llamalend, swapData.pathId);
             const contract = this.llamalend.contracts[this.market.controller].contract;
             const gas = yield contract.borrow_more_extended.estimateGas(_userCollateral, _debt, this.llamalend.constants.ALIASES.leverage_zap, [1, parseUnits(this._getMarketId(), 0), _userBorrowed], calldata, Object.assign({}, this.llamalend.constantOptions));
@@ -757,7 +757,7 @@ export class LeverageV2Module {
             if (_stateCollateral + _userCollateral > BigInt(0)) {
                 const swapData = this._getSwapDataFromCache(this.market.coinAddresses[1], _stateCollateral + _userCollateral);
                 if (slippage !== swapData.slippage)
-                    throw Error(`You must call leverage.repayExpectedBorrowed() with slippage=${slippage} first`);
+                    throw Error(`You must call leverageV2.repayExpectedBorrowed() with slippage=${slippage} first`);
                 calldata = yield _assembleTxOdos.call(this.llamalend, swapData.pathId);
             }
             console.log('params', [1, parseUnits(this._getMarketId(), 0), _userCollateral, _userBorrowed], calldata);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curvefi/llamalend-api",
-  "version": "1.0.30",
+  "version": "1.0.32",
   "description": "JavaScript library for Curve Lending",
   "main": "lib/index.js",
   "author": "Macket",

package/src/external-api.ts

@@ -136,6 +136,17 @@ export const _getUserCollateral = memoize(
     }
 )
 
+export const _getUserCollateralForce = async (
+    network: INetworkName, 
+    controller: string, 
+    user: string, 
+    newTx: string
+): Promise<void> => {
+    await fetch(`https://prices.curve.finance/v1/lending/collateral_events/${network}/${controller}/${user}?new_tx=${newTx}`);
+
+    _getUserCollateral.delete(network, controller, user);
+}
+
 export const _getUserCollateralCrvUsd = memoize(
     async (network: INetworkName, controller: string, user: string): Promise<string> => {
         const url = `https://prices.curve.finance/v1/crvusd/collateral_events/${network}/${controller}/${user}`;

package/src/lendMarkets/LendMarketTemplate.ts

@@ -23,7 +23,7 @@ import {
     smartNumber,
 } from "../utils.js";
 import {IDict, TGas, TAmount, IReward, IQuoteOdos, IOneWayMarket, IPartialFrac} from "../interfaces.js";
-import { _getExpectedOdos, _getQuoteOdos, _assembleTxOdos, _getUserCollateral, _getMarketsData } from "../external-api.js";
+import { _getExpectedOdos, _getQuoteOdos, _assembleTxOdos, _getUserCollateral, _getUserCollateralForce, _getMarketsData } from "../external-api.js";
 import ERC20Abi from '../constants/abis/ERC20.json' with {type: 'json'};
 import {cacheKey, cacheStats} from "../cache/index.js";
 
@@ -3160,4 +3160,16 @@ export class LendMarketTemplate {
 
         return boostBN.toFixed(4).replace(/([0-9])0+$/, '$1');
     }
+
+    public async forceUpdateUserState(newTx: string, userAddress?: string): Promise<void> {
+        const address = userAddress || this.llamalend.signerAddress;
+        if (!address) throw Error("Need to connect wallet or pass address into args");
+        
+        await _getUserCollateralForce(
+            this.llamalend.constants.NETWORK_NAME,
+            this.addresses.controller,
+            address,
+            newTx
+        );
+    }
 }

package/src/lendMarkets/lendMarketConstructor.ts

@@ -2,6 +2,10 @@ import { LendMarketTemplate} from "./LendMarketTemplate.js";
 import type { Llamalend } from "../llamalend.js";
 
 export const getLendMarket = function (this: Llamalend, lendMarketId: string): LendMarketTemplate {
-    const marketData = this.constants.ONE_WAY_MARKETS[lendMarketId];
-    return new LendMarketTemplate(lendMarketId, marketData, this)
+    if (!(lendMarketId in this.lendMarkets)) {
+        const marketData = this.constants.ONE_WAY_MARKETS[lendMarketId];
+        if (!marketData) throw new Error(`Lend market with id ${lendMarketId} not found`);
+        this.lendMarkets[lendMarketId] = new LendMarketTemplate(lendMarketId, marketData, this);
+    }
+    return this.lendMarkets[lendMarketId];
 }

package/src/llamalend.ts

@@ -81,6 +81,8 @@ import {createCall, handleMultiCallResponse} from "./utils.js";
 import {cacheKey, cacheStats} from "./cache/index.js";
 import {_getMarketsData, _getHiddenPools} from "./external-api.js";
 import {extractDecimals} from "./constants/utils.js";
+import {MintMarketTemplate} from "./mintMarkets";
+import {LendMarketTemplate} from "./lendMarkets";
 
 export const NETWORK_CONSTANTS: { [index: number]: any } = {
     1: {
@@ -177,6 +179,8 @@ class Llamalend implements ILlamalend {
     signerAddress: string;
     chainId: IChainId;
     contracts: { [index: string]: ICurveContract };
+    mintMarkets: { [addres: string]: MintMarketTemplate };
+    lendMarkets: { [addres: string]: LendMarketTemplate };
     feeData: { gasPrice?: number, maxFeePerGas?: number, maxPriorityFeePerGas?: number };
     constantOptions: { gasLimit: number };
     options: { gasPrice?: number | bigint, maxFeePerGas?: number | bigint, maxPriorityFeePerGas?: number | bigint };
@@ -204,6 +208,8 @@ class Llamalend implements ILlamalend {
         this.chainId = 1;
         this.multicallProvider = null as unknown as MulticallProvider;
         this.contracts = {};
+        this.mintMarkets = {};
+        this.lendMarkets = {};
         this.feeData = {}
         this.constantOptions = { gasLimit: 12000000 }
         this.options = {};

package/src/mintMarkets/MintMarketTemplate.ts

@@ -20,7 +20,7 @@ import {
     _mulBy1_3,
     DIGas,
 } from "../utils";
-import {IDict, TGas} from "../interfaces";
+import {IDict, ILlamma, TGas} from "../interfaces";
 import {_getUserCollateralCrvUsd} from "../external-api.js";
 import { ILeverageV2 } from "./interfaces/leverage.js";
 import { LeverageV2Module } from "./modules";
@@ -126,10 +126,8 @@ export class MintMarketTemplate {
         }
     }
 
-    constructor(id: string, llamalend: Llamalend) {
+    constructor(id: string, llammaData: ILlamma, llamalend: Llamalend) {
         this.llamalend = llamalend;
-        const llammaData = this.llamalend.constants.LLAMMAS[id];
-
         this.id = id;
         this.address = llammaData.amm_address;
         this.controller = llammaData.controller_address;

package/src/mintMarkets/mintMarketConstructor.ts

@@ -2,5 +2,10 @@ import { MintMarketTemplate} from "./MintMarketTemplate";
 import type { Llamalend } from "../llamalend.js";
 
 export const getMintMarket = function (this: Llamalend, mintMarketId: string): MintMarketTemplate {
-    return new MintMarketTemplate(mintMarketId, this)
+    if (!(mintMarketId in this.mintMarkets)) {
+        const llammaData = this.constants.LLAMMAS[mintMarketId];
+        if (!llammaData) throw new Error(`No market with id ${mintMarketId} found`);
+        this.mintMarkets[mintMarketId] = new MintMarketTemplate(mintMarketId, llammaData, this)
+    }
+    return this.mintMarkets[mintMarketId]
 }

package/src/mintMarkets/modules/leverageV2.ts

@@ -238,9 +238,8 @@ export class LeverageV2Module {
         const key = `${inputCoinAddress}-${_amount}`;
         if (!(key in this.swapDataCache)) throw Error(
             "You must call corresponding `expected` method first " +
-            "(leverage.createLoanExpectedCollateral, leverage.borrowMoreExpectedCollateral or leverage.repayExpectedBorrowed)"
+            "(leverageV2.createLoanExpectedCollateral, leverageV2.borrowMoreExpectedCollateral or leverageV2.repayExpectedBorrowed)"
         );
-
         return this.swapDataCache[key]
     }
 
@@ -494,7 +493,7 @@ export class LeverageV2Module {
         const _userBorrowed = parseUnits(userBorrowed, this.market.coinDecimals[0]);
         const _debt = parseUnits(debt, this.market.coinDecimals[0]);
         const swapData = this._getSwapDataFromCache(this.market.coinAddresses[0], _debt + _userBorrowed);
-        if (slippage !== swapData.slippage) throw Error(`You must call leverage.createLoanExpectedCollateral() with slippage=${slippage} first`);
+        if (slippage !== swapData.slippage) throw Error(`You must call leverageV2.createLoanExpectedCollateral() with slippage=${slippage} first`);
         const calldata = await _assembleTxOdos.call(this.llamalend, swapData.pathId as string);
         const contract = this.llamalend.contracts[this.market.controller].contract;
         const gas = await contract.create_loan_extended.estimateGas(
@@ -666,7 +665,7 @@ export class LeverageV2Module {
         const _userBorrowed = parseUnits(userBorrowed, this.market.coinDecimals[0]);
         const _debt = parseUnits(debt, this.market.coinDecimals[0]);
         const swapData = this._getSwapDataFromCache(this.market.coinAddresses[0], _debt + _userBorrowed);
-        if (slippage !== swapData.slippage) throw Error(`You must call leverage.borrowMoreExpectedCollateral() with slippage=${slippage} first`)
+        if (slippage !== swapData.slippage) throw Error(`You must call leverageV2.borrowMoreExpectedCollateral() with slippage=${slippage} first`)
         const calldata = await _assembleTxOdos.call(this.llamalend, swapData.pathId as string);
         const contract = this.llamalend.contracts[this.market.controller].contract;
         const gas = await contract.borrow_more_extended.estimateGas(
@@ -894,7 +893,7 @@ export class LeverageV2Module {
         let calldata = "0x";
         if (_stateCollateral + _userCollateral > BigInt(0)) {
             const swapData = this._getSwapDataFromCache(this.market.coinAddresses[1], _stateCollateral + _userCollateral);
-            if (slippage !== swapData.slippage) throw Error(`You must call leverage.repayExpectedBorrowed() with slippage=${slippage} first`)
+            if (slippage !== swapData.slippage) throw Error(`You must call leverageV2.repayExpectedBorrowed() with slippage=${slippage} first`)
             calldata = await _assembleTxOdos.call(this.llamalend, swapData.pathId as string);
         }