Add charts docs

README.md

@@ -16,6 +16,15 @@ $ yarn start
 
 This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
 
+### Multilanguage Development(i18n)
+
+```
+$ yarn build
+$ yarn serve
+```
+
+This command generates static content includes multilanguage feature(i18n).And it starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
 ### Build
 
 ```

docs/Concepts Explained/Basis trade.md

@@ -1,3 +1,74 @@
 ---
-sidebar_position: 5
----
+sidebar_position: 3
+---
+# Basis Position
+
+
+## Introduction
+
+The basis position on Overlay enables users to earn yield on delta neutral positions. If a user takes a position on Overlay that earns funding, the user can hedge that position (by opening a second position of the same size on the opposite side of the market), and get paid funding rates while maintaining no/minimal market exposure. 
+
+
+> WARNING      
+> EXECUTING THE BASIS POSITION REQUIRES CONSTANT SUPERVISION OF POSITIONS TAKEN AND THE FUNDING RATES INVOLVED.
+
+
+
+## When is funding paid to users on Overlay Markets?
+
+If the open interest (OI) of long positions is greater than the OI of short positions on an Overlay market, short positions earn funding on that market. The opposite also holds true, if OI of shorts are greater than that of longs. 
+
+
+<table>
+  <tr>
+   <td>OI imbalance
+   </td>
+   <td>Funding paid to
+   </td>
+  </tr>
+  <tr>
+   <td>OI<sub>shorts</sub> > OI<sub>longs</sub>
+   </td>
+   <td>Longs
+   </td>
+  </tr>
+  <tr>
+   <td>OI<sub>longs</sub> > OI<sub>shorts</sub>
+   </td>
+   <td>Shorts
+   </td>
+  </tr>
+</table>
+
+
+
+## Executing the basis position using Overlay
+
+To execute the basis position, a user may
+
+(i) take a position on the side of an Overlay market that is currently earning funding (only one earns funding at any given time), and then 
+
+(ii) take a converse position to hedge out the market exposure of the first position by using
+
+
+
+* spot assets
+* perps
+* lending markets
+
+
+## Purpose of the basis position on Overlay
+
+Funding is paid on traditional crypto exchanges offering perpetual futures (perps, the most popular derivative contract in crypto) in order to make the price of the perp contract trend towards the spot price of the underlying asset. Funding rates incentivise users to take positions on a particular side of the market in order to reduce the “basis”, that is, the gap between the spot price and the derivative price of an asset.
+
+
+> To learn more about the basis trade and how to execute it on Overlay, please read our detailed article on that [here](https://mirror.xyz/0x7999C7f0b9f2259434b7aD130bBe36723a49E14e/BWarv3spOc4YLQBLM7DlchqOzYt6-v2fpF378mRKzpU).
+
+
+However, pricing on Overlay occurs through an oracle fetch. Funding rates are not required to bring the price of the derivative in line with the spot asset - price data for assets is simply fetched from oracle feeds. 
+
+
+> To learn more about oracles on Overlay, please refer to our docs here
+
+
+Overlay requires funding rates in order to narrow OI imbalances between the long and short side of a market. Due to the mechanics of PnL being paid out by the protocol in the form of OVL, passive OVL holders face the potential of OVL inflation risk in case of OI imbalances - this risk increases the greater the OI imbalance. The funding rates are used to narrow the OI imbalances as much as possible, thus reducing OVL inflation risks.  

docs/Concepts Explained/Charts.md

@@ -0,0 +1,7 @@
+---
+sidebar_position: 6
+---
+
+# Charts
+
+The charting technology is provided by TradingView, a platform for traders and investors especially valued by crypto enthusiasts: it lets you dive into versatile research with high-performance tools and data like [BTC USD](https://www.tradingview.com/symbols/BTCUSD/) price and other key stats, to stay up-to-date on where the markets are moving.

docs/Concepts Explained/How is Overlay different.md

@@ -0,0 +1,57 @@
+---
+sidebar_position: 1
+---
+
+# How does Overlay differ from other perps?
+
+
+## What are perpetual futures contracts or perps?
+
+Perps are the most popular type of derivative contract in crypto markets. Perps allow a user to take a long or short position on an underlying asset without owning it, while either paying or receiving funding to carry on the position (depending on market conditions and the side a user is on). 
+
+Perps differ from traditional futures contracts in that there is no date of expiry/settlement or delivery of the underlying asset. Perp contracts keep rolling over in perpetuity till a user decides to close their position. 
+
+Typically, whitelisted assets are used as margin/collateral for these positions and users are allowed to take on leverage (sometimes up to a 100x). If the margin requirements fall below the minimum threshold, the collateral is liquidated.
+
+Contracts on Overlay markets resemble perpetual future contracts in that there is no date of expiry (contracts can keep rolling over), and that there is no delivery of the underlying asset. However, there are some key features of contracts on Overlay markets that differ from traditional perps - these are discussed below.
+
+
+## Oracle-based pricing
+
+Overlay brings in data points, which act as a proxy for price by using a combination of oracle-based feeds and native mechanisms to determine the data point of a feed that users can build positions on. For more details, please check out our detailed article on pricing. 
+
+Traditional crypto exchanges like FTX and Binance usually use a centralized limit order book (CLOB) system to determine price. Price is based on matching of orders in the buy side and sell side of the order book - price is determined merely by what the asset was last bought for. 
+
+Certain on-chain perp protocols like Perp Protocol and GMX also use oracle based feeds for pricing. 
+
+
+## Lack of traditional counterparties
+
+Overlay will offer tradable markets to its users without traditional counterparties taking the other side of a position. Overlay dynamically mints/burns its native token OVL when a position is closed:
+
+(i) if a positive delta is realized, the protocol mints OVL according to the delta difference against the users initial collateral (also denoted in OVL)
+
+(ii) if a negative delta is realized, a percent of collateral put up by the user (in the form of OVL) is burnt
+
+Risk of inflation is a potential risk for passive OVL holders, and should be understood by users of the system. To know more about how risks and how Overlay addresses risk, please refer to Summary of Risks.
+
+Traditional CLOB-based crypto exchanges rely on swap-based counterparties (including market makers) in order to provide liquidity into their markets. On-chain derivative protocols like Perp Protocol and GMX use liquidity providers to seed liquidity into liquidity pools that users then trade against. 
+
+
+## No Limit Orders
+
+Overlay v1 will not support setting bids and asks via limit orders. At this time, only market orders will be executable on Overlay markets. Generally, CLOB based and LP based exchanges have limit orders.
+
+
+## Funding
+
+Funding rates refer to the periodic fees paid by a trader to hold a long or short position using perps. This can also be thought of as a ‘premium’ that is paid in traditional markets to hold certain futures/options positions. 
+
+Funding rate mechanisms allow CLOB-based exchanges to get the futures price of an asset in line with the underlying spot price of the asset (and reduce the basis). Liquidity provider based trading platforms like GMX and Perp Protocol utilize funding payments in order to pay out yield to liquidity providers in return for providing liquidity.
+
+For Overlay, funding rates are calculated based on the imbalance in Open Interest, rather than the imbalance between spot and future prices. Funding rates on Overlay are mainly utilized to lessen the imbalance between longs and shorts, incentivizing users to come into the lagging side to reduce the imbalance.
+
+
+## PnL and Collateral
+
+Users would be required to lock OVL as collateral to a position in an Overlay market. PnL will also be paid out in OVL. OVL is minted by the protocol and paid out to the user as PnL if a position delta positive; on the other hand, if the position is delta negative, locked OVL is burned (to the extent of the loss).

docs/Concepts Explained/OI caps and other caps.md

@@ -0,0 +1,43 @@
+---
+sidebar_position: 4
+---
+
+# Payoff caps, OI caps, and the Circuit Breaker
+
+
+## Introduction
+
+Overlay uses its native token OVL to pay out PnL if there is a loss, and burns OVL collateralized by the user (up to the extent of the loss) in case of a loss. While this mechanism bestows the protocol with benefits like not requiring market makers or the ability to open positions on nearly any scalar data stream, it also opens the protocol up to potential vulnerabilities caused by OVL inflation (especially in case of long-tail assets).
+
+To counter these potential vulnerabilities, Overlay utilizes a risk framework that includes payoff caps, OI caps, and a circuit breaker mechanism.
+
+
+## Payoff caps
+
+Payoff caps (denoted as _C<sub>p</sub>_) are a “per-position” limit on the PnL of each position. This is a static cap that will be determined by the DAO through a formal governance process and will be specific to each market on Overlay. With riskier/longer tail assets, governance could choose a lower cap.
+
+In markets based on long tail price feeds, the payoff cap enables: 
+
+(i) the protocol to avoid a theoretically infinite payout on any particular position; and 
+
+(ii) the protocol to quantify the risk associated with each market in an automated fashion, based on the _C<sub>p</sub>_ determined by the DAO
+
+
+## Open Interest caps
+
+Open Interest caps (OI caps or C<sub>Q</sub> are “per-market” caps that set a cut off or limit on the aggregate amount of open interest (on the long and short side) in Overlay markets. This static constant will vary from market to market, and will be determined by the community through governance. OI caps are required despite the existence of payoff caps as payoff caps may be bypassed by a user by opening multiple positions. 
+
+Setting C<sub>Q</sub> through governance helps the protocol quantify inflation risk: the amount of OVL that the protocol will have to mint in case of a worst-case scenario for any given market. This hypothetical worst-case scenario involves the imbalance liability (the difference in OI between longs and shorts) being completely skewed towards one side of the market. Quantifying the per-market inflation risk (a function of C<sub>Q</sub>) in the worst-case scenario in an automated fashion allows the community to be aware of the risks posed to the protocol by the introduction of any new market. 
+
+
+## Circuit Breaker
+
+The circuit breaker mechanism gives Overlay an extra layer of protection: it allows a market to cool off in case there have been large payouts (in the form of OVL printing) during the recent past. 
+
+Using C<sub>Q</sub>, the protocol calculates an expected inflation rate over a rolling period of time. If the actual inflation rate in this period exceeds the expected rate, C<sub>Q </sub>is adjusted to stem the inflation. C<sub>Q </sub>comes back to normal when the actual inflation rate nears the expected inflation rate. 
+
+The circuit breaker works by adjusting the per-market notional OI cap (C<sub>Q</sub>) for a particular period of time so as to limit the possible notional size of new positions offered by the market till the market cools down. 
+
+<p style={{textAlign: 'right'}}>
+<em>Last updated on <strong>Oct 18, 2022</strong></em></p>
+

docs/Concepts Explained/OVL.md

@@ -1,3 +1,46 @@
 ---
-sidebar_position: 4
----
+sidebar_position: 2
+---
+# OVL
+
+OVL is the proposed native token of Overlay Protocol. It is an ERC-20 token on the Ethereum Mainnet. OVL serves a dual purpose and will be used to participate in trading and DAO governance after launch. 
+
+OVL may be used by holders to:
+
+
+
+1. vote on governance proposals of the DAO governing Overlay Protocol
+2. open positions on the markets offered on Overlay by using OVL as collateral
+
+
+## Building Position
+
+To enter a position, a user of Overlay Protocol will lock OVL into the Overlay smart contract as collateral/margin. A user could leverage this collateral on either side of any market offered by Overlay. 
+
+On closing a position, the position could either be profitable, unprofitable or at a break even. If the position is profitable, the protocol will mint OVL tokens equivalent to the delta difference of the market between build and unwind. These tokens are added to the circulating supply of OVL. 
+
+If the position is unprofitable, the protocol burns OVL tokens of a value equivalent to the loss sustained. These tokens are removed from the circulating supply of OVL. No tokens are minted or burned in case a position is closed at a break even.  
+
+
+## Governance
+
+Currently, Overlay Protocol is governed by Planck Cat DAO. Members of Planck Cat DAO are issued ERC-721 tokens/NFTs depending on their contribution to the protocol. For more details on the structure of Overlay governance at this time and how one can start contributing to Planck Cat Dao, please click [here](https://www.notion.so/PlanckCat-DAO-7a3fe097aa5c4acaac2d89e142467e53). 
+
+
+> TIP      
+> PCD minting is live with a soft cap of 500 PCDs. Contribute to Overlay and earn CRED in order to mint a PCD. For more details, go [here](https://www.notion.so/What-is-PlanckCat-DAO-PCD-330510eae9864129aa511668a8a594c8). Hop into the [discord](https://discord.com/invite/m2U5vSr4gD) here to start contributing.
+
+
+
+In the future, OVL will be the governance token of Overlay Protocol and may be used by holders to vote on governance proposals made by the community.
+
+This is similar to other existing DAOs like Maker DAO, Yearn Finance, etc. that also use their respective native tokens for voting on governance proposals for functioning and decision making. 
+
+
+## Supply
+
+There were 8 million OVL tokens when the token was first deployed. The OVL supply, by function, is dynamic. OVL will be dynamically minted and burned by the smart contracts when positions are unwound by users.
+
+<p style={{textAlign: 'right'}}>
+<em>Last updated on <strong>Oct 18, 2022</strong></em></p>
+

docs/Concepts Explained/Oracles.md

@@ -0,0 +1,24 @@
+---
+sidebar_position: 5
+---
+
+# Oracles
+
+Pricing data on Overlay markets is based on values intermittently fetched from oracles. Oracles are third-party services that help protocols get information/data (related to price data or other data) required from outside of the protocol’s smart contract ecosystem. Any tool that helps get price data about an asset is a “price oracle.” Overlay has the ability to onboard nearly any oracle, as long as the oracle feed is non-manipulable and non-predictable. 
+
+
+> TIP   
+> To learn more about oracles, a great place to start is the Ethereum Foundation's doc on oracles [here](https://ethereum.org/en/developers/docs/oracles/) or Chainlink's introduction [here](https://chain.link/education/blockchain-oracles).
+
+
+The first oracle that will be used by Overlay is the Uniswap v3 TWAP oracle. Overlay markets using this oracle will use the price feed from pre-existing market pairs on Uniswap v3. Which market pairs will be onboarded as Overlay markets will be decided through governance.  TWAP oracles help deter frontrunning of the oracle feed and protect the protocol from price oracle attacks.
+
+
+> TIP    
+> To learn more about Uniswap v3 TWAP oracles, a great place to start is Uniswap's doc on TWAP oracles [here](https://ethereum.org/en/developers/docs/oracles/) and Chaos Labs' more accessible writeup [here](https://chaoslabs.xyz/posts/chaos-labs-uniswap-v3-twap-deep-dive-pt-1).
+
+
+The second type of oracle to be implemented by Overlay would be Chainlink oracle feeds. Adding Chainlink feeds would help provide Overlay with the ability to offer any market/data stream available on Chainlink. This would also offer the protocol the ability to offer non-traditional markets based on data streams, like the Consumer Price Index (CPI), a metric for the level of inflation. Adding Chainlink oracles and other markets are a governance decision. 
+
+<p style={{textAlign: 'right'}}>
+<em>Last updated on <strong>Oct 18, 2022</strong></em></p>

docs/Contracts/Contract Addresses.md

@@ -0,0 +1,83 @@
+# Contract Addresses
+
+
+
+> INFO     
+> Overlay Protocol is currently only available to participants in the gated and sandboxed Litter Box 1 program. The OVL token is NOT available on any exchanges as of now, nor have any liquidity pools been deployed. To learn more about Litter Box 1, please check out our blog post, available here. 
+
+
+
+
+## OVL Token
+
+The OVL token is deployed on the Ethereum mainnet, and is meant only for the sandboxed and gated Litter box 1 program at this point in time.  The OVL token address on Ethereum mainnet is [0xdc77acc82cce1cc095cba197474cc06824ade6f7](https://etherscan.io/address/0xdc77acc82cce1cc095cba197474cc06824ade6f7#code).
+
+
+## Overlay Smart Contracts
+
+Overlay smart contracts are currently deployed only on the Ethereum mainnet exclusively for testing purposes. 
+
+
+<table>
+  <tr>
+   <td><strong>Contract</strong>
+   </td>
+   <td><strong>Address</strong>
+   </td>
+  </tr>
+  <tr>
+   <td>OverlayV1Factory
+   </td>
+   <td><a href="https://etherscan.io/address/0x9a74758c2a80fa1b1d899e0e1f24cf505a4dea33">0x9a74758c2A80fA1B1d899E0E1f24CF505a4Dea33</a>
+   </td>
+  </tr>
+  <tr>
+   <td>OverlayV1State
+   </td>
+   <td><a href="https://etherscan.io/address/0x477122219aa1F76E190f480a85af97DE0A643320#code">0x477122219aa1F76E190f480a85af97DE0A643320</a>
+   </td>
+  </tr>
+  <tr>
+   <td>OverlayV1Market
+   </td>
+   <td><a href="https://etherscan.io/address/0x7f72986e190BBd1D02daC52b8DdA82eEa363d313">0x7f72986e190BBd1D02daC52b8DdA82eEa363d313</a>
+   </td>
+  </tr>
+  <tr>
+   <td>OverlayV1NoReserveUniswapV3Factory
+   </td>
+   <td><a href="https://etherscan.io/address/0x40a9C6E8d60bE1CE297Bef6a9aC3337d45193D87">0x40a9C6E8d60bE1CE297Bef6a9aC3337d45193D87</a>
+   </td>
+  </tr>
+  <tr>
+   <td>OverlayV1NoReserveUniswapV3Feed ETH/USDC (0.05%)
+   </td>
+   <td><a href="https://etherscan.io/address/0xFFDd8e8D16AEd8CadF4b46DcAf4Ba620Dc269De1">0xFFDd8e8D16AEd8CadF4b46DcAf4Ba620Dc269De1</a>
+   </td>
+  </tr>
+</table>
+
+
+
+## PlanckCat DAO on Arbitrum
+
+PlanckCat DAO (PCD) is a DAO that enables Overlay contributors to be involved in decision making processes through governance. Contributors receive an ERC-721 token when their contribution crosses a certain threshold. PCD NFTs are currently minted on Arbitrum. The contract address for the PCD NFTs is _[0xc9B28946144E3A0e02fcC119a622E30565916784](https://arbiscan.io/token/0xc9B28946144E3A0e02fcC119a622E30565916784)_.
+
+
+
+> TIP     
+> PCD NFT minting is live with a soft cap of 500 PCD NFTs. Contribute to Overlay and earn CRED in order to mint a PCD! For more details, go [here](https://www.notion.so/PlanckCat-DAO-7a3fe097aa5c4acaac2d89e142467e53). Hop into our [discord](https://discord.com/invite/m2U5vSr4gD) here to start contributing.
+
+
+
+> DISCLAIMER    
+> Please note that Overlay Protocol's OVL token has been deployed in a limited capacity (only for participants of the Litter Box 1 program) on Ethereum mainnet. The official Overlay token OVL is not available on any exchange currently. The official token address of the OVL token is the one provided on this page. Any other ERC-20 tokens currently deployed on Ethereum (or any other chain) are not associated with Overlay Protocol.       
+> 
+> Do not interact with any token /smart contract addresses that are not listed on this webpage. Any "OVL" token not listed on this page that exists on any chain is not associated with Overlay Protocol. Please be careful and get information about Overlay only from the official channels listed [here](https://overlay-docs.vercel.app/Getting%20Started/Communication%20channels).
+
+
+<p style={{textAlign: 'right'}}>
+<em>Last updated on <strong>Oct 18, 2022</strong></em></p>
+
+
+