AN-3831/add-evm-lending-protocols (#237)

* add sonne and aave protocols

* add granary finance

* all exactly but liquidations

* fix liquidations

* tarot models

* fix tarot liq

* test fixes

* add complete models template

* add gold layer + docs

* missing inc tag

* test fixes

* renames

* event name fix

* doc updates

* push back recency tests

* overview fix

* gen doc fix

* pr comment fixes

* consolidate docs

* tarot asset detail fix

models/doc_descriptions/complete_lending/complete_lending_column_docs.md

@@ -0,0 +1,381 @@
+{% docs complete_lending_borrow_rate_mode %}
+
+The rate mode the user is swapping from. Stable: 1, Variable: 2.  Borrowers can switch between the stable and variable rate at any time. Stable rates act as a fixed rate in the short-term, but can be re-balanced in the long-term in response to changes in market conditions. The variable rate is the rate based on the offer and demand. The stable rate, as its name indicates, will remain pretty stable and its the best option to plan how much interest you will have to pay. The variable rate will change over time and could be the optimal rate depending on market conditions. 
+
+{% enddocs %}
+
+{% docs complete_lending_borrow_rate_stable %}
+
+The stable interest rate for borrowing assets.
+
+{% enddocs %}
+
+{% docs complete_lending_borrow_rate_variable %}
+
+The variable interest rate for borrowing assets.
+
+{% enddocs %}
+
+{% docs complete_lending_collateral_complete_lending_token %}
+
+The interest bearing token that's burned when a liquidation occurs. 
+
+{% enddocs %}
+
+{% docs complete_lending_collateral_asset %}
+
+The asset provided as collateral, which can be liquidated.
+
+{% enddocs %}
+
+{% docs complete_lending_data_provider %}
+
+The protocol data provider contract address. 
+
+{% enddocs %}
+
+{% docs complete_lending_debt_complete_lending_token %}
+
+The interest bearing token representing the debt. 
+
+{% enddocs %}
+
+{% docs complete_lending_debt_asset %}
+
+The debt asset, which the user borrowed. 
+
+{% enddocs %}
+
+{% docs complete_lending_debt_to_cover_amount %}
+
+The amount of debt the user must cover.
+
+{% enddocs %}
+
+{% docs complete_lending_debt_to_cover_amount_usd %}
+
+The amount of debt the user must cover, valued in USD. 
+
+{% enddocs %}
+
+{% docs complete_lending_depositor_address %}
+
+The depositor's address.
+
+{% enddocs %}
+
+{% docs complete_lending_end_voting_period %}
+
+The block number in which the voting period ends.
+
+{% enddocs %}
+
+{% docs complete_lending_flashloan_amount %}
+
+The amount of assets flash loaned.  
+
+{% enddocs %}
+
+{% docs complete_lending_flashloan_amount_usd %}
+
+The value of the flash loan amount, in USD. 
+
+{% enddocs %}
+
+{% docs complete_lending_governance_contract %}
+
+The governance contract address.
+
+{% enddocs %}
+
+{% docs complete_lending_initiator_address %}
+
+The address that initiated the flash loan.
+
+{% enddocs %}
+
+{% docs complete_lending_issued_tokens %}
+
+The amount of tokens that the user is depositing.
+
+{% enddocs %}
+
+{% docs complete_lending_lending_pool_contract %}
+
+The address of the lending pool.
+
+{% enddocs %}
+
+{% docs complete_lending_liquidated_amount %}
+
+The amount of asset liquidated.
+
+{% enddocs %}
+
+{% docs complete_lending_liquidated_amount_usd %}
+
+The value of the liquidated asset, in USD.
+
+{% enddocs %}
+
+{% docs complete_lending_liquidator %}
+
+The address that initiated the liquidation call. 
+
+{% enddocs %}
+
+{% docs complete_lending_market %}
+
+The asset contract for the applicable market.   
+
+{% enddocs %}
+
+{% docs complete_lending_payer %}
+
+The address that initiated the repayment.
+
+{% enddocs %}
+
+{% docs complete_lending_premium_amount %}
+
+The flash loan fee, changeable via the normal governance process, decimal adjusted.
+
+{% enddocs %}
+
+{% docs complete_lending_premium_amount_usd %}
+
+The flash loan fee, valued in USD. 
+
+{% enddocs %}
+
+{% docs complete_lending_proposal_id %}
+
+The unique ID representing a proposal.
+
+{% enddocs %}
+
+{% docs complete_lending_proposal_tx %}
+
+The transaction confirming a proposal submission. 
+
+{% enddocs %}
+
+{% docs complete_lending_proposer %}
+
+The user's address that submitted the proposal.
+
+{% enddocs %}
+
+{% docs complete_lending_repayed_tokens %}
+
+The amount of tokens repaid. 
+
+{% enddocs %}
+
+{% docs complete_lending_repayed_usd %}
+
+The value of repaid tokens, in USD.
+
+{% enddocs %}
+
+{% docs complete_lending_stable_debt_token_address %}
+
+Debt tokens are interest-accruing tokens that are minted and burned on borrow and repay, representing a debt to the protocol with a stable interest rate.
+
+{% enddocs %}
+
+{% docs complete_lending_start_voting_period %}
+
+The block number in which the voting period begins.
+
+{% enddocs %}
+
+{% docs complete_lending_status %}
+
+The proposal's status.
+
+{% enddocs %}
+
+{% docs complete_lending_supplied_usd %}
+
+The value of the asset in USD that the user is depositing.
+
+{% enddocs %}
+
+{% docs complete_lending_supply_rate %}
+
+The interest rate for supplying assets to the protocol.
+
+{% enddocs %}
+
+{% docs complete_lending_support %}
+
+A value indicating their vote (For: true, Against: false).
+
+{% enddocs %}
+
+{% docs complete_lending_target_address %}
+
+The address receiving the flash loan. 
+
+{% enddocs %}
+
+{% docs complete_lending_targets %}
+
+List of the targeted addresses by proposal transactions.
+
+{% enddocs %}
+
+{% docs complete_lending_token %}
+
+The interest bearing token contract.  
+
+{% enddocs %}
+
+{% docs complete_lending_total_liquidity_token %}
+
+The total supply of liquidity tokens.
+
+{% enddocs %}
+
+{% docs complete_lending_total_liquidity_usd %}
+
+The total value of liquidity tokens, in USD. 
+
+{% enddocs %}
+
+{% docs complete_lending_total_stable_debt_token %}
+
+The total supply of debt tokens, representing a debt to the protocol with a stable interest rate.
+
+{% enddocs %}
+
+{% docs complete_lending_total_stable_debt_usd %}
+
+The total USD value of debt tokens, representing a debt to the protocol with a stable interest rate.
+{% enddocs %}
+
+{% docs complete_lending_total_variable_debt_token %}
+
+The total supply of debt tokens, representing a debt to the protocol with a variable interest rate.
+
+{% enddocs %}
+
+{% docs complete_lending_total_variable_debt_usd %}
+
+The total USD value of debt tokens, representing a debt to the protocol with a variable interest rate.
+{% enddocs %}
+
+{% docs complete_lending_utilization_rate %}
+
+The percentage of assets loaned out.
+
+{% enddocs %}
+
+{% docs complete_lending_variable_debt_token_address %}
+
+Debt tokens are interest-accruing tokens that are minted and burned on borrow and repay, representing a debt to the protocol with a variable interest rate.
+
+{% enddocs %}
+
+{% docs complete_lending_version %}
+
+The contract version. Example: Aave AMM, Aave v1, Aave v2
+
+{% enddocs %}
+
+{% docs complete_lending_withdrawn_tokens %}
+
+The amount of tokens withdrawn. 
+
+{% enddocs %}
+
+{% docs complete_lending_withdrawn_usd %}
+
+The value of withdrawn tokens, in USD.
+
+{% enddocs %}
+
+{% docs complete_lending_platform %}
+
+The specific protocol where lending event occurred.
+
+{% enddocs %}
+
+{% docs complete_lending_protocol_token %}
+
+The protocol's specific lending asset token, ie cWBTC or aETHUni.
+
+{% enddocs %}
+
+{% docs complete_lending_borrower %}
+
+Address that initiated the borrow event.
+
+{% enddocs %}
+
+{% docs complete_lending_amount %}
+
+The decimal adjusted amount of tokens involved in the lending transaction, where available.
+
+{% enddocs %}
+
+{% docs complete_lending_amount_usd %}
+
+The value of the tokens in USD at the time of the lending transaction, where available.
+
+{% enddocs %}
+
+{% docs complete_lending_token_address %}
+
+The address of the token associated with the lending action.
+
+{% enddocs %}
+
+{% docs complete_lending_token_symbol %}
+
+The symbol of the token associated with the lending action.
+
+{% enddocs %}
+
+{% docs complete_lending_depositor %}
+
+Address that initiated a deposit event.
+
+{% enddocs %}
+
+{% docs complete_lending_amount_unadj %}
+
+The non-decimal adjusted amount of tokens involved in the lending transaction.
+
+{% enddocs %}
+
+{% docs complete_lending_premium_amount_unadj %}
+
+The flash loan fee, changeable via the normal governance process, non-decimal adjusted.
+
+{% enddocs %}
+
+{% docs complete_lending_flashloan_amount_unadj %}
+
+The amount of assets flash loaned, non-decimal adjusted.  
+
+{% enddocs %}
+
+{% docs complete_lending_flashloan_token %}
+
+The flashloaned token address.  
+
+{% enddocs %}
+
+{% docs complete_lending_flashloan_token_symbol %}
+
+The flashloaned token symbol
+
+{% enddocs %}
+
+{% docs borrower %}
+
+Its the address of the user who is Borrowing or repaying the loan, depending on the action.
+
+{% enddocs %}