@raac/rpc 2.0.0-beta.12 → 2.0.0-beta.14

package/dist/RPCLibrary.js

@@ -152,6 +152,7 @@ const getScheduled_1 = require("./contracts/rentStreamer/getScheduled");
 const getEpochProjection_1 = require("./contracts/rentStreamer/getEpochProjection");
 const sync_1 = require("./contracts/rentStreamer/sync");
 const release_1 = require("./contracts/rentStreamer/release");
+const getState_2 = __importDefault(require("./contracts/feeCollector/getState"));
 const getRawUserDepositsInLendingPool_1 = __importDefault(require("./pools/lendingPool/getRawUserDepositsInLendingPool"));
 const getRawUserDepositsInStabilityPool_1 = __importDefault(require("./pools/stabilityPool/getRawUserDepositsInStabilityPool"));
 const getEligibleUserDeposits_1 = __importDefault(require("./pools/lendingPool/getEligibleUserDeposits"));
@@ -189,6 +190,18 @@ const getWithdrawTimelockConfig_1 = require("./pools/stabilityPool/getWithdrawTi
 const requestWithdraw_1 = require("./pools/stabilityPool/requestWithdraw");
 // PSM
 const getVaultInfo_1 = require("./contracts/psm/getVaultInfo");
+const getVaultSettings_1 = require("./contracts/psm/getVaultSettings");
+const getState_3 = __importDefault(require("./contracts/housePrices/getState"));
+const getState_4 = __importDefault(require("./contracts/crvUSDToUSDOracle/getState"));
+const getRoles_1 = __importDefault(require("./contracts/getRoles"));
+const getState_5 = __importDefault(require("./contracts/treasury/getState"));
+const getStatuses_1 = __importDefault(require("./contracts/complianceRegistry/getStatuses"));
+const getAdminState_1 = __importDefault(require("./pools/stabilityPool/getAdminState"));
+const liquidation_1 = require("./pools/stabilityPool/liquidation");
+const emissionSchedule_1 = require("./minter/emissionSchedule");
+const getRegisteredAdapters_1 = __importDefault(require("./pools/rwaVault/getRegisteredAdapters"));
+const getSeedStatus_1 = __importDefault(require("./pools/rwaVault/getSeedStatus"));
+const getAdminState_2 = __importDefault(require("./pools/lendingPool/getAdminState"));
 const previewDeposit_2 = require("./contracts/psm/previewDeposit");
 const previewRedeem_1 = require("./contracts/psm/previewRedeem");
 const previewSwap_1 = require("./contracts/psm/previewSwap");
@@ -212,6 +225,7 @@ const controllerMethods = __importStar(require("./contracts/governance/gaugeCont
 const gaugeSystemMethods = __importStar(require("./contracts/governance/gaugeSystems"));
 // ===== Curve =====
 const curveCommonMethods = __importStar(require("./contracts/curve/common"));
+const faucetMethods = __importStar(require("./contracts/faucet"));
 // ===== User aggregates (dashboard) =====
 const userMethods = __importStar(require("./user"));
 // Proposals
@@ -220,7 +234,7 @@ const getQuorumNumerator_1 = require("./contracts/governance/proposals/getQuorum
 const getVotingPeriod_1 = require("./contracts/governance/proposals/getVotingPeriod");
 const castVote_1 = require("./contracts/governance/proposals/castVote");
 const getProposalInfo_1 = require("./contracts/governance/proposals/getProposalInfo");
-const getState_2 = require("./contracts/governance/proposals/getState");
+const getState_6 = require("./contracts/governance/proposals/getState");
 const execute_1 = require("./contracts/governance/proposals/execute");
 const getProposalThreshold_1 = require("./contracts/governance/proposals/getProposalThreshold");
 const getVotes_1 = require("./contracts/governance/proposals/getVotes");
@@ -234,7 +248,7 @@ const hasVoted_1 = require("./contracts/governance/proposals/hasVoted");
 const getVoteReceipt_1 = require("./contracts/governance/proposals/getVoteReceipt");
 const getProposalEta_1 = require("./contracts/governance/proposals/getProposalEta");
 const getLabel_1 = require("./contracts/governance/proposals/getLabel");
-const getRoles_1 = require("./contracts/governance/proposals/getRoles");
+const getRoles_2 = require("./contracts/governance/proposals/getRoles");
 const hasRole_1 = require("./contracts/governance/proposals/hasRole");
 const setParameter_1 = require("./contracts/governance/proposals/setParameter");
 const setTimelock_1 = require("./contracts/governance/proposals/setTimelock");
@@ -246,7 +260,7 @@ const hashOperationBatch_1 = require("./contracts/governance/timelock/hashOperat
 const isOperationDone_1 = require("./contracts/governance/timelock/isOperationDone");
 const isOperationReady_1 = require("./contracts/governance/timelock/isOperationReady");
 const isOperationPending_1 = require("./contracts/governance/timelock/isOperationPending");
-const getRoles_2 = require("./contracts/governance/timelock/getRoles");
+const getRoles_3 = require("./contracts/governance/timelock/getRoles");
 const hasRole_2 = require("./contracts/governance/timelock/hasRole");
 // Tokens
 // PMUSD
@@ -347,7 +361,7 @@ const getLocks_2 = require("./contracts/lockers/botLocker/getLocks");
 const getLockedTokenIds_1 = require("./contracts/lockers/botLocker/getLockedTokenIds");
 const getConfig_3 = require("./contracts/lockers/botLocker/getConfig");
 const getUnlockWindow_1 = require("./contracts/lockers/botLocker/getUnlockWindow");
-const getRoles_3 = require("./contracts/lockers/botLocker/getRoles");
+const getRoles_4 = require("./contracts/lockers/botLocker/getRoles");
 const hasRole_3 = require("./contracts/lockers/botLocker/hasRole");
 const grantRole_2 = require("./contracts/lockers/botLocker/grantRole");
 const addRewardTokens_1 = require("./contracts/lockers/botLocker/addRewardTokens");
@@ -412,6 +426,7 @@ class RPCLibrary {
     // prices
     // Curve pools from the chain config's `curve` section
     curve;
+    faucet;
     // Aggregate reads of one user's position and claimables, composed from the methods above
     user;
     prices;
@@ -495,8 +510,19 @@ class RPCLibrary {
         this.contracts = {
             housePrices: {
                 getLatestPrice: getLatestPrice_1.default,
+                getState: getState_3.default,
                 setOracle: setOracle_1.default,
             },
+            crvUSDToUSDOracle: {
+                getState: getState_4.default,
+            },
+            treasury: {
+                getState: getState_5.default,
+            },
+            complianceRegistry: {
+                getStatuses: getStatuses_1.default,
+            },
+            getRoles: getRoles_1.default,
             minter: {
                 tick: tick_1.default,
                 get: get_1.default,
@@ -512,6 +538,10 @@ class RPCLibrary {
                 calculateScheduledMintableAmount: calculateScheduledMintableAmount_1.calculateScheduledMintableAmount,
                 getEmissionPerSecond: getEmissionPerSecond_1.getEmissionPerSecond,
                 isPaused: isPaused_1.isPaused,
+                getEmissionSchedule: emissionSchedule_1.getEmissionSchedule,
+                getSchedulePosition: emissionSchedule_1.getSchedulePosition,
+                getEmissionPerSecondForWeek: emissionSchedule_1.getEmissionPerSecondForWeek,
+                getMintingWeekForTimestamp: emissionSchedule_1.getMintingWeekForTimestamp,
             },
             getContractAddress: getContractAddress_1.default,
             getContract: getContract_1.default,
@@ -522,6 +552,7 @@ class RPCLibrary {
             getTokenMetadata: getTokenMetadata_1.getTokenMetadata,
             feeCollector: {
                 claimRewardFromPool: claimRewardFromPool_1.default,
+                getState: getState_2.default,
             },
             rentStreamer: {
                 getState: getState_1.getState,
@@ -675,7 +706,7 @@ class RPCLibrary {
                 getLockedTokenIds: getLockedTokenIds_1.getLockedTokenIds,
                 getConfig: getConfig_3.getConfig,
                 getUnlockWindow: getUnlockWindow_1.getUnlockWindow,
-                getRoles: getRoles_3.getRoles,
+                getRoles: getRoles_4.getRoles,
                 hasRole: hasRole_3.hasRole,
                 grantRole: grantRole_2.grantRole,
                 revokeRole: grantRole_2.revokeRole,
@@ -725,7 +756,7 @@ class RPCLibrary {
                 getVotingPeriod: getVotingPeriod_1.getVotingPeriod,
                 castVote: castVote_1.castVote,
                 getProposalInfo: getProposalInfo_1.getProposalInfo,
-                getState: getState_2.getState,
+                getState: getState_6.getState,
                 execute: execute_1.execute,
                 getProposalThreshold: getProposalThreshold_1.getProposalThreshold,
                 getVotes: getVotes_1.getVotes,
@@ -739,7 +770,7 @@ class RPCLibrary {
                 getVoteReceipt: getVoteReceipt_1.getVoteReceipt,
                 getProposalEta: getProposalEta_1.getProposalEta,
                 getLabel: getLabel_1.getLabel,
-                getRoles: getRoles_1.getRoles,
+                getRoles: getRoles_2.getRoles,
                 hasRole: hasRole_1.hasRole,
                 setParameter: setParameter_1.setParameter,
                 setTimelock: setTimelock_1.setTimelock,
@@ -752,12 +783,13 @@ class RPCLibrary {
                 isOperationDone: isOperationDone_1.isOperationDone,
                 isOperationReady: isOperationReady_1.isOperationReady,
                 isOperationPending: isOperationPending_1.isOperationPending,
-                getRoles: getRoles_2.getRoles,
+                getRoles: getRoles_3.getRoles,
                 hasRole: hasRole_2.hasRole,
             },
         };
         this.psm = {
             getVaultInfo: getVaultInfo_1.getVaultInfo,
+            getVaultSettings: getVaultSettings_1.getVaultSettings,
             previewDeposit: previewDeposit_2.previewDeposit,
             previewRedeem: previewRedeem_1.previewRedeem,
             previewSwap: previewSwap_1.previewSwap,
@@ -777,6 +809,15 @@ class RPCLibrary {
                 getWithdrawRequestInfo: getWithdrawRequestInfo_1.getWithdrawRequestInfo,
                 getWithdrawTimelockConfig: getWithdrawTimelockConfig_1.getWithdrawTimelockConfig,
                 requestWithdraw: requestWithdraw_1.requestWithdraw,
+                getAdminState: getAdminState_1.default,
+                liquidation: {
+                    getContext: liquidation_1.readLiquidationContext,
+                    getTarget: liquidation_1.readLiquidationTarget,
+                    quote: liquidation_1.quoteLiquidation,
+                    suggestSplit: liquidation_1.suggestSplit,
+                    simulateWithSplit: liquidation_1.simulateWithSplit,
+                    minSharesOut: liquidation_1.minSharesOut,
+                },
             },
             // LendingPool
             lendingPool: {
@@ -788,6 +829,7 @@ class RPCLibrary {
                 depositAssetToLendingPool: depositAssetToLendingPool_1.default,
                 withdrawAssetFromLendingPool: withdrawAssetFromLendingPool_1.default,
                 getLendingPoolInfo: getLendingPoolInfo_1.default,
+                getAdminState: getAdminState_2.default,
                 getRawUserDepositsInLendingPool: getRawUserDepositsInLendingPool_1.default,
                 getEligibleUserDeposits: getEligibleUserDeposits_1.default,
                 getHealthFactor: getHealthFactor_1.default,
@@ -818,6 +860,8 @@ class RPCLibrary {
                 depositToRWAVault: depositToRWAVault_1.default,
                 redeemNFTFromRWAVault: redeemNFTFromRWAVault_1.default,
                 getRWAVaultInfo: getRWAVaultInfo_1.default,
+                getRegisteredAdapters: getRegisteredAdapters_1.default,
+                getSeedStatus: getSeedStatus_1.default,
                 getNextRandomNFT: getNextRandomNFT_1.default,
                 checkRedeemEligibility: checkRedeemEligibility_1.checkRedeemEligibility,
                 requestRandomSeed: requestRandomSeed_1.default,
@@ -871,6 +915,7 @@ class RPCLibrary {
         this.curve = {
             common: curveCommonMethods,
         };
+        this.faucet = faucetMethods;
         this.user = userMethods;
         this.prices = {
             getPrices: getPrices_1.getPrices,

package/dist/configs/chains/11155111.json

@@ -14,6 +14,11 @@
         }
     ],
     "contracts": {
+        "faucet": {
+            "id": "faucet",
+            "name": "Testnet Faucet",
+            "contract": "0xcFcAE14bC0Ef0CB5CD4466b916F518A393d7f2a7"
+        },
         "raachouseprices": {
             "id": "raachouseprices",
             "name": "RAAC House Prices",
@@ -180,6 +185,14 @@
             "timelock": "0x16fe0d26550aEEca53f5eF2FFE2DBc9319B3F212"
         }
     ],
+    "psm": {
+        "rpsm-susds": {
+            "id": "rpsm-sUSDS",
+            "name": "RAAC Peg Stability Module sUSDS",
+            "contract": "0xbcA54A6E7BeD62Ad3aA5660c0e51FeA1F6A47289",
+            "rateProvider": "0xB3b47F65dFeca20991148BAfe8dc34e1aDb6939b"
+        }
+    },
     "pools": {
         "stabilitypool": {
             "id": "stabilitypool",

package/dist/contracts/complianceRegistry/getStatuses.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ethers_1 = require("ethers");
+const contracts_1 = require("../../utils/contracts");
+const artifacts_1 = require("../../utils/artifacts");
+const rpcError_1 = require("../../utils/rpcError");
+// ComplianceRegistry storage: AccessControl._roles at slot 0, _blacklisted at slot 1, sanctionsList at slot 2.
+const BLACKLIST_SLOT = 1;
+const SANCTIONS_SLOT = 2;
+const listedSlot = (user) => ethers_1.ethers.keccak256(ethers_1.ethers.AbiCoder.defaultAbiCoder().encode(["address", "uint256"], [user, BLACKLIST_SLOT]));
+/**
+ * Reads the sanctions list and each address's compliance status. `_blacklisted` is private, so the own-list flag is
+ * read from storage, trusted only when slot 2 matches `sanctionsList()`; otherwise `listed` is null where it cannot
+ * be told apart from a sanction.
+ * @param chainId The chain id.
+ * @param addresses The addresses to check.
+ * @param provider The provider to read with.
+ */
+async function getStatuses(chainId, addresses, provider) {
+    const at = (0, contracts_1.getContractAddress)(chainId, "complianceregistry");
+    try {
+        const reg = new ethers_1.ethers.Contract(at, (0, artifacts_1.getABI)("complianceregistry"), provider);
+        const [list, slot2] = await Promise.all([reg.sanctionsList(), provider.getStorage(at, SANCTIONS_SLOT).catch(() => null)]);
+        const layoutOk = slot2 !== null && BigInt(slot2) === BigInt(list);
+        const sanctions = list === ethers_1.ethers.ZeroAddress ? null : new ethers_1.ethers.Contract(list, ["function isSanctioned(address) view returns (bool)"], provider);
+        const statuses = await Promise.all(addresses.map(async (address) => {
+            const [blocked, sanctioned, listed] = await Promise.all([
+                reg.isBlacklisted(address),
+                sanctions ? sanctions.isSanctioned(address) : false,
+                layoutOk ? provider.getStorage(at, listedSlot(address)).then((v) => BigInt(v) !== BigInt(0)) : null,
+            ]);
+            return { address, blocked, listed: listed ?? (sanctioned ? null : blocked), sanctioned };
+        }));
+        return { sanctionsList: list, statuses };
+    }
+    catch (error) {
+        throw (0, rpcError_1.toRpcError)("complianceRegistry.getStatuses", error, { chainId, address: at });
+    }
+}
+exports.default = getStatuses;

package/dist/contracts/crvUSDToUSDOracle/getState.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CRVUSD_PRICE_SOURCES = void 0;
+const ethers_1 = require("ethers");
+const contracts_1 = require("../../utils/contracts");
+const artifacts_1 = require("../../utils/artifacts");
+const rpcError_1 = require("../../utils/rpcError");
+/** Which route the crvUSD/USD price came from, as `getLatestPrice`'s third value reports it. */
+exports.CRVUSD_PRICE_SOURCES = ["chainlink", "curve", "fallback"];
+/**
+ * Reads the crvUSD/USD oracle's current price and route and every setting behind them. A reverting price read gives
+ * `price: null` instead of failing, since that is exactly when the settings matter.
+ * @param chainId The chain id.
+ * @param provider The provider to read with.
+ * @param oracleAddress Optional address, e.g. from `housePrices.getState`; defaults to the registry's `crvusdtousdoracle`.
+ */
+async function getState(chainId, provider, oracleAddress) {
+    const address = oracleAddress ?? (0, contracts_1.getContractAddress)(chainId, "crvusdtousdoracle");
+    try {
+        const oracle = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("crvusdtousdoracle"), provider);
+        const [owner, latest, circuitBreakerEnabled, minPriceThreshold, maxPriceThreshold, fallbackPriceInUSD, lastFallbackUpdateTimestamp, maxStableStaleTime, maxUnstableStaleTime, crvUSDDataFeed, ethDataFeed, curveOracle, K] = await Promise.all([
+            oracle.owner(),
+            oracle.getLatestPrice().catch(() => null),
+            oracle.circuitBreakerEnabled(),
+            oracle.minPriceThreshold(),
+            oracle.maxPriceThreshold(),
+            oracle.fallbackPriceInUSD(),
+            oracle.lastFallbackUpdateTimestamp(),
+            oracle.maxStableStaleTime(),
+            oracle.maxUnstableStaleTime(),
+            oracle.crvUSDDataFeed(),
+            oracle.ethDataFeed(),
+            oracle.curveOracle(),
+            oracle.K(),
+        ]);
+        return {
+            owner,
+            price: latest ? latest[0] : null,
+            priceTimestamp: latest ? Number(latest[1]) : null,
+            source: latest ? (exports.CRVUSD_PRICE_SOURCES[Number(latest[2])] ?? null) : null,
+            circuitBreakerEnabled,
+            minPriceThreshold,
+            maxPriceThreshold,
+            fallbackPriceInUSD,
+            lastFallbackUpdateTimestamp: Number(lastFallbackUpdateTimestamp),
+            maxStableStaleTime,
+            maxUnstableStaleTime,
+            crvUSDDataFeed,
+            ethDataFeed,
+            curveOracle,
+            K,
+        };
+    }
+    catch (error) {
+        throw (0, rpcError_1.toRpcError)("crvUSDToUSDOracle.getState", error, { chainId, address });
+    }
+}
+exports.default = getState;

package/dist/contracts/curve/common/_helpers.js

@@ -6,6 +6,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCurvePools = exports.CURVE_POOL_READ_ABI = void 0;
 exports.resolveCurvePool = resolveCurvePool;
 exports.getCurvePoolContract = getCurvePoolContract;
+exports.getCurvePoolFlavourContract = getCurvePoolFlavourContract;
+exports.assertCoinCount = assertCoinCount;
+exports.assertCoinIndex = assertCoinIndex;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
 /**
@@ -37,3 +40,57 @@ function getCurvePoolContract(chainId, poolAddressOrId, provider) {
     const entry = resolveCurvePool(chainId, poolAddressOrId);
     return { entry, contract: new ethers_1.ethers.Contract(entry.contract, exports.CURVE_POOL_READ_ABI, provider), provider };
 }
+/**
+ * Swap and liquidity methods per flavour. twocrypto-ng and tricrypto-ng index coins with uint256 and take fixed
+ * uint256[2] / uint256[3] arrays; stableswap-ng indexes with int128 and takes a dynamic uint256[]. Encoding one
+ * against another reverts, so the pool's configured flavour picks the ABI.
+ */
+const CURVE_POOL_WRITE_ABI = {
+    twocrypto: [
+        "function get_dy(uint256 i, uint256 j, uint256 dx) view returns (uint256)",
+        "function calc_withdraw_one_coin(uint256 token_amount, uint256 i) view returns (uint256)",
+        "function calc_token_amount(uint256[2] amounts, bool deposit) view returns (uint256)",
+        "function exchange(uint256 i, uint256 j, uint256 dx, uint256 min_dy, address receiver) returns (uint256)",
+        "function add_liquidity(uint256[2] amounts, uint256 min_mint_amount, address receiver) returns (uint256)",
+        "function remove_liquidity(uint256 _amount, uint256[2] min_amounts, address receiver) returns (uint256[2])",
+        "function remove_liquidity_one_coin(uint256 token_amount, uint256 i, uint256 min_amount, address receiver) returns (uint256)",
+    ],
+    tricrypto: [
+        "function get_dy(uint256 i, uint256 j, uint256 dx) view returns (uint256)",
+        "function calc_withdraw_one_coin(uint256 token_amount, uint256 i) view returns (uint256)",
+        "function calc_token_amount(uint256[3] amounts, bool deposit) view returns (uint256)",
+        "function exchange(uint256 i, uint256 j, uint256 dx, uint256 min_dy, address receiver) returns (uint256)",
+        "function add_liquidity(uint256[3] amounts, uint256 min_mint_amount, address receiver) returns (uint256)",
+        "function remove_liquidity(uint256 _amount, uint256[3] min_amounts, address receiver) returns (uint256[3])",
+        "function remove_liquidity_one_coin(uint256 token_amount, uint256 i, uint256 min_amount, address receiver) returns (uint256)",
+    ],
+    stableswap: [
+        "function get_dy(int128 i, int128 j, uint256 dx) view returns (uint256)",
+        "function calc_withdraw_one_coin(uint256 token_amount, int128 i) view returns (uint256)",
+        "function calc_token_amount(uint256[] amounts, bool is_deposit) view returns (uint256)",
+        "function exchange(int128 i, int128 j, uint256 dx, uint256 min_dy, address receiver) returns (uint256)",
+        "function add_liquidity(uint256[] amounts, uint256 min_mint_amount, address receiver) returns (uint256)",
+        "function remove_liquidity(uint256 _amount, uint256[] min_amounts, address receiver) returns (uint256[])",
+        "function remove_liquidity_one_coin(uint256 token_amount, int128 i, uint256 min_amount, address receiver) returns (uint256)",
+    ],
+};
+/** The pool contract with its flavour's swap and liquidity ABI, bound to a signer or provider. */
+function getCurvePoolFlavourContract(chainId, poolAddressOrId, runner) {
+    const entry = resolveCurvePool(chainId, poolAddressOrId);
+    if (!runner) {
+        runner = new ethers_1.ethers.JsonRpcProvider(chains_1.default[chainId].rpcs[0]);
+    }
+    return { entry, contract: new ethers_1.ethers.Contract(entry.contract, CURVE_POOL_WRITE_ABI[entry.flavour], runner) };
+}
+/** Checks an amounts array matches the pool's coin count before it reaches the encoder. */
+function assertCoinCount(entry, amounts, what) {
+    if (amounts.length !== entry.coins.length) {
+        throw new Error(`${what} needs ${entry.coins.length} amounts for ${entry.id}, got ${amounts.length}`);
+    }
+}
+/** Checks a coin index is inside the pool. */
+function assertCoinIndex(entry, index) {
+    if (!Number.isInteger(index) || index < 0 || index >= entry.coins.length) {
+        throw new Error(`Coin index ${index} is out of range for ${entry.id} (${entry.coins.length} coins)`);
+    }
+}

package/dist/contracts/curve/common/addLiquidity.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addLiquidity = void 0;
+const rpcError_1 = require("../../../utils/rpcError");
+const _helpers_1 = require("./_helpers");
+/**
+ * Deposits coins into a Curve pool for LP tokens. The caller approves each non-zero coin to the pool first.
+ *
+ * @param chainId - The chain/network to use.
+ * @param poolAddressOrId - The pool's key in the chain config's `curve` section, or its address.
+ * @param amounts - One amount per coin, in pool order and each coin's base units; 0 for a coin not deposited.
+ * @param minMintAmount - The least LP to accept (18 decimals); the deposit reverts below it. See `calcTokenAmount`.
+ * @param receiver - Who receives the LP tokens.
+ * @param signer - The signer sending the transaction.
+ * @returns The mined transaction receipt.
+ */
+const addLiquidity = async (chainId, poolAddressOrId, amounts, minMintAmount, receiver, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const { entry, contract } = (0, _helpers_1.getCurvePoolFlavourContract)(chainId, poolAddressOrId, signer);
+    (0, _helpers_1.assertCoinCount)(entry, amounts, "addLiquidity");
+    try {
+        const tx = await contract.add_liquidity(amounts, minMintAmount, receiver);
+        return await tx.wait();
+    }
+    catch (error) {
+        throw (0, rpcError_1.toRpcError)("curve.addLiquidity", error, { chainId, address: entry.contract });
+    }
+};
+exports.addLiquidity = addLiquidity;

package/dist/contracts/curve/common/calcTokenAmount.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calcTokenAmount = void 0;
+const rpcError_1 = require("../../../utils/rpcError");
+const _helpers_1 = require("./_helpers");
+/**
+ * LP tokens a deposit (or, with `isDeposit` false, a proportional withdrawal) of `amounts` mints or burns at the
+ * pool's current state. Fees are not included, so apply a slippage margin before using it as a minimum.
+ *
+ * @param amounts - One amount per coin, in pool order and each coin's base units.
+ * @returns LP tokens (18 decimals).
+ */
+const calcTokenAmount = async (chainId, poolAddressOrId, amounts, isDeposit, provider) => {
+    const { entry, contract } = (0, _helpers_1.getCurvePoolFlavourContract)(chainId, poolAddressOrId, provider);
+    (0, _helpers_1.assertCoinCount)(entry, amounts, "calcTokenAmount");
+    try {
+        return await contract.calc_token_amount(amounts, isDeposit);
+    }
+    catch (error) {
+        throw (0, rpcError_1.toRpcError)("curve.calcTokenAmount", error, { chainId, address: entry.contract });
+    }
+};
+exports.calcTokenAmount = calcTokenAmount;

package/dist/contracts/curve/common/calcWithdrawOneCoin.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calcWithdrawOneCoin = void 0;
+const rpcError_1 = require("../../../utils/rpcError");
+const _helpers_1 = require("./_helpers");
+/**
+ * How much of coin `i` burning `lpAmount` LP tokens returns at the pool's current state.
+ *
+ * @returns The output amount in coin `i`'s base units.
+ */
+const calcWithdrawOneCoin = async (chainId, poolAddressOrId, lpAmount, i, provider) => {
+    const { entry, contract } = (0, _helpers_1.getCurvePoolFlavourContract)(chainId, poolAddressOrId, provider);
+    (0, _helpers_1.assertCoinIndex)(entry, i);
+    try {
+        return await contract.calc_withdraw_one_coin(lpAmount, i);
+    }
+    catch (error) {
+        throw (0, rpcError_1.toRpcError)("curve.calcWithdrawOneCoin", error, { chainId, address: entry.contract });
+    }
+};
+exports.calcWithdrawOneCoin = calcWithdrawOneCoin;

package/dist/contracts/curve/common/exchange.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exchange = void 0;
+const rpcError_1 = require("../../../utils/rpcError");
+const _helpers_1 = require("./_helpers");
+/**
+ * Swaps `amountIn` of coin `i` for coin `j` in a Curve pool. The caller approves coin `i` to the pool first.
+ *
+ * @param chainId - The chain/network to use.
+ * @param poolAddressOrId - The pool's key in the chain config's `curve` section, or its address.
+ * @param i - Index of the coin sold, in pool order.
+ * @param j - Index of the coin bought, in pool order.
+ * @param amountIn - Amount of coin `i`, in its base units.
+ * @param minAmountOut - The least of coin `j` to accept, in its base units; the swap reverts below it.
+ * @param receiver - Who receives coin `j`.
+ * @param signer - The signer sending the transaction.
+ * @returns The mined transaction receipt.
+ */
+const exchange = async (chainId, poolAddressOrId, i, j, amountIn, minAmountOut, receiver, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const { entry, contract } = (0, _helpers_1.getCurvePoolFlavourContract)(chainId, poolAddressOrId, signer);
+    (0, _helpers_1.assertCoinIndex)(entry, i);
+    (0, _helpers_1.assertCoinIndex)(entry, j);
+    try {
+        const tx = await contract.exchange(i, j, amountIn, minAmountOut, receiver);
+        return await tx.wait();
+    }
+    catch (error) {
+        throw (0, rpcError_1.toRpcError)("curve.exchange", error, { chainId, address: entry.contract });
+    }
+};
+exports.exchange = exchange;

package/dist/contracts/curve/common/getDy.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDy = void 0;
+const rpcError_1 = require("../../../utils/rpcError");
+const _helpers_1 = require("./_helpers");
+/**
+ * How much of coin `j` a swap of `amountIn` of coin `i` returns at the pool's current state, before slippage.
+ *
+ * @returns The output amount in coin `j`'s base units.
+ */
+const getDy = async (chainId, poolAddressOrId, i, j, amountIn, provider) => {
+    const { entry, contract } = (0, _helpers_1.getCurvePoolFlavourContract)(chainId, poolAddressOrId, provider);
+    (0, _helpers_1.assertCoinIndex)(entry, i);
+    (0, _helpers_1.assertCoinIndex)(entry, j);
+    try {
+        return await contract.get_dy(i, j, amountIn);
+    }
+    catch (error) {
+        throw (0, rpcError_1.toRpcError)("curve.getDy", error, { chainId, address: entry.contract });
+    }
+};
+exports.getDy = getDy;

package/dist/contracts/curve/common/index.js

@@ -14,5 +14,12 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./addLiquidity"), exports);
+__exportStar(require("./calcTokenAmount"), exports);
+__exportStar(require("./calcWithdrawOneCoin"), exports);
+__exportStar(require("./exchange"), exports);
+__exportStar(require("./getDy"), exports);
 __exportStar(require("./getPools"), exports);
 __exportStar(require("./getVirtualPrice"), exports);
+__exportStar(require("./removeLiquidity"), exports);
+__exportStar(require("./removeLiquidityOneCoin"), exports);

package/dist/contracts/curve/common/removeLiquidity.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeLiquidity = void 0;
+const rpcError_1 = require("../../../utils/rpcError");
+const _helpers_1 = require("./_helpers");
+/**
+ * Burns LP tokens for every coin of a Curve pool in proportion to its balances.
+ *
+ * @param chainId - The chain/network to use.
+ * @param poolAddressOrId - The pool's key in the chain config's `curve` section, or its address.
+ * @param lpAmount - LP tokens to burn (18 decimals).
+ * @param minAmounts - The least of each coin to accept, in pool order and each coin's base units.
+ * @param receiver - Who receives the coins.
+ * @param signer - The signer sending the transaction.
+ * @returns The mined transaction receipt.
+ */
+const removeLiquidity = async (chainId, poolAddressOrId, lpAmount, minAmounts, receiver, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const { entry, contract } = (0, _helpers_1.getCurvePoolFlavourContract)(chainId, poolAddressOrId, signer);
+    (0, _helpers_1.assertCoinCount)(entry, minAmounts, "removeLiquidity");
+    try {
+        const tx = await contract.remove_liquidity(lpAmount, minAmounts, receiver);
+        return await tx.wait();
+    }
+    catch (error) {
+        throw (0, rpcError_1.toRpcError)("curve.removeLiquidity", error, { chainId, address: entry.contract });
+    }
+};
+exports.removeLiquidity = removeLiquidity;

package/dist/contracts/curve/common/removeLiquidityOneCoin.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeLiquidityOneCoin = void 0;
+const rpcError_1 = require("../../../utils/rpcError");
+const _helpers_1 = require("./_helpers");
+/**
+ * Burns LP tokens for a single coin of a Curve pool.
+ *
+ * @param chainId - The chain/network to use.
+ * @param poolAddressOrId - The pool's key in the chain config's `curve` section, or its address.
+ * @param lpAmount - LP tokens to burn (18 decimals).
+ * @param i - Index of the coin to receive, in pool order.
+ * @param minAmount - The least of coin `i` to accept, in its base units. See `calcWithdrawOneCoin`.
+ * @param receiver - Who receives the coin.
+ * @param signer - The signer sending the transaction.
+ * @returns The mined transaction receipt.
+ */
+const removeLiquidityOneCoin = async (chainId, poolAddressOrId, lpAmount, i, minAmount, receiver, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const { entry, contract } = (0, _helpers_1.getCurvePoolFlavourContract)(chainId, poolAddressOrId, signer);
+    (0, _helpers_1.assertCoinIndex)(entry, i);
+    try {
+        const tx = await contract.remove_liquidity_one_coin(lpAmount, i, minAmount, receiver);
+        return await tx.wait();
+    }
+    catch (error) {
+        throw (0, rpcError_1.toRpcError)("curve.removeLiquidityOneCoin", error, { chainId, address: entry.contract });
+    }
+};
+exports.removeLiquidityOneCoin = removeLiquidityOneCoin;

package/dist/contracts/faucet/claim.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claim = void 0;
+const ethers_1 = require("ethers");
+const contracts_1 = require("../../utils/contracts");
+const rpcError_1 = require("../../utils/rpcError");
+const FAUCET_CLAIM_ABI = [
+    "function claim(address token, uint256 amount)",
+    "function claimMultiple(address[] tokens, uint256[] amounts)",
+];
+/**
+ * Claims testnet tokens from the faucet: one `claim` for a single token, one `claimMultiple` for several.
+ *
+ * @param chainId - The chain/network to use; only chains with a `faucet` contract in their config.
+ * @param claims - The tokens and amounts to claim.
+ * @param signer - The signer sending the transaction; the tokens go to its address.
+ * @returns The mined transaction receipt.
+ * @throws If the chain has no faucet, `claims` is empty, or the transaction fails.
+ */
+const claim = async (chainId, claims, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    if (claims.length === 0)
+        throw new Error("Nothing to claim");
+    const address = (0, contracts_1.getContractAddress)(chainId, "faucet");
+    try {
+        const faucet = new ethers_1.ethers.Contract(address, FAUCET_CLAIM_ABI, signer);
+        const tx = claims.length === 1
+            ? await faucet.claim(claims[0].token, claims[0].amount)
+            : await faucet.claimMultiple(claims.map(({ token }) => token), claims.map(({ amount }) => amount));
+        return await tx.wait();
+    }
+    catch (error) {
+        throw (0, rpcError_1.toRpcError)("faucet.claim", error, { chainId, address });
+    }
+};
+exports.claim = claim;