Fix #1407: Low-hanging fruit for approachability

developers/README.md

@@ -1,24 +1,47 @@
 ---
-description: >-
-  Your resource hub for diving deep into the core concepts, exploring main
-  components, and accessing practical examples and integration guides to unleash
-  the power of Ocean Protocol in your applications
+description: Token-gated AI dApps & APIs
 cover: ../.gitbook/assets/cover/developer_banner.png
 coverY: 0
 ---
 
 # 👨💻 Developers
 
-With Ocean, crypto wallets transform into magical data wallets, where your data can roam freely and securely. Crypto exchanges? Well, they've taken on a new role as data marketplaces, where you can showcase and trade your valuable data treasures. And hold on tight because DAOs are here to create epic data co-ops, where collaboration and innovation reign supreme! 🤝
+### What can a developer build?
 
-But hold on tight, because we have even more in store for you! With Ocean Protocol, you gain access to a treasure trove of tools that will unlock your data scientist superpowers and allow you to unleash your creativity. Whether you're a Python aficionado or a JavaScript maestro, we have you covered with [ocean.py](../data-scientists/ocean.py/README.md) and [ocean.js](ocean.js/README.md) libraries. So, get ready to dive into the depths of data innovation and create the next groundbreaking dAapp (that's a decentralized App, by the way) using [ocean.js's](ocean.js/README.md) powerful capabilities or unleash your skills with [ocean.py](../data-scientists/ocean.py/README.md). It's time to shake up the data world like never before! 🌐🚀
+1. **Token-gated dApps & REST APIs**: monetize by making your dApp or its REST API token-gated. [Here's how](https://github.com/oceanprotocol/token-gating-template).
+1. **AI dApps**: monetize your AI dApp by token-gating on AI training data, feature vectors, models, or predictions.
+1. **Data Markets**: build a decentralized [data market](../developers/build-a-marketplace/README.md).
+1. **Private user profile data**: storing user profile data on your centralized server exposes you to liability. Instead, have it on-chain encrypted by the user's wallet, and just-in-time decrypt for the app. [Video](https://www.youtube.com/watch?v=xTfI8spLq1k&ab_channel=ParticleNetwork), [slides](https://docs.google.com/presentation/d/1_lkDVUkA0Rx1R7RpkaSeLkX3PeOBoMQyRhvxjwTvd6A/edit?usp=sharing).
 
-<figure><img src="../.gitbook/assets/general/developers.png" alt=""><figcaption><p>Ocean Protocol Explorer</p></figcaption></figure>
+### Example live dApps
 
-At the core of the Ocean Protocol, you'll find a constellation of [smart contracts](contracts/README.md) that bring extraordinary capabilities to every data asset. Here's where the magic happens! Every asset gets its own cool and unique [**ERC721 data NFT**](contracts/data-nfts.md#what-is-a-data-nft), along with one (or more) [**ERC20 datatokens**](contracts/datanft-and-datatoken.md). It's like giving your data its very own superhero cape! 🦸‍♂️
+- [Acentrik Market](https://market.acentrik.io/) - Enterprise data market, by Daimler
+- [Ocean Predictoor](https://predictoor.ai) - Token-gated AI prediction feeds
+- [Autobot](https://autobotocean.com/) - Token-gated analytics on [Data Farming](../data-farming/README.md)
+- [Ocean Waves](https://waves.oceanprotocol.com/) - Token-gated music market
+- [Ocean token-gating](https://tokengate.oceanprotocol.com/) - Token-gated [content](https://github.com/oceanprotocol/token-gating-template)
+- [Ocean Market](https://market.oceanprotocol.com) - General data market
 
-These [smart contracts](contracts/README.md) form the backbone of Ocean Protocol, empowering data assets with unparalleled value and enabling seamless integration with the wider blockchain ecosystem. Through the [contracts](contracts/README.md), data becomes not only valuable but also tradable, allowing you to unleash the true potential of your data treasures.
+### How do developers start using Ocean?
 
-<figure><img src="../.gitbook/assets/contracts/smart-contracts.png" alt=""><figcaption><p>Smart Contracts</p></figcaption></figure>
+- Highest-level: **[Use an Ocean Template](https://oceanprotocol.com/templates)**.
+- Library level: **[Use ocean.js](ocean.js/README.md)** is a library built for the key environment of dApp developers: JavaScript. Import it & use it your frontend or NodeJS.
+- Contracts level: **[Call Ocean contracts](contracts.md)** on Eth mainnet [and several other chains](../discover/networks.md).
 
-Now, if you're new to the world of web3 and blockchain technologies, fear not! We've got you covered. Before diving into the depths of Ocean Protocol, we recommend starting with some introductory guides. These [guides](../user-guides/README.md) will gently introduce you to the magical world of [web3](../discover/wallets/README.md) and help you understand the [basics](../discover/wallets-and-ocean.md) before you embark on your epic data-driven adventure.
+### Quick links for developers
+
+- [Architecture](architecture.md) - blockchain & contracts layer, middleware, dapps
+- Earning revenue: [code to collect payment](revenue.md), [fractional](fractional-ownership.md), [community $](community-monetization)
+- Schemas: [Metadata](metadata.md), [identifiers/DIDs](identifiers.md), [identifier objects/DDOs](ddo-specification.md), [storage](storage.md), [fine-grained permissions](fg-permissions.md)
+- Components:
+  - [Barge](barge.md) - local chain for testing
+  - [Ocean subgraph](subgraph.md) - grabbing event data from the chain
+  - [Ocean CLI](ocean-cli.md) - command-line interface
+  - [Compute-to-data](compute-to-data.md) - practical privacy approach
+  - [Aquarius](aquarius.md) - metadata cache
+  - [Provider](provider.md) - handshaking for access control
+- [FAQ](faq.md) 
+
+----
+
+_Next: [Architecture](architecture.md)_

discover/README.md

@@ -4,44 +4,25 @@ cover: ../.gitbook/assets/cover/discover_banner.png
 coverY: 7.413145539906106
 ---
 
-# 🌊 Discover
+# 🌊 Discover Ocean
 
-{% embed url="https://youtu.be/4P72ZelkEpQ" %}
+Ocean's mission is to level the playing field for AI and data.
 
-Society is increasingly reliant on data as AI becomes more popular. However, a small handful of organizations possess and control massive amounts of our personal data, posing a threat to a free and open society ☢️
+How? **By helping _you_ monetize AI models and data, while preserving privacy.**
 
-The concentration of vast datasets in the hands of a few organizations can lead to significant negative consequences for society. These include:
+Ocean is a decentralized data exchange protocol. Its core tech is:
+- Data NFTs & datatokens: an on-ramp and off-ramp for data assets into DeFi. MetaMask is now a data wallet; Gnosis Safe a data DAO.
+- Compute-to-data: buy & sell private data, while preserving privacy
 
-* 📛 **Monopolistic Control**: When a small number of organizations control large amounts of data and AI tools, they gain a significant advantage over competitors. This can lead to monopolistic behavior, where these organizations dominate the market and stifle competition. As a result, innovation may suffer, prices can be inflated, and consumer choice becomes limited.
-* 📛 **Single Point of Failure**: Concentrating data in the hands of a few organizations creates a single point of failure. If a breach or data leak occurs within one of these organizations, the impact can be far-reaching, affecting a significant portion of the population whose data is held by that organization. The potential scale of such breaches can be much larger than if data were distributed across multiple entities, making the consequences more severe.
-* 📛 **Algorithmic Bias and Discrimination**: AI tools rely on data to make decisions and predictions. If the datasets used for training are biased or incomplete, AI systems can perpetuate and amplify existing biases and discrimination. The concentration of datasets in the hands of a few organizations can exacerbate this issue, as their AI models may reflect the biases present in their data, leading to unfair or discriminatory outcomes in various domains, such as hiring, lending, and criminal justice.
-* 📛 **Lack of Transparency and Accountability**: The complex nature of AI algorithms and the concentration of power make it difficult to understand and scrutinize the decisions made by these systems. When only a few organizations control AI tools, it can limit transparency and accountability. This lack of visibility can lead to distrust in AI systems, as people are unable to understand how decisions are being made or to challenge them when they are unfair or erroneous. The desire to extract value from data can create a conflict between the need to protect individual privacy and the pursuit of business interests.
-* 📛 **Lack of Privacy**: In today's digital age, traditional data-sharing methods often compromise privacy, raising concerns among individuals and organizations alike. With the increasing amount of personal and sensitive information being collected, stored, and shared, it has become essential to address it.
-* 📛 **Limited Data Monetization**: Many data owners struggle to monetize their data assets effectively due to various factors. Firstly, they often lack data-driven business models that can translate their data into valuable insights and actionable opportunities. Additionally, data quality and trust play a critical role, as inaccurate or unreliable data hinders the development of data-driven products and erodes trust among potential buyers. Limited market access is another challenge, with the fragmented data economy and the absence of standardized platforms or marketplaces making it difficult for data owners to connect with the right audience.
-* 📛 **Intermediaries and Inefficiencies**: In the current data economy, intermediaries play a significant role in facilitating data transactions between data owners and data consumers. However, the reliance on intermediaries introduces additional costs and complexities that can hinder efficient data monetization.
+**Ocean users are:**
+- **[Developers](../developers/README.md).** Build token-gated AI dApps & REST 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)** 
 
-If we don't enable personal **sovereignty** over our data, then we could be at the mercy of Big Tech's decisions again in the future of Web3. What's worse, we could even be excluded from developing AI innovations entirely. ☢️☠️
+----
 
-{% embed url="https://giphy.com/clips/spongebob-PPEmM68bHy2zEZUcs7" %}
+_Next: [Ocean Why & What](explore.md)_
 
-That's why we made the decision to take action, and it led to the creation of the **Ocean Protocol**.
+_Back: [Docs main](../README.md)_
 
-**Ocean Protocol was founded to level the playing field for AI and data.**
-
-Ocean’s tools enable people to privately & securely publish, exchange, and consume data.
-
-{% hint style="info" %}
-If you're wondering which types of data can be monetized through Ocean Protocol, the answer is that virtually any kind of data can be sold via the platform! 📊🎶📸🎥💼🎫🌐 This includes AI data, ML models, music data, images, videos, trading data, tickets, and essentially anything that can be accessed online.
-{% endhint %}
-
-To find out more about the amazing team behind Ocean, you can visit the [website](https://oceanprotocol.com/about-us/foundation).
-
-Now that we've made you curious about our mission and how we're making a difference in the world, you won't want to miss this video featuring our co-founder, [Trent McConaghy](http://www.trent.st/). He'll share some fascinating insights into what we're doing and why it matters.
-
-{% embed url="https://youtu.be/XN_PHg1K61w" fullWidth="false" %}
-A new data economy with power to the people - Trent McConaghy
-{% endembed %}
-
-### Ocean Protocol Whitepaper
-
-If you'd like to explore the details of the technology, feel free to dive into the [whitepaper](https://oceanprotocol.com/tech-whitepaper.pdf)! It's a comprehensive resource that explains all the technical details and the core concepts that drive Ocean Protocol. It's a great way to get a deeper understanding of what we're all about.

discover/explore.md

@@ -1,155 +1,74 @@
 ---
-description: What is Ocean Protocol?
+description: Ocean Why & What
 ---
 
-# Explore
+**Contents**
 
-Ocean Protocol is a **decentralized data exchange protocol** that aims to unlock the value of data and enable secure and privacy-preserving on-chain data sharing and monetization ⛓️ It provides a framework for building data-centric applications that facilitate the exchange of data assets while ensuring data privacy, security, and compliance.
+- [Why Ocean](#why-ocean)
+- [What's Ocean](#whats-ocean)
+  - Tech core: [Datatokens](#ocean-data-nfts-and-datatokens) and [Compute-to-data](#ocean-compute-to-data)
+  - Community: [Builders & dapp ecosystem](#builders-and-dapps-ecosystem.md), [Ambassadors](#ocean-ambassadors)
 
-Ocean Protocol is used for a variety of purposes, including:
+### Why Ocean
 
-1. **Data Sharing**: Ocean Protocol allows individuals and organizations to share data securely and privately, enabling data owners to monetize their data assets while maintaining control over their data.
-2. **Data Monetization**: Data owners can monetize their data by offering it for sale or by providing data services through compute-to-data (C2D) capabilities. Data consumers can access and utilize data assets.
-3. **Decentralized Data Marketplaces**: Ocean Protocol facilitates the creation of decentralized data marketplaces where data providers can list their data assets and data consumers can discover and access them. These marketplaces operate on a peer-to-peer basis, eliminating the need for intermediaries and providing more efficient and transparent data transactions.
-4. **AI Development**: Ocean Protocol supports the development of AI models by providing access to diverse and high-quality datasets. Data scientists and AI developers can leverage these datasets to train and improve their models, leading to more accurate and robust AI systems.
-5. **Access control:** Ocean Protocol incorporates token-gating mechanisms that grant or restrict access to specific data assets based on predefined criteria, ensuring controlled and regulated data sharing within the ecosystem.
+Ocean was founded to level the playing field for AI and data.
 
-By leveraging **blockchain technology** and **smart contracts**, Ocean Protocol offers **open-source tools** to securely publish [NFTs](../developers/contracts/data-nfts.md) of your data and algorithms to seamlessly collaborate, trade, and innovate with others.
+{% embed url="https://youtu.be/4P72ZelkEpQ" %}
 
-<figure><img src="../.gitbook/assets/general/explore_ocean.png" alt=""><figcaption><p>A vast ocean of data awaits you...</p></figcaption></figure>
+To dive deeper, see [this blog](https://blog.oceanprotocol.com/mission-values-for-ocean-protocol-aba998e95b8) or [this video](https://youtu.be/XN_PHg1K61w).
 
-Get a glimpse into some of the things you can do with Ocean Protocol. The opportunities with the protocol to leverage an "Ocean of data" are great and ever-evolving. Together, we'll dive deeper and uncover even more ways to harness the power of decentralized data.
+### What's Ocean?
 
-<details>
+Ocean is a decentralized data exchange protocol.
 
-<summary><mark style="color:purple;">Build Your dApp</mark><br><br><strong>Building a</strong> <a href="https://oceanprotocol.com/templates"><strong>dApp</strong></a> <strong>using Ocean Protocol can be a great way to bring next generation data sharing tools to your users. By utilizing Ocean's technology stack, you will leverage Web3 technological advantages that distinguish your application from others and can tap into a robust network of Ocean core data engineers/AI scientists supporting dApp developers.</strong></summary>
+The core of Ocean tech is data NFTs & datatokens, and Compute-to-Data. Let's drill into each, including benefits.
 
-When building a dApp on top of Ocean Protocol, you gain access to a wide range of features and functionalities:
+Ocean's also a community of people: builders, data scientists, and more who care deeply about the future of data & AI.
 
-1. **Data access and discovery**: Utilize Ocean's data marketplace infrastructure to access diverse and valuable data sets. Leverage the data discovery mechanisms to help users find relevant data assets for their applications.
-2. **Data interoperability**: Seamlessly integrate and interact with various data sources using Ocean's standardized data representation formats. Ensure compatibility and easy data integration within your dApp.
-3. **Data privacy and security**: Leverage the cryptographic capabilities of Ocean Protocol to ensure privacy and security of sensitive data. Implement access controls, encryption, and secure data-sharing mechanisms within your dApp.
-4. **Provenance and transparency**: Leverage the transparency and immutability of the blockchain to establish data provenance. Build trust among users by providing an auditable record of data sources, usage, and transactions.
-5. **Tokenized incentives**: Utilize datatokens (ERC20) within your dApp to incentivize data providers and consumers. Design token economies that align with the specific requirements of your application, encouraging participation and value creation.
-6. **Community participation**: Leverage the community-driven nature of Ocean Protocol to foster collaboration, feedback, and innovation. Engage with the Ocean community to share ideas, contribute to the ecosystem, and gather insights to enhance your dApp.
+### Ocean data NFTs and datatokens
 
-These are a few examples of what can be built on top of Ocean.
+These enable decentralized access control, via token-gating. Key principles:
 
-1. [Ocean Waves](https://waves.oceanprotocol.com/) - Decentralized music [marketplace](https://github.com/oceanprotocol/waves)
-2. [Ocean Market](https://market.oceanprotocol.com) - Decentralized data [marketplace](https://github.com/oceanprotocol/market)
-3. [Autobot](https://autobotocean.com/) - Tokengated [data farming](https://df.oceandao.org/) intelligence app
-4. [Ocean token-gating](https://tokengate.oceanprotocol.com/) - Tokengated [content](https://github.com/oceanprotocol/token-gating-template)
-5. [Acentrik Market](https://market.acentrik.io/) - Enterprise decentralized data marketplace
+- Publish data services as ERC721 data NFTs and ERC20 datatokens
+- You can access the dataset / data service if you hold 1.0 datatokens
+- Consuming data services = spending datatokens
 
-</details>
+Crypto wallets, exchanges, and DAOs become _data_ wallets, exchanges, and DAOs.
 
-<details>
+<figure><img src="../.gitbook/assets/architecture/onramp-offramp.png" alt=""><figcaption>Data NFTs & datatokens are an on-ramp and off-ramp for data assets into DeFi</figcaption></figure>
 
-<summary><mark style="color:orange;">Build Your Data Marketplace</mark><br><br>With Ocean Protocol, you have the flexibility to create and launch your own data marketplace tailored to your specific requirements. Utilize the protocol's infrastructure and tools to establish a platform where data providers and consumers can connect and transact.</summary>
+Data can be on Azure or AWS, Filecoin or Arweave, REST APIs or smart contract feeds. Data may be raw AI training data, feature vectors, trained models, even AI model predictions, or non-AI data.
 
-You can choose from two options:
+### Ocean Compute-to-Data
 
-1. **Fork the** [**Ocean Marketplace**](https://github.com/oceanprotocol/market) **and customize it**: You have the ability to fork the existing [Ocean Marketplace](https://github.com/oceanprotocol/market) codebase and customize it according to your needs. This allows you to leverage the foundational infrastructure and functionality already built by Ocean Protocol while tailoring the user interface, features, and branding to align with your marketplace vision. Follow this [tutorial](../developers/build-a-marketplace/) to learn how to do it.
-2. **Build your marketplace with Ocean components**: Alternatively, you can build your data marketplace from scratch using Ocean Protocol's modular components. Ocean provides a comprehensive set of building blocks, such as the [**Aquarius**](https://github.com/oceanprotocol/aquarius), [**Provider**](https://github.com/oceanprotocol/provider), Ocean [contracts](https://github.com/oceanprotocol/contracts), and Ocean libraries ([**ocean.js**](https://github.com/oceanprotocol/ocean.js) & [**ocean.py**](https://github.com/oceanprotocol/ocean.py)), which you can integrate into your own marketplace development. This empowers you to create a unique and customized data marketplace experience while leveraging the underlying capabilities and standards provided by Ocean Protocol.
+This enables one buy & sell private data, while preserving privacy
+- Private data is valuable: using it can improve research and business outcomes. But concerns over privacy and control make it hard to access.
+- Compute-to-Data (C2D) grants access run compute against the data, _on the same premises of the data_. Only the results are visible to the consumer. The data never leaves the premises. Decentralized blockchain technology does the handshaking.
+- C2D enables people to sell private data while preserving privacy, as an opportunity for companies to monetize their data assets.
+- C2D can also be used for data sharing in science or technology contexts, with lower liability risk, because the data doesn't move.
 
-</details>
 
-<details>
+<figure><img src="../.gitbook/assets/c2d/c2d-mental-model.png" alt=""><figcaption>Compute-to-Data flow</figcaption></figure>
 
-<summary><mark style="color:blue;"><strong>Tokengate Your dApp or Content</strong></mark><br><br>Are you interested in token gating your dApp or content using an Ocean data NFT? We offer you all the code and support that you need to make this happen.</summary>
 
-Feel free to fork the [Ocean token-gating template](https://github.com/oceanprotocol/token-gating-template) code and customize it to start building your dApp from scratch. If you already have an existing dApp of yours, then you can also modify it simply to use an Ocean data NFT.
-</details>
+### Builders and Dapps Ecosystem
 
-<details>
+Ocean has a lively [ecosystem](https://oceanprotocol.com/explore/ecosystem) of dapps grown over years, from enthusiastic builders.
 
-<summary><mark style="color:green;">Buy or Sell Data</mark><br><br>Users have the possibility to publish, purchase, and sell data within the Ocean ecosystem. Data is tokenized in the form of interoperable <a href="https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md">ERC721</a> data NFTs and <a href="https://github.com/ethereum/EIPs/blob/7f4f0377730f5fc266824084188cc17cf246932e/EIPS/eip-20.md">ERC20</a> datatokens. The platform acts as a decentralized exchange (DEX) specifically designed for data transactions. Every action, including publishing, purchasing, and consuming data, is securely recorded on the blockchain, creating a tamper-proof audit trail.</summary>
+<figure><img src="../.gitbook/assets/general/builders.png" alt=""></figure>
 
-For data scientists and AI practitioners, Ocean presents opportunities such as increased access to a broader range of data, including private data, crypto-secured provenance for data and AI training, and potential income streams from selling and curating data.
+This ecosystem also contains many data scientists and OCEAN holders, all excited about the future of AI & data. You can find them doing predictions, data challenges, Data Farming, and more.
 
-To showcase these capabilities, Ocean developed a demonstrator marketplace known as the [Ocean Market](https://market.oceanprotocol.com/).
+### Ocean Ambassadors
 
-The following guides will help you get started with buying and selling data:
+Ocean has an excellent [community of ambassadors](https://oceanprotocol.com/explore/community). Anyone can join.
 
-* [Publish an NFT](../user-guides/publish-data-nfts.md)
-* [Download an NFT](../user-guides/buy-data-nfts.md)
-* [Host Assets](../user-guides/asset-hosting/README.md)
+<figure><img src="../.gitbook/assets/general/ambassadors.png" alt=""></figure>
 
-</details>
 
-<details>
 
-<summary><mark style="color:blue;">Manage datatokens and data NFTs for use in DeFi</mark><br><br>Ocean makes it easy to publish data services (deploy ERC721 data NFTs and ERC20 datatokens), and to consume data services (spend datatokens). Crypto wallets, exchanges, and DAOs become data wallets, exchanges, and DAOs.</summary>
+----
 
-Use Ocean [JavaScript](../developers/ocean.js/README.md) or [Python](../data-scientists/ocean.py/README.md) drivers to manage data NFTs and datatokens:
+_Next: [What can you do with Ocean?](ocean-101.md)_
 
-Ocean-based apps make data assets on-ramps and off-ramps easy for end users. Ocean smart contracts and libraries make this easy for developers. The data itself does not need to be on-chain, just the access control.
-
-Data NFTs are ERC721 tokens representing the unique asset and datatokens are ERC20 tokens to access data services. Each data service gets its own data NFT and one or more type of datatokens.
-
-To access the dataset, you send 1.0 datatokens to the data provider (running Ocean Provider). To give access to someone else, send them 1.0 datatokens. That's it.
-
-Since datatokens are ERC20, and live on Ethereum mainnet, there's a whole ecosystem to leverage.
-
-* _Publish and access data services:_ downloadable files or compute-to-data. Use Ocean to deploy a new [ERC721](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md) and [ERC20](https://github.com/ethereum/EIPs/blob/7f4f0377730f5fc266824084188cc17cf246932e/EIPS/eip-20.md) datatoken contract for each data service, then mint datatokens.
-* _Transfer datatokens_ to another owner (or approve & transferFrom).
-* _And more._ Use ERC20 support in [web3.js](https://web3js.readthedocs.io/), [web3.py](https://web3py.readthedocs.io/en/stable/examples.html#working-with-an-erc20-token-contract) and Solidity to connect datatokens with crypto wallets and other DeFi services.
-
-</details>
-
-<details>
-
-<summary><a href="https://medium.com/p/477b3decad51#7922"><mark style="color:orange;">Run Your Own Provider</mark></a><br><br>You have the option to generate revenue by running your own <a href="../developers/provider/">provider</a>. It has come to our attention that many of you have not pursued this opportunity, primarily due to the lack of compelling incentives.</summary>
-
-If you're not familiar with it, the Ocean [Provider](../developers/provider/README.md) serves as the proxy service responsible for encrypting/decrypting data and streaming it to the consumer. It also verifies user access privileges for specific data assets or services. It plays a vital role in the Ocean architecture.
-
-Fees are now paid to the individual or organization running the provider when a user downloads a data asset. The download fees are set based on the cost per MB, and there is also a provider fee for compute jobs, which is priced per minute.
-
-Both the download and compute fees can be set to any absolute amount, and you have the flexibility to choose the token in which you want to receive these fees. They do not have to be in the same currency used in the marketplace. For instance, the provider fee could be a fixed rate of 5 USDT per 1000 MB of data downloaded, and this fee will remain fixed in USDT even if the marketplace uses a different currency.
-
-Furthermore, provider fees are not restricted to data consumption; they can also be utilized to charge for compute resources. For example, a provider can charge a fixed fee of 15 DAI to reserve compute resources for one hour. This presents an advantage for both the user and the provider host. Users can now reserve the appropriate amount of computing resources according to their requirements. For provider hosts, this creates an additional income opportunity.
-
-</details>
-
-<details>
-
-<summary><mark style="color:purple;">Earn Rewards</mark><br><br>The <a href="../data-farming/README.md">Data Farming</a> initiative is a key feature of Ocean Protocol that empowers participants to earn <a href="../data-farming/">rewards</a> while contributing to a decentralized data economy. By staking OCEAN and actively participating in data markets, users play a vital role in enhancing the availability and accessibility of valuable data assets</summary>
-
-Through the Data Farming initiative, you are incentivized to lock OCEAN for [veOCEAN](../data-farming/README.md). By staking your tokens, you not only support the growth and sustainability of the ecosystem but also earn a share of the generated incentives💰. The Data Farming initiative offers participants a unique opportunity to earn [rewards](../data-farming/README.md) while making a meaningful impact in the data marketplace.
-
-Participating in the Data Farming initiative demonstrates a commitment to the principles of **fairness**, **transparency**, and **collaboration** that underpin Ocean Protocol. It allows you to actively engage with the ecosystem, promoting innovation, and driving the evolution of the decentralized data economy.
-
-</details>
-
-<details>
-
-<summary><mark style="color:red;">Data Challenges</mark><br><br>Ocean <a href="https://oceanprotocol.com/challenges">Data Challenges</a> offer you a unique opportunity to showcase your skills and creativity in the world of data. These organized events and competitions encourage <a href="../data-scientists/">data scientists</a>, researchers, and developers like yourself to explore and innovate using Ocean Protocol.</summary>
-
-By participating in Ocean Data Challenges, you can tackle real-world problems, leverage data assets, and utilize the technologies within the Ocean ecosystem. Not only do you have the chance to compete for recognition and prizes, but you also contribute to driving innovation, fostering collaboration, and making a positive impact in the data space.
-
-</details>
-
-<details>
-
-<summary><mark style="color:blue;">Become an Ambassador</mark><br><br>Becoming an <a href="https://oceanambassadors.community/">Ocean Ambassador</a> presents a unique opportunity to actively contribute to the growth and adoption of Ocean Protocol while being at the forefront of the decentralized data revolution.</summary>
-
-As an Ocean Ambassador, you become an advocate for the protocol, promoting its vision of democratizing data and empowering individuals. By sharing your knowledge and enthusiasm, you can educate others about the benefits and potential of Ocean Protocol, inspiring them to join the ecosystem. As part of a global community of like-minded individuals, you gain access to exclusive resources, networking opportunities, and collaborations that further enhance your expertise in the data economy. As an Ambassador, you play a vital role in shaping the future of data by driving awareness, fostering innovation, and helping to build a more open and equitable data ecosystem. Of course, the Ocean Protocol Ambassador Program rewards contributors with weekly bounties and discretionary grants for growing the Ocean Protocol communtiy worldwide.
-
-Follow the steps below to become an ambassador:
-
-To become a member of the Ambassador Program, follow these steps: 
-1. Join Ocean Protocol's [Discord](https://discord.com/invite/TnXjkR5) server
-2. Join the Discord channel called #treasure-hunter. 
-3. Access the application form: "[Apply](https://discord.com/channels/612953348487905282/1133478278531911790) to use this channel."
-4. Answer the questions in the application form. 
-5. Once you've completed the application process, you can start earning experience points (XP) by actively engaging in discussions on various topics related to the Ocean Protocol.
-</details>
-
-<details>
-<summary><mark style="color:green;">Contribute to Ocean Code Development</mark><br><br>Make a positive impact in the Web3 data economy by contributing to <a href="https://github.com/oceanprotocol">Ocean's open source code</a> on Github! From feature requests to pull requests, contributions of all kinds are appreciated.</summary>
-
-To begin, [visit the Ocean Github page](https://github.com/oceanprotocol) where you can see the repos and contributors. If you're going to contribute code to a repo, then we ask that you fork the code first, make your changes, and then create a pull request for us to review. If you are reporting an issue, then please first search the existing issues to see if it is documented yet. If not, then please open a new issue by describe your problem as best as possible and include screenshots.
-We also welcome you to join the [Discord developer community](https://discord.gg/TnXjkR5) where you can get rapid, practical advice on using Ocean tech but also get to know Ocean core team more personally!
-</details>
-
-This is just the beginning of what Ocean Protocol has to offer. Join us as we explore, innovate, and push the boundaries of what's possible with decentralized data. Together, we can shape a future where data is accessible, secure and empowers individuals and organizations alike. Let's dive in and discover the endless possibilities of Ocean Protocol :ocean:
+_Back: [Discover Ocean](README.md)_

discover/ocean-101.md

@@ -1,31 +1,120 @@
-# Ocean 101
+---
+description: What can you do with Ocean?
+---
 
-<figure><img src="../.gitbook/assets/gif/giphy.gif" alt=""><figcaption><p>Let's see how it works</p></figcaption></figure>
+**Contents**
 
-## How Does Ocean Work?
+This page shows things you can do with Ocean...
+- [As a builder](#what-builders-can-do)
+- [As a data scientist](#what-data-scientists-can-do)
+- [As an OCEAN holder](#what-ocean-holders-can-do)
+- [Become an Ocean ambassador](#become-an-ocean-ambassador)
 
-Ocean Protocol utilizes a combination of blockchain technology, decentralized networks, and cryptographic techniques to facilitate secure and privacy-preserving data sharing. Here's an overview of how Ocean works:
+### What builders can do
 
-1. **Asset Registration**: Data providers register their data assets on the Ocean blockchain, providing metadata that describes the asset, its usage terms, and pricing information. This metadata is stored on-chain and can be accessed by potential data consumers.
-2. **Discovery and Access Control**: Data consumers can discover available data assets through decentralized metadata services like Aquarius. Access control mechanisms, such as smart contracts, verify the consumer's permissions and handle the transfer of data access tokens.
-3. **Secure Data Exchange**: When a data consumer purchases access to a data asset, the asset's metadata, and access instructions are encrypted by the data provider using the Provider service. The encrypted asset is then securely transferred to the consumer, who can decrypt and utilize it without revealing the asset's URL.
-4. [**Compute-to-Data**](../developers/compute-to-data/README.md) **(C2D)**: Ocean Protocol supports C2D capabilities, allowing data consumers to perform computations on data assets without direct access to the underlying data. The compute operations are executed in a secure and controlled environment, ensuring data privacy and compliance.
-5. **Incentives and Governance**: Ocean Protocol incorporates tokenomics and a governance framework to incentivize participants and ensure the sustainability and evolution of the ecosystem. Participants can earn and stake OCEAN for veOCEAN, curate data, contribute to the network and participate in governance decisions.
+<figure><img src="../.gitbook/assets/general/dapps.png" alt=""></figure>
 
-Ocean Protocol also combines advanced technologies and web components to create a robust and efficient data ecosystem.
+<details>
 
-<figure><img src="../.gitbook/assets/architecture/Ocean101.png" alt=""><figcaption><p>Ocean architectural overview </p></figcaption></figure>
+<summary><mark style="color:purple;">Build Your Token-gated AI dApp</mark></summary>
 
-Powerful libraries such as [Ocean.js](../developers/ocean.js/README.md) (JavaScript) and [Ocean.py](../data-scientists/ocean.py/README.md) (Python) facilitate seamless integration and interaction with the protocol, offering a wide range of functionalities.
+Monetize by making your dApp token-gated. Users no longer have to use credit cards or manage OAuth credentials. Rather, they buy & spend ERC20 datatokens to access your dApp content.
 
-Ocean Protocol incorporates middleware components that enhance efficiency and streamline interactions. Components such as [Aquarius](../developers/aquarius/README.md) act as a metadata cache, improving search efficiency by caching on-chain data into Elasticsearch while [Provider](../developers/provider/README.md) plays a crucial role in various ecosystem operations, assisting in asset downloading, handling encryption of [Decentralized Data Objects](../developers/ddo-specification.md) (DDOs), and facilitating communication with the operator-service for Compute-to-Data jobs. And finally, the [Subgraph](../developers/subgraph/README.md), an off-chain service leveraging GraphQL, offers efficient access to information related to datatokens, users, and balances.
+Go further yet: rather than storing user profile data on your centralized server -- which exposes you to liability --  have it on-chain encrypted by the user's wallet, and just-in-time decrypt for the app.
 
-These libraries and middleware components contribute to efficient data discovery and secure interactions within the Ocean Protocol ecosystem.
+</details>
 
-By leveraging these tools and technologies, developers can harness the power of decentralized data while creating innovative applications and unlocking the true value of data assets.
 
-<figure><img src="../.gitbook/assets/architecture/decentralized_exchanges_marketplaces.png" alt=""><figcaption><p>Build dApps with Ocean</p></figcaption></figure>
+<details>
 
-Ocean Protocol gives people and organizations the power to unleash the true value of their data. With its decentralized marketplaces, rock-solid data-sharing technologies, and privacy protection measures, Ocean Protocol opens the door for collaboration, sparks innovation, and encourages responsible and ethical data usage.
+<summary><mark style="color:purple;">Build Your Token-gated REST API</mark></summary>
 
-It's all about making data work for everyone in a fair and transparent data economy.
+Focus on the backend: make a Web3-native REST API. Like the token-gated dApps, consumers of the REST API buy access with crypto, not credit cards.
+
+</details>
+
+
+<details>
+
+<summary><mark style="color:orange;">Build Your Data Market</mark><br><br></summary>
+
+You have two options:
+
+1. **[Fork Ocean Market**](https://github.com/oceanprotocol/market) **and customize it**: Start with the existing [Ocean Marketplace](https://github.com/oceanprotocol/market) codebase and customize it. This allows you to leverage the foundational infrastructure and functionality already built by Ocean Protocol while tailoring the user interface, features, and branding to align with your marketplace vision. Follow this [tutorial](../developers/build-a-marketplace/) to learn how to do it.
+2. **Build from Ocean components**: In this fashion, you'll be creating a custom data market experience while leveraging the Ocean stack.
+
+</details>
+
+To dive deeper, please go to [Developers page](../developers/README.md).
+
+
+
+### What data scientists can do
+
+<div align="center">
+<figure><img src="../.gitbook/assets/predictoor/predictoor_ui_crop.png"></figure>
+</div>
+
+<details>
+
+<summary><mark style="color:red;">Use Ocean in Python</mark><br><br></summary>
+
+The **[ocean.py](../data-scientists/ocean.py/README.md)** library is built for the key environment of data scientists: Python. Use it to earn $ from your data, share your data, get more data from others, and see provenance of data usage.
+
+</details>
+
+
+<details>
+
+<summary><mark style="color:red;">Do crypto price predictions</mark><br><br></summary>
+
+With [Ocean Predictoor](../predictoor/README.md), you submit predictions for the future price of BTC, ETH etc, and earn. The more accurate your predictions, the more $ you can earn.
+
+</details>
+
+
+<details>
+
+<summary><mark style="color:red;">Compete in a Data Challenge</mark><br><br></summary>
+
+Ocean regularly offer [data science challenges](../data-scientists/join-a-data-challenge) on real-world problems. Showcase your skills, and earn $ prizes.
+
+</details>
+
+To dive deeper, please go to [Data Scientists page](../data-scientists/README.md).
+
+
+### What OCEAN holders can do
+
+<details>
+
+<summary><mark style="color:purple;">Earn Rewards</mark><br><br></summary>
+
+Via [Data Farming](../data-farming/README.md), earn rewards by locking OCEAN & curating data.
+
+</details>
+
+### Become an Ocean Ambassador
+
+
+<details>
+<summary><mark style="color:blue;">Become an Ambassador</mark><br><br></summary>
+
+As an ambassador, you are an advocate for the protocol, promoting its vision and mission. By sharing your knowledge and enthusiasm, you can educate others about the benefits of Ocean Protocol, inspiring them to join the ecosystem. As part of a global community of like-minded individuals, you gain access to exclusive resources, networking opportunities, and collaborations that further enhance your expertise in the data economy. Of course, the Ocean Protocol Ambassador Program rewards contributors with weekly bounties and discretionary grants for growing the Ocean Protocol communtiy worldwide.
+
+Follow the steps below to become an ambassador:
+
+To become a member of the Ambassador Program, follow these steps: 
+1. Join Ocean Protocol's [Discord](https://discord.com/invite/TnXjkR5) server
+2. Join the Discord channel called #treasure-hunter. 
+3. Access the application form: "[Apply](https://discord.com/channels/612953348487905282/1133478278531911790) to use this channel."
+4. Answer the questions in the application form. 
+5. Once you've completed the application process, you can start earning experience points (XP) by actively engaging in discussions on various topics related to the Ocean Protocol.
+</details>
+
+
+----
+
+_Next: If you're a blockchain newcomer, go to [Basic Concepts](basic-concepts.md). Otherwise jump to [Docs main](../README.md) and drill into your interest._
+
+_Back: [Ocean Why & What](explore.md)_