@raac/rpc 1.2.0-beta.1 → 1.2.0-beta.11

package/dist/contracts/decodeCall.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeCall = void 0;
+const ethers_1 = require("ethers");
+const artifacts_1 = require("../utils/artifacts");
+const findContract_1 = require("./findContract");
+function formatValue(type, value) {
+    if (type.isArray()) {
+        return `[${value.map((item) => formatValue(type.arrayChildren, item)).join(", ")}]`;
+    }
+    if (type.isTuple()) {
+        return `(${type.components.map((component, i) => formatValue(component, value[i])).join(", ")})`;
+    }
+    if (type.baseType === "address")
+        return ethers_1.ethers.getAddress(value);
+    return String(value);
+}
+/**
+ * Decodes a call to a known contract: finds the target in the chain config,
+ * takes its ABI, and matches the calldata's selector to a function.
+ * Reads the chain config and bundled ABIs only; no RPC call is made.
+ *
+ * Arguments are returned raw, not formatted for display, so callers show
+ * exactly what the call would send.
+ *
+ * @param chainId - The chain/network to use.
+ * @param target - The address the call is sent to.
+ * @param calldata - The call's data, "0x" for a plain ETH transfer.
+ * @returns The contract, selector, signature and arguments; unknown parts are null.
+ */
+const decodeCall = (chainId, target, calldata) => {
+    const contract = (0, findContract_1.findContract)(chainId, target);
+    const data = calldata && calldata !== "0x" ? calldata : null;
+    const selector = data ? data.slice(0, 10).toLowerCase() : null;
+    if (!data || !contract?.abi) {
+        return { contract, selector, signature: null, args: [] };
+    }
+    const iface = new ethers_1.ethers.Interface((0, artifacts_1.getABI)(contract.abi));
+    let parsed = null;
+    try {
+        parsed = iface.parseTransaction({ data });
+    }
+    catch {
+        parsed = null;
+    }
+    if (!parsed) {
+        return { contract, selector, signature: null, args: [] };
+    }
+    return {
+        contract,
+        selector,
+        signature: parsed.signature,
+        args: parsed.fragment.inputs.map((input, i) => ({
+            name: input.name || `arg${i}`,
+            type: input.format("sighash"),
+            value: formatValue(input, parsed.args[i]),
+        })),
+    };
+};
+exports.decodeCall = decodeCall;
+exports.default = exports.decodeCall;

package/dist/contracts/findContract.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findContract = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../configs/chains"));
+const artifacts_1 = require("../utils/artifacts");
+/** Sections scanned in order; the first match wins. */
+const FLAT_SECTIONS = ["contracts", "governance", "pools", "lockers", "zap", "nfts", "assets"];
+const abiKey = (key) => (key in artifacts_1.ABIS ? key : null);
+const isDeployed = (address) => !!address && ethers_1.ethers.isAddress(address) && address !== ethers_1.ethers.ZeroAddress;
+/** Builds every configured contract on the chain with its name and ABI key. */
+function listContracts(chainId) {
+    const config = chains_1.default[chainId];
+    if (!config) {
+        throw new Error(`Chain configuration not found for chainId: ${chainId}`);
+    }
+    const found = [];
+    const push = (entry) => {
+        if (isDeployed(entry.address))
+            found.push({ ...entry, address: ethers_1.ethers.getAddress(entry.address) });
+    };
+    // gauges: { <system>: { label, gaugeType, controller, distributor, gauges: [{ id, name, contract }] } }
+    for (const [key, system] of Object.entries((config.gauges ?? {}))) {
+        push({ address: system.controller, id: `${key}.controller`, name: `${system.label} Controller`, section: "gauges", abi: "gaugecontroller" });
+        push({ address: system.distributor, id: `${key}.distributor`, name: `${system.label} Distributor`, section: "gauges", abi: "gaugerewardsdistributor" });
+        for (const gauge of system.gauges ?? []) {
+            push({ address: gauge.contract, id: gauge.id, name: gauge.name, section: "gauges", abi: abiKey(system.gaugeType.toLowerCase()) });
+        }
+    }
+    for (const section of FLAT_SECTIONS) {
+        for (const [key, value] of Object.entries((config[section] ?? {}))) {
+            push({ address: value.contract, id: value.id ?? key, name: value.name ?? key, section, abi: abiKey(key.toLowerCase()) });
+        }
+    }
+    // adapters: { <pool or vault>: { <adapter>: { contract, type: "ERC20" | "ERC721" } } }
+    for (const [owner, adapters] of Object.entries((config.adapters ?? {}))) {
+        for (const [key, value] of Object.entries(adapters)) {
+            const standard = (value.type ?? "").toLowerCase();
+            const kind = owner === "lendingpool" ? "assetadapter" : "vaultadapter";
+            push({ address: value.contract, id: value.id ?? key, name: value.name ?? key, section: "adapters", abi: abiKey(`${standard}${kind}`) });
+        }
+    }
+    // proposals: [{ id, label, governance, timelock }]
+    for (const instance of (config.proposals ?? [])) {
+        push({ address: instance.governance, id: `${instance.id}.governance`, name: `${instance.label} Governance`, section: "proposals", abi: "governance" });
+        push({ address: instance.timelock, id: `${instance.id}.timelock`, name: `${instance.label} Timelock`, section: "proposals", abi: "timelockcontroller" });
+    }
+    return found;
+}
+/**
+ * Finds a contract by address in the chain config.
+ * Reads the chain config only; no RPC call is made.
+ *
+ * @param chainId - The chain/network to use.
+ * @param address - Any-case contract address.
+ * @returns The contract's config entry and ABI key, or null if the chain config does not list it.
+ */
+const findContract = (chainId, address) => {
+    if (!ethers_1.ethers.isAddress(address))
+        return null;
+    const target = ethers_1.ethers.getAddress(address);
+    return listContracts(chainId).find((c) => c.address === target) ?? null;
+};
+exports.findContract = findContract;
+exports.default = exports.findContract;

package/dist/contracts/getContractAddress.js

@@ -26,6 +26,8 @@ const getContractAddress = (chainId, contractName) => {
         "assets",
         "pools",
         "nfts",
+        "lockers",
+        "zap",
     ];
     let address = null;
     for (const key of lookupKeys) {

package/dist/contracts/governance/_helpers.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toGovernanceTxError = exports.requireAddress = void 0;
+const ethers_1 = require("ethers");
+const errorDecoder_1 = require("../../utils/errorDecoder");
+/**
+ * Validates and checksums a contract address passed by the caller.
+ *
+ * @param address - The address to validate.
+ * @param name - Contract name used in the error message.
+ * @returns The checksummed address.
+ */
+const requireAddress = (address, name) => {
+    if (!address || !ethers_1.ethers.isAddress(address)) {
+        throw new Error(`Invalid ${name} address: ${address}`);
+    }
+    return ethers_1.ethers.getAddress(address);
+};
+exports.requireAddress = requireAddress;
+/**
+ * Wraps a failed write so the message says what failed while the original
+ * error stays reachable: its code (a wallet rejection is ACTION_REJECTED), its
+ * revert data and the decoded custom error name.
+ *
+ * @param prefix - What was being attempted, e.g. "Failed to cast vote".
+ * @param error - The error ethers threw.
+ * @returns An Error carrying `code`, `data`, `errorName` and `cause`.
+ */
+const toGovernanceTxError = (prefix, error) => {
+    const data = error?.data ?? error?.error?.data ?? error?.info?.error?.data;
+    const errorName = error?.revert?.name ?? (0, errorDecoder_1.decodeErrorName)(typeof data === "string" ? data : undefined) ?? undefined;
+    const wrapped = new Error(`${(0, errorDecoder_1.attachDecodedError)(prefix, error)}: ${error?.shortMessage ?? error?.message ?? String(error)}`);
+    wrapped.code = error?.code;
+    wrapped.data = typeof data === "string" ? data : undefined;
+    wrapped.errorName = errorName;
+    wrapped.cause = error;
+    return wrapped;
+};
+exports.toGovernanceTxError = toGovernanceTxError;

package/dist/contracts/governance/distributor/claimAll.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claimAll = void 0;
+const ethers_1 = require("ethers");
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const _helpers_2 = require("../_helpers");
+/**
+ * Claims rewards for the caller on several gauges. Each gauge must be active.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param gaugeAddressesOrIds - Addresses or config ids of the gauges.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction after it has been mined.
+ */
+const claimAll = async (chainId, gaugeSystem, gaugeAddressesOrIds, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const gaugeAddresses = gaugeAddressesOrIds.map((g) => (0, _helpers_1.resolveGauge)(chainId, g));
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), signer);
+    try {
+        const tx = await contract.claimAll(gaugeAddresses);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to claim all", error);
+    }
+};
+exports.claimAll = claimAll;

package/dist/contracts/governance/distributor/claimForGauge.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claimForGauge = void 0;
+const ethers_1 = require("ethers");
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const _helpers_2 = require("../_helpers");
+/**
+ * Transfers a gauge's accrued share from the distributor to the gauge.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction after it has been mined.
+ */
+const claimForGauge = async (chainId, gaugeSystem, gaugeAddressOrId, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), signer);
+    try {
+        const tx = await contract.claimForGauge(gaugeAddress);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to claim for gauge", error);
+    }
+};
+exports.claimForGauge = claimForGauge;

package/dist/contracts/governance/distributor/deposit.js

@@ -2,35 +2,31 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deposit = void 0;
 const ethers_1 = require("ethers");
-const getContractAddress_1 = require("../../getContractAddress");
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const _helpers_2 = require("../_helpers");
 /**
- * Deposits reward tokens into the distributor.
- * Anyone can call this, but only for approved tokens.
- * Rewards are distributed to gauges based on their weights.
+ * Deposits reward tokens into the distributor for the current epoch. The token must be the distributor's reward token and pre-approved. Reverts when no gauge is registered.
  *
  * @param chainId - The chain/network to use.
- * @param tokenAddress - Address of the reward token.
- * @param amount - Amount of reward tokens to deposit.
- * @param signer - An ethers.js Signer instance (must be connected to wallet).
- * @returns Transaction receipt after the deposit is made.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param token - Address of the reward token.
+ * @param amount - Amount to deposit, base units.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction after it has been mined.
  */
-const deposit = async (chainId, tokenAddress, amount, signer) => {
-    if (!signer) {
+const deposit = async (chainId, gaugeSystem, token, amount, signer) => {
+    if (!signer)
         throw new Error("Signer is required");
-    }
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), signer);
     try {
-        const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
-        const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
-        const contract = new ethers_1.ethers.Contract(contractAddress, abi, signer);
-        const tx = await contract.deposit(tokenAddress, amount);
+        const tx = await contract.deposit(token, amount);
         await tx.wait();
-        console.log(`Deposited ${amount} of ${tokenAddress} to distributor`);
         return tx;
     }
     catch (error) {
-        console.error("Error depositing:", error);
-        throw new Error(`Failed to deposit: ${error.message}`);
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to deposit rewards", error);
     }
 };
 exports.deposit = deposit;

package/dist/contracts/governance/distributor/getClaimableForGauge.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getClaimableForGauge = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Estimates the rewards a gauge can still pull from the distributor.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The claimable amount, base units.
+ */
+const getClaimableForGauge = async (chainId, gaugeSystem, gaugeAddressOrId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
+    return contract.getClaimableForGauge(gaugeAddress);
+};
+exports.getClaimableForGauge = getClaimableForGauge;

package/dist/contracts/governance/distributor/getClaimedAtEpoch.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getClaimedAtEpoch = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Returns how much a gauge has already pulled for an epoch.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param epoch - Epoch start timestamp, seconds.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The claimed amount, base units.
+ */
+const getClaimedAtEpoch = async (chainId, gaugeSystem, gaugeAddressOrId, epoch, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
+    return contract.claimedAtEpoch(gaugeAddress, epoch);
+};
+exports.getClaimedAtEpoch = getClaimedAtEpoch;

package/dist/contracts/governance/distributor/getDepositedAtEpoch.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDepositedAtEpoch = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Returns the rewards deposited into the distributor for an epoch.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param token - Address of the reward token.
+ * @param epoch - Epoch start timestamp, seconds.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The deposited amount, base units.
+ */
+const getDepositedAtEpoch = async (chainId, gaugeSystem, token, epoch, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
+    return contract.depositedAtEpoch(token, epoch);
+};
+exports.getDepositedAtEpoch = getDepositedAtEpoch;

package/dist/contracts/governance/distributor/getDustLastProcessedEpoch.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDustLastProcessedEpoch = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Returns the cursor of the last epoch swept by `withdrawDust`.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The epoch timestamp, seconds.
+ */
+const getDustLastProcessedEpoch = async (chainId, gaugeSystem, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
+    return contract.dustLastProcessedEpoch();
+};
+exports.getDustLastProcessedEpoch = getDustLastProcessedEpoch;

package/dist/contracts/governance/distributor/getGaugeController.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGaugeController = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Returns the GaugeController the distributor reads weights from.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The controller address.
+ */
+const getGaugeController = async (chainId, gaugeSystem, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
+    return contract.gaugeController();
+};
+exports.getGaugeController = getGaugeController;

package/dist/contracts/governance/distributor/getLastClaimedEpoch.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLastClaimedEpoch = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Returns the epoch a gauge's next claim starts walking from.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The epoch timestamp, seconds.
+ */
+const getLastClaimedEpoch = async (chainId, gaugeSystem, gaugeAddressOrId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
+    return contract.lastClaimedEpoch(gaugeAddress);
+};
+exports.getLastClaimedEpoch = getLastClaimedEpoch;

package/dist/contracts/governance/distributor/getMaxClaimBound.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMaxClaimBound = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Reads whether claim walks are capped and the cap in epochs.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns enabled flag and maxEpochs.
+ */
+const getMaxClaimBound = async (chainId, gaugeSystem, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
+    const [enabled, maxEpochs] = await Promise.all([contract.enableMaxClaimBound(), contract.MAX_EPOCHS()]);
+    return { enabled, maxEpochs };
+};
+exports.getMaxClaimBound = getMaxClaimBound;

package/dist/contracts/governance/distributor/getPeriodDuration.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPeriodDuration = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Returns the distributor's period duration.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The period duration, seconds.
+ */
+const getPeriodDuration = async (chainId, gaugeSystem, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
+    return contract.PERIOD_DURATION();
+};
+exports.getPeriodDuration = getPeriodDuration;

package/dist/contracts/governance/distributor/getRewardToken.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRewardToken = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Returns the single reward token the distributor pays out.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The reward token address.
+ */
+const getRewardToken = async (chainId, gaugeSystem, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
+    return contract.rewardToken();
+};
+exports.getRewardToken = getRewardToken;

package/dist/contracts/governance/distributor/getRewardTokenInfo.js

@@ -6,34 +6,24 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRewardTokenInfo = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
-const GET_REWARD_TOKEN_INFO_ABI = `function getRewardTokenInfo(address token) view returns (
-	uint256 totalDeposited,
-	uint256 totalDistributed,
-	uint256 totalClaimable,
-	uint256 balance
-)`;
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
- * Gets comprehensive statistics for a reward token.
+ * Reads the reward token totals and the distributor's current token balance.
  *
  * @param chainId - The chain/network to use.
- * @param tokenAddress - Address of the reward token.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Reward token info including deposits, distributions, and balances.
+ * @returns totalDeposited, totalDistributed, totalClaimable and balance, base units.
  */
-const getRewardTokenInfo = async (chainId, tokenAddress, provider) => {
+const getRewardTokenInfo = async (chainId, gaugeSystem, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
-    const contract = new ethers_1.ethers.Contract(contractAddress, [GET_REWARD_TOKEN_INFO_ABI], provider);
-    const [totalDeposited, totalDistributed, totalClaimable, balance] = await contract.getRewardTokenInfo(tokenAddress);
-    return {
-        totalDeposited: ethers_1.ethers.formatEther(totalDeposited),
-        totalDistributed: ethers_1.ethers.formatEther(totalDistributed),
-        totalClaimable: ethers_1.ethers.formatEther(totalClaimable),
-        balance: ethers_1.ethers.formatEther(balance),
-    };
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
+    const [totalDeposited, totalDistributed, totalClaimable, balance] = await contract.getRewardTokenInfo();
+    return { totalDeposited, totalDistributed, totalClaimable, balance };
 };
 exports.getRewardTokenInfo = getRewardTokenInfo;

package/dist/contracts/governance/distributor/getRewardTokenStats.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRewardTokenStats = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Reads the `rewardTokenInfo` mapping entry for a token.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeRewardsDistributor address.
+ * @param token - Address of the reward token.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns totalDeposited, totalDistributed and totalClaimable, base units.
+ */
+const getRewardTokenStats = async (chainId, gaugeSystem, token, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeDistributor)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugerewardsdistributor"), provider);
+    const [totalDeposited, totalDistributed, totalClaimable] = await contract.rewardTokenInfo(token);
+    return { totalDeposited, totalDistributed, totalClaimable };
+};
+exports.getRewardTokenStats = getRewardTokenStats;