@raac/rpc 1.2.0-beta.9 → 2.0.0-beta.1

package/dist/contracts/pmTreasury/getCollateralRatio.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 getCollateralRatio(chainId) {
+const amount_1 = require("../../utils/amount");
+const _helpers_1 = require("./_helpers");
+/**
+ * Reads the pmTreasury collateral ratio.
+ * @param chainId The chain id.
+ * @param provider Optional provider; defaults to the chain's first configured RPC.
+ * @returns The collateral ratio scaled by 1e18 (`decimals: 18`, 1.5e18 = 150%).
+ */
+async function getCollateralRatio(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 collateralRatio = await pmTreasuryContract.collateralRatio();
-        return collateralRatio;
+        return (0, amount_1.toScaled)(collateralRatio, amount_1.WAD_DECIMALS);
     }
     catch (error) {
         console.error("Error getting collateral ratio:", error);
-        return -1;
+        throw error;
     }
 }
 exports.default = getCollateralRatio;

package/dist/contracts/pmTreasury/getCurrentNav.js

@@ -1,34 +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 getCurrentNav(chainId) {
+const amount_1 = require("../../utils/amount");
+const _helpers_1 = require("./_helpers");
+/**
+ * Reads the current NAVs of the base token, pmUSD and xPM.
+ * @param chainId The chain id.
+ * @param provider Optional provider; defaults to the chain's first configured RPC.
+ * @returns The NAVs, each scaled by 1e18.
+ */
+async function getCurrentNav(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 currentNav = await pmTreasuryContract.getCurrentNav();
         return {
-            goldNav: ethers_1.ethers.formatEther(currentNav._baseNav),
-            goldUSDNav: ethers_1.ethers.formatEther(currentNav._fNav),
-            xGoldNav: ethers_1.ethers.formatEther(currentNav._xNav),
+            goldNav: (0, amount_1.toScaled)(currentNav._baseNav, amount_1.WAD_DECIMALS),
+            goldUSDNav: (0, amount_1.toScaled)(currentNav._fNav, amount_1.WAD_DECIMALS),
+            xGoldNav: (0, amount_1.toScaled)(currentNav._xNav, amount_1.WAD_DECIMALS),
         };
     }
     catch (error) {
         console.error("Error getting current nav:", error);
-        return {
-            goldNav: -1,
-            goldUSDNav: -1,
-            xGoldNav: -1,
-        };
+        throw error;
     }
 }
 exports.default = getCurrentNav;

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/resolveName.js

@@ -0,0 +1,128 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveName = resolveName;
+exports.resolveNames = resolveNames;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../configs/chains"));
+const findContract_1 = require("./findContract");
+const registry_1 = __importDefault(require("../configs/registry"));
+const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+const BURN_ADDRESS = "0x000000000000000000000000000000000000dEaD";
+/** Universal, chain-agnostic entries that do not belong in a per-chain registry file. */
+const BUILTIN_REGISTRY = {
+    [ZERO_ADDRESS]: { name: "None", kind: "external" },
+    [ethers_1.ethers.getAddress(BURN_ADDRESS)]: { name: "Burn", kind: "external" },
+};
+/** address -> { name, expiresAt } | null (a confirmed miss, cached too so a repeat lookup does not re-hit the network). */
+const ensCache = new Map();
+const ENS_TTL_MS = 60 * 60 * 1000;
+function contractInfoToAddressName(info) {
+    return {
+        address: info.address,
+        name: info.name,
+        kind: info.section === "gauges" ? "gauge" : "contract",
+        source: "config",
+    };
+}
+function lookupRegistry(chainId, address) {
+    const builtin = BUILTIN_REGISTRY[address];
+    if (builtin)
+        return { address, ...builtin, source: "registry" };
+    const registry = registry_1.default[String(chainId)];
+    const entry = registry?.[address];
+    if (!entry)
+        return null;
+    return { address, ...entry, source: "registry" };
+}
+async function lookupEns(address, provider) {
+    const cached = ensCache.get(address);
+    if (cached && cached.expiresAt > Date.now()) {
+        return cached.name ? { address, name: cached.name, kind: "ens", source: "ens" } : null;
+    }
+    try {
+        const runner = provider ?? new ethers_1.ethers.JsonRpcProvider(chains_1.default[1].rpcs[0]);
+        const ensName = await runner.lookupAddress(address);
+        // Forward-verify: an ENS reverse record is set by its owner and can point anywhere,
+        // so trust it only once the name's forward resolution points back to this address.
+        const verified = ensName && ethers_1.ethers.getAddress((await runner.resolveName(ensName)) ?? "") === address;
+        const name = verified ? ensName : null;
+        ensCache.set(address, { name, expiresAt: Date.now() + ENS_TTL_MS });
+        return name ? { address, name, kind: "ens", source: "ens" } : null;
+    }
+    catch {
+        // A broken or slow ENS lookup must not fail the rest of resolution.
+        return null;
+    }
+}
+/**
+ * Resolves an address to a readable name.
+ *
+ * Checks the chain config (via `findContract`), then a curated registry of
+ * off-chain-known addresses (wallets, external protocols), then - mainnet
+ * only, and only once the first two miss - an ENS reverse lookup, forward-
+ * verified against the name it returns.
+ *
+ * @param chainId - The chain/network to use.
+ * @param address - Any-case address.
+ * @param options - `ens: false` skips the ENS step; `provider` reuses an existing connection for it.
+ * @returns The resolved name, or null when nothing matches.
+ */
+async function resolveName(chainId, address, options) {
+    if (!ethers_1.ethers.isAddress(address))
+        return null;
+    const target = ethers_1.ethers.getAddress(address);
+    const configMatch = (0, findContract_1.findContract)(chainId, target);
+    if (configMatch)
+        return contractInfoToAddressName(configMatch);
+    const registryMatch = lookupRegistry(chainId, target);
+    if (registryMatch)
+        return registryMatch;
+    if (options?.ens === false || String(chainId) !== "1")
+        return null;
+    return lookupEns(target, options?.provider);
+}
+/**
+ * Batch form of {@link resolveName}. Config and registry lookups run
+ * synchronously per address; only addresses that fall through to ENS pay for
+ * a network round trip, and those run concurrently.
+ *
+ * @param chainId - The chain/network to use.
+ * @param addresses - Any-case addresses.
+ * @param options - Same as {@link resolveName}.
+ * @returns A map from the (checksummed) input address to its resolved name, or null.
+ */
+async function resolveNames(chainId, addresses, options) {
+    const result = {};
+    const pending = [];
+    for (const raw of addresses) {
+        if (!ethers_1.ethers.isAddress(raw))
+            continue;
+        const target = ethers_1.ethers.getAddress(raw);
+        const configMatch = (0, findContract_1.findContract)(chainId, target);
+        if (configMatch) {
+            result[target] = contractInfoToAddressName(configMatch);
+            continue;
+        }
+        const registryMatch = lookupRegistry(chainId, target);
+        if (registryMatch) {
+            result[target] = registryMatch;
+            continue;
+        }
+        if (options?.ens === false || String(chainId) !== "1") {
+            result[target] = null;
+            continue;
+        }
+        pending.push(target);
+    }
+    if (pending.length > 0) {
+        const ensResults = await Promise.all(pending.map((address) => lookupEns(address, options?.provider)));
+        pending.forEach((address, i) => {
+            result[address] = ensResults[i];
+        });
+    }
+    return result;
+}
+exports.default = resolveName;

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;