Consumer PWA · Q3 2026 Planned

PurityScan.
Scan it. Trust it.

A consumer PWA that verifies any Purity Receipt in 50ms. No app store. No login. No tracking.

Point your phone camera at any QR or NFC tag on Hive-certified packaging. PurityScan fetches the signed Purity Receipt from the issuer URL embedded in the tag, calls the edge verifier at thehiveryiq.com/verifier, and renders a trust card in under 50ms. Soil signature, GMO status, mRNA-vaccine status, pesticide residue, EU-banned-additive check, and 7 FSMA 204 KDEs — all cryptographically verified, all visible at the shelf.

Tagline: Scan it. Trust it. Signed by soil.

Free for consumers. Brands pay per-scan. Hive treats this like a CDN: minimal cost, maximal reach.

What happens in 50ms
1
Camera decodes QR
jsQR runs client-side, no server call. Extracts cert_id and issuer DID from URL.
2
Cert fetched from issuer
HTTPS GET to the DID document URL. The Purity Receipt is a signed JSON blob, typically 2–8 KB.
3
Edge verifier confirms signature
Cloudflare Workers at /verifier. ML-DSA-65 + Ed25519 hybrid. 50ms p99.
4
Trust card rendered
All attestation axes displayed. Expired certs show a clear expired badge. Chain visible.

This page is a product specification. PurityScan is planned for Q3 2026. The actual PWA ships separately from this spec document.


CSS-only mock. No emoji. Obsidian mobile frame.

The trust card

One scan. Six signed axes. Full chain.

The trust card is what the consumer sees after scanning. Every row is a cryptographically signed attestation — not a marketing claim. If the cert is expired, the header shows a clear "Expired" badge instead of "Verified." If the brand is not a Hive customer, PurityScan still verifies any /v1/purity/ cert from any issuer.

What each row means
GMO-free signed 3-of-5 threshold sig
mRNA-free signed Livestock agent attest
Pesticide-free signed Soil test + lab sig
EU-additive-free signed Processing agent attest
FSMA 204 chain complete 7 KDEs → all present
Soil signature valid Axis 17–24 entropy
Expired cert behavior

If a cert has passed its valid_until timestamp, the header chip switches from green "Verified" to red "Expired". The attestation rows remain visible so the consumer can see what was true at issuance time. No ambiguity.


PWA architecture

Four layers. All client-side where possible.

PurityScan is a Progressive Web App shell. No native SDK. No app-store review. Install is optional — the URL itself is the product. The architecture is designed so that verification logic runs at the edge, not on a central server.

Planned — Q3 2026

Layer i

PWA shell

Loaded from thehiveryiq.com/purityscan/. Service worker caches the shell on first visit. Subsequent loads are instant — sub-100ms from cache, no network required for the UI skeleton. Manifest enables "Add to Home Screen" on iOS and Android.

service worker + web manifest
Layer ii

Camera / QR decode

Camera access via getUserMedia(). QR decoding via jsQR — a pure JavaScript library that runs entirely in the browser. No pixels leave the device. NFC tap via Web NFC API where supported (Q4 2026). The URL is decoded client-side before any network call is made.

getUserMedia + jsQR — client-side only
Layer iii

Cert fetch from issuer

The QR URL contains an issuer DID and a cert_id. PurityScan resolves the DID document, extracts the cert endpoint, and fetches the signed Purity Receipt JSON directly from the issuer's server. Hive does not proxy this request. The consumer's browser contacts the issuer directly, preserving issuer sovereignty.

DID resolution + direct HTTPS fetch
Layer iv

Edge verification

The signed cert is forwarded to thehiveryiq.com/verifier — a Cloudflare Workers deployment. The verifier checks the ML-DSA-65 and Ed25519 signatures, confirms the chain hash linkage, and returns a structured verification result. Cloudflare p99 latency is under 50ms from any major metro.

Cloudflare Workers · 50ms p99
Consumer phone
      |
      | getUserMedia() + jsQR (client-side, no network)
      |
      v
QR decoded  →  URL: https://thehiveryiq.com/purityscan/?cert=<id>&issuer=<did>
      |
      | DID resolution  (browser → issuer DID document)
      v
Issuer server  →  returns signed Purity Receipt JSON (2–8 KB)
      |
      | POST /verify  (browser → Cloudflare Workers)
      v
thehiveryiq.com/verifier  (Cloudflare edge, 50ms p99)
      |   - ML-DSA-65 signature check
      |   - Ed25519 hybrid check
      |   - chain hash linkage
      |   - expiry check
      v
verification result  →  trust card rendered in browser
      no server-side session, no log of the consumer, no PII transmitted
      

Privacy posture

Nothing collected. Specifically nothing.

PurityScan is designed from the ground up to collect zero consumer data. The following list is explicit, not aspirational. CCPA and GDPR posture is identical: nothing is collected, so there is nothing to disclose, sell, or delete.

What is NOT collected
  • Name, email, phone, or any account identifier
  • Device fingerprint or hardware ID
  • GPS location or precise geolocation
  • Camera frames or images — jsQR decodes pixels locally and discards them
  • Scan history or search history
  • Analytics beacons, pixel trackers, or third-party scripts
  • IP address logging beyond standard Cloudflare WAF (ephemeral, not stored by Hive)
  • Cookies, local-storage session tokens, or any persistent identifier
Regulatory posture
CCPA (California)

No personal information is collected. There is no data to disclose, sell, or make subject to a deletion request. PurityScan does not trigger CCPA obligations because it processes no personal data.

GDPR (EU)

No personal data within the meaning of GDPR Article 4(1) is processed. No lawful basis for processing is required because no processing occurs. Hive is not a data controller for consumer scans.

Cloudflare WAF

Cloudflare sees request metadata (IP, user-agent, timestamp) for the duration of WAF processing. Hive does not receive, log, or store these fields. This is the same posture as any static website hosted on Cloudflare.


QR & NFC encoding spec

One URL. Fits a 33×33 QR module grid.

The URL embedded in the tag is designed to be minimal. The cert_id is a 22-character base58 string. The issuer DID is truncated to a compact form. Total URL length: under 90 characters, which fits in a QR code version 4 (33×33 modules) at error correction level M.

9×9 visual placeholder
Production: 33×33 QR v4 EC-M
URL format embedded in QR / NFC
https://thehiveryiq.com/purityscan/
?cert=7xKqNmB4RpLdA3fYe8Wv2z
&issuer=did:hive:farm:sunrise
Total length: 78 characters → fits QR v4 (33×33) at EC-M
cert parameter

cert_id is a 22-character base58-encoded SHA3-256 prefix of the receipt payload hash. It is deterministic — the same receipt always produces the same ID. The verifier uses it to look up the full cert at the issuer endpoint.

issuer parameter

issuer is a DID (Decentralized Identifier) in the form did:hive:<namespace>:<slug>. PurityScan resolves the DID document from thehiveryiq.com/did/<did> to find the cert endpoint. Any issuer can host their own DID document outside Hive infrastructure.

NFC encoding

The same URL is encoded as an NDEF URI record on the NFC tag. NFC tap on Android uses the Web NFC API. iOS 14+ supports background NFC tag reading for HTTPS URLs natively. No app required on either platform. NFC support planned Q4 2026.


Brand integration

How a brand adds PurityScan to a SKU.

Four steps from Purity Receipt to printed QR. No proprietary hardware required beyond a FarmGuard deployment or a direct API key. The brand owns its signing keys.

Issue a Purity Receipt via the API
POST to /v1/purity/cert/issue with your farm passport data, attestation axes, and signing key. The API returns a cert_id and a signed JSON receipt. FarmGuard customers issue receipts automatically as part of their daily Farm Passport cycle. Direct API access requires a brand API key (contact [email protected]).
Encode the cert URL to a QR or NFC tag
Build the URL: https://thehiveryiq.com/purityscan/?cert=<cert_id>&issuer=<your_did>. Encode it using any standard QR library at version 4, error correction M. For NFC, write as NDEF URI record. This is standard printing workflow — Hive does not supply printers or label stock.
Print the QR on your packaging
The QR goes anywhere on the label — back panel, bottom, or as a sticker insert. Minimum printed size: 20mm × 20mm at 300 DPI to ensure reliable scan under typical retail lighting. No approval process required. No Hive branding required, though the "Verified by Hive" lockup is available to licensees.
Done — scans go live immediately
The moment the packaging is in a consumer's hands, PurityScan can verify it. No app update required on the consumer side. No pre-registration of SKUs. The cert endpoint resolves via the issuer DID. Billing begins at first scan; the $99/mo minimum covers up to 990,000 scans/month at $0.0001/scan.
Sample: issue a Purity Receipt
# Issue a Purity Receipt for a specific SKU
curl -X POST https://thehiveryiq.com/v1/purity/cert/issue \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sku":         "SUNRISE-APPLE-HONEYCRISP-2026",
    "farm_did":    "did:hive:farm:sunrise-orchards",
    "attestations": {
      "gmo_free":           true,
      "mrna_free":          true,
      "pesticide_free":     true,
      "eu_additive_free":   true,
      "fsma_204_complete":  true,
      "soil_signature_axes": [17, 18, 20]
    },
    "valid_days":  90
  }'

# Response (200 OK)
{
  "cert_id":   "7xKqNmB4RpLdA3fYe8Wv2z",
  "issuer":    "did:hive:farm:sunrise-orchards",
  "issued_at": "2026-06-15T08:00:00Z",
  "valid_until":"2026-09-13T08:00:00Z",
  "qr_url":    "https://thehiveryiq.com/purityscan/?cert=7xKqNmB4RpLdA3fYe8Wv2z&issuer=did:hive:farm:sunrise-orchards",
  "sig":        "ML-DSA-65:0x8f3a...2b1c"
}

Brand pricing

CDN-grade unit economics for brands.

PurityScan is free for consumers. Brands pay per scan. Hive's cost model treats verification like a CDN: minimal marginal cost, billed to the brand, not the shopper. The $99/month minimum ensures service viability while keeping the per-scan rate competitive with any provenance alternative.

Option Cost per scan Monthly minimum Scans included at minimum Provenance data
PurityScan — Tier 1 Hive $0.0001 $99 / month Up to 1M scans/mo Full Purity Receipt, 6 attestation axes, FSMA 204 chain
PurityScan — Tier 2 (over 1M) Hive $0.001 $99 / month base Billed on usage above 1M Same full receipt
Blockchain food-trace platforms Alt $0.05 – $0.20 Varies; typically $500+ 2,500 – 10,000 Supply-chain hashes; limited attestation content
Traditional barcode / GS1 Alt $0.00 GS1 membership: $250 – $10K/yr No provenance, no attestation, no signing
Example economics

A brand shipping 500,000 units per month, with 10% QR scan rate, generates 50,000 scans/month. At $0.0001/scan: $5.00 in scan fees + $94 minimum overage = $99/month total. Cost per unit scanned: $0.002. Cost per unit shipped: $0.0002. Compare: a blockchain alternative at $0.05/scan would cost $2,500/month for the same volume.


Standards alignment

Open standards. No lock-in.

PurityScan is designed to coexist with, not replace, existing food-labeling infrastructure. The QR URL format is compatible with GS1 Digital Link. The attestation schema is designed to map to Open Food Facts fields. FSMA 204 KDE coverage is complete.

GS1 Digital Link

QR URL compatible with GS1 DL 1.1

The PurityScan URL can be structured as a GS1 Digital Link resolver URL, allowing a single QR to resolve to both a GS1 product page and a Purity Receipt. The cert and issuer params are passed as custom query-string extensions, which GS1 DL 1.1 permits.

Open Food Facts

Attestation schema maps to OFF fields

Purity Receipt fields including GMO status, additive list, and country of origin are designed to map directly to Open Food Facts product fields. Brands that submit their Purity Receipts to OFF can enrich the public database with cryptographically signed provenance data.

FSMA 204 — 21 CFR Part 1

7 KDEs at every CTE — auto-generated

The Purity Receipt chain covers all seven FSMA 204 Key Data Elements (traceability lot code, quantity, unit of measure, product description, location description, date, and reference document) at each Critical Tracking Event (growing, receiving, transforming, shipping). FarmGuard generates these automatically; PurityScan surfaces them to the consumer.

EU Regulation 1169/2011

Nutrition & origin labeling compatibility

EU 1169/2011 requires country-of-origin labeling for meat, fish, honey, olive oil, fruit and vegetables. PurityScan's soil signature (Axis 17) provides a farm-level geographic attestation that is consistent with EU 1169/2011 origin requirements. EU-banned-additive check covers the 12 additives permitted in the US but banned under EU food safety law.


Roadmap

Planned milestones. Honestly labeled.

Every item below is planned, not shipped. Dates are targets, not commitments. PurityScan does not exist as a shipping product today. This page is a product specification.

Q3 2026
PWA shell + QR scan
Core PWA shell at thehiveryiq.com/purityscan/. Service worker, web manifest. getUserMedia camera access. jsQR decode. Edge verifier integration. Trust card render. English language only. WCAG 2.1 AA compliance target.
Planned
Q4 2026
NFC tap support
Web NFC API integration for Android. iOS 14+ background NFC URL reading (no API change needed on iOS). Same URL format as QR — no backend changes required. NFC tags require NTAG213 or better.
Planned
Q1 2027
Offline verification cache
Service worker caches recently verified receipts. Consumer can re-verify a previously scanned product without network access. Cache is keyed by cert_id and expires when the cert's valid_until timestamp passes. Cached certs are stored in IndexedDB on-device, not transmitted to any server.
Planned
Q2 2027
Voice readout for accessibility
Web Speech API integration. After scan, the trust card result is read aloud: "GMO-free: verified. Pesticide-free: verified. Soil signature: valid." Intended for visually impaired users and shoppers who cannot read the screen in bright retail lighting. Language support tied to multi-lang rollout below.
Planned
Q2 2027
Multi-language support
Spanish, French, German, Japanese, Mandarin. Trust card labels and voice readout localized. Cert attestation data remains in English at issuance; display layer is translated. Language detection via navigator.language with manual override.
Planned
2028
Dedicated app-store apps (conditional)
Native iOS and Android apps, if consumer demand and retailer requirements warrant. The PWA is the primary and preferred delivery mechanism. App-store apps add nothing technically; they exist for discovery and shelf presence if brand partners request them. No commitment to this milestone.
If demand warrants

FAQ

Honest answers to likely questions.

Does the consumer need to install an app?
No. PurityScan is a Progressive Web App. The consumer opens the URL — either by typing it, scanning the QR with their native camera app, or tapping an NFC tag — and the experience loads in the browser. No app-store download. No account creation. "Add to Home Screen" is available but not required.
What happens if the certificate is expired?
The trust card header switches from a green "Verified" chip to a red "Expired" chip. All attestation rows remain visible, labeled with the issuance date, so the consumer can see what was true when the cert was issued. Brands are responsible for renewing certs before the valid_until date. PurityScan does not suppress or hide expired cert data.
What if the brand is not a Hive customer?
PurityScan verifies any /v1/purity/ cert from any issuer, not just Hive customers. If the issuer DID resolves to a valid DID document with a compatible cert endpoint, PurityScan will attempt verification. If the signature scheme is unsupported, the trust card will show "Unrecognized signature format" rather than "Verified."
What happens when I have no internet connection?
From Q1 2027, previously verified certs will be cached in the service worker for offline re-verification. Before that release, PurityScan requires a network connection to fetch and verify the cert. The PWA shell itself loads from cache even offline, but the verification result requires network access.
Can I share the trust card with someone else?
Yes. The trust card URL is the same QR URL embedded in the tag — it is a public, shareable link. The signed receipt is publicly accessible at the issuer endpoint. Anyone with the URL can independently verify the cert. There is no access control on public Purity Receipts.
What languages does PurityScan support?
English at launch (Q3 2026). Multi-language support — Spanish, French, German, Japanese, Mandarin — is planned for Q2 2027 alongside the voice readout feature. The trust card UI will auto-detect the browser language and fall back to English if the locale is not yet supported.
Is PurityScan accessible?
WCAG 2.1 AA compliance is the target for the Q3 2026 launch. This includes: semantic HTML with ARIA labels on all interactive elements, keyboard-navigable trust card, minimum 4.5:1 color contrast ratio on all text, screen-reader-compatible attestation rows, and no motion-only affordances. Voice readout (Web Speech API) is a Q2 2027 feature. If you identify an accessibility gap, please contact [email protected].
Will PurityScan support kosher and halal labeling?
Kosher and halal attestation axes are on the longer-term roadmap, planned as separate signing authorities. Kosher certification bodies and halal certification organizations would need to integrate as authorized issuers on the Hive platform. This is a 2027 initiative at the earliest. The Purity Receipt schema is extensible — adding new attestation axes does not require changes to the QR URL format or verifier architecture.

Interactive demo

Demo: planned for Q3 2026.

The live camera scan demo will be available when the PWA shell ships. Until then, the trust card mock above reflects the target consumer experience.

Camera viewfinder (planned)

Hold steady over any Hive-certified QR tag

Planned — Q3 2026

This is a product specification page, not the running PWA. The actual PWA ships separately.


Brand integration

Add PurityScan to your packaging in one sprint.

Book a 30-minute integration call. We walk through cert issuance, QR encoding, and the brand dashboard. Most brands are live in under a week.