This repository contains various proposals targeting the Aave governance. In addition to the actual proposals this repository also contains tooling to standardize certain protocol tasks. The tooling documentation is co-located with the relevant smart contracts.
The cross-chain-forwarders are opinionated contracts for proposals targeting polygon
, optimism
and arbitrum
. For detailed documentation checkout the docs.
The AaveV3ConfigEngine (Docs) is a helper smart contract to abstract good practices when doing "admin" interactions with the Aave v3 protocol, but built on top, without touching the core contracts.
This project uses Foundry. See the book for detailed instructions on how to install and use Foundry.
The template ships with sensible default so you can use default foundry
commands without resorting to MakeFile
.
cp .env.example .env
forge install
yarn
This repository includes a generator to help you bootstrap the required files for an AIP
.
To generate a proposal you need to run: yarn generate
To get a full list of available commands run yarn generate --help
Usage: proposal-generator [options]
CLI to generate aave proposals
Options:
-V, --version output the version number
-f, --force force creation (might overwrite existing files)
-cfg, --configEngine extends config engine
-ch, --chains <letters...> (choices: "Ethereum", "Optimism", "Arbitrum", "Polygon", "Avalanche", "Fantom", "Harmony", "Metis", "Base")
-pv, --protocolVersion <string> (choices: "V2", "V3")
-t, --title <string> aip title
-a, --author <string> author
-d, --discussion <string> forum link
-s, --snapshot <string> snapshot link
-h, --help display help for command
If you have any feedback regarding the generator (bugs, improvements, features), don't hesitate and put it here!
# You can use vanilla forge to customize your test
# https://book.getfoundry.sh/reference/forge/forge-test
forge test
# We also provide a script with sensible defaults to just test a single contract matching a filter
make test-contract filter=ENS
The makefile contains some generic templates for proposal deployments.
To deploy a contract you can run make deploy-ledger contract=pathToContract:Contract chain=chainAlias
.
# example
make deploy-ledger contract=script/CreateProposals.s.sol:MultiPayloadProposal chain=mainnet
make deploy-pk contract=script/CreateProposals.s.sol:MultiPayloadProposal chain=mainnet
# both targets also expose a `dry` option you can run via
make deploy-ledger contract=script/CreateProposals.s.sol:MultiPayloadProposal chain=mainnet dry=true
make deploy-pk contract=script/CreateProposals.s.sol:MultiPayloadProposal chain=mainnet dry=true
While a proposal should be tested throughout, it usually is a good idea to simulate execution on a fork. Therefore this repository comes with the aave-tenderly-cli node package which can be used to streamline fork creation.
Setup your .env
accordingly or follow the setup instructions for global configuration. Now you can
yarn simulate:<mainnet|polygon|...> -- <artifactPath>
# example:
# yarn simulate:polygon -- ./out/AaveV3EthAddCRVPoolPayload.sol/AaveV3EthAddCRVPoolPayload.json
to generate a tenderly fork you can share with your team.
To create a proposal you have to do three things:
- deploy the payload
- create an aip
- create the mainnet proposal
While the first two steps can be performed in parallel, the final proposal creation relies on (1) and (2). Every step can in theory be performed by a different entity.
The address creating the mainnet proposal(3) requires 80k AAVE of proposition power.
The payload is always deployed on the chain it affects. Therefore you need to adjust the relevant script accordingly:
- DeployMainnetPayload for payloads targeting mainnet pools
- DeployPolygonPayload for payloads targeting polygon pools
- DeployArbitrumPayload for payloads targeting arbitrum pools
- DeployOptimismPayload for payloads targeting optimism pools
Once adjusted, you need to deploy it to receive the payload address
.
Checkout Makefile for reference.
The aip can be co-located with the proposal code as a markdown file.
This repository will manage the upload to ipfs automatically once a pr is merged to main
.
Alternatively you can submit your aip to the aave/aip repository or upload it yourself.
The proposal requires at least one payload address
and the encodedHash
.
To create the proposal you need to adjust:
- CreateMainnetProposals according to your needs.
Once adjusted, you need to create the proposal. Checkout Makefile for reference.
๐