@raac/rpc 2.0.0-beta.2 → 2.0.0-beta.4

package/dist/pools/rwaVault/redeemNFTFromRWAVault.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const _helpers_1 = require("./_helpers");
 const getAdapterAddress_1 = require("./getAdapterAddress");
+const getContractAddress_1 = require("../../contracts/getContractAddress");
+const rpcError_1 = require("../../utils/rpcError");
 /**
  * Burns vault shares to redeem a specific NFT from the RWA vault.
  * @param chainId The chain id.
@@ -15,6 +17,7 @@ async function redeemNFTFromRWAVault(chainId, adapter, tokenId, maxSharesBurn, s
     if (!signer) {
         throw new Error("Wallet not connected");
     }
+    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "rwavault");
     try {
         const rwaVaultContract = await (0, _helpers_1.getRWAVaultContract)(chainId, signer);
         const address = (0, getAdapterAddress_1.getAdapterAddress)(chainId, adapter)?.address;
@@ -22,14 +25,11 @@ async function redeemNFTFromRWAVault(chainId, adapter, tokenId, maxSharesBurn, s
             throw new Error(`Adapter ${adapter} not found`);
         }
         const tx = await rwaVaultContract.redeemNFT(address, tokenId, maxSharesBurn);
-        console.log(`Redeem NFT transaction sent to RWA Vault:`, tx.hash);
         const receipt = await tx.wait();
-        console.log(`Redeemed NFT from RWA Vault successfully:`, receipt?.hash);
         return receipt;
     }
     catch (error) {
-        console.error(`Error redeeming NFT from RWA Vault:`, error);
-        throw new Error(`Redeem NFT from RWA Vault failed: ${error.message}`);
+        throw (0, rpcError_1.toRpcError)("rwaVault.redeemNFTFromRWAVault", error, { chainId, address: contractAddress });
     }
 }
 exports.default = redeemNFTFromRWAVault;

package/dist/pools/rwaVault/requestRandomSeed.js

@@ -1,23 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const _helpers_1 = require("./_helpers");
+const getContractAddress_1 = require("../../contracts/getContractAddress");
+const rpcError_1 = require("../../utils/rpcError");
 async function requestRandomSeed(chainId, signer) {
     if (!signer) {
         throw new Error("Wallet not connected");
     }
+    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "rwavault");
     try {
         const rwaVaultContract = await (0, _helpers_1.getRWAVaultContract)(chainId, signer);
         const tx = await rwaVaultContract.requestRandomSeed({
             nonce: await signer.getNonce(),
         });
-        console.log(`Random seed request transaction sent to RWA Vault:`, tx.hash);
         const receipt = await tx.wait();
-        console.log(`Random seed requested successfully:`, receipt?.hash);
         return receipt;
     }
     catch (error) {
-        console.error(`Error requesting random seed:`, error);
-        throw new Error(`Random seed request failed: ${error.message}`);
+        throw (0, rpcError_1.toRpcError)("rwaVault.requestRandomSeed", error, { chainId, address: contractAddress });
     }
 }
 exports.default = requestRandomSeed;

package/dist/pools/stabilityPool/depositToStabilityPool.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const _helpers_1 = require("./_helpers");
+const getContractAddress_1 = require("../../contracts/getContractAddress");
+const rpcError_1 = require("../../utils/rpcError");
 /**
  * Deposits rToken into the stability pool and receives deToken.
  * @param chainId The chain id.
@@ -12,19 +14,17 @@ async function depositToStabilityPool(chainId, amount, signer) {
     if (!signer) {
         throw new Error("Wallet not connected");
     }
+    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "stabilitypool");
     try {
         const stabilityPoolContract = await (0, _helpers_1.getStabilityPoolContract)(chainId, signer);
         const tx = await stabilityPoolContract.deposit(amount, {
             nonce: await signer.getNonce(),
         });
-        console.log(`Deposit transaction sent to Stability Pool:`, tx.hash);
         const receipt = await tx.wait();
-        console.log(`Deposited ${amount} base units to Stability Pool successfully:`, receipt?.hash);
         return receipt;
     }
     catch (error) {
-        console.error(`Error depositing to Stability Pool:`, error);
-        throw new Error(`Deposit to Stability Pool failed: ${error.message}`);
+        throw (0, rpcError_1.toRpcError)("stabilityPool.depositToStabilityPool", error, { chainId, address: contractAddress });
     }
 }
 exports.default = depositToStabilityPool;

package/dist/pools/stabilityPool/getRawUserDepositsInStabilityPool.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const _helpers_1 = require("./_helpers");
 const _helpers_2 = require("../lendingPool/_helpers");
+const getContractAddress_1 = require("../../contracts/getContractAddress");
+const rpcError_1 = require("../../utils/rpcError");
 /**
  * Reads the user's raw stability pool deposit, without accrued interest.
  * @param chainId The chain id.
@@ -10,14 +12,14 @@ const _helpers_2 = require("../lendingPool/_helpers");
  * @returns The deposit in deToken base units (reserve asset, crvUSD, decimals).
  */
 async function getRawUserDepositInStabilityPool(chainId, address, provider) {
+    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "stabilitypool");
     try {
         const stabilityPoolContract = await (0, _helpers_1.getStabilityPoolContract)(chainId, provider);
         const value = await stabilityPoolContract.getUserDeposit(address);
         return (0, _helpers_2.toReserveAmount)(chainId, value);
     }
     catch (error) {
-        console.error("Error in getRawUserDepositInStabilityPool:", error);
-        throw error;
+        throw (0, rpcError_1.toRpcError)("stabilityPool.getRawUserDepositInStabilityPool", error, { chainId, address: contractAddress });
     }
 }
 exports.default = getRawUserDepositInStabilityPool;

package/dist/pools/stabilityPool/getStabilityPoolInfo.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const _helpers_1 = require("./_helpers");
 const _helpers_2 = require("../lendingPool/_helpers");
+const getContractAddress_1 = require("../../contracts/getContractAddress");
+const rpcError_1 = require("../../utils/rpcError");
 /**
  * Reads the stability pool's total deposits and, optionally, a user's deposit.
  * @param chainId The chain id.
@@ -10,6 +12,7 @@ const _helpers_2 = require("../lendingPool/_helpers");
  * @returns The totals; see `StabilityPoolInfo`.
  */
 async function getStabilityPoolInfo(chainId, address, provider) {
+    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "stabilitypool");
     try {
         const stabilityPoolContract = await (0, _helpers_1.getStabilityPoolContract)(chainId, provider);
         const [totalDeposits, userDeposit] = await Promise.all([
@@ -22,8 +25,7 @@ async function getStabilityPoolInfo(chainId, address, provider) {
         };
     }
     catch (error) {
-        console.error("Error fetching stability pool info:", error);
-        throw error;
+        throw (0, rpcError_1.toRpcError)("stabilityPool.getStabilityPoolInfo", error, { chainId, address: contractAddress });
     }
 }
 exports.default = getStabilityPoolInfo;

package/dist/pools/stabilityPool/getStabilityPoolTotalDeposits.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const _helpers_1 = require("./_helpers");
 const _helpers_2 = require("../lendingPool/_helpers");
+const getContractAddress_1 = require("../../contracts/getContractAddress");
+const rpcError_1 = require("../../utils/rpcError");
 /**
  * Reads the stability pool's total deposits (deToken total supply).
  * @param chainId The chain id.
@@ -9,14 +11,14 @@ const _helpers_2 = require("../lendingPool/_helpers");
  * @returns The total deposits in deToken base units (reserve asset, crvUSD, decimals).
  */
 async function getStabilityPoolTotalDeposits(chainId, provider) {
+    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "stabilitypool");
     try {
         const stabilityPoolContract = await (0, _helpers_1.getStabilityPoolContract)(chainId, provider);
         const totalDeposits = await stabilityPoolContract.getTotalDeposits();
         return (0, _helpers_2.toReserveAmount)(chainId, totalDeposits);
     }
     catch (error) {
-        console.error("Error fetching total deposits:", error);
-        throw error;
+        throw (0, rpcError_1.toRpcError)("stabilityPool.getStabilityPoolTotalDeposits", error, { chainId, address: contractAddress });
     }
 }
 exports.default = getStabilityPoolTotalDeposits;

package/dist/pools/stabilityPool/getWithdrawRequestInfo.js

@@ -4,6 +4,8 @@ exports.getWithdrawRequestInfo = getWithdrawRequestInfo;
 const _helpers_1 = require("./_helpers");
 const _helpers_2 = require("../lendingPool/_helpers");
 const amount_1 = require("../../utils/amount");
+const getContractAddress_1 = require("../../contracts/getContractAddress");
+const rpcError_1 = require("../../utils/rpcError");
 /**
  * Reads a user's pending stability pool withdraw request.
  * @param chainId The chain id.
@@ -12,6 +14,7 @@ const amount_1 = require("../../utils/amount");
  * @returns The request, or `null` when there is none.
  */
 async function getWithdrawRequestInfo(chainId, userAddress, provider) {
+    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "stabilitypool");
     try {
         const stabilityPoolContract = await (0, _helpers_1.getStabilityPoolContract)(chainId, provider);
         const [duration, request] = await Promise.all([
@@ -32,7 +35,6 @@ async function getWithdrawRequestInfo(chainId, userAddress, provider) {
         };
     }
     catch (error) {
-        console.error("Error in getWithdrawRequestInfo:", error);
-        throw error;
+        throw (0, rpcError_1.toRpcError)("stabilityPool.getWithdrawRequestInfo", error, { chainId, address: contractAddress });
     }
 }

package/dist/pools/stabilityPool/getWithdrawTimelockConfig.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWithdrawTimelockConfig = getWithdrawTimelockConfig;
+const _helpers_1 = require("./_helpers");
+const getContractAddress_1 = require("../../contracts/getContractAddress");
+const rpcError_1 = require("../../utils/rpcError");
+/**
+ * Reads the stability pool's withdraw timelock configuration. The pool's
+ * actual enforced window for a given request is `readyAt + delay` (see
+ * `getWithdrawRequestInfo`'s `readyAt`), not `withdrawTimelock(user).expireAt`.
+ */
+async function getWithdrawTimelockConfig(chainId, provider) {
+    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "stabilitypool");
+    try {
+        const stabilityPoolContract = await (0, _helpers_1.getStabilityPoolContract)(chainId, provider);
+        const [duration, delay] = await Promise.all([
+            stabilityPoolContract.withdrawTimelockDuration(),
+            stabilityPoolContract.withdrawTimelockDelay(),
+        ]);
+        return { duration: Number(duration), delay: Number(delay) };
+    }
+    catch (error) {
+        throw (0, rpcError_1.toRpcError)("stabilityPool.getWithdrawTimelockConfig", error, { chainId, address: contractAddress });
+    }
+}

package/dist/pools/stabilityPool/requestWithdraw.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.requestWithdraw = requestWithdraw;
 const _helpers_1 = require("./_helpers");
+const getContractAddress_1 = require("../../contracts/getContractAddress");
+const rpcError_1 = require("../../utils/rpcError");
 /**
  * Queues a timelocked stability pool withdrawal.
  * @param chainId The chain id.
@@ -13,16 +15,14 @@ async function requestWithdraw(chainId, amount, signer) {
     if (!signer) {
         throw new Error("Wallet not connected");
     }
+    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "stabilitypool");
     try {
         const stabilityPoolContract = await (0, _helpers_1.getStabilityPoolContract)(chainId, signer);
         const tx = await stabilityPoolContract.requestWithdraw(amount);
         const receipt = await tx.wait();
-        console.log(`Withdrawal request for ${amount} base units submitted successfully`);
-        console.log(`Transaction hash: ${receipt?.hash}`);
         return receipt;
     }
     catch (error) {
-        console.error("Error in requestWithdraw:", error);
-        throw error;
+        throw (0, rpcError_1.toRpcError)("stabilityPool.requestWithdraw", error, { chainId, address: contractAddress });
     }
 }

package/dist/pools/stabilityPool/withdrawFromStabilityPool.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const _helpers_1 = require("./_helpers");
+const getContractAddress_1 = require("../../contracts/getContractAddress");
+const rpcError_1 = require("../../utils/rpcError");
 /**
  * Redeems deToken from the stability pool for rToken. When a withdraw timelock is active, `amount` must match the pending request.
  * @param chainId The chain id.
@@ -12,19 +14,17 @@ async function withdrawFromStabilityPool(chainId, amount, signer) {
     if (!signer) {
         throw new Error("Wallet not connected");
     }
+    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "stabilitypool");
     try {
         const stabilityPoolContract = await (0, _helpers_1.getStabilityPoolContract)(chainId, signer);
         const tx = await stabilityPoolContract.withdraw(amount, {
             nonce: await signer.getNonce(),
         });
-        console.log(`Withdrawal transaction sent to Stability Pool:`, tx.hash);
         const receipt = await tx.wait();
-        console.log(`Withdrawn ${amount} base units from Stability Pool successfully:`, receipt?.hash);
         return receipt;
     }
     catch (error) {
-        console.error(`Error withdrawing from Stability Pool:`, error);
-        throw new Error(`Withdrawal from Stability Pool failed: ${error.message}`);
+        throw (0, rpcError_1.toRpcError)("stabilityPool.withdrawFromStabilityPool", error, { chainId, address: contractAddress });
     }
 }
 exports.default = withdrawFromStabilityPool;

package/dist/prices/computeStakingAPY.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeStakingAPY = computeStakingAPY;
+const tokenPricesUSD_1 = require("./tokenPricesUSD");
+/** Simple staking APY = annualized emission value (RAAC x $) over staked value. */
+function computeStakingAPY(weeklyEmissionRAAC, stakedAmount, stakingTokenPriceUSD) {
+    const annualEmissionUSD = weeklyEmissionRAAC * 52 * (0, tokenPricesUSD_1.getTokenPriceUSD)("raac");
+    const stakedUSD = stakedAmount * stakingTokenPriceUSD;
+    if (stakedUSD <= 0)
+        return 0;
+    return (annualEmissionUSD / stakedUSD) * 100;
+}

package/dist/prices/getCurveLPPriceUSD.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCurveLPPriceUSD = getCurveLPPriceUSD;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../configs/chains"));
+const getTokenMetadata_1 = require("../contracts/getTokenMetadata");
+const tokenPricesUSD_1 = require("./tokenPricesUSD");
+const CURVE_POOL_ABI = [
+    "function coins(uint256) view returns (address)",
+    "function balances(uint256) view returns (uint256)",
+    "function totalSupply() view returns (uint256)",
+];
+async function getCurveLPPriceUSD(chainId, token, provider) {
+    if (!provider) {
+        const rpcUrl = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpcUrl);
+    }
+    if (!token)
+        return null;
+    try {
+        const pool = new ethers_1.ethers.Contract(token, CURVE_POOL_ABI, provider);
+        const [c0, c1, b0, b1, supply] = await Promise.all([
+            pool.coins(0),
+            pool.coins(1),
+            pool.balances(0),
+            pool.balances(1),
+            pool.totalSupply(),
+        ]);
+        if (supply === 0n)
+            return 0;
+        const [meta0, meta1] = await Promise.all([
+            (0, getTokenMetadata_1.getTokenMetadata)(chainId, c0, provider).catch(() => null),
+            (0, getTokenMetadata_1.getTokenMetadata)(chainId, c1, provider).catch(() => null),
+        ]);
+        const p0 = (0, tokenPricesUSD_1.getTokenPriceUSD)(meta0?.symbol);
+        const p1 = (0, tokenPricesUSD_1.getTokenPriceUSD)(meta1?.symbol);
+        const tvl = Number(ethers_1.ethers.formatEther(b0)) * p0 + Number(ethers_1.ethers.formatEther(b1)) * p1;
+        return tvl / Number(ethers_1.ethers.formatEther(supply));
+    }
+    catch {
+        return null; // not a Curve pool
+    }
+}

package/dist/prices/getPrices.js

@@ -2,17 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPrices = void 0;
 const amount_1 = require("../utils/amount");
+const tokenPricesUSD_1 = require("./tokenPricesUSD");
 const ONE_USD = 10n ** BigInt(amount_1.WAD_DECIMALS);
-// TODO: fetch prices from coingecko / chainlink or similar.
+// TODO: fetch prices from coingecko / chainlink or similar; TOKEN_PRICES_USD
+// is a static placeholder map.
 /**
- * Returns the USD price of each token.
- * @returns The prices, each a USD price per whole token scaled by 1e18.
+ * Returns the static USD price of each known token.
+ * @returns The prices, each a USD price per whole token scaled by 1e18, keyed by lowercase symbol.
  */
 const getPrices = async () => {
-    return {
-        pmUSD: (0, amount_1.toScaled)(ONE_USD, amount_1.WAD_DECIMALS),
-        crvUSD: (0, amount_1.toScaled)(ONE_USD, amount_1.WAD_DECIMALS),
-        raac: (0, amount_1.toScaled)(ONE_USD, amount_1.WAD_DECIMALS),
-    };
+    const prices = {};
+    for (const [symbol, price] of Object.entries(tokenPricesUSD_1.TOKEN_PRICES_USD)) {
+        prices[symbol] = (0, amount_1.toScaled)(BigInt(price) * ONE_USD, amount_1.WAD_DECIMALS);
+    }
+    return prices;
 };
 exports.getPrices = getPrices;

package/dist/prices/getStakingTokenPriceUSD.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStakingTokenPriceUSD = getStakingTokenPriceUSD;
+const getCurveLPPriceUSD_1 = require("./getCurveLPPriceUSD");
+const getWrapperPriceUSD_1 = require("./getWrapperPriceUSD");
+const tokenPricesUSD_1 = require("./tokenPricesUSD");
+/**
+ * USD value of one unit of a gauge's staking token:
+ *  - wrapped gauges -> ERC4626 wrapper share price (underlying reserve token value),
+ *  - Curve-LP staking tokens -> LP price from pool reserves,
+ *  - otherwise -> static price by symbol.
+ */
+async function getStakingTokenPriceUSD(chainId, gauge, provider) {
+    if (gauge.wrapped) {
+        const wrapperAddr = gauge.wrapper ?? gauge.stakingToken;
+        if (wrapperAddr)
+            return (0, getWrapperPriceUSD_1.getWrapperPriceUSD)(chainId, wrapperAddr, gauge.underlyingSymbol ?? "pmusd", provider);
+    }
+    if (gauge.stakingToken) {
+        const lp = await (0, getCurveLPPriceUSD_1.getCurveLPPriceUSD)(chainId, gauge.stakingToken, provider);
+        if (lp != null)
+            return lp;
+    }
+    return (0, tokenPricesUSD_1.getTokenPriceUSD)(gauge.stakingTokenSymbol);
+}

package/dist/prices/getWrapperPriceUSD.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWrapperPriceUSD = getWrapperPriceUSD;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../configs/chains"));
+const tokenPricesUSD_1 = require("./tokenPricesUSD");
+const ERC4626_CONVERT_ABI = ["function convertToAssets(uint256) view returns (uint256)"];
+/**
+ * USD value of one ERC4626 wrapper share = assets-per-share x underlying price
+ * (e.g. a wrapped RToken share -> its reserve token per share x that token's price).
+ */
+async function getWrapperPriceUSD(chainId, wrapper, underlyingSymbol = "pmusd", provider) {
+    if (!provider) {
+        const rpcUrl = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpcUrl);
+    }
+    if (!wrapper)
+        return 0;
+    try {
+        const w = new ethers_1.ethers.Contract(wrapper, ERC4626_CONVERT_ABI, provider);
+        const assetsPerShare = Number(ethers_1.ethers.formatEther(await w.convertToAssets(ethers_1.ethers.parseEther("1"))));
+        // Falls back to pmUSD ($1) when the underlying symbol isn't priced -
+        // most wrapped RTokens are 1:1 with their reserve.
+        const underlyingPrice = (0, tokenPricesUSD_1.getTokenPriceUSD)(underlyingSymbol) || (0, tokenPricesUSD_1.getTokenPriceUSD)("pmusd");
+        return assetsPerShare * underlyingPrice;
+    }
+    catch {
+        return 0;
+    }
+}

package/dist/prices/tokenPricesUSD.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOKEN_PRICES_USD = void 0;
+exports.getTokenPriceUSD = getTokenPriceUSD;
+/**
+ * Canonical static USD price per whole token, by lowercase symbol. Testnet
+ * placeholder values - swap for a real oracle/feed in production.
+ */
+exports.TOKEN_PRICES_USD = {
+    raac: 5,
+    pmusd: 1,
+    crvusd: 1, // same token the chain config's asset registry displays as pmUSD
+    ireet: 1, // RWA index token (NAV ~ 0.995, rounded to 1 for display)
+};
+/** Static USD price for a token symbol (0 if unknown). */
+function getTokenPriceUSD(symbol) {
+    if (!symbol)
+        return 0;
+    return exports.TOKEN_PRICES_USD[symbol.toLowerCase()] ?? 0;
+}