Skip to content

Use Case Publication Guide

This section guides data and software providers in the Pontus‑X ecosystem in the publication of their use cases on the Pontus‑X Devnet and Testnet.

Prerequisites

As an onboarded participant in the Pontus‑X ecosystem, ensure you have the required Network and Payment tokens to interact with the Pontus‑X Testnet/Devnet. If you need tokens or have not received them, please use the faucet.

Publication Process

Publishing your use cases to the Pontus‑X Testnet/Devnet can be achieved through two primary methods. You can either use the Pontus‑X portal, accessible at portal.pontus‑x.eu (as well as other Pontus‑X portals), or utilize Nautilus, our comprehensive TypeScript data economy toolkit. In the following sections, we will guide you through each method in detail.

Publication Process: Using the Pontus‑X Portal

1. Connect to Your Wallet

Connect to the portal using either your onboarded wallet via MetaMask (+ optional an Automation Wallet). We recommend using the Automation Wallet additionally as it eliminates the need for manual transaction signing during the publication process. In case you do not have an Automation Wallet, you can create one with your private key here.

Note: Currently, you must still connect with a MetaMask wallet to access the portals, even if you have an Automation Wallet.

Portal Wallet Connect

2. Connect to the Pontus‑X Testnet

Hover over your displayed wallet address, click "Add Pontus‑X Testnet," and confirm both MetaMask transactions.

Portal Network Connect

3. Start Publishing Process for Service Asset

  1. Click "Publish"
  2. Fill out the metadata:
    • Asset Type: Select "Dataset" or "Algorithm."
    • Title: Enter at least 4 characters.
    • Description: Enter at least 10 characters.
    • (Optional) Upload a Gaia‑X service credential and define tags.
    • (If algorithm): Define Docker Image
  3. Agree to the Terms and Conditions.
  4. Click "Continue"

Start Publishing Process

4. Define Access Information

  1. Choose access type: "Download" or "Compute."
  2. Select provider URL (relevant if your own provider is set up). deltaDAO provider is added by default.
  3. Provide file information and click "Submit."
    • Note: Only access information is provided; files are never transferred to Pontus‑X. More information about supported data sources can be found here.
  4. (Optional) Provide a sample file and click "Validate."
  5. Choose a timeout period, defining how long buyers can download the asset after the initial purchase.
  6. (Optional) Provide user-defined parameters, allowlist and/or denylist participants (otherwise, all onboarded participants listed here will have access). Provide a license and add a link to asset-specific Terms and Conditions.
  7. Click "Continue"

Portal Define Access Information

5. Define Pricing Information

  1. Define a price in EURO or select "Free" if the asset should be free of charge.
  2. Click "Continue."
Notes:
  • Since the Pontus‑X Testnet is a staging environment, no real monetary transactions occur. Only test tokens are exchanged.

6. Finalize Submission

  1. Click "Submit."
  2. If using MetaMask for transaction signing, confirm the transaction requests.

7. Compute‑to‑Data Use Cases

Repeat the process for the algorithm asset to be allowlisted for computation on the data source of the previously published data asset.

8. Compute‑to‑Data Use Cases: Allowlist Algorithm Asset

  1. Click "Catalogue" and select the previously published data asset. Portal Catalogue

  2. Click "Edit Asset." Portal Catalogue

  3. Click "Edit Compute Settings" and set the previously published algorithm asset for allowlisting. Portal Catalogue

  4. Click "Submit"

Publication Process: Using Nautilus

Overview of Nautilus

Nautilus is a developer-focused TypeScript library designed to simplify and streamline the development experience within OceanEnterprise ecosystems. It addresses common pain points such as configuring metadata, defining pricing schemes, and managing access controls, which can often be time-consuming and error-prone.

Key Features:
  • Builder Pattern: Simplifies configuration of data economy assets and services, enhancing readability, maintainability, and flexibility.
  • Feature Complete: Manages data assets and services, supports publish and edit functionalities, and leverages OceanEnterprise's Compute-to-Data capabilities.
  • Seamless Compute Jobs: Start, monitor, and retrieve compute job results within your development environment.

For a detailed guide on the publishing process, refer to the publishing section of the Nautilus Documentation.

Notes:
  • To install Nautilus, refer to our GitHub repository.
  • For quick coding examples, check out the nautilus-examples repository.
  • After installation, update the .env file with the NETWORK configuration for Pontus‑X Testnet (pontusxtestnet) and the PRIVATE_KEY of your onboarded wallet.