@raac/rpc 1.1.0-beta.92 → 1.2.0-beta.10

package/dist/configs/chains/8453.json

@@ -1,7 +1,9 @@
 {
     "chainId": 8453,
     "name": "localhost",
-    "rpcs": ["http://127.0.0.1:8545"],
+    "rpcs": [
+        "http://127.0.0.1:8545"
+    ],
     "nativeCurrency": {
         "name": "ETH",
         "symbol": "ETH",
@@ -44,6 +46,21 @@
             "name": "Treasury",
             "contract": "0x5FC8d32690cc91D4c39d9d3abcBD16989F875707"
         },
+        "pmtreasury": {
+            "id": "pmtreasury",
+            "name": "PM Treasury",
+            "contract": "0x51C4348Af0C6066a2fd31Bd968Bc0c039fe27342"
+        },
+        "pmmarket": {
+            "id": "pmmarket",
+            "name": "PM Market",
+            "contract": "0x4e8ef157762f0b8a7ad0d9ff45f86b203a0658cc"
+        },
+        "pmblender": {
+            "id": "pmblender",
+            "name": "PM Blender",
+            "contract": "0x7a7f847fb60b0000e24cce07298dc73df8b8e56a"
+        },
         "repairfund": {
             "id": "repairfund",
             "name": "Repair Fund",
@@ -88,13 +105,49 @@
             "id": "crvusdtousdoracle",
             "name": "CRVUSD to USD Oracle",
             "contract": "0x9fE46736679d2D9a65F0992F2272dE9f3c7fa6e0"
+        }
+    },
+    "governance": {
+        "gaugerewardsdistributor": {
+            "id": "gaugerewardsdistributor",
+            "name": "Gauge Rewards Distributor",
+            "contract": "0xB06c856C8eaBd1d8321b687E188204C1018BC4E5"
+        },
+        "gaugecontroller": {
+            "id": "gaugecontroller",
+            "name": "Gauge Controller",
+            "contract": "0xddE78e6202518FF4936b5302cC2891ec180E8bFf"
+        },
+        "gauge": {
+            "id": "gauge",
+            "name": "Gauge",
+            "contract": "0x0000000000000000000000000000000000000000"
         },
-        "nftroyaltyfeecollector": {
-            "id": "nftroyaltyfeecollector",
-            "name": "NFT Royalty Fee Collector",
-            "contract": "0x352b225A9f96ad9d90A1e8db4f1908943729b511"
+        "raacgauge": {
+            "id": "raacgauge",
+            "name": "RAAC Gauge",
+            "contract": "0xaB7B4c595d3cE8C85e16DA86630f2fc223B05057"
+        },
+        "rwagauge": {
+            "id": "rwagauge",
+            "name": "RWA Gauge",
+            "contract": "0xAD523115cd35a8d4E60B3C0953E0E0ac10418309"
         }
     },
+    "proposals": [
+        {
+            "id": "a",
+            "label": "Pair A: Protocol Parameters",
+            "governance": "0xf7Cd8fa9b94DB2Aa972023b379c7f72c65E4De9D",
+            "timelock": "0xeD1DB453C3156Ff3155a97AD217b3087D5Dc5f6E"
+        },
+        {
+            "id": "b",
+            "label": "Pair B: Gauge Management",
+            "governance": "0x33b1B5Aa9Aa4Da83a332F0bC5cAC6A903FDE5d92",
+            "timelock": "0x5B3120d0dA5FDcBA7aef87A9c3c64829C1c0D76B"
+        }
+    ],
     "pools": {
         "stabilitypool": {
             "id": "stabilitypool",
@@ -121,11 +174,23 @@
             "decimals": 18,
             "contract": "0x0000000000000000000000000000000000000000"
         },
+        "pmusd": {
+            "id": "pmusd",
+            "name": "PMUSD",
+            "decimals": 18,
+            "contract": "0xC0c17dD08263C16f6b64E772fB9B723Bf1344DdF"
+        },
+        "xpm": {
+            "id": "xpm",
+            "name": "xPM",
+            "decimals": 18,
+            "contract": "0x75939CEb9FBa27A545fE27d1CBd228c29123687c"
+        },
         "crvusd": {
             "id": "crvusd",
             "name": "CRVUSD",
             "decimals": 18,
-            "contract": "0x5FbDB2315678afecb367f032d93F642f64180aa3"
+            "contract": "0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512"
         },
         "rtoken": {
             "id": "rtoken",
@@ -143,13 +208,13 @@
             "id": "raactoken",
             "name": "RAAC",
             "decimals": 18,
-            "contract": "0x9fE46736679d2D9a65F0992F2272dE9f3c7fa6e0"
+            "contract": "0x700b6A60ce7EaaEA56F065753d8dcB9653dbAD35"
         },
         "veraac": {
             "id": "veraac",
             "name": "VERAAC",
             "decimals": 18,
-            "contract": "0x8A791620dd6260079BF849Dc5567aDC3F2FdC318"
+            "contract": "0xe1DA8919f262Ee86f9BE05059C9280142CF23f48"
         },
         "debttoken": {
             "id": "debttoken",
@@ -180,6 +245,36 @@
             "name": "RAAC Token Collector",
             "decimals": 18,
             "contract": "0x0000000000000000000000000000000000000000"
+        },
+        "leraac": {
+            "id": "leraac",
+            "name": "Liquid Escrowed RAAC",
+            "decimals": 18,
+            "contract": "0xa513E6E4b8f2a923D98304ec87F64353C4D5C853"
+        }
+    },
+    "lockers": {
+        "raacliquidlocker": {
+            "id": "raacliquidlocker",
+            "name": "RAAC Liquid Locker",
+            "contract": "0x9A676e781A523b5d0C0e43731313A708CB607508"
+        },
+        "raacmaturityvault": {
+            "id": "raacmaturityvault",
+            "name": "RAAC Maturity Vault",
+            "contract": "0x8A791620dd6260079BF849Dc5567aDC3F2FdC318"
+        },
+        "raacbotlocker": {
+            "id": "raacbotlocker",
+            "name": "RAAC Bot Locker",
+            "contract": "0x0DCd1Bf9A1b36cE34237eEaFef220932846BCD82"
+        }
+    },
+    "zap": {
+        "aladdinzap": {
+            "id": "aladdinzap",
+            "name": "Aladdin Zap",
+            "contract": "0xB7f8BC63BbcaD18155201308C8f3540b07f84F5e"
         }
     },
     "adapters": {

package/dist/configs/chains/index.js

@@ -5,17 +5,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.configs = void 0;
 // @ts-ignore
+const _1_json_1 = __importDefault(require("./1.json")); // assert { type: "json" };
 const _8453_json_1 = __importDefault(require("./8453.json")); // assert { type: "json" };
 const _17000_json_1 = __importDefault(require("./17000.json")); // assert { type: "json" };
 const _11155111_json_1 = __importDefault(require("./11155111.json")); // assert { type: "json" };
 const _18453_json_1 = __importDefault(require("./18453.json")); // assert { type: "json" };
-const _1_json_1 = __importDefault(require("./1.json")); // assert { type: "json" };
 const chains = {
+    1: _1_json_1.default,
     8453: _8453_json_1.default,
     17000: _17000_json_1.default, // the interface is the same for all the chains, so taking this
     11155111: _11155111_json_1.default,
     18453: _18453_json_1.default,
-    1: _1_json_1.default
 };
 exports.default = chains;
 exports.configs = chains;

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,61 @@
+"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, so specific entries (gauges) come before aliases (governance.raacgauge). */
+const FLAT_SECTIONS = ["gauges", "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) });
+    };
+    for (const section of FLAT_SECTIONS) {
+        for (const [key, value] of Object.entries((config[section] ?? {}))) {
+            const abi = section === "gauges" ? abiKey((value.type ?? "raacgauge").toLowerCase()) : abiKey(key.toLowerCase());
+            push({ address: value.contract, id: value.id ?? key, name: value.name ?? key, section, abi });
+        }
+    }
+    // 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

@@ -22,9 +22,13 @@ const getContractAddress = (chainId, contractName) => {
     }
     const lookupKeys = [
         "contracts",
+        "governance",
         "assets",
         "pools",
         "nfts",
+        "lockers",
+        "zap",
+        "gauges",
     ];
     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,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claimAll = void 0;
+const ethers_1 = require("ethers");
+const getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Claims accrued rewards for multiple gauges in a single transaction.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gauges - Array of gauge addresses.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns Transaction after it has been mined.
+ */
+const claimAll = async (chainId, gauges, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
+    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
+    const contract = new ethers_1.ethers.Contract(address, abi, signer);
+    const tx = await contract.claimAll(gauges);
+    await tx.wait();
+    return tx;
+};
+exports.claimAll = claimAll;

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

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claimForGauge = void 0;
+const ethers_1 = require("ethers");
+const getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Claims accrued rewards for a gauge.
+ * Note: only callable by the gauge contract itself (msg.sender must == gauge).
+ *
+ * @param chainId - The chain/network to use.
+ * @param gauge - Address of the gauge.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns Transaction after it has been mined.
+ */
+const claimForGauge = async (chainId, gauge, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
+    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
+    const contract = new ethers_1.ethers.Contract(address, abi, signer);
+    const tx = await contract.claimForGauge(gauge);
+    await tx.wait();
+    return tx;
+};
+exports.claimForGauge = claimForGauge;

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

@@ -0,0 +1,27 @@
+"use strict";
+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");
+/**
+ * Deposits reward tokens into the distributor.
+ * The reward token must be pre-approved by the caller before calling.
+ *
+ * @param chainId - The chain/network to use.
+ * @param token - Address of the reward token.
+ * @param amount - Amount of reward tokens to deposit.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns Transaction after it has been mined.
+ */
+const deposit = async (chainId, token, amount, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
+    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
+    const contract = new ethers_1.ethers.Contract(address, abi, signer);
+    const tx = await contract.deposit(token, amount);
+    await tx.wait();
+    return tx;
+};
+exports.deposit = deposit;

package/dist/contracts/governance/distributor/getClaimableForGauge.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.getClaimableForGauge = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Gets the amount of rewards currently claimable for a gauge.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gauge - Address of the gauge.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns Claimable reward amount (bigint).
+ */
+const getClaimableForGauge = async (chainId, gauge, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
+    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
+    const contract = new ethers_1.ethers.Contract(address, abi, provider);
+    return contract.getClaimableForGauge(gauge);
+};
+exports.getClaimableForGauge = getClaimableForGauge;

package/dist/contracts/governance/distributor/getClaimedAtEpoch.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.getClaimedAtEpoch = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Gets the amount claimed by a gauge at a specific epoch.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gauge - Address of the gauge.
+ * @param epoch - The epoch to query.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns Amount claimed at the epoch (bigint).
+ */
+const getClaimedAtEpoch = async (chainId, gauge, epoch, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
+    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
+    const contract = new ethers_1.ethers.Contract(address, abi, provider);
+    return contract.claimedAtEpoch(gauge, 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 getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Gets the amount of a token deposited at a specific epoch.
+ *
+ * @param chainId - The chain/network to use.
+ * @param token - Address of the reward token.
+ * @param epoch - The epoch to query.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns Amount deposited at the epoch (bigint).
+ */
+const getDepositedAtEpoch = async (chainId, token, epoch, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
+    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
+    const contract = new ethers_1.ethers.Contract(address, abi, provider);
+    return contract.depositedAtEpoch(token, epoch);
+};
+exports.getDepositedAtEpoch = getDepositedAtEpoch;

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 getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Gets the gauge controller address used by the distributor.
+ *
+ * @param chainId - The chain/network to use.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns Gauge controller address (string).
+ */
+const getGaugeController = async (chainId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
+    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
+    const contract = new ethers_1.ethers.Contract(address, abi, provider);
+    return contract.gaugeController();
+};
+exports.getGaugeController = getGaugeController;

package/dist/contracts/governance/distributor/getLastClaimedEpoch.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.getLastClaimedEpoch = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Gets the last epoch claimed for a gauge.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gauge - Address of the gauge.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns Last claimed epoch (bigint).
+ */
+const getLastClaimedEpoch = async (chainId, gauge, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
+    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
+    const contract = new ethers_1.ethers.Contract(address, abi, provider);
+    return contract.lastClaimedEpoch(gauge);
+};
+exports.getLastClaimedEpoch = getLastClaimedEpoch;

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 getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Gets the distributor's period (epoch) duration in seconds.
+ *
+ * @param chainId - The chain/network to use.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns Period duration in seconds (bigint).
+ */
+const getPeriodDuration = async (chainId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
+    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
+    const contract = new ethers_1.ethers.Contract(address, abi, 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 getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Gets the reward token address used by the distributor.
+ *
+ * @param chainId - The chain/network to use.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns Reward token address (string).
+ */
+const getRewardToken = async (chainId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugerewardsdistributor");
+    const abi = (0, artifacts_1.getABI)("gaugerewardsdistributor");
+    const contract = new ethers_1.ethers.Contract(address, abi, provider);
+    return contract.rewardToken();
+};
+exports.getRewardToken = getRewardToken;