GenoBank.io

DNA Collection Kit URL Creation and Activation Process

Overview

This document describes the complete flow for DNA collection kit URL generation, user activation, and BioNFT™ creation in the GenoBank.io platform.

1. DNA Kit URL Creation Process

1.1 Laboratory Prerequisites

Interface Location

Required Fields

  1. Prefix (Dropdown)
    • Range: 100-600
    • Purpose: Identifies the biosample manufacturer
    • Example: “100” for standard GenoBank kits
  2. Biosample ID (Number Input)
    • Range: 0 to 281,474,976,710,655 (2^48-1)
    • Purpose: Unique identifier for each DNA collection kit
    • Example: “12345”
  3. Purchase Hash Code (Text Input)
    • Purpose: Security code associated with the kit package
    • Example: “abc123def456”
POST /create_magic_link
{
  "prefix": "100",
  "biosampleId": "12345",
  "physicalId": "10012345",  // Concatenation of prefix + biosampleId
  "packageHashCode": "abc123def456",
  "domain": "https://genobank.io"
}

Generated URL Structure

https://genobank.io/activate/?biosampleId=12345&laboratoryId=2&secret=67d6516e1229eee318e5032776377b639f1c2ee2fe93531164bf5706d56fdcf1#1940837240937409237

URL Components:

1.3 QR Code Generation

2. DNA Kit Activation Flow

2.1 Initial Landing Page

URL: User scans QR code or visits the activation URL

First Screen: Welcome page with:

2.2 Terms & Conditions Consent

Required User Information:

  1. Full Name
  2. Sex (Female/Male dropdown)
  3. Digital Signature (drawn on canvas)
  4. Date of Birth
  5. Sample Collection Date (auto-populated with current date)
  6. Consent Checkbox for GDPR compliance

Consent Text Includes:

2.3 Wallet Selection Options

Three Authentication Methods:

Option 1: Login with Existing Wallet

Option 2: Create New Passphrase

  1. Preparation Screen: Warning to find ID card and not screenshot
  2. 12-Word Mnemonic Display:
    • Random BIP39 mnemonic generation
    • Strong warning against screenshots
    • User must write down words
  3. Passphrase Verification:
    • Words shown scrambled
    • User must drag words to correct order
    • Validates understanding and backup

Option 3: Import Existing Wallet

2.4 Blockchain Transaction

Token ID Construction:

const biosampleIdHex = ethers.utils.hexZeroPad(ethers.utils.hexlify(biosampleId), 4).substr(2);
const permitteeIdHex = ethers.utils.hexZeroPad(ethers.utils.hexlify(permiteeId), 4).substr(2);
const tokenID = `0x${biosampleIdHex}${permitteeIdHex}${account.substr(2)}`;

Claim API Call:

POST /claim/{tokenID}
{
  "biosampleSecret": "1940837240937409237",  // From URL hash
  "signature": "0x...",                       // Wallet signature of "I want to proceed"
  "seed": "0x...",                           // Wallet seed/address
  "signatureKind": "metamask",               // or "magic" for Google OAuth
  "sex": "Female"                            // From consent form
}

2.5 Transaction Finalization

3. BioNFT™ Creation Process

3.1 BioNFT™ Structure

Token ID Components:

  1. Biosample ID (4 bytes): Unique kit identifier
  2. Permittee ID (4 bytes): Laboratory identifier
  3. User Address (20 bytes): Wallet address of kit activator

Example Token ID:

0x0000303900000002742d35cc6634c0532925a3b844bc9e7595f7f2e1
  └─────┘└─────┘└──────────────────────────────────┘
     |      |                    |
Biosample  Lab ID          User Address
  12345      2

3.2 Smart Contract Interaction

Networks Supported:

BioNFT™ Properties:

  1. Ownership: User’s wallet address
  2. Permittee: Laboratory with access rights
  3. Metadata:
    • Biosample physical ID
    • Activation timestamp
    • Consent hash
    • Gender/sex information
  4. Revocability: User can revoke via BioWallet

3.3 Post-Activation State

For Users:

For Laboratories:

3.4 Data Flow After Activation

User Activates Kit → BioNFT™ Minted → User Dashboard Access
                           ↓
                  Laboratory Dashboard
                           ↓
                  Sample Processing
                           ↓
                  Results Upload
                           ↓
                  User Notification

4. Security Considerations

4.1 URL Security

4.2 Wallet Security

5. Error Handling

5.1 Common Errors

5.2 User Support

6. Technical Implementation Details

6.1 Frontend Technologies

6.2 Backend Endpoints

6.3 Blockchain Contracts

Conclusion

The DNA kit activation process seamlessly bridges physical sample collection with blockchain-based consent management, ensuring user sovereignty over genomic data while enabling laboratories to process samples with verified, GDPR-compliant consent. The resulting BioNFT™ serves as an immutable record of consent and ownership, facilitating secure data sharing in the genomic ecosystem.