Done whole first cut

.gitbook.yaml

@@ -17,6 +17,10 @@ redirects:
     tutorials/wallets-and-ocean-tokens: discover/wallets-and-ocean.md
     discover/explore: discover/README.md
     discover/ocean-101: discover/README.md
+    discover/basic-concepts: user-guides/basic-concepts.md
+    discover/wallets/README: user-guides/wallets/README.md
+    discover/wallets/metamask-setup: user-guides/wallets/metamask-setup.md
+    discover/wallets-and-ocean: user-guides/wallets-and-ocean.md
     using-ocean-market: user-guides/using-ocean-market.md
     using-ocean-market/marketplace-publish-data-asset: user-guides/publish-data-nfts.md
     using-ocean-market/marketplace-download-data-asset: user-guides/buy-data-nfts.md

SUMMARY.md

@@ -5,15 +5,16 @@
   - [Why Ocean?](discover/why-ocean.md)
   - [What is Ocean?](discover/what-is-ocean.md)
   - [What can you do with Ocean?](discover/benefits.md)
-- [📚 User Guides](user-guides/README.md)
+  - [OCEAN: The Ocean token](discover/ocean-token.md)
-  - [Basic Concepts](discover/basic-concepts.md)
-  - [Wallets](discover/wallets/README.md)
-    - [Set Up MetaMask Wallet](discover/wallets/metamask-setup.md)
-    - [Manage Your OCEAN](discover/wallets-and-ocean.md)
   - [Networks](discover/networks/README.md)
     - [Bridges](discover/networks/bridges.md)
-  - [Glossary](discover/glossary.md)
   - [FAQ](discover/faq.md)
+  - [Glossary](discover/glossary.md)
+- [📚 User Guides](user-guides/README.md)
+  - [Basic Concepts](user-guides/basic-concepts.md)
+  - [Wallets](user-guides/wallets/README.md)
+    - [Set Up MetaMask Wallet](user-guides/wallets/metamask-setup.md)
+    - [Manage Your OCEAN](user-guides/wallets-and-ocean.md)
   - [Guide to the Ocean Market](user-guides/using-ocean-market.md)
     - [Publish Data NFTs](user-guides/publish-data-nfts.md)
     - [Buy NFT Data](user-guides/buy-data-nfts.md)
@@ -112,8 +113,8 @@
 * [👀 Predictoor](predictoor/README.md)
   * [Introduction](predictoor/pdr-intro.md)
   * [Architecture](predictoor/pdr-architecture.md)
-  * [Parameters](predictoor/pdr-parameters.md)  
   * [How to Earn](predictoor/pdr-earn.md)
+  * [Parameters](predictoor/pdr-parameters.md)
   * [Pdr FAQ](predictoor/pdr-faq.md)  
   * [Pdr Resources](predictoor/pdr-resources.md)
 * [💰 Data Farming](data-farming/README.md)

discover/README.md

@@ -14,12 +14,21 @@ Ocean is a decentralized data exchange protocol. Its core tech is:
 - Data NFTs & datatokens, to enable token-gated access control, data wallets, data DAOs, and more.
 - Compute-to-data: buy & sell private data, while preserving privacy
 
-**Ocean users are:**
+### Ocean Users Are...
+
 - **[Developers](../developers/README.md).** Build token-gated AI dApps & APIs
 - **[Data scientists](../data-scientists/README.md).** Earn via predictions & challenges
 - **[OCEAN holders](../data-farming/README.md).** Get rewards by locking OCEAN & curating data, via Data Farming.
 - **[Ocean ambassadors](https://oceanprotocol.com/explore/community)**
 
+### Quick Links
+
+- [Why Ocean?](why-ocean.md) and [What is Ocean?](what-is-ocean.md)
+- [What can you do with Ocean?](benefits.md)
+- [OCEAN: The Ocean token](ocean-token.md)
+- [Networks](networks/README.md), [Bridges](networks/bridges.md)
+- [FAQ](faq.md), [Glossary](glossary.md)
+
 ----
 
 _Next: [Why Ocean?](why-ocean.md)_

discover/benefits.md

@@ -112,8 +112,6 @@ To become a member of the Ambassador Program, follow these steps:
 
 ----
 
-Congrats! You've completed this quick introduction to Ocean.
+_Next: [OCEAN: The Ocean token](ocean-token.md)_
-
-_Next: If you're a blockchain newcomer, go to [User Guides](../user-guides/README.md). Otherwise jump to [Docs main](../README.md) and click on your interest._
 
 _Back: [What is Ocean?](what-is-ocean.md)_

discover/faq.md

@@ -209,3 +209,11 @@ Fees are generated Ocean Market from Ocean Market that head to Ocean community.
 For collaborations, please fill in this [form](https://docs.google.com/forms/d/e/1FAIpQLSdBz7cblsz5yuOKMVoPVfK0Pp1Xuqjwner1kCkRibIIbYMe-w/viewform). 
 One member of our team will reach out to you 🤝
 </details>
+
+
+----
+
+_Next: [Glossary](glossary.md)_
+
+_Back: [Bridges](networks/bridges.md)_
+

discover/glossary.md

@@ -1,7 +1,6 @@
 ---
 description: >-
-  A comprehensive list of key terms, concepts, and acronyms used in the Ocean
+  Key terms, concepts, and acronyms used in Ocean
-  Protocol ecosystem
 ---
 
 # Glossary
@@ -11,7 +10,6 @@ description: >-
 <details>
 
 <summary>Ocean Protocol</summary>
-
 Ocean Protocol is a decentralized data exchange protocol that enables individuals and organizations to share, sell, and consume data in a secure, transparent, and privacy-preserving manner. The protocol is designed to address the current challenges in data sharing, such as data silos, lack of interoperability, and data privacy concerns. Ocean Protocol uses blockchain technology, smart contracts, and cryptographic techniques to create a network where data providers can offer their data assets for sale, data consumers can purchase and access the data, and developers can build data-driven applications and services on top of the protocol.
 
 </details>
@@ -28,7 +26,7 @@ The Ocean Protocol's token (OCEAN) is a utility token used in the Ocean Protocol
 
 <summary>Data Consume Volume (DCV)</summary>
 
-The data consume value (DCV) is a key metric that refers to the amount of $ spent to buy data assets where the data assets are subsequently consumed.
+The data consume value (DCV) is a key metric that refers to the amount of $ spent over a time period, to buy data assets where the data assets are subsequently consumed.
 
 </details>
 
@@ -36,49 +34,7 @@ The data consume value (DCV) is a key metric that refers to the amount of $ spen
 
 <summary>Transaction Volume (TV)</summary>
 
-The transaction value is a key metric that refers to the value of transactions within the ecosystem.
+The transaction value is a key metric that refers to the number of blockchain transactions done over a time period.
-
-Transaction volume(TV) is often used interchangeably with data consume volume (DCV). DCV is a more refined metric that excludes activities like wash trading. DCV measures the actual consumption or processing of data within the protocol, which is a more accurate measure of the value generated by the ecosystem.
-
-</details>
-
-<details>
-
-<summary><strong>Base IP</strong></summary>
-
-**Base IP** means the artifact being copyrighted. Represented by the {ERC721 address, tokenId} from the publish transactions.
-
-</details>
-
-<details>
-
-<summary><strong>Base IP holder</strong></summary>
-
-**Base IP holder** means the holder of the Base IP. Represented as the actor that did the initial "publish" action.
-
-</details>
-
-<details>
-
-<summary><strong>Sub-licensee</strong></summary>
-
-**Sub-licensee** is the holder of the sub-license. Represented as the entity that controls address ERC721.\_owners\[tokenId=x].
-
-</details>
-
-<details>
-
-<summary><strong>To Publish</strong></summary>
-
-Claim copyright or exclusive base license.
-
-</details>
-
-<details>
-
-<summary><strong>To Sub-license</strong></summary>
-
-Transfer one (of many) sub-licenses to new licensee: ERC20.transfer(to=licensee, value=1.0).
 
 </details>
 
@@ -151,47 +107,47 @@ When a user allocates veOCEAN to Ocean Market projects, then weekly OCEAN reward
 
 </details>
 
+### Intellectual Property (IP) Concepts
+
 <details>
 
-<summary>Challenge DF</summary>
+<summary><strong>Base IP</strong></summary>
 
-When users submit accurate predictions for the price of Ethereum to the [Challenge DF program](https://df.oceandao.org/challenge-df), they have a chance to win OCEAN rewards by being in the top 3 submissions based on predicted value accuracy. 
+**Base IP** means the artifact being copyrighted. Represented by the {ERC721 address, tokenId} from the publish transactions.
-
-These rewards are classified as [Challenge DF](../data-farming/README.md) rewards since they require active participation in the challenge. Rewards can be claimed every Thursday on the [Rewards page](https://df.oceandao.org/rewards).
 
 </details>
 
 <details>
 
-<summary>H2O</summary>
+<summary><strong>Base IP holder</strong></summary>
 
-[H2O](https://www.h2odata.xyz/) is a decentralized protocol that introduced the first non-pegged stable asset, $H2O. Initially, it is backed by OCEAN but there are plans to be backed by other data tokens.
+**Base IP holder** means the holder of the Base IP. Represented as the actor that did the initial "publish" action.
-
-The H2O non-pegged stable asset is a friendly fork of RAI. Whereas RAI uses ether (ETH) as its asset for collateral, H2O uses OCEAN. The price of H2O is managed by an algorithm that rebalances to bring the redemption price close to the market price and participants are incentivized to aid in this process. Traditional stable assets are pegged to a price such as 1 USD. In contrast, RAI (and soon H2O) are free-floating but typically settle around a price; for RAI this has been \~$3.
 
 </details>
 
 <details>
 
-<summary>$POSEIDON</summary>
+<summary><strong>Sub-licensee</strong></summary>
 
-The [POSEIDON token](https://docs.h2odata.xyz/protocol-overview/poseidon-mechanics) is the governance token of the H2O protocol. With the following function inside the protocol:
+**Sub-licensee** is the holder of the sub-license. Represented as the entity that controls address ERC721.\_owners\[tokenId=x].
-
-* Ungovernance: once governance minimization is finalized, POSEIDON holders will be able to remove control from any remaining components in H2O or, if needed, continue to manage components that may be challenging to ungovern (such as oracles or any other component interacting with other protocols).
 
 </details>
 
 <details>
 
-<summary>$psdnOcean</summary>
+<summary><strong>To Publish</strong></summary>
 
-[psdnOCEAN](https://docs.h2odata.xyz/protocol-overview/psdnocean-veocean-liquid-staking) is the liquid staking wrapper for veOCEAN.
+Claim copyright or exclusive base license.
-
-* Convert OCEAN to psdnOCEAN with a 1:1 ratio.
-* Gain access to a liquid asset and receive a share of the revenue of veOCEAN.
 
 </details>
 
+<details>
+
+<summary><strong>To Sub-license</strong></summary>
+
+Transfer one (of many) sub-licenses to new licensee: ERC20.transfer(to=licensee, value=1.0).
+
+</details>
 
 
 ### Web3 Fundamentals
@@ -465,4 +421,14 @@ Machine learning is a subfield of artificial intelligence (AI) that involves tea
 </details>
 
 
+----
+
+
+Congrats! You've completed this quick introduction to Ocean.
+
+_Next: Jump to [Docs main](../README.md) and click on your interest._
+
+_Back: [FAQ](faq.md)_
+
+
 

discover/networks/README.md

@@ -1,13 +1,39 @@
 ---
-title: Supported Networks
+title: 
 description: All the public networks the Ocean Protocol contracts are deployed to.
 ---
 
 # Networks
 
-Ocean Protocol contracts are deployed on multiple public networks. You can always find the most up-to-date deployment addresses for all individual contracts in the [address.json](https://github.com/oceanprotocol/contracts/blob/v4main/addresses/address.json).
+Ocean Protocol's smart contracts and OCEAN are deployed on multiple public networks: several production chains, and several testnets too.
 
-In each network, whether it's the Ethereum mainnet, a testnet, or the Polygon/Matic network, you'll need ETH or Matic to pay for gas and OCEAN for certain actions on the Ocean Protocol network. The Ethereum mainnet and the Polygon network are both live networks and the tokens on these networks have real value. However, the tokens on the test networks are not of real value and are only used for testing purposes. You can obtain testnet ETH and OCEAN from faucets, which are services that provide small amounts of tokens for free.
+[address.json](https://github.com/oceanprotocol/contracts/blob/v4main/addresses/address.json) holds up-to-date deployment addresses for all Ocean contracts.
+
+You need the network's native token to pay for gas to make transactions: ETH for Ethereum mainnet, MATIC for Polygon, etc; you typically get these from exchanges. You also need "fake" native tokens for testnets; you typically get these from faucets.
+
+## Networks Summary
+
+Here are the networks that Ocean is deployed to.
+
+**Production Networks:**
+- [Ethereum mainnet](#ethereum-mainnet)
+- [Polygon mainnet](#polygon-mainnet)
+- [Oasis Sapphire mainnet](#oasis-sapphire-mainnet)
+- [BNB Smart Chain](#bnb-smart-chain)
+- [Energy Web Chain](#energy-web-chain)
+- [Optimism Mainnet](#optimism-mainnet)
+- [Moonriver](#moonriver)
+
+**Test Networks:**
+- [Görli](#görli)
+- [Sepolia](#sepolia)
+- [Mumbai](#mumbai)
+- [Oasis Sapphire testnet](#oasis-sapphire-testnet)
+- [Optimism Sepolia](#optimism-sepolia)
+
+The rest of this doc gives details for each network. You can skip it until you need the reference information.
+
+## Production Networks
 
 ### Ethereum Mainnet
 
@@ -35,18 +61,6 @@ Ocean Protocol is also deployed to Oasis Sapphire Mainnet, which is a production
 
 Check out our Celer Bridge [guide](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/get-ocean-on-sapphire.md#2-transfer-ocean-to-sapphire-mainnet-via-celer) to learn how you can bridge your OCEAN tokens from Ethereum Mainnet to Oasis Sapphire Mainnet.
 
-### Oasis Sapphire Testnet
-
-Ocean Protocol is also deployed to Oasis Sapphire Testnet, which is a test network that Ocean Protocol uses for [Predictoor](https://predictoor.ai). Ocean Protocol does do not currently support ocean.js, ocean.py, or Ocean Market on Oasis Sapphire. The native token of Oasis Sapphire is ROSE. If you cannot find Oasis Sapphire Testnet as a predefined network in your wallet, you can manually connect to it by entering the following information during the import process: Network Name: `Oasis Sapphire Testnet`, RPC URL: `https://testnet.sapphire.oasis.dev`, Chain ID: `23295`, Token: `ROSE`.
-
-<table data-header-hidden><thead><tr><th width="100">Gas Token</th><th>ROSE(Native token)</th></tr></thead><tbody><tr><td>OCEAN</td><td><a href="https://explorer.oasis.io/testnet/sapphire/address/0x973e69303259B0c2543a38665122b773D28405fB">0x973e69303259B0c2543a38665122b773D28405fB</a></td></tr><tr><td>Explorer</td><td><a href="https://explorer.oasis.io/testnet/sapphire/">https://explorer.oasis.io/testnet/sapphire/</a></td></tr></tbody></table>
-
-**Get (fake) OCEAN on Sapphire Testnet**
-
-Check out our [guide](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/testnet-faucet.md#get-fake-ocean-on-sapphire-testnet) for how to get fake OCEAN tokens on Sapphire Testnet. 
-
-Check out our [guide](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/testnet-faucet.md#get-fake-rose-on-sapphire-testnet) for how to get fake ROSE tokens on Oasis Sapphire Testnet.
-
 ### BNB Smart Chain
 
 Ocean Protocol is also deployed to BNB Smart Chain, which is another production network. The native token of the BNB Smart Chain is BNB, which is the token of the Binance exchange. If BNB Smart Chain is not listed as a predefined network in your wallet, you can manually connect to it by following Binance's [guide](https://academy.binance.com/en/articles/connecting-metamask-to-binance-smart-chain), which provides detailed instructions on how to connect to BNB Smart Chain.
@@ -67,7 +81,7 @@ Ocean Protocol is also deployed to [Energy Web Chain](https://energy-web-foundat
 
 To bridge assets between Energy Web Chain and Ethereum mainnet, you can use [this](https://bridge.carbonswap.exchange/) bridge.
 
-### OP Mainnet(Optimism)
+### Optimism Mainnet
 
 Ocean Protocol is also deployed to OP Mainnet (Optimism), which is another production network. The native token of Optimism is ETH, which needs to be bridged from Ethereum Mainnet. If you cannot find Optimism as a predefined network in your wallet, you can manually connect to it by following OP's [guide](https://community.optimism.io/docs/useful-tools/networks/#op-mainnet), which provides step-by-step instructions for connecting to OP Mainnet.
 
@@ -87,12 +101,22 @@ Ocean Protocol is also deployed to [Moonriver](https://docs.moonbeam.network/bui
 
 To bridge assets between Moonriver and Ethereum mainnet, you can use [this](https://anyswap.exchange/#/bridge) bridge.
 
+
+## Test Networks
+
+
 ### Görli
 
 Ocean Protocol is deployed on the Görli test network, which is used for testing and experimentation. Tokens on Görli do not hold real economic value, as it is a non-production network. To connect to Görli using a wallet like MetaMask, simply click on the network name dropdown and select _Goerli_ from the list of available networks.
 
 <table data-header-hidden><thead><tr><th width="100">Gas Token</th><th>Görli ETH(Native token)</th></tr></thead><tbody><tr><td>Görli ETH</td><td><a href="https://goerlifaucet.com/">Faucet</a>. You may find others by <a href="https://www.google.com/search?q=goerli+ether+faucet%5C&#x26;oq=goerli+ether+faucet">searching</a>.</td></tr><tr><td>Görli OCEAN</td><td><a href="https://faucet.goerli.oceanprotocol.com">Faucet</a></td></tr><tr><td>OCEAN</td><td><a href="https://goerli.etherscan.io/address/0xcfdda22c9837ae76e0faa845354f33c62e03653a">0xCfDdA22C9837aE76E0faA845354f33C62E03653a</a></td></tr><tr><td>Explorer</td><td><a href="https://blockscout.moonriver.moonbeam.network">https://blockscout.moonriver.moonbeam.network</a></td></tr></tbody></table>
 
+### Sepolia
+
+Ocean Protocol is deployed on the Sepolia test network, which is designed for testing and experimentation purposes. Tokens in Sepolia do not hold any real economic value, as it is not a production network. To connect to Sepolia using a wallet like MetaMask, you can select "Sepolia" from the network dropdown list(enable "Show test networks").
+
+<table data-header-hidden><thead><tr><th width="100">Gas Token</th><th>SepoliaETH (Native token)</th></tr></thead><tbody><tr><td>SepoliaETH</td><td><a href="https://sepoliafaucet.com/">Faucet</a></td></tr><tr><td>Sepolia OCEAN</td><td><a href="https://faucet.sepolia.oceanprotocol.com/">Faucet</a></td></tr><tr><td>OCEAN</td><td><a href="https://sepolia.etherscan.io/address/0x1B083D8584dd3e6Ff37d04a6e7e82b5F622f3985">0x1B083D8584dd3e6Ff37d04a6e7e82b5F622f3985</a></td></tr><tr><td>Explorer</td><td><a href="https://sepolia.etherscan.io/">https://sepolia.etherscan.io/</a></td></tr></tbody></table>
+
 ### Mumbai
 
 Ocean Protocol is deployed on the Mumbai test network Matic / Polygon, which is designed for testing and experimentation purposes. Tokens in Mumbai do not hold any real economic value, as it is not a production network. To connect to Mumbai using a wallet like MetaMask, you can select "Görli" from the network dropdown list.
@@ -101,14 +125,20 @@ If Mumbai is not listed as a predefined network in your wallet, you can connect
 
 <table data-header-hidden><thead><tr><th width="100"></th><th>Mumbai MATIC(Native token)</th></tr></thead><tbody><tr><td>Mumbai MATIC</td><td><a href="https://faucet.matic.network/">Faucet</a>. You may find others by <a href="https://www.google.com/search?q=mumbai+faucet">searching</a>.</td></tr><tr><td>Mumbai OCEAN</td><td><a href="https://faucet.mumbai.oceanprotocol.com/">Faucet</a></td></tr><tr><td>OCEAN</td><td><a href="https://mumbai.polygonscan.com/token/0xd8992Ed72C445c35Cb4A2be468568Ed1079357c8">0xd8992Ed72C445c35Cb4A2be468568Ed1079357c8</a></td></tr><tr><td>Explorer</td><td><a href="https://mumbai.polygonscan.com">https://mumbai.polygonscan.com</a></td></tr></tbody></table>
 
-### Sepolia
+### Oasis Sapphire Testnet
 
-Ocean Protocol is deployed on the Sepolia test network, which is designed for testing and experimentation purposes. Tokens in Sepolia do not hold any real economic value, as it is not a production network. To connect to Sepolia using a wallet like MetaMask, you can select "Sepolia" from the network dropdown list(enable "Show test networks").
+Ocean Protocol is also deployed to Oasis Sapphire Testnet, which is a test network that Ocean Protocol uses for [Predictoor](https://predictoor.ai). Ocean Protocol does do not currently support ocean.js, ocean.py, or Ocean Market on Oasis Sapphire. The native token of Oasis Sapphire is ROSE. If you cannot find Oasis Sapphire Testnet as a predefined network in your wallet, you can manually connect to it by entering the following information during the import process: Network Name: `Oasis Sapphire Testnet`, RPC URL: `https://testnet.sapphire.oasis.dev`, Chain ID: `23295`, Token: `ROSE`.
 
-<table data-header-hidden><thead><tr><th width="100">Gas Token</th><th>SepoliaETH (Native token)</th></tr></thead><tbody><tr><td>SepoliaETH</td><td><a href="https://sepoliafaucet.com/">Faucet</a></td></tr><tr><td>Sepolia OCEAN</td><td><a href="https://faucet.sepolia.oceanprotocol.com/">Faucet</a></td></tr><tr><td>OCEAN</td><td><a href="https://sepolia.etherscan.io/address/0x1B083D8584dd3e6Ff37d04a6e7e82b5F622f3985">0x1B083D8584dd3e6Ff37d04a6e7e82b5F622f3985</a></td></tr><tr><td>Explorer</td><td><a href="https://sepolia.etherscan.io/">https://sepolia.etherscan.io/</a></td></tr></tbody></table>
+<table data-header-hidden><thead><tr><th width="100">Gas Token</th><th>ROSE(Native token)</th></tr></thead><tbody><tr><td>OCEAN</td><td><a href="https://explorer.oasis.io/testnet/sapphire/address/0x973e69303259B0c2543a38665122b773D28405fB">0x973e69303259B0c2543a38665122b773D28405fB</a></td></tr><tr><td>Explorer</td><td><a href="https://explorer.oasis.io/testnet/sapphire/">https://explorer.oasis.io/testnet/sapphire/</a></td></tr></tbody></table>
+
+**Get (fake) OCEAN on Sapphire Testnet**
+
+Check out our [guide](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/testnet-faucet.md#get-fake-ocean-on-sapphire-testnet) for how to get fake OCEAN tokens on Sapphire Testnet. 
+
+Check out our [guide](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/testnet-faucet.md#get-fake-rose-on-sapphire-testnet) for how to get fake ROSE tokens on Oasis Sapphire Testnet.
 
 
-### OP Sepolia(Optimism)
+### Optimism Sepolia
 
 Ocean Protocol is deployed on the OP Sepolia test network, which is designed for testing and experimentation purposes. Tokens in Sepolia do not hold any real economic value, as it is not a production network. If OP Sepolia is not listed as a predefined network in your wallet, you can manually connect to it by following OP's [guide](https://community.optimism.io/docs/useful-tools/networks/#op-sepolia), which provides detailed instructions on how to connect to OP Seploia.
 
@@ -117,3 +147,11 @@ Ocean Protocol is deployed on the OP Sepolia test network, which is designed for
 **Bridge**
 
 Check out the OP Bridge [guide](https://https://app.optimism.io/bridge/deposit) to deposit, withdraw and send tokens.
+
+
+----
+
+_Next: [Bridges](bridges.md)_
+
+_Back: [OCEAN: the Ocean token](../ocean-token.md)_
+

discover/networks/bridges.md

@@ -7,7 +7,13 @@ description: Transfer tokens between two blockchain networks.
 
 A bridge is a mechanism that connects two or more separate blockchain networks, enabling communication and interoperability between them. Bridges can be designed to facilitate the transfer of assets, data, or messages between different blockchain networks that may operate on different protocols, and consensus mechanisms, or have different native currencies.
 
-We suggest using the following solutions to transfer OCEAN between Ethereum mainnet and Polygon or BSC.
+This page covers:
+- [Celer Bridge](#celer-bridge) - bridge OCEAN from Eth mainnet <> Oasis Sapphire mainnet
+- [BNB Smart Chain Bridge](#bnb-smart-chain-bridge) - bridge OCEAN from Eth mainnet <> BNB Smart Chain
+
+For other bridges and networks, see the [Networks page](README.md).
+
+The rest of this doc gives bridging details. You can skip it until you need the reference information.
 
 ## Celer Bridge
 
@@ -81,3 +87,11 @@ Alternatively, you can manually configure the network on Metamask by using the f
 | Currency Symbol    | `MATIC`                                              |
 | Block Explorer URL | [`https://polygonscan.com`](https://polygonscan.com) |
 
+
+
+----
+
+_Next: [FAQ](../faq.md)_
+
+_Back: [Networks](README.md)_
+

discover/ocean-token.md

@@ -0,0 +1,134 @@
+---
+description: 
+---
+
+# OCEAN: The Ocean Token
+
+OCEAN is a utility token. It's used to stake on data for curation, buy & sell data, and more. Its supply is disbursed over time to drive near-term growth and long-term sustainability.
+
+**Contents:**
+- [Getting and storing OCEAN](#getting-and-storing-ocean)
+- [Staking OCEAN](#staking-ocean)
+- [OCEAN supply](#ocean-supply)
+- [Token design](#ocean-token-design)
+- [OCEAN addresses](#ocean-addresses)
+
+
+<figure><img src="../.gitbook/assets/general/purchase-and-compute_and_ocean-network.png" alt=""></figure>
+
+
+
+### Getting and Storing OCEAN
+
+OCEAN is available on most leading CEXes and DEXes. The [Ocean Token page at oceanprotocol.com](https://oceanprotocol.com/about-us/ocean-token) has details. 
+
+The [Wallets User Guide](../user-guides/wallets/README.md) here in Ocean docs shows how to set up wallets and store OCEAN.
+
+### Staking OCEAN
+
+You can lock OCEAN and earn rewards via [Ocean Data Farming](../data-farming/README.md).
+
+### OCEAN supply
+
+Total # tokens: 1.41B. All tokens are minted; all control is [revoked](https://blog.oceanprotocol.com/control-over-the-ocean-contract-to-be-revoked-soon-overview-6c5b15be2db).
+
+OCEAN supply is divided as follows:
+
+- 51% (719.1M OCEAN) - to Data Farming and incentives programs. Distributed via vesting: burn-in period then 4-year half-life. For details, see section 5.1 "OCEAN Emissions Schedule" of [Data Farming Main](https://blog.oceanprotocol.com/ocean-data-farming-main-is-here-49c99602419e#5a8f).
+- 15% (211.5M OCEAN) - to Ocean community (grants, more) and foundation operations. 
+- 10% (141.0M OCEAN) - to the founding company, and in turn to its investors, employees & operations
+- 24% (338.4M OCEAN) - to token acquirors. This completed in early 2019. All acquiror vesting is complete as well.
+
+### OCEAN Token Design
+
+The system-level design of the OCEAN token is based on [The Web3 Sustainability Loop](https://blog.oceanprotocol.com/the-web3-sustainability-loop-b2a4097a36e), a general design pattern. The Ocean-specific version of this design is described in [section (7) of that same article](https://blog.oceanprotocol.com/the-web3-sustainability-loop-b2a4097a36e#e0f6).
+
+This design gives flexibility to adapt the Ocean products for traction and growth. The flexibility is due to the goal to "drive network revenue", subject to the constraints of the mission & values of Ocean Protocol.
+
+<figure><img src="../.gitbook/assets/general/whirlpool.png" alt=""></figure>
+
+
+### OCEAN addresses
+
+The "root" OCEAN token is deployed on Ethereum mainnet with address [`0x967da4048cd07ab37855c090aaf366e4ce1b9f48`](https://etherscan.io/token/0x967da4048cd07ab37855c090aaf366e4ce1b9f48).
+
+The OCEAN token has bridges to several [other chains](networks/README.md). It has a unique address on each chain.
+
+<details>
+
+<summary><mark style="color:black;"><i>OCEAN address per chain: (expand me)</i></mark></summary>
+
+<table data-full-width="false">
+   <thead>
+      <tr>
+         <th width="161">Network name</th>
+         <th width="444">Contract Address</th>
+         <th width="105">Symbol</th>
+         <th>Decimals</th>
+      </tr>
+   </thead>
+   <tbody>
+      <tr>
+         <td><strong>Mainnet</strong></td>
+         <td>0x967da4048cD07aB37855c090aAF366e4ce1b9F48</td>
+         <td>OCEAN</td>
+         <td>18</td>
+      </tr>
+      <tr>
+         <td><strong>Polygon</strong><br><strong>(ex Matic)</strong></td>
+         <td>0x282d8efCe846A88B159800bd4130ad77443Fa1A1</td>
+         <td>mOCEAN</td>
+         <td>18</td>
+      </tr>
+      <tr>
+         <td><strong>BNB</strong><br><strong>BNB Smart Chain</strong></td>
+         <td>0xdce07662ca8ebc241316a15b611c89711414dd1a</td>
+         <td>OCEAN</td>
+         <td>18</td>
+      </tr>
+       <tr>
+         <td><strong>Oasis Sapphire</strong></td>
+         <td>0x39d22B78A7651A76Ffbde2aaAB5FD92666Aca520</td>
+         <td>OCEAN</td>
+         <td>18</td>
+      </tr>
+      <tr>
+         <td><strong>Optimism</strong></td>
+         <td>0xf26c6c93f9f1d725e149d95f8e7b2334a406ad10</td>
+         <td>OCEAN</td>
+         <td>18</td>
+      </tr>
+      <tr>
+         <td><strong>Görli</strong></td>
+         <td>0xCfDdA22C9837aE76E0faA845354f33C62E03653a</td>
+         <td>OCEAN</td>
+         <td>18</td>
+      </tr>
+      <tr>
+         <td><strong>Mumbai</strong></td>
+         <td>0xd8992Ed72C445c35Cb4A2be468568Ed1079357c8</td>
+         <td>OCEAN</td>
+         <td>18</td>
+      </tr>
+      <tr>
+         <td><strong>Sepolia</strong></td>
+         <td>0x1B083D8584dd3e6Ff37d04a6e7e82b5F622f3985</td>
+         <td>OCEAN</td>
+         <td>18</td>
+      </tr>
+     <tr>
+         <td><strong>Oasis Sapphire Testnet</strong></td>
+         <td>0x973e69303259B0c2543a38665122b773D28405fB</td>
+         <td>OCEAN</td>
+         <td>18</td>
+      </tr>
+   </tbody>
+</table>
+
+</details>
+
+----
+
+_Next: [Networks](networks/README.md)_
+
+_Back: [What can you do with Ocean?](benefits.md)_

discover/wallets-and-ocean.md

@@ -1,103 +0,0 @@
----
-description: >-
-  How to use a crypto wallet to check your OCEAN balance and send OCEAN
-  Tokens to others
----
-
-# Manage Your OCEAN
-
-If you don't see any OCEAN in your crypto wallet software 🔎 (e.g. MetaMask or MyEtherWallet), don't worry! It might not know how to manage OCEAN yet.
-
-### Token Information
-
-Almost all ERC-20 wallets require these values for adding a custom token:
-
-<table data-full-width="false">
-   <thead>
-      <tr>
-         <th width="161">Network name</th>
-         <th width="444">Contract Address</th>
-         <th width="105">Symbol</th>
-         <th>Decimals</th>
-      </tr>
-   </thead>
-   <tbody>
-      <tr>
-         <td><strong>Mainnet</strong></td>
-         <td>0x967da4048cD07aB37855c090aAF366e4ce1b9F48</td>
-         <td>OCEAN</td>
-         <td>18</td>
-      </tr>
-      <tr>
-         <td><strong>Polygon</strong><br><strong>(ex Matic)</strong></td>
-         <td>0x282d8efCe846A88B159800bd4130ad77443Fa1A1</td>
-         <td>mOCEAN</td>
-         <td>18</td>
-      </tr>
-      <tr>
-         <td><strong>BNB</strong><br><strong>BNB Smart Chain</strong></td>
-         <td>0xdce07662ca8ebc241316a15b611c89711414dd1a</td>
-         <td>OCEAN</td>
-         <td>18</td>
-      </tr>
-       <tr>
-         <td><strong>Oasis Sapphire</strong></td>
-         <td>0x39d22B78A7651A76Ffbde2aaAB5FD92666Aca520</td>
-         <td>OCEAN</td>
-         <td>18</td>
-      </tr>
-      <tr>
-         <td><strong>Optimism</strong></td>
-         <td>0xf26c6c93f9f1d725e149d95f8e7b2334a406ad10</td>
-         <td>OCEAN</td>
-         <td>18</td>
-      </tr>
-      <tr>
-         <td><strong>Görli</strong></td>
-         <td>0xCfDdA22C9837aE76E0faA845354f33C62E03653a</td>
-         <td>OCEAN</td>
-         <td>18</td>
-      </tr>
-      <tr>
-         <td><strong>Mumbai</strong></td>
-         <td>0xd8992Ed72C445c35Cb4A2be468568Ed1079357c8</td>
-         <td>OCEAN</td>
-         <td>18</td>
-      </tr>
-      <tr>
-         <td><strong>Sepolia</strong></td>
-         <td>0x1B083D8584dd3e6Ff37d04a6e7e82b5F622f3985</td>
-         <td>OCEAN</td>
-         <td>18</td>
-      </tr>
-     <tr>
-         <td><strong>Oasis Sapphire Testnet</strong></td>
-         <td>0x973e69303259B0c2543a38665122b773D28405fB</td>
-         <td>OCEAN</td>
-         <td>18</td>
-      </tr>
-   </tbody>
-</table>
-
-The [token page](https://oceanprotocol.com/token) at oceanprotocol.com has further details.
-
-### MetaMask
-
-1. Make sure MetaMask is connected to the Ethereum Mainnet.
-2. Select the account you want to manage.
-3. Scroll down until the `Import Tokens` link is visible, then click on it.
-4. Click on `Custom Tokens`.
-5. Paste the OCEAN contract address listed above into the _Token Contract Address_ field. The other two fields should auto-fill. If not, add `OCEAN` for the symbol and `18` for the precision.
-6. Click `Add custom token`.
-7. Click `Import Tokens`.
-
-If you prefer visual demonstrations, we have prepared a visual demo that illustrates the steps mentioned above.
-
-{% embed url="https://app.arcade.software/share/yHiKKN336QGdAkhTlsIh" fullWidth="false" %}
-{% endembed %}
-
-MetaMask should now show your OCEAN balance, and when you're looking at that, there should be a `Send` button to send OCEAN to others. For help with that, see [the MetaMask docs about how to send tokens](https://metamask.zendesk.com/hc/en-us/articles/360015488931-How-to-Send-Tokens).
-
-### Other Wallet Software
-
-Do a web search to find out how to add a custom ERC-20 token to the wallet software you're using.

predictoor/README.md

@@ -28,7 +28,11 @@ Ocean Predictoor provides on-chain "prediction feeds" on whether ETH, BTC, etc w
 
 Finally, join us on [**Discord**](https://discord.gg/TnXjkR5) to chat with other predictoors, traders, or devs in the Predictoor ecosystem.
 
-## Next step
 
-If you're going through docs sequentially: next is [Introduction](pdr-intro.md).
+----
+
+_Next: [Introduction](pdr-intro.md)_
+
+_Back: [Docs main](../README.md)_
+
 

predictoor/pdr-architecture.md

@@ -83,7 +83,9 @@ The implementation is in templates/ERC20Template3.sol at at [Ocean’s contracts
 
 **- Predictoor behavior.** Each datatoken contract has additional methods specific to Predictoor: submitting predictions, submitting truevals, computing aggregated predictions, etc.
 
+----
 
-## Next step
+_Next: [How to earn](pdr-earn.md)_
+
+_Back: [Introduction](pdr-intro.md)_
 
-If you're going through docs sequentially: next is [How to earn](pdr-earn.md).

predictoor/pdr-earn.md

@@ -64,12 +64,13 @@ The image below has the same experimental setup, but for BTC/USDT pair. The size
 
 <figure><img src="../.gitbook/assets/predictoor/simulated_returns_btc_usdt.png" alt=""><figcaption>Simulated returns vs time of BTC/USDT trading on Binance. Trade size has little impact.</figcaption></figure>
 
+----
 
-## Next step
+_Next: [Parameters](pdr-parameters.md)_
 
-If you're going through docs sequentially: next is [Parameters](pdr-parameters.md).
+_Back: [Architecture](pdr-architecture.md)_
 
-Or to drill into earning further:
+_Or, drill into earning further:_
 - [Pdr-backend repo](https://github.com/oceanprotocol/pdr-backend) - how to run bots, specifically
 - [Predictoor Data Farming](../data-farming/predictoordf.md) - baseline sales $  for running predictoor bots
 

predictoor/pdr-faq.md

@@ -158,6 +158,9 @@ Predictoor needs to leverage a privacy-preserving EVM chain which is in producti
 </details>
 
 
-## Next step
+----
+
+_Next: [Further Resources](pdr-resources.md)_
+
+_Back: [Parameters](pdr-parameters.md)_
 
-If you're going through docs sequentially: next is [Further Resources](pdr-resources.md).

predictoor/pdr-intro.md

@@ -33,8 +33,8 @@ Alas, accurate predictions are *hard*. Worse, typical prediction feeds have no a
 <figure><img src="../.gitbook/assets/predictoor/predictoor_ui.png" alt=""><figcaption>Screenshot from predictoor.ai</figcaption></figure>
 
 
-## Next step
+----
-
-If you're going through docs sequentially: next is [Architecture](pdr-architecture.md).
 
+_Next: [Architecture](pdr-architecture.md)_
 
+_Back: [Predictoor Docs main](README.md)_

predictoor/pdr-parameters.md

@@ -32,6 +32,9 @@ The price to subscribe to one feed for 24 hours is 3.00 OCEAN. This includes all
 Pricing is subject to change based on learnings, and feedback from community.  
 
 
-## Next step
+----
+
+_Next: [FAQ](pdr-faq.md)_
+
+_Back: [How to earn](pdr-earn.md)_
 
-If you're going through docs sequentially: next is [FAQ](pdr-faq.md).

predictoor/pdr-resources.md

@@ -14,10 +14,11 @@ For thoroughness:
 - All blog posts & media: ["Ocean Predictoor Series"](https://blog.oceanprotocol.com/ocean-predictoor-series-6a9122754a4d)
 - Webapp code is at [pdr-web](https://github.com/oceanprotocol/pdr-web/) repo
 
-## Next step
+----
 
 Congrats, you've gone through all the Predictoor docs!
 
-Follow-up links:
+_Next: Go earn! Start at [how to earn](pdr-earn.md). Or, go to [Predictoor docs homepage](README.md)_
-- Go earn! Start at [how to earn](pdr-earn.md)
+
-- [Predictoor docs Homepage](README.md)
+_Back: [FAQ](pdr-faq.md)_
+

user-guides/README.md

@@ -10,6 +10,25 @@ coverY: 0
 
 <figure><img src="../.gitbook/assets/gif/follow-instructions.gif" alt="" width="375"><figcaption></figcaption></figure>
 
+### For Blockchain / Web3 Beginners
+
+{% content-ref url="publish-data-nfts.md" %}
+[basic-concepts.md](basic-concepts.md)
+{% endcontent-ref %}
+
+{% content-ref url="publish-data-nfts.md" %}
+[wallets/README.md.md](wallets/README.md.md)
+{% endcontent-ref %}
+
+{% content-ref url="publish-data-nfts.md" %}
+[wallets/metamask-setup.md.md](wallets/metamask-setup.md.md)
+{% endcontent-ref %}
+
+{% content-ref url="publish-data-nfts.md" %}
+[wallets-and-ocean.md](wallets-and-ocean.md)
+{% endcontent-ref %}
+
+
 ### Tokenize & sell your data
 
 Buy, mint, and sell NFTs using the Ocean Market following the guides below.
@@ -34,14 +53,6 @@ Buy, mint, and sell NFTs using the Ocean Market following the guides below.
 [using-ocean-market.md](using-ocean-market.md)
 {% endcontent-ref %}
 
-### Data Farming
-
-Earn rewards by locking OCEAN, curating data assets, and more.
-
-{% content-ref url="../data-farming/README.md" %}
-[../data-farming/README.md](../data-farming/README.md)
-{% endcontent-ref %}
-
 ### Antique Stuff 🏺
 
 If you have OCEAN in old pools, this will help.

user-guides/wallets/wallets-and-ocean.md

@@ -0,0 +1,35 @@
+---
+description: >-
+  How to use a crypto wallet to check your OCEAN balance and send OCEAN
+  Tokens to others
+---
+
+# Manage Your OCEAN
+
+If you don't see any OCEAN in your crypto wallet software 🔎 (e.g. MetaMask or MyEtherWallet), don't worry! It might not know how to manage OCEAN yet.
+
+For an ERC-20 wallet to see OCEAN, the wallet typically needs to have OCEAN's address added as a custom token.
+- The [OCEAN docs page](../discover/ocean-token.md) has the OCEAN address for each network.
+- Then, use that information for the wallet instructions below.
+
+
+### MetaMask
+
+1. Make sure MetaMask is connected to the Ethereum Mainnet.
+2. Select the account you want to manage.
+3. Scroll down until the `Import Tokens` link is visible, then click on it.
+4. Click on `Custom Tokens`.
+5. Paste the OCEAN contract address listed above into the _Token Contract Address_ field. The other two fields should auto-fill. If not, add `OCEAN` for the symbol and `18` for the precision.
+6. Click `Add custom token`.
+7. Click `Import Tokens`.
+
+If you prefer visual demonstrations, we have prepared a visual demo that illustrates the steps mentioned above.
+
+{% embed url="https://app.arcade.software/share/yHiKKN336QGdAkhTlsIh" fullWidth="false" %}
+{% endembed %}
+
+MetaMask should now show your OCEAN balance, and when you're looking at that, there should be a `Send` button to send OCEAN to others. For help with that, see [the MetaMask docs about how to send tokens](https://metamask.zendesk.com/hc/en-us/articles/360015488931-How-to-Send-Tokens).
+
+### Other Wallet Software
+
+Do a web search to find out how to add a custom ERC-20 token to the wallet software you're using.