GhostLink is a Zero-Knowledge Data Passport that transforms your Web2 reputation into verifiable on-chain credentials (SBT) — without exposing your raw data.
One sentence: Prove you meet a condition, not who you are.
- Web3 lacks trust signals; Web2 has abundant reputation data
- Proving credentials often requires doxxing private information
- Sybil attacks plague airdrops, allowlists, and community access
GhostLink bridges this gap with privacy-first verification:
| What's Visible ✅ | What's Hidden ❌ |
|---|---|
| Whether you meet a requirement | Your raw account data |
| Cryptographic proof of validity | Exact balances or follower counts |
| Reusable credential on-chain | Your identity across platforms |
 Dark Mode |
 Light Mode |
 ZK Privacy Bridge |
 Credential Explorer |
 Contract Inspector (Blueprint Studio) |
|
- Dev-Pass: Prove developer credibility from GitHub (account age, contributions, repos)
- Social-Pass: Prove social reach from X/Twitter (followers, engagement, account age)
- Asset-Pass: Prove "≥ threshold" from financial data — show solvency without revealing balances
- Zero-Knowledge Proofs: Powered by RISC Zero zkVM
- Nullifier System: Prevents double-claiming with cryptographic uniqueness
- On-Chain Verification: All proofs verified by smart contracts
- Dual Theme: Professional dark mode & clean light mode (Blueprint aesthetic)
- Multi-Language: Full English & Chinese (中文) support
- Contract Inspector: Transparent smart contract auditing with live logic analysis
- Real-Time Explorer: Track credential minting and holder statistics
graph TD
subgraph Browser["🌐 Browser (Privacy Zone)"]
UI["React Frontend"]
Wallet["Wallet Connection"]
end
subgraph Backend["⚙️ Backend (Spring Boot)"]
OAuth["OAuth Callbacks"]
Prover["ZK Proof Generator"]
end
subgraph Chain["⛓️ Ethereum (Sepolia)"]
Verifier["RISC Zero Verifier"]
SBT["GhostLinkSBT Contract"]
end
UI --> Wallet
UI --> OAuth
OAuth --> Prover
Prover --> Verifier
Verifier --> SBT
Wallet --> SBT
| Layer | Technology |
|---|---|
| Frontend | React 18 + Vite + Tailwind CSS + Framer Motion |
| Backend | Java 17 + Spring Boot 3 |
| Blockchain | Ethereum (Sepolia) + Solidity |
| ZK Proving | RISC Zero zkVM + Groth16 |
| Deployment | Cloudflare Pages + Alibaba Cloud |
- Node.js 18+
- Java 17+
- Maven 3.8+
- MetaMask or compatible wallet
cd web
npm install
npm run devOpen http://localhost:5173 in your browser.
./mvnw spring-boot:runAPI available at http://localhost:8080.
The GhostLinkSBT contract is deployed on Sepolia:
Address: 0xe62f6F1E02507880a561A8cd7a88050E61CFA4Ad
# OAuth Credentials (Required for production)
export GHOSTLINK_GITHUB_CLIENT_ID="your_github_client_id"
export GHOSTLINK_GITHUB_CLIENT_SECRET="your_github_client_secret"
export GHOSTLINK_TWITTER_CLIENT_ID="your_twitter_client_id"
export GHOSTLINK_TWITTER_CLIENT_SECRET="your_twitter_client_secret"# Create .env.local in /web (optional)
VITE_API_BASE_URL=http://localhost:8080
VITE_API_ZERO_URL=http://localhost:8081
VITE_GITHUB_CLIENT_ID=your_github_client_id
VITE_TWITTER_CLIENT_ID=your_twitter_client_idghostlink/
├── web/ # React Frontend
│ ├── src/
│ │ ├── components/ # Reusable UI components
│ │ ├── pages/ # Page components
│ │ ├── contexts/ # React contexts (Theme, I18n)
│ │ ├── i18n/ # Internationalization strings
│ │ └── config/ # Configuration constants
│ └── public/ # Static assets
├── src/ # Spring Boot Backend
│ └── main/java/org/example/ghostlink/
│ ├── controller/ # REST controllers
│ ├── service/ # Business logic
│ └── config/ # Configuration
├── contracts/ # Solidity smart contracts
│ ├── GhostLinkSBT.sol # Main SBT contract
│ └── IRiscZeroVerifier.sol
├── productdoc/ # Product specifications
└── docs/ # Documentation & screenshots
| Document | Description |
|---|---|
| Product Spec | Full product specification |
| Smart Contract Spec | Contract architecture & functions |
| RISC Zero Spec | ZK proving system design |
| 需求文档 | Chinese requirements document |
- V1 MVP: Multi-page Web UI + Demo proof flows
- Contract Inspector: Blueprint Studio with live logic analysis
- Dual Theme: Dark/Light mode with i18n support
- Real Proving: zkVM/WASM local privacy computation
- zkTLS Integration: Prove data authenticity from sources
- SDK & Marketplace: "Bring your own logic" for any dApp
- Mobile App: Privacy + identity in your pocket
We welcome contributions! Here's how you can help:
- Star the repo ⭐ — it helps visibility
- Open an Issue — share ideas or report bugs
- Submit a PR — improve code, docs, or translations
This project is licensed under the MIT License — see the LICENSE file for details.