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

package/dist/types/contracts/governance/gauge/getUserClaimableRewards.d.ts

@@ -11,26 +11,28 @@ export interface ClaimableExtraReward {
 }
 export interface UserClaimableRewards {
     gauge: string;
-    /** RAAC already accrued to the user inside the gauge (gauge.pendingRewards). */
+    /** The gauge's main reward token. */
+    rewardToken: string;
+    /** The distributor the gauge pulls its main reward from, read from the gauge. */
+    distributor: string;
+    /** Main reward already accrued to the user inside the gauge (gauge.pendingRewards), base units. */
     inGauge: bigint;
-    /** The user's pro-rata share of RAAC still sitting in the distributor for this gauge
-     *  (deposited but not yet pulled in via a claim). */
-    inDistributor: bigint;
-    /** Total claimable RAAC = inGauge + inDistributor, base units. */
+    /** Main reward the user can claim right now, base units. Same as `inGauge`. */
     raac: bigint;
-    /** Total claimable RAAC, formatted (18 decimals). */
+    /** `raac` formatted to the reward token's decimals. */
     raacFormatted: string;
     /** Extra reward tokens claimable by the user. */
     extras: ClaimableExtraReward[];
 }
 /**
- * The user's TRUE claimable rewards on a gauge.
+ * What a user can claim from a gauge right now: the main reward already accrued to them inside the gauge, plus any
+ * extra reward tokens.
  *
- * The gauge's `pendingRewards()` view only reflects RAAC already pulled into the gauge.
- * RAAC emitted to the gauge sits in the GaugeRewardsDistributor until a claim pulls it in
- * (`claimRewardToken`/`claimRewardsFor` call `_pullRewardsFromDistributor` first). So a
- * user's real claimable also includes their working-balance share of the distributor's
- * `getClaimableForGauge(gauge)`. This helper combines both, plus any extra reward tokens.
+ * Rewards still held by the GaugeRewardsDistributor are not included. They are not the user's yet: a pull
+ * (`pullRewardsFromDistributor`, or the pull every claim makes first) streams them to everyone staked over the rest of
+ * the reward period, so any per-user share of them would change with every stake, unstake and pull. Read the gauge's
+ * total still in the distributor with `governance.distributor.getClaimableForGauge` when it is needed.
+ * The distributor is read from the gauge itself, so RAAC and RWA gauges both resolve to their own system's distributor.
  *
  * @param chainId - The chain/network to use.
  * @param gaugeAddressOrId - Address of the gauge contract or its config ID.

package/dist/types/contracts/governance/gauge/getUserGaugeState.d.ts

@@ -0,0 +1,31 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+export interface UserGaugeTokenState {
+    address: string;
+    symbol: string;
+    decimals: number;
+    /** Wallet balance, base units. */
+    balance: bigint;
+    /** Allowance to `spender`, base units. */
+    allowance: bigint;
+    /** The contract that pulls the token: the gauge for the staking token, the wrapper for the underlying. */
+    spender: string;
+}
+export interface UserGaugeState {
+    gauge: string;
+    /** Staking token staked in the gauge, base units, without boost. */
+    staked: bigint;
+    stakingToken: UserGaugeTokenState;
+    /** The token to wrap before staking; null when the gauge takes its token directly. */
+    underlying: UserGaugeTokenState | null;
+}
+/**
+ * What a wallet needs to stake in, wrap for, or unstake from a gauge: its stake, its balance of the staking token and its
+ * allowance to the gauge, and for a wrapped gauge its balance of the underlying and allowance to the wrapper.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param user - The wallet.
+ * @param provider - Optional ethers.js Provider instance.
+ */
+export declare const getUserGaugeState: (chainId: ChainId, gaugeAddressOrId: string, user: string, provider?: Provider) => Promise<UserGaugeState>;

package/dist/types/contracts/governance/gauge/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./addRewardToken";
+export * from "./approveGaugeToken";
 export * from "./claimExtraReward";
 export * from "./claimExtraRewards";
 export * from "./claimOnBehalfOf";
@@ -6,15 +7,19 @@ export * from "./claimRewardsFor";
 export * from "./claimRewardToken";
 export * from "./depositRewardToken";
 export * from "./getAllPendingExtraRewards";
+export * from "./getApy";
 export * from "./getBalanceOf";
 export * from "./getControllerAddress";
 export * from "./getDecimalAdjustment";
 export * from "./getDepositRAACOnClaim";
 export * from "./getDistributorData";
 export * from "./getDistributors";
+export * from "./getEarnedExtraReward";
 export * from "./getEarnedReward";
 export * from "./getExtraRewardTokens";
+export * from "./getGaugeData";
 export * from "./getGaugeRewardTokenData";
+export * from "./getPauseStatus";
 export * from "./getPendingExtraRewards";
 export * from "./getPendingRewards";
 export * from "./getPeriodBoundaries";
@@ -22,18 +27,23 @@ export * from "./getPeriodDuration";
 export * from "./getRaacAutolockMin";
 export * from "./getRawBalanceOf";
 export * from "./getRawTotalSupply";
+export * from "./getRewardTokens";
 export * from "./getTotalSupply";
+export * from "./getUserApy";
 export * from "./getUserClaimableRewards";
+export * from "./getUserGaugeState";
 export * from "./getUserRewardTokenData";
 export * from "./getUserWeight";
 export * from "./isPaused";
 export * from "./manageDistributor";
+export * from "./pullRewardsFromDistributor";
 export * from "./setController";
 export * from "./setDepositRAACOnClaim";
-export * from "./setDistributorApproval";
 export * from "./setEmergencyPaused";
 export * from "./setGaugeRewardDistributor";
 export * from "./setRaacAutolockMin";
 export * from "./stake";
+export * from "./unwrapStakingToken";
 export * from "./updateUserRewards";
 export * from "./withdraw";
+export * from "./wrapStakingToken";

package/dist/types/contracts/governance/gauge/isPaused.d.ts

@@ -1,7 +1,7 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
 /**
- * Returns whether the gauge is currently paused.
+ * Returns the gauge's own emergency pause switch. Does not reflect the controller's global pause; use `getPauseStatus` for both.
  * @param chainId - The chain/network to use.
  * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
  * @param provider - Optional ethers.js Provider instance.

package/dist/types/contracts/governance/gauge/pullRewardsFromDistributor.d.ts

@@ -0,0 +1,11 @@
+import { ethers, Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Pulls a gauge's accrued share from its rewards distributor into the gauge's reward rate. Callable by anyone. Reverts while the gauge or its controller is paused; the share stays in the distributor and the first pull after the pause walks every missed epoch.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction after it has been mined.
+ */
+export declare const pullRewardsFromDistributor: (chainId: ChainId, gaugeAddressOrId: string, signer: Signer) => Promise<ethers.ContractTransactionResponse>;

package/dist/types/contracts/governance/gauge/unwrapStakingToken.d.ts

@@ -0,0 +1,12 @@
+import { Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Unwraps a wrapped gauge's staking token back into its underlying (ERC4626 `redeem`), sending it to the signer.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param shares - Staking token to unwrap, base units.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The mined transaction.
+ */
+export declare const unwrapStakingToken: (chainId: ChainId, gaugeAddressOrId: string, shares: bigint, signer: Signer) => Promise<any>;

package/dist/types/contracts/governance/gauge/wrapStakingToken.d.ts

@@ -0,0 +1,13 @@
+import { Signer } from "ethers";
+import { ChainId } from "../../../configs/chains";
+/**
+ * Wraps the underlying of a wrapped gauge into its staking token (ERC4626 `deposit`), minting the shares to the signer.
+ * The underlying must be approved to the wrapper first, see `approveGaugeToken`.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param assets - Underlying to wrap, base units.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The mined transaction.
+ */
+export declare const wrapStakingToken: (chainId: ChainId, gaugeAddressOrId: string, assets: bigint, signer: Signer) => Promise<any>;

package/dist/types/contracts/governance/gaugeController/addGauge.d.ts

@@ -1,10 +1,13 @@
-import { Signer } from "ethers";
+import { ethers, Signer } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
 /**
- * Adds a new gauge to the GaugeController. Requires the GAUGE_ADMIN role.
+ * Registers a gauge on the controller. Requires GAUGE_ADMIN. The gauge must belong to this system (RAACGauge on the RAAC controller, RWAGauge on the RWA controller).
+ *
  * @param chainId - The chain/network to use.
- * @param gauge - Address of the gauge to add.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
  * @param signer - An ethers.js Signer instance (required).
- * @returns The transaction response.
+ * @returns The transaction after it has been mined.
  */
-export declare const addGauge: (chainId: ChainId, gauge: string, signer: Signer) => Promise<any>;
+export declare const addGauge: (chainId: ChainId, gaugeSystem: GaugeSystemRef, gaugeAddressOrId: string, signer: Signer) => Promise<ethers.ContractTransactionResponse>;

package/dist/types/contracts/governance/gaugeController/batchVote.d.ts

@@ -1,11 +1,14 @@
-import { Signer } from "ethers";
+import { ethers, Signer } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
 /**
- * Casts votes on multiple gauges in a single transaction.
+ * Votes on several gauges in one transaction.
+ *
  * @param chainId - The chain/network to use.
- * @param gaugeAddresses - Array of gauge addresses to vote on.
- * @param voteWeights - Array of vote weights (basis points) aligned with gaugeAddresses.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressesOrIds - Addresses or config ids of the gauges.
+ * @param voteWeights - Vote weight per gauge in basis points, index-aligned with the gauges.
  * @param signer - An ethers.js Signer instance (required).
- * @returns The transaction response.
+ * @returns The transaction after it has been mined.
  */
-export declare const batchVote: (chainId: ChainId, gaugeAddresses: string[], voteWeights: (string | number | bigint)[], signer: Signer) => Promise<any>;
+export declare const batchVote: (chainId: ChainId, gaugeSystem: GaugeSystemRef, gaugeAddressesOrIds: string[], voteWeights: (string | number | bigint)[], signer: Signer) => Promise<ethers.ContractTransactionResponse>;

package/dist/types/contracts/governance/gaugeController/calculateBoost.d.ts

@@ -1,16 +1,18 @@
 import { Provider } from "ethers";
-import configs from "../../../configs/chains";
+import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
 /**
- * Reads the calculateBoost result from the GaugeController contract (read-only).
+ * Calculates the reward boost a user would get on a gauge for a staked amount.
  *
  * @param chainId - The chain/network to use.
- * @param userAddress - The user for which to calculate boost.
- * @param gaugeAddress - The gauge address to calculate the boost for.
- * @param amount - The amount to calculate the boost for.
- * @param provider - An ethers.js Provider instance for read-only RPC.
- * @returns {Promise<{ boostBasisPoints: bigint, boostedAmount: bigint }>}
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param user - Address of the user.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param amount - Staked amount, base units.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The boost in basis points and the boosted amount.
  */
-export declare const calculateBoost: (chainId: keyof typeof configs, userAddress: string, gaugeAddress: string, amount: string | number | bigint, provider: Provider) => Promise<{
+export declare const calculateBoost: (chainId: ChainId, gaugeSystem: GaugeSystemRef, user: string, gaugeAddressOrId: string, amount: string | number | bigint, provider?: Provider) => Promise<{
     boostBasisPoints: bigint;
     boostedAmount: bigint;
 }>;

package/dist/types/contracts/governance/gaugeController/forceCompleteCheckpoint.d.ts

@@ -1,10 +1,13 @@
-import { Signer } from "ethers";
+import { ethers, Signer } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
 /**
- * Forces completion of a pending checkpoint for a gauge.
+ * Completes a gauge's pending weight checkpoint.
+ *
  * @param chainId - The chain/network to use.
- * @param gauge - Address of the gauge to checkpoint.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
  * @param signer - An ethers.js Signer instance (required).
- * @returns The transaction response.
+ * @returns The transaction after it has been mined.
  */
-export declare const forceCompleteCheckpoint: (chainId: ChainId, gauge: string, signer: Signer) => Promise<any>;
+export declare const forceCompleteCheckpoint: (chainId: ChainId, gaugeSystem: GaugeSystemRef, gaugeAddressOrId: string, signer: Signer) => Promise<ethers.ContractTransactionResponse>;

package/dist/types/contracts/governance/gaugeController/getActiveGaugeCount.d.ts

@@ -0,0 +1,12 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
+/**
+ * Returns the number of registered gauges on the controller. Emergency-paused gauges are counted.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The registered gauge count.
+ */
+export declare const getActiveGaugeCount: (chainId: ChainId, gaugeSystem: GaugeSystemRef, provider?: Provider) => Promise<bigint>;

package/dist/types/contracts/governance/gaugeController/getActiveGauges.d.ts

@@ -1,15 +1,19 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
 export interface ActiveGaugesInfo {
     gauges: string[];
+    /** Weight per gauge at the current epoch, formatted in ether units, index-aligned with `gauges`. */
     weights: string[];
+    /** Sum of all gauge weights, formatted in ether units. */
     totalWeight: string;
 }
 /**
- * Gets the active gauges and their weights.
+ * Gets the active gauges on a controller and their weights at the current epoch.
  *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Active gauges, their weights, and total weight. (address[] memory, uint256[] memory, uint256} {activeGauges, weights, totalWeight} Tuple of active gauges, weights and total weight)
+ * @returns Active gauges, their weights and the total weight.
  */
-export declare const getActiveGauges: (chainId: ChainId, provider?: Provider) => Promise<ActiveGaugesInfo>;
+export declare const getActiveGauges: (chainId: ChainId, gaugeSystem: GaugeSystemRef, provider?: Provider) => Promise<ActiveGaugesInfo>;

package/dist/types/contracts/governance/gaugeController/getConstants.d.ts

@@ -1,13 +1,15 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
 /**
- * Reads the immutable/constant configuration values from the GaugeController.
+ * Reads the constant configuration values from a GaugeController.
+ *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
  * @param provider - Optional ethers.js Provider instance.
- * @returns An object with maxBoost, minBoost, weightPrecision, week, weightVoteDelay,
- *   minVoteWeight and maxVoteWeight, all bigint.
+ * @returns maxBoost, minBoost, weightPrecision, week, weightVoteDelay, minVoteWeight and maxVoteWeight.
  */
-export declare const getConstants: (chainId: ChainId, provider?: Provider) => Promise<{
+export declare const getConstants: (chainId: ChainId, gaugeSystem: GaugeSystemRef, provider?: Provider) => Promise<{
     maxBoost: bigint;
     minBoost: bigint;
     weightPrecision: bigint;

package/dist/types/contracts/governance/gaugeController/getCurrentEpoch.d.ts

@@ -1,9 +1,12 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
 /**
- * Gets the current epoch boundary (rounded down to the week) from the GaugeController.
+ * Returns the start timestamp of the controller's current epoch.
+ *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Current epoch timestamp as a bigint.
+ * @returns The current epoch timestamp, seconds.
  */
-export declare const getCurrentEpoch: (chainId: ChainId, provider?: Provider) => Promise<bigint>;
+export declare const getCurrentEpoch: (chainId: ChainId, gaugeSystem: GaugeSystemRef, provider?: Provider) => Promise<bigint>;

package/dist/types/contracts/governance/gaugeController/getExpiredGaugeVotePower.d.ts

@@ -0,0 +1,16 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
+/**
+ * Returns the vote power a user still has assigned to gauges whose votes no longer count, because every lock backing the vote has decayed out by the next epoch. Free it by re-voting those gauges.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param user - Address of the voter.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The stale vote weight in basis points and the gauges it sits on.
+ */
+export declare const getExpiredGaugeVotePower: (chainId: ChainId, gaugeSystem: GaugeSystemRef, user: string, provider?: Provider) => Promise<{
+    expiredGaugePower: bigint;
+    gauges: string[];
+}>;

package/dist/types/contracts/governance/gaugeController/getGauge.d.ts

@@ -1,13 +1,16 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
 /**
- * Reads the gauge config struct from the public `gauges` mapping on the GaugeController.
+ * Reads a gauge's entry from the controller's public `gauges` mapping.
+ *
  * @param chainId - The chain/network to use.
- * @param gauge - Address of the gauge.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
  * @param provider - Optional ethers.js Provider instance.
- * @returns An object with isActive, isBoostAmplificationEnabled (booleans), weight and lastUpdateTime (bigint).
+ * @returns isActive and isBoostAmplificationEnabled flags, weight and lastUpdateTime.
  */
-export declare const getGauge: (chainId: ChainId, gauge: string, provider?: Provider) => Promise<{
+export declare const getGauge: (chainId: ChainId, gaugeSystem: GaugeSystemRef, gaugeAddressOrId: string, provider?: Provider) => Promise<{
     isActive: boolean;
     isBoostAmplificationEnabled: boolean;
     weight: bigint;

package/dist/types/contracts/governance/gaugeController/getGaugeDistributor.d.ts

@@ -0,0 +1,12 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
+/**
+ * Returns the GaugeRewardsDistributor wired to the controller.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The distributor address.
+ */
+export declare const getGaugeDistributor: (chainId: ChainId, gaugeSystem: GaugeSystemRef, provider?: Provider) => Promise<string>;

package/dist/types/contracts/governance/gaugeController/getGaugeEmissions.d.ts

@@ -1,5 +1,6 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemId } from "../../../configs/chains/chain";
 export interface GaugeEpochEmission {
     /** Epoch (Unix-week) start timestamp, seconds. */
     epoch: number;
@@ -57,8 +58,10 @@ export interface GaugeEmissionsResult {
  * where scheduledWeekEmission = minter.calculateScheduledMintableAmount(week) × distributorShare.
  *
  * @param chainId - The chain/network to use.
- * @param gauge - Gauge address (or config key).
- * @param numEpochs - How many epochs to include, ending at the current one (default 8).
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges").
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param numEpochs - How many epochs to include, ending at the current one (default 8), clamped to the gauge's start.
+ * @param includeUpcoming - Whether to append a projection for the next epoch (default true).
  * @param provider - Optional ethers.js Provider instance.
  */
-export declare const getGaugeEmissions: (chainId: ChainId, gauge: string, numEpochs?: number, includeUpcoming?: boolean, provider?: Provider) => Promise<GaugeEmissionsResult>;
+export declare const getGaugeEmissions: (chainId: ChainId, gaugeSystem: GaugeSystemId, gaugeAddressOrId: string, numEpochs?: number, includeUpcoming?: boolean, provider?: Provider) => Promise<GaugeEmissionsResult>;

package/dist/types/contracts/governance/gaugeController/getGaugeRelativeWeight.d.ts

@@ -1,15 +1,14 @@
-import { Signer } from "ethers";
+import { ethers, Signer } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
 /**
- * Computes and checkpoints a gauge's relative weight at a given epoch.
- *
- * This is a state-modifying call (it writes checkpoints), so it requires a Signer.
- * For a pure read with no state changes, use getGaugeRelativeWeightView instead.
+ * Checkpoints a gauge and computes its relative weight at an epoch. State-changing; use `getGaugeRelativeWeightView` to read without a transaction. Reverts during a global pause.
  *
  * @param chainId - The chain/network to use.
- * @param gauge - Address of the gauge.
- * @param epoch - Epoch timestamp to checkpoint.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param epoch - Epoch start timestamp, seconds.
  * @param signer - An ethers.js Signer instance (required).
- * @returns The transaction response.
+ * @returns The transaction after it has been mined.
  */
-export declare const getGaugeRelativeWeight: (chainId: ChainId, gauge: string, epoch: string | number | bigint, signer: Signer) => Promise<any>;
+export declare const getGaugeRelativeWeight: (chainId: ChainId, gaugeSystem: GaugeSystemRef, gaugeAddressOrId: string, epoch: string | number | bigint, signer: Signer) => Promise<ethers.ContractTransactionResponse>;

package/dist/types/contracts/governance/gaugeController/getGaugeRelativeWeightView.d.ts

@@ -1,14 +1,17 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
 /**
- * Reads a gauge's relative weight at a given epoch without modifying state.
+ * Returns a gauge's relative weight at an epoch without checkpointing.
+ *
  * @param chainId - The chain/network to use.
- * @param gauge - Address of the gauge.
- * @param epoch - Epoch timestamp to query.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param epoch - Epoch start timestamp, seconds.
  * @param provider - Optional ethers.js Provider instance.
- * @returns An object with relativeWeight (1e18-scaled, where 1e18 = 100%) and totalWeight, both bigint.
+ * @returns relativeWeight (1e18 = 100%) and the total weight at that epoch.
  */
-export declare const getGaugeRelativeWeightView: (chainId: ChainId, gauge: string, epoch: string | number | bigint, provider?: Provider) => Promise<{
+export declare const getGaugeRelativeWeightView: (chainId: ChainId, gaugeSystem: GaugeSystemRef, gaugeAddressOrId: string, epoch: string | number | bigint, provider?: Provider) => Promise<{
     relativeWeight: bigint;
     totalWeight: bigint;
 }>;

package/dist/types/contracts/governance/gaugeController/getGaugeWeight.d.ts

@@ -1,11 +1,13 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
 /**
- * Gets the weight of a gauge.
+ * Returns a gauge's weight at the current epoch.
  *
  * @param chainId - The chain/network to use.
- * @param gaugeAddress - Address of the gauge.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Weight of the gauge formatted in ether units.
+ * @returns The weight formatted in ether units.
  */
-export declare const getGaugeWeight: (chainId: ChainId, gaugeAddress: string, provider?: Provider) => Promise<string>;
+export declare const getGaugeWeight: (chainId: ChainId, gaugeSystem: GaugeSystemRef, gaugeAddressOrId: string, provider?: Provider) => Promise<string>;

package/dist/types/contracts/governance/gaugeController/getLastVoteTime.d.ts

@@ -1,11 +1,14 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
 /**
- * Gets the timestamp of a user's last vote on a given gauge.
+ * Returns when a user last voted on a gauge.
+ *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
  * @param user - Address of the user.
- * @param gauge - Address of the gauge.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
  * @param provider - Optional ethers.js Provider instance.
- * @returns The last vote timestamp as a bigint.
+ * @returns The last vote timestamp, seconds.
  */
-export declare const getLastVoteTime: (chainId: ChainId, user: string, gauge: string, provider?: Provider) => Promise<bigint>;
+export declare const getLastVoteTime: (chainId: ChainId, gaugeSystem: GaugeSystemRef, user: string, gaugeAddressOrId: string, provider?: Provider) => Promise<bigint>;

package/dist/types/contracts/governance/gaugeController/getMaxVoteBuckets.d.ts

@@ -0,0 +1,12 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
+/**
+ * Returns the per-vote decay-bucket cap. 0 means exact (one entry per lock).
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The bucket cap.
+ */
+export declare const getMaxVoteBuckets: (chainId: ChainId, gaugeSystem: GaugeSystemRef, provider?: Provider) => Promise<bigint>;

package/dist/types/contracts/governance/gaugeController/getNextEpoch.d.ts

@@ -1,9 +1,12 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
 /**
- * Gets the next epoch boundary (current epoch plus one week) from the GaugeController.
+ * Returns the start timestamp of the controller's next epoch. Votes cast now take effect at this epoch.
+ *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Next epoch timestamp as a bigint.
+ * @returns The next epoch timestamp, seconds.
  */
-export declare const getNextEpoch: (chainId: ChainId, provider?: Provider) => Promise<bigint>;
+export declare const getNextEpoch: (chainId: ChainId, gaugeSystem: GaugeSystemRef, provider?: Provider) => Promise<bigint>;

package/dist/types/contracts/governance/gaugeController/getRegisteredGaugeList.d.ts

@@ -0,0 +1,12 @@
+import { Provider } from "ethers";
+import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
+/**
+ * Returns every gauge registered on the controller, from `addGauge` until `removeGauge`, emergency-paused ones included.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The registered gauge addresses.
+ */
+export declare const getRegisteredGaugeList: (chainId: ChainId, gaugeSystem: GaugeSystemRef, provider?: Provider) => Promise<string[]>;

package/dist/types/contracts/governance/gaugeController/getTotalWeight.d.ts

@@ -1,10 +1,12 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
 /**
- * Gets the total weight of all active gauges.
+ * Returns the sum of all gauge weights at the current epoch.
  *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Total weight of all active gauges formatted in ether units.
+ * @returns The total weight formatted in ether units.
  */
-export declare const getTotalWeight: (chainId: ChainId, provider?: Provider) => Promise<string>;
+export declare const getTotalWeight: (chainId: ChainId, gaugeSystem: GaugeSystemRef, provider?: Provider) => Promise<string>;

package/dist/types/contracts/governance/gaugeController/getUserGaugeVotePower.d.ts

@@ -1,11 +1,14 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
 /**
- * Gets the vote weight (in basis points) a user has allocated to a gauge.
+ * Returns the vote power a user has allocated to a gauge.
+ *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
  * @param user - Address of the user.
- * @param gauge - Address of the gauge.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Vote weight in basis points as a bigint.
+ * @returns The allocated vote power.
  */
-export declare const getUserGaugeVotePower: (chainId: ChainId, user: string, gauge: string, provider?: Provider) => Promise<bigint>;
+export declare const getUserGaugeVotePower: (chainId: ChainId, gaugeSystem: GaugeSystemRef, user: string, gaugeAddressOrId: string, provider?: Provider) => Promise<bigint>;

package/dist/types/contracts/governance/gaugeController/getUserVotePowerRemaining.d.ts

@@ -1,11 +1,13 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
 /**
- * Get user's remaining voting power available.
+ * Returns the vote weight a user has not yet allocated, in basis points.
  *
  * @param chainId - The chain/network to use.
- * @param userAddress - Address of the user.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param user - Address of the user.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Remaining voting power in basis points (0-10000).
+ * @returns The remaining vote weight.
  */
-export declare const getUserVotePowerRemaining: (chainId: ChainId, userAddress: string, provider?: Provider) => Promise<number>;
+export declare const getUserVotePowerRemaining: (chainId: ChainId, gaugeSystem: GaugeSystemRef, user: string, provider?: Provider) => Promise<number>;