Skip to content

Request for Clarification: Aquarius Status and Confusion with get_config_dict and Code Examples #1994

@somykoron-it

Description

@somykoron-it

There is significant developer confusion regarding the current status of the Aquarius metadata cache and the recommended way to interact with Ocean Protocol on remote networks (e.g., Mainnet, Sepolia).

While trying to develop a dApp, I encountered the following issues:

  1. Unresponsive Aquarius URL: The public URL https://v4.aquarius.oceanprotocol.com/ returns an unresponsive error.
  2. Outdated Documentation/Code: The official documentation, specifically the [old infrastructure doc](https://docs.oceanprotocol.com/developers/old-infrastructure), suggests a move away from the "Barge" setup. This is reinforced by a barge commit that removes Aquarius from docker-compose files.
  3. Conflicting Information: Many code examples, such as those in the [ocean.js repo](https://github.com/oceanprotocol/ocean.js/blob/main/CodeExamples.md), still explicitly mention or require Aquarius URLs, creating a conflict.

Problem

When using ocean_lib or ocean.js to connect to a remote network (e.g., Sepolia), the get_config_dict function or similar logic points to an unresponsive local or old Aquarius URL, leading to an Invalid or unresponsive aquarius url error. This happens even for remote networks where a local instance is not required.

Expected Behavior

  • The documentation and code examples should clearly reflect the current best practices for metadata discovery.
  • The libraries should be configured to automatically use the correct subgraph or remote endpoint for a given network without requiring developers to manually provide local Aquarius URLs.
  • If Aquarius is still a required part of the stack, a clear guide on its new URL or configuration method should be available.

Request

Could you please provide:

  1. Clarification on the current status of Aquarius. Is it meant to be run locally, or is it a fully managed service for each network?
  2. Updated code examples for ocean.js and ocean.py that demonstrate how to correctly initialize the libraries for a remote network without relying on get_config_dict or an old, unresponsive Aquarius endpoint.
  3. A reference to the new infrastructure (e.g., the correct subgraph URLs) that should be used for production applications.

Thank you for your help!

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type: BugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions