@raac/rpc 2.0.0-beta.17 → 2.0.0-beta.19

package/dist/RPCLibrary.js

@@ -383,6 +383,7 @@ const getMinterInfo_1 = require("./contracts/tokens/leRAAC/getMinterInfo");
 // Aladdin Zap
 const getRoutes_1 = require("./contracts/zap/aladdin/getRoutes");
 const getCurvePoolToken_1 = require("./contracts/zap/aladdin/getCurvePoolToken");
+const inspectCurvePool_1 = require("./contracts/zap/aladdin/inspectCurvePool");
 const getPool2Token_1 = require("./contracts/zap/aladdin/getPool2Token");
 const getOwner_1 = require("./contracts/zap/aladdin/getOwner");
 const getVersion_1 = require("./contracts/zap/aladdin/getVersion");
@@ -728,6 +729,7 @@ class RPCLibrary {
             aladdin: {
                 getRoutes: getRoutes_1.getRoutes,
                 getCurvePoolToken: getCurvePoolToken_1.getCurvePoolToken,
+                inspectCurvePool: inspectCurvePool_1.inspectCurvePool,
                 getPool2Token: getPool2Token_1.getPool2Token,
                 getOwner: getOwner_1.getOwner,
                 getVersion: getVersion_1.getVersion,

package/dist/artifacts/faucet/Faucet.json

@@ -0,0 +1,254 @@
+{
+    "_comment": "Hand-written from the deployed Sepolia faucet 0xcFcAE14bC0Ef0CB5CD4466b916F518A393d7f2a7 (no source in the repos); every selector checked against its bytecode.",
+    "abi": [
+        {
+            "type": "function",
+            "name": "allTokens",
+            "constant": true,
+            "stateMutability": "view",
+            "payable": false,
+            "inputs": [],
+            "outputs": [
+                {
+                    "type": "address[]",
+                    "name": ""
+                }
+            ]
+        },
+        {
+            "type": "function",
+            "name": "tokens",
+            "constant": true,
+            "stateMutability": "view",
+            "payable": false,
+            "inputs": [
+                {
+                    "type": "uint256",
+                    "name": "index"
+                }
+            ],
+            "outputs": [
+                {
+                    "type": "address",
+                    "name": ""
+                }
+            ]
+        },
+        {
+            "type": "function",
+            "name": "approvedToken",
+            "constant": true,
+            "stateMutability": "view",
+            "payable": false,
+            "inputs": [
+                {
+                    "type": "address",
+                    "name": "token"
+                }
+            ],
+            "outputs": [
+                {
+                    "type": "bool",
+                    "name": ""
+                }
+            ]
+        },
+        {
+            "type": "function",
+            "name": "tokenCap",
+            "constant": true,
+            "stateMutability": "view",
+            "payable": false,
+            "inputs": [
+                {
+                    "type": "address",
+                    "name": "token"
+                }
+            ],
+            "outputs": [
+                {
+                    "type": "uint256",
+                    "name": ""
+                }
+            ]
+        },
+        {
+            "type": "function",
+            "name": "whitelisted",
+            "constant": true,
+            "stateMutability": "view",
+            "payable": false,
+            "inputs": [
+                {
+                    "type": "address",
+                    "name": "account"
+                }
+            ],
+            "outputs": [
+                {
+                    "type": "bool",
+                    "name": ""
+                }
+            ]
+        },
+        {
+            "type": "function",
+            "name": "owner",
+            "constant": true,
+            "stateMutability": "view",
+            "payable": false,
+            "inputs": [],
+            "outputs": [
+                {
+                    "type": "address",
+                    "name": ""
+                }
+            ]
+        },
+        {
+            "type": "function",
+            "name": "paused",
+            "constant": true,
+            "stateMutability": "view",
+            "payable": false,
+            "inputs": [],
+            "outputs": [
+                {
+                    "type": "bool",
+                    "name": ""
+                }
+            ]
+        },
+        {
+            "type": "function",
+            "name": "claim",
+            "constant": false,
+            "payable": false,
+            "inputs": [
+                {
+                    "type": "address",
+                    "name": "token"
+                },
+                {
+                    "type": "uint256",
+                    "name": "amount"
+                }
+            ],
+            "outputs": []
+        },
+        {
+            "type": "function",
+            "name": "claimMultiple",
+            "constant": false,
+            "payable": false,
+            "inputs": [
+                {
+                    "type": "address[]",
+                    "name": "tokens"
+                },
+                {
+                    "type": "uint256[]",
+                    "name": "amounts"
+                }
+            ],
+            "outputs": []
+        },
+        {
+            "type": "function",
+            "name": "addToken",
+            "constant": false,
+            "payable": false,
+            "inputs": [
+                {
+                    "type": "address",
+                    "name": "token"
+                },
+                {
+                    "type": "uint256",
+                    "name": "cap"
+                }
+            ],
+            "outputs": []
+        },
+        {
+            "type": "function",
+            "name": "updateTokenCap",
+            "constant": false,
+            "payable": false,
+            "inputs": [
+                {
+                    "type": "address",
+                    "name": "token"
+                },
+                {
+                    "type": "uint256",
+                    "name": "cap"
+                }
+            ],
+            "outputs": []
+        },
+        {
+            "type": "function",
+            "name": "withdraw",
+            "constant": false,
+            "payable": false,
+            "inputs": [
+                {
+                    "type": "address",
+                    "name": "token"
+                },
+                {
+                    "type": "uint256",
+                    "name": "amount"
+                }
+            ],
+            "outputs": []
+        },
+        {
+            "type": "function",
+            "name": "whitelist",
+            "constant": false,
+            "payable": false,
+            "inputs": [
+                {
+                    "type": "address",
+                    "name": "account"
+                },
+                {
+                    "type": "bool",
+                    "name": "status"
+                }
+            ],
+            "outputs": []
+        },
+        {
+            "type": "function",
+            "name": "pause",
+            "constant": false,
+            "payable": false,
+            "inputs": [],
+            "outputs": []
+        },
+        {
+            "type": "function",
+            "name": "unpause",
+            "constant": false,
+            "payable": false,
+            "inputs": [],
+            "outputs": []
+        },
+        {
+            "type": "function",
+            "name": "transferOwnership",
+            "constant": false,
+            "payable": false,
+            "inputs": [
+                {
+                    "type": "address",
+                    "name": "newOwner"
+                }
+            ],
+            "outputs": []
+        }
+    ]
+}

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

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCurvePools = exports.CURVE_POOL_READ_ABI = void 0;
+exports.CURVE_POOL_WRITE_ABI = exports.getCurvePools = exports.CURVE_POOL_READ_ABI = void 0;
 exports.resolveCurvePool = resolveCurvePool;
 exports.getCurvePoolContract = getCurvePoolContract;
 exports.getCurvePoolFlavourContract = getCurvePoolFlavourContract;
@@ -45,7 +45,7 @@ function getCurvePoolContract(chainId, poolAddressOrId, provider) {
  * 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 = {
+exports.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)",
@@ -80,7 +80,7 @@ function getCurvePoolFlavourContract(chainId, poolAddressOrId, runner) {
     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) };
+    return { entry, contract: new ethers_1.ethers.Contract(entry.contract, exports.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) {

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

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPoolInterface = void 0;
+const ethers_1 = require("ethers");
+const _helpers_1 = require("./_helpers");
+/**
+ * The pool's swap and liquidity ABI for its flavour, for encoding calls that are sent elsewhere (e.g. queued in a
+ * Safe) instead of through `exchange` / `addLiquidity` / `removeLiquidity` / `removeLiquidityOneCoin`. Reads the config
+ * only; no RPC call is made.
+ *
+ * @param chainId - The chain/network to use.
+ * @param poolAddressOrId - The pool's key in the chain config's `curve` section, or its address.
+ * @returns The interface (stableswap-ng indexes coins with int128 and takes dynamic arrays, the crypto pools uint256 and fixed arrays).
+ */
+const getPoolInterface = (chainId, poolAddressOrId) => new ethers_1.ethers.Interface(_helpers_1.CURVE_POOL_WRITE_ABI[(0, _helpers_1.resolveCurvePool)(chainId, poolAddressOrId).flavour]);
+exports.getPoolInterface = getPoolInterface;

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

@@ -0,0 +1,105 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPoolState = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const amount_1 = require("../../../utils/amount");
+const rpcError_1 = require("../../../utils/rpcError");
+const _helpers_1 = require("./_helpers");
+const getPools_1 = require("./getPools");
+const COMMON = [
+    "function balances(uint256) view returns (uint256)",
+    "function totalSupply() view returns (uint256)",
+    "function get_virtual_price() view returns (uint256)",
+    "function fee() view returns (uint256)",
+    "function A() view returns (uint256)",
+];
+/**
+ * Price getters per flavour. twocrypto-ng has one price and no index; tricrypto-ng and stableswap-ng take k for
+ * coin k + 1. All price in coin 0.
+ */
+const PRICE_ABI = {
+    twocrypto: [
+        "function price_oracle() view returns (uint256)",
+        "function last_prices() view returns (uint256)",
+        "function price_scale() view returns (uint256)",
+        "function lp_price() view returns (uint256)",
+        "function mid_fee() view returns (uint256)",
+        "function out_fee() view returns (uint256)",
+    ],
+    tricrypto: [
+        "function price_oracle(uint256) view returns (uint256)",
+        "function last_prices(uint256) view returns (uint256)",
+        "function price_scale(uint256) view returns (uint256)",
+        "function lp_price() view returns (uint256)",
+        "function mid_fee() view returns (uint256)",
+        "function out_fee() view returns (uint256)",
+    ],
+    stableswap: ["function price_oracle(uint256) view returns (uint256)", "function get_p(uint256) view returns (uint256)"],
+};
+const FEE_DECIMALS = 10;
+const ONE = BigInt(10) ** BigInt(amount_1.WAD_DECIMALS);
+/**
+ * Reads a Curve pool's composition, prices and fees in one go: balances, LP supply, virtual and LP price, the
+ * oracle, spot and (crypto) scale price of every coin in coin 0, each balance's value in coin 0, and the fee and A.
+ *
+ * @param chainId - The chain/network to use.
+ * @param poolAddressOrId - The pool's key in the chain config's `curve` section, or its address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The pool's state; values and TVL are in coin 0's units at the oracle price.
+ */
+const getPoolState = async (chainId, poolAddressOrId, provider) => {
+    const entry = (0, _helpers_1.resolveCurvePool)(chainId, poolAddressOrId);
+    const pool = (0, getPools_1.getPool)(chainId, entry.id);
+    if (!provider)
+        provider = new ethers_1.ethers.JsonRpcProvider(chains_1.default[chainId].rpcs[0]);
+    const contract = new ethers_1.ethers.Contract(entry.contract, [...COMMON, ...PRICE_ABI[entry.flavour]], provider);
+    const crypto = entry.flavour !== "stableswap";
+    const others = pool.coins.slice(1).map((_, k) => k);
+    // twocrypto-ng's price getters take no index; it has a single other coin.
+    const each = (method) => Promise.all(others.map((k) => (entry.flavour === "twocrypto" ? contract[method]() : contract[method](k))));
+    try {
+        const [balances, supply, virtualPrice, fee, A, oracle, spot, scale, lpPrice, mid, out] = await Promise.all([
+            Promise.all(pool.coins.map((_, i) => contract.balances(i))),
+            contract.totalSupply(),
+            contract.get_virtual_price(),
+            contract.fee(),
+            contract.A(),
+            each("price_oracle"),
+            each(crypto ? "last_prices" : "get_p"),
+            crypto ? each("price_scale") : Promise.resolve(null),
+            crypto ? contract.lp_price() : Promise.resolve(null),
+            crypto ? contract.mid_fee() : Promise.resolve(null),
+            crypto ? contract.out_fee() : Promise.resolve(null),
+        ]);
+        const unit = pool.coins[0];
+        const prices = (p) => [ONE, ...p].map((v) => (0, amount_1.toAmount)(v, amount_1.WAD_DECIMALS, unit.symbol));
+        const oraclePrices = prices(oracle);
+        // balance (coin decimals) * price (1e18) -> coin 0 decimals
+        const values = balances.map((b, i) => (0, amount_1.toAmount)((b * oraclePrices[i].value * BigInt(10) ** BigInt(unit.decimals)) / (BigInt(10) ** BigInt(pool.coins[i].decimals) * ONE), unit.decimals, unit.symbol));
+        const tvl = values.reduce((sum, v) => sum + v.value, BigInt(0));
+        const lp = lpPrice ?? (supply > BigInt(0) ? (tvl * BigInt(10) ** BigInt(amount_1.WAD_DECIMALS + amount_1.WAD_DECIMALS - unit.decimals)) / supply : BigInt(0));
+        return {
+            pool,
+            balances: balances.map((b, i) => (0, amount_1.toAmount)(b, pool.coins[i].decimals, pool.coins[i].symbol)),
+            totalSupply: (0, amount_1.toAmount)(supply, amount_1.WAD_DECIMALS, "LP"),
+            virtualPrice: (0, amount_1.toAmount)(virtualPrice, amount_1.WAD_DECIMALS),
+            lpPrice: (0, amount_1.toAmount)(lp, amount_1.WAD_DECIMALS, unit.symbol),
+            oraclePrices,
+            spotPrices: prices(spot),
+            priceScale: scale ? prices(scale) : null,
+            values,
+            tvl: (0, amount_1.toAmount)(tvl, unit.decimals, unit.symbol),
+            fee: (0, amount_1.toScaled)(fee, FEE_DECIMALS),
+            feeRange: mid !== null && out !== null ? { mid: (0, amount_1.toScaled)(mid, FEE_DECIMALS), out: (0, amount_1.toScaled)(out, FEE_DECIMALS) } : null,
+            A,
+        };
+    }
+    catch (error) {
+        throw (0, rpcError_1.toRpcError)("curve.common.getPoolState", error, { chainId, address: entry.contract });
+    }
+};
+exports.getPoolState = getPoolState;

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

@@ -20,6 +20,8 @@ __exportStar(require("./calcWithdrawOneCoin"), exports);
 __exportStar(require("./exchange"), exports);
 __exportStar(require("./getDy"), exports);
 __exportStar(require("./getPools"), exports);
+__exportStar(require("./getPoolInterface"), exports);
+__exportStar(require("./getPoolState"), exports);
 __exportStar(require("./getVirtualPrice"), exports);
 __exportStar(require("./removeLiquidity"), exports);
 __exportStar(require("./removeLiquidityOneCoin"), exports);

package/dist/contracts/faucet/getState.js

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getState = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../configs/chains"));
+const amount_1 = require("../../utils/amount");
+const artifacts_1 = require("../../utils/artifacts");
+const contracts_1 = require("../../utils/contracts");
+const rpcError_1 = require("../../utils/rpcError");
+const ERC20 = ["function symbol() view returns (string)", "function decimals() view returns (uint8)", "function balanceOf(address) view returns (uint256)"];
+/**
+ * Reads the testnet faucet: its owner, whether it is paused, and every token it gives out with its balance and per-claim cap.
+ * The faucet has no deposit function; it is topped up with a plain ERC20 transfer.
+ *
+ * @param chainId - The chain/network to use; only chains with a `faucet` contract in their config (Sepolia).
+ * @param provider - Optional ethers.js Provider instance.
+ */
+const getState = async (chainId, provider) => {
+    if (!provider)
+        provider = new ethers_1.ethers.JsonRpcProvider(chains_1.default[chainId].rpcs[0]);
+    const address = (0, contracts_1.getContractAddress)(chainId, "faucet");
+    const faucet = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("faucet"), provider);
+    try {
+        const [owner, paused, list] = await Promise.all([faucet.owner(), faucet.paused(), faucet.allTokens()]);
+        const tokens = await Promise.all(list.map(async (token) => {
+            const erc20 = new ethers_1.ethers.Contract(token, ERC20, provider);
+            const [symbol, decimals, balance, cap, approved] = await Promise.all([
+                erc20.symbol(),
+                erc20.decimals().then(Number),
+                erc20.balanceOf(address),
+                faucet.tokenCap(token),
+                faucet.approvedToken(token),
+            ]);
+            return { address: ethers_1.ethers.getAddress(token), symbol, decimals, balance: (0, amount_1.toAmount)(balance, decimals, symbol), cap: (0, amount_1.toAmount)(cap, decimals, symbol), approved };
+        }));
+        return { address: ethers_1.ethers.getAddress(address), owner, paused, tokens };
+    }
+    catch (error) {
+        throw (0, rpcError_1.toRpcError)("faucet.getState", error, { chainId, address });
+    }
+};
+exports.getState = getState;

package/dist/contracts/faucet/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./claim"), exports);
+__exportStar(require("./getState"), exports);

package/dist/contracts/zap/aladdin/inspectCurvePool.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inspectCurvePool = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const rpcError_1 = require("../../../utils/rpcError");
+const _types_1 = require("./_types");
+/**
+ * The zap's Curve swap calls by pool type (TokenZapLogic.swap), for pools indexed by plain `coins(i)`. The base, A, Y,
+ * meta and factory meta pools all swap through the same 4-argument int128 `exchange`, so they share CurveBasePool here.
+ */
+const SWAP_SIGNATURES = [
+    [_types_1.AladdinPoolType.CurveCryptoPool, "exchange(uint256,uint256,uint256,uint256)"],
+    [_types_1.AladdinPoolType.CurveFactoryPlainPool, "exchange(int128,int128,uint256,uint256,address)"],
+    [_types_1.AladdinPoolType.CurveTriCryptoPool, "exchange(uint256,uint256,uint256,uint256,bool)"],
+    [_types_1.AladdinPoolType.CurveBasePool, "exchange(int128,int128,uint256,uint256)"],
+];
+const MAX_COINS = 8;
+const ERC20 = ["function symbol() view returns (string)", "function decimals() view returns (uint8)"];
+/**
+ * Reads a Curve pool that may not be in the chain config, so a zap route can be built through it: its coins in index
+ * order with their symbols, and which zap pool types it can swap as. The types come from the swap function selectors in
+ * its deployed bytecode, which Vyper and Solidity dispatchers embed; a match means the call exists, not that the pool
+ * behaves as that type in every other way.
+ *
+ * @param chainId - The chain/network to use.
+ * @param pool - The pool address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @throws If the address has no code or no `coins(0)`.
+ */
+const inspectCurvePool = async (chainId, pool, provider) => {
+    if (!provider)
+        provider = new ethers_1.ethers.JsonRpcProvider(chains_1.default[chainId].rpcs[0]);
+    const address = ethers_1.ethers.getAddress(pool);
+    try {
+        const code = await provider.getCode(address);
+        if (code === "0x")
+            throw new Error(`${address} has no contract code`);
+        // Newer pools index coins with uint256, older ones with int128.
+        const byUint = new ethers_1.ethers.Contract(address, ["function coins(uint256) view returns (address)"], provider);
+        const byInt = new ethers_1.ethers.Contract(address, ["function coins(int128) view returns (address)"], provider);
+        const coinAt = (i) => byUint.coins(i).catch(() => byInt.coins(i)).catch(() => null);
+        const addresses = [];
+        for (let i = 0; i < MAX_COINS; i++) {
+            const coin = await coinAt(i);
+            if (!coin || coin === ethers_1.ethers.ZeroAddress)
+                break;
+            addresses.push(ethers_1.ethers.getAddress(coin));
+        }
+        if (!addresses.length)
+            throw new Error(`${address} has no coins(0); it is not a Curve pool this can read`);
+        const coins = await Promise.all(addresses.map(async (coin) => {
+            const erc20 = new ethers_1.ethers.Contract(coin, ERC20, provider);
+            const [symbol, decimals] = await Promise.all([erc20.symbol().catch(() => "?"), erc20.decimals().then(Number).catch(() => 18)]);
+            return { address: coin, symbol, decimals };
+        }));
+        const poolTypes = SWAP_SIGNATURES.filter(([, sig]) => code.toLowerCase().includes(ethers_1.ethers.id(sig).slice(2, 10))).map(([type]) => type);
+        return { pool: address, coins, poolTypes };
+    }
+    catch (error) {
+        throw (0, rpcError_1.toRpcError)("zap.aladdin.inspectCurvePool", error, { chainId, address });
+    }
+};
+exports.inspectCurvePool = inspectCurvePool;

package/dist/pools/rwaVault/adapters/erc721/getERC721VaultAdapterAssetValue.js

@@ -9,7 +9,7 @@ const rpcError_1 = require("../../../../utils/rpcError");
  * @param adapterAddress The ERC721 vault adapter address.
  * @param tokenId The NFT token id.
  * @param signer The signer to read with.
- * @returns The oracle value in crvUSD base units, 18 decimals.
+ * @returns The oracle value in USD, 18 decimals.
  */
 async function getERC721VaultAdapterAssetValue(adapterAddress, tokenId, signer) {
     if (!signer) {

package/dist/pools/rwaVault/adapters/erc721/getERC721VaultAdapterTotalValue.js

@@ -8,7 +8,7 @@ const rpcError_1 = require("../../../../utils/rpcError");
  * Reads the value of all NFTs held by an ERC721 vault adapter.
  * @param adapterAddress The ERC721 vault adapter address.
  * @param signer The signer to read with.
- * @returns The summed oracle value in crvUSD base units, 18 decimals.
+ * @returns The summed oracle value in USD, 18 decimals.
  */
 async function getERC721VaultAdapterTotalValue(adapterAddress, signer) {
     if (!signer) {

package/dist/pools/rwaVault/getRegisteredAdapters.js

@@ -42,7 +42,7 @@ async function readAdapter(address, provider) {
         adapter.totalValue().catch(() => null),
         erc721 ? adapter.getDepositedTokens() : Promise.resolve([]),
     ]);
-    return { type, token, tokenSymbol, tokenDecimals, value: value === null ? null : (0, amount_1.toAmount)(value, amount_1.WAD_DECIMALS, "crvUSD"), tokenIds: [...tokenIds] };
+    return { type, token, tokenSymbol, tokenDecimals, value: value === null ? null : (0, amount_1.toAmount)(value, amount_1.WAD_DECIMALS, erc721 ? "USD" : "crvUSD"), tokenIds: [...tokenIds] };
 }
 /**
  * Every adapter registered on the RWA vault, read from the vault's own arrays rather than the chain config (which

package/dist/pools/rwaVault/previewDeposit.js

@@ -6,7 +6,7 @@ const rpcError_1 = require("../../utils/rpcError");
 /**
  * Previews how many vault shares are minted for depositing `assetValue`.
  * @param chainId The chain id.
- * @param assetValue The asset value in vault value base units (crvUSD, 18 decimals, as returned by the vault adapters).
+ * @param assetValue The asset value in vault value base units (USD for house NFTs, 18 decimals, as returned by the vault adapters).
  * @param provider The provider to read with.
  * @returns The shares (rounded down), in share token (RWA index token) base units.
  */

package/dist/pools/rwaVault/previewWithdraw.js

@@ -6,7 +6,7 @@ const rpcError_1 = require("../../utils/rpcError");
 /**
  * Previews how many vault shares are burned to withdraw `assetValue`.
  * @param chainId The chain id.
- * @param assetValue The asset value in vault value base units (crvUSD, 18 decimals, as returned by the vault adapters).
+ * @param assetValue The asset value in vault value base units (USD for house NFTs, 18 decimals, as returned by the vault adapters).
  * @param provider The provider to read with.
  * @returns The shares (rounded up), in share token (RWA index token) base units.
  */

package/dist/types/RPCLibrary.d.ts

@@ -301,6 +301,7 @@ import { burnFrom as burnFromLeRAAC } from "./contracts/tokens/leRAAC/burnFrom";
 import { getMinterInfo as getMinterInfoLeRAAC } from "./contracts/tokens/leRAAC/getMinterInfo";
 import { getRoutes as getRoutesAladdin } from "./contracts/zap/aladdin/getRoutes";
 import { getCurvePoolToken as getCurvePoolTokenAladdin } from "./contracts/zap/aladdin/getCurvePoolToken";
+import { inspectCurvePool as inspectCurvePoolAladdin } from "./contracts/zap/aladdin/inspectCurvePool";
 import { getPool2Token as getPool2TokenAladdin } from "./contracts/zap/aladdin/getPool2Token";
 import { getOwner as getOwnerAladdin } from "./contracts/zap/aladdin/getOwner";
 import { getVersion as getVersionAladdin } from "./contracts/zap/aladdin/getVersion";
@@ -652,6 +653,7 @@ declare class RPCLibrary {
         aladdin: {
             getRoutes: typeof getRoutesAladdin;
             getCurvePoolToken: typeof getCurvePoolTokenAladdin;
+            inspectCurvePool: typeof inspectCurvePoolAladdin;
             getPool2Token: typeof getPool2TokenAladdin;
             getOwner: typeof getOwnerAladdin;
             getVersion: typeof getVersionAladdin;

package/dist/types/contracts/curve/common/_helpers.d.ts

@@ -1,6 +1,6 @@
 import { ethers, Provider, Signer } from "ethers";
 import { ChainId } from "../../../configs/chains";
-import { CurvePoolEntry, CurvePools } from "../../../configs/chains/chain";
+import { CurvePoolEntry, CurvePoolFlavour, CurvePools } from "../../../configs/chains/chain";
 /**
  * Reads every Curve pool flavour shares. Coin indexes differ (uint256 vs int128) only in swap and liquidity
  * methods, which are not here.
@@ -14,6 +14,12 @@ export declare function getCurvePoolContract(chainId: ChainId, poolAddressOrId:
     contract: ethers.Contract;
     provider: ethers.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.
+ */
+export declare const CURVE_POOL_WRITE_ABI: Record<CurvePoolFlavour, string[]>;
 /** The pool contract with its flavour's swap and liquidity ABI, bound to a signer or provider. */
 export declare function getCurvePoolFlavourContract(chainId: ChainId, poolAddressOrId: string, runner?: Signer | Provider): {
     entry: CurvePoolEntry;

package/dist/types/contracts/curve/common/getPoolInterface.d.ts

@@ -0,0 +1,12 @@
+import { ethers } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * The pool's swap and liquidity ABI for its flavour, for encoding calls that are sent elsewhere (e.g. queued in a
+ * Safe) instead of through `exchange` / `addLiquidity` / `removeLiquidity` / `removeLiquidityOneCoin`. Reads the config
+ * only; no RPC call is made.
+ *
+ * @param chainId - The chain/network to use.
+ * @param poolAddressOrId - The pool's key in the chain config's `curve` section, or its address.
+ * @returns The interface (stableswap-ng indexes coins with int128 and takes dynamic arrays, the crypto pools uint256 and fixed arrays).
+ */
+export declare const getPoolInterface: (chainId: ChainId, poolAddressOrId: string) => ethers.Interface;

package/dist/types/contracts/curve/common/getPoolState.d.ts

@@ -0,0 +1,43 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+import { ScaledValue, TokenAmount } from "../../../utils/amount";
+import { CurvePool } from "./getPools";
+export interface CurvePoolState {
+    pool: CurvePool;
+    /** Coin balances in pool index order, each in its own decimals and symbol. */
+    balances: TokenAmount[];
+    /** LP tokens in circulation (the pool is its own LP token, 18 decimals). */
+    totalSupply: TokenAmount;
+    /** `get_virtual_price()`: underlying per LP token, only grows with fees. */
+    virtualPrice: TokenAmount;
+    /** Value of one LP token in coin 0: `lp_price()` on crypto pools, the balances at oracle prices on stableswap pools. */
+    lpPrice: TokenAmount;
+    /** Price of each coin in coin 0, 18 decimals, from the pool's EMA oracle; `oraclePrices[0]` is 1. */
+    oraclePrices: TokenAmount[];
+    /** Price of each coin in coin 0 right now: `last_prices` on crypto pools, `get_p` on stableswap pools. */
+    spotPrices: TokenAmount[];
+    /** Crypto pools only: where liquidity is concentrated (`price_scale`), in coin 0. Null on stableswap pools. */
+    priceScale: TokenAmount[] | null;
+    /** Each balance valued in coin 0 at the oracle price; their sum is the pool's TVL in coin 0. */
+    values: TokenAmount[];
+    tvl: TokenAmount;
+    /** Current swap fee as a fraction (Curve's 1e10 scale). */
+    fee: ScaledValue;
+    /** Crypto pools: the fee range the current fee moves in, as fractions. Null on stableswap pools. */
+    feeRange: {
+        mid: ScaledValue;
+        out: ScaledValue;
+    } | null;
+    /** Amplification, as the pool's `A()` reports it (crypto pools scale it by 10000). */
+    A: bigint;
+}
+/**
+ * Reads a Curve pool's composition, prices and fees in one go: balances, LP supply, virtual and LP price, the
+ * oracle, spot and (crypto) scale price of every coin in coin 0, each balance's value in coin 0, and the fee and A.
+ *
+ * @param chainId - The chain/network to use.
+ * @param poolAddressOrId - The pool's key in the chain config's `curve` section, or its address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The pool's state; values and TVL are in coin 0's units at the oracle price.
+ */
+export declare const getPoolState: (chainId: ChainId, poolAddressOrId: string, provider?: Provider) => Promise<CurvePoolState>;

package/dist/types/contracts/curve/common/index.d.ts

@@ -4,6 +4,8 @@ export * from "./calcWithdrawOneCoin";
 export * from "./exchange";
 export * from "./getDy";
 export * from "./getPools";
+export * from "./getPoolInterface";
+export * from "./getPoolState";
 export * from "./getVirtualPrice";
 export * from "./removeLiquidity";
 export * from "./removeLiquidityOneCoin";

package/dist/types/contracts/faucet/getState.d.ts

@@ -0,0 +1,27 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../configs/chains";
+import { TokenAmount } from "../../utils/amount";
+export interface FaucetToken {
+    address: string;
+    symbol: string;
+    decimals: number;
+    /** What the faucet holds and can still give out. */
+    balance: TokenAmount;
+    /** The most one claim may take. */
+    cap: TokenAmount;
+    approved: boolean;
+}
+export interface FaucetState {
+    address: string;
+    owner: string;
+    paused: boolean;
+    tokens: FaucetToken[];
+}
+/**
+ * Reads the testnet faucet: its owner, whether it is paused, and every token it gives out with its balance and per-claim cap.
+ * The faucet has no deposit function; it is topped up with a plain ERC20 transfer.
+ *
+ * @param chainId - The chain/network to use; only chains with a `faucet` contract in their config (Sepolia).
+ * @param provider - Optional ethers.js Provider instance.
+ */
+export declare const getState: (chainId: ChainId, provider?: Provider) => Promise<FaucetState>;

package/dist/types/contracts/faucet/index.d.ts

@@ -1 +1,2 @@
 export * from "./claim";
+export * from "./getState";

package/dist/types/contracts/zap/aladdin/inspectCurvePool.d.ts

@@ -0,0 +1,28 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+import { AladdinPoolType } from "./_types";
+export interface InspectedCoin {
+    address: string;
+    /** "?" when the token has no readable symbol. */
+    symbol: string;
+    decimals: number;
+}
+export interface InspectedCurvePool {
+    pool: string;
+    /** In pool index order: the index a route hop uses. */
+    coins: InspectedCoin[];
+    /** Zap pool types whose swap call the pool's bytecode has, best match first; empty when none is found. */
+    poolTypes: AladdinPoolType[];
+}
+/**
+ * Reads a Curve pool that may not be in the chain config, so a zap route can be built through it: its coins in index
+ * order with their symbols, and which zap pool types it can swap as. The types come from the swap function selectors in
+ * its deployed bytecode, which Vyper and Solidity dispatchers embed; a match means the call exists, not that the pool
+ * behaves as that type in every other way.
+ *
+ * @param chainId - The chain/network to use.
+ * @param pool - The pool address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @throws If the address has no code or no `coins(0)`.
+ */
+export declare const inspectCurvePool: (chainId: ChainId, pool: string, provider?: Provider) => Promise<InspectedCurvePool>;

package/dist/types/pools/rwaVault/adapters/erc721/getERC721VaultAdapterAssetValue.d.ts

@@ -5,7 +5,7 @@ import { TokenAmount } from "../../../../utils/amount";
  * @param adapterAddress The ERC721 vault adapter address.
  * @param tokenId The NFT token id.
  * @param signer The signer to read with.
- * @returns The oracle value in crvUSD base units, 18 decimals.
+ * @returns The oracle value in USD, 18 decimals.
  */
 declare function getERC721VaultAdapterAssetValue(adapterAddress: string, tokenId: bigint, signer: Signer): Promise<TokenAmount>;
 export default getERC721VaultAdapterAssetValue;

package/dist/types/pools/rwaVault/adapters/erc721/getERC721VaultAdapterTotalValue.d.ts

@@ -4,7 +4,7 @@ import { TokenAmount } from "../../../../utils/amount";
  * Reads the value of all NFTs held by an ERC721 vault adapter.
  * @param adapterAddress The ERC721 vault adapter address.
  * @param signer The signer to read with.
- * @returns The summed oracle value in crvUSD base units, 18 decimals.
+ * @returns The summed oracle value in USD, 18 decimals.
  */
 declare function getERC721VaultAdapterTotalValue(adapterAddress: string, signer: Signer): Promise<TokenAmount>;
 export default getERC721VaultAdapterTotalValue;

package/dist/types/pools/rwaVault/getRWAVaultInfo.d.ts

@@ -1,7 +1,7 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../configs/chains/index";
 import { TokenAmount } from "../../utils/amount";
-/** RWA vault state. Values are in crvUSD base units with 18 decimals, as priced by the vault adapters. */
+/** RWA vault state. Values are the sum of the adapters' values, 18 decimals: USD for the house NFT adapter (crvUSD for any ERC20 adapter). */
 export interface RWAVaultInfo {
     /** Total value of all assets held by the vault. */
     totalAssets: TokenAmount;

package/dist/types/pools/rwaVault/getRegisteredAdapters.d.ts

@@ -15,7 +15,7 @@ export interface RegisteredVaultAdapter {
     depositable: boolean;
     /** Listed in `redeemableERC721Adapters`. */
     redeemable: boolean;
-    /** Oracle value of everything held, in crvUSD with 18 decimals; null when the adapter could not price it. */
+    /** Oracle value of everything held, 18 decimals: USD for NFT adapters (RAACNFTVaultAdapterOracle), crvUSD for ERC20 adapters (their price oracle); null when the adapter could not price it. */
     value: TokenAmount | null;
     /** Token ids held, for ERC721 adapters. */
     tokenIds: bigint[];

package/dist/types/pools/rwaVault/previewDeposit.d.ts

@@ -4,7 +4,7 @@ import { TokenAmount } from "../../utils/amount";
 /**
  * Previews how many vault shares are minted for depositing `assetValue`.
  * @param chainId The chain id.
- * @param assetValue The asset value in vault value base units (crvUSD, 18 decimals, as returned by the vault adapters).
+ * @param assetValue The asset value in vault value base units (USD for house NFTs, 18 decimals, as returned by the vault adapters).
  * @param provider The provider to read with.
  * @returns The shares (rounded down), in share token (RWA index token) base units.
  */

package/dist/types/pools/rwaVault/previewWithdraw.d.ts

@@ -4,7 +4,7 @@ import { TokenAmount } from "../../utils/amount";
 /**
  * Previews how many vault shares are burned to withdraw `assetValue`.
  * @param chainId The chain id.
- * @param assetValue The asset value in vault value base units (crvUSD, 18 decimals, as returned by the vault adapters).
+ * @param assetValue The asset value in vault value base units (USD for house NFTs, 18 decimals, as returned by the vault adapters).
  * @param provider The provider to read with.
  * @returns The shares (rounded up), in share token (RWA index token) base units.
  */

package/dist/types/utils/artifacts.d.ts

@@ -2383,6 +2383,32 @@ declare const ABIS: {
         type: string;
         anonymous?: undefined;
     })[];
+    faucet: ({
+        type: string;
+        name: string;
+        constant: boolean;
+        stateMutability: string;
+        payable: boolean;
+        inputs: {
+            type: string;
+            name: string;
+        }[];
+        outputs: {
+            type: string;
+            name: string;
+        }[];
+    } | {
+        type: string;
+        name: string;
+        constant: boolean;
+        payable: boolean;
+        inputs: {
+            type: string;
+            name: string;
+        }[];
+        outputs: any[];
+        stateMutability?: undefined;
+    })[];
     pmmarket: any[];
     pmtreasury: any[];
     pmblender: any[];
@@ -5313,6 +5339,31 @@ declare const getABI: (name: keyof typeof ABIS) => any[] | ({
     inputs?: undefined;
     name?: undefined;
     outputs?: undefined;
+})[] | ({
+    type: string;
+    name: string;
+    constant: boolean;
+    stateMutability: string;
+    payable: boolean;
+    inputs: {
+        type: string;
+        name: string;
+    }[];
+    outputs: {
+        type: string;
+        name: string;
+    }[];
+} | {
+    type: string;
+    name: string;
+    constant: boolean;
+    payable: boolean;
+    inputs: {
+        type: string;
+        name: string;
+    }[];
+    outputs: any[];
+    stateMutability?: undefined;
 })[] | ({
     inputs: any[];
     stateMutability: string;

package/dist/utils/artifacts.js

@@ -60,6 +60,8 @@ const LiquidEscrowedRAAC_json_1 = __importDefault(require("../artifacts/core/tok
 // Zap
 const AladdinZap_json_1 = __importDefault(require("../artifacts/zap/AladdinZap.sol/AladdinZap.json"));
 // PSM
+// Testnet faucet (hand-written ABI, Sepolia only)
+const Faucet_json_1 = __importDefault(require("../artifacts/faucet/Faucet.json"));
 const PSMVault_json_1 = __importDefault(require("../artifacts/core/psm/PSMVault.sol/PSMVault.json"));
 const RateProvider_json_1 = __importDefault(require("../artifacts/core/psm/RateProvider.sol/RateProvider.json"));
 const CRVUSD_ABI = crvUSDToken_json_1.default.abi;
@@ -147,6 +149,7 @@ const ABIS = {
     governance: Governance_json_1.default.abi,
     timelockcontroller: TimelockController_json_1.default.abi,
     // PM Market
+    faucet: Faucet_json_1.default.abi,
     pmmarket: PMMARKET_ABI,
     // PM Treasury
     pmtreasury: PMTREASURY_ABI,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@raac/rpc",
-	"version": "2.0.0-beta.17",
+	"version": "2.0.0-beta.19",
 	"description": "RPC Library for RAAC",
 	"main": "dist/index.js",
 	"types": "dist/types/index.d.ts",