# Glossary

Terms specific to this repository and proposal development workflow.

- [Payload](#payload)
- [Config Engine](#config-engine)
- [Generator](#generator)
- [Feature Module](#feature-module)
- [Snapshot Diff](#snapshot-diff)
- [Fork Testing](#fork-testing)
- [Default Test Suite](#default-test-suite)
- [PayloadsController](#payloadscontroller)
- [AIP (Aave Improvement Proposal)](#aip-aave-improvement-proposal)
- [ARFC (Aave Request for Comments)](#arfc-aave-request-for-comments)
- [Direct-to-AIP](#direct-to-aip)
- [Proposition Power](#proposition-power)
- [Voting Network](#voting-network)
- [Catapulta](#catapulta)
- [Base Payload Classes](#base-payload-classes)
- [Config File Mode](#config-file-mode)

## Repository-Specific Terms

### Payload

[Smart contract](../src/20251201_AaveV3Ethereum_XAUtCapAdjustment/AaveV3Ethereum_XAUtCapAdjustment_20251201.sol) that executes protocol changes on a specific chain. Inherits from base classes like `AaveV3PayloadEthereum`. Deployed on the target chain.

### Config Engine

Standardized interface (`IAaveV3ConfigEngine`) for protocol parameter updates. Provides functions like `newListings()`, `capsUpdates()`, `rateStrategiesUpdates()`. External dependency from `aave-v3-origin`.

### Generator

[CLI tool](../generator/cli.ts) (`npm run generate`) that creates proposal files interactively. Generates `.sol`, `.t.sol`, `.s.sol`, and `.md` files based on user prompts.

### Feature Module

[Generator component](../generator/features/) that handles specific update type (e.g., caps, rates, asset listing).

### Snapshot Diff

Automated before/after comparison of protocol state. Generated by `defaultTest()` and saved to [`diffs/` directory](../diffs/) as markdown.

### Fork Testing

Running tests against a copy of live blockchain state at a specific block. Uses Foundry's `vm.createSelectFork()`.

### Default Test Suite

The `defaultTest()` function that runs comprehensive validation: captures state, executes proposal, generates diff, validates parameters.

### PayloadsController

Governance contract that registers and executes approved payloads. Deployed on each target chain.

## Governance Terms

### AIP (Aave Improvement Proposal)

Formal on-chain proposal submitted to governance. Executable smart contract that modifies protocol parameters when approved.

### ARFC (Aave Request for Comments)

Pre-proposal discussion on governance forum to gather community feedback before creating AIP.

### Direct-to-AIP

Streamlined path skipping ARFC/Snapshot. Used for: time-sensitive updates, routine maintenance, extensions of approved proposals.

### Voting Network

Blockchain where voting occurs. Default: Avalanche (for gas savings).

## Related documentation

- [README.md](../README.md) - Repository overview and architecture
- [Generator Guide](../generator/README.md) - Using the generator CLI
- [TESTING_GUIDE.md](./TESTING_GUIDE.md) - Testing workflows and infrastructure