Welcome to NeuraMark
NeuraMark is a blockchain-powered platform that provides immutable proof-of-authorship verification for AI-generated content. Combining cutting-edge Web3 technology with user-friendly Web2 authentication, NeuraMark creates a unified identity system for the AI content creator.
Cryptographic Security
SHA-256 hashing ensures content integrity and authenticity
Blockchain Backed
Immutable proof stored on Ethereum Sepolia testnet
IPFS Storage
Decentralized content storage via Pinata
AI-Powered
Gemini AI analyzes content originality and uniqueness
Getting Started
Create an Account
Sign up using Google OAuth or Email/Password. Your account is created in both Firebase and our database.
Link Your Wallet
Connect your MetaMask wallet to your account. You can link multiple wallets for flexibility.
Register a Proof
Upload your AI prompt and output. Our system will hash the content, upload to IPFS, and register on blockchain.
Get Your Certificates
Receive a soulbound NFT, W3C Verifiable Credential, and downloadable PDF certificate for your proof.
Hybrid Authentication
Web2 + Web3 Identity
NeuraMark uses a hybrid authentication system combining Firebase Auth (Web2) with MetaMask wallets (Web3) to create a unified identity.
Firebase Authentication
Sign in with Google OAuth or Email/Password for familiar Web2 experience
MetaMask Integration
Link one or more Ethereum wallets to your account
Multi-Wallet Support
One account can link multiple wallets, but each wallet can only belong to one account
Wallet Linking Rules
✅ One user → Many wallets | ❌ One wallet → One user ONLY (database enforced)
Proof Registration
6-Step Registration Flow
Enter Content
Provide your AI prompt, output (text/image/code), and model information
Hash Generation
Client-side SHA-256 hashing ensures privacy (raw content never sent to API)
IPFS Upload
Content uploaded to Pinata IPFS, returns Content Identifiers (CIDs)
Blockchain Registration
Sign MetaMask transaction to register proof on NeuraMark smart contract
AI Originality Analysis
Gemini AI analyzes uniqueness (0-100% score) by comparing with existing proofs
NFT Certificate Minting
Automatically mint soulbound ERC-721 token (non-transferable proof of authorship)
What You Get
- ✅ Immutable blockchain proof on Ethereum
- ✅ Decentralized IPFS storage with permanent CIDs
- ✅ AI originality score with confidence level
- ✅ Soulbound NFT certificate (viewable on OpenSea)
- ✅ W3C Verifiable Credential for portable verification
- ✅ Downloadable PDF certificate with QR code
Decentralized Identifiers (DID)
W3C DID Core v1.0 Compliant
NeuraMark implements a W3C-compliant DID system that creates a unified, verifiable identity linking your Firebase account, Ethereum wallets, and all registered proofs.
did:neuramark:<userId>did:neuramark:abc123xyz456Auto-Generation
DID created automatically on account signup with IPFS document upload
Unified Identity
Links Firebase UID, multiple wallets, and all proofs in one DID document
QR Code Generation
Generate scannable QR codes for easy identity sharing and verification
Public Verification
Anyone can verify DIDs via /verify-did page using identifier or wallet address
Soulbound NFT Certificates
Non-Transferable Authorship Tokens
Every registered proof automatically receives a soulbound NFT (ERC-721 token) that serves as an immutable certificate of authorship. These tokens are permanently bound to your wallet and cannot be transferred or sold.
Contract Address
0x951df3400098cB80990B54E6bE651a54f94A36BFNetwork
Ethereum Sepolia Testnet
Soulbound Logic
All transfer and approve functions revert - tokens permanently bound to creator
On-Chain Metadata
Proof hashes, CIDs, model info stored directly on blockchain
OpenSea Compatible
View certificates on OpenSea and other NFT marketplaces (view-only)
W3C Verifiable Credentials
Portable Digital Passports
Unlike NFTs (Ethereum-only) or PDFs (visual-only), W3C Verifiable Credentials are cryptographically-signed, portable proofs that work with ANY W3C-compliant verifier.
| Format | Purpose | Verification | Portability |
|---|---|---|---|
| 🎨 NFT | On-chain trophy | Etherscan, OpenSea | Ethereum-only |
| 🎫 VC | Digital passport | Any W3C verifier | Platform-independent |
| Human document | Visual QR scan | Print/email-friendly |
Ed25519 Signatures
Cryptographic signatures prove authenticity without contacting NeuraMark
JSON-LD Format
Standard format recognized by identity wallets (Microsoft Entra, Trinsic, etc.)
Self-Sovereign
You control the credential independently of the NeuraMark platform
AI-Powered Originality Scoring
Gemini AI Analysis
Google's Gemini AI analyzes your content's uniqueness by comparing it against recent database entries, providing a 0-100% originality score with detailed explanation.
Intelligent Analysis
Analyzes prompt similarity, output uniqueness, model diversity, and temporal context
Comparison Scope
Compares against 50-100 most recent proofs in database
Non-Blocking
Registration succeeds even if AI analysis fails (fallback score provided)
Semantic Search
ChromaDB + Jina AI v3
Vector-based semantic search enables intelligent content discovery using natural language queries. Find similar proofs by meaning, not just keywords.
Jina AI v3
1024-dimensional semantic embeddings via REST API
ChromaDB
Cloud-hosted vector database for similarity search
Originality Risk
Four-tier system (CRITICAL/HIGH/MEDIUM/LOW) for plagiarism detection
Prior Art Detection
Find existing similar content in blockchain registry before registration
Context-Aware
Embeddings enhanced with model info, content type, and authorship markers
Use Cases
- 🔍 Verify originality before registration
- 🚫 Detect duplicates and similar content
- 📊 Establish prior art for authorship disputes
- 🤝 Discover related proofs in your portfolio
ENS Integration
Human-Readable Names
NeuraMark integrates with Ethereum Name Service (ENS) to display human-readable names like "vitalik.eth" instead of long wallet addresses throughout the platform.
0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045vitalik.ethAutomatic Resolution
Reverse ENS lookup (address → name) using Viem on Ethereum mainnet
1-Hour Caching
In-memory cache minimizes RPC calls and improves performance
Graceful Fallback
Falls back to truncated address format (0x1234...5678) if no ENS
Get Your ENS Name
ENS names must be purchased at app.ens.domains (~$5-20/year). Set "Primary ENS Name" in settings for reverse resolution.
Technical Architecture
System Components
Frontend
Blockchain
Storage
Authentication
AI Services
Smart Contracts
0xe11b27FAfE1D18a2d9F1ab36314f84D47326A7950x951df3400098cB80990B54E6bE651a54f94A36BFTroubleshooting
MetaMask Not Connecting
Ensure you're on Sepolia network (Chain ID: 11155111). Click 'Switch Network' if prompted.
Transaction Failing
Check you have sufficient Sepolia ETH for gas fees. Get testnet ETH from faucet: https://sepoliafaucet.com
ENS Name Not Showing
ENS names must be purchased at app.ens.domains and 'Primary ENS Name' must be set. If no ENS, you'll see truncated address (0x1234...5678).
IPFS Content Not Loading
IPFS can be slow on first load. Wait 30-60 seconds or try refreshing. Content is permanently stored.
AI Originality Score Missing
AI analysis is optional and non-blocking. If Gemini API unavailable, a default score is provided.
NFT Not Showing in Wallet
NFTs appear on OpenSea Testnet within 5-10 minutes. Check: https://testnets.opensea.io/account