PharmaServes

Decentralized hot storage for African genomic data — built on Shelby Protocol testnet

What is PharmaServes?

African genomes are the most genetically diverse and least studied in the world. Researchers working on sickle cell disease, malaria, and other conditions that disproportionately affect African populations are bottlenecked by inaccessible, expensive, and slow genomic data infrastructure.

PharmaServes is an open-source infrastructure layer that enables African biobanks, research institutions, and pharmaceutical researchers to store, stream, and monetize genomic datasets on the Shelby decentralized hot storage network — at sub-second read speeds, with micropayment-per-read economics and encrypted access control.

Demo

Full end-to-end demo — upload → registry → range request → access grant → stream:

npx tsx src/scripts/demo.ts

Architecture

[ African Genomic Data Repository ]  ← VCF, FASTQ, SAM stored on Shelby testnet
           ↓
[ DRM Access Control Layer ]         ← encrypted time-limited access grants
           ↓
[ Biobank Marketplace ]              ← micropayment-per-read economics
           ↓
[ pharmaserves-sdk ]                 ← TypeScript SDK for developers
           ↓
[ Research Pipeline Connectors ]     ← stream directly into AlphaFold, AutoDock Vina

Why Shelby?

Filecoin and Arweave are cold storage — unsuitable for AI drug discovery pipelines that need millisecond reads. Shelby's erasure-coded architecture (Clay codes, 16 chunks per dataset), dedicated fiber backbone, read-incentivized nodes, and programmable access control are the exact primitives PharmaServes is built around.

Installation

npm install pharmaserves-sdk

Quick Start

import { PharmaServesClient, AccessController } from "pharmaserves-sdk";

// Initialize client
const client = new PharmaServesClient({
  apiKey: "your_shelby_api_key",
  privateKey: "your_aptos_private_key",
  network: "testnet",
});

// Upload a genomic dataset
await client.upload(vcfBuffer, "datasets/african-reference/sample.vcf", 7);

// View dataset registry
const datasets = await client.registry();

// Stream a specific byte range (e.g. chromosome 11 region)
const region = await client.streamToBuffer("datasets/african-reference/sample.vcf", {
  start: 0,
  end: 1000,
});

// Grant a researcher time-limited access
const provider = new AccessController();
const grant = provider.grantAccess(blobName, researcherPublicKey, 24);

// Researcher decrypts grant and streams data
const researcher = new AccessController();
const blobName = researcher.decryptGrant(grant, provider.getPublicKey(), researcher.getSecretKey());
const data = await client.streamToBuffer(blobName);

Supported Genomic Formats

Format	Description	Use Case
VCF	Variant Call Format	Genomic variant data, SNP analysis
FASTQ	Raw sequencing reads	Next-generation sequencing output
SAM/BAM	Sequence Alignment Map	Read alignment to reference genome
FASTA	Reference sequences	Genome assembly, gene sequences

Key Features

Decentralized Storage Genomic datasets are erasure coded using Clay codes across 16 storage nodes on Shelby testnet. 10 data chunks + 6 parity chunks — zero data loss even if nodes go offline.

Range Requests Stream only the genomic region you need. A researcher studying the HBB gene doesn't need to download a 40GB whole genome file — they request bytes 5,000,000–6,000,000 and pay only for what they read.

Encrypted Access Control Data providers issue time-limited, encrypted access grants to researchers. Grants auto-expire. Every access is auditable. No lawyers, no data brokers — just cryptography.

Micropayment Economics African biobanks earn in real time, every time their data is accessed. Built on Shelby's native micropayment channel infrastructure.

Scripts

# Fund account with APT
npx tsx src/scripts/fund.ts

# Fund account with ShelbyUSD
npx tsx src/scripts/fund-usd.ts

# Upload VCF, FASTQ, SAM formats
npx tsx src/scripts/upload-formats.ts

# View dataset registry
npx tsx src/scripts/registry.ts

# Stream a specific byte range
npx tsx src/scripts/range-download.ts

# Test access control flow
npx tsx src/scripts/test-access.ts

# Full end-to-end demo
npx tsx src/scripts/demo.ts

Network

Running on Shelby testnet.

Component	URL
Shelby RPC	https://api.testnet.shelby.xyz/shelby
Aptos Full Node	https://api.testnet.aptoslabs.com/v1
Smart Contract	0xc63d6a5efb0080a6029403131715bd4971e1149f7cc099aac69bb0069b3ddbf5

Roadmap

• Shelby client on testnet
• Account funding (APT + ShelbyUSD)
• VCF, FASTQ, SAM uploads — all isWritten: true
• Range requests — stream specific byte regions
• Dataset registry — human-readable metadata
• pharmaserves-sdk — published on npm
• Access control — encrypted grants + expiry enforcement
• End-to-end demo script
• Aptos Move smart contract — on-chain access control
• Biobank marketplace UI
• AlphaFold pipeline connector

Built With

• Shelby Protocol — Decentralized hot storage
• Aptos — Blockchain coordination layer
• tweetnacl — Cryptographic access control
• TypeScript

License

MIT