GitBook: [keep3r-network#4] No subject

Author: SeaSaltyFunk

SUMMARY.md

@@ -11,8 +11,8 @@
 ## $KP3R Token
 
 * [Understanding $KP3R](usdkp3r-token/understanding-usdkp3r.md)
-* [$KP3R FAQ](usdkp3r-token/usdkp3r-faq.md)
 * [$KP3R Tokenomics](usdkp3r-token/usdkp3r-tokenomics.md)
+* [$KP3R FAQ](usdkp3r-token/usdkp3r-faq.md)
 
 ## Minting
 
@@ -61,7 +61,7 @@
 ## Appendix
 
 * [Audits](appendix/audits.md)
-* [Security](appendix/security.md)
+* [Minting & Issuance Security](appendix/minting-and-issuance-security.md)
 
 ## Links
 

appendix/minting-and-issuance-security.md

@@ -0,0 +1,40 @@
+# Minting & Issuance Security
+
+## Iron Bank Role Explained
+
+Iron Bank refers to the set of lending contracts that represent the Iron Bank money market. More on Iron Bank in their [main documentation](https://docs.ib.xyz/). Markets can be added or removed via the [Iron Bank Unittroller](https://etherscan.io/address/0xAB1c342C7bf5Ec5F02ADEA1c2270670bCa144CbB). The admin for Iron Bank is the [Iron Bank Timelock](https://etherscan.io/address/0x5b12f04e22384b01f42ed14da23eacd21f14ac17#code) which in turn is controlled by the [Iron Bank Multisig](https://etherscan.io/address/0xa5fc0bbfcd05827ed582869b7254b6f141ba84eb#code). The list of multisig signers can be found [here](https://gnosis-safe.io/app/eth:0xA5fC0BbfcD05827ed582869b7254b6f141BA84Eb/settings/owners)
+
+Iron Bank useful links;
+
+* [GitHub](https://github.com/ibdotxyz)
+* [Documentation](https://docs.ib.xyz/v/ethereum/)
+* [Website](https://app.ib.xyz/)
+
+## Oracles
+
+Price Oracles are maintained by Iron Bank, more detail found [here](https://docs.ib.xyz/v/ethereum/lending-market/price-oracle), oracle updates are behind the [Iron Bank Timelock](https://etherscan.io/address/0x5b12f04e22384b01f42ed14da23eacd21f14ac17#code)
+
+## ibXXX
+
+ibXXX (Fixed Forex assets, example; ibCHF, ibEUR, ibAUD) are erc20 tokens that are pegged to their corresponding forex pair name. They can only be borrowed via Iron Bank by supplying collateral in one of Iron Bank's accepted collateral options, list available [here](https://docs.ib.xyz/v/ethereum/lending-market/collateral-factor).
+
+This means that each ibXXX asset is backed by a $ amount equal to its fiat value. If 1 ibCHF is borrowed, it had to be backed by at least 1 CHF of value (whether that asset be in the form of BTC, CRV, ETH, etc).
+
+Iron Bank liquidations ensure that the ibXXX assets maintain their peg. Further to this is the dynamic interest rate model. Should the peg drift above the underlying price, supply can be burned in Iron Bank, increasing interest rates (forcing repayments or liquidations). If the peg drifts below the underlying price, additional supply can be minted into Iron Bank to decrease interest rates, stimulating borrowing demand.
+
+ibXXX assets are owned by the [ib\_controller](https://etherscan.io/address/0xa511da90c2f4c557456cd84cd003a1f74c202d80#code), which in turn is owned by the [Keep3r Multisig](https://etherscan.io/address/0x0d5dc686d0a2abbfdafdfb4d0533e886517d4e83). The list of Multisig signers can be found [here](https://gnosis-safe.io/app/eth:0x0d5dc686d0a2abbfdafdfb4d0533e886517d4e83/settings/owners)
+
+Useful Links for Fixed Forex can be found in the [Links Section](broken-reference)
+
+## Lifecycle
+
+ibXXX (Fixed Forex assets, example: ibCHF) & cyXXX (Iron Bank assets, example: cyCHF) are explicitly linked. At contract deployment an ibXXX asset references a corresponding cyXXX asset, this can not be changed after deployment.
+
+ibXXX assets can be `minted` only for the purpose of depositing into cyXXX assets. They can not be minted and sent to any other address. This ensures that ibXXX assets can only enter circulating supply by being borrowed from Iron Bank (and thus backed by collateral).
+
+## Risk Vectors
+
+* Keep3r Multisig can mint large supply into Iron Bank which decreases interest rates.
+* Keep3r Multisig can burn a large supply from Iron Bank which increases interest rates.
+* Iron Bank Multisig can add a dangerous oracle that incorrectly provides price, this is guarded by the Iron Bank Timelock.
+* Iron Bank Multisig can add a dangerous asset that can be used to drain collateral, this is guarded by the Iron Bank Timelock.

appendix/security.md

@@ -1,2 +1,13 @@
+---
+description: What is the utility of Fixed Forex assets?
+---
+
 # Fixed Forex Use Cases
 
+Fixed Forex assets aim to provide wide utility as on-chain stablecoins representing select fiat currencies
+
+Current utility is limited to;
+
+* Earning interest on Fixed Forex assets by providing supply to Iron Bank
+* Earning yield via rewards through providing liquidity for pools
+* Integration of Fixed Forex assets with [Mover](https://faq.viamover.com/iron-bank/how-to-top-up-mover-debit-card-with-iron-bank-forex-tokens) allowing real-world payments 

getting-started/fixed-forex-use-cases.md

@@ -1,2 +1,59 @@
+---
+description: Common terms for understanding Fixed Forex ecosystem
+---
+
 # Glossary
 
+## Vesting
+
+When $KP3R token holders stake or lock their token it is entered into a vesting contract that linearly decays towards 0. Vesting positions are represented by $vKP3R tokens & this entitles holders to a share of protocol fees. See the [Understanding $KP3R](../usdkp3r-token/understanding-usdkp3r.md) & [Vesting](broken-reference) sections for more details
+
+## Fees
+
+Fixed Forex shares fees generated by protocol activity with vested $KP3R token holders. Fees are distributed proportionally to individual vested token holding vs total amount of tokens locked 
+
+## ibXXX
+
+Representation of a Fixed Forex asset (i.e. $ibEUR, $ibCHF, $ibGBP, $ibAUD, $ibJPY, $ibKRW, etc.) 
+
+## OLM (Options Liquidity Mining)
+
+Fixed Forex incentivizes liquidity in a unique way, through the use of Options Liquidity Mining. For more details on OLM see the [Options Liquidity Mining Section](broken-reference)
+
+## Iron Bank
+
+Iron Bank is a decentralized lending platform focused on capital efficiency allowing protocols and individuals to supply and borrow cryptocurrencies.\
+\
+Iron Bank partners with Fixed Forex & the Keep3r Network (see the [Security Section](../appendix/minting-and-issuance-security.md)).
+
+## Curve
+
+Curve Finance is a decentralized exchange that specializes in pegged assets such as stablecoins. The native token of Curve is $CRV
+
+Liquidity of Fixed Forex Assets is available on Curve, allowing utilization of ibXXX swaps & LP rewards
+
+## Convex
+
+Convex is a yield optimizer built on Curve Finance. Convex allows Curve liquidity providers to earn trading fees and claim boosted $CRV without locking $CRV themselves. Liquidity providers can receive boosted $CRV and liquidity mining rewards with minimal effort\
+\
+Liquidity Providers of Fixed Forex Assets can deposit LP positions on Convex to earn yield
+
+## LP (Liquidity Provider)
+
+Users providing liquidity (funds/assets) on decentralized exchange (DEX) protocols
+
+## Yearn
+
+Yearn Protocol is a set of Smart Contracts focused on creating a simple way to generate high risk-adjusted returns for depositors of various assets via best-in-class lending protocols, liquidity pools, and community-made yield farming strategies
+
+Yearn strategies for Fixed Forex assets auto-compound rewards back into the ibXXX asset of choice
+
+## Keep3r Jobs Network
+
+Keep3r Network is a decentralized keeper network – it connects projects off-loading DevOps jobs and external teams ready to help. A _Job_ is a term used to refer to a smart contract that is awaiting for an external entity to perform an action
+
+Keep3r Network utilizes the $KP3R token to reward keepers for completing _Jobs_
+
+## Voting
+
+Vested $KP3R token holders can vote for distribution of new $rKP3R rewards to Liquidity Providers of Fixed Forex Assets 

getting-started/glossary.md

@@ -19,7 +19,7 @@ Fixed Forex assets are [ERC-20 tokens ](https://ethereum.org/en/developers/docs/
 * $ibJPY - Japanese Yen
 * $ibKRW - Korean Won
 
-Fixed Forex stablecoins are over-collateralized, meaning that each stablecoin issued must be backed by collateral maintained at a ratio greater than the fiat value of the stablecoins borrowed. Fixed Forex utilizes the [Iron Bank protocol](https://app.ib.xyz/markets/Ethereum) for the issue & minting of new Fixed Forex assets.
+Fixed Forex stablecoins are over-collateralized, meaning that each stablecoin issued must be backed by collateral maintained at a ratio greater than the fiat value of the stablecoins borrowed (i.e. more than €1 worth of collateral must be provided to borrow 1 $ibEUR). Fixed Forex utilizes the [Iron Bank protocol](https://app.ib.xyz/markets/Ethereum) for the issue & minting of new Fixed Forex assets.
 
 ## Where's the Whitepaper?
 

getting-started/understanding-fixed-forex.md

@@ -1,2 +1,34 @@
 # Understanding $KP3R
 
+The $KP3R token is a representation of the single liquidity ecosystem that includes Fixed Forex & [the Keep3r Network](https://keep3r.network/)
+
+## The Liquidity Ecosystem Explained
+
+Something
+
+## Token Versions Explained
+
+There are four variations of the $KP3R token each serving different purposes within Fixed Forex. The table below provides an explanation for the purpose of each;
+
+| $KP3R Token Version | Purpose                                                                                                                                                                                                                                                                                    |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| $KP3R               | The Keep3r token, Fixed Forex users can receive through completing the redemption process for any $rKP3R held or earnt                                                                                                                                                                     |
+| $rKP3R              | Redeemable Keep3r, users receive as a reward for providing liquidity of Fixed Forex Assets or as a vested Keep3r token holder reward. Redeemable Keep3r entitles the holder to purchase $KP3R at a discount. See the [Options Liquidity Mining Section](broken-reference) for more details |
+| $oKP3R              | Keep3r Options are created upon activation on the Fixed Forex site, and allow the holder 24 hours to purchase the option for discounted $KP3R. See the [Claiming OLM Rewards Section](../options-liquidity-mining/claiming-olm-rewards.md) for more details                                |
+| $vKP3R              | Vested Keep3r is a "ve" locking mechanism. See the[ Vesting Section](broken-reference) for more details                                                                                                                                                                                    |
+
+## Token Use Cases
+
+Something
+
+## Use in Fixed Forex
+
+Something
+
+## Vesting
+
+Something
+
+## Voting
+
+Something