Merge pull request #313 from Azuro-protocol/main

upd knowledge-hub from main

pages/hub/apps/get-started.mdx

@@ -1,6 +1,9 @@
 import { Button, Card, Image } from 'components'
 
 ## Getting Started
+> Explore beyond the easy path; your creativity is the only limit.
+>
+> Whichever path you choose, you’ll have our liquidity pools, smart contract logic, and risk management to back you up.
 *Explore beyond the easy path; your creativity is the only limit. Whichever path you choose, you’ll have our liquidity pools, smart contract logic, and risk management to back you up.*
 
 ### Choose your path
@@ -11,23 +14,23 @@ import { Button, Card, Image } from 'components'
     text="
         <p>- Low-code option</p>
         <p>- Prerequisites: Git, Node.js</p>
-        <p>- Result: basic dApp with access to on-chain data in less than a day.</p>"
+        <p>- Result: basic dApp with access to onchain data in less than a day.</p>"
     to="https://gem.azuro.org/hub/apps/get-started#-quick-start"
   />
   <Card
     title="Medium"
     text="
         <p>- Moderate coding (SDK)</p>
         <p>- Prerequisites: JavaScript, Web3 (wagmi, ethers)</p>
-        <p>- Result: basic dApp in less than a day with access to on-chain data and broad customization opportunities.</p>"
+        <p>- Result: basic dApp in less than a day with access to onchain data and broad customization opportunities.</p>"
     to="https://gem.azuro.org/hub/apps/sdk/overview"
   />
   <Card
     title="Advanced"
     text="
         <p>- Independent coding</p>
         <p>- Prerequisites: GraphQL, Web3 (wagmi, ethers, or other similar libs)</p>
-        <p>- Result: any web3 prediction app, bot, add-on for websites, game engines, DAO, DEX, cross-chain solutions, etc.</p>"
+        <p>- Result: any Azuro app (betting interfaces, bots, game engines, DAOs, etc.).</p>"
     to="guides/advanced/overview"
   />
 </div>

pages/hub/index.mdx

@@ -16,7 +16,7 @@ As an onchain prediction layer, Azuro offers a modular smart contract infrastruc
 <div className="grid lg:grid-cols-2 gap-8 mt-1">
   <div>
     ### 🔮 For applications
-    *Set up Azuro in your project to tap into our liquidity pools and streamlined risk management.*
+    *Set up your app to connect to Azuro protocol, inheriting the full might of our singleton LP's liquidity with robust oracle feeds.*
 
     👉 [Getting Started](hub/apps/get-started)
 
@@ -31,7 +31,7 @@ As an onchain prediction layer, Azuro offers a modular smart contract infrastruc
   </div>
   <div>
     ### 🧩 For blockchains
-    *Azuro brings real-world data, users and transaction volumes that are achievable only in gaming to your blockchain.*
+    *Unlock a new vertical in prediction markets for your chain. Start the integration process and connect to Azuro within two weeks.*
 
     👉 [Getting Started](hub/blockchains/get-started)
 
@@ -44,4 +44,6 @@ As an onchain prediction layer, Azuro offers a modular smart contract infrastruc
 
 ---
 
-Read about [Azuro integrations](/cases/overview) to get inspired 👉
+<Callout type="feature">
+  Explore past Azuro integration [case studies](/cases/overview) to get inspired!
+</Callout>

pages/index.mdx

@@ -1,4 +1,4 @@
-import { Button, Card } from 'components'
+import { Card } from 'components'
 
 # Welcome to Azuro Docs 📘
 
@@ -10,7 +10,7 @@ Azuro is a decentralized protocol for prediction markets, providing tooling & in
   <Card
     title="Knowledge Hub"
     text="Learn more about Azuro, the decentralized prediction markets protocol built for scale."
-    to="/knowledge-hub/mission-and-vision"
+    to="/knowledge-hub/abstract/foreword"
   />
   <Card
     title="Contracts"
@@ -74,19 +74,13 @@ Azuro is a decentralized protocol for prediction markets, providing tooling & in
 
 ---
 
-<div className="grid lg:grid-cols-3 gap-3">
+<div className="grid lg:grid-cols-2 gap-3">
   <Card
     contentIcon="/images/svg/discord.svg"
     title="Discord"
     text="Join our Developer Community"
     toTab="https://discord.gg/azuro"
   />
-  <Card
-    contentIcon="/images/svg/capitol.svg"
-    title="Forum"
-    text="Discuss governance and more"
-    toTab="https://gov.azuro.org/"
-  />
   <Card
     contentIcon="/images/svg/github.svg"
     title="GitHub"

pages/knowledge-hub/_meta.json

@@ -1,29 +1,47 @@
 {
-  "mission-and-vision": {
-    "title": "Mission & Vision"
+  "abstract": {
+    "title": "Abstract"
   },
-  "foreword": {
-    "title": "Foreword"
+  "background": {
+    "title": "Background"
+  },
+  "separator1": {
+    "type": "separator"
   },
   "introduction": {
     "title": "Introduction"
   },
+  "how-to-use-azuro": {
+    "title": "How to Use Azuro?"
+  },
+  "azuroscan": {
+    "title": "Azuroscan: Search & Discover"
+  },
+  "faqs": {
+    "title": "FAQs"
+  },
+  "separator2": {
+    "type": "separator"
+  },
   "how-azuro-works": {
     "title": "How Azuro Works"
   },
   "azur": {
-    "title": "🌊 $ AZUR token"
-  },
-  "additional": {
-    "title": "Additional Info"
+    "title": "🌊 $AZUR token"
   },
   "go-defi": {
     "title": "💧 Go DeFi"
   },
+  "separator3": {
+    "type": "separator"
+  },
+  "additional": {
+    "title": "Additional Info"
+  },
   "get-involved": {
     "title": "Get Involved"
   },
   "airdrops": {
-    "title": "Airdrops"
+    "title": "🪂 Airdrops"
   }
 }

pages/knowledge-hub/abstract/_meta.json

@@ -0,0 +1,4 @@
+{
+    "foreword": "Foreword",
+    "mission-and-vision": "Mission and Vision"
+}

pages/knowledge-hub/foreword.mdx → pages/knowledge-hub/abstract/foreword.mdx

@@ -58,7 +58,7 @@ In the age of social media and the internet, a restrict-first and ban-first appr
 
 Crypto is the great global equalizer. No matter who you are or where you’re from, all you need is an internet-connected device to be your own wealth custodian. No background checks, salary slips, or proof of residence necessary — setup your wallet, and you’re ready to go!
 
-Just like how for the Coinbase’s and Binance’s of the world we still need the Uniswap’s and Hyperliquid’s, for the Stake.com’s of the world we would also need decentralized alternatives. Azuro fully preserves the core tenets of crypto, birthing an antifragile protocol that lives so long as the internet lives.
+Just like how for the Coinbase(s) and Binance(s) of the world we still need DEXs like Uniswap, for the Stake.com(s) of the world we would also need decentralized alternatives. Here, zuro fully preserves the core tenets of crypto, birthing an antifragile protocol that lives so long as the internet lives:
 
 - Permissionless. You do not need to satisfy any criteria, nor obtain anyone’s permission to place bets.
 
@@ -68,6 +68,6 @@ Just like how for the Coinbase’s and Binance’s of the world we still need th
 
 But decentralization doesn’t have to be costly, nor a means to an end. Surprisingly it seems, when you do away with unnecessary overhead that comes with operating traditional custodial businesses, you’ll pass on these cost savings to your end-users — in form of better odds and lower spreads!
 
-Powered by LiquidityTree and the singleton LP model, Azuro prediction markets will be seeded with much deeper liquidity on aggregate when compared to other protocols. Azuro's tooling and infrastructure can eventually be ported to any chain, starting with EVM-compatible environments. And Azuro’s by-default composability enables anyone to launch and connect their app to the protocol with zero upfront and running costs — inheriting Azuro’s liquidity pools and selection of markets right out-of-the-box!
+Powered by [LiquidityTree](/knowledge-hub/how-azuro-works/liquidity-tree) and the singleton LP model, Azuro prediction markets will be seeded with much deeper liquidity on aggregate when compared to other protocols. Azuro's tooling and infrastructure can eventually be ported to any chain, starting with EVM-compatible environments. And Azuro’s by-default composability enables anyone to launch and connect their app to the protocol with zero upfront and running costs — inheriting Azuro’s liquidity pools and selection of markets right out-of-the-box!
 
 Yet, if we are to bring the next billion users onchain, this may not be enough. There must be real feature innovation and big UX advancements. The onchain variant of the industry has to be wild — expect the protocol to cataclyze levels of degeneracy that even our ancestors will be proud of!

pages/knowledge-hub/mission-and-vision.mdx → pages/knowledge-hub/abstract/mission-and-vision.mdx

@@ -2,16 +2,14 @@ import { Image, Button, Callout } from 'components'
 
 # Mission & Vision
 
-<Callout type="info">
-**Mission:** To reinvent the opaque betting industry of today as an open-for-all public good, onchain.
-</Callout>
-
 <Image
   src="/images/concepts/vision.png"
   width={2000}
   height={700}
 />
 
 <Callout type="feature">
+**Mission:** To reinvent the opaque betting industry of today as a public good, *onchain*.
+
 **Vision:** To become the global hub for price discovery and the origin of betting lines — the people’s authoritative source for real-time probabilities across major world events.
 </Callout>

pages/knowledge-hub/additional/_meta.json

@@ -1,5 +1,4 @@
 {
-    "faqs": "FAQs",
     "landscape": "Competitive Landscape",
     "brand-assets": "Brand Assets",
     "glossary": "Glossary"

pages/knowledge-hub/additional/landscape.mdx

@@ -1,15 +1,17 @@
 # Competitive Landscape
 
-| Text                             | Polymarket                        | Drift BET                       | SX Network                    | Stake.com / Rollbit / Shuffle | **Azuro**                         |
+| 🌊                              | Polymarket                        | Drift BET                       | SX Network                    | Stake.com / Rollbit / Shuffle | *Azuro*                         |
 |----------------------------------|-----------------------------------|---------------------------------|-------------------------------|-------------------------------|-------------------------------------|
-| **Market types**                 | Politics, exotic, prices, sports  | Politics, exotic, sports        | Sports, casino, prices, exotic, politics | Casino, sports                 | ***Sports, politics, exotic***      |
-| **Business model**               | B2C                               | B2C                             | B2B2C                          | B2C                           | ***B2B2C***                         |
-| **Deployment**                   | Polygon                           | Solana                          | SX Chain                       | Offchain                      | ***Polygon, Gnosis, Chiliz***       |
-| **Custody model**                | Non-custodial                     | Non-custodial                   | Non-custodial                  | Custodial                     | ***Non-custodial***                 |
-| **Access model**                 | Singular interface                | Singular interface              | Singular interface             | Singular interface             | ***Multiple interfaces***           |
-| **Betting flow**                 | Peer-to-peer                      | Peer-to-peer                    | Peer-to-peer                   | Centralized                   | ***Peer-to-pool***                  |
-| **Market creation**              | Centralized                       | Centralized                     | Permissionless                 | Centralized                   | ***Permissionless***               |
-| **Mechanism design**             | CLOB                              | CLOB                            | CLOB                           | Proprietary                   | ***vAMM***                          |
-| **Primary liquidity source**     | Centralized market-makers         | Centralized market-makers       | Public liquidity\*             | Proprietary                   | ***Public liquidity***              |
-| **Liquidity provision**          | Active                            | Active                          | Active                         | Proprietary                   | ***Passive***                       |
-| **Resolution process**           | UMA, Polymarket                   | Drift security council           | Market creator, chain validators | Internal                      | ***Data provider, AzuroDAO***      |
+| **Market types (ranked)**        | Politics, exotic, sports		   | Politics, exotic, sports        | Sports, casino, exotic, politics | Casino, sports                 | *Sports, politics, exotic*      |
+| **Business model**               | B2C                               | B2C                             | B2B2C                          | B2C                           | *B2B2C*                         |
+| **Deployment**                   | Polygon                           | Solana                          | SX Chain                       | Offchain                      | *Polygon, Gnosis, Chiliz*       |
+| **Custody model**                | Non-custodial                     | Non-custodial                   | Non-custodial                  | Custodial                     | *Non-custodial*                 |
+| **Access model**                 | Singular interface                | Singular interface              | Singular interface             | Singular interface            | *Multiple interfaces*           |
+| **Betting structure**            | Peer-to-peer                      | Peer-to-peer                    | Peer-to-peer                   | Proprietary                   | *Peer-to-pool*                  |
+| **Market creation**              | Centralized                       | Centralized                     | Permissionless                 | Centralized                   | *Permissionless\**               |
+| **Mechanism design**             | CLOB                              | CLOB                            | CLOB                           | Proprietary                   | *vAMM*                          |
+| **Primary liquidity source**     | Market-makers	          		  | Market-makers   			     | Onchain\*           			  | Proprietary                   | *Onchain*			              |
+| **Liquidity provision**          | Active                            | Active                          | Active                         | Proprietary                   | *Passive*                       |
+| **Resolution process**           | UMA, Internal	                   | Internal						 | Market creator				  | Internal                      | *Data provider, AzuroDAO\**      |
+
+*\*not yet fully implemented*

pages/knowledge-hub/azur/_meta.json

@@ -1,5 +1,5 @@
 {
     "tokenomics": "Tokenomics",
-    "redacted": "[redacted]",
+    "st-azur": "stAZUR",
     "azuro-dao": "AzuroDAO"
   }

pages/knowledge-hub/azur/azuro-dao.mdx

@@ -1,4 +1,4 @@
-import { PageHeadline, Image, Callout } from 'components'
+import { Image, Callout } from 'components'
 
 # AzuroDAO
 

pages/knowledge-hub/go-defi/st-azur.mdx → pages/knowledge-hub/azur/st-azur.mdx

@@ -1,13 +1,13 @@
-import { PageHeadline, Image, Callout } from 'components'
+import { Image, Callout } from 'components'
 
-# Azuro stAZUR
+# stAZUR
 
-Staking AZUR signals your commitment to Azuro. By staking AZUR, you’ll be eligible to earn an estimated ~22% APY, starting 24 Jun 2024 until the end of the staking period. The duration of the staking period is not announced ahead of time.
+Staking AZUR signals your commitment to Azuro. By staking AZUR, you’ll be eligible to earn staking yield, starting 24 Jun 2024 until the end of the staking period. The duration of the staking period is not announced ahead of time.
 
 Further details to be disclosed closer to the end of the staking period.
 
 <Callout type="feature">
-Staking rewards are generated off the overall value that is accrued to the Azuro ecosystem. They are not derived off new emissions from the uncirculated AZUR supply.
+Staking rewards are denominated in AZUR, and are generated from protocol revenue attributable to AzuroDAO. They are a form of real yield, and are not derived off new emissions from the uncirculated AZUR supply.
 </Callout>
 
 When staking AZUR, users will receive stAZUR, our liquid staking token that can be used on partner platforms to gain additional rewards from our partners.

pages/knowledge-hub/azur/tokenomics.mdx

@@ -1,4 +1,4 @@
-import { PageHeadline, Image, Callout } from 'components'
+import { Image, Callout } from 'components'
 
 # Tokenomics
 

pages/knowledge-hub/introduction/azuroscan.mdx → pages/knowledge-hub/azuroscan.mdx

@@ -8,8 +8,6 @@ It will be Azuro’s front-facing onchain prediction markets explorer, allowing
 
 We envision Azuroscan to be your gateway to world events, driven by Azuro prediction markets. Uncover insights, analyze trends, view historical odds, see betting flows, etc. — all in one place!
 
-What Etherscan is for Ethereum, is what Azuroscan will be for Azuro.
-
 <Callout type="info">
-**Azuroscan →** coming sewn.
+**Azuroscan →** coming soon
 </Callout>

pages/knowledge-hub/introduction/background/prediction-markets-v1.mdx → pages/knowledge-hub/background/prediction-markets-v1.mdx

@@ -10,6 +10,6 @@ Initial liquidity is seeded to the AMM by an entity (e.g., market makers) — th
 
 ## CLOB
 
-Advances made in blockchain scalability (and proving capabilities) results in the renaissance of the onchain CLOB model. In the case of prediction markets, each event has their own orderbook where participants may place bid/ask orders to trade YES and NO tokens.
+Advances made in blockchain scalability (and proving capabilities) results in the renaissance of the centralized orderbook (CLOB) model. In the case of prediction markets, each event has their own orderbook where participants may place bid/ask orders to trade YES and NO tokens.
 
 Market makers are employed to make liquidity for each orderbook-based prediction market, and price movements will depend on betting flows with regards to liquidity: the more liquidity market-makers dedicate to the orderbook, the less sensitive prices will change per dollar of flow.