Quick Start - Sequentia Network

⏱️ Time Required

This quick start guide takes approximately 5 minutes to complete and will get you up and running with basic genomic data tokenization on Sequentia Network.

Connect Your Wallet

First, connect your Web3 wallet to authenticate with the Sequentia Network.

JavaScript - Connect Wallet

// Install Web3 library
npm install web3 @sequentia/nbdr-sdk

// Connect to MetaMask or other Web3 wallet
async function connectWallet() {
    if (typeof window.ethereum !== 'undefined') {
        try {
            // Request account access
            const accounts = await window.ethereum.request({
                method: 'eth_requestAccounts'
            });

            // Get the connected account
            const account = accounts[0];
            console.log('Connected:', account);

            // Authenticate with BioWallet
            window.location.href = `https://auth.genobank.app?wallet=${account}`;

        } catch (error) {
            console.error('User denied account access');
        }
    } else {
        console.error('Please install MetaMask');
    }
}

Upload Your Genomic Data

Upload your VCF, 23andMe, or other genomic file formats to create a BioIP Vault.

Upload VCF File

// Upload VCF file for annotation
const formData = new FormData();
formData.append('vcf_file', fileInput.files[0]);
formData.append('user_signature', await getSignature());

const response = await fetch('https://genobank.app/api_vcf_annotator/post_register_user', {
    method: 'POST',
    body: formData
});

const result = await response.json();
console.log('VCF registered:', result.job_id);

Upload 23andMe File

// Upload 23andMe raw data for ancestry analysis
const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('user_signature', await getSignature());

const response = await fetch('https://genobank.app/api_somos_dao/post_register_user', {
    method: 'POST',
    body: formData
});

const result = await response.json();
console.log('23andMe file uploaded:', result.registration_id);

Upload FASTQ for GPU Processing

// Upload FASTQ files for Clara GPU processing
const response = await fetch('https://genobank.app/api_clara/process_s3_sample', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        user_signature: await getSignature(),
        sample_id: 'my-sample-001',
        fastq_r1: 's3://path/to/read1.fastq.gz',
        fastq_r2: 's3://path/to/read2.fastq.gz'
    })
});

const result = await response.json();
console.log('GPU processing started:', result.job_id);

Tokenize Your Data as NFT

Convert your genomic data into a BioIP NFT with automatic licensing terms.

Mint BioIP NFT

// Mint your genomic data as an NFT
async function mintBioIPNFT(jobId) {
    const response = await fetch('https://genobank.app/api_bioip/mint_bioip_to_collection', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json'
        },
        body: JSON.stringify({
            user_signature: await getSignature(),
            job_id: jobId,
            collection_address: '0xC91940118822D247B46d1eBA6B7Ed2A16F3aDC36',
            metadata: {
                name: 'My Genomic Data',
                description: 'Personal whole genome sequence',
                category: 'vcf',
                license_terms: {
                    commercial_use: false,
                    derivatives_allowed: true,
                    attribution_required: true,
                    royalty_percentage: 15
                }
            }
        })
    });

    const result = await response.json();
    console.log('NFT minted:', result.ip_id);
    console.log('View on Story Protocol:', `https://explorer.story.foundation/ipa/${result.ip_id}`);

    return result.ip_id;
}

Configure Access & Licensing

Set PIL (Programmable IP License) terms for your genomic data.

Create PIL License

// Create and attach PIL license terms
async function createLicense(ipId) {
    const response = await fetch('https://genobank.app/create_license', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json'
        },
        body: JSON.stringify({
            user_signature: await getSignature(),
            ip_id: ipId,
            terms: {
                transferable: true,
                royalty_policy: 'LAP',           // License Attached Payments
                minting_fee: '0',
                commercial_use: false,
                commercial_revenue_share: 15,     // 15% royalty to patient
                derivatives_allowed: true,
                derivatives_revenue_share: 10,    // 10% from derivatives
                territories: ['worldwide'],
                attribution: true
            }
        })
    });

    const result = await response.json();
    console.log('License created:', result.license_id);
    return result.license_id;
}

✅ Automatic Royalties

With PIL terms configured, you'll automatically receive 15% royalties whenever your genomic data is used for research, AI training, or drug discovery.

Access & Share Your Data

Use NBDR protocol to access your tokenized genomic data from any service.

Access via NBDR

// Access your genomic data using NBDR protocol
import { NBDRClient } from '@sequentia/nbdr-sdk';

const nbdr = new NBDRClient({
    network: 'mainnet',
    provider: window.ethereum
});

// Access your VCF file
async function accessMyGenomicData(ipId) {
    // Verify ownership
    const hasAccess = await nbdr.verifyOwnership(ipId);

    if (hasAccess) {
        // Get available services
        const services = await nbdr.getAvailableServices(ipId);
        console.log('Available services:', services);
        // Output: ['vcf.genobank.app', 'alphagenome.genobank.app', 'claude.genobank.app']

        // Route to variant annotation
        const annotationResult = await nbdr.routeTo('vcf.genobank.app', {
            action: 'annotate',
            package: 'hereditary_cancer'
        });

        // Route to AI interpretation
        const aiAnalysis = await nbdr.routeTo('claude.genobank.app', {
            action: 'interpret',
            variants: annotationResult.pathogenic_variants
        });

        return {
            annotations: annotationResult,
            interpretation: aiAnalysis
        };
    }
}