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

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

@@ -1,17 +1,24 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { TokenAmount } from "../../../utils/amount";
+export interface UserRewardTokenData {
+    /** Cumulative reward accrued to the user, normalized to 18 decimals by the gauge. */
+    integral: TokenAmount;
+    /** The gauge's internal reward accumulator at the user's last checkpoint (ray-scaled over the working supply), raw. */
+    lastGaugeIntegral: bigint;
+    /** Reward accrued and not yet claimed as of the last checkpoint, normalized to 18 decimals by the gauge. */
+    claimable: TokenAmount;
+    /** Total reward claimed, in the reward token's base units, with its registry decimals and symbol. */
+    claimed: TokenAmount;
+    lastUpdate: bigint;
+}
 /**
- * Gets a user's reward accounting data for a specific token.
+ * Gets a user's reward accounting data for the gauge's main reward token.
  * @param chainId - The chain/network to use.
  * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
  * @param token - Address of the reward token.
  * @param user - Address of the user.
  * @param provider - Optional ethers.js Provider instance.
+ * @returns The user's reward data; see `UserRewardTokenData` for the unit of each field.
  */
-export declare const getUserRewardTokenData: (chainId: ChainId, gaugeAddressOrId: string, token: string, user: string, provider?: Provider) => Promise<{
-    integral: bigint;
-    lastGaugeIntegral: bigint;
-    claimable: bigint;
-    claimed: bigint;
-    lastUpdate: bigint;
-}>;
+export declare const getUserRewardTokenData: (chainId: ChainId, gaugeAddressOrId: string, token: string, user: string, provider?: Provider) => Promise<UserRewardTokenData>;

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

@@ -1,10 +1,12 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { TokenAmount } from "../../../utils/amount";
 /**
- * Gets the gauge vote weight for a given account.
+ * Gets the working balance an account would have if checkpointed now: its staked balance with its current veRAAC boost applied, capped at the staked balance.
  * @param chainId - The chain/network to use.
  * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
  * @param account - Address of the user.
  * @param provider - Optional ethers.js Provider instance.
+ * @returns The boosted working balance in staking token base units, with the staking token's registry decimals and symbol.
  */
-export declare const getUserWeight: (chainId: ChainId, gaugeAddressOrId: string, account: string, provider?: Provider) => Promise<bigint>;
+export declare const getUserWeight: (chainId: ChainId, gaugeAddressOrId: string, account: string, provider?: Provider) => Promise<TokenAmount>;

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,17 +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/setRaacAutolockMin.d.ts

@@ -4,7 +4,7 @@ import { ChainId } from "../../../configs/chains";
  * Sets the minimum RAAC amount required to trigger an autolock on claim (requires DEFAULT_ADMIN_ROLE).
  * @param chainId - The chain/network to use.
  * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
- * @param amount - The new minimum autolock amount.
+ * @param amount - The new minimum autolock amount, in RAAC base units.
  * @param signer - An ethers.js Signer instance (required).
  */
-export declare const setRaacAutolockMin: (chainId: ChainId, gaugeAddressOrId: string, amount: string | number | bigint, signer: Signer) => Promise<any>;
+export declare const setRaacAutolockMin: (chainId: ChainId, gaugeAddressOrId: string, amount: bigint, signer: Signer) => Promise<any>;

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

@@ -6,8 +6,8 @@ import configs from "../../../configs/chains";
  *
  * @param chainId - The chain/network to use.
  * @param gaugeAddressOrId - Address of the gauge contract or ID of the gauge.
- * @param amount - The amount of tokens to stake.
+ * @param amount - The amount to stake, in staking token base units.
  * @param signer - An ethers.js Signer instance (must be connected to wallet).
  * @returns Transaction receipt after the stake is made.
  */
-export declare const stake: (chainId: keyof typeof configs, gaugeAddressOrId: string, amount: string | number | bigint, signer: Signer) => Promise<any>;
+export declare const stake: (chainId: keyof typeof configs, gaugeAddressOrId: string, amount: bigint, signer: Signer) => Promise<any>;

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/withdraw.d.ts

@@ -6,8 +6,8 @@ import configs from "../../../configs/chains";
  *
  * @param chainId - The chain/network to use.
  * @param gaugeAddressOrId - Address of the gauge contract or ID of the gauge.
- * @param amount - The amount of tokens to withdraw.
+ * @param amount - The amount to withdraw, in staking token base units.
  * @param signer - An ethers.js Signer instance (must be connected to wallet).
  * @returns Transaction receipt after the withdrawal is made.
  */
-export declare const withdraw: (chainId: keyof typeof configs, gaugeAddressOrId: string, amount: string | number | bigint, signer: Signer) => Promise<any>;
+export declare const withdraw: (chainId: keyof typeof configs, gaugeAddressOrId: string, amount: 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 (10000 = 100% of the caller's voting power), 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: bigint[], signer: Signer) => Promise<ethers.ContractTransactionResponse>;

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

@@ -1,16 +1,19 @@
 import { Provider } from "ethers";
-import configs from "../../../configs/chains";
+import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
+import { TokenAmount } from "../../../utils/amount";
 /**
- * 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, in the gauge's staking token base units.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The boost in basis points (10000 = 1x) and the boosted amount in staking token base units.
  */
-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: bigint, provider?: Provider) => Promise<{
     boostBasisPoints: bigint;
-    boostedAmount: bigint;
+    boostedAmount: TokenAmount;
 }>;

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,20 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
+import { TokenAmount } from "../../../utils/amount";
 export interface ActiveGaugesInfo {
     gauges: string[];
-    weights: string[];
-    totalWeight: string;
+    /** Weight per gauge projected to the next epoch, veRAAC voting power in base units, index-aligned with `gauges`. */
+    weights: TokenAmount[];
+    /** Sum of all gauge weights projected to the next epoch, veRAAC voting power in base units. */
+    totalWeight: TokenAmount;
 }
 /**
- * Gets the active gauges and their weights.
+ * Gets the registered gauges on a controller (paused ones included) and their weights projected to the next 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 and minBoost in basis points (10000 = 1x), weightPrecision (10000), week and weightVoteDelay in seconds, and minVoteWeight and maxVoteWeight in basis points (10000 = 100%).
  */
-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 (10000 = 100%) 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,15 +1,19 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
+import { TokenAmount } from "../../../utils/amount";
 /**
- * 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, the stored weight (veRAAC voting power, base units) 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;
+    weight: TokenAmount;
     lastUpdateTime: 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,18 +1,26 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemId } from "../../../configs/chains/chain";
+import { ScaledValue, TokenAmount } from "../../../utils/amount";
 export interface GaugeEpochEmission {
     /** Epoch (Unix-week) start timestamp, seconds. */
     epoch: number;
-    /** Reward token deposited into the distributor for this epoch (formatted). */
-    deposited: string;
-    /** Gauge relative weight at this epoch, 1e18-scaled (1e18 = 100%). */
-    relativeWeight: bigint;
-    /** Gauge relative weight as a percentage 0..100. */
+    /** System reward emission attributed to this epoch, in reward token base units. For past
+     * epochs this is the actual deposited amount; for the in-progress epoch it is the FULL
+     * scheduled week emission (not the partial tick deposit). */
+    deposited: TokenAmount;
+    /** Reward token actually deposited into the distributor so far for this epoch, in base units.
+     * For the current epoch this grows via tick() during the week; for past epochs it
+     * equals `deposited`. */
+    depositedSoFar: TokenAmount;
+    /** Gauge relative weight at this epoch, an 18-decimal fraction (1.0 = 100%). */
+    relativeWeight: ScaledValue;
+    /** Gauge relative weight as a percentage 0..100, a computed float. */
     relativeWeightPct: number;
-    /** RAAC this gauge received/was allocated for this epoch = deposited × relativeWeight. */
-    gaugeEmission: string;
-    gaugeEmissionRaw: bigint;
-    /** True for the in-progress (current) epoch — `deposited` may still grow via tick(). */
+    /** Reward token this gauge received/was allocated for this epoch = deposited × relativeWeight, base units. */
+    gaugeEmission: TokenAmount;
+    /** True for the in-progress (current) epoch — `deposited` is the scheduled full-week
+     * total, while `depositedSoFar` is what has been ticked in so far. */
     isCurrent: boolean;
     /**
      * True for the upcoming (next) epoch preview. Nothing is deposited yet, so `deposited`
@@ -27,25 +35,33 @@ export interface GaugeEmissionsResult {
     rewardToken: string;
     currentEpoch: number;
     weekSeconds: number;
-    /** Current-epoch gauge relative weight as a percentage 0..100. */
+    /** Current-epoch gauge relative weight as a percentage 0..100, a computed float. */
     relativeWeightPct: number;
-    /** RAAC allocated to this gauge for the current (in-progress) epoch. */
-    currentWeekEmission: string;
+    /** Reward token allocated to this gauge for the current (in-progress) epoch, base units — the scheduled
+     * full-week total, deterministic from the emission schedule (not the tick deposit). */
+    currentWeekEmission: TokenAmount;
+    /** Reward token deposited into the distributor so far for the current epoch (tick-based), base units. */
+    currentWeekDepositedSoFar: TokenAmount;
     /** Per-epoch series, oldest → newest, ending at the current epoch. */
     epochs: GaugeEpochEmission[];
 }
 /**
- * Per-epoch emissions actually received by a gauge: the GaugeController snapshots
- * gauge weights per epoch, and the GaugeRewardsDistributor records the RAAC deposited
- * per epoch. A gauge's emission for an epoch is therefore
+ * Per-epoch emissions for a gauge. The GaugeController snapshots gauge weights per epoch
+ * and the GaugeRewardsDistributor records the RAAC deposited per epoch, so for a COMPLETED
+ * epoch a gauge's emission is:
  *   depositedAtEpoch(epoch) × gaugeRelativeWeight(gauge, epoch).
  *
- * Returns a series ending at the current (in-progress) epoch so callers can chart
- * "week of X → this gauge received Y RAAC".
+ * For the in-progress epoch, `depositedAtEpoch` only reflects what has been ticked in so
+ * far and keeps growing through the week — which is misleading. Since the emission schedule
+ * already determines the full week's emission, the current (and upcoming) epoch instead use
+ *   scheduledWeekEmission(epoch) × gaugeRelativeWeight(gauge, epoch)
+ * 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,18 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
+import { ScaledValue, TokenAmount } from "../../../utils/amount";
 /**
- * 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 as an 18-decimal fraction (1.0 = 100%) and the total weight at that epoch (veRAAC voting power, base units). Both are zero when no weight is voted.
  */
-export declare const getGaugeRelativeWeightView: (chainId: ChainId, gauge: string, epoch: string | number | bigint, provider?: Provider) => Promise<{
-    relativeWeight: bigint;
-    totalWeight: bigint;
+export declare const getGaugeRelativeWeightView: (chainId: ChainId, gaugeSystem: GaugeSystemRef, gaugeAddressOrId: string, epoch: string | number | bigint, provider?: Provider) => Promise<{
+    relativeWeight: ScaledValue;
+    totalWeight: TokenAmount;
 }>;

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

@@ -1,11 +1,14 @@
 import { Provider } from "ethers";
 import { ChainId } from "../../../configs/chains";
+import { GaugeSystemRef } from "../gaugeSystems/_helpers";
+import { TokenAmount } from "../../../utils/amount";
 /**
- * Gets the weight of a gauge.
+ * Returns a gauge's weight projected to the next 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, veRAAC voting power in base 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<TokenAmount>;

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>;