Skip to main content

​
Quick Start Guide

This guide will help you get started with the AgrospAI Data Space Portal. You’ll learn how to connect your wallet, browse available datasets, and make your first data transaction.

​
Prerequisites

Before you begin, make sure you have:
1

Install a Web3 Wallet

Install MetaMask, WalletConnect, or another compatible Ethereum wallet.
2

Get Test Tokens

For testing on Pontus-X DevNet, you’ll need test tokens. Use the faucet to get free test tokens.
3

Add Pontus-X Network

Add the Pontus-X network to your wallet. See the Network Setup guide for details.

​
Step 1: Connect Your Wallet

Visit portal.agrospai.udl.cat and connect your wallet.
1

Click Connect Wallet

Click the Connect Wallet button in the top right corner of the page.
2

Select Your Wallet

Choose your wallet provider from the ConnectKit modal:
  • MetaMask
  • WalletConnect
  • Coinbase Wallet
  • Trust Wallet
  • Other supported wallets
3

Approve Connection

Approve the connection request in your wallet. The portal will never ask for your private keys or seed phrase.
4

Select Network

If prompted, switch to the Pontus-X network. The portal supports:
  • Pontus-X DevNet (Chain ID: 32456) - For testing
  • Pontus-X TestNet (Chain ID: 32457) - For testing
Your wallet address will appear in the top right corner once connected. You can click it to view your profile and transaction history.

​
Step 2: Browse the Marketplace

Explore available datasets and algorithms in the marketplace.

​
Search and Filter

Use the search bar to find specific datasets: 
Search examples:
- "agriculture crop yield"
- "weather data"
- "soil quality sensors"
Apply filters to narrow your search:
  • Asset Type: Dataset or Algorithm
  • Pricing: Fixed price or Free
  • Network: Pontus-X DevNet or TestNet
  • Service Type: Download or Compute
The homepage displays curated sections:
  • Featured Assets - Highlighted by the community
  • Recent Assets - Newly published datasets
  • Top Sales - Most popular assets
  • Bookmarked Assets - Your saved favorites (click the bookmark icon)
Click the bookmark icon on any asset to save it for later. Access your bookmarks from the main menu.

​
Step 3: Access a Dataset

Once you find a dataset you want to access:
1

View Asset Details

Click on an asset to view its details page. Review:
  • Description and metadata
  • Pricing information
  • File size and format
  • Publisher information
  • Sample data (if available)
2

Check Pricing

View the pricing model:
  • Fixed Price: Pay once to download
  • Free: No cost, gas fees only
The price is displayed in the datatoken price plus any marketplace fees. You’ll see the total cost before confirming.
3

Purchase Access

Click Buy Now or Get Free Asset to access the dataset.The portal will:
  1. Calculate the total price (datatoken + fees)
  2. Request token approval (if needed)
  3. Execute the purchase transaction
  4. Grant you access to download
4

Download the Dataset

After the transaction confirms, click Download to get your dataset files.
Downloads are tracked on-chain. You can re-download assets you’ve purchased at any time from your profile page.

​
Step 4: Publish Your First Dataset (Optional)

Share your own datasets with the community:
1

Navigate to Publish

Click Publish in the main menu to start the publishing workflow.
2

Enter Metadata

Provide information about your dataset:
  • Name and description
  • Author and organization
  • Tags and categories
  • File(s) to publish
3

Configure Access

Choose how users can access your data:
  • Download: Users download files directly
  • Compute-to-Data: Users run algorithms without downloading
If your dataset contains personal data, you must use Compute-to-Data and enable GDPR compliance features.
4

Set Pricing

Configure your pricing model:
  • Fixed Price: Set a specific price in tokens
  • Free: Make it freely accessible
You can also configure marketplace fees (percentage of each sale).
5

Publish to Blockchain

Review your settings and click Publish. This will:
  1. Create an NFT representing your dataset
  2. Mint datatokens for access control
  3. Store metadata on IPFS
  4. Register your asset on-chain
Publishing requires three blockchain transactions: NFT creation, datatoken creation, and metadata registration. Each requires wallet approval.
For detailed publishing instructions, see the Publishing Assets Guide.

​
Step 5: Run a Compute Job (Advanced)

Use Compute-to-Data to analyze private datasets:
1

Find a Compute Dataset

Look for datasets with the Compute service type. These allow algorithms to run on the data without exposing the raw files.
2

Select an Algorithm

Choose an algorithm from the marketplace or publish your own. Algorithms must be Docker containers compatible with the Compute-to-Data environment.
3

Configure the Job

Set compute job parameters:
  • Select dataset(s)
  • Choose algorithm
  • Set custom parameters (if supported)
  • Select compute environment
4

Start the Job

Click Start Compute Job and approve the transactions. The compute job will run on the data provider’s infrastructure.
5

Monitor and Download Results

Track your job status from your profile page. Once complete, download the results (logs and output files).
For detailed Compute-to-Data instructions, see the Compute Jobs Guide.

​
Common Tasks

Add Funds

Get test tokens from the faucet or bridge assets to Pontus-X

View Your Assets

Access your purchased datasets and published assets

Enable Automation

Set up automated testing with the automation wallet feature

Verify Credentials

Create and verify Gaia-X compliant credentials

​
Troubleshooting

Solutions:
  • Make sure your wallet extension is unlocked
  • Refresh the page and try again
  • Check that you’re using a supported wallet
  • Clear browser cache and cookies
Common causes:
  • Insufficient balance for gas fees
  • Network congestion (try increasing gas price)
  • Rejected by user
  • Smart contract error (check error message)
View transaction details on the block explorer for more information.
Solutions:
  • Verify you’ve completed the purchase transaction
  • Check that the data provider is online
  • Try downloading from your profile page
  • Contact the dataset publisher if issue persists

​
Next Steps

Now that you’re familiar with the basics:

Learn Architecture

Understand how the portal works under the hood

Core Features

Explore advanced marketplace features

API Reference

Integrate the portal into your applications
Need help? Check out our troubleshooting guides or contact support via GitHub Issues.

Build docs developers (and LLMs) love

Get started for freeTalk to us