@raac/rpc 1.2.0-beta.8 → 2.0.0-beta.0

package/dist/contracts/pmTreasury/getLeverageRatio.js

@@ -1,26 +1,23 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const ethers_1 = require("ethers");
-const contracts_1 = require("../../utils/contracts");
-const index_1 = require("../../configs/chains/index");
-// import { PMTreasury } from "../../typechain-types";
-const pmTreasury_json_1 = __importDefault(require("../../artifacts/core/pmTreasury/pmTreasury.json"));
-async function getLeverageRatio(chainId) {
+const amount_1 = require("../../utils/amount");
+const _helpers_1 = require("./_helpers");
+/**
+ * Reads the pmTreasury EMA leverage ratio of xPM.
+ * @param chainId The chain id.
+ * @param provider Optional provider; defaults to the chain's first configured RPC.
+ * @returns The leverage ratio scaled by 1e18 (`decimals: 18`, 2e18 = 2x).
+ */
+async function getLeverageRatio(chainId, provider) {
     try {
-        const provider = new ethers_1.ethers.JsonRpcProvider(index_1.configs[chainId].rpcs[0]);
-        const pmTreasuryAddress = (0, contracts_1.getContractAddress)(chainId, "pmtreasury");
-        // const pmTreasuryABI = getABI("pmtreasury");
-        const pmTreasuryABI = pmTreasury_json_1.default.abi;
-        const pmTreasuryContract = new ethers_1.ethers.Contract(pmTreasuryAddress, pmTreasuryABI, provider);
+        const runner = (0, _helpers_1.resolvePmTreasuryProvider)(chainId, provider);
+        const pmTreasuryContract = (0, _helpers_1.getPmTreasuryContract)(chainId, runner);
         const leverageRatio = await pmTreasuryContract.leverageRatio();
-        return leverageRatio;
+        return (0, amount_1.toScaled)(leverageRatio, amount_1.WAD_DECIMALS);
     }
     catch (error) {
         console.error("Error getting leverage ratio:", error);
-        return -1;
+        throw error;
     }
 }
 exports.default = getLeverageRatio;

package/dist/contracts/pmTreasury/getMaxMintablePMUSD.js

@@ -1,32 +1,28 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const ethers_1 = require("ethers");
-const contracts_1 = require("../../utils/contracts");
-const index_1 = require("../../configs/chains/index");
-// import { PMTreasury } from "../../typechain-types";
-const pmTreasury_json_1 = __importDefault(require("../../artifacts/core/pmTreasury/pmTreasury.json"));
-async function getMaxMintablePMUSD(chainId, newCollateralRatio) {
+const amount_1 = require("../../utils/amount");
+const _helpers_1 = require("./_helpers");
+/**
+ * Reads the most pmUSD mintable, and the base token needed, before the collateral ratio falls to `newCollateralRatio`.
+ * @param chainId The chain id.
+ * @param newCollateralRatio The target collateral ratio scaled by 1e18 (e.g. `1_300_000_000_000_000_000n` for 130%). Must be greater than 1e18.
+ * @param provider Optional provider; defaults to the chain's first configured RPC.
+ * @returns The base token amount (18 decimals) and the pmUSD amount (registry `pmusd` decimals and symbol).
+ */
+async function getMaxMintablePMUSD(chainId, newCollateralRatio, provider) {
+    (0, _helpers_1.assertCollateralRatio)(newCollateralRatio);
     try {
-        const provider = new ethers_1.ethers.JsonRpcProvider(index_1.configs[chainId].rpcs[0]);
-        const pmTreasuryAddress = (0, contracts_1.getContractAddress)(chainId, "pmtreasury");
-        // const pmTreasuryABI = getABI("pmtreasury");
-        const pmTreasuryABI = pmTreasury_json_1.default.abi;
-        const pmTreasuryContract = new ethers_1.ethers.Contract(pmTreasuryAddress, pmTreasuryABI, provider);
-        const maxMintable = await pmTreasuryContract.maxMintableFToken(ethers_1.ethers.parseEther(newCollateralRatio.toString()));
+        const runner = (0, _helpers_1.resolvePmTreasuryProvider)(chainId, provider);
+        const pmTreasuryContract = (0, _helpers_1.getPmTreasuryContract)(chainId, runner);
+        const result = await pmTreasuryContract.maxMintableFToken(newCollateralRatio);
         return {
-            maxPMIn: ethers_1.ethers.formatEther(maxMintable[0]),
-            maxPMUSDMintable: ethers_1.ethers.formatEther(maxMintable[1]),
+            maxPMIn: (0, amount_1.toAmount)(result[0], _helpers_1.BASE_TOKEN_DECIMALS),
+            maxPMUSDMintable: (0, amount_1.toTokenAmount)(chainId, "pmusd", result[1]),
         };
     }
     catch (error) {
         console.error("Error getting max mintable PMUSD:", error);
-        return {
-            maxPMIn: -1,
-            maxPMUSDUSDMintable: -1,
-        };
+        throw error;
     }
 }
 exports.default = getMaxMintablePMUSD;

package/dist/contracts/pmTreasury/getMaxMintablePMUSDWithoutBaseToken.js

@@ -1,30 +1,27 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const ethers_1 = require("ethers");
-const contracts_1 = require("../../utils/contracts");
-const index_1 = require("../../configs/chains/index");
-// import { PMTreasury } from "../../typechain-types";
-const pmTreasury_json_1 = __importDefault(require("../../artifacts/core/pmTreasury/pmTreasury.json"));
-async function getMaxMintablePMUSDWithoutBaseToken(chainId, newCollateralRatio) {
+const amount_1 = require("../../utils/amount");
+const _helpers_1 = require("./_helpers");
+/**
+ * Reads the most pmUSD mintable without depositing base token before the collateral ratio falls to `newCollateralRatio`.
+ * @param chainId The chain id.
+ * @param newCollateralRatio The target collateral ratio scaled by 1e18 (e.g. `1_300_000_000_000_000_000n` for 130%). Must be greater than 1e18.
+ * @param provider Optional provider; defaults to the chain's first configured RPC.
+ * @returns The pmUSD amount (registry `pmusd` decimals and symbol).
+ */
+async function getMaxMintablePMUSDWithoutBaseToken(chainId, newCollateralRatio, provider) {
+    (0, _helpers_1.assertCollateralRatio)(newCollateralRatio);
     try {
-        const provider = new ethers_1.ethers.JsonRpcProvider(index_1.configs[chainId].rpcs[0]);
-        const pmTreasuryAddress = (0, contracts_1.getContractAddress)(chainId, "pmtreasury");
-        // const pmTreasuryABI = getABI("pmtreasury");
-        const pmTreasuryABI = pmTreasury_json_1.default.abi;
-        const pmTreasuryContract = new ethers_1.ethers.Contract(pmTreasuryAddress, pmTreasuryABI, provider);
-        const maxMintable = await pmTreasuryContract.maxMintableFTokenWithoutBaseToken(ethers_1.ethers.parseEther(newCollateralRatio.toString()));
+        const runner = (0, _helpers_1.resolvePmTreasuryProvider)(chainId, provider);
+        const pmTreasuryContract = (0, _helpers_1.getPmTreasuryContract)(chainId, runner);
+        const maxMintable = await pmTreasuryContract.maxMintableFTokenWithoutBaseToken(newCollateralRatio);
         return {
-            maxPMUSDMintable: ethers_1.ethers.formatEther(maxMintable),
+            maxPMUSDMintable: (0, amount_1.toTokenAmount)(chainId, "pmusd", maxMintable),
         };
     }
     catch (error) {
         console.error("Error getting max mintable PMUSD:", error);
-        return {
-            maxPMUSDMintable: -1,
-        };
+        throw error;
     }
 }
 exports.default = getMaxMintablePMUSDWithoutBaseToken;

package/dist/contracts/pmTreasury/getMaxMintableXPM.js

@@ -1,32 +1,28 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const ethers_1 = require("ethers");
-const contracts_1 = require("../../utils/contracts");
-const index_1 = require("../../configs/chains/index");
-// import { PMTreasury } from "../../typechain-types";
-const pmTreasury_json_1 = __importDefault(require("../../artifacts/core/pmTreasury/pmTreasury.json"));
-async function getMaxMintablePMUSD(chainId, newCollateralRatio) {
+const amount_1 = require("../../utils/amount");
+const _helpers_1 = require("./_helpers");
+/**
+ * Reads the most xPM mintable, and the base token needed, before the collateral ratio rises to `newCollateralRatio`.
+ * @param chainId The chain id.
+ * @param newCollateralRatio The target collateral ratio scaled by 1e18 (e.g. `1_300_000_000_000_000_000n` for 130%). Must be greater than 1e18.
+ * @param provider Optional provider; defaults to the chain's first configured RPC.
+ * @returns The base token amount (18 decimals) and the xPM amount (registry `xpm` decimals and symbol).
+ */
+async function getMaxMintableXPM(chainId, newCollateralRatio, provider) {
+    (0, _helpers_1.assertCollateralRatio)(newCollateralRatio);
     try {
-        const provider = new ethers_1.ethers.JsonRpcProvider(index_1.configs[chainId].rpcs[0]);
-        const pmTreasuryAddress = (0, contracts_1.getContractAddress)(chainId, "pmtreasury");
-        // const pmTreasuryABI = getABI("pmtreasury");
-        const pmTreasuryABI = pmTreasury_json_1.default.abi;
-        const pmTreasuryContract = new ethers_1.ethers.Contract(pmTreasuryAddress, pmTreasuryABI, provider);
-        const maxMintable = await pmTreasuryContract.maxMintableXToken(ethers_1.ethers.parseEther(newCollateralRatio.toString()));
+        const runner = (0, _helpers_1.resolvePmTreasuryProvider)(chainId, provider);
+        const pmTreasuryContract = (0, _helpers_1.getPmTreasuryContract)(chainId, runner);
+        const result = await pmTreasuryContract.maxMintableXToken(newCollateralRatio);
         return {
-            maxPMIn: ethers_1.ethers.formatEther(maxMintable[0]),
-            maxXPMMintable: ethers_1.ethers.formatEther(maxMintable[1]),
+            maxPMIn: (0, amount_1.toAmount)(result[0], _helpers_1.BASE_TOKEN_DECIMALS),
+            maxXPMMintable: (0, amount_1.toTokenAmount)(chainId, "xpm", result[1]),
         };
     }
     catch (error) {
         console.error("Error getting max mintable XPM:", error);
-        return {
-            maxPMIn: -1,
-            maxXPMMintable: -1,
-        };
+        throw error;
     }
 }
-exports.default = getMaxMintablePMUSD;
+exports.default = getMaxMintableXPM;

package/dist/contracts/pmTreasury/getMaxRedeemablePMUSD.js

@@ -1,32 +1,28 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const ethers_1 = require("ethers");
-const contracts_1 = require("../../utils/contracts");
-const index_1 = require("../../configs/chains/index");
-// import { PMTreasury } from "../../typechain-types";
-const pmTreasury_json_1 = __importDefault(require("../../artifacts/core/pmTreasury/pmTreasury.json"));
-async function getMaxRedeemablePMUSD(chainId, newCollateralRatio) {
+const amount_1 = require("../../utils/amount");
+const _helpers_1 = require("./_helpers");
+/**
+ * Reads the most pmUSD redeemable, and the base token received, before the collateral ratio rises to `newCollateralRatio`.
+ * @param chainId The chain id.
+ * @param newCollateralRatio The target collateral ratio scaled by 1e18 (e.g. `1_300_000_000_000_000_000n` for 130%). Must be greater than 1e18.
+ * @param provider Optional provider; defaults to the chain's first configured RPC.
+ * @returns The base token amount (18 decimals) and the pmUSD amount (registry `pmusd` decimals and symbol).
+ */
+async function getMaxRedeemablePMUSD(chainId, newCollateralRatio, provider) {
+    (0, _helpers_1.assertCollateralRatio)(newCollateralRatio);
     try {
-        const provider = new ethers_1.ethers.JsonRpcProvider(index_1.configs[chainId].rpcs[0]);
-        const pmTreasuryAddress = (0, contracts_1.getContractAddress)(chainId, "pmtreasury");
-        // const pmTreasuryABI = getABI("pmtreasury");
-        const pmTreasuryABI = pmTreasury_json_1.default.abi;
-        const pmTreasuryContract = new ethers_1.ethers.Contract(pmTreasuryAddress, pmTreasuryABI, provider);
-        const maxRedeemable = await pmTreasuryContract.maxRedeemableFToken(ethers_1.ethers.parseEther(newCollateralRatio.toString()));
+        const runner = (0, _helpers_1.resolvePmTreasuryProvider)(chainId, provider);
+        const pmTreasuryContract = (0, _helpers_1.getPmTreasuryContract)(chainId, runner);
+        const result = await pmTreasuryContract.maxRedeemableFToken(newCollateralRatio);
         return {
-            maxPMOut: ethers_1.ethers.formatEther(maxRedeemable[0]),
-            maxPMUSDRedeemable: ethers_1.ethers.formatEther(maxRedeemable[1]),
+            maxPMOut: (0, amount_1.toAmount)(result[0], _helpers_1.BASE_TOKEN_DECIMALS),
+            maxPMUSDRedeemable: (0, amount_1.toTokenAmount)(chainId, "pmusd", result[1]),
         };
     }
     catch (error) {
         console.error("Error getting max redeemable PMUSD:", error);
-        return {
-            maxPMOut: -1,
-            maxPMUSDRedeemable: -1,
-        };
+        throw error;
     }
 }
 exports.default = getMaxRedeemablePMUSD;

package/dist/contracts/pmTreasury/getMaxRedeemableXPM.js

@@ -1,32 +1,28 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const ethers_1 = require("ethers");
-const contracts_1 = require("../../utils/contracts");
-const index_1 = require("../../configs/chains/index");
-// import { PMTreasury } from "../../typechain-types";
-const pmTreasury_json_1 = __importDefault(require("../../artifacts/core/pmTreasury/pmTreasury.json"));
-async function getMaxRedeemableXPM(chainId, newCollateralRatio) {
+const amount_1 = require("../../utils/amount");
+const _helpers_1 = require("./_helpers");
+/**
+ * Reads the most xPM redeemable, and the base token received, before the collateral ratio falls to `newCollateralRatio`.
+ * @param chainId The chain id.
+ * @param newCollateralRatio The target collateral ratio scaled by 1e18 (e.g. `1_300_000_000_000_000_000n` for 130%). Must be greater than 1e18.
+ * @param provider Optional provider; defaults to the chain's first configured RPC.
+ * @returns The base token amount (18 decimals) and the xPM amount (registry `xpm` decimals and symbol).
+ */
+async function getMaxRedeemableXPM(chainId, newCollateralRatio, provider) {
+    (0, _helpers_1.assertCollateralRatio)(newCollateralRatio);
     try {
-        const provider = new ethers_1.ethers.JsonRpcProvider(index_1.configs[chainId].rpcs[0]);
-        const pmTreasuryAddress = (0, contracts_1.getContractAddress)(chainId, "pmtreasury");
-        // const pmTreasuryABI = getABI("pmtreasury");
-        const pmTreasuryABI = pmTreasury_json_1.default.abi;
-        const pmTreasuryContract = new ethers_1.ethers.Contract(pmTreasuryAddress, pmTreasuryABI, provider);
-        const maxRedeemable = await pmTreasuryContract.maxRedeemableXToken(ethers_1.ethers.parseEther(newCollateralRatio.toString()));
+        const runner = (0, _helpers_1.resolvePmTreasuryProvider)(chainId, provider);
+        const pmTreasuryContract = (0, _helpers_1.getPmTreasuryContract)(chainId, runner);
+        const result = await pmTreasuryContract.maxRedeemableXToken(newCollateralRatio);
         return {
-            maxPMOut: ethers_1.ethers.formatEther(maxRedeemable[0]),
-            maxXPMRedeemable: ethers_1.ethers.formatEther(maxRedeemable[1]),
+            maxPMOut: (0, amount_1.toAmount)(result[0], _helpers_1.BASE_TOKEN_DECIMALS),
+            maxXPMRedeemable: (0, amount_1.toTokenAmount)(chainId, "xpm", result[1]),
         };
     }
     catch (error) {
         console.error("Error getting max redeemable XPM:", error);
-        return {
-            maxPMOut: -1,
-            maxXPMRedeemable: -1,
-        };
+        throw error;
     }
 }
 exports.default = getMaxRedeemableXPM;

package/dist/contracts/pmTreasury/getTotalBaseToken.js

@@ -1,26 +1,23 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const ethers_1 = require("ethers");
-const contracts_1 = require("../../utils/contracts");
-const index_1 = require("../../configs/chains/index");
-// import { PMTreasury } from "../../typechain-types";
-const pmTreasury_json_1 = __importDefault(require("../../artifacts/core/pmTreasury/pmTreasury.json"));
-async function getTotalBaseToken(chainId) {
+const amount_1 = require("../../utils/amount");
+const _helpers_1 = require("./_helpers");
+/**
+ * Reads the amount of base token held by the pmTreasury.
+ * @param chainId The chain id.
+ * @param provider Optional provider; defaults to the chain's first configured RPC.
+ * @returns The base token amount, with 18 decimals (fixed by the treasury math).
+ */
+async function getTotalBaseToken(chainId, provider) {
     try {
-        const provider = new ethers_1.ethers.JsonRpcProvider(index_1.configs[chainId].rpcs[0]);
-        const pmTreasuryAddress = (0, contracts_1.getContractAddress)(chainId, "pmtreasury");
-        // const pmTreasuryABI = getABI("pmtreasury");
-        const pmTreasuryABI = pmTreasury_json_1.default.abi;
-        const pmTreasuryContract = new ethers_1.ethers.Contract(pmTreasuryAddress, pmTreasuryABI, provider);
+        const runner = (0, _helpers_1.resolvePmTreasuryProvider)(chainId, provider);
+        const pmTreasuryContract = (0, _helpers_1.getPmTreasuryContract)(chainId, runner);
         const totalBaseToken = await pmTreasuryContract.totalBaseToken();
-        return ethers_1.ethers.formatEther(totalBaseToken);
+        return (0, amount_1.toAmount)(totalBaseToken, _helpers_1.BASE_TOKEN_DECIMALS);
     }
     catch (error) {
         console.error("Error getting total base token:", error);
-        return -1;
+        throw error;
     }
 }
 exports.default = getTotalBaseToken;

package/dist/contracts/tokens/RAAC/getBalance.js

@@ -5,15 +5,26 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getBalance = void 0;
 const ethers_1 = require("ethers");
-const chains_1 = require("../../../configs/chains");
+const chains_1 = __importDefault(require("../../../configs/chains"));
 const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const amount_1 = require("../../../utils/amount");
 const BALANCE_OF_ABI = "function balanceOf(address account) view returns (uint256)";
-const getBalance = async (chainId, address) => {
-    const rpc = chains_1.configs[chainId].rpcs[0];
-    const provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+/**
+ * Gets the RAAC balance of an account.
+ *
+ * @param chainId - The chain/network to use.
+ * @param address - The account to query.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The balance in RAAC base units, with the `raactoken` asset decimals from the chain config.
+ */
+const getBalance = async (chainId, address, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
     const contractAddress = (0, getContractAddress_1.default)(chainId, "raactoken");
     const contract = new ethers_1.ethers.Contract(contractAddress, [BALANCE_OF_ABI], provider);
     const balance = await contract.balanceOf(address);
-    return ethers_1.ethers.formatEther(balance);
+    return (0, amount_1.toTokenAmount)(chainId, "raactoken", balance);
 };
 exports.getBalance = getBalance;

package/dist/contracts/tokens/RAAC/getTotalSupply.js

@@ -5,20 +5,25 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTotalSupply = void 0;
 const ethers_1 = require("ethers");
-const chains_1 = require("../../../configs/chains");
+const chains_1 = __importDefault(require("../../../configs/chains"));
 const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const amount_1 = require("../../../utils/amount");
 const TOTAL_SUPPLY_ABI = "function totalSupply() view returns (uint256)";
 /**
+ * Gets the RAAC total supply.
  *
- * @param {number} chainId
- * @returns {Promise<string>}
+ * @param chainId - The chain/network to use.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The total supply in RAAC base units, with the `raactoken` asset decimals from the chain config.
  */
-const getTotalSupply = async (chainId) => {
-    const rpc = chains_1.configs[chainId].rpcs[0];
-    const provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+const getTotalSupply = async (chainId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
     const contractAddress = (0, getContractAddress_1.default)(chainId, "raactoken");
     const contract = new ethers_1.ethers.Contract(contractAddress, [TOTAL_SUPPLY_ABI], provider);
     const totalSupply = await contract.totalSupply();
-    return ethers_1.ethers.formatEther(totalSupply);
+    return (0, amount_1.toTokenAmount)(chainId, "raactoken", totalSupply);
 };
 exports.getTotalSupply = getTotalSupply;

package/dist/contracts/tokens/crvUSD/getBalance.js

@@ -5,15 +5,26 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getBalance = void 0;
 const ethers_1 = require("ethers");
-const chains_1 = require("../../../configs/chains");
+const chains_1 = __importDefault(require("../../../configs/chains"));
 const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const amount_1 = require("../../../utils/amount");
 const BALANCE_OF_ABI = "function balanceOf(address account) view returns (uint256)";
-const getBalance = async (chainId, address) => {
-    const rpc = chains_1.configs[chainId].rpcs[0];
-    const provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+/**
+ * Gets the crvUSD balance of an account.
+ *
+ * @param chainId - The chain/network to use.
+ * @param address - The account to query.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The balance in crvUSD base units, with the `crvusd` asset decimals from the chain config.
+ */
+const getBalance = async (chainId, address, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
     const contractAddress = (0, getContractAddress_1.default)(chainId, "crvusd");
     const contract = new ethers_1.ethers.Contract(contractAddress, [BALANCE_OF_ABI], provider);
     const balance = await contract.balanceOf(address);
-    return ethers_1.ethers.formatEther(balance);
+    return (0, amount_1.toTokenAmount)(chainId, "crvusd", balance);
 };
 exports.getBalance = getBalance;

package/dist/contracts/tokens/crvUSD/getTotalSupply.js

@@ -5,20 +5,25 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTotalSupply = void 0;
 const ethers_1 = require("ethers");
-const chains_1 = require("../../../configs/chains");
+const chains_1 = __importDefault(require("../../../configs/chains"));
 const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const amount_1 = require("../../../utils/amount");
 const TOTAL_SUPPLY_ABI = "function totalSupply() view returns (uint256)";
 /**
+ * Gets the crvUSD total supply.
  *
- * @param {number} chainId
- * @returns {Promise<string>}
+ * @param chainId - The chain/network to use.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The total supply in crvUSD base units, with the `crvusd` asset decimals from the chain config.
  */
-const getTotalSupply = async (chainId) => {
-    const rpc = chains_1.configs[chainId].rpcs[0];
-    const provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+const getTotalSupply = async (chainId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
     const contractAddress = (0, getContractAddress_1.default)(chainId, "crvusd");
     const contract = new ethers_1.ethers.Contract(contractAddress, [TOTAL_SUPPLY_ABI], provider);
     const totalSupply = await contract.totalSupply();
-    return ethers_1.ethers.formatEther(totalSupply);
+    return (0, amount_1.toTokenAmount)(chainId, "crvusd", totalSupply);
 };
 exports.getTotalSupply = getTotalSupply;

package/dist/contracts/tokens/leRAAC/approve.js

@@ -2,6 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.approve = void 0;
 const _helpers_1 = require("./_helpers");
+/**
+ * Approves `spender` to transfer the caller's leRAAC.
+ *
+ * @param chainId - The chain/network to use.
+ * @param spender - The spender to approve.
+ * @param amount - The allowance in leRAAC base units (18 decimals).
+ * @param signer - An ethers.js Signer instance (must be connected to wallet).
+ * @returns The approval transaction, after it is mined.
+ */
 const approve = async (chainId, spender, amount, signer) => {
     if (!signer)
         throw new Error("Signer is required");

package/dist/contracts/tokens/leRAAC/burn.js

@@ -4,6 +4,11 @@ exports.burn = void 0;
 const _helpers_1 = require("./_helpers");
 /**
  * Burn `amount` of the caller's leRAAC.
+ *
+ * @param chainId - The chain/network to use.
+ * @param amount - The amount in leRAAC base units (18 decimals).
+ * @param signer - An ethers.js Signer instance (must be connected to wallet).
+ * @returns The burn transaction, after it is mined.
  */
 const burn = async (chainId, amount, signer) => {
     if (!signer)

package/dist/contracts/tokens/leRAAC/burnFrom.js

@@ -4,6 +4,12 @@ exports.burnFrom = void 0;
 const _helpers_1 = require("./_helpers");
 /**
  * Burn `amount` of `account`'s leRAAC. Caller must have ERC20 allowance from `account`.
+ *
+ * @param chainId - The chain/network to use.
+ * @param account - The account to burn from.
+ * @param amount - The amount in leRAAC base units (18 decimals).
+ * @param signer - An ethers.js Signer instance (must be connected to wallet).
+ * @returns The burn transaction, after it is mined.
  */
 const burnFrom = async (chainId, account, amount, signer) => {
     if (!signer)

package/dist/contracts/tokens/leRAAC/getAllowance.js

@@ -1,11 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getAllowance = void 0;
-const ethers_1 = require("ethers");
 const _helpers_1 = require("./_helpers");
+const amount_1 = require("../../../utils/amount");
+/**
+ * Gets the leRAAC allowance `owner` granted to `spender`.
+ *
+ * @param chainId - The chain/network to use.
+ * @param owner - The token owner.
+ * @param spender - The approved spender.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The allowance in leRAAC base units, with the `leraac` asset decimals from the chain config.
+ */
 const getAllowance = async (chainId, owner, spender, provider) => {
     const contract = await (0, _helpers_1.getLeRAACContract)(chainId, provider);
     const allowance = await contract.allowance(owner, spender);
-    return ethers_1.ethers.formatEther(allowance);
+    return (0, amount_1.toTokenAmount)(chainId, "leraac", allowance);
 };
 exports.getAllowance = getAllowance;

package/dist/contracts/tokens/leRAAC/getBalance.js

@@ -1,11 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getBalance = void 0;
-const ethers_1 = require("ethers");
 const _helpers_1 = require("./_helpers");
+const amount_1 = require("../../../utils/amount");
+/**
+ * Gets the leRAAC balance of an account.
+ *
+ * @param chainId - The chain/network to use.
+ * @param address - The account to query.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The balance in leRAAC base units, with the `leraac` asset decimals from the chain config.
+ */
 const getBalance = async (chainId, address, provider) => {
     const contract = await (0, _helpers_1.getLeRAACContract)(chainId, provider);
     const balance = await contract.balanceOf(address);
-    return ethers_1.ethers.formatEther(balance);
+    return (0, amount_1.toTokenAmount)(chainId, "leraac", balance);
 };
 exports.getBalance = getBalance;

package/dist/contracts/tokens/leRAAC/getMinterInfo.js

@@ -2,6 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getMinterInfo = void 0;
 const _helpers_1 = require("./_helpers");
+const amount_1 = require("../../../utils/amount");
+/**
+ * Gets a minter's role status, mint ceiling and minted amount on leRAAC.
+ *
+ * @param chainId - The chain/network to use.
+ * @param minter - The minter address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The minter info; `ceiling` and `minted` use the `leraac` asset decimals from the chain config.
+ */
 const getMinterInfo = async (chainId, minter, provider) => {
     const contract = await (0, _helpers_1.getLeRAACContract)(chainId, provider);
     const [info, isMinter] = await Promise.all([
@@ -10,6 +19,6 @@ const getMinterInfo = async (chainId, minter, provider) => {
     ]);
     const ceiling = info.ceiling ?? info[0];
     const minted = info.minted ?? info[1];
-    return { isMinter, ceiling, minted };
+    return { isMinter, ceiling: (0, amount_1.toTokenAmount)(chainId, "leraac", ceiling), minted: (0, amount_1.toTokenAmount)(chainId, "leraac", minted) };
 };
 exports.getMinterInfo = getMinterInfo;

package/dist/contracts/tokens/leRAAC/getTotalSupply.js

@@ -1,11 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTotalSupply = void 0;
-const ethers_1 = require("ethers");
 const _helpers_1 = require("./_helpers");
+const amount_1 = require("../../../utils/amount");
+/**
+ * Gets the leRAAC total supply.
+ *
+ * @param chainId - The chain/network to use.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The total supply in leRAAC base units, with the `leraac` asset decimals from the chain config.
+ */
 const getTotalSupply = async (chainId, provider) => {
     const contract = await (0, _helpers_1.getLeRAACContract)(chainId, provider);
     const supply = await contract.totalSupply();
-    return ethers_1.ethers.formatEther(supply);
+    return (0, amount_1.toTokenAmount)(chainId, "leraac", supply);
 };
 exports.getTotalSupply = getTotalSupply;

package/dist/contracts/tokens/leRAAC/transfer.js

@@ -2,6 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.transfer = void 0;
 const _helpers_1 = require("./_helpers");
+/**
+ * Transfers the caller's leRAAC to `to`.
+ *
+ * @param chainId - The chain/network to use.
+ * @param to - The recipient.
+ * @param amount - The amount in leRAAC base units (18 decimals).
+ * @param signer - An ethers.js Signer instance (must be connected to wallet).
+ * @returns The transfer transaction, after it is mined.
+ */
 const transfer = async (chainId, to, amount, signer) => {
     if (!signer)
         throw new Error("Signer is required");