Gauge System

​

Key Components

1. GaugeFactoryV2: The main contract for creating and managing gauges.
2. GaugeV2: Individual gauge contracts created by the factory.
3. Voting Mechanism: Allows ve3,3 token holders to allocate votes to gauges.
4. Reward Distribution: Handles the emission of rewards based on gauge weights.

​

GaugeFactoryV2 Contract

• Creating new gauges
• Managing emergency modes
• Setting reward parameters
• Updating gauge configurations

​

Key Functions

function createGaugeV2(
    address _rewardToken,
    address _ve,
    address _token,
    address _distribution,
    address _internal_bribe,
    address _external_bribe,
    bool _isPair
) external returns (address)

function activateEmergencyMode(address[] memory _gauges) external
function stopEmergencyMode(address[] memory _gauges) external

function setRewarderPid(address[] memory _gauges, uint[] memory _pids) external
function setGaugeRewarder(address[] memory _gauges, address[] memory _rewarder) external
function setDistribution(address[] memory _gauges, address distro) external
function setInternalBribe(address[] memory _gauges, address[] memory int_bribe) external

​

Using Gauges

​

Creating a New Gauge

1. Call createGaugeV2 on the GaugeFactoryV2 contract.
2. Store the returned gauge address for future reference.

const newGaugeAddress = await gaugeFactory.createGaugeV2(
  rewardTokenAddress,
  veTokenAddress,
  poolTokenAddress,
  distributionAddress,
  internalBribeAddress,
  externalBribeAddress,
  isPair
);

​

Voting on Gauges

1. Implement a voting interface in the frontend.
2. Call the voting function on the gauge controller contract.

await gaugeController.vote(gaugeAddress, weight);

​

Distributing Rewards

1. The system calculates gauge weights periodically.
2. Rewards are emitted to gauges based on their relative weights.
3. Users can claim rewards from gauges they’ve provided liquidity to.

​

Maintenance and Upgrades

​

Emergency Mode

1. Call activateEmergencyMode on GaugeFactoryV2.
2. This will pause reward emissions and certain gauge functions.
3. Use stopEmergencyMode to resume normal operations.

​

Updating Gauge Parameters

1. Use the appropriate setter function in GaugeFactoryV2.
2. Ensure you have the necessary permissions (GAUGE_ADMIN role).

await gaugeFactory.setDistribution([gauge1Address, gauge2Address], newDistributionAddress);

​

Integration with Other Components

• ve3,3 Token: Provides voting power for gauge voting.
• Liquidity Pools: Gauges are associated with specific liquidity pools.
• Merkl: Handles efficient reward distribution from gauges to users.