SynBio IP Registry - Documentation

Getting Started

The SynBio IP Registry enables researchers to tokenize biological intellectual property and automatically manage licensing through Story Protocol's programmable IP licenses (PIL).

Quick Start

Connect Your Wallet: Use MetaMask or WalletConnect to authenticate
Choose BioIP Category: Select between Plasmids, AAV Reports, or Antibodies
Upload Your Data: Submit your biological IP with metadata
Select License Terms: Choose from 4 PIL license types
Tokenize: Mint your BioIP as an NFT on Story Protocol

Supported File Formats

GenBank (.gb, .gbk) - Annotated sequence format
FASTA (.fa, .fasta) - Simple sequence format
SnapGene (.dna) - Commercial plasmid editor format
SBOL (.xml) - Synthetic Biology Open Language

BioIP Categories

1. Plasmids (DNA Blueprints)

Circular DNA molecules used as vectors for genetic engineering. These are the foundational blueprints that can be used to create both AAV vectors and antibodies.

Fingerprint Format: PLS-XXXXXXXXXXXXXXXX
Required Data: DNA sequence, features, resistance markers
Use Cases: Cloning, expression, viral production

2. AAV Reports (Viral Vector Results)

Experimental data from Adeno-Associated Virus vectors used for gene delivery. These are results from using plasmids to create viral vectors.

Fingerprint Format: AAV-XXXXXXXXXXXXXXXX
Required Data: Serotype, tropism, expression pattern, images
Use Cases: Gene therapy, neuroscience tools

3. Antibodies (Protein Detection Tools)

Proteins used for detection and therapeutic applications. Can be produced from expression plasmids.

Fingerprint Format: AB-XXXXXXXXXXXXXXXX
Required Data: Target antigen, validated applications, isotype
Use Cases: Research, diagnostics, therapeutics

Fingerprinting System

Each BioIP receives a unique fingerprint using SHA-256 hashing of its characteristics:

// Plasmid Fingerprint Components
{
    sequence: "SHA256 hash of normalized DNA sequence",
    features: "Sorted list of genetic features with positions",
    resistance_markers: "Antibiotic resistance genes",
    origin_of_replication: "Origin type (e.g., pUC, ColE1)",
    promoters: "List of promoter sequences"
}

// Result: PLS-A7B3C9D2E5F1G8H4
                    

Duplicate Detection

The fingerprinting system automatically detects if identical biological IP has already been registered, preventing duplicate tokenization while allowing legitimate derivatives.

PIL Licensing Terms

Available License Types

🎓 Non-Commercial (Research Only)

Free for academic research
Attribution required
No commercial use permitted
Derivatives must use same license

💼 Commercial Use

For-profit research allowed
10% automatic revenue share
Attribution required
No derivative works

🔄 Commercial Remix

Create and commercialize derivatives
5% revenue share to original creator
Must share improvements
Attribution required

🌍 Open Source

No restrictions on use
Optional attribution
Community driven development
No revenue sharing

API Reference

Base URL

https://genobank.app/api_synbio

Authentication

All API calls require a Web3 signature in the user_signature parameter.

Core Endpoints

POST /register_plasmid

POST /register_aav_report

Submit AAV experimental data

POST /register_antibody

GET /search_plasmids

Search tokenized plasmids by features, organism, or license type

POST /request_license

Request commercial license for a BioIP

GET /royalty_dashboard

View earnings and active licenses

Smart Contracts

Story Protocol Collections

// Plasmid Collection
0x5021F7438ea502b0c346cB59F8E92B749Ecd74B5

// AAV Reports Collection  
0xB8d03f2E1C02e4cC5b5fe1613c575c01BDD12269

// Antibody Collection
0x495B1E8C54b572d78B16982BFb97908823C9358A
                    

License Module

Handles automatic royalty distribution based on PIL terms:

Non-Commercial: 0% royalty
Commercial Use: 10% royalty
Commercial Remix: 5% royalty
Open Source: 0% royalty

Foundry Integration

The Foundry module connects Adaptyv Bio protein engineering experiments to Sequentia blockchain, enabling on-chain ownership and licensing of protein IP.

Architecture: Experiment to BioIP

Adaptyv experiment {id}
  → donor_ref = "adaptyv-{id}"
  → Custodial biowallet (EIP-55, Fernet-encrypted key)
  → BioIP asset minted on Sequentia (chain 15132025)
  → Sequences registered as child BioCIDs
  → Results registered as child BioCIDs
  → BioPIL license (1-9) attached

Sequentia Contracts

BioIPRegistry — ERC-721 minting for experiment BioIP assets
BioCIDRegistry — File fingerprint registration for sequences and results
BioPIL (0xDae899b64282370001E3f820304213eDf2D983DE) — 9 license types
Chain ID: 15132025 | RPC: seqrpc.genobank.app

BioPIL License Types

ID	Label	Use Case
1	Non-Commercial	Academic research only
2	Commercial	Revenue-sharing enabled
3	Exclusive	Single licensee
4	Public Good	Open access
5	GDPR Research	Revocable, EU-compliant
6	AI Training	Machine learning model training
7	Clinical Use	Therapeutic applications
8	Pharma Research	Drug development pipelines
9	Family Inheritance	Genetic lineage rights

Foundry API Endpoints

POST /api_synbio/foundry_create_experiment
  Body: { user_signature, adaptyv_experiment_id, experiment_type, target_name, name }
  Returns: { experiment_id, wallet_address, bioip_id, tx_hash }

POST /api_synbio/foundry_add_sequences
  Body: { user_signature, experiment_id, sequences: "[{name, chain_type, sequence}]" }
  Returns: { sequences_registered, biocids: [{sequence_name, biocid, fingerprint, tx_hash}] }

POST /api_synbio/foundry_submit_experiment
  Body: { user_signature, experiment_id }
  Returns: { status: "waiting_for_confirmation" }

GET  /api_synbio/foundry_experiment_status
  Params: experiment_id | adaptyv_experiment_id
  Returns: { status, wallet_address, bioip_id, sequences, results_biocid, license_type }

POST /api_synbio/foundry_import_results
  Body: { user_signature, experiment_id, results: "{...}" }
  Returns: { results_biocid, fingerprint, tx_hash }

POST /api_synbio/foundry_attach_license
  Body: { user_signature, experiment_id, license_type: 1-9 }
  Returns: { license_label, tx_hash, biopil_contract }

GET  /api_synbio/foundry_my_experiments
  Params: user_signature
  Returns: { experiments: [...] }

GET  /api_synbio/foundry_experiment_bioip
  Params: experiment_id
  Returns: { wallet, bioip, biocids, license, network }
                    

Example Flow

// 1. Create experiment (mints biowallet + BioIP)
POST /api_synbio/foundry_create_experiment
{ "user_signature": "0x...", "adaptyv_experiment_id": "exp-abc123", "experiment_type": "affinity", "target_name": "HER2" }
→ { "wallet_address": "0x7A3b...", "bioip_id": "0xfa29...", "tx_hash": "0x..." }

// 2. Register sequences as BioCIDs
POST /api_synbio/foundry_add_sequences
{ "user_signature": "0x...", "experiment_id": "uuid", "sequences": "[{\"name\":\"heavy\",\"chain_type\":\"heavy\",\"sequence\":\"EVQLVES...\"}]" }
→ { "biocids": [{ "biocid": "biocid://v1/sequentia/SYNBIO/...", "fingerprint": "a3f2..." }] }

// 3. Attach AI-training license
POST /api_synbio/foundry_attach_license
{ "user_signature": "0x...", "experiment_id": "uuid", "license_type": 6 }
→ { "license_label": "ai-training", "biopil_contract": "0xDae899b..." }
                    

Best Practices

Before Tokenizing

✅ Verify you have rights to the biological IP
✅ Check for existing patents using USPTO search
✅ Ensure sequences don't contain hazardous elements
✅ Include complete metadata for discoverability
✅ Choose appropriate license terms for your goals

Safety Considerations

Follow NIH Guidelines for Research Involving Recombinant DNA
Declare biosafety level (BSL-1, BSL-2, etc.)
List all resistance markers and selection systems
Note any toxic gene products or oncogenes

Collaboration Tips

Use descriptive names and comprehensive descriptions
Tag relevant organisms and applications
Link to publications or protocols when available
Consider Commercial Remix license for maximum collaboration

🧬 SynBio IP Registry Documentation