@curvefi/api 2.68.17 → 2.68.21

package/README.md

@@ -181,6 +181,17 @@ import curve from "@curvefi/api";
     //     '0xb0cada2a2983dc0ed85a26916d32b9caefe45fecde47640bd7d0e214ff22aed3',
     //     '0x00ea7d827b3ad50ce933e96c579810cd7e70d66a034a86ec4e1e10005634d041'
     // ]
+    
+    // Get populated approve transactions (without executing)
+    const approveTxs = await curve.populateApprove(["DAI", "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"], ['1000', '1000'], spender);
+    // OR with custom user address (for API): 
+    // await curve.populateApprove(["DAI", "USDC"], ['1000', '1000'], spender, false, '0x...userAddress');
+    // Returns array of TransactionLike objects (may include reset to 0 if needed for some tokens)
+    console.log(approveTxs);
+    // [
+    //   { to: '0x6B17...', data: '0x095ea7b3...', hash: '0x...', ... },
+    //   { to: '0xA0b8...', data: '0x095ea7b3...', hash: '0x...', ... }
+    // ]
 })()
 ```
 
@@ -1191,6 +1202,13 @@ import curve from "@curvefi/api";
     // [
     //     '0xc111e471715ae6f5437e12d3b94868a5b6542cd7304efca18b5782d315760ae5'
     // ]
+    
+    // Get populated transactions for approve (without executing)
+    const approveTxs = await curve.router.populateApprove('DAI', 1000, false, userAddress);
+    // OR const approveTxs = await curve.router.populateApprove('0x6B175474E89094C44Da98b954EedeAC495271d0F', 1000, false, userAddress);
+    console.log(approveTxs);
+    // [{ to: '0x6B17...', data: '0x...', ... }]
+    // Returns array of TransactionLike objects
     const swapTx = await curve.router.swap('DAI', 'CRV', '1000');
     // OR const swapTx = await curve.router.swap('0x6B175474E89094C44Da98b954EedeAC495271d0F', '0xD533a949740bb3306d119CC777fa900bA034cd52', '1000');
     console.log(swapTx.hash);
@@ -1200,6 +1218,16 @@ import curve from "@curvefi/api";
 
     await curve.getBalances(['DAI', 'CRV']);
     // [ '8900.0', '100428.626463428100672494' ]
+
+    // Get calldata for swap (without executing transaction)
+    // First, you need to call getBestRouteAndOutput to cache the route
+    await curve.router.getBestRouteAndOutput('DAI', 'CRV', '1000');
+    
+    // Then get calldata
+    const { data, to, from, amount } = await curve.router.populateSwap('DAI', 'CRV', '1000', 0.5);
+    // OR const tx = await curve.router.populateSwap('0x6B175474E89094C44Da98b954EedeAC495271d0F', '0xD533a949740bb3306d119CC777fa900bA034cd52', '1000', 0.5);
+    console.log(data);
+    // 0x8f726f1c000000000000000000000000...
 })()
 ```
 

package/lib/index.d.ts

@@ -51,6 +51,7 @@ export declare const createCurve: () => {
     getAllowance: (coins: string[], address: string, spender: string) => Promise<string[]>;
     hasAllowance: (coins: string[], amounts: (string | number)[], address: string, spender: string) => Promise<boolean>;
     ensureAllowance: (coins: string[], amounts: (string | number)[], spender: string, isMax?: boolean | undefined) => Promise<string[]>;
+    populateApprove: (coins: string[], amounts: (string | number)[], spender: string, isMax?: boolean | undefined, userAddress?: string | undefined) => Promise<ethers.TransactionLike<string>[]>;
     getCoinsData: (...args: string[] | string[][]) => Promise<{
         name: string;
         symbol: string;
@@ -254,7 +255,9 @@ export declare const createCurve: () => {
         priceImpact: (inputCoin: string, outputCoin: string, amount: string | number) => Promise<number>;
         isApproved: (inputCoin: string, amount: string | number) => Promise<boolean>;
         approve: (inputCoin: string, amount: string | number) => Promise<string[]>;
+        populateApprove: (inputCoin: string, amount: string | number, isMax: boolean | undefined, userAddress: string) => Promise<ethers.TransactionLike<string>[]>;
         swap: (inputCoin: string, outputCoin: string, amount: string | number, slippage?: number | undefined) => Promise<ethers.ContractTransactionResponse>;
+        populateSwap: (inputCoin: string, outputCoin: string, amount: string | number, slippage?: number | undefined) => Promise<ethers.TransactionLike<string>>;
         getSwappedAmount: (tx: ethers.ContractTransactionResponse, outputCoin: string) => Promise<string>;
         estimateGas: {
             approve: (inputCoin: string, amount: string | number) => Promise<number | number[]>;
@@ -361,6 +364,7 @@ declare const _default: {
     getAllowance: (coins: string[], address: string, spender: string) => Promise<string[]>;
     hasAllowance: (coins: string[], amounts: (string | number)[], address: string, spender: string) => Promise<boolean>;
     ensureAllowance: (coins: string[], amounts: (string | number)[], spender: string, isMax?: boolean | undefined) => Promise<string[]>;
+    populateApprove: (coins: string[], amounts: (string | number)[], spender: string, isMax?: boolean | undefined, userAddress?: string | undefined) => Promise<ethers.TransactionLike<string>[]>;
     getCoinsData: (...args: string[] | string[][]) => Promise<{
         name: string;
         symbol: string;
@@ -564,7 +568,9 @@ declare const _default: {
         priceImpact: (inputCoin: string, outputCoin: string, amount: string | number) => Promise<number>;
         isApproved: (inputCoin: string, amount: string | number) => Promise<boolean>;
         approve: (inputCoin: string, amount: string | number) => Promise<string[]>;
+        populateApprove: (inputCoin: string, amount: string | number, isMax: boolean | undefined, userAddress: string) => Promise<ethers.TransactionLike<string>[]>;
         swap: (inputCoin: string, outputCoin: string, amount: string | number, slippage?: number | undefined) => Promise<ethers.ContractTransactionResponse>;
+        populateSwap: (inputCoin: string, outputCoin: string, amount: string | number, slippage?: number | undefined) => Promise<ethers.TransactionLike<string>>;
         getSwappedAmount: (tx: ethers.ContractTransactionResponse, outputCoin: string) => Promise<string>;
         estimateGas: {
             approve: (inputCoin: string, amount: string | number) => Promise<number | number[]>;

package/lib/index.js

@@ -9,10 +9,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { PoolTemplate, getPool } from "./pools/index.js";
 import { getUserPoolListByLiquidity, getUserPoolListByClaimable, getUserPoolList, getUserLiquidityUSD, getUserClaimable, } from "./pools/utils.js";
-import { getBestRouteAndOutput, getArgs, swapExpected, swapRequired, swapPriceImpact, swapIsApproved, swapApproveEstimateGas, swapApprove, swapEstimateGas, swap, getSwappedAmount, } from "./router.js";
+import { getBestRouteAndOutput, getArgs, swapExpected, swapRequired, swapPriceImpact, swapIsApproved, swapApproveEstimateGas, swapApprove, swapPopulateApprove, swapEstimateGas, swap, populateSwap, getSwappedAmount, } from "./router.js";
 import { Curve } from "./curve.js";
 import { getCrv, getLockedAmountAndUnlockTime, getVeCrv, getVeCrvPct, calcUnlockTime, createLockEstimateGas, createLock, isApproved, approveEstimateGas, approve, increaseAmountEstimateGas, increaseAmount, increaseUnlockTimeEstimateGas, increaseUnlockTime, withdrawLockedCrvEstimateGas, withdrawLockedCrv, claimableFees, claimFeesEstimateGas, claimFees, lastEthBlock, getAnycallBalance, topUpAnycall, topUpAnycallEstimateGas, lastBlockSent, blockToSend, sendBlockhash, sendBlockhashEstimateGas, submitProof, submitProofEstimateGas, claimFeesCrvUSDEstimateGas, claimableFeesCrvUSD, claimFeesCrvUSD, calculateVeCrv, } from "./boosting.js";
-import { getBalances, getAllowance, hasAllowance, ensureAllowanceEstimateGas, ensureAllowance, getUsdRate, getGasPriceFromL1, getGasPriceFromL2, getGasInfoForL2, getTVL, getCoinsData, getVolume, hasDepositAndStake, hasRouter, getBasePools, getGasPrice, getCurveLiteNetworks, } from "./utils.js";
+import { getBalances, getAllowance, hasAllowance, ensureAllowanceEstimateGas, ensureAllowance, populateApprove, getUsdRate, getGasPriceFromL1, getGasPriceFromL2, getGasInfoForL2, getTVL, getCoinsData, getVolume, hasDepositAndStake, hasRouter, getBasePools, getGasPrice, getCurveLiteNetworks, } from "./utils.js";
 import { deployStablePlainPool, deployStablePlainPoolEstimateGas, getDeployedStablePlainPoolAddress, setOracle, setOracleEstimateGas, deployStableMetaPool, deployStableMetaPoolEstimateGas, getDeployedStableMetaPoolAddress, deployCryptoPool, deployCryptoPoolEstimateGas, getDeployedCryptoPoolAddress, deployTricryptoPool, deployTricryptoPoolEstimateGas, getDeployedTricryptoPoolAddress, deployGauge, deployGaugeEstimateGas, getDeployedGaugeAddress, deployGaugeSidechain, deployGaugeSidechainEstimateGas, deployGaugeMirror, deployGaugeMirrorEstimateGas, getDeployedGaugeMirrorAddress, getDeployedGaugeMirrorAddressByTx, deployStableNgPlainPool, deployStableNgPlainPoolEstimateGas, deployStableNgMetaPool, deployStableNgMetaPoolEstimateGas, deployTwocryptoPool, deployTwocryptoPoolEstimateGas, getDeployedTwocryptoPoolAddress, } from './factory/deploy.js';
 import { getTwoCryptoImplementations } from './constants/twoCryptoImplementations.js';
 import { crvSupplyStats, userCrv, userVeCrv, crvLockIsApproved, crvLockApproveEstimateGas, crvLockApprove, calcCrvUnlockTime, createCrvLockEstimateGas, createCrvLock, increaseCrvLockedAmountEstimateGas, increaseCrvLockedAmount, increaseCrvUnlockTimeEstimateGas, increaseCrvUnlockTime, withdrawLockedCrvEstimateGas as daoWithdrawLockedCrvEstimateGas, withdrawLockedCrv as daoWithdrawLockedCrv, claimableFees as daoClaimableFees, claimFeesEstimateGas as daoClaimFeesEstimateGas, claimFees as daoClaimFees, getVotingGaugeList, userGaugeVotes, voteForGaugeNextTime, voteForGaugeEstimateGas, voteForGauge, getProposalList, getProposal, userProposalVotes, voteForProposalEstimateGas, voteForProposal, executeVote, executeVoteEstimateGas, isCanVoteExecute, } from "./dao.js";
@@ -51,6 +51,7 @@ export const createCurve = () => {
         getAllowance: getAllowance.bind(_curve),
         hasAllowance: hasAllowance.bind(_curve),
         ensureAllowance: ensureAllowance.bind(_curve),
+        populateApprove: populateApprove.bind(_curve),
         getCoinsData: getCoinsData.bind(_curve),
         getVolume: getVolume.bind(_curve),
         hasDepositAndStake: hasDepositAndStake.bind(_curve),
@@ -228,7 +229,9 @@ export const createCurve = () => {
             priceImpact: swapPriceImpact.bind(_curve),
             isApproved: swapIsApproved.bind(_curve),
             approve: swapApprove.bind(_curve),
+            populateApprove: swapPopulateApprove.bind(_curve),
             swap: swap.bind(_curve),
+            populateSwap: populateSwap.bind(_curve),
             getSwappedAmount: getSwappedAmount.bind(_curve),
             estimateGas: {
                 approve: swapApproveEstimateGas.bind(_curve),

package/lib/router.d.ts

@@ -1,4 +1,4 @@
-import { ethers } from "ethers";
+import { ethers, TransactionLike } from "ethers";
 import { type Curve } from "./curve.js";
 import { IRoute } from "./interfaces";
 export declare function getBestRouteAndOutput(this: Curve, inputCoin: string, outputCoin: string, amount: number | string): Promise<{
@@ -20,6 +20,8 @@ export declare function swapPriceImpact(this: Curve, inputCoin: string, outputCo
 export declare function swapIsApproved(this: Curve, inputCoin: string, amount: number | string): Promise<boolean>;
 export declare function swapApproveEstimateGas(this: Curve, inputCoin: string, amount: number | string): Promise<number | number[]>;
 export declare function swapApprove(this: Curve, inputCoin: string, amount: number | string): Promise<string[]>;
+export declare function swapPopulateApprove(this: Curve, inputCoin: string, amount: number | string, isMax: boolean | undefined, userAddress: string): Promise<TransactionLike[]>;
 export declare function swapEstimateGas(this: Curve, inputCoin: string, outputCoin: string, amount: number | string): Promise<number | number[]>;
 export declare function swap(this: Curve, inputCoin: string, outputCoin: string, amount: number | string, slippage?: number): Promise<ethers.ContractTransactionResponse>;
+export declare function populateSwap(this: Curve, inputCoin: string, outputCoin: string, amount: number | string, slippage?: number): Promise<TransactionLike>;
 export declare function getSwappedAmount(this: Curve, tx: ethers.ContractTransactionResponse, outputCoin: string): Promise<string>;

package/lib/router.js

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { ethers } from "ethers";
 import { OLD_CHAINS } from "./curve.js";
-import { _cutZeros, _get_price_impact, _get_small_x, _getCoinAddresses, _getCoinDecimals, _getUsdRate, BN, DIGas, ensureAllowance, ensureAllowanceEstimateGas, ETH_ADDRESS, fromBN, getGasPriceFromL1, getTxCostsUsd, hasAllowance, isEth, parseUnits, runWorker, smartNumber, toBN, } from "./utils.js";
+import { _cutZeros, _get_price_impact, _get_small_x, _getCoinAddresses, _getCoinDecimals, _getUsdRate, BN, DIGas, ensureAllowance, ensureAllowanceEstimateGas, ETH_ADDRESS, fromBN, getGasPriceFromL1, getTxCostsUsd, hasAllowance, isEth, parseUnits, populateApprove, runWorker, smartNumber, toBN, } from "./utils.js";
 import { getPool } from "./pools/index.js";
 import { _getAmplificationCoefficientsFromApi } from "./pools/utils.js";
 import { L2Networks } from "./constants/L2Networks.js";
@@ -373,6 +373,11 @@ export function swapApprove(inputCoin, amount) {
         return yield ensureAllowance.call(this, [inputCoin], [amount], this.constants.ALIASES.router);
     });
 }
+export function swapPopulateApprove(inputCoin_1, amount_1) {
+    return __awaiter(this, arguments, void 0, function* (inputCoin, amount, isMax = true, userAddress) {
+        return yield populateApprove.call(this, [inputCoin], [amount], this.constants.ALIASES.router, isMax, userAddress);
+    });
+}
 export function swapEstimateGas(inputCoin, outputCoin, amount) {
     return __awaiter(this, void 0, void 0, function* () {
         const [inputCoinAddress, outputCoinAddress] = _getCoinAddresses.call(this, inputCoin, outputCoin);
@@ -385,7 +390,7 @@ export function swapEstimateGas(inputCoin, outputCoin, amount) {
         return gas;
     });
 }
-export function swap(inputCoin_1, outputCoin_1, amount_1) {
+function prepareSwap(inputCoin_1, outputCoin_1, amount_1) {
     return __awaiter(this, arguments, void 0, function* (inputCoin, outputCoin, amount, slippage = 0.5) {
         const [inputCoinAddress, outputCoinAddress] = _getCoinAddresses.call(this, inputCoin, outputCoin);
         const [inputCoinDecimals, outputCoinDecimals] = _getCoinDecimals.call(this, inputCoinAddress, outputCoinAddress);
@@ -405,10 +410,35 @@ export function swap(inputCoin_1, outputCoin_1, amount_1) {
             const gasLimit = (DIGas(yield contract.exchange.estimateGas(_route, _swapParams, _amount, _minRecvAmount, _pools, Object.assign(Object.assign({}, this.constantOptions), { value })))) * (this.chainId === 1 ? this.parseUnits("130", 0) : this.parseUnits("160", 0)) / this.parseUnits("100", 0);
             return yield contract.exchange(_route, _swapParams, _amount, _minRecvAmount, _pools, Object.assign(Object.assign({}, this.options), { value, gasLimit }));
         }
-        else {
-            const gasLimit = (DIGas(yield contract.exchange.estimateGas(_route, _swapParams, _amount, _minRecvAmount, Object.assign(Object.assign({}, this.constantOptions), { value })))) * this.parseUnits("160", 0) / this.parseUnits("100", 0);
-            return yield contract.exchange(_route, _swapParams, _amount, _minRecvAmount, Object.assign(Object.assign({}, this.options), { value, gasLimit }));
+        const gasLimit = (DIGas(yield contract.exchange.estimateGas(_route, _swapParams, _amount, _minRecvAmount, Object.assign(Object.assign({}, this.constantOptions), { value })))) * this.parseUnits("160", 0) / this.parseUnits("100", 0);
+        return [contract, [_route, _swapParams, _amount, _minRecvAmount], Object.assign(Object.assign({}, this.options), { value, gasLimit })];
+    });
+}
+export function swap(inputCoin_1, outputCoin_1, amount_1) {
+    return __awaiter(this, arguments, void 0, function* (inputCoin, outputCoin, amount, slippage = 0.5) {
+        const [contract, params, options] = yield prepareSwap.call(this, inputCoin, outputCoin, amount, slippage);
+        return yield contract.exchange(...params, options);
+    });
+}
+export function populateSwap(inputCoin_1, outputCoin_1, amount_1) {
+    return __awaiter(this, arguments, void 0, function* (inputCoin, outputCoin, amount, slippage = 0.5) {
+        console.log(inputCoin, outputCoin, amount, slippage);
+        const [inputCoinAddress, outputCoinAddress] = _getCoinAddresses.call(this, inputCoin, outputCoin);
+        const [inputCoinDecimals, outputCoinDecimals] = _getCoinDecimals.call(this, inputCoinAddress, outputCoinAddress);
+        const { route, output } = _getBestRouteAndOutput.call(this, inputCoinAddress, outputCoinAddress, amount);
+        if (route.length === 0) {
+            throw new Error("This pair can't be exchanged");
         }
+        const { _route, _swapParams, _pools } = _getExchangeArgs.call(this, route);
+        const _amount = parseUnits(amount, inputCoinDecimals);
+        const minRecvAmountBN = BN(output).times(100 - slippage).div(100);
+        const _minRecvAmount = fromBN(minRecvAmountBN, outputCoinDecimals);
+        const contract = this.contracts[this.constants.ALIASES.router].contract;
+        return yield contract.exchange.populateTransaction(...[
+            _route, _swapParams, _amount, _minRecvAmount,
+            ..._pools ? [_pools] : [],
+            { value: isEth(inputCoinAddress) ? _amount : this.parseUnits("0") },
+        ]);
     });
 }
 export function getSwappedAmount(tx, outputCoin) {

package/lib/utils.d.ts

@@ -1,4 +1,4 @@
-import { Contract } from 'ethers';
+import { Contract, TransactionLike } from 'ethers';
 import { Contract as MulticallContract } from "@curvefi/ethcall";
 import BigNumber from 'bignumber.js';
 import { Abi, AbiFunction, IBasePoolShortItem, IChainId, ICurveLiteNetwork, IDict, INetworkName, IRewardFromApi, IVolumeAndAPYs, REFERENCE_ASSET } from './interfaces';
@@ -33,6 +33,7 @@ export declare function hasAllowance(this: Curve, coins: string[], amounts: (num
 export declare function _ensureAllowance(this: Curve, coins: string[], amounts: bigint[], spender: string, isMax?: boolean): Promise<string[]>;
 export declare function ensureAllowanceEstimateGas(this: Curve, coins: string[], amounts: (number | string)[], spender: string, isMax?: boolean): Promise<number | number[]>;
 export declare function ensureAllowance(this: Curve, coins: string[], amounts: (number | string)[], spender: string, isMax?: boolean): Promise<string[]>;
+export declare function populateApprove(this: Curve, coins: string[], amounts: (number | string)[], spender: string, isMax?: boolean, userAddress?: string): Promise<TransactionLike[]>;
 export declare function getPoolIdBySwapAddress(this: Curve, swapAddress: string): string;
 export declare function _getRewardsFromApi(this: Curve): Promise<IDict<IRewardFromApi[]>>;
 export declare function _getUsdRate(this: Curve, assetId: string): Promise<number>;

package/lib/utils.js

@@ -269,6 +269,29 @@ export function ensureAllowance(coins_1, amounts_1, spender_1) {
         return yield _ensureAllowance.call(this, coinAddresses, _amounts, spender, isMax);
     });
 }
+export function populateApprove(coins_1, amounts_1, spender_1) {
+    return __awaiter(this, arguments, void 0, function* (coins, amounts, spender, isMax = true, userAddress) {
+        const coinAddresses = _getCoinAddresses.call(this, coins);
+        const decimals = _getCoinDecimals.call(this, coinAddresses);
+        const _amounts = amounts.map((a, i) => parseUnits(a, decimals[i]));
+        const address = userAddress || this.signerAddress;
+        if (!address)
+            throw Error("User address is not defined. Pass userAddress parameter.");
+        const allowance = yield _getAllowance.call(this, coinAddresses, address, spender);
+        const transactions = [];
+        for (let i = 0; i < allowance.length; i++) {
+            if (allowance[i] < _amounts[i]) {
+                const contract = this.contracts[coinAddresses[i]].contract;
+                const _approveAmount = isMax ? MAX_ALLOWANCE : _amounts[i];
+                if (allowance[i] > parseUnits("0")) {
+                    transactions.push(yield contract.approve.populateTransaction(spender, parseUnits("0")));
+                }
+                transactions.push(yield contract.approve.populateTransaction(spender, _approveAmount));
+            }
+        }
+        return transactions;
+    });
+}
 export function getPoolIdBySwapAddress(swapAddress) {
     const poolsData = this.getPoolsData();
     const poolIds = Object.entries(poolsData).filter(([, poolData]) => poolData.swap_address.toLowerCase() === swapAddress.toLowerCase());

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@curvefi/api",
-  "version": "2.68.17",
+  "version": "2.68.21",
   "description": "JavaScript library for curve.finance",
   "main": "lib/index.js",
   "author": "Macket",
   "license": "MIT",
   "private": false,
   "engines": {
-    "node": "22"
+    "node": "24"
   },
   "repository": {
     "type": "git",
@@ -25,20 +25,20 @@
   },
   "type": "module",
   "devDependencies": {
-    "@babel/eslint-parser": "^7.28.0",
+    "@babel/eslint-parser": "^7.28.5",
     "@eslint/eslintrc": "^3.3.1",
-    "@eslint/js": "^9.34.0",
-    "@types/chai": "^5.2.2",
+    "@eslint/js": "^9.38.0",
+    "@types/chai": "^5.2.3",
     "@types/memoizee": "^0.4.12",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^24.3.1",
-    "@typescript-eslint/eslint-plugin": "^8.42.0",
-    "@typescript-eslint/parser": "^8.42.0",
+    "@types/node": "^24.9.2",
+    "@typescript-eslint/eslint-plugin": "^8.46.2",
+    "@typescript-eslint/parser": "^8.46.2",
     "chai": "^5.3.3",
-    "eslint": "^9.34.0",
-    "globals": "^16.3.0",
-    "mocha": "^11.7.2",
-    "typescript": "^5.9.2",
+    "eslint": "^9.38.0",
+    "globals": "^16.4.0",
+    "mocha": "^11.7.4",
+    "typescript": "^5.9.3",
     "vue-eslint-parser": "^10.2.0"
   },
   "dependencies": {