Payload PR - BIP-268
Background
The Child Chain Gauge Factory V2 is the Layer Zero replacement for the old Child Chain Streamer style gauges. These new gauges will enable veBAL boost to be extended to non-mainnet chains.
Beyond emitting BAL, Balancer Gauges have the ability to emit other externally provided tokens. Projects such as Lido and Polygon have used this capability in the past to provide direct emissions to stakers.
In for a token to be used in a reward gauge, the add_reward function must be called on the gauge with the specified token. This BIP Grants the Balancer Maxis the ability to manage external rewards tokens on gauges, and authorizes them to make decisions about what tokens to add based on their best judgement and in collaboration with other Balancer Service Providers.
English Specification
The transaction details were generated by this script with inputs and outputs in this directory
The following files can be found both linked below and in the payload PR linked above:
| Filename | Description of Contents |
|---|---|
| inputs.json | The inputs to the script mapping functions and deployments to target addresses that can execute them. |
| results_address_sorted.md | The resulting changes printed in a table sorted by target chain and target address. (to easily understand permisisons granted) |
| results_deployment_sorted.md | The resulting changes printed in a table sorted by target chain and target deployment. (for verification against action ids) |
| function_descriptions.md | A table that describes what each function that is being granted privileged access to allows. |
chainname.json |
For each change with changes, a transaction builder json named after said chain exists to apply the changes described in the tables. |
More information about the various Balancer Multisigs and their functions can be found in the multisig-ops repo
Specification
As described in the payload json, the authorizer will be called to grant the roles as described.
The change can be reviewed by the below by comparing the results_deployment_sorted.md file to the source of truth, which should match the order found in the source of truth for actionIds on the balancer-v2-monorepo.
For record, the contents of results_address_sorted.md are printed here:
| deployment | chain | function | role | target | target_address |
|---|---|---|---|---|---|
| 20230316-child-chain-gauge-factory-v2 | arbitrum | add_reward(address,address) | 0x56245c361d1ed9e55e6f9889e49f36d9991761b712de544f847b557a84ccd62f | lm | 0xc38c5f97B34E175FFd35407fc91a937300E33860 |
| 20230316-child-chain-gauge-factory-v2 | gnosis | add_reward(address,address) | 0xc94195da697c94d4db5c313ab49b9ea64c8d69137624b163ba0e4540edfd0faf | lm | 0x14969B55a675d13a1700F71A37511bc22D90155a |
| 20230316-child-chain-gauge-factory-v2 | optimism | add_reward(address,address) | 0x3bf29175652a3f0fac5abb715d0b7fe2e7b597e2e2eff555dac6b21a20a7c83e | lm | 0x09Df1626110803C7b3b07085Ef1E053494155089 |
| 20230316-child-chain-gauge-factory-v2 | polygon | add_reward(address,address) | 0x728b7c90958572ff4fc88088c34b65ed64230c82afe8611d4d44d39d0845c264 | lm | 0xc38c5f97B34E175FFd35407fc91a937300E33860 |
Risk Assessment
The main risk to adding external tokens to a gauge are that it could be used to distribute spam coins or other mallicious tokens through the gauge system. The Balancer Maxis have demonstrated themselves as well qualified being both permissive but sensible.