Lab402+ Documentation

Introduction

Lab402+ is a decentralized protocol enabling programmatic access to laboratory instruments and compute resources through HTTP 402 micropayments. The protocol combines instrument usage, computational power, and AI interpretation into a unified payment workflow on the Solana blockchain.

Installation

Install the Lab402+ SDK using your preferred package manager:

NPM

npm install @lab402/sdk

Yarn

yarn add @lab402/sdk

Quick Start

Get started with Lab402+ in just a few lines of code:

const { Lab402 } = require('@lab402/sdk');

// Initialize client
const lab = new Lab402({
  network: 'mainnet',
  wallet: yourKeypair
});

// Request analysis
const result = await lab.analyze({
  instrument: 'dna-sequencer',
  sample: sampleData,
  aiModel: 'genomics-llm-70b',
  computeTier: 'performance'
});

console.log(result.analysisId); // 0x7f3a...

HTTP 402 Protocol

The HTTP 402 Payment Required status code creates a unified micropayment workflow. When you submit an analysis request, the server returns a 402 response with a Solana payment invoice containing:

Once payment is confirmed on the Solana blockchain, the lab begins processing your sample with real-time status updates via WebSocket events.

Laboratory Instruments

Lab402+ provides access to 6 high-precision laboratory instruments with tiered clearance levels:

AI Models

Choose from 7 specialized AI models for automated interpretation of your results:

Compute Tiers

Select the appropriate compute tier based on your performance requirements:

Example: Basic Analysis

Complete example showing how to submit and monitor an analysis request:

const { Lab402 } = require('@lab402/sdk');
const { Keypair } = require('@solana/web3.js');

async function runAnalysis() {
  // Load wallet keypair
  const keypair = Keypair.fromSecretKey(
    Buffer.from(process.env.WALLET_SECRET, 'base64')
  );
  
  // Initialize Lab402 client
  const lab = new Lab402({
    network: 'mainnet',
    wallet: keypair
  });
  
  // Submit analysis request
  const result = await lab.analyze({
    instrument: 'spectroscopy',
    sample: {
      type: 'protein',
      data: sampleData
    },
    aiModel: 'bio-gpt-7b',
    computeTier: 'standard'
  });
  
  console.log('Analysis ID:', result.analysisId);
  console.log('Payment TX:', result.paymentTx);
  console.log('Status:', result.status);
}

runAnalysis().catch(console.error);

Example: Batch Processing

Process multiple samples with volume discounts (up to 30% off):

const batch = await lab.batch({
  samples: [sample1, sample2, sample3],
  instrument: 'mass-spectrometry',
  aiModel: 'chem-bert-base',
  options: {
    parallel: true,
    onProgress: (completed, total) => {
      console.log(`Progress: ${completed}/${total}`);
    }
  }
});

console.log('Batch ID:', batch.batchId);
console.log('Discount:', batch.discount);