Skip to content

README.md

Latest commit

 

History

History
62 lines (47 loc) · 1.99 KB

README.md

File metadata and controls

62 lines (47 loc) · 1.99 KB

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

Variable Description
SHELBY_API_KEY Shelby 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