Mainnet · status nominal6 reports anchoredApr 30 2026 · 13:48 UTCDocs
eluent.bio · /docs

Documentation

Eluent is a peptide-identity verification layer with a tamper-evident on-chain receipt. This page is the single reference for how the lookup pipeline works, what the confidence grades mean, how chain attestations are constructed, and what data ever leaves your device. Research-only. No medical claims.

§ 01

What Eluent is

Eluent takes a single-letter amino acid sequence and returns:

  • Identity — what the peptide is, with a confidence grade and citations.
  • Structure — a 3D model from AlphaFold, ESMFold, or PEP-FOLD4 routed by sequence length.
  • Mechanism — primary targets, mechanism summary, links to GtoPdb / ChEMBL / OpenTargets.
  • Vendor matches — when our nightly scrapers find this exact sequence on a Tier-1 vendor with a recent COA, the row appears in your dossier.
  • On-chain receipt — every lookup is anchored to Solana mainnet via the Memo program with a commit/reveal scheme. Verifiable by anyone, post-hoc.

The free tier uses a single Eluent paymaster account to sponsor the chain writes. You never need a wallet to use the lookup — connecting one only unlocks tier-gated features.

§ 02

Lookup pipeline

Lookup runs as five sequential stages. Cache hits short-circuit later stages. SHA-256 of the canonicalized sequence is the cache key — same sequence always returns the same dossier.

  1. 01CanonicalizeParse FASTA / raw / URL · normalize · compute SHA-256 · check cache
  2. 02IdentityUniProt Peptide Search exact (≥7aa) → BLAST homolog (e-val ≤ 1e-10) → grade
  3. 03StructureAlphaFold DB v6 / ESMFold / PEP-FOLD4 routed by length + UniProt match
  4. 04MechanismChEMBL + GtoPdb + OpenTargets join · LLM synthesis · cite-or-omit
  5. 05On-chainCommit memo before bio APIs · reveal memo with result CID after upload
Identity card streams to the browser at p50 1.4s. Structure + mechanism follow at p95 4.8s. Sequence-length routing for structure: <40aa → PEP-FOLD4, 40–400aa with UniProt hit → AlphaFold DB v6, 40–400aa without UniProt hit → ESMFold, >400aa → AlphaFold DB only.
§ 03

Confidence grading

Every dossier carries one of five letter grades — A, B, C, D, or X. Same scale on the result page, the OG share image, and the embed badge. The grade encodes how much the sequence is trusted, not whether the peptide is good or bad.

Full rubric: /docs/grading.

AExact match · seed table or UniProt Peptide Search ≥99%
BClose homolog · BLAST ≥90% identity
CDistant homolog · BLAST ≥70% identity
DNo reliable hit · novel sequence
XInvalid input · failed canonicalization
§ 04

On-chain protocol

Each lookup produces two transactions on Solana mainnet-beta — a commit before the bio APIs run, then a reveal after the dossier is uploaded to permanent storage. The commit is a blinded hash; the reveal carries the salt and the result CID. Anyone can later verify the binding without needing Eluent's cooperation.

// COMMIT memo (lands at confirmed, ~400ms)
eluent:commit:v1:<sha256(sequence||salt||requested_at)>:<requested_at>

// REVEAL memo (lands after dossier upload)
eluent:reveal:v1:<commitTxSig>:<salt_hex>:<result_cid>:<result_hash>

Cost: ~$0.0015 per lookup (commit + reveal Memo writes). Free-tier writes are sponsored by the Eluent paymaster account; connected-wallet writes can be self-paid for users who prefer full self-custody.

§ 05

Wallet auth

Eluent uses Sign-In with Solana (SIWS) — connect Phantom, Solflare, or Backpack via the Wallet Standard, sign one nonce, receive a JWT scoped to your pubkey. No password. No email.

The wallet button is in the top-right nav. Free anonymous use (no wallet) gives 5 lookups per IP per 30 days; signing in lifts that to a higher per-wallet cap and unlocks the saved-receipts history at /me.

§ 06

Tier system

Pro features unlock based on your $ELUENT balance — the contract address ships when the token launches. Until then, all wallets resolve to the free tier.

TierBalanceLookupsFeatures
free0 ELUENT5 / 30dLookup · /me history
Tier 1≥ 1,000,000 ELUENT25 / 30d+ DNA Match · Stack Mode
Tier 2≥ 4,000,000 ELUENT100 / 30d+ priority queue · share-lock
Unlimited≥ 8,000,000 ELUENT+ private dossiers · early access
Dormant until $ELUENT mint published · all wallets resolve free
Token gating is dormant by default — no contract address means no on-chain balance check, no error. Tiers go live the moment the token CA + thresholds are set in the deploy environment.
§ 07

DNA Match

Drop your raw 23andMe / AncestryDNA / MyHeritage / LivingDNA / FamilyTreeDNA export. Eluent matches your genotype against a curated PGx variant table for the top-12 research peptides. Results render entirely in your browser.

Defense layers stacked behind that promise:

  • No upload endpoint exists for genome data — there is no/dna-match/upload route.
  • Parsing happens in a Web Worker isolated from the page.
  • A route-scoped service worker actively rejects POSTs from /dna-match as a second line of defense.
  • Optional cache lives in IndexedDB with AES-256-GCM encryption, deleted on demand from the page.
  • Share OG images are CI-checked to contain zero rsID patterns — the share preview cannot leak genotype even by accident.

Open it at /dna-match.

§ 08

Stack Mode

Add multiple peptides to evaluate interactions across the stack. The engine uses three signals — shared receptor competition, shared metabolic pathway, and curated literature stacks — to surface synergies, warnings, and unknowns.

Default posture on unmatched combinations is no known interaction data — Eluent never implies a stack is safe, only what is and isn't in our literature.

Open it at /stack.

§ 09

Data sources

SourceUseLicense
UniProtIdentity match · primary protein databaseCC-BY 4.0
AlphaFold DB v6Structure (40–400aa, UniProt hit)CC-BY 4.0
ESMFoldStructure (40–400aa, no UniProt hit)MIT
PEP-FOLD4Structure (<40aa)Academic free
ChEMBL 35Mechanism · target binding dataCC-BY 4.0
GtoPdbMechanism · ligand–receptor mapCC-BY 4.0
OpenTargetsMechanism · disease associationCC0
PharmGKBDNA Match · PGx variant evidenceCC-BY-SA 4.0
CPIC guidelinesDNA Match · clinical variant contextPublic
PubMed / dbSNP / gnomADCitations · variant frequencyPublic
§ 10

Privacy & security

  • No genome upload. DNA Match parsing is browser-only. There is no server endpoint for raw genotype.
  • Sequence privacy. Lookup sequences are committed via blinded hash before any third-party API runs — UniProt sees the sequence on reveal-only paths or not at all (cache hits skip the API entirely).
  • No medical PII. Eluent stores no name, email, address, or birthdate. Wallet pubkey is the only identifier.
  • Analytics whitelist. Captured events are restricted to a fixed allowlist. rsIDs, genotype calls, and evidence-level details are explicitly denied at the capture layer.
  • No Eluent-side keys. Wallet signing happens in the user's wallet extension. Eluent never sees a private key.
  • Verifiable on-chain. Every lookup binds the sequence to a Solana mainnet transaction via commit/reveal — anyone can later verify the dossier against the on-chain hash without trusting Eluent's servers.
§ 11

API endpoints

MethodPathPurpose
POST/eluent/quotePre-flight: get cost + idempotent quote for a sequence
POST/eluent/commitAnchor commit memo; returns commit tx signature
POST/eluent/revealAnchor reveal memo with result CID + hash
GET/eluent/:shortIdFetch dossier by short share ID
POST/auth/nonceSIWS challenge nonce
POST/auth/verifySubmit signed nonce; receive JWT
GET/auth/meCurrent session pubkey + tier
GET/me/searchesSaved lookup history (signed-in users)
POST/api/pro/checkResolve token tier for a wallet
GET/api/pro/pgx-variantsCurated PGx variant DB (Pro-gated)
POST/dna-match/shareCreate anonymous DNA share (peptide IDs only — no rsIDs)
POST/stack/shareCreate anonymous stack share (peptide IDs only)
GET/embed/:vendor/:skuSigned embed payload for vendor pages
GET/statsPublic counters · reports anchored, network status
§ 12

Roadmap

Phase 1shipped
  • · Lookup pipeline · UniProt + BLAST + structure routing + mechanism synth
  • · Commit / reveal v2 over Solana Memo · mainnet-beta
  • · SIWS auth · /me history · /status · /docs/grading
  • · Async-RSC landing · live /stats counter
  • · /d/[shortId] dossier with Mol* viewer
Phase 2shipped
  • · DNA Match · 5-format SNP-array parser · 12-peptide PGx variant DB
  • · Stack Mode · 3-signal DDI engine · receptor graph
  • · Vendor scrapers · 12 Tier-1 vendors · nightly cron
  • · Embed badge · Ed25519-signed · <16 KB gz
  • · Token-tier infra · dormant default · pro_lite / pro_full / whale
Phase 3next
  • · Vendor onboarding · Privy or Wallet-Standard sign-in
  • · SAS schemas · eluent.batch.v1 · eluent.coa.v1 · eluent.report.v1
  • · Vial verify · /v/[vendor]/[batchId] · WebNFC
  • · Squads V4 multisig for the Eluent authority key
  • · Lab tier · COA publish endpoint
  • · Custom Anchor program · vendor reputation · slashable stake
Phase 4later
  • · Arcium MXE · private BLAST for pharma tier
  • · Cross-chain bridges · Wormhole · deBridge
  • · Confidential Transfers · Private Eluent tier
  • · Token-2022 hooks
Last updated · Phase 2 ship · Eluent v0.1.x