@raac/rpc 1.2.0-beta.5 → 1.2.0-beta.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (196) hide show
  1. package/dist/RPCLibrary.js +38 -97
  2. package/dist/artifacts/core/collectors/FeeCollector.sol/FeeCollector.json +2 -2
  3. package/dist/artifacts/core/governance/gauges/BaseGauge.sol/BaseGauge.json +155 -144
  4. package/dist/artifacts/core/governance/gauges/GaugeController.sol/GaugeController.json +119 -335
  5. package/dist/artifacts/core/governance/gauges/GaugeRewardsDistributor.sol/GaugeRewardsDistributor.json +104 -325
  6. package/dist/artifacts/core/governance/gauges/RAACGauge.sol/RAACGauge.json +167 -146
  7. package/dist/artifacts/core/governance/gauges/RWAGauge.sol/RWAGauge.json +167 -146
  8. package/dist/artifacts/core/governance/proposals/Governance.sol/Governance.json +2 -2
  9. package/dist/artifacts/core/lockers/RAACLiquidLocker.sol/RAACLiquidLocker.json +2 -2
  10. package/dist/artifacts/core/tokens/veRAACToken.sol/veRAACToken.json +66 -32
  11. package/dist/configs/chains/11155111.json +83 -16
  12. package/dist/configs/chains/8453.json +6 -6
  13. package/dist/contracts/getContractAddress.js +1 -0
  14. package/dist/contracts/governance/distributor/claimAll.js +25 -0
  15. package/dist/contracts/governance/distributor/claimForGauge.js +26 -0
  16. package/dist/contracts/governance/distributor/deposit.js +12 -21
  17. package/dist/contracts/governance/distributor/getClaimableForGauge.js +29 -0
  18. package/dist/contracts/governance/distributor/getClaimedAtEpoch.js +30 -0
  19. package/dist/contracts/governance/distributor/getDepositedAtEpoch.js +30 -0
  20. package/dist/contracts/governance/distributor/getGaugeController.js +28 -0
  21. package/dist/contracts/governance/distributor/getLastClaimedEpoch.js +29 -0
  22. package/dist/contracts/governance/distributor/getPeriodDuration.js +28 -0
  23. package/dist/contracts/governance/distributor/{getRewardTokens.js → getRewardToken.js} +10 -9
  24. package/dist/contracts/governance/distributor/getRewardTokenInfo.js +9 -19
  25. package/dist/contracts/governance/distributor/getRewardTokenStats.js +30 -0
  26. package/dist/contracts/governance/{gaugeController/isGauge.js → distributor/getStartEpoch.js} +10 -10
  27. package/dist/contracts/governance/distributor/index.js +31 -17
  28. package/dist/contracts/governance/distributor/setController.js +26 -0
  29. package/dist/contracts/governance/distributor/withdrawRemovedGaugeRewards.js +27 -0
  30. package/dist/contracts/governance/distributor/withdrawUnallocatedRewards.js +26 -0
  31. package/dist/contracts/governance/gauge/addRewardToken.js +34 -0
  32. package/dist/contracts/governance/gauge/claimExtraReward.js +34 -0
  33. package/dist/contracts/governance/gauge/claimExtraRewards.js +33 -0
  34. package/dist/contracts/governance/gauge/claimOnBehalfOf.js +36 -0
  35. package/dist/contracts/governance/gauge/claimRewardToken.js +3 -4
  36. package/dist/contracts/governance/gauge/claimRewardsFor.js +34 -0
  37. package/dist/contracts/governance/gauge/depositRewardToken.js +35 -0
  38. package/dist/contracts/governance/gauge/getAllPendingExtraRewards.js +36 -0
  39. package/dist/contracts/governance/gauge/getControllerAddress.js +34 -0
  40. package/dist/contracts/governance/gauge/getDecimalAdjustment.js +35 -0
  41. package/dist/contracts/governance/gauge/getDepositRAACOnClaim.js +34 -0
  42. package/dist/contracts/governance/gauge/getDistributorData.js +36 -0
  43. package/dist/contracts/governance/gauge/getDistributors.js +34 -0
  44. package/dist/contracts/governance/gauge/getEarnedReward.js +11 -19
  45. package/dist/contracts/governance/gauge/getExtraRewardTokens.js +34 -0
  46. package/dist/contracts/governance/gauge/getGaugeRewardTokenData.js +44 -0
  47. package/dist/contracts/governance/gauge/getPendingExtraRewards.js +36 -0
  48. package/dist/contracts/governance/gauge/getPendingRewards.js +11 -19
  49. package/dist/contracts/governance/gauge/getRaacAutolockMin.js +34 -0
  50. package/dist/contracts/governance/gauge/getUserRewardTokenData.js +37 -0
  51. package/dist/contracts/governance/gauge/getUserWeight.js +35 -0
  52. package/dist/contracts/governance/gauge/index.js +53 -35
  53. package/dist/contracts/governance/gauge/isPaused.js +34 -0
  54. package/dist/contracts/governance/gauge/manageDistributor.js +35 -0
  55. package/dist/contracts/governance/gauge/setController.js +34 -0
  56. package/dist/contracts/governance/gauge/setDepositRAACOnClaim.js +34 -0
  57. package/dist/contracts/governance/gauge/setDistributorApproval.js +35 -0
  58. package/dist/contracts/governance/gauge/setEmergencyPaused.js +34 -0
  59. package/dist/contracts/governance/gauge/setGaugeRewardDistributor.js +34 -0
  60. package/dist/contracts/governance/gauge/setRaacAutolockMin.js +34 -0
  61. package/dist/contracts/governance/gauge/updateUserRewards.js +3 -2
  62. package/dist/contracts/governance/gaugeController/addGauge.js +24 -0
  63. package/dist/contracts/governance/gaugeController/batchVote.js +25 -0
  64. package/dist/contracts/governance/gaugeController/forceCompleteCheckpoint.js +24 -0
  65. package/dist/contracts/governance/gaugeController/getConstants.js +45 -0
  66. package/dist/contracts/governance/gaugeController/getCurrentEpoch.js +27 -0
  67. package/dist/contracts/governance/gaugeController/getGauge.js +29 -0
  68. package/dist/contracts/governance/gaugeController/getGaugeEmissions.js +136 -0
  69. package/dist/contracts/governance/gaugeController/getGaugeRelativeWeight.js +29 -0
  70. package/dist/contracts/governance/gaugeController/getGaugeRelativeWeightView.js +30 -0
  71. package/dist/contracts/governance/gaugeController/getLastVoteTime.js +29 -0
  72. package/dist/contracts/governance/gaugeController/getNextEpoch.js +27 -0
  73. package/dist/contracts/governance/gaugeController/getUserGaugeVotePower.js +29 -0
  74. package/dist/contracts/governance/gaugeController/getVeToken.js +27 -0
  75. package/dist/contracts/governance/gaugeController/getVoteUserPower.js +28 -0
  76. package/dist/contracts/governance/gaugeController/getVoteUserSlope.js +30 -0
  77. package/dist/contracts/governance/gaugeController/index.js +44 -23
  78. package/dist/contracts/governance/gaugeController/isPaused.js +27 -0
  79. package/dist/contracts/governance/gaugeController/kick.js +24 -0
  80. package/dist/contracts/governance/gaugeController/removeGauge.js +24 -0
  81. package/dist/contracts/governance/gaugeController/removePowerFromGauge.js +24 -0
  82. package/dist/contracts/governance/gaugeController/setBoostAmplificationEnabled.js +25 -0
  83. package/dist/contracts/governance/gaugeController/setEmergencyGaugePause.js +25 -0
  84. package/dist/contracts/governance/gaugeController/setEmergencyPause.js +24 -0
  85. package/dist/contracts/lockers/botLocker/unlock.js +4 -1
  86. package/dist/contracts/lockers/maturityVault/harvest.js +3 -2
  87. package/dist/types/RPCLibrary.d.ts +6 -64
  88. package/dist/types/contracts/governance/distributor/claimAll.d.ts +11 -0
  89. package/dist/types/contracts/governance/distributor/claimForGauge.d.ts +12 -0
  90. package/dist/types/contracts/governance/distributor/deposit.d.ts +6 -7
  91. package/dist/types/contracts/governance/distributor/getClaimableForGauge.d.ts +11 -0
  92. package/dist/types/contracts/governance/distributor/getClaimedAtEpoch.d.ts +12 -0
  93. package/dist/types/contracts/governance/distributor/getDepositedAtEpoch.d.ts +12 -0
  94. package/dist/types/contracts/governance/distributor/getGaugeController.d.ts +10 -0
  95. package/dist/types/contracts/governance/distributor/getLastClaimedEpoch.d.ts +11 -0
  96. package/dist/types/contracts/governance/distributor/getPeriodDuration.d.ts +10 -0
  97. package/dist/types/contracts/governance/distributor/{getRewardTokens.d.ts → getRewardToken.d.ts} +3 -3
  98. package/dist/types/contracts/governance/distributor/getRewardTokenInfo.d.ts +8 -10
  99. package/dist/types/contracts/governance/distributor/getRewardTokenStats.d.ts +15 -0
  100. package/dist/types/contracts/governance/distributor/getStartEpoch.d.ts +10 -0
  101. package/dist/types/contracts/governance/distributor/index.d.ts +16 -8
  102. package/dist/types/contracts/governance/distributor/setController.d.ts +12 -0
  103. package/dist/types/contracts/governance/distributor/withdrawRemovedGaugeRewards.d.ts +13 -0
  104. package/dist/types/contracts/governance/distributor/withdrawUnallocatedRewards.d.ts +12 -0
  105. package/dist/types/contracts/governance/gauge/addRewardToken.d.ts +10 -0
  106. package/dist/types/contracts/governance/gauge/claimExtraReward.d.ts +10 -0
  107. package/dist/types/contracts/governance/gauge/claimExtraRewards.d.ts +9 -0
  108. package/dist/types/contracts/governance/gauge/claimOnBehalfOf.d.ts +12 -0
  109. package/dist/types/contracts/governance/gauge/claimRewardToken.d.ts +1 -2
  110. package/dist/types/contracts/governance/gauge/claimRewardsFor.d.ts +10 -0
  111. package/dist/types/contracts/governance/gauge/depositRewardToken.d.ts +11 -0
  112. package/dist/types/contracts/governance/gauge/getAllPendingExtraRewards.d.ts +13 -0
  113. package/dist/types/contracts/governance/gauge/getControllerAddress.d.ts +9 -0
  114. package/dist/types/contracts/governance/gauge/getDecimalAdjustment.d.ts +10 -0
  115. package/dist/types/contracts/governance/gauge/getDepositRAACOnClaim.d.ts +9 -0
  116. package/dist/types/contracts/governance/gauge/getDistributorData.d.ts +13 -0
  117. package/dist/types/contracts/governance/gauge/{getRewardTokens.d.ts → getDistributors.d.ts} +3 -5
  118. package/dist/types/contracts/governance/gauge/getEarnedReward.d.ts +4 -5
  119. package/dist/types/contracts/governance/gauge/getExtraRewardTokens.d.ts +9 -0
  120. package/dist/types/contracts/governance/gauge/getGaugeRewardTokenData.d.ts +18 -0
  121. package/dist/types/contracts/governance/gauge/getPendingExtraRewards.d.ts +11 -0
  122. package/dist/types/contracts/governance/gauge/getPendingRewards.d.ts +4 -5
  123. package/dist/types/contracts/governance/gauge/getRaacAutolockMin.d.ts +9 -0
  124. package/dist/types/contracts/governance/gauge/getUserRewardTokenData.d.ts +17 -0
  125. package/dist/types/contracts/governance/gauge/getUserWeight.d.ts +10 -0
  126. package/dist/types/contracts/governance/gauge/index.d.ts +38 -17
  127. package/dist/types/contracts/governance/gauge/isPaused.d.ts +9 -0
  128. package/dist/types/contracts/governance/gauge/manageDistributor.d.ts +11 -0
  129. package/dist/types/contracts/governance/gauge/setController.d.ts +10 -0
  130. package/dist/types/contracts/governance/gauge/setDepositRAACOnClaim.d.ts +10 -0
  131. package/dist/types/contracts/governance/gauge/setDistributorApproval.d.ts +11 -0
  132. package/dist/types/contracts/governance/gauge/setEmergencyPaused.d.ts +10 -0
  133. package/dist/types/contracts/governance/gauge/setGaugeRewardDistributor.d.ts +10 -0
  134. package/dist/types/contracts/governance/gauge/setRaacAutolockMin.d.ts +10 -0
  135. package/dist/types/contracts/governance/gauge/updateUserRewards.d.ts +2 -1
  136. package/dist/types/contracts/governance/gaugeController/addGauge.d.ts +10 -0
  137. package/dist/types/contracts/governance/gaugeController/batchVote.d.ts +11 -0
  138. package/dist/types/contracts/governance/gaugeController/forceCompleteCheckpoint.d.ts +10 -0
  139. package/dist/types/contracts/governance/gaugeController/getConstants.d.ts +18 -0
  140. package/dist/types/contracts/governance/gaugeController/getCurrentEpoch.d.ts +9 -0
  141. package/dist/types/contracts/governance/gaugeController/getGauge.d.ts +15 -0
  142. package/dist/types/contracts/governance/gaugeController/getGaugeEmissions.d.ts +51 -0
  143. package/dist/types/contracts/governance/gaugeController/getGaugeRelativeWeight.d.ts +15 -0
  144. package/dist/types/contracts/governance/gaugeController/getGaugeRelativeWeightView.d.ts +14 -0
  145. package/dist/types/contracts/governance/gaugeController/getLastVoteTime.d.ts +11 -0
  146. package/dist/types/contracts/governance/gaugeController/getNextEpoch.d.ts +9 -0
  147. package/dist/types/contracts/governance/gaugeController/getUserGaugeVotePower.d.ts +11 -0
  148. package/dist/types/contracts/governance/gaugeController/getVeToken.d.ts +9 -0
  149. package/dist/types/contracts/governance/gaugeController/getVoteUserPower.d.ts +10 -0
  150. package/dist/types/contracts/governance/gaugeController/getVoteUserSlope.d.ts +15 -0
  151. package/dist/types/contracts/governance/gaugeController/index.d.ts +29 -11
  152. package/dist/types/contracts/governance/gaugeController/isPaused.d.ts +9 -0
  153. package/dist/types/contracts/governance/gaugeController/kick.d.ts +10 -0
  154. package/dist/types/contracts/governance/gaugeController/removeGauge.d.ts +10 -0
  155. package/dist/types/contracts/governance/gaugeController/removePowerFromGauge.d.ts +10 -0
  156. package/dist/types/contracts/governance/gaugeController/setBoostAmplificationEnabled.d.ts +11 -0
  157. package/dist/types/contracts/governance/gaugeController/setEmergencyGaugePause.d.ts +11 -0
  158. package/dist/types/contracts/governance/gaugeController/setEmergencyPause.d.ts +10 -0
  159. package/dist/types/contracts/lockers/botLocker/unlock.d.ts +3 -0
  160. package/dist/types/contracts/lockers/maturityVault/harvest.d.ts +1 -1
  161. package/dist/utils/contracts.js +1 -1
  162. package/package.json +1 -1
  163. package/dist/contracts/governance/distributor/getAvailableBalance.js +0 -29
  164. package/dist/contracts/governance/distributor/getGaugeRewardTokens.js +0 -28
  165. package/dist/contracts/governance/distributor/getTransferableBalance.js +0 -30
  166. package/dist/contracts/governance/distributor/isRewardTokenApproved.js +0 -29
  167. package/dist/contracts/governance/distributor/isTokenApproved.js +0 -29
  168. package/dist/contracts/governance/gauge/claimReward.js +0 -44
  169. package/dist/contracts/governance/gauge/getAllEarnedRewards.js +0 -51
  170. package/dist/contracts/governance/gauge/getAllPendingRewards.js +0 -41
  171. package/dist/contracts/governance/gauge/getRewardTokens.js +0 -41
  172. package/dist/contracts/governance/gauge/getUserGaugeVoteWeight.js +0 -42
  173. package/dist/contracts/governance/gauge/getWorkingBalance.js +0 -43
  174. package/dist/contracts/governance/gauge/syncRewardTokens.js +0 -51
  175. package/dist/contracts/governance/gaugeController/checkpoint.js +0 -33
  176. package/dist/contracts/governance/gaugeController/checkpointGauge.js +0 -34
  177. package/dist/contracts/governance/gaugeController/getUserGaugeVoteWeight.js +0 -30
  178. package/dist/tests/liquidLocker.test.js +0 -262
  179. package/dist/tests/test.js +0 -32
  180. package/dist/types/contracts/governance/distributor/getAvailableBalance.d.ts +0 -11
  181. package/dist/types/contracts/governance/distributor/getGaugeRewardTokens.d.ts +0 -11
  182. package/dist/types/contracts/governance/distributor/getTransferableBalance.d.ts +0 -12
  183. package/dist/types/contracts/governance/distributor/isRewardTokenApproved.d.ts +0 -12
  184. package/dist/types/contracts/governance/distributor/isTokenApproved.d.ts +0 -11
  185. package/dist/types/contracts/governance/gauge/claimReward.d.ts +0 -11
  186. package/dist/types/contracts/governance/gauge/getAllEarnedRewards.d.ts +0 -17
  187. package/dist/types/contracts/governance/gauge/getAllPendingRewards.d.ts +0 -19
  188. package/dist/types/contracts/governance/gauge/getUserGaugeVoteWeight.d.ts +0 -14
  189. package/dist/types/contracts/governance/gauge/getWorkingBalance.d.ts +0 -12
  190. package/dist/types/contracts/governance/gauge/syncRewardTokens.d.ts +0 -13
  191. package/dist/types/contracts/governance/gaugeController/checkpoint.d.ts +0 -11
  192. package/dist/types/contracts/governance/gaugeController/checkpointGauge.d.ts +0 -12
  193. package/dist/types/contracts/governance/gaugeController/getUserGaugeVoteWeight.d.ts +0 -12
  194. package/dist/types/contracts/governance/gaugeController/isGauge.d.ts +0 -11
  195. package/dist/types/tests/liquidLocker.test.d.ts +0 -18
  196. package/dist/types/tests/test.d.ts +0 -1
@@ -0,0 +1,12 @@
1
+ import { Signer } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Withdraws unallocated rewards to a recipient.
5
+ * Requires DEFAULT_ADMIN_ROLE.
6
+ *
7
+ * @param chainId - The chain/network to use.
8
+ * @param recipient - Address to receive the withdrawn rewards.
9
+ * @param signer - An ethers.js Signer instance (required).
10
+ * @returns Transaction after it has been mined.
11
+ */
12
+ export declare const withdrawUnallocatedRewards: (chainId: ChainId, recipient: string, signer: Signer) => Promise<any>;
@@ -0,0 +1,10 @@
1
+ import { Signer } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Registers a new reward token on the gauge (requires GAUGE_ADMIN).
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param token - Address of the reward token to add.
8
+ * @param signer - An ethers.js Signer instance (required).
9
+ */
10
+ export declare const addRewardToken: (chainId: ChainId, gaugeAddressOrId: string, token: string, signer: Signer) => Promise<any>;
@@ -0,0 +1,10 @@
1
+ import { Signer } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Claims a single extra reward token for the caller on the given gauge.
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param token - Address of the extra reward token to claim.
8
+ * @param signer - An ethers.js Signer instance (required).
9
+ */
10
+ export declare const claimExtraReward: (chainId: ChainId, gaugeAddressOrId: string, token: string, signer: Signer) => Promise<any>;
@@ -0,0 +1,9 @@
1
+ import { Signer } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Claims all extra reward tokens for the caller on the given gauge.
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param signer - An ethers.js Signer instance (required).
8
+ */
9
+ export declare const claimExtraRewards: (chainId: ChainId, gaugeAddressOrId: string, signer: Signer) => Promise<any>;
@@ -0,0 +1,12 @@
1
+ import { Signer } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Claims a specific token amount on behalf of a user (requires CLAIM_FOR_ROLE).
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param token - Address of the reward token.
8
+ * @param amount - The amount to claim.
9
+ * @param user - Address of the user on whose behalf the claim is made.
10
+ * @param signer - An ethers.js Signer instance (required).
11
+ */
12
+ export declare const claimOnBehalfOf: (chainId: ChainId, gaugeAddressOrId: string, token: string, amount: string | number | bigint, user: string, signer: Signer) => Promise<any>;
@@ -5,8 +5,7 @@ import configs from "../../../configs/chains";
5
5
  *
6
6
  * @param chainId - The chain/network to use.
7
7
  * @param gaugeAddressOrId - Address of the gauge contract or ID of the gauge.
8
- * @param tokenAddress - Address of the reward token to claim.
9
8
  * @param signer - An ethers.js Signer instance (must be connected to wallet).
10
9
  * @returns Transaction receipt after the claim is made.
11
10
  */
12
- export declare const claimRewardToken: (chainId: keyof typeof configs, gaugeAddressOrId: string, tokenAddress: string, signer: Signer) => Promise<any>;
11
+ export declare const claimRewardToken: (chainId: keyof typeof configs, gaugeAddressOrId: string, signer: Signer) => Promise<any>;
@@ -0,0 +1,10 @@
1
+ import { Signer } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Claims rewards on behalf of a user (requires DISTRIBUTOR_ROLE).
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param user - Address of the user whose rewards are claimed.
8
+ * @param signer - An ethers.js Signer instance (required).
9
+ */
10
+ export declare const claimRewardsFor: (chainId: ChainId, gaugeAddressOrId: string, user: string, signer: Signer) => Promise<any>;
@@ -0,0 +1,11 @@
1
+ import { Signer } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Deposits an amount of a reward token into the gauge for distribution.
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param token - Address of the reward token to deposit.
8
+ * @param amount - The amount to deposit.
9
+ * @param signer - An ethers.js Signer instance (required).
10
+ */
11
+ export declare const depositRewardToken: (chainId: ChainId, gaugeAddressOrId: string, token: string, amount: string | number | bigint, signer: Signer) => Promise<any>;
@@ -0,0 +1,13 @@
1
+ import { Provider } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Gets all pending extra rewards for a user across all extra reward tokens.
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param user - Address of the user.
8
+ * @param provider - Optional ethers.js Provider instance.
9
+ */
10
+ export declare const getAllPendingExtraRewards: (chainId: ChainId, gaugeAddressOrId: string, user: string, provider?: Provider) => Promise<{
11
+ tokens: string[];
12
+ amounts: bigint[];
13
+ }>;
@@ -0,0 +1,9 @@
1
+ import { Provider } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Gets the gauge controller address registered on the gauge.
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param provider - Optional ethers.js Provider instance.
8
+ */
9
+ export declare const getControllerAddress: (chainId: ChainId, gaugeAddressOrId: string, provider?: Provider) => Promise<string>;
@@ -0,0 +1,10 @@
1
+ import { Provider } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Gets the decimal adjustment factor used for a given reward token.
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param token - Address of the reward token.
8
+ * @param provider - Optional ethers.js Provider instance.
9
+ */
10
+ export declare const getDecimalAdjustment: (chainId: ChainId, gaugeAddressOrId: string, token: string, provider?: Provider) => Promise<bigint>;
@@ -0,0 +1,9 @@
1
+ import { Provider } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Returns whether claimed RAAC is auto-deposited (locked) on claim.
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param provider - Optional ethers.js Provider instance.
8
+ */
9
+ export declare const getDepositRAACOnClaim: (chainId: ChainId, gaugeAddressOrId: string, provider?: Provider) => Promise<boolean>;
@@ -0,0 +1,13 @@
1
+ import { Provider } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Gets the registration data for a given distributor on the gauge.
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param distributor - Address of the distributor.
8
+ * @param provider - Optional ethers.js Provider instance.
9
+ */
10
+ export declare const getDistributorData: (chainId: ChainId, gaugeAddressOrId: string, distributor: string, provider?: Provider) => Promise<{
11
+ distributor: string;
12
+ approved: boolean;
13
+ }>;
@@ -1,11 +1,9 @@
1
1
  import { Provider } from "ethers";
2
2
  import { ChainId } from "../../../configs/chains";
3
3
  /**
4
- * Gets all registered reward tokens for the gauge.
5
- *
4
+ * Gets the list of distributor addresses registered on the gauge.
6
5
  * @param chainId - The chain/network to use.
7
- * @param gaugeAddressOrId - Address of the gauge contract or ID of the gauge.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
8
7
  * @param provider - Optional ethers.js Provider instance.
9
- * @returns Array of reward token addresses.
10
8
  */
11
- export declare const getRewardTokens: (chainId: ChainId, gaugeAddressOrId: string, provider?: Provider) => Promise<string[]>;
9
+ export declare const getDistributors: (chainId: ChainId, gaugeAddressOrId: string, provider?: Provider) => Promise<string[]>;
@@ -1,13 +1,12 @@
1
1
  import { Provider } from "ethers";
2
2
  import { ChainId } from "../../../configs/chains";
3
3
  /**
4
- * Gets the earned rewards for a user for a specific token (already claimed).
4
+ * Gets the total amount of main-reward-token a user has already claimed from a gauge.
5
5
  *
6
6
  * @param chainId - The chain/network to use.
7
- * @param gaugeAddressOrId - Address of the gauge contract or ID of the gauge.
8
- * @param tokenAddress - Address of the reward token.
7
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
9
8
  * @param userAddress - Address of the user.
10
9
  * @param provider - Optional ethers.js Provider instance.
11
- * @returns The amount of earned rewards formatted in ether units.
10
+ * @returns The claimed reward amount (raw, base units).
12
11
  */
13
- export declare const getEarnedReward: (chainId: ChainId, gaugeAddressOrId: string, tokenAddress: string, userAddress: string, provider?: Provider) => Promise<string>;
12
+ export declare const getEarnedReward: (chainId: ChainId, gaugeAddressOrId: string, userAddress: string, provider?: Provider) => Promise<bigint>;
@@ -0,0 +1,9 @@
1
+ import { Provider } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Gets the list of extra reward token addresses registered on the gauge.
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param provider - Optional ethers.js Provider instance.
8
+ */
9
+ export declare const getExtraRewardTokens: (chainId: ChainId, gaugeAddressOrId: string, provider?: Provider) => Promise<string[]>;
@@ -0,0 +1,18 @@
1
+ import { Provider } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Gets the gauge-level reward accounting data for a specific token.
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param token - Address of the reward token.
8
+ * @param provider - Optional ethers.js Provider instance.
9
+ */
10
+ export declare const getGaugeRewardTokenData: (chainId: ChainId, gaugeAddressOrId: string, token: string, provider?: Provider) => Promise<{
11
+ isActive: boolean;
12
+ decimals: bigint;
13
+ rate: bigint;
14
+ integral: bigint;
15
+ lastUpdateTime: bigint;
16
+ distributed: bigint;
17
+ leftoverRewards: bigint;
18
+ }>;
@@ -0,0 +1,11 @@
1
+ import { Provider } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Gets the pending extra rewards for a user for a specific token.
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param token - Address of the reward token.
8
+ * @param user - Address of the user.
9
+ * @param provider - Optional ethers.js Provider instance.
10
+ */
11
+ export declare const getPendingExtraRewards: (chainId: ChainId, gaugeAddressOrId: string, token: string, user: string, provider?: Provider) => Promise<bigint>;
@@ -1,13 +1,12 @@
1
1
  import { Provider } from "ethers";
2
2
  import { ChainId } from "../../../configs/chains";
3
3
  /**
4
- * Gets the pending rewards for a user for a specific token.
4
+ * Gets the pending (unclaimed) main-reward-token amount for a user on a gauge.
5
5
  *
6
6
  * @param chainId - The chain/network to use.
7
- * @param gaugeAddressOrId - Address of the gauge contract or ID of the gauge.
8
- * @param tokenAddress - Address of the reward token.
7
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
9
8
  * @param accountAddress - Address of the user.
10
9
  * @param provider - Optional ethers.js Provider instance.
11
- * @returns The amount of pending rewards formatted in ether units.
10
+ * @returns The pending reward amount (raw, base units).
12
11
  */
13
- export declare const getPendingRewards: (chainId: ChainId, gaugeAddressOrId: string, tokenAddress: string, accountAddress: string, provider?: Provider) => Promise<string>;
12
+ export declare const getPendingRewards: (chainId: ChainId, gaugeAddressOrId: string, accountAddress: string, provider?: Provider) => Promise<bigint>;
@@ -0,0 +1,9 @@
1
+ import { Provider } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Gets the minimum RAAC amount required to trigger an autolock on claim.
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param provider - Optional ethers.js Provider instance.
8
+ */
9
+ export declare const getRaacAutolockMin: (chainId: ChainId, gaugeAddressOrId: string, provider?: Provider) => Promise<bigint>;
@@ -0,0 +1,17 @@
1
+ import { Provider } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Gets a user's reward accounting data for a specific token.
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param token - Address of the reward token.
8
+ * @param user - Address of the user.
9
+ * @param provider - Optional ethers.js Provider instance.
10
+ */
11
+ export declare const getUserRewardTokenData: (chainId: ChainId, gaugeAddressOrId: string, token: string, user: string, provider?: Provider) => Promise<{
12
+ integral: bigint;
13
+ lastGaugeIntegral: bigint;
14
+ claimable: bigint;
15
+ claimed: bigint;
16
+ lastUpdate: bigint;
17
+ }>;
@@ -0,0 +1,10 @@
1
+ import { Provider } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Gets the gauge vote weight for a given account.
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param account - Address of the user.
8
+ * @param provider - Optional ethers.js Provider instance.
9
+ */
10
+ export declare const getUserWeight: (chainId: ChainId, gaugeAddressOrId: string, account: string, provider?: Provider) => Promise<bigint>;
@@ -1,17 +1,38 @@
1
- export { getPendingRewards } from "./getPendingRewards";
2
- export { getAllPendingRewards, type AllPendingRewards } from "./getAllPendingRewards";
3
- export { getEarnedReward } from "./getEarnedReward";
4
- export { getAllEarnedRewards, type AllEarnedRewards } from "./getAllEarnedRewards";
5
- export { getRewardTokens } from "./getRewardTokens";
6
- export { getBalanceOf } from "./getBalanceOf";
7
- export { getRawBalanceOf } from "./getRawBalanceOf";
8
- export { getTotalSupply } from "./getTotalSupply";
9
- export { getRawTotalSupply } from "./getRawTotalSupply";
10
- export { getPeriodBoundaries, type PeriodBoundaries } from "./getPeriodBoundaries";
11
- export { getPeriodDuration } from "./getPeriodDuration";
12
- export { stake } from "./stake";
13
- export { withdraw } from "./withdraw";
14
- export { claimReward } from "./claimReward";
15
- export { claimRewardToken } from "./claimRewardToken";
16
- export { syncRewardTokens } from "./syncRewardTokens";
17
- export { updateUserRewards } from "./updateUserRewards";
1
+ export * from "./addRewardToken";
2
+ export * from "./claimExtraReward";
3
+ export * from "./claimExtraRewards";
4
+ export * from "./claimOnBehalfOf";
5
+ export * from "./claimRewardsFor";
6
+ export * from "./claimRewardToken";
7
+ export * from "./depositRewardToken";
8
+ export * from "./getAllPendingExtraRewards";
9
+ export * from "./getBalanceOf";
10
+ export * from "./getControllerAddress";
11
+ export * from "./getDecimalAdjustment";
12
+ export * from "./getDepositRAACOnClaim";
13
+ export * from "./getDistributorData";
14
+ export * from "./getDistributors";
15
+ export * from "./getEarnedReward";
16
+ export * from "./getExtraRewardTokens";
17
+ export * from "./getGaugeRewardTokenData";
18
+ export * from "./getPendingExtraRewards";
19
+ export * from "./getPendingRewards";
20
+ export * from "./getPeriodBoundaries";
21
+ export * from "./getPeriodDuration";
22
+ export * from "./getRaacAutolockMin";
23
+ export * from "./getRawBalanceOf";
24
+ export * from "./getRawTotalSupply";
25
+ export * from "./getTotalSupply";
26
+ export * from "./getUserRewardTokenData";
27
+ export * from "./getUserWeight";
28
+ export * from "./isPaused";
29
+ export * from "./manageDistributor";
30
+ export * from "./setController";
31
+ export * from "./setDepositRAACOnClaim";
32
+ export * from "./setDistributorApproval";
33
+ export * from "./setEmergencyPaused";
34
+ export * from "./setGaugeRewardDistributor";
35
+ export * from "./setRaacAutolockMin";
36
+ export * from "./stake";
37
+ export * from "./updateUserRewards";
38
+ export * from "./withdraw";
@@ -0,0 +1,9 @@
1
+ import { Provider } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Returns whether the gauge is currently paused.
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param provider - Optional ethers.js Provider instance.
8
+ */
9
+ export declare const isPaused: (chainId: ChainId, gaugeAddressOrId: string, provider?: Provider) => Promise<boolean>;
@@ -0,0 +1,11 @@
1
+ import { Signer } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Adds or removes a distributor on the gauge (requires GAUGE_ADMIN).
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param distributor - Address of the distributor to manage.
8
+ * @param shouldAdd - True to add, false to remove.
9
+ * @param signer - An ethers.js Signer instance (required).
10
+ */
11
+ export declare const manageDistributor: (chainId: ChainId, gaugeAddressOrId: string, distributor: string, shouldAdd: boolean, signer: Signer) => Promise<any>;
@@ -0,0 +1,10 @@
1
+ import { Signer } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Sets the gauge controller address (requires GAUGE_ADMIN).
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param controller - Address of the new controller.
8
+ * @param signer - An ethers.js Signer instance (required).
9
+ */
10
+ export declare const setController: (chainId: ChainId, gaugeAddressOrId: string, controller: string, signer: Signer) => Promise<any>;
@@ -0,0 +1,10 @@
1
+ import { Signer } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Toggles whether claimed RAAC is auto-deposited on claim (requires DEFAULT_ADMIN_ROLE).
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param value - New value for the deposit-on-claim flag.
8
+ * @param signer - An ethers.js Signer instance (required).
9
+ */
10
+ export declare const setDepositRAACOnClaim: (chainId: ChainId, gaugeAddressOrId: string, value: boolean, signer: Signer) => Promise<any>;
@@ -0,0 +1,11 @@
1
+ import { Signer } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Sets the approval flag for a distributor on the gauge (requires GAUGE_ADMIN).
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param distributor - Address of the distributor.
8
+ * @param isApproved - Whether the distributor should be approved.
9
+ * @param signer - An ethers.js Signer instance (required).
10
+ */
11
+ export declare const setDistributorApproval: (chainId: ChainId, gaugeAddressOrId: string, distributor: string, isApproved: boolean, signer: Signer) => Promise<any>;
@@ -0,0 +1,10 @@
1
+ import { Signer } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Sets the emergency paused state of the gauge (requires CONTROLLER_ROLE).
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param paused - True to pause, false to unpause.
8
+ * @param signer - An ethers.js Signer instance (required).
9
+ */
10
+ export declare const setEmergencyPaused: (chainId: ChainId, gaugeAddressOrId: string, paused: boolean, signer: Signer) => Promise<any>;
@@ -0,0 +1,10 @@
1
+ import { Signer } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Sets the gauge reward distributor address (requires DEFAULT_ADMIN_ROLE).
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param rewardDistributor - Address of the new reward distributor.
8
+ * @param signer - An ethers.js Signer instance (required).
9
+ */
10
+ export declare const setGaugeRewardDistributor: (chainId: ChainId, gaugeAddressOrId: string, rewardDistributor: string, signer: Signer) => Promise<any>;
@@ -0,0 +1,10 @@
1
+ import { Signer } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Sets the minimum RAAC amount required to trigger an autolock on claim (requires DEFAULT_ADMIN_ROLE).
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
7
+ * @param amount - The new minimum autolock amount.
8
+ * @param signer - An ethers.js Signer instance (required).
9
+ */
10
+ export declare const setRaacAutolockMin: (chainId: ChainId, gaugeAddressOrId: string, amount: string | number | bigint, signer: Signer) => Promise<any>;
@@ -6,7 +6,8 @@ import configs from "../../../configs/chains";
6
6
  *
7
7
  * @param chainId - The chain/network to use.
8
8
  * @param gaugeAddressOrId - Address of the gauge contract or ID of the gauge.
9
+ * @param user - Address of the user whose reward state should be settled/kicked.
9
10
  * @param signer - An ethers.js Signer instance (must be connected to wallet).
10
11
  * @returns Transaction receipt after the update is complete.
11
12
  */
12
- export declare const updateUserRewards: (chainId: keyof typeof configs, gaugeAddressOrId: string, signer: Signer) => Promise<any>;
13
+ export declare const updateUserRewards: (chainId: keyof typeof configs, gaugeAddressOrId: string, user: string, signer: Signer) => Promise<any>;
@@ -0,0 +1,10 @@
1
+ import { Signer } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Adds a new gauge to the GaugeController. Requires the GAUGE_ADMIN role.
5
+ * @param chainId - The chain/network to use.
6
+ * @param gauge - Address of the gauge to add.
7
+ * @param signer - An ethers.js Signer instance (required).
8
+ * @returns The transaction response.
9
+ */
10
+ export declare const addGauge: (chainId: ChainId, gauge: string, signer: Signer) => Promise<any>;
@@ -0,0 +1,11 @@
1
+ import { Signer } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Casts votes on multiple gauges in a single transaction.
5
+ * @param chainId - The chain/network to use.
6
+ * @param gaugeAddresses - Array of gauge addresses to vote on.
7
+ * @param voteWeights - Array of vote weights (basis points) aligned with gaugeAddresses.
8
+ * @param signer - An ethers.js Signer instance (required).
9
+ * @returns The transaction response.
10
+ */
11
+ export declare const batchVote: (chainId: ChainId, gaugeAddresses: string[], voteWeights: (string | number | bigint)[], signer: Signer) => Promise<any>;
@@ -0,0 +1,10 @@
1
+ import { Signer } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Forces completion of a pending checkpoint for a gauge.
5
+ * @param chainId - The chain/network to use.
6
+ * @param gauge - Address of the gauge to checkpoint.
7
+ * @param signer - An ethers.js Signer instance (required).
8
+ * @returns The transaction response.
9
+ */
10
+ export declare const forceCompleteCheckpoint: (chainId: ChainId, gauge: string, signer: Signer) => Promise<any>;
@@ -0,0 +1,18 @@
1
+ import { Provider } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Reads the immutable/constant configuration values from the GaugeController.
5
+ * @param chainId - The chain/network to use.
6
+ * @param provider - Optional ethers.js Provider instance.
7
+ * @returns An object with maxBoost, minBoost, weightPrecision, week, weightVoteDelay,
8
+ * minVoteWeight and maxVoteWeight, all bigint.
9
+ */
10
+ export declare const getConstants: (chainId: ChainId, provider?: Provider) => Promise<{
11
+ maxBoost: bigint;
12
+ minBoost: bigint;
13
+ weightPrecision: bigint;
14
+ week: bigint;
15
+ weightVoteDelay: bigint;
16
+ minVoteWeight: bigint;
17
+ maxVoteWeight: bigint;
18
+ }>;
@@ -0,0 +1,9 @@
1
+ import { Provider } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Gets the current epoch boundary (rounded down to the week) from the GaugeController.
5
+ * @param chainId - The chain/network to use.
6
+ * @param provider - Optional ethers.js Provider instance.
7
+ * @returns Current epoch timestamp as a bigint.
8
+ */
9
+ export declare const getCurrentEpoch: (chainId: ChainId, provider?: Provider) => Promise<bigint>;
@@ -0,0 +1,15 @@
1
+ import { Provider } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Reads the gauge config struct from the public `gauges` mapping on the GaugeController.
5
+ * @param chainId - The chain/network to use.
6
+ * @param gauge - Address of the gauge.
7
+ * @param provider - Optional ethers.js Provider instance.
8
+ * @returns An object with isActive, isBoostAmplificationEnabled (booleans), weight and lastUpdateTime (bigint).
9
+ */
10
+ export declare const getGauge: (chainId: ChainId, gauge: string, provider?: Provider) => Promise<{
11
+ isActive: boolean;
12
+ isBoostAmplificationEnabled: boolean;
13
+ weight: bigint;
14
+ lastUpdateTime: bigint;
15
+ }>;
@@ -0,0 +1,51 @@
1
+ import { Provider } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ export interface GaugeEpochEmission {
4
+ /** Epoch (Unix-week) start timestamp, seconds. */
5
+ epoch: number;
6
+ /** Reward token deposited into the distributor for this epoch (formatted). */
7
+ deposited: string;
8
+ /** Gauge relative weight at this epoch, 1e18-scaled (1e18 = 100%). */
9
+ relativeWeight: bigint;
10
+ /** Gauge relative weight as a percentage 0..100. */
11
+ relativeWeightPct: number;
12
+ /** RAAC this gauge received/was allocated for this epoch = deposited × relativeWeight. */
13
+ gaugeEmission: string;
14
+ gaugeEmissionRaw: bigint;
15
+ /** True for the in-progress (current) epoch — `deposited` may still grow via tick(). */
16
+ isCurrent: boolean;
17
+ /**
18
+ * True for the upcoming (next) epoch preview. Nothing is deposited yet, so `deposited`
19
+ * is the PROJECTED system emission for that week (schedule × distributor share) and
20
+ * `gaugeEmission` is the projection from the gauge's weight at `nextEpoch` — i.e. what
21
+ * this gauge would receive if voting stays as it currently stands.
22
+ */
23
+ isProjected?: boolean;
24
+ }
25
+ export interface GaugeEmissionsResult {
26
+ gauge: string;
27
+ rewardToken: string;
28
+ currentEpoch: number;
29
+ weekSeconds: number;
30
+ /** Current-epoch gauge relative weight as a percentage 0..100. */
31
+ relativeWeightPct: number;
32
+ /** RAAC allocated to this gauge for the current (in-progress) epoch. */
33
+ currentWeekEmission: string;
34
+ /** Per-epoch series, oldest → newest, ending at the current epoch. */
35
+ epochs: GaugeEpochEmission[];
36
+ }
37
+ /**
38
+ * Per-epoch emissions actually received by a gauge: the GaugeController snapshots
39
+ * gauge weights per epoch, and the GaugeRewardsDistributor records the RAAC deposited
40
+ * per epoch. A gauge's emission for an epoch is therefore
41
+ * depositedAtEpoch(epoch) × gaugeRelativeWeight(gauge, epoch).
42
+ *
43
+ * Returns a series ending at the current (in-progress) epoch so callers can chart
44
+ * "week of X → this gauge received Y RAAC".
45
+ *
46
+ * @param chainId - The chain/network to use.
47
+ * @param gauge - Gauge address (or config key).
48
+ * @param numEpochs - How many epochs to include, ending at the current one (default 8).
49
+ * @param provider - Optional ethers.js Provider instance.
50
+ */
51
+ export declare const getGaugeEmissions: (chainId: ChainId, gauge: string, numEpochs?: number, includeUpcoming?: boolean, provider?: Provider) => Promise<GaugeEmissionsResult>;
@@ -0,0 +1,15 @@
1
+ import { Signer } from "ethers";
2
+ import { ChainId } from "../../../configs/chains";
3
+ /**
4
+ * Computes and checkpoints a gauge's relative weight at a given epoch.
5
+ *
6
+ * This is a state-modifying call (it writes checkpoints), so it requires a Signer.
7
+ * For a pure read with no state changes, use getGaugeRelativeWeightView instead.
8
+ *
9
+ * @param chainId - The chain/network to use.
10
+ * @param gauge - Address of the gauge.
11
+ * @param epoch - Epoch timestamp to checkpoint.
12
+ * @param signer - An ethers.js Signer instance (required).
13
+ * @returns The transaction response.
14
+ */
15
+ export declare const getGaugeRelativeWeight: (chainId: ChainId, gauge: string, epoch: string | number | bigint, signer: Signer) => Promise<any>;