Skip to content

Repository files navigation

HashBase

Verifiable AI dataset hub. Upload datasets to Shelby decentralized storage with integrity proofs anchored on the Aptos blockchain.

What it does

  • Upload dataset files to Shelby Protocol storage
  • Register dataset hashes on-chain via Aptos wallet signing
  • Browse and search uploaded datasets
  • Download files directly from Shelby storage nodes
  • Verify dataset integrity against on-chain Merkle roots
  • Dataset versioning with full version history
  • Provenance timeline tracking (registration, storage, updates)

Tech Stack

  • Framework: Nuxt 4 (Vue 3)
  • Styling: Tailwind CSS v4 + shadcn-vue (reka-ui)
  • Storage: Shelby Protocol SDK (@shelby-protocol/sdk)
  • Blockchain: Aptos (@aptos-labs/ts-sdk, @aptos-labs/wallet-adapter-core)

Project Structure

app/
pages/ # Routes (index, datasets, upload, dataset detail)
components/ # Vue components (DatasetCard, UploadForm, etc.)
services/ # Client-side Shelby upload/verify logic
types/ # TypeScript interfaces
composables/ # Wallet composable
server/
api/ # Nitro API routes (datasets, download, verify)
utils/ # Server-side Shelby client + blob-to-dataset mapper
public/ # Static assets (logo)

Setup

cp .env.example .env
# Add your SHELBY_API_KEY
npm install
npm run dev

Runs on http://localhost:3000.

Environment Variables

VariableDescription
SHELBY_API_KEYShelby Protocol API key (get one here)

How it works

  1. User connects Aptos wallet (Petra, etc.)
  2. Selects files and dataset name
  3. Files are uploaded to Shelby storage via batchUpload()
  4. Transaction is signed with wallet, registering blobs on-chain
  5. Server reads blob data from Shelby coordination layer
  6. Anyone can verify by comparing file hashes against on-chain Merkle roots

About

Verifiable AI dataset hub. Upload datasets to Shelby decentralized storage with integrity proofs anchored on the Aptos blockchain.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages