Skip to content

QuantBlockchain/qc-bc-interactive

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

20 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

โš›๏ธ Quantum Blockchain Interactive DOI

An interdisciplinary demonstration of post-quantum cryptography, blockchain risk awareness, and sustainable distributed trust through interactive user experience and real quantum hardware execution.

โ€œWhat I cannot create, I do not understand.โ€
โ€” Richard Feynman


UI Walkthrough Run Locally Deploy AWS

โš›๏ธ Quantum Computing ย ย โ€ขย ย  ๐Ÿ” Post-Quantum Cryptography ย ย โ€ขย ย  โ›“๏ธ Blockchain Security ย ย โ€ขย ย  โ˜๏ธ AWS Braket


๐ŸŒ Demo Contribution Summary

Quantum Blockchain Interactive is a research demonstration exploring the transition toward quantum-resilient blockchain infrastructure through a guided interactive experience.

The platform integrates:

  • โš›๏ธ post-quantum cryptography,
  • โ›“๏ธ blockchain security risk awareness,
  • โ˜๏ธ real quantum hardware execution,

into a unified demonstrator designed for interdisciplinary audiences.

The demo illustrates:

  • how advances in quantum computing affect current blockchain cryptographic assumptions,
  • how post-quantum cryptographic mechanisms can be introduced through participatory interfaces,
  • how infrastructure decisions and stakeholder perception influence adoption dynamics,
  • how distributed trust systems evolve under emerging computational paradigms.

Unlike demonstrations focused solely on protocol implementation or algorithmic benchmarking, this system emphasizes the interaction between technical security mechanisms, ecosystem understanding, and adoption processes. Participants experience post-quantum migration through a structured interaction flow culminating in the generation of a quantum-resistant cryptographic artifact using Amazon Braket.


๐Ÿงญ Overview

Quantum Blockchain Interactive is an interactive web platform designed for:

  • ๐ŸŽค live demonstrations
  • ๐Ÿงช workshops and exhibitions
  • ๐ŸŒ public engagement

The experience connects quantum computing progress, blockchain security challenges, and post-quantum cryptography through a structured user journey.

Participants move from scientific context and risk awareness to participatory interaction and infrastructure exploration, concluding with the generation of a quantum-safe cryptographic key โ€” a personalized Quantum-Safe Blockchain Passport.

The project serves simultaneously as:

  • ๐Ÿ“˜ an educational interface for emerging cryptographic transitions,
  • ๐Ÿ”ฌ a research demonstration of interdisciplinary technology adoption,
  • ๐Ÿš€ a deployable interactive system for events and exhibitions.

๐Ÿ“š Table of Contents


๐ŸŽฎ Experience (UI Journey)

The application presents a 7-page guided interaction flow that progressively introduces quantum computing concepts and blockchain security implications while remaining accessible to mixed technical audiences.

๐Ÿ‘‰ Detailed UI documentation:
docs/ui-information/Readme.md


๐Ÿ—บ๏ธ Journey Overview

Page Screen Experience Goal UI Module
Page 1 Nobel Prize Context Establish scientific grounding Scientific context module
Page 2 Quantum Meets Blockchain Explain quantum threat and PQC transition Threat analysis module
Page 3 Experience Overview / Consent Establish transparency and participation rules Consent & session module
Page 4 Public Sentiment Capture perception and engagement Sentiment input module
Page 5 Results & Industry Voting Aggregate community priorities Voting & visualization module
Page 6 Device Selection Explore infrastructure and hardware tradeoffs Device exploration module
Page 7 Quantum-Safe Passport Present cryptographic outcome artifact Key generation & result module

๐Ÿงฉ Experience Design Principles

The interaction flow mirrors real-world technology adoption and post-quantum transition processes.

Design Principle Pages Role in Experience
Context โ†’ Understanding Pages 1โ€“2 Establish shared scientific and security context
Participation โ†’ Reflection Pages 3โ€“5 Transform learning into interaction and feedback
Decision โ†’ Outcome Pages 6โ€“7 Connect infrastructure choices to cryptographic results

This progression allows participants to understand post-quantum migration as both a technical and socio-technical transition involving research, engineering, governance, and investment perspectives.


๐Ÿ› ๏ธ Admin Dashboard

A protected dashboard at /dashboard provides:

  • ๐Ÿ“Š session monitoring and activity metrics
  • ๐Ÿ”‘ invite code management
  • โ˜๏ธ sentiment and voting aggregation
  • ๐Ÿ“ feedback review and export

๐Ÿ—๏ธ System Architecture

The application is deployed as a single-stack, serverless web system on AWS. It is optimized for live demos and workshops: low operational overhead, fast global delivery, and strict separation between the browser UI and privileged cloud operations (data + quantum execution).

High-level system flow

CloudFront (CDN)  โ†’  API Gateway (HTTP)  โ†’  Lambda (Next.js / Docker ARM64)
                                                  โ”‚
                                      โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                                  DynamoDB     Lambda       S3
                                 (7 tables)   (Braket)  (feedback)

What each component does

๐ŸŒ CloudFront (CDN) Serves the UI and static assets (images, scripts) from edge locations to reduce latency during public events. Dynamic requests (API calls and server-rendered routes) are forwarded downstream.
๐Ÿšช API Gateway (HTTP) Provides the public HTTP entry point for the applicationโ€™s server-side endpoints. It establishes request boundaries (routing, throttling) between the internet and compute functions.
โš™๏ธ Lambda (Next.js / Docker ARM64) Runs the Next.js application as a serverless container. This layer performs server-side rendering and hosts API routes for session orchestration, consent gating, sentiment/voting submission, and result retrievalโ€”while ensuring no AWS credentials are ever exposed to the browser.
๐Ÿ—„๏ธ DynamoDB (7 tables) Persists interaction artifacts and operational state with burst-friendly scaling. Typical tables include sessions, sentiments, industry votes, generated key metadata, invite codes, admins, and feedback metadata.
โš›๏ธ Lambda (Braket) Isolates quantum execution from the web runtime. It submits tasks to Amazon Braket (simulators or QPUs), tracks job status, and returns device/job metadata used to render auditable outcome artifacts (the โ€œQuantum-Safe Passportโ€).
๐Ÿ“ฆ S3 (feedback) Stores optional large uploads such as feedback attachments or exported artifacts. DynamoDB retains associated metadata and pointers.

Why this architecture fits the demo

  • Performance for live audiences: CloudFront reduces global latency and stabilizes UI delivery under burst traffic.
  • Security by design: the browser never holds AWS credentials; privileged operations (data writes + Braket jobs) happen server-side.
  • Auditability of outcomes: quantum execution returns job/device metadata that can be surfaced in the final results page for traceability.
  • Operational simplicity: a single CDK stack provisions the system; one deployment path supports repeated event setups.

In summary, the stack is designed to keep the interactive experience responsive and reliable while supporting real post-quantum workflow integration with quantum hardware.


โš™๏ธ Configuration

Application behavior is configured through environment variables used in both local development and cloud deployment.

๐Ÿ’ป Local Configuration

Create:

frontend/.env.local

Example:

AWS_REGION=us-east-1
ADMIN_API_KEY=your-key

โ˜๏ธ Cloud Configuration

Environment variables are injected into Lambda functions through AWS CDK during deployment. These values remain server-side and are never exposed to the browser.

Variable Required Default Description
AWS_REGION No us-east-1 AWS region for DynamoDB and Braket
ADMIN_API_KEY Yes โ€” Admin dashboard authentication
DDB_TABLE_SESSIONS No qc-bc-sessions Sessions table
DDB_TABLE_SENTIMENTS No qc-bc-sentiments Sentiment storage
DDB_TABLE_INDUSTRY_VOTES No qc-bc-industry-votes Voting storage
DDB_TABLE_QUANTUM_KEYS No qc-bc-quantum-keys Generated keys
DDB_TABLE_INVITE_CODES No qc-bc-invite-codes Invite code storage

๐Ÿš€ Getting Started (Local Development)

Run the application locally for development or testing.

Prerequisites

  • Node.js 20+
  • Docker
  • AWS CLI configured
  • AWS CDK v2

Run Locally

cd frontend
npm install

cp .env.example .env.local
npm run dev

Application runs at:

http://localhost:3000

โ˜๏ธ Cloud Deployment

Deploy the application to AWS using CDK:

./deploy.sh

Deployment performs:

  1. Frontend container build
  2. Infrastructure provisioning via AWS CDK
  3. Lambda, API Gateway, DynamoDB, and CloudFront configuration
  4. Output of the public application URL

After deployment, the application runs fully serverlessly and is ready for live demonstrations or production use.